Intégration SimHub
SimHub est le hub de télémétrie de référence pour le sim racing sur PC — il extrait la télémétrie propre à chaque jeu (vitesse, régime, rapport engagé, deltas de secteur, températures de pneus) et alimente tout le matériel à l'écoute. De nombreux montages de sim racing utilisent SimHub pour piloter des indicateurs de changement de rapport à LED de régime, des tableaux de bord OLED / à segments, des ventilateurs de vent, des bancs tactiles à bass-shakers, et l'éclairage par bouton sur une façade de volant. NodeBlue livre un ensemble de modules qui font apparaître la carte auprès de SimHub comme l'une de ses familles de périphériques prises en charge, de sorte que l'utilisateur obtient un profil en un clic dans l'interface SimHub et des liaisons de variables côté SimHub prêtes à l'emploi.
Cette page est l'approfondissement signalé à la fin du tutoriel Sim-Racing. Si vous voulez juste une recette rapide « allumer des LED depuis SimHub », sautez directement à l'exemple concret en bas de page.
Comment SimHub communique avec une carte
SimHub parle deux familles de protocoles :
| Famille | Transport | Point de terminaison NodeBlue |
|---|---|---|
| Serial | Un port COM virtuel (USB-CDC), texte + binaire mélangés. Plug-and-play — l'utilisateur choisit le port COM dans SimHub et commence à utiliser le périphérique. | nSimHubInterface |
| HID Custom Device | Un périphérique HID-USB personnalisé que SimHub identifie par VID/PID. Configuration plus facile pour l'utilisateur (pas de port COM à choisir), et le périphérique apparaît avec des métadonnées complètes dans l'interface SimHub. | nSimHubDevice |
Les deux interfaces parlent presque le même format de fil en dessous ; les modules de surface se ressemblent beaucoup. Utilisez nSimHubInterface pour les périphériques basés sur le série, nSimHubDevice pour ceux basés sur le HID. Vous ne mettez pas les deux sur le même canevas.
Les points de terminaison de transport
nSimHubInterface — série
Déposez ce module sur le canevas pour déclarer la carte comme un périphérique SimHub-série.
| Paramètre | Description |
|---|---|
| Sync | Généralement MainLoop ou InputSync. |
| ref | Nom utilisé par les modules compagnons nSimHubInterface* pour retrouver ce point de terminaison (défaut Interface). |
| bufferSize | Taille du buffer Rx interne — 256 convient à la plupart des projets ; augmentez-la si vous poussez de grandes matrices de LED. |
| crc table | La table CRC8 utilisée pour authentifier les paquets — laissez la valeur par défaut crc_table_crc8. |
| Debug | Port série de sortie de débogage optionnel. Choisir un port autre que None déverrouille les indicateurs de débogage par zone (Packet, Parser, Commands, …). Réservé aux administrateurs — la plupart des utilisateurs laisseront ceci désactivé. |
| Port | Direction | Ce qu'il transporte |
|---|---|---|
Tx (entrée) | carte → SimHub | Un cBuffer transportant des paquets de statut / réponse. Généralement câblé depuis la sortie de réponse d'un module compagnon. |
Rx (sortie) | SimHub → carte | Un cBuffer transportant chaque commande SimHub entrante. Routé vers les modules compagnons ci-dessous — chacun s'abonne à un type de paquet. |
Bauds (sortie) | carte → compagnon | Un u32 reportant le débit série actuel — utile lorsque le côté SimHub change de vitesse en cours de session. |
Vous câblez généralement nSimHubInterface.Rx vers une chaîne de modules compagnons, chacun déclarant le code de paquet qui l'intéresse ('G' pour Gear, 'S' pour les données TM1637, 'M' pour LED Matrix, …). La sortie de chaque compagnon vous donne un buffer typé propre ou une valeur unique que vous pouvez router vers le reste du projet.
nSimHubDevice — périphérique HID personnalisé
Même forme, transport différent. Utilisé lorsque vous voulez que la carte apparaisse comme un périphérique HID personnalisé dans le panneau « My Hardware » de SimHub, avec marque, URL d'image et une étiquette de type de matériel — SimHub le traite comme un périphérique de première classe que l'utilisateur peut configurer via l'interface.
| Paramètre | Description |
|---|---|
| Brand | Nom du fabricant (défaut ElectroSeed). |
| Picture URL | URL d'une image de produit que SimHub affiche dans son interface. |
| Autodetect | Si SimHub détecte automatiquement le périphérique lors de l'énumération USB. |
| Type | DEVICETYPE_* — choisissez la famille correspondante (Wheel, Pedals, Button Box, Shifter, etc.). SimHub s'en sert pour suggérer des liaisons sensées. |
| ULock | « Upload locked » — empêche SimHub d'écraser le firmware via son propre flux de mise à jour. Laissez activé sauf si vous savez que vous voulez que SimHub gère le firmware. |
| Leds / ButtonLeds | Nombre de LED adressables / LED de rétroéclairage de boutons que le périphérique annonce. |
| Layout | Une description sous forme de chaîne de la disposition des LED — l'éditeur de SimHub l'utilise. |
| Matrix / Fans | Nombre de contrôleurs de matrice et de ventilateurs que le périphérique annonce. |
Ports Tx (entrée) / Rx (sortie) / Leds (sortie) — même principe que l'interface série, plus un canal Leds dédié aux données de LED que SimHub pousse.
La voie du périphérique HID exige également que le type USB de la carte soit compatible HID (customhid ou l'une de ses variantes serial*customhid*).
Les modules compagnons — recevoir les commandes
Les modules d'interface ci-dessus sont des transports purs — ils décodent la trame et les CRC mais ne savent pas ce que signifie un paquet spécifique. Les modules compagnons sont les abonnés par type de paquet.
nSimHubInterfaceIn — types de commandes intégrés
Choisissez le paquet SimHub que vous voulez dans la liste déroulante type et le module renseigne pour vous les détails du protocole :
| Type | Sorties | Ce que SimHub envoie |
|---|---|---|
| Gear | u8 — le rapport actuel (R, N, 1–8). | Le rapport engagé, sous forme de caractère ASCII. |
| TM1637 | Luminosité + 9 octets de données — un buffer prêt à alimenter directement un afficheur TM1637 à quatre ou six chiffres. | Texte pré-rendu + luminosité pour un écran 7 segments. |
| TM1638 | Luminosité + 17 octets de données — pour le module TM1638. | Même principe, pour un clavier à LED TM1638 plus grand. |
| Led Matrix | Luminosité + 9 octets de données — données mono- ou bicolores pour une petite matrice de points. | Données par pixel plus un octet de luminosité global. |
| Custom | Défini par l'utilisateur — choisissez le code de données, le nombre, la longueur d'élément, le type de sortie. | Ce que vous avez configuré SimHub pour envoyer. |
Chaque abonné émet aussi une sortie Sync — une impulsion u8 qui se déclenche à l'arrivée d'un paquet, utile pour déclencher un cycle de « rafraîchissement de l'affichage » en aval sans interrogation continue.
Vous rattachez un abonné à l'interface en le sélectionnant dans la liste déroulante interface — peuplée à partir de chaque nSimHubInterface présent sur le canevas.
nSimHubInterfaceInExt — types de commandes étendus
Pour les commandes à trame plus complexe — actuellement le type de sortie PWM — nSimHubInterfaceInExt ajoute une plomberie supplémentaire que le module In de base n'a pas (nombres par élément, négociation de code de fonctionnalité, codes d'accusé de réception). Le dialogue verrouille les champs une fois qu'un Type est choisi.
Construisez un périphérique piloté par PWM (ventilateur, moteur de vibration) en routant la sortie de cet abonné vers le module nPWMOutput.
Chemins de sortie des LED
Les LED sont la charge utile la plus courante de SimHub. NodeBlue a trois modules qui la décodent selon la pile de LED que vous utilisez.
nSimHubInterfaceLeds — bandeau / matrice via le série
Le module clé en main pour les bandeaux de LED RGB et les matrices de LED RGB pilotés via l'interface SimHub-série.
| Paramètre | Description |
|---|---|
| interface | Le nSimHubInterface auquel il s'abonne. |
| Type | Led Strip (un bandeau 1D — Count est défini par l'utilisateur) ou Led Matrix (une matrice 2D — Count fixé à 8×8). |
| Count | Nombre de LED (bandeau uniquement). Le module pousse le nombre choisi vers le pilote de LED auquel il est câblé. |
| Code / Feature Code | Les identifiants du format de fil (auto-remplis par Type). |
La sortie est un Buffer de données RGB prêt à alimenter un pilote nFastLed ou nWS2812Serial — nSimHubInterfaceLeds met automatiquement à jour le paramètre Nb Leds du pilote en aval quand vous changez Count, de sorte que vous ne gérez pas deux nombres qui doivent correspondre.
Pour les afficheurs LED monochromes pilotés par les données de couleur SimHub, insérez un nRGBToMonochrome entre ce module et le pilote — nSimHubInterfaceLeds y propage également Count.
nSimHubHIDLeds — rapport de LED au format HID
Pour la livraison de LED côté HID (nSimHubDevice), nSimHubHIDLeds est l'équivalent.
| Paramètre | Description |
|---|---|
| Count | Nombre de LED. |
| ReportID | L'ID de rapport HID sur lequel arrivent les données de LED (défaut 0x68). |
Entrée : un buffer de rapport HID (câblé depuis la sortie du périphérique HID, ou depuis une gestion d'entrée HID générique). Sortie : un buffer d'octets RGB prêt pour nFastLed / nWS2812Serial.
nSimHubLedsNextion — LED affichées sur un écran Nextion
Lorsque les « LED » sont en réalité rendues sur un afficheur Nextion (widgets de barre de régime, pixels de statut), nSimHubLedsNextion produit les données dans un format que les modules côté Nextion attendent :
| Sortie | Ce qu'elle transporte |
|---|---|
Data | Données de pixels RGB. |
Bright | Octet de luminosité. |
B+D | Luminosité + Données concaténées — généralement ce que veut le gestionnaire Nextion en aval. |
Ce module se rattache automatiquement à un nNextionInterface (la directive include fait le câblage) ; pas de liste déroulante interface à choisir.
Renvoyer des données — télémétrie sortante (rare)
La plupart des déploiements SimHub sont unidirectionnels du PC vers la carte — la carte affiche / actionne ce que SimHub calcule. Le côté Tx des modules d'interface existe pour les rares cas qui nécessitent un canal montant :
- Accusés de réception — confirmer qu'une commande a été appliquée (certains modules compagnons en émettent automatiquement).
- Relecture de capteur — renvoyer une température, un gain de retour de force, une consommation de courant vers le tableau de bord de SimHub.
- Plugin personnalisé — un plugin SimHub écrit par l'utilisateur qui récupère l'état de la carte.
Câblez le buffer que vous voulez envoyer vers nSimHubInterface.Tx / nSimHubDevice.Tx. La documentation du plugin de données entrantes de SimHub couvre la façon dont le côté récepteur le lit.
Un exemple concret — LED de régime sur un bandeau RGB
Le « Hello World » de l'intégration SimHub : un bandeau WS2812 de 16 LED sur le volant affichant le régime moteur sous forme de barre de gauche à droite qui passe au rouge au point de changement de rapport.
nSimHubInterface(USB-CDC) →Rx→nSimHubInterfaceLeds(Type =Led Strip, Count = 16) →Part D→nFastLed(broche de données, type de LED WS2812B) → bandeau physique.
Côté SimHub :
- Dans SimHub, Add a new device → choisissez Arduino → Serial → COM port.
- Ouvrez le concepteur de LED, réglez le nombre de LED sur 16, dessinez un profil de barre de régime associé à la plage de régime de votre jeu.
- Cliquez sur Send to device — le bandeau s'allume.
Total : trois modules sur le canevas. Aucune écriture de firmware, aucun code de mappage de LED — nSimHubInterfaceLeds fait le décodage et pousse le nombre directement dans le pilote FastLed. Voir SimHub/Serial/Teensy32_PL9823_FastLeds ou SimHub/Serial/TeensyLC_WS2812Serial.
Un exemple concret — tableau de bord TM1637
Même principe, mais les données SimHub pilotent un afficheur TM1637 à 4 ou 6 chiffres montrant vitesse / rapport / delta de secteur.
nSimHubInterface→Rx→nSimHubInterfaceIn(Type =TM1637) →B+D→nTM1637(broches CLK / DIO) → afficheur physique.
La sortie B+D du module In est exactement la forme de buffer que nTM1637 attend — pas de séparation de buffer, pas de remappage. Voir SimHub/Serial/TM1637_6Digits.
Un exemple concret — volant complet avec USB-HID + LED
Un volant qui est à la fois un gamepad HID (boutons / encodeurs / palettes) et une cible LED SimHub :
nFFBHIDounHIDpour le côté gamepad (axes, boutons, hat).nSimHubInterfaceen parallèle, sur un point de terminaison série CDC, pour le côté LED.
Le type USB serait serialhid (HID + CDC), et SimHub capte le port série pour les commandes de LED pendant que le jeu voit le gamepad HID. Voir la famille TM*_Wheel_USB.txt sous SimHub/Serial/.
Un exemple concret — par voie hertzienne via NRF24
Une carte côté volant reçoit les données SimHub via une liaison hôte filaire (USB série), puis les relaie par radio NRF24 vers le volant réel posé sur la jante :
nSimHubInterface(sur la carte de liaison hôte) → les commandes SimHub arrivent → compagnon sélectionné → → → empaquetées dans un buffer →nNRF24(canal) → par voie hertzienne → carte réceptrice →nNRF24(canal correspondant) → pilote les LED / TM1637 / matrice côté volant.
Les variantes « +Radio » des fichiers d'exemple montrent exactement ce schéma — SimHub/Serial/Max7219_LedMatrixRadio, SimHub/Serial/RGBLedMatrixRadio.
Débogage
Les deux transports exposent des indicateurs de débogage par zone (Packet / Parser / Commands / Errors), activés en sélectionnant un port série de débogage dans le dialogue du module (généralement SerialUSB1 sur Teensy ou un UART matériel sur les autres cartes). Les indicateurs ajoutent des traces Serial.print des étapes de pipeline concernées — utile quand SimHub semble communiquer mais qu'aucune commande n'arrive à la carte.
Les indicateurs sont réservés aux administrateurs (masqués aux utilisateurs ordinaires) — ne les activez que pendant le débogage et retirez-les avant de partager le projet, sinon le trafic de débogage grignote le budget de la boucle.
Côté SimHub, la fenêtre de journal de SimHub (Settings → Logs) affiche chaque commande envoyée / reçue avec des horodatages — le premier endroit où regarder quand la poignée de main échoue.
Et ensuite
Avec les boutons, le FFB et SimHub couverts, le seul sujet sim racing restant est le moteur de point de patinage embrayage / palette — nClutchManager, qui a droit à son propre approfondissement dans Embrayage et bite point. Après cela, la page de test des contrôleurs de jeu est ce que vous utiliserez pour vérifier que tout fonctionne.