Avant qu’une passerelle puisse relayer 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 traite des 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.
- Accédez à la page de configuration propre à la passerelle ; vous y saisirez les valeurs juste après l’ajout.
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 seule fois. »).
- Remplissez le formulaire :
| Champ | Saisie attendue | 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 EUI composés uniquement de zéros ou uniquement de F sont refusés. |
- Sélectionnez Ajouter la passerelle.
Le panneau indique désormais La passerelle a été ajoutée. Saisissez maintenant ces valeurs sur celle-ci : 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.
Attention
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 En ajouter une autre. Hermetry ne conserve qu’une empreinte du jeton et ne peut pas l’afficher à nouveau. Si vous le perdez, régénérez 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 suivre le passage en ligne de la passerelle dans son onglet LoRaWAN.
Ce que Hermetry crée
| Élément | Détails |
|---|---|
| Un appareil | Nommé comme vous l’avez saisi, avec le profil intégré Passerelle LoRaWAN. Ce profil marque la passerelle comme en ligne tant que sa connexion est ouverte. |
| Un enregistrement de passerelle | EUI, protocole Basics Station, mode cloud, région, statut actif. |
| Une réservation de l’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 intégré de passerelle reçoit des règles par défaut (hors ligne pendant 10 minutes, temps d’aller-retour lent, downlinks en échec, cycle d’utilisation, température). Voir État, santé et carte des passerelles. |
Le formulaire de passerelle ne demande pas de position. 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 doit comporter 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.

