WM SYSTEMS WM-I3 měřicí modem

Specifikace dokumentu

Tato dokumentace byla vytvořena za účelem prezentace konfiguračních kroků provozu kompatibilního s LwM2M a komunikace čítače pulsů / sběrače dat MBUS a vysílače WM-I3®.

Verze dokumentu:	REV 1.80
Železářské zboží Typ/verze:	Uživatelská příručka WM-I3® měřicí modem – nastavení LwM2M
Železářské zboží Verze:	V 3.1
Bootloader Verze:	V 1.81
Verze firmwaru:	V 1.10g
Termín WM-E® konfigurace verze softwaru:	V 1.3.78
Stránky:	18
Postavení:	Finále
Vytvořeno:	01-02-2023
Naposledy změněno:	01-02-2023

Zavedení

WM-I3® je naše 3. generace nízkoenergetického celulárního pulsního počítadla a záznamníku dat 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.
Dálkový sběr dat přes pulzní výstup (typ S0) nebo M-bus připojeného elektroměru. Data jsou odesílána prostřednictvím mobilních sítí LTE Cat.NB / Cat.M 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 probouzí v předem nakonfigurovaných intervalech a přenáší uložená data pomocí protokolu MQTT nebo LwM2M, prostých paketů TCP/IP nebo formátu JSON, XML. Proto lze zařízení používat s komunikací LwM2M.

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_80_EN.pdf

Konfigurace modemu

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_78.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. Stiskněte tlačítko Přihlásit (pole Uživatelské jméno a Heslo ponechte tak, jak jsou vyplněna).

#Krok 5. Poté zvolte tlačítko Vybrat na zařízení WM-I3.

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 od 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 kartu LwM2M.
2. Přidejte nový název připojení pro profesionálafile poté stiskněte tlačítko Vytvořit.
3. Poté se zobrazí další okno s nastavením připojení.
4. Přidejte IP adresu serveru LwM2M, který jste již nainstalovali. Jako adresu lze místo IP adresy použít také jméno serveru.
5. Zde také přidejte číslo portu serveru LwM2M.
6. Přidejte název koncového bodu zařízení WM-I3, které jste již nakonfigurovali na straně serveru LwM2M. 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. Pokud chcete, můžete zaškrtnutím políčka povolit použití proxy správce.
   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.
   Poznámka, ž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 — INPUT MANUALLY — jako výchozí.
9. Kliknutím na tlačítko Uložit uložíte připojení profile.

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. Při první konfiguraci otevřeme soubor file v softwaru WM-E Term.
   (Pokud jste již zařízení nakonfigurovali prostřednictvím LwM2M, můžete použít čtení parametrů ikonu na displeji a upravit nastavení).
3. Otevřete skupinu parametrů nastavení LwM2M.
4. Stiskněte tlačítko Upravit hodnoty.
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ě zabezpečení musí být definována také pole Identity and Secret key (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í ověření 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 protokolující zařízení lwm2m a definuje způsob komunikace pro zařízení: říká, se kterým serverem by se mělo komunikovat – pak odešle šifrovací klíč pro komunikaci – pokud ano server je dostupný prostřednictvím šifrovaného kanálu
   • Není 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. Pokud chcete, přidejte název identity, který se používá pro ověřování TLS – a může být stejný jako název koncového bodu.
9. Zde můžete také přidat hodnotu Secret Key, což je předsdílený klíč (PSK) TLS v hexa formátu – např. 010203040A0B0C0D
10. Kliknutím na tlačítko OK uložíte předvolby 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í.

Aktualizace firmwaru
Poznámka že nabídka Nástroje / funkce aktualizace firmwaru zatím není k dispozici. Aktualizace firmwaru funguje pouze v režimu LwM2M.

1. Zvolte menu Nástroje / Aktualizace firmwaru (LwM2M).
   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 tlačítko Připojit a pole se změní na upravitelná.
3. Firmware URL obsahuje odkaz pro stažení firmwaru, který zařízení používá ke stažení firmwaru.
4. Prioritou je závažnost.
5. Maximální doba odložení znamená zpoždění instalace firmwaru.
6. Změňte nastavení a klikněte na tlačítko Nahrát parametry.
7. Zahajte aktualizaci firmwaru stisknutím tlačítka Spustit aktualizaci.

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ývojové / testovací zdroje a čas.
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 → WM-I3 zařízení

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. Poté 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á pulzem) v bitech [8bitové celé číslo]
8. Hodnota 1 (hodnota počítaného pulzu) v aktuálním intervalu [x bitů]

Implementace AV Systems 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í

©2023. 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

Dokumenty / zdroje

WM SYSTEMS WM-I3 měřicí modem [pdfUživatelská příručka WM-I3 měřicí modem, WM-I3, měřicí modem, modem

Reference

• Uživatelská příručka