Encodeurs et entrées rotatives
NodeBlue regroupe trois familles de dispositifs rotatifs utilisés comme interface humaine (par exemple sur des façades ou des volants) ou comme capteur de position d'axe moteur lorsqu'ils offrent une haute résolution et sont sans crans. Ils se ressemblent, mais produisent des signaux très différents. Certains fournissent une position absolue, d'autres produisent des impulsions incrémentales +/−. En général, les encodeurs absolus ont des crans bien plus marqués entre les positions. Choisissez d'abord la famille qui correspond à votre matériel physique ; le bon module en découle.
- Les encodeurs incrémentaux signalent des changements — chaque pas de rotation est une paire d'impulsions en quadrature A/B ; compter les impulsions donne la position. Coupez l'alimentation et vous perdez la position. Boutons PEC11, encodeurs de type CTS, une roue optique sur un arbre de moteur.
- Les encodeurs absolus signalent directement la position courante. Allumez-les à n'importe quel angle et ils savent toujours où ils se trouvent. L'Alps EC18AG (code de Gray sur 4 bits).
- Les commutateurs rotatifs sont N contacts discrets, un par position crantée — naturellement absolus (le contact actif est la position courante). Lorsque le commutateur n'a pas de butée et peut tourner librement, le logiciel peut malgré tout le faire se comporter comme un encodeur incrémental.
Encodeurs incrémentaux
nRotaryEncoder (bouton mécanique avec crans)
Le petit bouton rotatif de type PEC11 avec bouton-poussoir et crans que l'on trouve sur la plupart des façades. nRotaryEncoder est un module modèle — en interne c'est un nRotKnob (qui compte les impulsions de l'encodeur pour en faire une valeur) alimentant un nPosToPulses (qui émet des impulsions incrémentales +/−), plus un lecteur de bouton-poussoir. La variante interne retenue dépend du type de dispositif configuré (Generic 1 ppd, Generic 2 ppd, CTS, Elma).
| Paramètre | Description |
|---|---|
| Pin A / B / Sw | Les trois GPIO (deux pour l'encodeur, une pour le bouton-poussoir). |
| Pulses per detent | À régler selon votre bouton — généralement 2 (les encodeurs les plus courants). Une mauvaise valeur donne par exemple « deux clics comptés par cran ». Les encodeurs CTS ont leur propre variante de timing. |
Voir : 02-Digital/RotaryEncoder.
nHWEncoder (décodeur matériel)
Lorsque le microcontrôleur dispose d'un périphérique décodeur de quadrature matériel (la plupart des puces Cortex-M4/M7, tous les Teensy 4.x, la famille SAMD51), nHWEncoder l'utilise. Les impulsions sont comptées dans le silicium, si bien que vous ne manquez jamais un pas, même à haut régime — idéal pour les encodeurs d'arbre moteur, les volants de sim-racing tournant vite et autres. Le signal d'index est utile pour compter les tours et disposer d'une référence absolue de position. Si l'encodeur est utilisé sur une base de volant, l'index devrait si possible être placé physiquement près du centre, de sorte qu'à l'initialisation la référence de position soit trouvée avec une rotation minimale.
| Paramètre | Description |
|---|---|
| Pin A / Pin B | Les broches de quadrature. Ce doivent être des broches utilisables par le périphérique matériel — l'IDE filtre le menu déroulant pour ne montrer que celles qui sont valides pour votre carte. |
| Index Pin | Optionnelle, disponible uniquement sur certains encodeurs, ce signal est déclenché une fois par tour. |
| Counts per revolution | Utilisé par l'IDE pour indiquer la position en degrés si vous le souhaitez. |
Examples/02-Digital/HWEncoder le montre en action.
Pour un angle absolu sans contact et sans le coût d'un encodeur industriel, le capteur magnétique rotatif AS5600 présenté dans le tutoriel Capteurs est souvent plus adapté — même bus I²C, résolution inférieure au degré (12 bits répartis sur 18° à 360°), aucun contact avec l'arbre.
Famille RotKnob
Les modules RotKnob sont des lecteurs d'encodeurs incrémentaux ; ils sont utilisés en interne dans les modules nRotaryEncoder. Leur rôle : lire les impulsions d'un encodeur et les compter dans une valeur courante.
| Module | Type d'encodeur |
|---|---|
| nRotKnob | Bouton en quadrature générique, 1 ou 2 impulsions par cran. |
| nRotKnobQS | Même famille avec le profil de timing « QS » (Quick Scan / variantes CTS spécifiques). |
| nRotKnobElma | Le timing d'impulsions des encodeurs rotatifs Elma — un profil mécanique/électrique différent du PEC11. |
La chaîne canonique :
bouton →
nRotKnob(compte les impulsions dans une valeur) →nPosToPulses(émet des impulsions plus larges, plus faciles à traiter en logiciel) → entrées de bouton HID up / down.
À comparer avec nEncoder / nHWEncoder, qui exposent directement la valeur comptée — utile lorsque vous n'avez pas besoin d'impulsions en sortie (une remise à l'échelle Range, un affichage de position, etc.).
Encodeurs absolus
nAbsEncoder
Lorsque la position DOIT survivre à une coupure d'alimentation, ou que l'on souhaite des crans marqués. nAbsEncoder lit un encodeur absolu numérique (dispositifs Alps EC18AG). L'encodeur utilise 4 broches pour coder 12, 15 ou 16 positions.
Voir Examples/02-Digital/AbsEncoder.
Commutateurs rotatifs et encodeurs absolus — nRotarySwitch
Un commutateur rotatif expose N positions discrètes, chacune reliée à son propre contact, avec une broche commune. Le câblage d'origine nécessite une broche numérique par position — douze GPIO pour un sélecteur à 12 positions. La réponse d'ElectroSeed (et de quelques circuits imprimés tiers similaires du marché) est une petite carte compagnon qui compresse ces N contacts en une seule tension analogique au moyen d'une échelle de résistances, de sorte que le firmware ne consomme qu'une seule broche analogique.
nRotarySwitch est le module modèle qui gère en un seul endroit chaque variante courante de cette idée :
| Type de dispositif | Matériel en coulisses |
|---|---|
| Commutateur rotatif générique + carte tierce à échelle de résistances | Les N contacts arrivent déjà encodés en une tension analogique sur une seule broche. |
| Commutateur rotatif + carte ElectroSeed à échelle de résistances | Même idée, avec l'amélioration de stabilité décrite ci-dessous. |
| Encodeur absolu Alps EC18AG | La pièce en code de Gray sur 4 bits déjà décrite dans nAbsEncoder ci-dessus — nRotarySwitch sait aussi l'encapsuler. |
Choisissez le type de dispositif dans la boîte de dialogue d'édition du module et nRotarySwitch sélectionne le bon lecteur / décodeur interne.
À partir de la sortie du modèle, vous partez ensuite dans l'une des deux directions en aval :
| En aval | Ce que cela vous donne |
|---|---|
Entrée select de nRotarySwitch → nMultiplexer / nDeMultiplexer | Chaque position achemine un appui de bouton (ou toute valeur) vers une sortie différente — N boutons HID, un par position du commutateur. |
nRotarySwitch → nPosToPulses → up / down HID | Le commutateur se comporte comme un encodeur incrémental — tourner d'une position dans le sens horaire émet une impulsion +, dans le sens antihoraire une impulsion −. N'a de sens que lorsque le commutateur peut tourner librement (sans butée) ; un commutateur borné arrivé à sa limite ne peut plus produire d'impulsions au-delà. |
Voir Examples/02-Digital/RotarySwitches.
Pourquoi la carte ElectroSeed n'est pas tout à fait comme les cartes tierces
Un commutateur rotatif standard est make-before-break ou break-before-make selon la pièce — dans les deux cas, lorsque l'axe est à mi-chemin entre deux positions, la broche commune est électriquement flottante. Les broches flottantes se comportent comme des antennes, et l'échantillon analogique prélevé à cet instant est essentiellement aléatoire — capté par les champs parasites du tracé, le ronflement du secteur, les commutations voisines, et ainsi de suite. Une carte à échelle de résistances ordinaire vous donnera des « positions fantômes » parasites chaque fois que l'utilisateur tourne au travers.
La carte ElectroSeed ajoute une résistance de tirage vers le bas (pull-down) sur la broche commune. Tant que l'axe est entre deux positions, la broche commune est désormais tirée proprement vers la masse ; le firmware lit 0 au lieu de valeurs aberrantes, et l'intervalle inter-positions est reconnu comme « aucune position pressée » plutôt que comme une position valide aléatoire. Comportement stable à chaque rotation, sans à-coups vers de mauvaises positions.
Quand contourner le modèle — nDigiPot
nRotarySwitch suffit dans presque tous les cas. Si vous voulez la valeur de position comptée sous forme de nombre au lieu de boutons HID ou d'impulsions — pour piloter une remise à l'échelle Range, un affichage, une machine à états, un multiplexeur qui choisit des valeurs et non des boutons — insérez directement nDigiPot. C'est le lecteur de plus bas niveau situé à l'intérieur de nRotarySwitch, exposé comme un module autonome qui se contente de sortir l'indice de position (0..N-1).
Position → impulsions — nPosToPulses
nPosToPulses transforme une valeur numérique en un train d'impulsions en sortie — une impulsion positive pour chaque incrément de hausse de la valeur, une impulsion négative pour chaque incrément de baisse.
nPosToPulses produit des impulsions d'une largeur fixe définie dans les paramètres du module — même largeur à chaque impulsion, quelle que soit la vitesse à laquelle la valeur amont change. Le consommateur en aval voit donc un train uniforme et prévisible qu'il ne peut pas manquer. Cette largeur fixe compte lorsque le consommateur est un hôte HID USB ou un jeu : les impulsions générées par le matériel sont parfois trop courtes pour que le logiciel les attrape toutes, surtout quand l'utilisateur tourne le bouton rapidement. Réémettre à une largeur choisie, suffisamment grande, signifie qu'aucune impulsion n'est perdue en aval.
Deux appariements canoniques :
- RotKnob → PosToPulses — voir la section RotKnob ci-dessus. Les crans d'encodeur comptés deviennent des impulsions plus larges, plus faciles à traiter en logiciel.
- nDigiPot → PosToPulses — voir la section nDigiPot. Un commutateur rotatif tournant librement peut piloter une entrée HID +/−.
Pour le « Funky switch » Alps RKJ (navigation 5 directions + encodeur dans une même pièce), voir le tutoriel dédié Joycoders, qui est la prochaine étape de la série.