Test des contrôleurs de jeu
L'onglet Contrôleurs de la barre latérale droite est un testeur en direct pour les contrôleurs de jeu USB / BLE — manettes, joysticks, volants de sim-racing — connectés à votre ordinateur. Vous l'utiliserez chaque fois que vous construirez un périphérique HID avec NodeBlue (voir Construire des périphériques USB HID) pour vérifier que les boutons, les croix directionnelles et les axes rapportent bien ce que votre firmware prévoyait.
Lorsque le contrôleur connecté se trouve être une carte NodeBlue exécutant son propre firmware, l'onglet fait également apparaître le panneau côté IDE pour l'administration de la carte : version du firmware, projet à partir duquel le firmware a été compilé, zones mortes / inversion / calibration par axe, édition optionnelle de courbes spline non linéaires, et mise à jour du firmware en un clic.
L'onglet fonctionne dans les navigateurs qui prennent en charge WebHID (Chrome / Edge 89+). Sans WebHID, le Board Server doit être en cours d'exécution — voir Installation du Board Server. Les contrôleurs BLE (NRF52 BLE-Gamepad / -Keyboard) fonctionnent également via Web Bluetooth.
Ouvrir l'onglet et associer un contrôleur
Cliquez sur Contrôleurs dans la barre latérale droite. Si aucun contrôleur n'est détecté, l'onglet affiche un message et un bouton Associer une manette — cliquez dessus et sélectionnez votre appareil dans la boîte de dialogue d'association du navigateur.
Les contrôleurs USB peuvent aussi être simplement branchés, et l'onglet les découvrira en environ 2 secondes.
L'en-tête du contrôleur
En haut de l'onglet :
| Élément | Ce qu'il affiche |
|---|---|
| Menu déroulant | Tous les contrôleurs connus — choisissez celui que l'onglet affiche actuellement. Le choix est mémorisé d'un rechargement à l'autre. |
| Ligne VID / PID | Le Vendor ID et le Product ID sur 16 bits du contrôleur sélectionné (en hexadécimal). Pour les contrôleurs Bluetooth, une petite étiquette BT apparaît à côté des valeurs. Masquée lorsque le VID et le PID sont tous deux nuls (certains contrôleurs virtuels / hubs). |
La ligne VID/PID est le moyen le plus simple de confirmer que l'identité d'une carte correspond au firmware compilé — particulièrement utile pour les appareils BLE où le PnP-ID annonçant le VID/PID est quelque chose que le firmware définit explicitement.
État en direct
Pour chaque contrôleur, l'onglet affiche trois familles d'entrées :
Boutons
Chaque bouton est une case numérotée. Appuyé → vert. Relâché → gris. Utile pour vérifier les correspondances bouton-broche au fur et à mesure du câblage.
Croix directionnelles POV
Si le contrôleur expose une croix directionnelle POV, elle apparaît sous la forme de huit flèches directionnelles autour d'un point central. La direction actuellement appuyée s'allume.
Axes analogiques
Chaque ligne d'axe contient :
- Le nom de l'axe.
- Une valeur numérique (dans l'unité sélectionnée ci-dessous).
- Une barre montrant la position actuelle sur toute sa plage.
- Un petit bouton graphique (
~) à droite — cliquez pour déplier / replier un graphique d'historique défilant propre à l'axe.
Unités des axes
Utilisez le menu déroulant Axis Units pour changer la façon dont les valeurs des axes sont affichées :
| Unité | Description |
|---|---|
| None | Aucun affichage numérique. |
| Raw | Valeur brute non signée (0..65535). |
| Raw Signed | Valeur signée (-32768..32767). |
| Percentage | 0..100 %. |
| Voltage (1.2 V – 5 V) | Mise à l'échelle sur les tensions de référence ADC courantes — confirme la correspondance ADC → HID du firmware par rapport à un multimètre. |
Panneau latéral de la carte NodeBlue
Lorsque le contrôleur connecté est une carte NodeBlue (c'est-à-dire une carte exécutant un firmware NodeBlue qui expose une interface USB-HID Config, ou un périphérique NodeBlue associé en BLE), un bloc supplémentaire apparaît sous le menu déroulant avec :
| Champ | D'où il provient |
|---|---|
| Nom de la carte | Recherché dans board_defs.js à partir du VID/PID du contrôleur. |
| Version du firmware | Lue en direct sur la carte via le protocole NBI (le même canal que celui utilisé par le tableau de bord). |
| Projet | Le projet à partir duquel le firmware a été compilé — nom et numéro de projet — tous deux cliquables : cliquer sur le nom du projet l'ouvre dans l'éditeur. |
| Lien Mise à jour disponible | Affiché uniquement lorsque le serveur dispose d'une version du firmware strictement plus récente pour cette carte que celle qu'elle exécute actuellement. Cliquer dessus lance le processus de mise à jour dans le navigateur (aucun pilote requis). |
Mise à jour du firmware en un clic
Lorsqu'un lien Mise à jour disponible est affiché :
- Cliquez dessus.
- L'IDE fait passer la carte en mode bootloader (réinitialisation HID, puis établissement de la liaison avec le bootloader WebUSB / WebSerial selon la famille de la carte).
- Le nouveau firmware est flashé.
- La carte se ré-énumère avec la nouvelle version, et le champ de version se met à jour sur place.
Le processus de mise à jour restaure l'EEPROM (paramètres de calibration / zone morte / inversion / spline) lorsque la famille de la carte le prend en charge — votre réglage survit à la mise à jour.
Réglage par axe — zones mortes, inversion, calibration, spline
Pour chaque axe que la carte NodeBlue connectée déclare comme réglable, la ligne reçoit une deuxième bande de commandes sous la barre :
| Commande | Effet |
|---|---|
| Bouton Calibrer | Lance la routine de calibration sur la carte pour cet axe — balayez l'axe sur ses extrêmes physiques (butées gauche/droite, course complète de la pédale), cliquez à nouveau sur Arrêter Cal et la carte enregistre le min/max appris dans l'EEPROM. |
Zone morte basse (%) | Pourcentage de la course ignoré à l'extrémité basse (la valeur au bas de la barre). Étirée : toute la plage de sortie reste atteinte au-delà de la zone morte. Enregistrée à chaque modification. |
| Case à cocher Inverser | Inverse la polarité de l'axe. Enregistrée à chaque modification. |
Zone morte haute (%) | Symétrique de la Zone morte basse, en haut de la course. |
Les valeurs que vous définissez sont écrites immédiatement sur la carte via la liaison NBI, et enregistrées dans son EEPROM côté carte — aucune recompilation du firmware n'est nécessaire. C'est le même modèle de persistance que celui utilisé par la calibration nRangeModule.
Éditeur de spline — courbes de réponse non linéaires
Lorsque le firmware de la carte utilise une nCubicSpline sur l'axe, un bouton S supplémentaire apparaît à droite de la bande de commandes. Cliquez dessus pour ouvrir un éditeur de spline en ligne :
- Les points de contrôle X / Y de la spline sont dessinés par-dessus la correspondance entrée → sortie.
- Faites glisser les points pour remodeler la courbe, ajoutez ou supprimez des points, saisissez des valeurs exactes.
- Les modifications sont écrites en direct dans l'EEPROM de la carte — enregistrées immédiatement.
Utilisation typique : une pédale de frein à cellule de charge où la spline façonne la relation force vs. pression — souple en haut de la course, progressive une fois que la pédale mord, linéaire jusqu'à la zone de blocage.
Plusieurs contrôleurs
Plusieurs contrôleurs connectés en même temps ? Le menu déroulant de l'en-tête les liste tous — choisissez celui à afficher. L'onglet mémorise votre sélection d'un rechargement à l'autre, indexée sur le VID/PID du contrôleur, de sorte que l'état de visibilité du graphique / choix d'unité propre à chaque contrôleur survit aux débranchements et aux actualisations.
La mettre en pratique
Une boucle d'itération typique lors de la construction d'un périphérique HID :
- Câblez vos boutons / capteurs / encodeurs dans un
nHIDsur le canevas. - Téléversez le firmware.
- Ouvrez l'onglet Contrôleurs — le nouvel appareil apparaît.
- Appuyez sur chaque bouton, vérifiez que la bonne case devient verte ; bougez chaque axe, observez la barre se déplacer ; vérifiez que la valeur est dans la plage attendue en utilisant au besoin les unités Voltage / Percentage.
- Si une valeur est hors limites, ajustez le module Range / RangeDeadZone du projet, puis téléversez à nouveau. Une fois satisfait, définissez la zone morte + l'inversion + la calibration persistantes depuis l'onglet Contrôleurs lui-même.
C'est le bon moment pour revenir à Construire des périphériques USB HID et appliquer ce que le testeur a confirmé.