Wichtig! Produktübergreifende Dokumentation für Sensoren
      Zurück zur Startseite
      1. Help-Desk
      2. Wichtig! Produktübergreifende Dokumentation für Sensoren

      Generische LoRaWAN® Dokumentation

      Sie suchen die generische LoRaWAN® Dokumentation?

      Hier finden Sie die generische LoRaWAN® Dokumentation.

      Grundlagen

      📢 Dieses Dokument beschreibt sensorübergreifen die für das Funkprotokoll LoRaWAN® spezifischen Eigenschaften und einstellbaren Parameter.

      Join Verhalten der LoRaWAN® Sensoren

      Bevor Telemetriedaten via LoRaWAN versendet werden können, muss das Gerät eine Verbindung mit dem Netzwerk herstellen. Dazu versendet das Gerät so lange Join-Requests, bis erfolgreich ein Join-Accept empfangen wurde. Als Kompromiss zwischen Energieverbrauch und zügigem Join, werden die Sendeabstände der Join-Requests immer größer. Außerdem wird auch die Datarate variiert (zunächst große Datarate bzw. kleiner Spreizfaktor, dann kleinere Datarate bzw. größerer Spreizfaktor). Das Join Verhalten hält die Vorgaben und Empfehlungen der LoRa-Alliance Spezifikation strikt ein. Sentinum Sensoren setzen die Vorgaben durch sogenannte Join-Bursts, deren Abstand zueinander wächst, um

      Ein Join Burst besteht aus maximal 6 Join-Requests mit abnehmender Datarate (DR5-DR0) bzw. zunehmenden Spreizfaktor (SF7-SF12). Die Abstände zwischen den Requests nehmen quadratisch zu, um die Lora-Alliance spezifischen Duty-Cycle Richtlinien nicht zu verletzen. Die LoRa-Alliance schreibt einen Abnehmenden Duty-Cycle für Join Requests gemäß folgender Tabelle vor Zeit Duty-Cycle <1h 1% <11h 0.1%

      11h 0.01%

      Das Bedeutet das in der ersten Phase (<1h) genau so viel Sendebudget zur verfügung steht, wie in der zweiten (<11h), obwohl nur ein zehntel der Zeit zur verfügung steht. Um das Budget maximal auszunutzen, sind die Abstände zwischen Join Bursts (bestehend aus max. 6 Join Requests) zunächst klein und werden dann größer. Konkret werden in Phase 1 2 Bursts durchgeführt. In Phase 2 werden 2 weitere Bursts durchgeführt, ab Phase 3 wird 1 Burst pro Tag durchgeführt. Die länge der Bursts wächst von ca. 10 Minuten in Phase 1, über ca. 100 in Phase 2 , auf bis zu 16 Stunden in Phase 3, an.

      EUIs und Schlüssel

      Alle ausgelieferten Sentinum Sensoren besitzen

      • DEVEUI
      • APPEUI
      • APPKEY
      • Produktnummer

      Die 8 Byte DEVEUI ist eine aus dem Sentinum OUI-Block FC84A ausgewählte eindeutige Nummer, der den Sensoren zugewiesen wurde. Auch die 8 Byte APPEUI ist aus dem Sentinum eigenen Nummernkreis gewählt. Jeder Sensorreihe besitzt immer die gleiche APPEUI. Dadurch kann die Produktreihe innerhalb der Sentinum Produkte indentifiziert werden. Der 16 Byte APPKEY ist eine von einem Programm zufällig generierter Schlüssel.

      Zusätzlich besitzt jedes Produkt eine individuelle Produktnummer. Jede Produktnummer (APOQXXXX, FEBRXXXX, …) ist mit einer DEVEUI und einem APPKEY verknüpft.

      Der Lieferumfang beinhaltet für jeden LoRaWAN® Sensor die drei aufgeführten Schlüssel und sind Teil des Paketes. Zusätzlich werden die Schlüssel über die eine sichere Cloud bereitgestellt.

      Die APPEUI wird beim Auslesen durch die Sentinum LinQs App angezeigt.

      Default Parameter

      Die default Parameter und Vorseinstellungen gelten, falls in der produktspezifischen Dokumentation keine anderen Werte angegeben sind.

      Parameter Default Optional (einstellbar)
      Aktivierung OTAA ABP
      LoRa MAC Version 1.0.2 Update erfolgt falls Eigenschaften der Sensoren positiv beeinfluss werden.
      Join Loop Datarate Start SF7 (datarate 5)  
      Join Loop Datarate End Interne Temperatur  
      Regional Parameters RP001 Regional Parameters 1.0.2 revision B  
      REV REV B  
      Frequency Plan (for EU) Europe 863-870 MHz (SF12 for RX2 recommended)  

      Konfigurationsmöglichkeiten

      NFC- und Downlinkbefehle

      Name: APPEUI
      Beschreibung: Gibt die Application EUI (APPEUI) an, die die Produktserie innerhalb der Sentinum-Geräte identifiziert.
      JSON Schlüssel: app_eui
      Modul-Schlüssel: 0x1112
      Gruppe für Downlink: 0x00
      Property ID: 0x00
      Default Wert: 
      Minimaler Wert: 
      Maximaler Wert: 
      Einheit: 
      Read/Write: w 

      Name: APPKEY
      Beschreibung: Gibt den Application Key (APPKEY) an, der zur sicheren Authentifizierung und Verschlüsselung in der LoRaWAN-Kommunikation verwendet wird.
      JSON Schlüssel: app_key
      Modul-Schlüssel: 0x1112
      Gruppe für Downlink: 0x00
      Property ID: 0x01
      Default Wert: 
      Minimaler Wert: 
      Maximaler Wert: 
      Einheit: 
      Read/Write: w 

      Name: DEVEUI
      Beschreibung: Gibt die Device EUI (DEVEUI) an, eine eindeutige Kennung für jeden Sentinum-Sensor.
      JSON Schlüssel: dev_eui
      Modul-Schlüssel: 0x1112
      Gruppe für Downlink: 0x00
      Property ID: 0x02
      Default Wert: 
      Minimaler Wert: 
      Maximaler Wert: 
      Einheit: 
      Read/Write: r

      Name: Confirmed Strategy
      Beschreibung: Gibt an, ob der Sensor im Confirmed-Modus arbeitet:

      • 0: Unbestätigt (confirmed off)
      • 1: Bestätigte INFO-Nachrichten (Status-Uplinks) → Derzeit nicht verfügbar
      • 2: Bestätigte Alarm-Uplinks
      • 3: Alle Uplinks bestätigt

      JSON Schlüssel: conf
      Modul-Schlüssel: 0x1112
      Gruppe für Downlink: 0x01
      Property ID: 0x00
      Default Wert: 0
      Minimaler Wert: 0
      Maximaler Wert: 3
      Einheit: 
      Read/Write: rw 

      Name: Confirmed Retries
      Beschreibung: Maximale Anzahl der Wiederholungen (Sendeversuche) im Confirmed-Modus.
      JSON Schlüssel: retry
      Modul-Schlüssel: 0x1112
      Gruppe für Downlink: 0x01
      Property ID: 0x01
      Default Wert: 3
      Minimaler Wert: 1
      Maximaler Wert: 5
      Einheit: 
      Read/Write: rw 

      Name: ADR
      Beschreibung: Aktiviert oder deaktiviert Adaptive Data Rate (ADR).

      • 0: ADR aus
      • 1: ADR ein

      JSON Schlüssel: adr
      Modul-Schlüssel: 0x1112
      Gruppe für Downlink: 0x01
      Property ID: 0x02
      Default Wert: 3
      Minimaler Wert: 0
      Maximaler Wert: 1
      Einheit: 
      Read/Write: rw 

      Name: ADR SF min
      Beschreibung: Definiert den minimalen Spreading Factor (SF), auf den ADR zurückfallen kann.
      JSON Schlüssel: dr
      Modul-Schlüssel: 0x1112
      Gruppe für Downlink: 0x01
      Property ID: 0x03
      Default Wert: 5
      Minimaler Wert: 0
      Maximaler Wert: 5
      Einheit: datarate
      Read/Write: rw 

      Name: Fixed SF
      Beschreibung: Legt einen festen Spreading Factor (SF) fest, wenn ADR deaktiviert ist.
      JSON Schlüssel: drmax
      Modul-Schlüssel: 0x1112
      Gruppe für Downlink: 0x01
      Property ID: 0x04
      Default Wert: 0
      Minimaler Wert: 0
      Maximaler Wert: 5
      Einheit: datarate
      Read/Write: rw 

      Name: Enable Downlink Response
      Beschreibung: Gibt an, ob ein Downlink eine Uplink-Antwort auslöst, unabhängig von einer bestätigten Downlink-Bestätigung.

      • 0: Aus (keine Antwort)
      • 1: An (Downlink löst eine Uplink-Antwort aus)

      JSON Schlüssel: dresp
      Modul-Schlüssel: 0x1112
      Gruppe für Downlink: 0x01
      Property ID: 0x05
      Default Wert: 0
      Minimaler Wert: 0
      Maximaler Wert: 1
      Einheit: 
      Read/Write: rw 

      Name: ACTMTH
      Beschreibung: Bestimmt die Aktivierungsmethode für die LoRaWAN-Verbindung.

      • 0: OTAA (Over-The-Air Activation)
      • 1: ABP (Activation by Personalization)

      JSON Schlüssel: act_mth
      Default Wert: 0
      Minimaler Wert: 0
      Maximaler Wert: 1
      Einheit: 
      Read/Write: rw

      Name: CHKEV
      Beschreibung: Definiert nach wie vielen Übertragungen eine Netzprüfung durchgeführt wird. Die Art der Prüfung hängt von der Rejoin-Strategie (rejstr) ab:

      • 1: Link Check
      • 2: Confirmed Uplink mit ACK

      JSON Schlüssel: chkev
      Default Wert: 4
      Minimaler Wert: 1
      Maximaler Wert: 48
      Einheit: 
      Read/Write: rw 

      Name: REJAFT
      Beschreibung: Gibt an, nach wie vielen fehlgeschlagenen Checks der Sensor einen Rejoin-Versuch starten soll.
      JSON Schlüssel: rejaft
      Default Wert: 4
      Minimaler Wert: 0
      Maximaler Wert: 5
      Einheit: 
      Read/Write: rw

      📢 Die Werte der Gruppe für Downlink APPEUI, APPKEY, DEVEUI können nur via NFC gesetzt werden!

      Um die Schlüssel wie z.B. app_eui und app_key zu ändern und gleichzeitig einen REBOOT
      durchzuführen bitte immer folgendes ausführen:
      {
          „power“:“REBOOT“,
          „senticom“:{
          „app_eui“:“8XXXXXXXXXXXXXXX“,
          „app_key“:“XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX“
           }
      }
      Da app_eui und app_key write-only Parameter sind, können diese nicht von der App gelesen werden, außer diese wurden zuvor von der App beschrieben. Deshalb empfehlen wir in der Regel, die Keys dauerhaft in der JSON-Konfiguration stehen zu lassen. Falls gefordert ist, dass nutzerspezifische Keys gesetzt werden, diese aber keinesfalls auslesbar sein sollen, kann nach erstmaligem setzen der Keys ein weiteres JSON ohne diese Keys geschrieben werden. In diesem Falle bleiben die Keys im internen Speicher erhalten. Erst bei power=RESET werden diese auf Werkseinstellung zurückgesetzt.

      💡 rejstr, chkev und rejaft sind Features um einen Link Check zu aktivieren.

      SF vs. DR

      DR
      SF
      0
      SF12
      1
      SF11
      2
      SF10
      3
      SF9
      4
      SF8
      5
      SF7