ABP-Gerät hinzufügen

Ein ABP-Gerät (Activation by Personalisation) tritt keinem Netz bei. Seine Adresse (DevAddr) und seine beiden Sitzungsschlüssel sind im Gerät hinterlegt, und es sendet mit ihnen ab dem ersten Frame. Verwenden Sie ABP nur, wenn das Gerät kein OTAA kann: OTAA ist sicherer und lässt sich einfacher wiederherstellen. Diese Seite erklärt, wie Sie ein ABP-Gerät registrieren und wie Sie mit seinen Frame-Countern umgehen.

ABP wird für LoRaWAN 1.0.x (1.0.2, 1.0.3, 1.0.4) unterstützt. Sie benötigen die Berechtigung, LoRaWAN-Geräte hinzuzufügen, zu bearbeiten und zu löschen.

Was Sie benötigen

Wert	Format
DevEUI	16 hexadezimale Ziffern
JoinEUI	16 hexadezimale Ziffern (wird nicht zum Beitritt verwendet; 0000000000000000 ist zulässig)
DevAddr	8 hexadezimale Ziffern, wie im Gerät eingestellt
NwkSKey (Netzwerk-Sitzungsschlüssel)	32 hexadezimale Ziffern
AppSKey (Anwendungs-Sitzungsschlüssel)	32 hexadezimale Ziffern

Die DevAddr muss zu diesem Netz gehören

Jedes LoRaWAN-Netz hat eine NetID, und die ersten Bits einer DevAddr kennzeichnen das Netz. Die Gateways von Hermetry erhalten die NetID des Netzes und verwerfen Frames, deren DevAddr zu einem anderen Netz gehört. Daher lehnt Hermetry eine solche Adresse von vornherein ab.

Passt die Adresse nicht, antwortet Hermetry mit Diese DevAddr gehört nicht zu diesem Netz. Verwenden Sie eine Adresse mit dem NetID-Präfix des Netzes. (devaddr_not_in_netid), und die Details des Fehlers nennen die NetID des Netzes. Bei der NetID 000000 muss die DevAddr zwischen 00000000 und 01FFFFFF liegen. Stammt Ihr Gerät mit einer Adresse außerhalb dieses Bereichs, stellen Sie im Gerät eine neue DevAddr ein.

Eine DevAddr kann nur von einem aktiven Gerät in Ihrer Organisation verwendet werden. Ein zweites Gerät mit derselben Adresse wird abgelehnt: Ein anderes Gerät dieses Mandanten verwendet bereits diese DevAddr. (devaddr_taken).

Gerät hinzufügen

1. Öffnen Sie Geräte und wählen Sie Neues Gerät.
2. Wählen Sie LoRaWAN-Gerät.
3. Stellen Sie Aktivierung auf ABP (Adresse und Sitzungsschlüssel im Gerät eingestellt). Das Formular zeigt einen Hinweis zu Frame-Countern und den ABP-Feldern.
4. Füllen Sie Name, DevEUI, JoinEUI (AppEUI), DevAddr, NwkSKey (Netzwerk-Sitzungsschlüssel) und AppSKey (Anwendungs-Sitzungsschlüssel) aus und danach LoRaWAN-Version und Klasse.
5. Wählen Sie Gerät hinzufügen.

Der Dialog meldet Das Gerät wurde hinzugefügt. Seine Uplinks werden ab dem ersten Frame empfangen.

Frame-Counter

Jeder Uplink trägt einen Frame-Counter. Der Network Server akzeptiert nur einen Counter, der vorwärts läuft (höchstens um 16.384 auf einmal). Eine Wiederholung wird nur als erneute Übertragung des letzten bestätigten Uplinks akzeptiert. So werden wiedergegebene Frames blockiert.

Für ein ABP-Gerät ist dies wichtig:

