Cette page vous guide, d’une passerelle LoRaWAN et d’un capteur LoRaWAN, depuis le déballage jusqu’aux mesures décodées en environ quinze minutes. Elle utilise la configuration la plus courante : une passerelle qui parle Basics Station et un capteur qui rejoint le réseau par voie radio (OTAA). Chaque étape renvoie vers la page complète de la section LoRaWAN.
Ce dont vous avez besoin
- Le rôle Admin (autorisation de gérer les passerelles et appareils LoRaWAN).
- Une passerelle EU868 qui prend en charge Basics Station (mode LNS), avec accès à sa propre page de configuration. Les passerelles qui n’exécutent que le transmetteur de paquets UDP ne sont pas prises en charge.
- Un capteur EU868 et sa fiche fournisseur avec le DevEUI, le JoinEUI (aussi appelé AppEUI) et l’AppKey.
- De la place pour deux appareils supplémentaires dans votre offre : 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. La Région est fixée à EU868. - Sélectionnez Ajouter la passerelle.
Le panneau affiche les valeurs de Connecter la passerelle : l’adresse LNS, l’adresse de découverte et l’en-tête du jeton, ainsi que des boutons pour télécharger tc.uri, tc.trust et tc.key.
Attention
Le jeton n’est affiché qu’ici, une seule fois. Copiez l’en-tête du jeton ou téléchargez les trois fichiers avant de fermer le panneau. En cas de perte, 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://<l'adresse de votre organisation>.<l'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 du jeton, ou importez le fichiertc.keytéléchargé. - Enregistrez et redémarrez le transmetteur 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é depuis se remplissent. Voir Connecter une passerelle Basics Station.
3. Ajouter le capteur
- Ouvrez Appareils > Nouvel appareil et choisissez Appareil LoRaWAN (« Un appareil final, identifié par son DevEUI, son JoinEUI et son AppKey. »).
- Laissez Activation sur OTAA (rejoint avec son AppKey).
- Renseignez le Nom, le DevEUI, le JoinEUI (AppEUI) (utilisez
0000000000000000si la fiche n’en indique pas), 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 rejoint après sa première demande de connexion.
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.
Attention
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 rejoindre le réseau
Mettez le capteur sous tension, ou faites-le rejoindre à nouveau le réseau (beaucoup de capteurs disposent pour cela d’un bouton ou d’un aimant). Ouvrez l’onglet LoRaWAN du capteur : le badge de connexion à côté du titre passe à Rejoint après une connexion réussie. La connexion et les premières trames montantes apparaissent aussi dans le journal des trames : Appareils > ⋯ > Trames LoRaWAN.
Voir Comment un appareil rejoint le réseau, é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.
Dans 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 brute transmise aux 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émétrie du capteur. Après la prochaine trame montante, 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’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’affiche jamais En ligne | Elle exécute encore le transmetteur 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. |
| Rien du capteur dans le journal des trames | Le capteur est hors de portée, n’est pas un appareil EU868, ou n’a pas tenté de rejoindre le réseau. |
| Une connexion est refusée dans le journal des trames | AppKey ou JoinEUI incorrect, ou DevNonce réutilisé. Voir Dépannage des connexions. |
Connecté, 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, santé et carte des passerelles.
- Affichez les mesures sur un tableau de bord : Créer votre premier tableau de bord.