Adapter une solution à vos appareils

Une solution prête à l’emploi attend certaines clés de télémétrie, attributs et relations. Vos appareils nomment probablement les choses différemment : temp au lieu de air_temp, door sous forme de texte au lieu de door_open en vrai/faux, la pression en pascals au lieu du bar. Cette page montre comment les faire correspondre sans réécrire la solution, et ce que la solution attend d’autre de votre part.

Choisir une approche

Approche	Idéal quand	Effort
1. Nettoyer dans le flux racine	Plusieurs appareils d’un même type envoient les mêmes noms	Un seul flux, puis chaque tableau de bord et chaque règle fonctionne sans modification
2. Modifier les cartes	Seules quelques cartes sont concernées, ou vous utilisez de toute façon un tableau de bord modèle	Modifier les clés de chaque carte
3. Modifier le codec (LoRaWAN)	Le capteur est LoRaWAN et son codec nomme les clés à sa façon	Enregistrer une copie du codec avec d’autres noms de sortie
4. Placer vos appareils dans les profils de la solution	Vos appareils peuvent envoyer directement les clés de la solution (vous maîtrisez le firmware)	Aucune action côté Hermetry

L’approche 1 est le choix habituel : les données stockées correspondent alors aux profils de la solution, de sorte que les règles d’alarme, les tableaux de bord et les graphiques fonctionnent tous, et vous pouvez mélanger les fabricants d’appareils.

1. Nettoyer dans le flux racine

Chaque message d’appareil passe par un flux racine avant d’être stocké : la racine propre au profil s’il en existe une, sinon le flux racine de l’organisation. Placez les étapes de nettoyage avant Enregistrer la télémétrie.

1. Donnez aux appareils d’un même type leur propre profil d’appareil, ou utilisez le profil de la solution.
2. Dans Automatisation, créez un flux sur l’hôte IoT à partir du modèle Flux racine par défaut et liez-le comme racine de ce profil. Voir Hôtes, flux racine et flux racines de profil.
3. Entre Messages des appareils et Règles d’alarme, ajoutez les étapes ci-dessous.
4. Testez avec un message enregistré, puis déployez.

Placez les étapes avant Règles d’alarme, afin que les règles voient aussi les clés nettoyées.

Renommer une clé

Un bloc Modifier à deux étapes, par exemple pour transformer temp en air_temp :

Étape	Chemin	Valeur
set	msg.payload.air_temp	msg.payload.temp
delete	msg.payload.temp

Convertir une valeur

Un bloc Calculer, une cible par valeur :

Besoin	Expression	Cible
°F vers °C (air_temp)	round((msg.payload.temp_f - 32) * 5 / 9, 1)	msg.payload.air_temp
État de porte en texte vers vrai/faux	msg.payload.door == "open"	msg.payload.door_open
Code d’événement d’un traceur vers le mot de la solution	msg.payload.ev == 3 ? "fall" : (msg.payload.ev == 7 ? "sos" : "normal")	msg.payload.event
Texte numérique vers un nombre	number(msg.payload.level)	msg.payload.level_cm

Un calcul sur du texte échoue, même sur du texte numérique tel que "21.5" : convertissez d’abord avec number(...). Voir Blocs de transformation de données et Nettoyer les valeurs décodées.

Supprimer les clés dont vous n’avez pas besoin

Un bloc Modifier avec des étapes delete, ou limitez Enregistrer la télémétrie aux clés que vous listez. Moins de clés vous éloignent de la limite de clés de votre offre ; voir Clés de télémétrie.

2. Modifier les cartes

Pour lire directement vos clés, ouvrez le tableau de bord en mode Personnaliser, ouvrez les paramètres d’une carte et choisissez votre clé dans son champ de données. Les graphiques, tableaux et cartes géographiques ont chacun leurs propres listes de clés. Un paramètre de tableau de bord tel que Cuves ou Contrôleurs de site sélectionne les appareils par profil : ouvrez Gérer les paramètres… et ajoutez-y votre profil pour que vos appareils apparaissent sur le tableau de bord.

