Chaînes de caractères et texte
Jusqu'ici, les valeurs circulaient de module en module sous forme de nombres. Pour les envoyer par un port série, les afficher sur un écran, les consigner dans la console ou les intégrer à un message plus riche, vous devez transformer ces nombres en texte. NodeBlue propose un petit groupe de modules de chaînes, très performant, conçu précisément pour cela :
- FormatText — transformer une valeur numérique (ou plusieurs) en une chaîne formatée.
- Text — émettre une chaîne fixe, ou insérer des variables dans un gabarit.
- StringToNumber — l'inverse : extraire un nombre d'un tampon de texte entrant.
La sortie de ces modules est un Buffer (une séquence d'octets terminée par un saut de ligne, par défaut), utilisable comme entrée pour USB Serial, le Traceur, un UART, une socket TCP, un afficheur OLED, ou tout autre « puits de texte ».
FormatText
FormatText est le module de base. Il prend une ou plusieurs entrées numériques et en produit une représentation textuelle. Ses paramètres sont :
| Paramètre | Description |
|---|---|
| Type | Le type numérique des entrées (u8, s16, f32, …). Détermine la façon dont la valeur est interprétée. |
| Nb Entrées | Le nombre de valeurs à formater. Clic droit → Add Input pour l'agrandir. |
| Sync | Le moment où émettre le texte — généralement InputSync, afin qu'une nouvelle ligne soit produite chaque fois qu'une entrée change. |
| Format | Les indicateurs de format (hexadécimal / décimal / signé / rempli / etc.). |
| Précision | Le nombre de décimales lorsque l'entrée est un flottant. |
| Long. Max | La taille maximale du tampon en octets. |
| Libellé | Un préfixe constant ajouté avant la valeur ("speed: ", par exemple). |
| Unité | Un suffixe constant ajouté après la valeur (" rpm", " °C"). |
| Nettoyer | Réinitialiser le tampon entre les sorties. |
| Aligner à droite | Aligner le nombre à droite dans son champ. |
Un FormatText avec Label = "Count: ", Unit = "\n", de type u16, alimenté par un Counter, produit indéfiniment des lignes du type Count: 42. Reliez sa sortie à une entrée USB Serial et vous obtenez un flux numérique en direct que vous pouvez observer dans la console série — voir Examples/08-Strings/FormatText.
De nombreux autres modules — BlinkSerial, les exemples d'entrée numérique, les exemples d'entrée analogique — utilisent tous FormatText en amont d'un USB Serial. C'est le moyen le plus simple de confirmer qu'une valeur correspond bien à ce que vous attendez.
Text
Text émet un gabarit fixe, avec des points d'insertion facultatifs de style % qui récupèrent les valeurs de ses entrées numériques. Utilisez-le lorsque vous voulez une ligne façonnée à la main — un message d'état, une trame de protocole série, un message d'accueil sur une ligne — plutôt que le schéma tout fait « libellé + valeur + unité » de FormatText.
L'exemple Examples/08-Strings/Text illustre la syntaxe des gabarits.
StringToNumber
StringToNumber fait l'inverse : il parcourt un tampon de texte à la recherche d'un nombre et le produit sur sa sortie dans le type numérique configuré. Reliez-le après une entrée USB Serial pour lire des commandes envoyées par un programme hôte, ou après un récepteur HTTP/UDP pour analyser les données entrantes.
Il est couramment associé à un FormatText sur une carte partenaire, ce qui vous donne un protocole numérique simple basé sur des lignes, facile à déboguer — il suffit d'ouvrir une console et de taper les nombres vous-même.
À propos des Buffers
La sortie de chaque module de texte est un Buffer. Les buffers peuvent être :
- routés vers USB Serial / Hardware Serial / Software Serial pour quitter la carte,
- affichés sur un écran OLED ou Nextion,
- écrits dans un fichier par l'hôte via
nNodeBlueInterface, - assemblés avec d'autres buffers par BufferMerge / BufferSplit (voir le tutoriel sur le conditionnement des données),
- ou simplement affichés dans la console à des fins de débogage.
Voyons maintenant comment déplacer les buffers d'une carte à l'autre : Communication — La famille Série.