Empaquetage de données
Lorsque des valeurs passent d'un monde à l'autre — de la sortie d'un module vers un tampon, vers un transport, puis de l'autre côté à nouveau vers des valeurs individuelles — elles doivent être empaquetées à une extrémité et désempaquetées à l'autre. NodeBlue fournit un jeu de modules restreint mais polyvalent, exactement pour cela.
Serializer / UnSerializer — valeurs ↔ tampon
La paire la plus simple : prendre plusieurs valeurs typées et les concaténer en un seul tampon ; à l'autre extrémité, redécouper le tampon en valeurs d'origine.
| Module | Ce qu'il fait |
|---|---|
| nSerializer | N entrées typées → 1 tampon en sortie. Les octets de chaque entrée sont ajoutés au tampon dans l'ordre. |
| nUnSerializer | 1 tampon en entrée → N sorties typées. Le tampon est redécoupé selon les mêmes limites. |
Tous deux exposent le type de chaque port (de sorte qu'un seul Serializer peut mélanger un u16, un f32 et trois u8 dans un même tampon). Tous deux ont un paramètre Sync (typiquement InputSync) et un nombre de ports configurable.
Usage typique :
- Plusieurs capteurs → un paquet sans fil. Six valeurs d'axes → Serializer → entrée NRF24. Récepteur : sortie NRF24 → UnSerializer → six valeurs d'origine.
- Envoyer une structure sur UDP / MQTT. Même schéma avec des modules UDP / MQTT à la place du NRF24.
Empaquetage au niveau bit — BitPacker / BitUnPacker
Lorsque vous n'avez pas des octets entiers à gaspiller — un octet d'état où 8 booléens partagent un seul u8, une lecture 12 bits serrée à côté d'un champ 4 bits, seize boutons tassés dans deux octets — les modules d'empaquetage au niveau bit sont la réponse la plus propre.
| Module | Ce qu'il fait |
|---|---|
| nBitPacker | N entrées → un tableau d'octets empaqueté de ⌈total bits / 8⌉ octets. Chaque entrée est associée à une plage de bits configurable ; dès que le total dépasse 8 bits, le tableau s'agrandit simplement d'un octet supplémentaire. La sortie est toujours un tableau d'octets, elle s'insère donc dans un Serializer / Multiplexer / transport radio sans conversion supplémentaire. |
| nBitUnPacker | L'inverse : une valeur empaquetée → N sorties, chacune extraite d'une plage de bits configurée. |
Chaque port a un décalage de bit et une largeur de bit ; le module décale et masque pour vous, en étendant le signe lorsque le champ est signé.
Buffer Split / Merge / Not / Permute
Un second groupe opère sur des tampons entiers plutôt que sur des champs individuels.
| Module | Ce qu'il fait |
|---|---|
| nBufferSplit | Découpe un tampon en N morceaux à des décalages d'octets configurés. Chaque morceau apparaît sur sa propre sortie. |
| nBufferSplitCustom | Même idée mais les points de découpe sont dynamiques, pilotés depuis une entrée de contrôle. À utiliser pour des trames de longueur variable. |
| nBufferMerge | L'inverse — concatène N tampons en entrée en un seul tampon de sortie. |
| nBufferNot | Inverse bit à bit chaque octet d'un tampon. Utile pour les protocoles actifs à l'état bas, une obfuscation simple, ou pour piloter certains rubans de LED qui attendent le motif de bits inversé. |
| nBufferPermute | Réordonne les octets d'un tampon selon une table de permutation configurée — pratique pour corriger l'endianness de champs multi-octets dans un tampon, ou pour dé-brouiller des ordres d'octets propres à certains fournisseurs. |
Utilitaires d'endianness et de code de Gray
Deux modules de conversion spécialisés :
| Module | Ce qu'il fait |
|---|---|
| nEndian | Permute les octets d'un entier (big↔little endian). Fréquent lors de la lecture d'un capteur dont la fiche technique définit les registres en big-endian sur un MCU little-endian. |
| nGrayToBin | Convertit une valeur codée en Gray (souvent produite par les encodeurs absolus) en un entier binaire normal. Le sens inverse est également pris en charge via le mode du module. |
TypeCast et Constant
Deux petits outils qui se marient bien avec le reste :
- nTypeCast — conversion explicite de type numérique (
f32→s16,u32→u8avec saturation, etc.). La plupart du temps, la correspondance des couleurs de fils de NodeBlue rend cela automatique ; recourez àTypeCastlorsque vous avez besoin d'un contrôle précis sur l'arrondi, le signe ou la saturation. - nConstant — émet une valeur fixe sur un port. Pratique comme champ empaqueté qui ne change jamais (un octet d'en-tête de protocole, une sentinelle fixe).
Un exemple complet : un paquet IMU 6 axes sans fil
Une configuration courante :
Axes de l'IMU (6 × s16) →
nSerializer(six entrées s16, une sortie tampon) → entrée de canalnNRF24.Côté récepteur : sortie de canal
nNRF24→nUnSerializer(une entrée tampon, six sorties s16) → consommateurs en aval (graphiques du tableau de bord, axes HID, moteurs).
Format sur le fil total : 12 octets par paquet, tient confortablement dans la charge utile radio NodeBlue de 31 octets, avec de la marge pour un numéro de séquence ou un champ d'état via la famille BitPacker.
Le complément de ce tutoriel est la page Multiplexeurs — multiplexer lequel de plusieurs flux transmettre, par opposition à empaqueter le contenu d'un seul flux.
Suite : comment présenter vos valeurs à un humain — Afficheurs.