Zum Hauptinhalt springen

ChirpStack V3 Connector

Connector-Details ChirpStack​

Der ChirpStack V3 Connector ermöglicht es der Plattform, Geräte zu provisionieren und sich per MQTT für Geräte-Updates von einem ChirpStack V3 LoRaWAN-Server zu abonnieren. Dies automatisiert die ChirpStack-Integration und ermöglicht eine vollständige Geräteverwaltung direkt in Yggio. Unterstützte Operationen umfassen:

  • Provisionieren neuer Geräte
  • Abonnieren von Geräte-Updates
  • Löschen von Geräten

Voraussetzung: Ein MQTT-Broker, der in ChirpStack v3 hinzugefügt wurde, z. B. Mosquitto.

connector-chirpstack

Erforderliche Informationen

Um eine Verbindung zu einem ChirpStack-V3-Server einzurichten, geben Sie Folgendes an:

  • a. ChirpStack MQTT broker URL: lora.service.sensative.net (Sensative ChirpStack V3 LoraWAN-Server)
  • b. ChirpStack API URL: https://lora.service.sensative.net/api (Sensative ChirpStack V3 LoraWAN-Server)
  • c. Username: Ihr MQTT-/API-Benutzername
  • d. Password: Ihr Passwort
  • e. Application ID: Die in ChirpStack zu verwendende Application ID
  • f. Organization ID: Die in ChirpStack zu verwendende Organization ID
  • g. Network Server ID: Die in ChirpStack zu verwendende Network Server ID

⚠️ ChirpStack V3 muss mit allen oben genannten Angaben vorkonfiguriert sein, und der API-Benutzer muss die Rolle Admin haben, um diese Operationen durchzuführen. Wenn Sie eine 40x-Fehlerantwort erhalten, liegt das wahrscheinlich an falschen Zugangsdaten, einer falschen URL oder unzureichenden Zugriffsrechten. Stellen Sie sicher, dass alle Einstellungen überprüft und entsprechend angepasst wurden.

ChirpStack konfigurieren​

Beginnen Sie mit der Einrichtung des Zugriffs​

Melden Sie sich bei Ihrem ChirpStack-Server an und erstellen Sie ein API-Benutzerkonto. Erstellen Sie bei Bedarf auch eine neue Organization und Application. Wenn Sie keinen eigenen LoRaWAN-Server haben, aber eine private Einrichtung wünschen, wenden Sie sich bitte an Ihren Support-Kontakt.

  • a. Das Konto muss sowohl mit einer Organization als auch mit einer Application verknüpft sein, um die Geräteprovisionierung zu ermöglichen.
  • b. Der Benutzer muss in der Organization die Rolle Admin haben

ChirpStack Organization

ChirpStack Application

Beachten Sie, dass die ID für Organization und Application in der Browser-URL verfügbar ist

ChirpStack User

Geräteprofile erstellen​

In ChirpStack müssen Sie Device Profiles erstellen. Diese definieren die zu verwendenden LoRaWAN-Einstellungen, einschließlich ob OTAA unterstützt wird, die LoRaWAN-Version (üblicherweise 1.0.2, 1.0.4 oder 1.1), Regional Parameters (z. B. Region A, B oder eine bestimmte RP-Version) sowie ob das Gerät Class A oder Class C verwendet. Weitere Parameter können ebenfalls zutreffen.

Device Profiles sind wichtig - wenn die Einstellungen nicht mit dem tatsächlichen Gerät übereinstimmen, können LoRaWAN-Nachrichten verloren gehen, und Aktuatoren reagieren nicht sofort, sofern Class C nicht aktiviert ist.

Nach der Konfiguration erscheinen die Device Profiles in der IoT-Plattform beim Erstellen eines neuen LoRaWAN-Geräts.

ChirpStack User

Einrichten des Connectors​

Sobald die ChirpStack-Konfiguration abgeschlossen ist, fahren Sie mit der IoT-Plattform fort:

  1. Navigieren Sie zu Connectors → New Connector → ChirpStack V3 Connector
  2. Füllen Sie die erforderlichen Felder mit den gesammelten Informationen aus.

Beachten Sie, dass Network Server ID, Organization ID und Application ID alle in der URL-Leiste Ihres Browsers zu finden sind. Nachfolgend ein Beispiel für den Network Server; die obigen Abbildungen liefern weitere Details.

ChirpStack Network Server

