/SimHub-SF1000-UDP

A SimHub plugin that provides more games support for Thrustmaster™ SF1000 wheel

Primary LanguageC#MIT LicenseMIT

SimHub SF1000 UDP

Build GitHub Downloads (all assets, all releases)

This plugin's primary goal is to provide more games support to Thrustmaster™ SF1000 wheel, such as Assetto Corsa, through its support for F1 2020 & F1 23 games UDP.

Some functionalities on the wheel won't be available depending on the game you play. Also, the SF1000 wheel has bugs in its firmware, so some data will not be shown on the dash, most notably the ERS bar (I reported this and got no response so I guess we'll have to live with it).

How it works (technical details?)

From SimHub app, this plugin will send UDP packets containing data in F1 23 UDP format, or F1 2020 UDP format.

Data comes directly from SimHub without any other plugins so it is limited.

Some data is modified to adapt to some bugs in the wheel, and some will be dropped to avoid unnecessary data being transferred to the wheel (eg. weather).

Installation

  • Download latest SimHub
  • Download latest release (SimHubSF1000UDP_v*.zip)
  • Open the zip file
  • Extract the one file (*.dll) to your SimHub folder (where SimHubWPF.exe file is)
  • Start SimHub and enable the plugin when prompted (only have to do once)
  • Follow Configuration steps below

Note

Starting from v2, this plugin supports F1 2020 and F1 23 UDP format. By default, F1 23 UDP format is used, which only supports SF1000 wheel with firmware v6.27 and above.

If your wheel does not show any data or has older firmware, you can switch to F1 2020 format by opening SimHub -> Additional plugins -> SimHub SF1000 UDP tab -> UDP format dropdown -> Select F1 2020 -> Click Save button.

(Recommended) See Thrustmaster SF1000 website for more information on how to check & update your wheel firmware.

Configuration

1. Wheel config

  • First thing, you need to configure Wi-Fi for your wheel, please go to Thrustmaster SF1000 website, and read instructions provided by them on how to set up UDP/Wi-Fi. You should see these two files (you can ignore the steps for F1 games):

    image

  • If your wheel's firmware is v5 and below (check on wheel's info screen), you need to configure your wheel to read UDP data. You need to do this everytime the wheel turns on. Please read Thrustmaster's guide on how to set it up.

    image

  • If you have firmware v6.27 and above, UDP is always enabled, you don't have to configure anything on the wheel. If the Wi-Fi screen shows UDP: 20777 then you are good to go. If not, check your firmware version again on Info screen or check if Wi-Fi has been configured correctly.

2. Plugin config

  • On your wheel Wi-Fi screen, note the IP: xxx.xxx.xxx.xxx address line.

    image

  • Open SimHub, go to Additional plugins -> SimHub SF1000 UDP tab -> Enter the IP shown on your wheel in "New IP" section -> Click Save button.

    image

  • Select your game in SimHub Games screen if you haven't already (if you have SimHub Licensed Edition then you don't have to manually select the game - not an ad).

  • Start your game and the wheel should show the dash.

Building

Note

This section is for developers only, if you just want to use the plugin, follow Installation and Configuration

Requirements

  • Visual Studio 2022 (recommended), other versions might work but not tested.
  • .NET Framework 4.8

Steps

  1. Clone this repo
  2. Open Visual Studio
  3. SimHub libraries are included in this repo, so building should be straightforward as hitting build button.
  4. A .dll file will be generated in bin/Debug or bin/Release folder, depending on your configuration selection.
  5. Copy the built .dll file to SimHub directory.
  6. Do whatever you want with the plugin

Issues & suggestions

If you have any issues/questions or suggestions, please create an issue here.

Disclaimer

This application/project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Guillemot Corporation S.A, or any of its subsidiaries or its affiliate. Thrustmaster is a registered trademarks of Guillemot Corporation S.A.

This application/project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Electronic Arts, or any of its subsidiaries or its affiliate.