Aller au contenu principal

Opérateurs et mathématiques

Les portes logiques gèrent les décisions 0/1 ; ce qui gère les valeurs, c'est le groupe des opérateurs — gain, décalage, mélange, comparaison, conversion de plage, filtrage passe-bas et les quelques utilitaires qui ne rentrent nulle part ailleurs. Ce sont les petites boîtes noires qui transforment les lectures brutes des capteurs en un nombre propre sur lequel un module en aval pourra agir.

Le groupe se divise nettement selon le type de données. Les opérateurs entiers (u8 / s16 / u16 / u32) restent dans le domaine entier et s'exécutent un poil plus vite ; les variantes Float effectuent leurs calculs en f32 et acceptent des entrées à virgule flottante. Choisissez celle qui correspond au reste de votre chaîne de signal — l'IDE affiche la couleur des ports pour que vous voyiez d'un coup d'œil si deux ports parlent le même type.

Bases arithmétiques​

Ces quatre-là couvrent l'essentiel de ce dont vous aurez besoin :

ModuleCe qu'il fait
OpGain / FloatGainMultiplie l'entrée par un facteur de gain constant.
OpOffset / FloatOffsetAjoute un décalage constant à l'entrée.
OpMixer / FloatMixerAdditionne plusieurs entrées (chacune avec son propre gain), une seule sortie.
FloatSumSomme multi-entrées triviale (sans gain par entrée).

Mixer est le cheval de bataille pour la fusion de capteurs, le fondu enchaîné de type audio, la sommation simple de type PID, et toute combinaison « a · x + b · y + c · z » — son paramètre inputs augmente via clic droit → Add Input, comme les portes logiques.

Le projet Examples/05-Control/P_Controller illustre un régulateur proportionnel construit à partir d'un Gain et d'un Mixer.

Conversion de plage​

Les signaux réels arrivent rarement dans les unités qu'attend un module en aval. Les ADC vous donnent 0..65535 ; le tableau de bord veut 0..100 ; une PWM veut 0..255. La famille Range convertit entre elles :

ModuleCe qu'il fait
RangeRemappage linéaire d'une plage numérique vers une autre (par exemple, ADC 0..65535 → pourcentage 0..100).
RangeModuleMême idée, mais avec la plage d'entrée apprise par calibration (parcourez-la une fois jusqu'à ses extrêmes, puis enregistrez).
RangeDeadZoneRemappage de plage avec des zones mortes configurables aux extrémités basse et haute de la course — conçu pour les pédales, afin que les butées mécaniques indiquent de façon fiable 0 % et 100 %.
FloatRangeLa variante à virgule flottante — pratique quand vous convertissez vers une unité physique (par exemple, code ADC → volts).

Les paramètres de Range sont uniformes :

ParamètreDescription
Min Ent. / Max Ent.La plage d'entrée.
Min Sort. / Max Sort.La plage de sortie vers laquelle elle est convertie.
EcrêtageFaut-il écrêter les sorties qui tombent en dehors de Min Sort. / Max Sort., ou extrapoler.

L'entrée Calibrer de RangeModule est ce qui le rend spécial : envoyez une impulsion sur l'entrée de calibration pour entrer en mode apprentissage, balayez la source jusqu'à ses extrêmes physiques, puis envoyez une nouvelle impulsion pour en sortir. Les min/max ainsi appris sont sauvegardés en EEPROM et appliqués au démarrage suivant. C'est exactement ainsi que fonctionne la calibration des axes de contrôleur de jeu de l'IDE.

Lissage — FloatIIRFilter​

Les capteurs bruités (cellules de charge, magnétomètres, tout ce qui est analogique à gain élevé) ont besoin d'un lissage avant que vous n'agissiez d'après eux. FloatIIRFilter est un passe-bas à réponse impulsionnelle infinie du premier ordre — un seul réglage (la constante de temps ou alpha) et une valeur en entrée, une valeur lissée en sortie.

Le compromis est le classique : une constante de temps plus longue lisse davantage mais ajoute plus de retard. Commencez avec une valeur de l'ordre de 100 ms pour un capteur que vous afficherez, 10 ms pour un élément d'une boucle de contrôle temps réel, puis affinez à partir de là.

Comparateur​

Parfois, vous avez besoin d'une réponse booléenne à partir d'une valeur : « est-ce au-dessus d'un seuil ? », « est-ce entre ces deux bornes ? ». Le Comparateur fait cela.

Mode de comparaisonLa sortie vaut 1 quand…
> / <L'entrée est au-dessus / en dessous d'un seuil configuré.
>= / <=Idem, inclusif.
== / !=L'entrée est égale à / diffère d'une valeur cible.
Dans la plageL'entrée est comprise entre deux bornes.
Hors plageL'entrée est en dehors de deux bornes.

Un Comparateur alimentant un Edge vous donne l'instant où un seuil est franchi — typique pour déclencher un relais, envoyer une alerte ou incrémenter un compteur.

Compteur​

Le module Counter compte les événements sur son entrée. Chaque front montant de l'entrée incrémente le compteur interne ; atteindre le maximum configuré peut, au choix, provoquer un rebouclage ou déclencher une impulsion de sortie.

ParamètreDescription
MaxLa valeur à laquelle le compteur reboucle (ou s'arrête, selon le mode).
Réinitialiser au dépassementFaut-il reboucler à 0 ou s'arrêter.

Associez-le à un Edge lorsque l'entrée est un niveau (un bouton), afin de compter les appuis plutôt que toute la durée pendant laquelle le bouton est maintenu. La conception Examples/01-Basics/Counter en est la démonstration minimale.

TypeCast​

Lorsque deux modules parlent des types numériques différents, TypeCast est le convertisseur explicite. La plupart du temps, la correspondance des couleurs de fils de NodeBlue rend la conversion automatique ; recourez à TypeCast quand vous voulez contrôler explicitement l'arrondi, le caractère signé ou la saturation (par exemple, un f32 provenant d'un filtre vers un u16 pour un registre PWM).

Constant et Sync​

Deux petits utilitaires qui complètent le groupe :

  • Constant — émet une valeur numérique fixe, configurée dans ses paramètres. Pratique comme le « b » dans a + b (associé à un Mixer ou un Offset) lorsque la valeur est réglée à la main plutôt que lue quelque part.
  • Sync — la source de synchronisation nommée abordée dans Timers / Signaux de synchronisation. Piloté une fois par un timer, référencé par son nom depuis de nombreux consommateurs.

Une fois qu'une valeur est mise en forme comme vous le souhaitez, la prochaine chose que vous ferez souvent est de la transformer en quelque chose de lisible par un humain — voir Chaînes et texte.