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) |
APPEUI 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
|