Les codecs de bibliothèque nomment leurs clés de sortie selon la convention de chaque fabricant d’appareils. La température d’un fabricant s’appelle temperature, celle d’un autre temperature_red ; un capteur de stationnement envoie "occupied" sous forme de texte, un autre envoie 1. Si vous mélangez les fabricants, vos tableaux de bord et vos règles d’alarme seront plus faciles à gérer lorsque chaque appareil transmet les mêmes clés, dans le même format. Cette page présente deux façons d’y parvenir : modifier les valeurs dans un flux, ou modifier le codec.
Option 1 : nettoyer dans un flux
Chaque message d’appareil passe par un flux racine avant d’être stocké : le flux racine de votre organisation, ou le flux racine du profil lorsque celui-ci en possède un. Ajoutez-y les étapes de nettoyage, avant le bloc Save telemetry. Les valeurs nettoyées sont alors celles qui sont stockées.
Adapté pour : renommer des clés, convertir des unités, transformer du texte en nombres, supprimer les clés dont vous n’avez pas besoin, sans toucher au codec.
Bonne pratique : attribuez à chaque type de capteur son propre profil LoRaWAN avec son propre flux racine, afin que chaque flux ne traite qu’une seule forme de charge utile.
Renommer une clé
Utilisez le bloc Change avec une étape move, ou une étape set suivie d’une étape delete :
| Étape | Chemin | Valeur |
|---|---|---|
set | msg.payload.temperature | msg.payload.temperature_red |
delete | msg.payload.temperature_red |
Convertir une valeur
Utilisez le bloc Calculate. Exemples :
| Besoin | Expression | Cible |
|---|---|---|
| mV vers V | round(msg.payload.battery / 1000, 2) | msg.payload.battery_v |
| °F vers °C | round((msg.payload.temp_f - 32) * 5 / 9, 1) | msg.payload.temperature |
| État textuel vers nombre | msg.payload.parking_status == "occupied" ? 1 : 0 | msg.payload.occupied |
| Texte numérique vers nombre | number(msg.payload.level) | msg.payload.level |
Les calculs sur du texte échouent, même sur du texte numérique comme "21.5" : convertissez d’abord avec number(...).
Supprimer les clés inutiles
Utilisez un bloc Change avec des étapes delete, ou delete keys avec un motif (par exemple debug_.*). Le bloc Save telemetry peut aussi être limité aux clés que vous indiquez.
Conserver les clés radio
Les clés lora.* (lora.rssi, lora.snr et autres) arrivent dans le même msg.payload. Conservez-les si vous souhaitez l’historique de réception.
Où les valeurs arrivent dans le flux
Le déclencheur Device message envoie la télémétrie sous forme d’un message par enregistrement, avec un msg.payload plat de la forme { key: value }. La sortie imbriquée du codec est déjà aplatie avec des points : une valeur probe.temperature correspond donc à la clé "probe.temperature". Lisez la clé avec son nom complet.
Pour le détail des blocs, voir Data transform blocks et Hosts, the root flow and profile root flows.
Option 2 : modifier le codec
Enregistrez une copie du codec de bibliothèque et modifiez-la. Voir Write your own codec.
Adapté pour : obtenir les bons noms de clés et les bonnes unités à la source, afin que chaque flux, tableau de bord et export les voie.
| Modification | Comment dans le tableau |
|---|---|
| Renommer une clé | Modifiez le nom field du champ. |
| Mettre une valeur à l’échelle | Définissez scale (et digits pour les décimales). |
| Modifier l’étiquette d’unité | Définissez unit. |
| Texte au lieu d’un code | Utilisez enum pour associer des nombres à des mots, ou supprimez-le pour conserver le nombre. |
Retenez la règle de révision : une fois votre codec publié, une nouvelle révision ne peut ni supprimer ni renommer de clés. Décidez des noms avant publication, ou publiez sous un nouvel identifiant.
Quelle option choisir
| Situation | Choisir |
|---|---|
| Quelques clés à renommer ou à convertir | Flux |
| De nombreux capteurs d’un même modèle, et vous voulez des clés propres partout | Copie du codec |
| Combiner des valeurs (par exemple, le point de rosée à partir de la température et de l’humidité) | Flux |
| Le codec de bibliothèque décode mal une trame | Copie du codec |
Texte, nombres et vrai/faux
Gardez à chaque clé un seul type dans le temps : une clé tantôt numérique, tantôt textuelle est difficile à tracer et à comparer. Transformez en nombres ou en vrai/faux, dans le flux, les états que vous voulez tracer ou comparer (ouvert/fermé, occupé/libre). Voir Numbers, text and true/false values.
Vérifier le résultat
- Ouvrez l’onglet Telemetry d’un appareil, ou la sortie de débogage du flux, après la prochaine remontée.
- Vérifiez les noms de clés et les valeurs.
- Mettez à jour les tableaux de bord et les règles d’alarme avec les nouveaux noms de clés.