Aller au contenu principal

Joycoders (Alps RKJ « Funky Switch »)

Un Joycoder est le funky switch que l'on retrouve sur beaucoup de button boxes de sim-racing, de stream decks de milieu de gamme et de panneaux similaires — la famille RKJ-XT d'Alps. Mécaniquement, il s'agit d'une seule tête actionnable au pouce qui combine deux entrées :

  • un commutateur de navigation 5 directions — poussez la tête vers le Haut / la Gauche / le Bas / la Droite ou enfoncez-la tout droit (centre) ;
  • un encodeur rotatif mécanique (1 impulsion par cran) autour du même axe.

En sortie de composant, cela fait 9 contacts (5 directionnels, 2 A/B d'encodeur, plus 2 communs). NodeBlue fournit un module pour le Joycoder — nJoycoder — qui suppose l'utilisation du PCB ElectroSeed. Lorsque la carte dispose d'assez de broches pour câbler le RKJ directement, vous vous passez du template et construisez la chaîne à partir des primitives ; un exemple montre le procédé.

Deux façons de le câbler​

CâblageGPIOCôté NodeBlueQuand
Via le PCB ElectroSeed3 broches — 1 analogique + 2 numériquesModule template nJoycoder.Par défaut. Tout projet utilisant une carte préfabriquée — vous insérez le PCB dans votre assemblage et câblez 3 broches vers le microcontrôleur.
Direct, sans PCB7 broches — 5 numériques (directions) + 2 numériques (A/B d'encodeur)Pas de module dédié : assemblez la chaîne à la main. Voir l'exemple JoycoderRaw pour la disposition canonique.Uniquement lorsque vous concevez votre propre PCB et disposez des broches de microcontrôleur en réserve. Le RKJ n'est pas un composant CMS, mais ses broches sont courtes et ne sont pas prévues pour être soudées à des fils — sans PCB sur lequel les poser, le câblage manuel n'est pas praticable.

Le PCB ElectroSeed à échelle de résistances​

Le PCB compagnon vendu par ElectroSeed fonctionne ainsi :

  • Chacun des 5 contacts directionnels est câblé au rail commun via une résistance différente dans une échelle de résistances.
  • Le contact qui est fermé tire la sortie analogique vers sa propre tension — cinq niveaux de tension distincts, plus un niveau « aucun bouton pressé ».
  • La broche analogique échantillonne cette tension ; le firmware identifie quel bouton est enfoncé selon la plage de tension dans laquelle l'échantillon tombe.
  • Le PCB ne gère que les boutons directionnels. Les deux broches d'encodeur (A / B) sortent directement du PCB vers des GPIO numériques — le signal rotatif est trop rapide et trop codé en quadrature pour être compressé à travers l'échelle de résistances.

Le PCB ajoute aussi une résistance de tirage vers le bas sur la broche commune — la même correction de stabilité décrite dans la section commutateur rotatif du tutoriel Encodeurs : entre deux états de bouton, le commun est flottant et capterait du bruit comme une antenne ; le tirage vers le bas le fixe à la masse pour que la lecture analogique soit 0 (aucun bouton), jamais une direction fantôme.

Résultat : cinq boutons lus avec une seule broche analogique, l'encodeur conservé sur ses deux broches numériques natives — 3 broches au total.

Fonctionnement interne de nJoycoder​

nJoycoder est un module template — sous le capot, il câble ensemble une petite chaîne fixe que vous pourriez en principe construire à la main :

nAnalogInput (échantillonne la tension de l'échelle) → nResLadder (décide auquel des 5 boutons cette tension correspond) → nDeMultiplexer (répartit le bouton actif vers une sortie par direction) → les cinq sorties de bouton.

Séparément : broches A / B de l'encodeur → nRotKnob (1 ppd, compte les impulsions de l'encodeur dans une valeur) → nPosToPulses (émet les sorties Inc / Dec sous forme d'impulsions plus larges et plus faciles à traiter par logiciel — voir le tutoriel encodeurs → Position → impulsions).

Câbler des entrées dans le template masque tout cela entièrement ; l'utilisateur ne voit que les 7 ports de sortie.

Le câblage « direct » (sans PCB) nécessite la même chaîne, mais avec l'étage d'entrée à échelle de résistances remplacé par cinq entrées numériques ordinaires. L'exemple JoycoderRaw montre exactement cette disposition.

Paramètres​

ParamètreDescription
Broche (analogique)Broche ADC lisant la tension de l'échelle de résistances.
Broche A / Broche BGPIO numériques lisant les signaux en quadrature de l'encodeur.
Pulse durationLargeur (en dizaines de µs) de chaque impulsion de sortie Inc / Dec — voir nPosToPulses. Même sémantique de largeur fixe pour chaque impulsion.
Anti RebondTemps d'anti-rebond des boutons directionnels, en ms.
Moyenne / Ref ADC / Résolution ADCRéglage de l'étage d'entrée analogique pour la lecture de l'échelle de résistances.

Sorties​

SortieCe qu'elle transporte
Up / Left / Down / Right / PushÉtats des boutons directionnels (0 / 1), chacun sur son propre port — à câbler directement dans les boutons HID correspondants.
IncUne impulsion par cran horaire — à câbler dans un bouton HID que vous utiliserez comme « haut ».
DecUne impulsion par cran anti-horaire — à câbler dans un bouton HID que vous utiliserez comme « bas ».
msgUn flux d'état / diagnostic, surtout utile pendant la mise en route d'une carte.

Pour un gamepad USB, la chaîne canonique est le motif de tampon du tutoriel HID — signaux de bouton → nBitPacker → nSerializer → nHID — avec les sept sorties du Joycoder alimentant le nBitPacker.

Exemples​

  • Examples/02-Digital/Joycoder — le parcours PCB ElectroSeed utilisant le template nJoycoder : une broche analogique + deux broches d'encodeur.
  • Examples/02-Digital/JoycoderRaw — câblage direct à sept broches sans échelle de résistances, construit à la main à partir des primitives. Utilisez-le comme modèle pour les cartes disposant de broches en réserve. Le fichier examples/09-USB/RKJXT1F42001 est le même projet, copié dans le dossier USB sous la référence Alps afin qu'il soit également repérable lorsque vous parcourez les exemples HID.

Suite : Plage, calibration et spline — transformer les valeurs brutes issues de chaque périphérique d'entrée en signaux propres, calibrés et prêts à être exploités en aval.