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 :
| Module | Ce qu'il fait |
|---|---|
| OpGain / FloatGain | Multiplie l'entrée par un facteur de gain constant. |
| OpOffset / FloatOffset | Ajoute un décalage constant à l'entrée. |
| OpMixer / FloatMixer | Additionne plusieurs entrées (chacune avec son propre gain), une seule sortie. |
| FloatSum | Somme 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 :
| Module | Ce qu'il fait |
|---|---|
| Range | Remappage linéaire d'une plage numérique vers une autre (par exemple, ADC 0..65535 → pourcentage 0..100). |
| RangeModule | Même idée, mais avec la plage d'entrée apprise par calibration (parcourez-la une fois jusqu'à ses extrêmes, puis enregistrez). |
| RangeDeadZone | Remappage 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 %. |
| FloatRange | La variante à virgule flottante — pratique quand vous convertissez vers une unité physique (par exemple, code ADC → volts). |
Les paramètres de Range sont uniformes :
| Paramètre | Description |
|---|---|
| Min Ent. / Max Ent. | La plage d'entrée. |
| Min Sort. / Max Sort. | La plage de sortie vers laquelle elle est convertie. |
| Ecrêtage | Faut-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 comparaison | La 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 plage | L'entrée est comprise entre deux bornes. |
| Hors plage | L'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ètre | Description |
|---|---|
| Max | La valeur à laquelle le compteur reboucle (ou s'arrête, selon le mode). |
| Réinitialiser au dépassement | Faut-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.