Kopplungsmodus

Der Kopplungsmodus fügt Geräte hinzu, ohne jede DevEUI einzeln einzugeben. Für einige Minuten wird jedes Gerät, das noch nicht registriert ist und sich mit dem gemeinsamen AppKey des Profils verbindet, diesem Profil hinzugefügt. Er eignet sich für Chargen identischer Sensoren, die der Lieferant mit einem gemeinsamen AppKey ausgeliefert hat.

Der Kopplungsmodus ist standardmäßig ausgeschaltet und läuft pro Profil. Zum Starten und Stoppen benötigen Sie die Berechtigung, LoRaWAN-Geräte hinzuzufügen, zu bearbeiten und zu löschen.

Bevor Sie beginnen

• Verwenden Sie für die Charge ein LoRaWAN-Profil, zum Beispiel ein Profil, das Sie für diesen Sensortyp angelegt haben. Die Kopplung fügt die Geräte dem Profil hinzu, in dem sie läuft.
• Legen Sie den Shared AppKey des Profils auf dessen Registerkarte LoRaWAN fest (32 hexadezimale Ziffern) und speichern Sie. Ohne ihn zeigt der Abschnitt Pairing mode needs a shared AppKey on this profile. an und bietet nichts an.
• Prüfen Sie die LoRaWAN-Version und die Klasse des Profils: Geräte, die der Kopplungsmodus hinzufügt, erhalten diese Werte.
• Entscheiden Sie über die Freigabe mit Devices added by pairing mode are ready at once (no approval). Aus (der Standard) bedeutet, dass jedes neue Gerät wartet, bis es jemand freigibt. Siehe Freigabe von über Kopplung hinzugefügten Geräten.
• Stellen Sie sicher, dass ein Gateway in der Nähe der Geräte Online ist und dass Ihr Tarif Platz für die Geräte bietet.

Kopplungsmodus ausführen

1. Öffnen Sie das Profil und dessen Registerkarte LoRaWAN. Scrollen Sie zu Pairing mode; das Abzeichen zeigt Off.
2. Wählen Sie unter For how long 5, 15 (Standard), 30, 60 oder 120 Minuten.
3. Wählen Sie Start pairing und bestätigen Sie Start pairing mode: „Für n Minuten wird jedes Gerät, das sich mit dem gemeinsamen AppKey dieses Profils verbindet, Ihren Geräten hinzugefügt. Starten Sie es nur, während Sie Ihre eigenen Geräte einschalten.“
4. Das Abzeichen zeigt nun On: mit der verbleibenden Zeit, die herunterzählt.
5. Schalten Sie die Geräte ein oder lassen Sie sie sich verbinden.
6. Beobachten Sie Devices added. Die Liste wird alle 10 Sekunden neu eingelesen, solange die Kopplung läuft.
7. Wenn alle Geräte aufgelistet sind, wählen Sie Stop. Andernfalls schließt sich das Fenster von selbst, wenn die Zeit abgelaufen ist.

Wenn Sie Start pairing erneut wählen, während sie läuft, verschiebt sich das Ende des Fensters; bereits gefundene Geräte bleiben in der Liste.

Was mit jedem Gerät geschieht

1. Das Gerät sendet eine Join-Anfrage. Seine DevEUI ist auf der Plattform nirgends registriert.
2. Der Network Server probiert den gemeinsamen AppKey jedes Ihrer Profile aus, die sich im Kopplungsmodus befinden. Stimmt die Integritätsprüfung der Anfrage mit einem überein, wird das Gerät erkannt. Der Network Server beantwortet diese erste Anfrage nicht.
3. Hermetry fügt das Gerät diesem Profil hinzu, benannt LoRa <DevEUI>, mit Codec Automatic, unter Verwendung des gemeinsamen Schlüssels, der Version und der Klasse des Profils. Es zählt zu Ihrem Geräte-Limit.
4. Die Eigentümer und Administratoren Ihrer Organisation erhalten eine Benachrichtigung: LoRaWAN device DevEUI added by pairing mode.
5. Das Gerät sendet seine nächste Join-Anfrage (Geräte wiederholen sie selbstständig):
   • Bei erforderlicher Freigabe wird die Anfrage als Waiting for approval abgelehnt, bis jemand das Gerät freigibt.
   • Mit ready at once wird die Anfrage beantwortet und das Gerät tritt bei.

Das Frame-Protokoll zeigt die erste Anfrage als Being added by pairing mode.

Die Liste Devices added

Spalte	Zeigt
Name	LoRa <DevEUI>, bis Sie es umbenennen
DevEUI	Die EUI des Geräts
Added	Wann der Kopplungsmodus es hinzugefügt hat
Status	Waiting for approval (mit Schaltfläche Approve) oder Ready

Die Liste zeigt die Geräte des aktuellen (oder letzten) Fensters, neueste zuerst, bis zu 200. Ist sie leer, erscheint No device has been added by pairing mode yet.

Regeln und Schutzmaßnahmen

• Eine DevEUI, die bereits registriert ist, in Ihrer Organisation oder in einer anderen, wird durch die Kopplung nie hinzugefügt. Das Gerät einer anderen Organisation bleibt „A device of another network“.
• Ein Gerät, dessen Join zu keinem gemeinsamen AppKey eines Profils im Kopplungsmodus passt, wird wie immer als Unknown DevEUI abgelehnt.
• Die Kopplung funktioniert nur innerhalb des Fensters. Eine Anfrage, die im Fenster gesehen, aber später verarbeitet wird, wird gegen Beginn und Ende des Fensters geprüft.
• Wenn Ihr Geräte-Limit erreicht ist, werden weitere Geräte übersprungen.
• Ein Profil ohne gemeinsamen AppKey kann die Kopplung nicht starten: Hermetry lehnt mit Pairing mode needs a shared AppKey on the profile. (no_shared_appkey) ab.
• Start und Stopp werden im Audit-Log protokolliert (iot_lorawan.profile.pairing_started, iot_lorawan.profile.pairing_stopped); jedes hinzugefügte Gerät wird als iot_lorawan.device.paired protokolliert.

Über die API

Anfrage	Wirkung
GET /tenant/<tenantId>/api/iot/lorawan/profiles/<profileId>/pairing	Das Fenster und die von ihm hinzugefügten Geräte
POST …/pairing mit { "minutes": 15 }	Startet oder verlängert das Fenster (1–120 Minuten)
DELETE …/pairing	Stoppt es sofort

Die Antwort ist { pairing: { active, until, startedAt, hasSharedAppKey, found: [...] } }.