CLS LoRaWAN Statistiken / Informationen

LoRaWAN Informationen

Beschreibung

In LoRaWAN Netzen gibt es für die Gateways einige interessante Statistikfelder, welche über diesen Call vom Gateway an das Backend übermittelt werden. Die Übertragung findet - falls aktiviert - einmal pro Minute statt. Bitte beachten, dass die Felder erst durch einen Neustart genullt werden und nicht nach der Übetragung.

Konfiguration

Ob die Geräte Systemstatusinformationen übermitteln wird über die Konfiguration festgelegt. Der Parmeter stats.lora muss auf den Wert 1 eingestellt sein, damit die Übertragung stattfindet.

Typ für die Abfrage im Datastore

Die Daten werden über die Serverfuntion lorastats übertragen und sind der MAC des Gateways zugeordnet.

Enthaltene Daten

Die Daten sind in einem JSON Objekt ablegt und es sind die folgende Bausteine enthalten:

• ts Erzeugunszeitpunkt der LoRa Statistiken als Unix-Timestamp
• chip_comm_error Kommunikationsstörungen mit dem LoRaWAN-Gateway-Chip, sollte immer 0 sein. Bei häufiger auftretenden Fehlern sollte das Gateway getauscht werden
• rx_crc_bad Anzahl der empfangenen LoRa-Pakete mit defekter CRC Prüfsumme
• rx_crc_missing Anzahl der empfangenen LoRa-Pakete ohne CRC Prüfsumme
• rx_nr_pkts Gesamtzahl der empfangenen LoRa-Pakete
• tx_busy Anzahl der Pakete, welche nicht versendet werden konnten, weil der Chip zu diesem Zeitpunkt bereits belegt war
• tx_dequeue_error Anzahl der Pakete, welche nicht korrekt aus der JIT-Queue entnommen werden konnten
• tx_failed Anzahl der Pakete, welche auf Grund eines unspezifischen Fehlers nicht gesendet werden konnten
• tx_override BESCHREIBUNG EINFÜGEN
• tx_peek BESCHREIBUNG EINFÜGEN
• tx_peek_index_zero BESCHREIBUNG EINFÜGEN
• tx_success Anzahl der korrekt ausgesendeten Pakete
• tx_type_beacon Anzahl der ausgesendeten Beacons
• util_fopen_failed Fehler beim Dateihandling der LoRa Software auf dem Gateway

Datensatz aus dem Datastore

Bei der Abfrage über den Datastore sollte über die API unbedingt die MAC und der Typ der Abfrage spezifiziert werden.

{
  "version": 1,
  "uid" : "CLSCON-7w98437",
  "clsbox" : "AA:BB:CC:DD:EE:FF",
  "ts" : { 
    "device":  1536049997,
    "server" : 1536049998 
  },
  "type": "lorastats",
  "data": {
     "chip_comm_error": 0,
     "rx_crc_bad": 13330,
     "rx_crc_missing": 100,
     "rx_nr_pkts": 9099292929,
     "tx_busy": 0,
     "tx_dequeue_error": 0,
     "tx_failed": 30,
     "tx_override": 5,
     "tx_peek": 0,
     "tx_peek_index_zero": 34,
     "tx_success": 1020888,
     "tx_type_beacon": 0,
     "util_fopen_failed": 0
  }
}

In den Daten wird der Wert ts für das Feld ts.device verwendet und nicht redundant unterhalb von data.ts gehalten.