Force Feedback
Le Force Feedback (FFB, retour de force) est la boucle fermée entre le simulateur et le volant : le jeu dit au volant « tu viens de heurter un vibreur », le volant actionne un moteur pour repousser les mains du pilote, et le pilote ressent le vibreur à travers sa prise. NodeBlue expose cette boucle sous la forme de deux modules — nFFBHID (le point de terminaison USB qui parle le dialecte HID de la classe Force Feedback) et nFFBEngine (le moteur de calcul qui transforme les messages FFB de l'hôte en une commande de couple pour un moteur).
Cette page est l'approfondissement vers lequel pointait le tutoriel Sim-Racing. Si vous n'avez pas encore lu HID et Moteurs, commencez par là — le FFB repose sur les deux.
Comment se déroule une session PC-FFB
Avant de regarder les modules, voici le protocole sur le fil :
- Le volant s'énumère sur l'USB en tant que périphérique HID avec la page d'usage Force Feedback. Son descripteur de rapport déclare non seulement des axes/boutons mais aussi un rapport de contrôle (effets, gains, conditions) et un rapport d'état (statut des effets).
- Le jeu découvre le périphérique via DirectInput (Windows) ou l'interface FF d'evdev (Linux) et téléverse des descripteurs d'effets — une force constante, un amortisseur, un ressort, un coefficient d'inertie, un périodique. Chaque effet reçoit un ID d'effet.
- Le jeu envoie ensuite des messages en temps réel : démarrer l'effet 3, arrêter l'effet 7, moduler le gain de l'effet 5 à 80 %. Ces messages arrivent au volant sous forme d'octets sur le point de terminaison de contrôle.
- Le firmware du volant lit ces messages, maintient une table interne des effets actifs, et à chaque tick de contrôle calcule un couple combiné sur l'ensemble des effets actifs, puis pilote le moteur avec ce couple.
- Le volant renvoie sa position de braquage au jeu dans son rapport d'entrée. Le jeu utilise cette position à la fois pour mettre à jour la simulation et pour calculer les effets dépendants de la position (une force de ressort dépend de l'écart par rapport au centre).
Le calcul de l'étape 4 est ce que fait nFFBEngine. Les étapes 1, 2, 3 et le flux de rapports de l'étape 5 sont ce que gère nFFBHID.
nFFBHID — le point de terminaison USB
nFFBHID est un cousin spécialisé de nHID / nHIDPro. Les modules HID ne peuvent déclarer que des axes et des boutons en entrée ; nFFBHID ajoute le flux de rapports FFB bidirectionnel au descripteur — un point de terminaison de sortie (Out) séparé dans lequel l'hôte écrit les commandes d'effets, plus le point de terminaison d'entrée (In) correspondant que le firmware utilise pour signaler le statut des effets.
Il force le type USB de la carte à customhid (ou les variantes serial*customhid*) car le descripteur qu'il construit n'est pas l'un des descripteurs préfabriqués standards — le descripteur de rapport FFB est généré sur mesure à partir des cases à cocher du dialogue.
Le sélecteur Type
Un seul réglage pilote presque tous les autres champs :
| Type | Ce que cela signifie |
|---|---|
| Generic | Un volant DirectInput / Windows-Force-Feedback classique. La plupart des champs sont visibles dans le dialogue. Le descripteur est construit à partir de votre sélection d'axes (X/Y/Z/Rx/Ry/Rz, deux sliders), du nombre de boutons, de la configuration du hat, plus l'ensemble d'effets FFB standards. Choisissez celui-ci sauf si vous avez une raison précise de ne pas le faire. |
| Fanatec Base | Un descripteur préfabriqué qui imite une base Fanatec de classe ClubSport / DD. Le pilote Fanatec le reconnaît comme l'un des siens — utile pour insérer une carte NodeBlue dans un écosystème Fanatec (une base personnalisée pour un volant Fanatec, par exemple). |
| Custom | Vous permet de spécifier chaque champ du descripteur à la main — VID/PID/bcdDevice, tailles des rapports d'entrée/sortie, régions d'entrée/sortie définies par le fabricant. À utiliser lorsque vous cherchez à imiter un volant tiers dont vous avez analysé le protocole. La plupart des garde-fous fournis par le mode Generic sont désactivés en mode Custom. |
Champs d'identité (Generic / Custom)
| Champ | Description |
|---|---|
| Name | La chaîne que le système d'exploitation affiche. |
| Vendor ID / Product ID | Les identifiants USB que l'hôte utilise pour associer les pilotes. Un volant auto-signé emprunte souvent le VID/PID d'un volant connu pour hériter de son pilote ; un volant sur mesure utilise la plage allouée de NodeBlue. |
| ID (bcdDevice) | Le champ « device-release » de deux octets du descripteur USB — l'hôte l'utilise pour distinguer les révisions de firmware partageant les mêmes VID/PID. Incrémenter ce champ permet au système d'exploitation de traiter un volant reflashé comme un « nouveau » périphérique nécessitant un ré-appairage dans le jeu. |
La même hiérarchie VID/PID s'applique que pour un HID ordinaire — voir la discussion sur l'identité du tutoriel HID.
Axes (Generic)
Les axes visibles sont le même ensemble sélectionnable que nHID : X, Y, Z, Rx, Ry, Rz, deux Sliders. Chacun peut être s8 (8 bits signés) ou s16 (16 bits signés). Les axes que vous ne sélectionnez pas sont absents du descripteur — l'hôte ne les verra pas.
L'axe de braquage (X) est celui que le FFB Engine relit comme position. Un FFB à deux axes (le rumble d'une palette de vitesses, par exemple) utilise nFFBEngine avec Nb Axis = 2 et un second axe déclaré ici.
Boutons, hat, régions fabricant
| Champ | Description |
|---|---|
| Buttons | Nombre de boutons HID déclarés. Le champ compacté en bits correspondant se trouve dans le rapport d'entrée, exactement comme pour un HID ordinaire. |
| Hat | 0 ou 1 — ajoute un usage hat de 4 bits s'il est activé. |
| Vendor input 1 / 2 | Octets de région d'entrée « définie par le fabricant » — opaque pour les pilotes standards, utilisée pour transporter de la télémétrie vers un pilote spécifique au fabricant. |
| Vendor output | Idem, pour le sens de sortie (commandes spécifiques au fabricant venant de l'hôte). |
| Config Report | Octets du rapport de configuration fabricant — piloté par la seconde paire de ports d'entrée/sortie de nFFBHID (Conf In / Conf Out). Utile pour des canaux de configuration en bande, séparés du flux FFB. |
Entrées / sorties
| Port | Direction | Ce qu'il transporte |
|---|---|---|
In | Entrée buffer | Le rapport d'entrée HID que vous assemblez en aval de nBitPacker + nSerializer — axes, boutons, hats. Règles de compactage identiques à nHID. |
Conf | Entrée buffer | Le rapport d'entrée de configuration fabricant (quand Config Report > 0). |
Out | Sortie buffer | Le rapport de sortie HID venant de l'hôte — c'est là qu'arrivent les commandes d'effets FFB. Câblez ceci vers l'entrée Report de nFFBEngine. |
Conf | Sortie buffer | Le rapport de sortie de configuration fabricant (quand il est activé). |
Le sélecteur Type dans le dialogue masque tous les champs qui ne sont pas pertinents pour le mode choisi — le nombre de champs en mode Generic est élevé car il dispose de l'ensemble standard ; Custom les affiche tous ; Fanatec Base n'en affiche presque aucun (le descripteur est figé).
nFFBEngine — le calculateur de couple
nFFBEngine est une machine à états unique à fréquence fixe. Il consomme le flux de rapports FFB de l'hôte et la position en direct de l'encodeur, et émet une commande de couple à chaque tick Sync.
Entrées
| Entrée | Type | Ce que c'est |
|---|---|---|
Report | cBuffer | Le rapport de sortie FFB tel qu'il arrive de l'hôte via nFFBHID.Out. |
X (et Y pour 2 axes) | s32 | La position actuelle de l'arbre, sous forme de valeur de compteur. Généralement câblée depuis nHWEncoder pour un encodeur en quadrature, ou depuis un nAS5600 pour un capteur magnétique absolu — tout ce qui fournit une position entière par tick. |
Sorties
| Sortie | Type | Ce que c'est |
|---|---|---|
Cmd X (et Cmd Y) | s32 | Commande de couple signée. Négatif = « pousser l'arbre dans le sens antihoraire », positif = « le pousser dans le sens horaire ». La valeur absolue est l'intensité de la commande — son échelle dépend du pilote de moteur en aval. |
Paramètres
| Paramètre | Description |
|---|---|
| Nb Axis | 1 ou 2 — un volant à un axe est le cas courant ; les projets à deux axes sont rares (une combinaison retour de force braquage + pédale, un manche d'aviation). |
| Control Freq. | La cadence de calcul du couple, en Hz. Défaut 1000 Hz — la référence absolue pour le FFB. Des fréquences plus basses (250, 500) fonctionnent mais perdent du détail dans les effets à haute fréquence ; des fréquences plus élevées (2 kHz) nécessitent un MCU rapide. |
| Encoder PPR | Impulsions par tour sur le tour mécanique complet de l'arbre. Essentiel pour que le moteur sache « quelle est la taille d'un degré » — le calcul du ressort / amortisseur / inertie se fait en interne en unités d'encodeur, mais les paramètres visibles par l'utilisateur (raideur du ressort du jeu, etc.) sont en unités physiques. Défaut 10 000. |
Le moteur maintient en interne l'ensemble complet des effets DirectInput — Constant, Ramp, Spring, Damper, Inertia, Friction, Sine, Square, Triangle, Sawtooth Up / Down. Le jeu les téléverse, le moteur les ajoute à sa table ; à chaque tick il parcourt la table, calcule la contribution de chaque effet à la position actuelle de l'arbre, et les additionne dans la sortie Cmd. Aucune configuration des effets côté NodeBlue n'est nécessaire — le jeu en est le propriétaire.
Réglage par effet (côté hôte)
La manière dont un utilisateur final ajuste le ressenti (« moins de ressort », « couper le rumble », « mettre tous les effets à l'échelle 70 % ») passe par les paramètres d'effets DirectInput définis par le jeu — la plupart des simulateurs exposent un menu pour cela. NodeBlue ne cherche pas à deviner à la place du jeu ; si vous voulez un bouton de gain principal dans le firmware, insérez un multiplicateur entre nFFBEngine.Cmd et le pilote de moteur.
La chaîne FFB complète
Un volant minimal à un axe :
Relecture de position : encodeur d'arbre →
nHWEncoder(Out= compteur, s32) →nFFBEngine.Xet →nRange→nFFBHID.In(l'axe X déclaré en s16).Boutons / hat :
nButton × N→nBitPacker→nSerializer(comme pour un HID ordinaire) →nFFBHID.In(assemblé avec les octets d'axes en amont).FFB descendant :
nFFBHID.Out(rapport d'effets de l'hôte) →nFFBEngine.Report.Commande moteur :
nFFBEngine.CmdX(couple s32) → entrée du pilote de moteur (voir Moteurs) — par ex. l'entréeTorqued'unnSimpleMotion, ou un pilote de servomoteur DC en boucle fermée.
Côté type USB, réglez sur customhid (sans interfaces supplémentaires) ou sur l'une des variantes serialcustomhid* si vous voulez aussi un port série de débogage actif.
Voir Examples/09-USB/FFBWheel pour un projet minimal complet, et Examples/09-USB/FFBWheel_Test pour un banc de test avec entrées simulées.
Notes de réglage
- Un Encoder PPR mal accordé avec le rapport mécanique réel donne un ressenti irréel. Un effet de ressort où l'hôte s'attend à « 5° = pleine force » devient « 0,5° = pleine force » si le PPR est erroné — le volant se claque au centre avec un couple violent au moindre petit décalage. Calibrez le PPR par rapport à la plage de rotation physique avant de vous battre avec l'intensité des effets.
- Une fréquence de contrôle inférieure à 1 kHz produit des artefacts audibles dans les effets périodiques (Sine, Square — ressentis comme un bourdonnement à la fréquence d'aliasing). Restez à 1 kHz sauf si le MCU ne peut pas suivre le reste du projet à cette cadence.
- Le pilote de moteur doit accepter des commandes de couple signées à la même cadence. Un pilote qui ne se met à jour qu'à 100 Hz jette la majeure partie de ce que
nFFBEnginecalcule — associez le moteur à un pilote fonctionnant à ≥ Control Freq. - La précision de la relecture de position borne la qualité des effets. Un encodeur bruité ou à faible PPR rend le ressort granuleux au toucher. La cible d'ordre de grandeur pour un volant compétitif est de 10 000+ PPR côté arbre.
Quand choisir FFBHID plutôt que les modules propres à un écosystème
nFFBHID est un périphérique FFB DirectInput générique — fonctionne dans tous les simulateurs qui prennent en charge le FFB, sans pilote nécessaire au-delà de la pile HID du système d'exploitation. Le compromis est que l'utilisateur doit choisir l'intensité des effets dans le menu de réglages du jeu lui-même (le volant n'expose pas d'interface de pilote).
Si vous construisez un volant qui doit s'intégrer à un écosystème spécifique (Fanatec, Thrustmaster, Simagic) — pour une intégration plus étroite, l'interface du pilote affichant votre volant comme « Fanatec ClubSport », des profils par jeu gérés dans l'application du fabricant — utilisez plutôt les modules propres à l'écosystème du tutoriel Sim-Racing.
nFFBHID Type = « Fanatec Base » est le juste milieu : un descripteur au goût Fanatec sans le protocole complet de l'écosystème Fanatec en dessous — fonctionne pour des intégrations simples mais pas pour une fidélité complète de l'interface du pilote.
Modules complémentaires pilotés par la télémétrie (page suivante)
Une amélioration courante une fois que le volant fonctionne en jeu consiste à ajouter des LED pilotées par la télémétrie et un écran de tableau de bord — pilotés par la télémétrie du jeu, non par les messages FFB. Cette couche est ce que couvre ensuite l'Intégration SimHub.