Firefly

Der Firefly-Konnektor stellt eine bidirektionale Verbindung zu DIGIMONDOs Firefly LoRaWAN-Netzwerkserver her: Uplink-Daten werden über eine MQTT-Subscription empfangen; Downlinks und Gerätemanagement erfolgen über die Firefly-REST-API.

Weitere Inhalte zu Firefly in niotix: Überblick und Kapitel, Organisationsverwaltung, Geräteverwaltung, Anbindung von LoRaWAN-Gateways.

Details zur Funktion:

  • Authentifizierung: API-Schlüssel (für REST API und MQTT)
  • Protokoll: REST API (Gerätemanagement, Downlinks) + MQTT (Datenempfang via RabbitMQ-Subscription)
  • API-Timeout: 2.000 ms; MQTT-Timeout: 2.000 ms
  • Downlink-Parameter (konfigurierbar im Virtuellen Gerät oder in einer Regel):
    • eui — EUI des Zielgeräts (Pflichtfeld)
    • payload — Downlink-Payload (Pflichtfeld)
    • encoding — Kodierung: utf8 (Standard), base16, base64
    • port — LoRaWAN FPort, Standard: 0
    • confirmed — Bestätigter Downlink, Standard: false
  • Multicast-Downlink: Unterstützt (per Multicast-ID mcid)
  • Geräteparameter (Standard): Aktivierungsmodus OTAA; Region EU868; RX2 Data Rate 0 (SF 12 / BW 125 kHz)

Unterstützte Remote-Aktionen

  • Gerät erstellen: Unterstützt. Virtuelle Geräte, die in niotix erstellt werden, werden automatisch in der Organisation erstellt, auf die der Konnektor verweist.
  • Gerät importieren: Unterstützt. Virtuelle Geräte, die bereits in Firefly 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 Firefly verändert.
  • Gerät löschen: Unterstützt. Virtuelle Geräte, die in niotix gelöscht werden, werden automatisch aus der Firefly-Organisation 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

  • Instanz-Name: Individueller, einfach zu erschließender Name des Konnektors.
  • Beschreibung: Kurze Beschreibung.
  • Template: Wird im Moment nicht zum Aufbau der Verbindung benötigt, daher deaktiviert.
  • apiKey: API-Schlüssel der Firefly-Instanz – erforderlich zur Authentifizierung und zum Senden von Downlink-Paketen vom richtigen Konto.
  • baseURL: Adresse der Firefly-Instanz inkl. Protokoll (“http” oder “https”).
  • Firefly MQTT Url (optional): Adresse der Firefly RabbitMQ-Instanz inkl. Protokoll (“mqtt” oder “mqtts”), z. B. “mqtts://messagequeue.firefly.com”. Nur erforderlich, wenn Virtuelle Geräte mit Firefly angelegt werden sollen.