Modifiez une copie plutôt que le tableau de bord installé : Dupliquer-le d’abord. Lorsque Hermetry met à jour une solution, les cartes du tableau de bord installé sont réécrites (voir Installer une solution).

3. Utiliser les limites de la solution

Les règles d’alarme comparent les mesures aux attributs serveur de chaque appareil. Vos appareils en ont besoin eux aussi :

Solution	Attributs sur chaque appareil
Site d’eau	Cuve : lowLevelThreshold, highLevelThreshold. Station de pompage : minPressure
Sites distants	Contrôleur de site : highTempThreshold, lowTempThreshold, highHumThreshold, lowHumThreshold
Zones de capteurs	maxTempThreshold, minTempThreshold, warnTempThreshold, maxHumThreshold, minHumThreshold, warnHumThreshold
Suivi du personnel	forbiddenZone
Stations météo	Aucun

Un appareil sans attribut n’est pas contrôlé par la règle qui le lit. Définissez les attributs :

• à la main, dans l’onglet Attributs de l’appareil (portée Serveur),
• en masse, avec des colonnes attr:<key> dans un import d’appareils (voir Importer des appareils en masse),
• depuis un autre système, avec POST /api/iot/devices/{deviceId}/attributes/server (voir API de télémétrie et d’attributs).

4. Emplacements et relations

Certaines pages trouvent les appareils grâce au modèle de site. Recréez-le pour vos propres appareils :

Solution	Ce dont le tableau de bord a besoin	Comment
Site d’eau	Cuves et stations placées dans une zone sous le site ; chaque cuve CONTROLS sa station de pompage	Placer les appareils ; ajouter la relation de la cuve vers la station
Sites distants	Contrôleur et passerelle UPS placés dans le site ; la passerelle UPS FEEDS le contrôleur ; caméras placées dans le site	Placer les appareils ; ajouter la relation de l’UPS vers le contrôleur
Zones de capteurs	Capteurs placés dans une zone ; l’attribut floorPlan de la zone ; la station libellée Weather station	Placer les appareils ; définir l’attribut et le libellé
Suivi du personnel	Actifs de zone nommés exactement comme les traceurs les signalent	Créer des actifs de type Zone portant ces noms

Voir Placer des appareils et Relations.

5. Bien nommer les appareils

Les tableaux de bord affichent les noms des appareils dans les titres, tableaux, cartes et textes d’alarme (« Alarme ouverte sur nom : … »). Nommez chaque appareil d’après ce qu’il est et où il se trouve (Abri de Hilltop, Cuve 3 Nord), et non d’après son numéro de série. Le tableau de bord des zones de capteurs utilise aussi le libellé de l’appareil sur la carte.

Liste de contrôle

1. Vos appareils envoient les clés de la solution, directement ou après le nettoyage du flux racine. Vérifiez l’onglet Télémétrie d’un appareil.
2. Chaque appareil possède ses attributs de limite.
3. Les appareils sont placés et les relations existent.
4. Les paramètres de profil du tableau de bord incluent vos profils.
5. La liste des profils du flux de notification nomme vos profils, ses destinataires sont corrects et il est activé.
6. Les appareils d’exemple dont vous n’avez plus besoin sont supprimés.

Dépannage

Symptôme	Vérification
Une carte reste vide	Le nom de la clé dans l’onglet Télémétrie de l’appareil, exactement, casse comprise. Voir Un tableau de bord n’affiche aucune donnée.
Un graphique est vide mais la carte de valeur affiche une valeur	La clé est un texte ou un vrai/faux : stockez une copie numérique
Aucune alarme ne s’ouvre	L’attribut de limite est absent, ou le nettoyage s’exécute après Règles d’alarme
Les données s’arrêtent après la liaison d’une racine de profil	La nouvelle racine n’a pas de Enregistrer la télémétrie. Voir Les données n’arrivent pas.

Voir aussi

• Installer une solution
• Recettes de flux
• Profils d’appareils