Überblick
Dieses Beispiel zeigt die Anbindung eines NB-IoT-Zählers mit dem Elvaco-Kommunikationsmodul CMi6110 an den niotix LwM2M Server (lwm2m.niotix.io). Die Verbindung erfolgt per LwM2M über den Bootstrap Server mit PSK/DTLS-Verschlüsselung; konfiguriert wird das Modul über die Elvaco OTC App (NFC).
Voraussetzungen
- Device EUI (= Serial Number des Moduls) – per Elvaco OTC App auslesbar
- PSK (Pre-Shared Key; bei Elvaco „bootstrapTransportKey", teils auch „Transport Secret Key" genannt) – nicht per OTC App auslesbar; wird von Elvaco als CSV-Datei bereitgestellt
- aktive SIM-Karte (für die Aktivierung wird i. d. R. die ICC ID benötigt); bei einem Mobilfunktarif mit privatem APN müssen die LwM2M-Endpunkte freigegeben sein – siehe Firewall-Whitelist
- Das Gerät darf nicht mehr in einer anderen LwM2M- bzw. Herstellerplattform registriert sein (z. B. Elvaco-Cloud) – die Löschung dort ggf. über den Elvaco-Support veranlassen
Zähler konfigurieren (OTC App)
In der Elvaco OTC App folgende Einstellungen setzen und per Apply auf das Gerät übertragen:
| Einstellung | Wert |
|---|---|
| BS URI | coaps://lwm2m.niotix.io:5694 |
| Upload Protocol | LwM2M Send¹ |
| Power Mode | Active² |
¹ Elvaco-Default ist MQTT-SN – ohne die Umstellung auf LwM2M Send werden keine Meter Data gesendet. Die Umstellung muss nicht zwingend vor dem Bootstrap erfolgen, sie kann auch nachträglich remote über LwM2M konfiguriert werden.
² Ab Werk befinden sich die Geräte im Schlafmodus – sie müssen einmalig aktiviert werden.
Anschließend unter Status → Network Connection prüfen, ob sich die SIM-Karte ins Mobilfunknetz eingebucht hat.
Weitere Hinweise:
- Bei Geräten, die bereits mit Elvaco-SIM und korrekt gesetzter BS URI laufen, ist keine Umkonfiguration am Gerät nötig.
- Bei eigenen SIM-Karten muss ggf. der APN am Modul konfiguriert werden.
- Bei Modulen mit externer Antenne ggf. die Antennen-Einstellung anpassen.
- Als Nachrichtenformat wird CBOR empfohlen.
Der unverschlüsselte Modus (coap://lwm2m.niotix.io:5693, Security Mode NoSec) sollte ausschließlich zu Testzwecken verwendet werden.
Gerät in niotix anlegen
In niotix ein Virtuelles Gerät mit dem Konnektor „LwM2M Server" anlegen (Connection Server Type: Bootstrap, Security Mode: PSK). Die Elvaco-Angaben werden dabei wie folgt zugeordnet:
| Elvaco | niotix (Virtuelles Gerät) |
|---|---|
| Serial Number (= Device EUI) | External ID |
| bootstrapTransportKey (PSK) | Device Key (Hex-Format) |
digimondo stellt fertige Gerätetreiber für das Parsen der CBOR-Nachrichten sowie Gerätetemplates bereit, die die Anlage vereinfachen – zum Anlegen werden dann nur Device EUI und bootstrapTransportKey benötigt. Mehrere Geräte lassen sich so bequem per CSV-Import auf Basis eines Gerätetemplates anlegen.
Details zu den Feldern und zum Datenformat beschreibt die Seite LwM2M Server im Abschnitt „Konfiguration des Virtuellen Gerätes in niotix".
Verbindung prüfen
Eine erfolgreiche Verbindung zum LwM2M-Server ist am Status „Bootstrap connection successful" erkennbar. Eingehende Daten erscheinen anschließend im _RAW-Datenpunkt des Virtuellen Geräts (Format siehe LwM2M Server).
Kommen keine Daten an, in dieser Reihenfolge prüfen:
- SIM/Netz: Ist die SIM-Karte aktiv und eingebucht (OTC App → Status → Network Connection)? Bei eigenen SIM-Karten: Stimmt der konfigurierte APN?
- APN-Firewall: Sind die LwM2M-Endpunkte aus dem APN erreichbar (siehe Firewall-Whitelist)?
- BS URI: Ist
coaps://lwm2m.niotix.io:5694exakt eingetragen? - EUI/PSK: Stimmen External ID und Device Key in niotix exakt mit den Gerätewerten überein?
- Upload Protocol: Steht die Einstellung auf „LwM2M Send"?
- Antenne: Bei Modulen mit externer Antenne die Antennen-Einstellung prüfen.
- Fremdplattform: Ist das Gerät noch in einer anderen Plattform (z. B. Elvaco-Cloud) registriert?