Decodierung Wert für Gesundheitszustand (= Verbindungsqualität)

Decodierung Wert für Gesundheitszustand (= Verbindungsqualität)

Das folgende Dokument beschreibt die Struktur des codierten Werts, den Sie über die REST API bzw. Push API abrufen können, sowie die Methode zur Decodierung. Der Wert enthält mehrere Informationen zur Empfangsqualität eines LoRaWAN-Sensors, darunter die Anzahl der verbundenen Gateways, Signalstärke (RSSI), Signal-Rausch-Verhältnis (SNR) und andere Parameter. Das folgende Dokument beschreibt die Struktur des codierten Werts, den Sie über die REST API abrufen können, sowie die Methode zur Decodierung. Weiterführende Informationen zur Verbindungsqualität finden Sie hier: Verbindungsqualität 

Codierter Wert

Der über die API abgerufene Wert ist eine Ganzzahl (Integer), die als 46-Bit binärer String interpretiert wird. Die einzelnen Bits sind in einer festen Struktur angeordnet und müssen entsprechend dekodiert werden.

Beispiel für einen codierten Wert:

  1. 42590503493070 bzw. 4.259050349307E13

Dieser Wert wird als 46-Bit Binärwert interpretiert.

Bit-Layout & Bedeutung der Werte

Die folgende Tabelle zeigt die Struktur der einzelnen Bits und ihre Bedeutung: 

Feldname

Bit-Länge

Interpretation

Wertbereich

Dekodierungsformel

signalBit

1 Bit

Startbit (immer 1)

1 (gültig)

1 (fix)

healthScore

3 Bits

Gesundheitsbewertung

1, 2, 3

bindec(bits)


1 = good
2 = medium
3 = bad

0, 4, 5, 6, 7 = undefined

dr (Datenrate)

3 Bits

LoRaWAN Datenrate (DR)

0 - 7

bindec(bits)

numGws (Gateways)

3 Bits

Anzahl verbundener Gateways

0 - 7

bindec(bits)

bestRssi

6 Bits

Beste empfangene Signalstärke (RSSI)

-128 bis 0 dBm

bindec(bits) * -2

bestSnr

6 Bits

Bestes Signal-Rausch-Verhältnis (SNR)

-20 bis 43 dB

bindec(bits) - 20

weakestRssi

6 Bits

Schwächste empfangene Signalstärke (RSSI)

-128 bis 0 dBm

bindec(bits) * -2

weakestSnr

6 Bits

Schwächstes Signal-Rausch-Verhältnis (SNR)

-20 bis 43 dB

bindec(bits) - 20

medianRssi

6 Bits

Median der RSSI-Werte

-128 bis 0 dBm

bindec(bits) * -2

medianSnr

6 Bits

Median des SNR

-20 bis 43 dB

bindec(bits) - 20


Werte interpretieren

  • RSSI-Werte werden mit * -2 umgerechnet, um dBm-Werte zu erhalten.
  • SNR-Werte werden um -20 reduziert, um reale Werte zu erhalten.
  • Die Anzahl der Gateways (numGws) gibt an, wie viele Gateways das Signal empfangen haben.
  • Datenrate (dr) zeigt die LoRaWAN-Datenrate, die für die Übertragung genutzt wurde.
  • HealthScore gibt einen allgemeinen Indikator für die Empfangsqualität des Geräts.

    • Beispiel für eine vollständige Decodierung

    Gegeben:
    1. 42590503493070
    Binärdarstellung (46 Bit):
    1. 1001101011110001011111110101001101110111001110

    Extrahierte Werte:

    Feld

    Binärwert

    Dezimalwert

    Berechnung

    signalBit

    1

    1

    (immer 1)

    healthScore

    001

    1

    bindec(001) = 1

    dr

    101

    5

    bindec(101) = 5

    numGws

    011

    3

    bindec(011) = 3

    bestRssi

    110001

    49

    bindec(110001) * -2 = -98 dBm

    bestSnr

    011111

    31

    bindec(011111) - 20 = 11 db

    weakestRssi

    110101

    53

    bindec(110101) * -2 = -106 dBm

    weakestSnr

    001101

    13

    bindec(001101) - 20 = -7 dB

    medianRssi

    110111

    55

    bindec(110111) * -2 = -110 dBm

    medianSnr

    001110

    14

    bindec(001110) - 20 = -6 db


      • Related Articles

      • MQTT

        MQTT (Message Queuing Telemetry Transport) ist ein leichtgewichtiges, publish/subscribe-basiertes Protokoll, das speziell für die zuverlässige Übertragung von Nachrichten in Umgebungen mit begrenzter Bandbreite und hoher Latenz entwickelt wurde. Es ...

      • Confluent Kafka

        Confluent Kafka ist eine auf Apache Kafka basierende Plattform, die entwickelt wurde, um Unternehmen eine leistungsstarke und skalierbare Lösung für das Streaming von Daten in Echtzeit zu bieten. Apache Kafka selbst ist ein verteiltes ...

      • Microsoft Azure Event Hub

        Einleitung Microsoft Azure Event Hub ist ein Cloud-basierter Service, der für die Verarbeitung und Analyse großer Mengen an Ereignisdaten in Echtzeit entwickelt wurde. Dieser Dienst ist besonders nützlich für Szenarien, in denen große Mengen an ...

      • Webhook

        Webhooks sind eine Methode, mit der eine Anwendung automatisch eine Nachricht oder eine Anfrage an eine andere Anwendung sendet, sobald ein bestimmtes Ereignis eintritt. Im Gegensatz zu traditionellen APIs, bei denen eine Anwendung aktiv Anfragen ...

      • REST API

        Die LineMetrics REST API bietet die Möglichkeit Daten via REST JSON API auszulesen bzw. Objekte in der Objektstruktur zu erstellen. Alle REST API Endpunkte sowie Beschreibung der einzelnen Endpunkte finden Sie in unserer Postman Collection welche ...