Cette page vous guide, d’une passerelle LoRaWAN et d’un capteur LoRaWAN, de la sortie de boîte aux premières mesures décodées en une quinzaine de minutes. Elle utilise la configuration la plus courante : une passerelle qui parle Basics Station et un capteur qui se joint par voie radio (OTAA). Chaque étape renvoie vers la page complète de la section LoRaWAN.
De quoi vous avez besoin
- Le rôle Admin (autorisation de gérer les passerelles et appareils LoRaWAN).
- Une passerelle qui prend en charge Basics Station (mode LNS), avec accès à sa propre page de configuration. Les passerelles qui n’exécutent que le transitaire de paquets UDP ne sont pas prises en charge.
- Un capteur LoRaWAN et sa fiche fournisseur avec le DevEUI, le JoinEUI (aussi appelé AppEUI) et l’AppKey.
- De la place pour deux appareils de plus dans votre forfait : la passerelle et le capteur comptent chacun pour un appareil.
Si votre passerelle est un routeur sous licence doté d’une radio LoRa, passez les étapes 1 et 2 et suivez Routeurs sous licence comme passerelles LoRaWAN.
1. Ajouter la passerelle
- Ouvrez Appareils et sélectionnez Nouvel appareil.
- Choisissez Passerelle LoRaWAN (« Une passerelle Basics Station, identifiée par son EUI ; son jeton n’est affiché qu’une fois. »).
- Saisissez un Nom (par exemple
Roof, north side) et le Gateway EUI : 16 chiffres hexadécimaux figurant sur l’étiquette de la passerelle ou sur sa page web. Les espaces,-et:sont supprimés automatiquement. - Sélectionnez Ajouter la passerelle.
Le panneau affiche les valeurs Connecter la passerelle : l’adresse LNS, l’adresse de découverte et l’en-tête de jeton, avec des boutons pour télécharger tc.uri, tc.trust et tc.key.
Avertissement
Le jeton n’est affiché qu’ici, une seule fois. Copiez l’en-tête de jeton ou téléchargez les trois fichiers avant de fermer le panneau. Si vous le perdez, renouvelez le jeton plus tard. Voir Ajouter une passerelle LoRaWAN.
2. Configurer la passerelle
Sur la page de configuration propre à la passerelle :
- Choisissez le mode serveur réseau Basics Station (LNS).
- Renseignez l’adresse du serveur (
tc.uri) avec l’adresse LNS,wss://<adresse de votre organisation>.<hôte du serveur réseau>. Si la passerelle demande plutôt une adresse de découverte, utilisez l’adresse de découverte. - Renseignez le certificat du serveur (
tc.trust) : importez le fichier téléchargé, ou choisissez le magasin de certificats système de la passerelle. - Renseignez le jeton d’autorisation (
tc.key) avec la ligne En-tête de jeton, ou importez le fichiertc.keytéléchargé. - Enregistrez puis redémarrez le transitaire de la passerelle.
De retour dans Hermetry, ouvrez la passerelle depuis Appareils et sélectionnez son onglet LoRaWAN. En moins d’une minute, le statut indique En ligne, et Aller-retour et Connectée depuis se renseignent. Voir Connecter une passerelle Basics Station.
3. Ajouter le capteur
- Ouvrez Appareils > Nouvel appareil et choisissez Appareil LoRaWAN (« Un équipement terminal, identifié par son DevEUI, son JoinEUI et son AppKey. »).
- Laissez Activation sur OTAA (se joint avec son AppKey).
- Renseignez le Nom, le DevEUI, le JoinEUI (AppEUI) (utilisez
0000000000000000si la fiche n’en indique aucun), l’AppKey (32 chiffres hexadécimaux), la version LoRaWAN (1.0.3 sauf indication contraire de la fiche) et la Classe (A pour les capteurs sur batterie). - Sélectionnez Ajouter l’appareil. Le panneau indique L’appareil a été ajouté. Il apparaît comme joint après sa première demande de jonction.
Le capteur est ajouté avec le profil intégré LoRaWAN EU868 Classe A OTAA (1.0.3). Seul le mode appairage ajoute des appareils à un profil de votre choix.
Avertissement
L’AppKey est stockée chiffrée et n’est jamais réaffichée. Conservez la fiche du fournisseur.
Voir Ajouter un appareil OTAA. Pour les capteurs à clés de session fixes, voir Ajouter un appareil ABP.
4. Laisser le capteur se joindre
Mettez le capteur sous tension, ou forcez une nouvelle jonction (de nombreux capteurs ont un bouton ou un aimant pour cela). Ouvrez l’onglet LoRaWAN du capteur : le badge de jonction à côté du titre passe à Joint après une jonction réussie. La jonction et les premières remontées apparaissent aussi dans le journal des trames : Appareils > ⋯ > Trames LoRaWAN.
Voir Comment un appareil se joint, étape par étape.
5. Vérifier le codec
Un codec transforme les octets du capteur en mesures. Un nouvel appareil utilise Automatique (par fabricant et port) : Hermetry choisit le codec qui revendique le fabricant du capteur (d’après son DevEUI) et le FPort de la trame. Vos propres codecs sont essayés avant les 106 codecs de la bibliothèque.
Sur l’onglet LoRaWAN du capteur, regardez Codec :
- Si un codec a été trouvé, conservez Automatique.
- Si aucun codec ne revendique le capteur, la charge utile arrive non décodée en hexadécimal sous la clé
raw. Choisissez le codec du capteur dans la liste et sélectionnez Enregistrer, ou utilisez Aucun (charge utile brute vers les flux) et décodez-la dans un flux.
Voir Codecs : transformer les octets en valeurs et La bibliothèque de codecs.
6. Voir les premières mesures
Ouvrez l’onglet Télémesure du capteur. Après la prochaine remontée, le tableau Dernières valeurs affiche les clés décodées, par exemple temperature, humidity et battery, ainsi que les clés radio lora.rssi, lora.snr et d’autres lorsque le profil les ajoute. L’onglet LoRaWAN affiche la Dernière réception avec les passerelles qui l’ont entendue.
Les capteurs sur batterie n’envoient souvent qu’une mesure toutes les 10 à 60 minutes. Consultez le journal des trames si vous ne voulez pas attendre.
Si cela ne fonctionne pas
| Symptôme | Première vérification |
|---|---|
| La passerelle n’apparaît jamais En ligne | Elle exécute encore le transitaire UDP, la ligne du jeton est incomplète, ou elle ne fait pas confiance au certificat. Voir le tableau de dépannage dans Connecter une passerelle Basics Station. |
| Aucune trace du capteur dans le journal des trames | Le capteur est hors de portée, utilise un plan de fréquences différent de celui de la passerelle, ou n’a pas tenté de se joindre. |
| Une jonction est refusée dans le journal des trames | AppKey ou JoinEUI erroné, ou DevNonce réutilisé. Voir Dépannage des jonctions. |
Jointé, mais seul raw arrive | Aucun codec ne revendique le capteur. Choisissez-en un dans l’onglet LoRaWAN. |
| Les valeurs arrivent avec les noms du fabricant | Renommez-les et convertissez-les. Voir Nettoyer les valeurs décodées. |
Étapes suivantes
- Ajoutez plusieurs capteurs du même type d’un coup avec le mode appairage.
- Placez la passerelle sur la carte : Statut de la passerelle, santé et carte.
- Affichez les mesures sur un tableau de bord : Créer votre premier tableau de bord.

