Aller au contenu principal

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.

ModuleCe qu'il fait
nSerializerN entrées typées → 1 tampon en sortie. Les octets de chaque entrée sont ajoutés au tampon dans l'ordre.
nUnSerializer1 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.

ModuleCe qu'il fait
nBitPackerN 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.
nBitUnPackerL'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.

ModuleCe qu'il fait
nBufferSplitDécoupe un tampon en N morceaux à des décalages d'octets configurés. Chaque morceau apparaît sur sa propre sortie.
nBufferSplitCustomMê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.
nBufferMergeL'inverse — concatène N tampons en entrée en un seul tampon de sortie.
nBufferNotInverse 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é.
nBufferPermuteRé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 :

ModuleCe qu'il fait
nEndianPermute 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.
nGrayToBinConvertit 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 → u8 avec saturation, etc.). La plupart du temps, la correspondance des couleurs de fils de NodeBlue rend cela automatique ; recourez à TypeCast lorsque 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 canal nNRF24.

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.