La bibliothèque de décodeurs

Hermetry est livré avec une bibliothèque de 106 décodeurs pour les capteurs LoRaWAN courants. Chacun décode les charges utiles d’un capteur ou d’une famille de capteurs d’un même fabricant. Les appareils en mode Automatic utilisent la bibliothèque sans aucune configuration lorsque leur fabricant et leur FPort correspondent à un décodeur de la bibliothèque.

Ouvrir la bibliothèque

1. Ouvrez Devices.
2. Ouvrez le menu ⋯ et sélectionnez LoRaWAN codecs.

Le tiroir liste tous les décodeurs que vous pouvez utiliser : ceux de la bibliothèque (Source: Library) et les vôtres (Source: Yours). Vous avez besoin de la permission d’afficher les décodeurs LoRaWAN (users par défaut).

Colonne	Affiche
Id	L’identifiant du décodeur. Les identifiants de la bibliothèque sont des noms courts construits à partir du fabricant et du modèle. Vos décodeurs commencent par t.
Name	Ce que le décodeur décode, par exemple un capteur de température et d’humidité
Vendor	Le fabricant de l’appareil
Models	Les noms de modèles couverts par le décodeur
FPorts	Les FPorts décodés ; vide signifie tous les ports
Kind	Le format de table, tlv ou layout
Source	Library ou Yours
Verified	Verified on a device ou Not verified (décodé à partir du format publié par le fabricant et vérifié avec ses vecteurs de test)
Revision, Updated, Status	La révision actuelle, la date de modification le cas échéant, Published ou Withdrawn

Recherche par identifiant, nom, fabricant, modèle ou code fabricant (OUI).

Ce que couvre la bibliothèque

Type de capteur	Exemples de valeurs
Qualité de l’air intérieur	CO₂, particules fines, formaldéhyde, ozone, température, humidité, pression, luminosité
Température et humidité	Capteurs de pièce, étiquettes, sondes (y compris les transmetteurs PT100 et thermocouple), capteurs à insertion et à double sonde
Portes, fenêtres et contacts	État ouvert/fermé, compteurs d’ouvertures
Impulsions et entrées numériques	Compteurs d’impulsions, états d’entrée
Courant électrique	Pinces de transformateur de courant (monophasées et triphasées), capteurs de courant multicanaux, prises intelligentes et prises de compteur
Fuites d’eau	Fuite détectée, capteurs de fuite à membrane et à sonde
Niveau et distance	Distance ultrasonique, radar et LiDAR, niveau de liquide capacitif, niveau immergé, transmetteurs de pression et de niveau, niveau de remplissage
Inclinaison	Angle d’inclinaison et alarmes d’inclinaison
Sol et agriculture	Humidité du sol, température, conductivité (EC), pH, humidité foliaire
Gaz et odeurs	Détecteurs de gaz, détecteurs d’odeurs
Pression et débit	Pression de canalisation, débitmètres
Météo et environnement	Stations météo, niveau de luminosité, niveau sonore
Suivi	Traceurs d’actifs en extérieur (GPS et Wi-Fi), traceurs de conteneurs et de cartes, badges, balises de traçage de contacts
Boutons et alarmes	Boutons d’alarme, boutons intelligents et portables, badges de sécurité, panneaux de scénarios
Occupation et présence	Compteurs de personnes, occupation de bureaux et d’espaces de travail, présence par radar, détection de chute, détection de mouvement PIR
Stationnement	Capteurs de places de stationnement
Commande	Contrôleurs d’électrovannes, contrôleurs multi-interfaces, contrôleurs d’éclairage, thermostats, thermostats de radiateur

Il n’existe pas aujourd’hui de capteur de vibrations LoRaWAN dans la bibliothèque. Pour un capteur absent, écrivez votre propre décodeur.

Trouver le décodeur de votre capteur

1. Recherchez dans le tiroir le nom du modèle du capteur, tel qu’imprimé dessus.
2. Ouvrez le décodeur et vérifiez Models et FPorts.
3. Vérifiez Makers (OUI) : si votre DevEUI commence par l’un de ces codes à six chiffres, Automatic choisit ce décodeur tout seul.
4. Si votre DevEUI ne commence par aucun code fabricant listé (par exemple, si le fournisseur a attribué ses propres DevEUI), choisissez le décodeur par son nom sur l’appareil ou le profil.

La page d’un décodeur

Ouvrez un décodeur depuis la liste pour voir :

Section	Affiche
Codec	Identifiant, révision, Fingerprint (SHA-256), modèles, FPorts, fabricants (OUI), origine et source
Keys it decodes	Chaque clé de sortie avec son unité, tirée des vecteurs de test du décodeur
Revisions	Chaque révision publiée, avec sa taille et son nombre de clés
Test bench	Testez le décodeur avec une charge utile réelle
La table du décodeur	La table elle-même (en lecture seule pour les décodeurs de la bibliothèque)

La page vous rappelle aussi : Downlinks are sent as raw hex or base64. Les décodeurs ne font que décoder ; voir Sending downlinks.

Tester un décodeur

1. Ouvrez le décodeur et faites défiler jusqu’à Test bench.
2. Saisissez le FPort (1–255) et la Payload (hex) envoyée par l’appareil (espaces autorisés, 255 octets au maximum). Copiez la charge utile depuis l’outil du fabricant de votre appareil, ou depuis un message décodé avec None.
3. Sélectionnez Decode.

Le banc affiche la Key, la Value et l’Unit décodées, les éventuels Warnings et Errors, ainsi que Bytes left over lorsque le décodeur n’a pas utilisé tous les octets. The codec did not recognise this frame. signifie que le décodeur n’a pas de règle pour ce FPort ou cette forme de charge utile.

Noms des clés de sortie

Les décodeurs de la bibliothèque nomment leurs clés comme la documentation du fabricant de l’appareil, par exemple temperature_red ou un état textuel tel que "occupied". Différents fabricants utilisent des noms différents pour la même grandeur. Si vous souhaitez une nomenclature unique pour votre parc, voir Cleaning up decoded values.

Évolutions de la bibliothèque

• La plateforme met à jour la bibliothèque au fil du temps. Une nouvelle révision d’un décodeur peut ajouter des clés, mais ne supprime ni ne renomme jamais une clé, et ne modifie jamais l’unité d’une clé. Vos flux et tableaux de bord continuent de fonctionner.
• Un décodeur peut être Withdrawn par la plateforme. Les appareils qui l’avaient choisi décodent alors avec le choix automatique.
• Les décodeurs de la bibliothèque sont en lecture seule pour vous. Pour en modifier un, utilisez Save a copy ; voir Écrire votre propre décodeur.