Neu: Die KI-Firewall überwacht die gesamte Plattform und erklärt jeden Vorfall in einfachen Worten. So funktioniert es

Ein Basics-Station-Gateway verbinden

Konfigurieren Sie jedes Basics-Station-Gateway mit der LNS-Adresse, dem Serverzertifikat und dem Token, damit es sich mit Hermetry verbindet.

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-EinstellungBasics-Station-DateiWert aus Hermetry
Netzwerkserver-Modus—Basics Station (LNS). Nicht der UDP-Packet-Forwarder.
Serveradresse (LNS-URI)tc.uriIhre LNS-Adresse, zum Beispiel wss://acme.<network server host>
Serverzertifikattc.trustDie heruntergeladene Datei tc.trust oder der Systemzertifikatspeicher des Gateways
Autorisierungtc.keyDie Token-Header-Zeile: Authorization: Bearer <token>

Hermetry nutzt nur die LNS-Verbindung. Der Konfigurationsupdate-Dienst (CUPS), den manche Gateways anbieten, wird nicht verwendet: Es gibt keine Dateien cups.uri oder cups.key. Konfigurieren Sie das Gateway einmal von Hand und, falls Sie sein Token rotieren, erneut von Hand.

Schritt für Schritt

  1. Wählen Sie am Gateway den LoRaWAN-Netzwerkserver-Modus Basics Station (LNS), nicht den UDP-Packet-Forwarder.
  2. Stellen Sie die Serveradresse (LNS-URI, tc.uri) auf Ihre LNS-Adresse ein. Verlangt das Gateway stattdessen eine Discovery- oder Router-Info-Adresse, verwenden Sie die Discovery-Adresse, die auf /router-info endet.
  3. 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.
  4. 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. Haben Sie tc.key heruntergeladen, laden Sie die Datei unverändert hoch.
  5. Speichern Sie und starten Sie den Packet-Forwarder des Gateways neu.

Das Gateway wird innerhalb einer Minute auf dem Reiter LoRaWAN als Online angezeigt.

Die drei Dateien

Wenn Ihr Gateway Dateien einliest, laden Sie sie direkt nach dem Hinzufügen des Gateways (oder nach dem Rotieren seines Tokens) aus der Seitenleiste herunter. Jede Datei ist reiner Text 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 nie in einem Link weiter.

Was geschieht, wenn sich das Gateway verbindet

  1. Das Gateway öffnet eine sichere Websocket-Verbindung zu Ihrer Adresse und legt sein Token vor.
  2. Der Netzwerkserver prüft das Token und ob die Gateway-EUI in der Verbindung zu dem Gateway passt, zu dem das Token gehört.
  3. Das Gateway sendet seine Version. Der Netzwerkserver antwortet mit der Funkkonfiguration des Frequenzplans (Kanäle, Datenraten und Ihre NetID), sodass Sie die Kanäle nicht selbst am Gateway einstellen müssen.
  4. 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 Geräte und dann den Reiter LoRaWAN:

  • Das Statusabzeichen zeigt Online.
  • Round Trip zeigt die Zeit, die eine Nachricht bis zum Gateway und zurück benötigt. Ab 800 ms wird der Wert markiert: Langsame Verbindung: Geräte mit kurzer RX-Verzögerung weichen auf RX2 aus.
  • Verbunden seit zeigt, wann die aktuelle Verbindung geöffnet wurde.
  • Vom Gateway empfangene Frames füllt sich, sobald Geräte senden.

Fehlerbehebung

SymptomWahrscheinliche UrsacheWas zu tun ist
Das Gateway geht nie onlineEs läuft noch der UDP-Packet-Forwarder.Stellen Sie es auf Basics Station um.
Das Gateway geht nie onlineDie Token-Zeile ist falsch oder unvollständig.Kopieren Sie den vollständigen Token-Header erneut oder rotieren Sie das Token und verwenden Sie das neue.
Das Gateway geht nie onlineDas Token gehört zu einem anderen Gateway (EUI stimmt nicht überein).Jedes Gateway hat ein eigenes Token. Verwenden Sie das für diese EUI ausgestellte Token.
Das Gateway geht nie onlineEs vertraut dem Zertifikat nicht.Verwenden Sie die Datei tc.trust oder den Systemzertifikatspeicher des Gateways.
Das Gateway geht nie onlineEs verweist auf eine alte Adresse, nachdem sich Ihre Web-Adresse geändert hat.Kopieren Sie die aktuelle LNS-Adresse vom Reiter LoRaWAN des Gateways.
Es war online und ist nach einer Token-Rotation stehen gebliebenDas alte Token wird sofort ungültig.Hinterlegen Sie das neue Token auf dem Gateway.
Es ist DeaktiviertJemand hat es deaktiviert.Wählen Sie auf dem Reiter LoRaWAN des Gateways Aktivieren.
Online, aber keine FramesKein Gerät in Reichweite oder Geräte nutzen ein anderes Band.Prüfen Sie das Frame-Protokoll und ob Ihre Geräte denselben Frequenzplan wie das Gateway verwenden.

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 möglicherweise als Grund für das Schließen der Verbindung an.

Verwandte Themen