Skip to content

Latest commit

 

History

History
148 lines (104 loc) · 5.54 KB

README.MD

File metadata and controls

148 lines (104 loc) · 5.54 KB

Project logo

Open-source wireless steering wheel or button box for ESP32 boards

This project provides open hardware and software for a sim-racing wheel or button box, featuring:

  • 🛜 Wireless connectivity via Bluetooth Low Energy, with no configuration effort.

  • 🔌Wired connectivity is also available via USB.

  • 🤔 There are several hardware setups to choose from and detailed instructions about how to customize them with minimal effort. Support for button matrices, multiplexed switches, GPIO expanders, shift registers, rotary encoders, funky switches...

  • 🗲 Powered by rechargeable batteries, wheel base or USB cable.

  • 🪫 State of charge (for batteries).

  • ⎇ Alternate mode (mode selector). While engaged, any input is reported as an alternate, doubling the number of effective inputs. Much like your keyboard's SHIFT key.

  • 🏎️ Clutch paddles that can be mapped to one of four functions by user preference:

    • F1-style clutch with bite-point calibration.
    • Alternate mode.
    • Regular button.
    • Individual analog axes.

    Dead zones and polarity of each axis are configurable.

  • ⛕ ALT buttons that can be mapped to one of two functions by user preference:

    • Alternate mode.
    • Regular button.

  • 🕹️ A directional pad or funky switch may be mapped to one of two functions by user preference:

    • Navigation controls.
    • Regular buttons. Navigation controls cannot be assigned to car functions in some simulators. This solves that problem.

  • 🎮 Custom button mapping. The user can customize the button numbering on this wheel to match other wheels. This way, the simulator does not force the user to reconfigure inputs every time these wheels are swapped.

  • ⛐ Telemetry using SimHub. Supported display hardware includes RGB LED strips and single color LEDs.

  • 💤 Automatic power-off when not in use.

  • 👍 Quality control (you don't want your wheel to fail in the middle of a race)

  • 🗎 Extensive documentation

  • 💰 Low budget.

  • ✅ Fully operational.

There is a companion app for user preferences, not mandatory but needed for some features. A SimHub plugin is required for telemetry. This plugin can also configure basic user preferences.

Important

Please start with the documentation index.

(🇪🇸) Volante inalámbrico de simulador o caja de botones, de fuentes abiertas, para placas ESP32

Este proyecto proporciona hardware y software abierto para un volante de simulación o una caja de botones con las siguientes características:

  • 🛜 Conectividad inalámbrica a través de Bluetooth de baja energía y sin esfuerzo de configuración.

  • 🔌 Conectividad por cable también disponible mediante USB.

  • 🤔 Varias configuraciones hardware para elegir e instrucciones detalladas para personalizarlas con el mínimo esfuerzo. Soporte para matrices de botones, interruptores multiplexados, expansores de GPIO, registros de desplazamiento, codificadores rotativos, funky switches...

  • 🗲 Alimentación mediante baterías recargables, base del volante o cable USB.

  • 🪫 Estado de la carga (para baterías).

  • ⎇ Modo alternativo (selector de modo). Mientras está activado, cualquier entrada se reporta como una entrada alternativa, duplicando su número en consecuencia. Similar a la tecla SHIFT de un teclado.

  • 🏎️ Levas de embrague que pueden ser configuradas en una de cuatro funciones:

    • Embrague tipo F1 con calibración del punto de mordida
    • Modo alternativo
    • Botón normal y corriente
    • Ejes analógicos independientes.

    Tanto las zonas muertas como la polaridad de cada eje se pueden configurar.

  • ⛕ Botones "ALT" que pueden ser configurados en una de dos funciones:

    • Modo alternativo
    • Botón normal y corriente.

  • 🕹️ Una cruceta direccional o funky switch puede ser configurada en una de dos funciones:

    • Controles de navegación
    • Botones normales y corrientes. Los controles de navegación no se pueden asignar a funciones del coche en algunos simuladores. Esto solventa dicho problema.

  • 🎮 Mapa de botones definido por el usuario. El usuario puede ajustar la numeración de los botones de manera que coincida con cualquier otro volante. De esta manera, el simulador no fuerza al usuario a configurar las entradas cada vez que intercambia los volantes.

  • ⛐ Telemetría mediante SimHub. El hardware de visualización incluye tiras LED RGB y LED de un único color.

  • 💤 Apagado automático cuando no se usa

  • 👍 Controles de calidad (no queremos que el volante falle en medio de una carrera)

  • 🗎 Documentación extensa

  • 💰 Costes contenidos.

  • ✅ Totalmente operativo.

Existe una aplicación auxiliar para las preferencias de usuario, no obligatoria, pero necesaria para algunas funcionalidades. Un plugin para SimHub es necesario para la telemetría. Este plugin también puede configurar las preferencias básicas del usuario.

Important

Por favor, comience por el índice de documentación (en inglés).