Uživatelská příručka
WM-I3® měřicí modem
Nastavení LwM2M (podle termínu WM-E)
v1.70

WM-I3 LLC Inovace v systémech Smart IoT

Specifikace dokumentu

Tato dokumentace byla vytvořena pro prezentaci konfiguračních kroků LwM2M kompatibilní provoz a komunikaci WM-I3® počítadlo pulzů / sběrač dat MBUS a zařízení vysílače.

Verze dokumentu:	REV 1.70
Typ/verze hardwaru:	Uživatelská příručka WM-I3® měřicí modem – nastavení LwM2M
Verze hardwaru:	V 3.1
Verze bootloaderu:	V 1.81
Verze firmwaru:	V 1.9m
Konfigurace WM-E Term®	V 1.3.71
verze softwaru:	18
Stránky:	Finále
Postavení:	17-06-2021
Vytvořeno:	27-07-2022
Naposledy změněno:	17-06-2021

Kapitola 1. Úvod

The WM-I3® je naše 3. generace nízkoenergetického celulárního pulzního počítadla a dataloggeru s vestavěným celulárním modemem pro chytré měření vody a plynu. Automatizované odečty vodoměrů s přizpůsobitelnými poruchami, detekcí úniků a prevencí. Detekce úniků vody pro zamezení záplav, netržba vody pro přesnější vyúčtování, optimalizace provozních nákladů a zlepšení spolehlivosti dodávek vody.
Vzdálený sběr dat přes pulzní výstup (typ S0) or M-bus připojeného měřiče.
Data jsou odesílána přes LTE Cat.NB / Cat.M celulární sítě na centrální server nebo HES (Head-end System).

Toto chytré zařízení pro měření vody má samostatný a přerušovaný provoz.
V „režimu spánku“ čte a počítá údaje o spotřebě (impulzní signály nebo data M-Bus) připojených elektroměrů a ukládá data do místní paměti. Poté se probudí v předem nakonfigurovaných intervalech a přenese uložená data pomocí MQTT or LwM2M protokol, prosté pakety TCP/IP popř JSON, XML formát. Proto lze zařízení používat s LwM2M sdělení.

Naše řešení LwM2M je kompatibilní se serverem Leshan Server nebo Leshan Bootstrap serverem nebo serverovými řešeními AV System LwM2M. Zvažte to, když budete instalovat server LwM2M pro použití WM-I3.

Důležité!
Tento popis obsahuje pouze požadovaná nastavení pro použití protokolu LwM2M na WM-I3.
Jakékoli další nastavení zařízení lze provést pomocí úplné uživatelské příručky zařízení WM-I3.
https://m2mserver.com/m2m-downloads/User_Manual_for_WM-I3_v1_70_EN.pdf

Kapitola 2. Konfigurace modemu

2.1 Konfigurace zařízení pomocí softwaru WM-E Term®
#Krok 1. Na vašem počítači musí být nainstalován Microsoft ®.Net Framework v4. V případě, že tato součást chybí, musíte si ji stáhnout a nainstalovat od výrobce  webmísto: https://www.microsoft.com/en-us/download/details.aspx?id=30653

#Krok 2. Stáhněte si konfigurační software WM-E Term (kompatibilní s Microsoft Windows® 7/8/10) tímto URL:
https://m2mserver.com/m2m-downloads/WM-ETerm_v1_3_71.zip
(Musíte vlastnit administrátorská práva pro adresář, kde program používáte.)
#Krok 3. Rozbalte stažený .ZIP file do adresáře a poté spusťte konfigurační software pomocí WM-ETerm.exe file.

#Krok 4. Spustí se konfigurační software. Zatlačte na Přihlášení tlačítko (nechat Uživatelské jméno a Heslo pole tak, jak jsou vyplněna).

#Krok 5. Poté vyberte Vybrat tlačítko na WM-I3 zařízení.
2.2 Nastavení připojení zařízení – Vzdálená konfigurace pomocí protokolu LwM2M
Důležité! Upozorňujeme, že server LwM2M (Leshan Server nebo Leshan Bootstrap server nebo serverové řešení LwM2M společnosti AV System) musí být již nainstalován a spuštěn a server musí být připojen k síti, protože WM-I3 se během připojení pokusí připojit k serveru LwM2M. konfigurace!

