Ein Basics-Station-Gateway verbinden

Nachdem Sie ein Gateway hinzugefügt haben, konfigurieren Sie das Gateway selbst einmalig. Danach verbindet es sich selbstständig und bleibt verbunden; daran muss nichts weiter eingestellt werden. Diese Seite beschreibt die Einstellungen in allgemeiner Form. Gerätehersteller benennen die Menüs unterschiedlich, daher suchen Sie auf der Konfigurationsseite Ihres Gateways nach den entsprechenden Feldern.

Was das Gateway benötigt

Gateway-Einstellung	Basics-Station-Datei	Wert aus Hermetry
Netzwerkserver-Modus	—	Basics Station (LNS). Nicht der UDP-Packet-Forwarder.
Serveradresse (LNS-URI)	`tc.uri`	Ihre LNS-Adresse, zum Beispiel `wss://acme.<Netzwerkserver-Host>`
Serverzertifikat	`tc.trust`	Die heruntergeladene Datei `tc.trust` oder der Systemzertifikatspeicher des Gateways
Autorisierung	`tc.key`	Die Token-Header-Zeile: `Authorization: Bearer <token>`

Hermetry nutzt ausschließlich die LNS-Verbindung. Den Konfigurationsupdate-Dienst (CUPS), den manche Gateways anbieten, nutzt Hermetry nicht: Es gibt keine Dateien cups.uri oder cups.key. Konfigurieren Sie das Gateway einmalig von Hand und erneut von Hand, falls Sie sein Token rotieren.

Schritt für Schritt

Wählen Sie am Gateway den LoRaWAN-Netzwerkserver-Modus Basics Station (LNS), nicht den UDP-Packet-Forwarder.
Stellen Sie die Serveradresse (LNS-URI, tc.uri) auf Ihre LNS-Adresse ein. Falls das Gateway stattdessen eine Discovery- oder Router-Info-Adresse verlangt, verwenden Sie die Discovery-Adresse, die auf /router-info endet.
Stellen Sie das Serverzertifikat (tc.trust) ein: Laden Sie die heruntergeladene Datei tc.trust hoch oder wählen Sie den Systemzertifikatspeicher, falls das Gateway ihn anbietet.
Stellen Sie das Autorisierungs-Token (tc.key) auf die Token-Header-Zeile ein. Manche Gateways nehmen die ganze Zeile Authorization: Bearer <token>; andere haben ein Token-Feld und ergänzen den Teil Authorization: Bearer selbst. Wenn Sie tc.key heruntergeladen haben, laden Sie sie unverändert hoch.
Speichern Sie und starten Sie den Packet-Forwarder des Gateways neu.

Das Gateway wird innerhalb einer Minute als Online auf seinem LoRaWAN-Tab angezeigt.

Die drei Dateien

Falls Ihr Gateway Dateien verwendet, laden Sie sie direkt nach dem Hinzufügen des Gateways (oder nach dem Rotieren seines Tokens) aus der Seitenleiste herunter. Jede Datei ist Klartext und endet mit einem Zeilenumbruch:

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

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

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

Die Dateien werden direkt von Ihrem Browser heruntergeladen; Hermetry gibt das Token niemals in einem Link aus.

Was passiert, wenn sich das Gateway verbindet

Das Gateway öffnet eine sichere Websocket-Verbindung zu Ihrer Adresse und übermittelt sein Token.
Der Netzwerkserver prüft das Token und ob die Gateway-EUI in der Verbindung zu dem Gateway passt, zu dem das Token gehört.
Das Gateway sendet seine Version. Der Netzwerkserver antwortet mit der EU868-Funkkonfiguration (Kanäle, Datenraten und die NetID Ihres Netzwerks), sodass Sie die Kanäle nicht selbst am Gateway einstellen müssen.
Uplinks beginnen zu fließen. Das Gerät des Gateways geht online, und sein Zustand wird einmal pro Minute erfasst.

Frames, die ein Gateway vor seiner Versionsnachricht sendet, werden ignoriert. Ein Gateway, das innerhalb von 60 Sekunden drei fehlerhafte Nachrichten sendet, wird getrennt.

Verbindung prüfen

Öffnen Sie das Gateway auf der Seite Devices und dessen Tab LoRaWAN:

Das Statusabzeichen zeigt Online.
Round trip zeigt die Zeit, die eine Nachricht zum Gateway und zurück braucht. Ab 800 ms wird der Wert markiert: Langsame Verbindung: Geräte mit kurzer RX-Verzögerung weichen auf RX2 aus.
Connected since zeigt, wann die aktuelle Verbindung geöffnet wurde.
Frames this gateway heard füllt sich, während Geräte senden.

Fehlerbehebung

Symptom	Wahrscheinliche Ursache	Was zu tun ist
Das Gateway wird nie online	Es läuft noch der UDP-Packet-Forwarder.	Stellen Sie es auf Basics Station um.
Das Gateway wird nie online	Die Token-Zeile ist falsch oder unvollständig.	Kopieren Sie den gesamten Token-Header erneut oder rotieren Sie das Token und verwenden Sie das neue.
Das Gateway wird nie online	Das Token gehört zu einem anderen Gateway (EUI stimmt nicht überein).	Jedes Gateway hat sein eigenes Token. Verwenden Sie das für diese EUI ausgestellte Token.
Das Gateway wird nie online	Es vertraut dem Zertifikat nicht.	Verwenden Sie die Datei `tc.trust` oder den Systemzertifikatspeicher des Gateways.
Das Gateway wird nie online	Es zeigt auf eine alte Adresse, nachdem sich Ihre Web-Adresse geändert hat.	Kopieren Sie die aktuelle LNS-Adresse vom Tab LoRaWAN des Gateways.
Es war online und ging nach einer Token-Rotation offline	Das alte Token wird sofort ungültig.	Spielen Sie das neue Token auf dem Gateway ein.
Es ist Disabled	Jemand hat es deaktiviert.	Wählen Sie auf dessen Tab LoRaWAN Enable.
Online, aber keine Frames	Kein Gerät in Reichweite, oder Geräte nutzen ein anderes Band.	Prüfen Sie das Frame-Protokoll und ob Ihre Geräte EU868-Geräte sind.

Ablehnungsgründe des Netzwerkservers: no_credential (kein Token oder Zertifikat gesendet), bad_token (unbekanntes oder falsches Token), eui_mismatch (das Token oder Zertifikat gehört zu einer anderen EUI), revoked (das Gateway ist deaktiviert), mode_not_supported (das Gateway ist nicht im Cloud-Modus). Das eigene Protokoll Ihres Gateways zeigt einen dieser Werte womöglich als Schließgrund an.