Überprüfen des Connectors​

  • Die Plattform überprüft die Verbindung automatisch beim Erstellen des Connectors, dies garantiert jedoch nicht die volle Funktionsfähigkeit.

  • Für eine vollständige Überprüfung:

    1. Erstellen Sie ein Gerät in der Plattform mit dem ChirpStack-Connector.
    2. Öffnen Sie nach der Erstellung die Geräteseite.
    3. Gehen Sie zu Tools und prüfen Sie den Synchronize-Status - er sollte nicht "never" anzeigen.
    4. Klicken Sie manuell auf die Schaltfläche Synchronize, um zu bestätigen, dass es erfolgreich funktioniert.
    5. Melden Sie sich bei ChirpStack an und bestätigen Sie, dass das Gerät provisioniert wurde.
    6. Lösen Sie den ersten Uplink des Geräts aus (oder warten Sie darauf).
    7. Stellen Sie sicher, dass der Uplink empfangen und von der Plattform korrekt dekodiert wird.

Multi-Account-Einrichtung​

Es gibt zwei grundlegende Möglichkeiten, ChirpStack mit der IoT-Plattform zu integrieren:

1. Benutzer benötigen Zugriff auf ChirpStack Bilden Sie Teile der Organisationsstruktur der IoT-Plattform im ChirpStack-Server ab. Benutzer können ChirpStack-Konten erhalten, um LoRaWAN-spezifische Verbindungsparameter einzusehen und neue Device Profiles zu erstellen. Erstellen Sie in dieser Einrichtung einen Connector pro Organization.

2. Benutzer benötigen keinen Zugriff auf ChirpStack Verwenden Sie eine flache Struktur in ChirpStack, in der alle Geräte an einem gemeinsamen Ort verwaltet werden. Es wird nur ein Connector in der IoT-Plattform benötigt, der mit allen Benutzern geteilt werden kann, die Geräte hinzufügen müssen.

Hinweis: ChirpStack V3 unterstützt keine Abrechnung, daher muss die Abrechnung über die IoT-Plattform erfolgen.

⚠️ Wichtig:​

Wenn ein Gerät aus der IoT-Plattform gelöscht wird, wird es standardmäßig auch vom ChirpStack-LoRaWAN-Server gelöscht und außer Betrieb genommen. Um dies zu vermeiden, stellen Sie sicher, dass Sie im Bestätigungsdialog die Löschaktion abwählen.

Opt out delete

Fehlerbehebung​

Ich erhalte einen 40x-Fehler​

  • Dies deutet in der Regel auf ein Problem mit Ihrer URL, Ihren Zugangsdaten oder Ihren Zugriffsrechten hin. Prüfen Sie diese einzeln:
    • Überprüfen Sie die URL genau - stellen Sie sicher, dass kein abschließender / vorhanden ist.
    • Überprüfen Sie, ob Benutzername, Passwort und Zugriffsberechtigungen korrekt sind.
  • Tipp: Verwenden Sie die ChirpStack Swagger UI. Holen Sie sich nach der Anmeldung ein JWT-Token aus der ChirpStack-Oberfläche, geben Sie das JWT-Token ein, versuchen Sie ein Gerät zu erstellen und prüfen Sie, ob die Anfrage erfolgreich ist.
  • Gehen Sie zum Sensor in der ChirpStack-Benutzeroberfläche.
  • Bestätigen Sie, dass das Gerät tatsächlich Uplinks gesendet hat.
  • Bestätigen Sie, dass die MQTT-URL in der Verbindung korrekt ist und kein abschließender / vorhanden ist

Ich habe ein API-Gateway zwischen mir und ChirpStack - was soll ich tun?​

  • Stellen Sie sicher, dass das API-Gateway Zugriff auf sowohl die ChirpStack-API als auch den ChirpStack-MQTT-Broker gewährt.
  • Aktualisieren Sie beim Erstellen des Connectors die API- und MQTT-URLs, sodass sie auf die Gateway-Endpunkte verweisen, die korrekt zu ChirpStack weiterleiten.

Ich erhalte einen 40x-Fehler beim Versuch, Geräte zu importieren oder zu erstellen - woran könnte das liegen?​

  • Ein 40x-Fehler bedeutet, dass ChirpStack die Anfrage ablehnt. Dies wird üblicherweise verursacht durch:
    • Falsche Zugangsdaten
    • Falsche URL
    • Fehlende oder falsche Zugriffsrechte auf ChirpStack-Seite
  • Gehen Sie die Beispiel-Einrichtungsbilder durch und überprüfen Sie Folgendes:
    • Username, Password, API-URL
    • Network Server ID, Organization ID und Application ID
  • Bestätigen Sie außerdem:
    • Dass das ChirpStack-API-Benutzerkonto in der richtigen Organization als Admin User markiert ist