Avant qu’une passerelle puisse transmettre les trames de vos appareils, vous l’enregistrez dans Hermetry à l’aide de son EUI. Hermetry vous fournit alors un jeton et les valeurs de configuration de la passerelle. Cette page couvre les passerelles qui utilisent le protocole Basics Station. Les routeurs sous licence s’ajoutent différemment : voir Routeurs sous licence comme passerelles LoRaWAN.
Vous avez besoin de l’autorisation d’ajouter, de modifier, de désactiver et de supprimer des passerelles LoRaWAN (administrateurs par défaut).
Avant de commencer
- Repérez l’EUI de la passerelle. Il comporte 16 chiffres hexadécimaux, imprimés sur l’étiquette de la passerelle ou affichés sur sa propre page web. Certains fabricants l’appellent Gateway ID.
- Vérifiez que votre offre permet d’ajouter un appareil supplémentaire. Une passerelle compte pour un appareil dans votre limite d’appareils.
- Ayez accès à la page de configuration propre à la passerelle ; vous y saisirez les valeurs juste après l’avoir ajoutée.
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. »).
- Remplissez le formulaire :
| Champ | Quoi saisir | Règles |
|---|---|---|
| Nom | Un nom que vous reconnaissez, par exemple « Toit, côté nord ». | Obligatoire, 128 caractères maximum. |
| EUI de la passerelle | L’EUI à 16 chiffres de la passerelle. | 16 chiffres hexadécimaux. Les espaces, - et : sont supprimés. Les lettres sont enregistrées en majuscules. Les valeurs entièrement à zéro ou entièrement à F sont refusées. |
| Région | Fixée sur Europe 863–870 MHz (EU868). | EU868 est la seule région. |
- Sélectionnez Ajouter la passerelle.
Le panneau indique désormais La passerelle a été ajoutée. Saisissez maintenant ces valeurs sur elle : le jeton n’est affiché qu’ici. Il présente les étapes Connecter la passerelle avec votre 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.
Avertissement
Le jeton n’est affiché qu’une seule fois. Copiez l’en-tête du jeton ou téléchargez les fichiers avant de fermer le panneau ou de sélectionner Ajouter une autre. Hermetry ne conserve qu’une empreinte du jeton et ne peut pas l’afficher à nouveau. Si vous le perdez, renouvelez le jeton (voir Identifiants de passerelle, désactivation et suppression).
- Configurez la passerelle avec ces valeurs. Voir Connecter une passerelle Basics Station.
- Sélectionnez Ouvrir l’appareil pour voir la passerelle passer en ligne dans son onglet LoRaWAN.
Ce que Hermetry crée
| Élément créé | Détails |
|---|---|
| Un appareil | Nommé comme vous l’avez saisi, avec le profil intégré Passerelle LoRaWAN. Le profil passe la passerelle en ligne tant que sa connexion est ouverte. |
| Un enregistrement de passerelle | EUI, protocole Basics Station, mode cloud, région EU868, statut actif. |
| Une réservation d’EUI à l’échelle de la plateforme | L’EUI est désormais réservé à votre organisation. |
| Règles d’alarme de santé par défaut | Lorsque les alarmes sont disponibles dans votre organisation, le profil de passerelle intégré reçoit des règles par défaut (hors ligne pendant 10 minutes, aller-retour lent, échecs des liaisons descendantes, cycle d’utilisation, température). Voir État, santé et carte des passerelles. |
Le formulaire de passerelle ne demande pas d’emplacement. Placez la passerelle sur la carte plus tard ; voir État, santé et carte des passerelles.
Erreurs
| Message | Cause | Que faire |
|---|---|---|
| L’EUI de la passerelle comporte 16 chiffres hexadécimaux. | L’EUI est trop court, trop long ou contient d’autres caractères. | Recopiez l’EUI depuis l’étiquette. |
| Donnez un nom à la passerelle. | Le nom est vide. | Saisissez un nom. |
Cet EUI est déjà enregistré. (eui_taken) | Une autre passerelle de la plateforme, dans votre organisation ou dans une autre, possède cet EUI. Hermetry n’indique pas laquelle. | Vérifiez l’EUI. Si la passerelle a été enregistrée auparavant dans une autre organisation, elle doit d’abord y être supprimée. |
| La limite d’appareils de votre offre est atteinte. | Votre offre ne permet pas d’ajouter un appareil supplémentaire. | Supprimez les appareils inutilisés ou changez d’offre. |
Ajouter une passerelle via l’API
POST /tenant/<tenantId>/api/iot/lorawan/gateways
Content-Type: application/json
{ "name": "Roof, north side", "eui": "AA555A0000000101" }La réponse (201) contient gateway, le token en clair (une seule fois) et stationConfig, les trois fichiers avec leur contenu. Champs facultatifs : latitude (−90 à 90), longitude (−180 à 180), altitude (−1 000 à 100 000 m). Les champs inconnus sont refusés. Voir l’API LoRaWAN.