1. Vyberte Typ připojení na levé straně obrazovky a poté vyberte LwM2M tab.
2. Přidat a Nové připojení jméno pro profíkafile pak zatlačte Vytvořit tlačítko.
3. Poté se zobrazí další okno s nastavením připojení.
4. Přidejte IP adresa serveru LwM2M, který jste již nainstalovali. Pro adresu lze místo IP adresy použít také jméno serveru.
5. Přidejte také číslo portu LwM2M server zde.
6. Přidejte název koncového bodu WM-I3 zařízení, které jste již nakonfigurovali na LwM2M straně serveru. The LwM2M server bude komunikovat prostřednictvím tohoto názvu koncového bodu.
   Tento název koncového bodu lze také vyžádat a uvést na serveru, pokud je zařízení již zaregistrováno na serveru Leshan.
7. Můžete povolit Použít proxy správce pokud chcete, zaškrtněte políčko.
   Jedná se o unikátní Windows službu a program, který dokáže zapnout a spustit server Leshan. Je vhodné jej používat a komunikovat přes něj jako proxy.
   Všimněte si, že pokud to chcete použít, musíte přidat adresu LeshanSupervisor a jeho číslo portu a software WM-E Term bude komunikovat prostřednictvím tohoto proxy se serverem Leshan a s koncovými body lwm2m (zařízení WM-I3) .
8. Můžete vybrat Koncový bod z hodnoty serveru nebo ji nechat zapnutou — ZADEJTE RUČNĚ —jak je výchozí.
9. Klikněte na Uložit tlačítko pro uložení připojení profile.

2.3 Nastavení parametrů LwM2M

Důležité! Upozorňujeme, že server Leshan nebo server Leshan Bootstrap musí být již nainstalován, spuštěn a připojen k síti!

1. Stáhněte si sample konfigurace WM-I3 file: https://m2mserver.com/m2m-downloads/WM-I3_Sample_Config.zip
2. Poprvé konfigurace, Pojďme OTEVŘENO a file v Termín WM-E software.
   (Pokud jste již zařízení nakonfigurovali prostřednictvím LwM2M, můžete použít Přečtení parametru ikonu na displeji a upravit nastavení).
3. Otevřete Nastavení LwM2M skupina parametrů.
4. Zatlačte na Upravit hodnoty tlačítko.
5. Upravte nastavení a přidejte server Leshan URL (adresa serveru LwM2M).
   Definovaný server Lwm2m URL může být adresa bootstrap serveru nebo běžná adresa LwM2M serveru (s jednoduchou nebo šifrovanou komunikací). The URL  definuje způsob komunikace – např. coap:// pro obecný komunikační kanál nebo coaps:// pro zabezpečený. (V případě bezpečného, Identita a Tajný klíč musí být také definována pole (PSK).
6. Přidejte koncový bod (název zařízení WM-I3), který jste již nakonfigurovali na straně serveru Leshan. Server LwM2M bude komunikovat prostřednictvím tohoto názvu koncového bodu.
   Tento název koncového bodu lze také vyžádat a uvést na serveru, pokud je zařízení již zaregistrováno na serveru Leshan.