• Die Counter beginnen bei 0, wenn Sie das Gerät hinzufügen.
• Viele ABP-Geräte beginnen ihren Counter bei jedem Neustart oder Batteriewechsel erneut bei 0. Ihre nächsten Frames wirken dann wie alte Frames und werden verworfen; im Frame-Protokoll erscheinen sie als Replayed frame oder Frame counter jumped.
• Hermetry synchronisiert einen Counter nie selbstständig neu. Sie entscheiden.

Counter nach einem Neustart des Geräts zurücksetzen

1. Stellen Sie sicher, dass das Gerät seine Counter tatsächlich zurückgesetzt hat (etwa weil es neu geflasht oder die Batterie gewechselt wurde).
2. Öffnen Sie den Reiter LoRaWAN des Geräts und wählen Sie Counter zurücksetzen.
3. Bestätigen Sie Frame-Counter zurücksetzen: „Verwenden Sie dies nur, nachdem das Gerät seine Counter zurückgesetzt hat. Bis das Gerät erneut sendet, könnte ein aufgezeichneter alter Frame von ihm einmal akzeptiert werden. Das Zurücksetzen wird im Audit-Log erfasst.“

Der nächste Uplink-Counter wird ab 0 akzeptiert, und der Downlink-Counter beginnt bei 0. Der Reiter zeigt Counter zuletzt zurückgesetzt. Der Audit-Eintrag iot_lorawan.device.counters_reset erfasst die ersetzten Counter.

Ein ABP-Gerät hat keine Schaltfläche Sitzung zurücksetzen: Es kann nicht beitreten, und das Beenden seiner Sitzung würde es abtrennen. Hermetry lehnt dies ab mit Ein ABP-Gerät tritt nicht bei: Seine Sitzung kann nicht zurückgesetzt werden. Setzen Sie seine Counter zurück oder geben Sie ihm neue Sitzungsschlüssel.

Funkeinstellungen eines ABP-Geräts

Da ein ABP-Gerät nie beitritt, wurden ihm die Einstellungen des Profils nie mitgeteilt. Es startet mit den LoRaWAN-1.0.x-Standardwerten von EU868: RX1-Verzögerung 1 Sekunde, RX1-Datenratenversatz 0, RX2 bei 869,525 MHz und DR0, sowie nur die drei Standardkanäle. Der Network Server plant Downlinks mit diesen Werten und fordert das Gerät per MAC-Befehlen auf, auf die RX1-Verzögerung des Profils (standardmäßig 5 Sekunden) zu wechseln. Bis das Gerät dies bestätigt, verwenden Downlinks, was das Gerät tatsächlich hat.

Ein Zurücksetzen der Counter setzt auch diese Funkwerte auf die Standardwerte zurück.

Sitzungsschlüssel ersetzen

Geben Sie im Reiter LoRaWAN unter Schlüssel die DevAddr (mit der aktuellen vorausgefüllt), Neuer NwkSKey und Neuer AppSKey ein und wählen Sie Schlüssel ersetzen. Bestätigen Sie: „Eine neue Sitzung startet mit Countern bei 0. Stellen Sie im Gerät dieselbe Adresse und dieselben Schlüssel ein, sonst wird es nicht mehr empfangen.“ Alle drei Werte gehören zusammen; Hermetry lehnt eine teilweise Änderung ab mit Eine neue ABP-Sitzung benötigt DevAddr, NwkSKey und AppSKey gemeinsam.

Über die API

POST /tenant/<tenantId>/api/iot/lorawan/devices
Content-Type: application/json

{
  "activation": "ABP",
  "name": "Meter 12",
  "devEui": "1122334455667712",
  "devAddr": "0100A3F1",
  "nwkSKey": "<32 hex digits>",
  "appSKey": "<32 hex digits>",
  "macVersion": "1.0.3",
  "class": "A"
}

Ein ABP-Body mit einem appKey oder ein OTAA-Body mit Sitzungsschlüsseln wird abgelehnt. Setzen Sie die Counter mit DELETE /tenant/<tenantId>/api/iot/lorawan/devices/<deviceId>/counters zurück.