Aller au contenu principal

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.

Prérequis

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émentCe qu'il affiche
Menu déroulantTous les contrôleurs connus — choisissez celui que l'onglet affiche actuellement. Le choix est mémorisé d'un rechargement à l'autre.
Ligne VID / PIDLe 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
NoneAucun affichage numérique.
RawValeur brute non signée (0..65535).
Raw SignedValeur signée (-32768..32767).
Percentage0..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 :

ChampD'où il provient
Nom de la carteRecherché dans board_defs.js à partir du VID/PID du contrôleur.
Version du firmwareLue en direct sur la carte via le protocole NBI (le même canal que celui utilisé par le tableau de bord).
ProjetLe 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 disponibleAffiché 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é :

  1. Cliquez dessus.
  2. 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).
  3. Le nouveau firmware est flashé.
  4. 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 :

CommandeEffet
Bouton CalibrerLance 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 InverserInverse 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 :

  1. Câblez vos boutons / capteurs / encodeurs dans un nHID sur le canevas.
  2. Téléversez le firmware.
  3. Ouvrez l'onglet Contrôleurs — le nouvel appareil apparaît.
  4. 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.
  5. 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é.