Configuration app for ESP32-based open-source sim wheels / button boxes

A companion app for ESP32 based open-source wireless steering wheel.

Features

• Load/save from/to file.
• Handle multiple connected devices.
• Choose working mode of clutch paddles, "ALT" buttons and/or directional pad.
• Set clutch bite point.
• Force auto-calibration of analog clutch paddles.
• Force battery auto-calibration (not available if the battery was "factory-calibrated" previously).
• Map hardware buttons to user-defined HID buttons.
• Supports all firmware versions to date (data versions 1.0 to 1.4).
• Rename device (Windows and BLE, only)
• Set a custom VID and/or PID (BLE only)
• Reverse axis polarity (in analog clutch paddles only)
• Windows / Linux / Mac
• UI languages (automatically detected):
  • English (default)
  • Español (Spanish)
  • 中国 (Chinese)

User documentation

Installing and running

Usage notes

Known issues / Troubleshooting

User interface not showing

As a workaround, open your web browser and try one of these URL: localhost:8000 or localhost:8080. The user interface will show in your browser.

If your operating system is Windows 11, this issue is caused by some kind of security measure for files downloaded from the Internet. Download the ZIP file again and follow the installation notes carefully.

Other

Change log

Notes for software developers

Licensed work

This project uses the following libraries under a compatible license:

• "hidapi" from Gary Bishop:

  Available under several licenses, including public domain.

• "nicegui" from Zauberzeug GmbH:

  Available under MIT license.

• "appstrings" from this author:

  Available under EUPL license.