Aller au contenu principal

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ètreDescription
TypeLe type numérique des entrées (u8, s16, f32, …). Détermine la façon dont la valeur est interprétée.
Nb EntréesLe nombre de valeurs à formater. Clic droit → Add Input pour l'agrandir.
SyncLe moment où émettre le texte — généralement InputSync, afin qu'une nouvelle ligne soit produite chaque fois qu'une entrée change.
FormatLes indicateurs de format (hexadécimal / décimal / signé / rempli / etc.).
PrécisionLe nombre de décimales lorsque l'entrée est un flottant.
Long. MaxLa 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").
NettoyerRéinitialiser le tampon entre les sorties.
Aligner à droiteAligner 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.

astuce

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.