Der Konnektor stellt eine Verbindung zur Chirpstack-Instanz her: Uplinks werden per Webhook (HTTP POST) empfangen; Gerätemanagement und Downlinks erfolgen über die Chirpstack REST API. Ein Konnektor ist immer auf eine “Application” in Chirpstack begrenzt. Der Konnektor unterstützt die Chirpstack Versionen 3 und 4.
Details zur Funktion:
- Authentifizierung: API-Schlüssel (Bearer Token)
- Datenpfad (eingehend): Webhook-basiert — Chirpstack sendet Uplinks per HTTP POST an niotix
- Chirpstack-Version: v3 oder v4 (Standard: v4); für v4 ist zusätzlich die Tenant ID erforderlich
- API-Timeout: 2.000 ms
- Downlink-Parameter (konfigurierbar im Virtuellen Gerät oder in einer Regel):
EUI— EUI des Zielgeräts als Hex-String (16 Zeichen, Pflichtfeld)data— Downlink-Payload als Hex-String (Pflichtfeld)port— LoRaWAN FPort, Standard:0confirmed— Bestätigter Downlink, Standard:falsepending— Als Pending markieren, Standard:false
Unterstützte Remote-Aktionen
- Gerät erstellen: Unterstützt. Virtuelle Geräte, die in niotix erstellt werden, werden automatisch in der Application erstellt, auf die der Konnektor verweist.
- Gerät importieren: Unterstützt. Virtuelle Geräte, die bereits in Chirpstack vorhanden sind, können über ihre EUI importiert werden.
- Gerät aktualisieren: Unterstützt. Konnektorspezifische Eigenschaften die im Virtuellen Gerät verändert werden, wie zum Beispiel Region oder der Titel, werden auch in Chirpstack verändert.
- Gerät löschen: Unterstützt. Virtuelle Geräte, die in niotix gelöscht werden, werden automatisch aus der Chirptstack-Application gelöscht (wenn die Option “Gerät im externem Service beim Löschen” aktiviert ist).
- Downlink senden: Unterstützt. Es können Downlinks aus dem Virtuellen Gerät oder einer Regel im Digitalen Zwilling versendet werden.
Einstellungen
- Instanzname: Individueller, einfach zu erschließender Name des Konnektors.
- Beschreibung: Kurze Beschreibung.
- Chirpstack Version: Chirpstack-Version, für die der Konnektor verwendet werden soll.
- Base URl: Basis-URL der Chirpstack-Instanz, unter der die API erreichbar ist.
- API-KEY: API-Schlüssel des Chirpstack-Tenants.
- Application ID: Die Id der Application aus Chirpstack für die der Konnektor erstellt werden soll.
- Template: Das Template “Chirpstack v3” ist ebenfalls kompatibel mit der Version 4. Spezifische Änderungen bei der Datentransformation können hier bei Bedarf vorgenommen werden.