Connecter une passerelle Basics Station

Après avoir ajouté une passerelle, vous configurez la passerelle elle-même une seule fois. Elle se connecte ensuite toute seule et reste connectée ; rien d’autre ne doit être réglé sur elle. Cette page décrit les réglages en termes généraux. Les fabricants de passerelles nomment les menus différemment, il faut donc chercher les champs équivalents sur la page de configuration propre à votre passerelle.

Ce dont la passerelle a besoin

Réglage de la passerelle	Fichier Basics Station	Valeur issue de Hermetry
Mode du serveur réseau	—	Basics Station (LNS). Pas le UDP packet forwarder.
Adresse du serveur (URI LNS)	`tc.uri`	Votre adresse LNS, par exemple `wss://acme.<network server host>`
Certificat du serveur	`tc.trust`	Le fichier `tc.trust` téléchargé, ou le magasin de certificats système de la passerelle
Autorisation	`tc.key`	La ligne d’en-tête du jeton : `Authorization: Bearer <token>`

Hermetry n’utilise que la connexion LNS. Il n’utilise pas le service de mise à jour de configuration (CUPS) que certaines passerelles proposent : il n’y a pas de fichiers cups.uri ni cups.key. Configurez la passerelle une fois à la main, et à nouveau à la main si vous changez son jeton.

Pas à pas

Sur la passerelle, choisissez le mode de serveur réseau LoRaWAN Basics Station (LNS), et non le UDP packet forwarder.
Réglez l’adresse du serveur (URI LNS, tc.uri) sur votre adresse LNS. Si la passerelle demande plutôt une adresse de découverte ou d’informations de routeur, utilisez l’adresse de découverte, qui se termine par /router-info.
Réglez le certificat du serveur (tc.trust) : téléversez le fichier tc.trust téléchargé, ou choisissez le magasin de certificats du système si la passerelle le propose.
Réglez le jeton d’autorisation (tc.key) sur la ligne d’en-tête du jeton. Certaines passerelles acceptent la ligne complète Authorization: Bearer <token> ; d’autres ont un champ jeton et ajoutent elles-mêmes la partie Authorization: Bearer. Si vous avez téléchargé tc.key, téléversez-le tel quel.
Enregistrez puis redémarrez le packet forwarder de la passerelle.

La passerelle s’affiche comme Online dans l’onglet LoRaWAN en moins d’une minute.

Les trois fichiers

Si votre passerelle utilise des fichiers, téléchargez-les depuis le panneau juste après avoir ajouté la passerelle (ou après avoir changé son jeton). Chaque fichier est un texte brut se terminant par un saut de ligne :

# tc.uri
wss://acme.lns.example.com

# tc.key
Authorization: Bearer 3q2-7…

# tc.trust
-----BEGIN CERTIFICATE-----
…
-----END CERTIFICATE-----

Les fichiers sont téléchargés directement depuis votre navigateur ; Hermetry ne place jamais le jeton dans un lien.

Ce qui se passe lorsque la passerelle se connecte

La passerelle ouvre une websocket sécurisée vers votre adresse et présente son jeton.
Le serveur réseau vérifie le jeton et que l’EUI de passerelle dans la connexion correspond à la passerelle à laquelle appartient le jeton.
La passerelle envoie sa version. Le serveur réseau répond avec la configuration radio EU868 (canaux, débits de données et NetID de votre réseau), vous n’avez donc pas à régler vous-même les canaux sur la passerelle.
Les uplinks commencent à circuler. L’appareil de la passerelle passe en ligne et son état de santé est enregistré une fois par minute.

Les trames qu’une passerelle envoie avant son message de version sont ignorées. Une passerelle qui envoie trois messages malformés en 60 secondes est déconnectée.

Vérifier la connexion

Ouvrez la passerelle sur la page Devices, puis son onglet LoRaWAN :

Le badge d’état indique Online.
Round trip indique le temps qu’un message met pour aller jusqu’à la passerelle et en revenir. Au-delà de 800 ms, la valeur est signalée : Liaison lente : les appareils avec un délai RX court basculent sur RX2.
Connected since indique quand la connexion actuelle a été établie.
Frames this gateway heard se remplit au fur et à mesure que les appareils émettent.

Dépannage

Symptôme	Cause probable	Que faire
La passerelle ne passe jamais en ligne	Elle utilise encore le UDP packet forwarder.	Passez-la sur Basics Station.
La passerelle ne passe jamais en ligne	La ligne du jeton est erronée ou incomplète.	Copiez à nouveau l’intégralité du Token header, ou changez le jeton et utilisez le nouveau.
La passerelle ne passe jamais en ligne	Le jeton appartient à une autre passerelle (EUI non concordant).	Chaque passerelle a son propre jeton. Utilisez le jeton délivré pour cet EUI.
La passerelle ne passe jamais en ligne	Elle ne fait pas confiance au certificat.	Utilisez le fichier `tc.trust`, ou le magasin de certificats système de la passerelle.
La passerelle ne passe jamais en ligne	Elle pointe vers une ancienne adresse depuis que votre adresse web a changé.	Copiez l’adresse LNS actuelle depuis l’onglet LoRaWAN de la passerelle.
Elle était en ligne, puis s’est arrêtée après un changement de jeton	L’ancien jeton cesse de fonctionner immédiatement.	Installez le nouveau jeton sur la passerelle.
Elle est Disabled	Quelqu’un l’a désactivée.	Sélectionnez Enable dans son onglet LoRaWAN.
En ligne, mais aucune trame	Aucun appareil à portée, ou les appareils utilisent une autre bande.	Vérifiez le journal des trames et que vos appareils sont bien des appareils EU868.

Motifs de refus utilisés par le serveur réseau : no_credential (aucun jeton ni certificat envoyé), bad_token (jeton inconnu ou erroné), eui_mismatch (le jeton ou le certificat appartient à un autre EUI), revoked (la passerelle est désactivée), mode_not_supported (la passerelle n’est pas en mode cloud). Le journal de votre passerelle peut afficher l’un de ces motifs comme raison de fermeture.