7. Nakonfigurujte funkci Is bootstrap, což znamená, že se zařízení připojuje k bootstrap serveru (který vytváří primární autentizaci a rozhoduje, se kterým serverem lwm2m má zařízení komunikovat).
   Po úspěšné autentizaci bootstrap odešle bootstrap server parametry připojení pro koncové zařízení (např. URL, Název koncového bodu, v případě pokusu o šifrovanou komunikaci – také parametry Identity and Secret key (PSK). Poté se zařízení bude registrovat na server – který byl získán během bootstrap procesu – s vybraným režimem připojení podle přijatých parametrů. Během registrace (přihlášení k serveru LwM2M) proběhne druhá autentizace a zařízení se objeví jako registrovaný koncový bod. K dispozici je životnost opětovné registrace (její hodnota může být max. 86400 sekund), která řídí délku platnosti životnosti registrace zařízení.
   Zde jsou dvě možné možnosti výběru:
   – Je bootstrap (povolená funkce): bootstrap, který identifikuje logující zařízení lwm2m a definuje způsob komunikace pro zařízení: říká, se kterým serverem má komunikovat – pak odešle šifrovací klíč pro komunikaci – pokud je tento server dostupné prostřednictvím šifrovaného kanálu
   – Ne bootstrap (zakázaná funkce): jednoduchý server poskytuje funkce serveru LwM2M s běžnou nebo šifrovanou komunikací Obojí lze šifrovat pomocí protokolu DTLS (TLS založený na protokolu UDP).
8. Přidejte Identita name if you wnat, který se používá pro ověřování TLS – a může být stejný jako Koncový bod jméno.
9. Můžete také přidat Tajný klíč hodnotu zde, což je předsdílený klíč (PSK) TLS v hexa formátu – např. 010203040A0B0C0D
10. Klikněte na OK tlačítko pro uložení předvoleb do termínu WM-E.

Důležité! Pamatujte, že v případě použití LwM2M je nutné zvolit protokol LwM2M u každé skupiny parametrů a nastavení.
2.4 Aktualizace firmwaru
Všimněte si, že Nástroje Jídelní lístek / Aktualizace firmwaru funkce zatím není k dispozici. Aktualizace firmwaru funguje pouze v režimu LwM2M.

1. Vyberte si Nástroje Jídelní lístek / Aktualizace firmwaru (LwM2M) položka.
   Poté se zobrazí následující okno.Pamatujte, že server LwM2M (Leshan) musí být spuštěn a připojen k síti!
2. Klikněte na Připojit a pole se změní na upravitelná.
3. The Firmware URL obsahuje odkaz pro stažení firmwaru, který zařízení používá ke stažení firmwaru.
4. The závažnost je prioritou.
5. The maximálně odložit perioda znamená zpoždění instalace firmwaru.
6. Změňte nastavení a klikněte na Nahrajte parametry tlačítko.
7. Zahajte aktualizaci firmwaru stisknutím tlačítka Spustit aktualizaci tlačítko.

2.5 Implementace Leshan LwM2M
Náš vývoj podporuje dvě řešení LwM2M. Toto řešení je založeno na serveru Leshan Lwm2m.
Další informace: https://leshan.eclipseprojects.io/#/about.
Řešení Leshan také podporuje protokol OMA Lwm2m v1.1.
Náš modul LwM2M podporuje protokol Lwm2m v1.0. Kromě toho jsme definovali vlastní objekty a několik standardních objektů.
Pokud zákazník potřebuje implementaci na straně serveru nebo poskytovatel služeb chce používat náš produkt, bude samozřejmě nutné provést systémovou integraci. Na základě požadavků tedy musíme naše řešení přizpůsobit verzi serveru Lwm2m, kterou klient používá. Jak lze očekávat, bude to vyžadovat určitý vývoj /
testování zdrojů a času.

Rozšíření Lwm2m konfiguračního softwaru WM-E Term zcela závisí na Leshanovi, protože používá své HTTP API ke komunikaci s koncovými zařízeními WM-I3.
Komunikační kanál vypadá takto:

WME-Term ← → Leshan Server ← → Zařízení WM-I3
2.6 Použití protokolu LwM2M na serveru Leshan (formát CBOR)
Demo řešení LwM2M je v současné době implementováno na WM-I3. Účelem je demonstrovat fungování serveru LwM2M-Leshan.
Pokud máte konkrétní požadavek ohledně formátu dat, kontaktujte našeho Obchodníka!
U veřejného serveru Leshan musíte vzít v úvahu následující.
Data jsou kódována ve formátu CBOR.
Některá podobná data získáte pomocí objektů při datové komunikaci zařízení (např. v našem exampPodívejme se na Objekt 19 (BinaryAppDataContainer), který je uložen v zakódovaném formátu:

9f02131a61e5739e190384010118201902bff6ff
9f02131a61e57922190384020118201902c41902c4f6ff
9f02131a61e57d6d190384010118201902d1f6ff
9f02131a61e580f1190384010118201902ecf6ff
9f02131a61e5847419038401011820190310f6ff
9f02131a61e587f819038401011820190310f6ff
9f02131a61e58efe19038401011820190310f6ff
9f02131a61e592821903840101182019031af6ff

Měli byste zkopírovat a vložit řádek do pravé části CBOR webstránku a stiskněte tlačítko se šipkou doleva v horní části pravého panelu. Pak aplikace CBOR
dekóduje obsah. Měli byste to opakovat od řádku k řádku.
aplikace CBOR webstrana: https://cbor.me

Význam hodnot:

1.  Hodnota 2 představující formát OMA-LwM2M CBOR [8bitové celé číslo]
2. ID instance / třída za časový interval [16bitové celé číslo]
3. Časamp prvního intervalu [32bitové celé číslo] představující počet sekund od 1. ledna 1970 v časovém pásmu UTC.
4. Interval ukládání dat (perioda) v sekundách [32bitové celé číslo]
5.  Počet intervalů v užitečné zátěži [16bitové celé číslo]
6. Počet hodnot k odeslání za interval (období) [8bitové celé číslo]
7. Velikost hodnoty 1 (hodnota počítaného pulsu) v bitech [8bitové celé číslo]
8. Hodnota 1 (puls počítaná hodnota) v aktuálním intervalu [x bitů]

2.7 Implementace AV systémů LwM2M
Druhé řešení bylo vytvořeno serverovým řešením LwM2M společnosti AV Systems.

Nezbytná nastavení lze provést lokálně pomocí konfiguračního softwaru WM-E Term nebo vzdáleně pomocí rozhraní Coiote Device Management softwaru AV Systems. Více informací: https://www.avsystem.com/products/coiote-iot-device-management-platform/Konfigurace uživatelského rozhraní AV Systems Coiote Device Management

Příchozí pulzní signály

Podpora

Máte-li jakékoli dotazy týkající se používání zařízení, kontaktujte nás na následujícím kontaktu:

E-mail: iotsupport@wmsystems.hu
Telefon: +36 20 3331111
Online produktovou podporu lze požadovat zde na naší webmísto: https://www.m2mserver.com/en/support/
Pro správnou identifikaci vašeho zařízení použijte štítek routeru a jeho informace, který obsahuje důležité informace pro call centrum.
Kvůli otázkám podpory je pro vyřešení vašeho problému důležitý identifikátor produktu. Když se nám pokoušíte sdělit incident, zašlete nám prosím informace IMEI a SN (sériové číslo) ze záručního štítku produktu (umístěného na přední straně krytu produktu).
Dokumentaci a verzi softwaru pro tento produkt lze získat pomocí tohoto odkazu: https://m2mserver.com/en/product/wm-i3/

 Právní upozornění

©2022. WM Systems LLC.

Obsah této dokumentace (veškeré informace, obrázky, testy, popisy, návody, loga) je chráněn autorským právem. Kopírování, používání, distribuce a publikování je povoleno pouze se souhlasem WM Systems LLC., s jasným uvedením zdroje.
Obrázky v uživatelské příručce jsou pouze ilustrační.
WM Systems LLC. nepotvrzuje ani nepřijímá odpovědnost za jakékoli chyby v informacích obsažených v uživatelské příručce.
Informace publikované v tomto dokumentu se mohou bez upozornění změnit.
Všechna data obsažená v uživatelské příručce slouží pouze pro informační účely. Pro další informace prosím kontaktujte naše kolegy.

Varování
Jakékoli chyby, ke kterým dojde během procesu aktualizace programu, mohou způsobit selhání zařízení.

WM Systems LLC 8 Villa str., Budapešť H-1222 MAĎARSKO
Telefon: +36 1 310 7075
E-mail: sales@wmsystems.hu
Web: www.wmsystems.hu
2022-07-27

Dokumenty / zdroje

	WM Systems WM-I3 LLC Inovace v systémech Smart IoT [pdfUživatelská příručka WM-I3 LLC Innovation in Smart IoT systems, WM-I3, LLC Innovation in Smart IoT systems, LLC Innovation in Smart IoT systems, Smart IoT systems, IoT systems
	WM Systems WM-I3 LLC Inovace v systémech Smart IoT [pdfUživatelská příručka WM-I3 LLC Innovation in Smart IoT systems, WM-I3, LLC Innovation in Smart IoT systems, Innovation in Smart IoT systems, Smart IoT systems, IoT systems

Reference

• Uživatelská příručka