Ein OTAA-Gerät muss sich anmelden (Join), bevor der Network Server seine Daten annimmt. Diese Seite verfolgt einen Join-Request durch alle Prüfungen, damit Sie anhand des Join-Status oder des Frames-Logs erkennen können, an welcher Stelle ein fehlgeschlagener Join abbricht.
Die Schritte
- Das Gerät sendet einen Join-Request. Er enthält die JoinEUI, die DevEUI, eine DevNonce (eine Zahl, die das Gerät selbst wählt) und einen Integritätscode (MIC), der mit dem AppKey berechnet wird.
- Gateways leiten ihn weiter. Kopien von mehreren Gateways werden wie bei jedem Uplink zusammengeführt.
- Die DevEUI wird nachgeschlagen. Der Network Server sucht die DevEUI im plattformweiten Verzeichnis.
- Nirgends registriert: Ist eines Ihrer Profile im Pairing-Modus und stimmt der Request mit dessen gemeinsamem AppKey überein, übernimmt das Pairing (siehe Pairing-Modus). Andernfalls wird der Request als Unbekannte DevEUI verworfen.
- In einer anderen Organisation registriert: wird als Gerät eines anderen Netzwerks verworfen. Weitere Informationen dazu erhalten Sie nicht.
- Der Gerätedatensatz wird geprüft.
- Ein ABP-Gerät, das einen Join-Request sendet, wird abgelehnt (ABP-Gerät hat einen Join-Request gesendet).
- Ein Gerät, das vom Pairing-Modus zurückgehalten wird, wird abgelehnt (Warten auf Genehmigung).
- Ein Gerät ohne Schlüssel wird abgelehnt (Kein AppKey gespeichert).
- Die JoinEUI wird verglichen mit der gespeicherten, sofern das Gerät nicht jede JoinEUI akzeptiert. Eine abweichende wird abgelehnt (Join abgelehnt: andere JoinEUI).
- Der Integritätscode wird geprüft mit dem AppKey (dem eigenen Schlüssel des Geräts bzw. dem gemeinsamen Schlüssel des Profils bei Geräten, die über Pairing hinzugefügt wurden). Eine Abweichung führt zur Ablehnung (Join abgelehnt: falscher AppKey?).
- Die DevNonce wird geprüft (siehe unten). Eine bereits verwendete wird abgelehnt (Join abgelehnt: DevNonce wurde schon verwendet).
- Eine Session wird angelegt. Der Network Server wählt in seinem Netzwerk eine freie Geräteadresse (DevAddr), leitet die beiden Session-Schlüssel ab und speichert sie verschlüsselt. Die neue Session bleibt ausstehend, bis der erste Uplink des Geräts eingeht.
- Die Join-Accept wird gesendet. Sie läuft über das beste Gateway, das das Gerät noch erreichen kann: 5 Sekunden nach dem Request (RX1, gleicher Kanal) oder 6 Sekunden danach (RX2, 869,525 MHz, DR0). Die Accept teilt dem Gerät seine Adresse, die RX1-Verzögerung seines Profils (standardmäßig 5 s), den RX1-Datenraten-Offset, die RX2-Datenrate und die zusätzlichen Kanäle des Frequenzplans mit (auf EU868 fünf).
- Das Gerät sendet seinen ersten Uplink mit der neuen Session. Ab diesem Moment werden seine Frames akzeptiert.
Wenn alle Prüfungen bestanden sind, zeigt das Join-Badge des Geräts Verbunden an, und das Gerät erhält die Attribute lora.devAddr und lora.joinedAt.
Kann kein Gateway eines der beiden Fenster nutzen (alle offline, deaktiviert oder ohne Duty-Cycle-Budget), wird die Session angelegt, die Accept aber nicht gesendet. Das Join-Badge zeigt dann Join-Antwort nicht gesendet (kein Gateway rechtzeitig), und das Gerät versucht es erneut.
Ein abgelehntes Gerät erhält nie eine Antwort. LoRaWAN kennt keine Nachricht „Join abgelehnt“, daher versucht das Gerät es einfach später erneut.
DevNonce-Regeln
Die DevNonce verhindert, dass jemand einen alten Join-Request wiederholt (Replay).
| LoRaWAN-Version | Regel |
|---|---|
| 1.0.4 | Jede DevNonce muss größer sein als die zuletzt akzeptierte. |
| 1.0.2 und 1.0.3 | Eine DevNonce darf nicht schon einmal verwendet worden sein. Die letzten 256 Werte werden gespeichert. |
Ein Gerät, das neu startet und seine DevNonce wieder bei 0 zählt (1.0.4), oder einen Wert wählt, den es schon einmal verwendet hat (1.0.2, 1.0.3), wird abgelehnt, bis es einen neuen Wert verwendet. Wenn Sie für das Gerät einen neuen AppKey setzen, wird sein DevNonce-Verlauf gelöscht.
Join-Status
Der Tab LoRaWAN des Geräts zeigt ein Join-Badge:
| Badge | Bedeutung |
|---|---|
| Noch nicht verbunden | Kein Join erfasst und keine Session vorhanden. |
| Verbunden | Der letzte Join wurde akzeptiert, oder das Gerät hat eine aktive Session. |
| Join abgelehnt: falscher AppKey? | Die Integritätsprüfung ist fehlgeschlagen. |
| Join abgelehnt: DevNonce wurde schon verwendet | Der Replay-Schutz hat die DevNonce abgelehnt. |
| Join abgelehnt: andere JoinEUI | Die JoinEUI weicht von der gespeicherten ab. |
| Join-Antwort nicht gesendet (kein Gateway rechtzeitig) | Alle Prüfungen waren bestanden, aber kein Gateway konnte die Accept senden. |
| Kein AppKey gespeichert | Das Gerät hat keinen Schlüssel, mit dem geprüft werden könnte. |
| Warten auf Genehmigung | Durch den Pairing-Modus hinzugefügt, noch nicht genehmigt. |
| ABP-Gerät: es meldet sich nicht an | Ein ABP-Gerät hat einen Join-Request gesendet. |
| Join abgelehnt (Grund) | Jede andere Ablehnung, mit ihrem Code. |
Über die API nimmt die Geräteliste den Filter joinState mit joined, refused oder never entgegen.
Session zurücksetzen
Session zurücksetzen im Tab LoRaWAN des Geräts beendet die aktuelle Session des Geräts. Seine Uplinks werden abgelehnt, bis es sich erneut anmeldet.
Verwenden Sie diese Funktion, nachdem das Gerät auf die Werkseinstellungen zurückgesetzt wurde oder Sie seine Schlüssel geändert haben, damit keine alte Session bestehen bleibt. Bestätigen Sie mit Session zurücksetzen: „Das Gerät muss sich erneut anmelden, bevor seine Uplinks akzeptiert werden. Verwenden Sie diese Funktion, nachdem ein Gerät zurückgesetzt wurde oder seine Schlüssel geändert wurden.“
Das Zurücksetzen der Session bringt das Gerät nicht zum Anmelden: Das Gerät muss selbst einen Join starten (Neustart über Aus- und Einschalten oder über seine Join-Taste). Die Funktion steht für ABP-Geräte nicht zur Verfügung. Jedes Zurücksetzen wird als iot_lorawan.device.session_reset protokolliert.

