Der von Semtech entwickelte UDP-Packet Forwarder auf einem LoRa bzw. LoRaWAN Gateway ist für den bidirektionalen Datentransfer zwischen dem Gateway und dem Netzwerkserver zuständig. Dieser Artikel beschreibt die JSON Objekte, die ab dem 12 Byte an eine Nachricht angefügt werden. Weitere Informationen zu den ersten 12 Bytes einer jeden Nachricht werden in diesem Artikel näher erläutert.

Welche JSON Objekte gibt es?

Für den Uplink (Sendung vom Gateway zum Netzwerkserver) werden zwei JSON Objekte (STAT & RXPK) verwenden. STAT übermittelt den Status vom Gateway (Standort, div. Zähler und Zeitstempel) und RXPK ein vom Gateway empfangenes Datenpaket mit den Dateninhalt und Informationen zum Paket selbst (Größe, Signalstärke, Modulation usw.)

Für den Downlink (Sendung vom Netzwerkserver zum Gateway) gibt es zwei JSON Objekte (TXPK, TXPK_ACK). Mit TXPK werden Datenpakete an das Gateway übermittelt, welche per Funk ausgesendet werden sollen. Wurde der Downlink vom Gateway akzeptiert bzw. kann gesendet werden, wird als Antwort nur ein 12 Byte TX_ACK ohne JSON Objekt gesendet. Im Fehlerfall wird das TXPK_ACK Objekt an die vorherigen 12 Byte angefügt und zum Netzwerkserver zurückgesendet.

Die JSON Objekte im Detail

Die folgenden Tabellen beschreiben die einzelnen Keys vom jeweiligen JSON Objekt.

STAT (Zyklische Statusnachrichten vom Gateway zum Netzwerkserver):

{"stat":{"ackr":0.000000,"dwnb":0,"rxfw":0,"rxnb":0,"rxok":0,"time":"2024-11-15 10:45:54 GMT","txnb":0}}

RXPK (Empfangenes Datenpaket oder mehrere Datenpakete in einem Array):

{"rxpk":[{"chan":0,"codr":"4/5","data":"QN3Mu6qATgEBddf3CGO3W+c=","datr":"SF7BW125","freq":868.100000,"lsnr":9.750000,"modu":"LORA","rfch":1,"rssi":-32,"size":26,"stat":1,"time":"2024-11-15T10:47:43.674536Z","tmst":2905060155}]}

TXPK (Downlink: Senden eines Telegramms über ein Gateway):

{"txpk":{"imme":true,"freq":868.500,"rfch":1,"powe":14,"modu":"LORA","datr":"SF11BW125","codr":"4/5","ipol":false,"size":24,"data":"3UBCTIB9FOa+LyVdGkt63237S2p4CEX/"}}

TXPK_ACK (Antwort vom Gateway zum Netzwerkserver auf ein PULL-RESP):

{"txpk_ack":{"error":"TX_FREQ"}}

Mit dem Key "error" können folgende Fehlermeldungen Übermittelt werden: