Manuale d'usu
Modem di misurazione WM-I3®
Impostazioni LwM2M (da WM-E Term)
v1.70

WM-I3 LLC Innovazione in sistemi Smart IoT

Specificazioni di u documentu

Sta documentazione hè stata fatta per presentà i passi di cunfigurazione di u LwM2M operazione cumpatibile è cumunicazione di u WM-I3® contatore di impulsi / raccoglitore di dati MBUS è trasmettitore.

Versione di u documentu:	REV 1.70
Tipu di hardware / Versione:	Manuale d'uso Modem di misurazione WM-I3® - Impostazioni LwM2M
Versione Hardware:	V 3.1
Versione di Bootloader:	V 1.81
Versione Firmware:	V 1.9 m
Cunfigurazione WM-E Term®	V 1.3.71
versione di u software:	18
Pagine:	Finale
Status:	17-06-2021
Creatu:	27-07-2022
Ultima mudificazione:	17-06-2021

Capitulu 1. Introduzione

U WM-I3® hè u nostru contatore di segnali di impulsi cellulare di bassa putenza di 3a generazione è registratore di dati cù un modem cellulare integratu per a misurazione intelligente di acqua è gas. Letture automatizzate di u misuratore d'acqua cù guasti persunalizabili, rilevazione di fughe è prevenzione. Rilevazione di perdite d'acqua per evità l'inundazioni, acqua senza entrate per una fatturazione più precisa, ottimisazione di i costi operativi, è migliurà a affidabilità di l'approvvigionamentu d'acqua.
Raccolta di dati remoti via uscita impulsu (tipu S0) or M-bus di u metru cunnessu.
I dati sò mandati attraversu LTE Cat.NB / Cat.M rete cellulari à un servitore centrale o HES (Head-end System).

Stu dispusitivu intelligente di misurazione di l'acqua hà un funziunamentu standalone è intermittenti.
Leghje è cunta i dati di cunsumu (signali di impulsi o dati M-Bus) di i metri cunnessi in "modu sonnu" è salva i dati in u almacenamiento locale. Allora si sveglia à intervalli pre-configurati per trasmette i dati almacenati utilizendu MQTT or LwM2M protokollu, pacchetti TCP/IP semplici o JSON, XML furmatu. Per quessa, u dispusitivu pò ièssiri usatu cu LwM2M cumunicazione.

A nostra soluzione LwM2M hè cumpatibile cù u servitore Leshan Server o Leshan Bootstrap o e soluzioni di u servitore LwM2M di u Sistema AV. Per piacè cunsiderà questu, quandu installate u servitore LwM2M per l'usu WM-I3.

Impurtante!
Questa descrizzione cuntene solu i paràmetri necessarii per l'usu di u protocolu LwM2M in u WM-I3.
Ogni più paràmetri di u dispusitivu pò esse fattu usendu u Manuale d'Usuariu cumpletu di u dispusitivu WM-I3.
https://m2mserver.com/m2m-downloads/User_Manual_for_WM-I3_v1_70_EN.pdf

Capitulu 2. Configurazione Modem

2.1 Configurazione di u dispusitivu cù u software WM-E Term®
#Step 1. Microsoft ®.Net Framework v4 deve esse stallatu in u vostru urdinatore. In casu di mancassi stu cumpunente, avete da scaricà è stallà da u fabricatore  websitu: https://www.microsoft.com/en-us/download/details.aspx?id=30653

#Step 2. Scaricate u software di cunfigurazione WM-E Term (compatibile Microsoft Windows® 7/8/10) da questu URL:
https://m2mserver.com/m2m-downloads/WM-ETerm_v1_3_71.zip
(Avete pussede privilegi di amministratore per u repertoriu induve site cù u prugramma.)
#Step 3. Unpack u .ZIP telecaricatu file in un repertoriu, poi inizià u software di cunfigurazione da u WM-ETerm.exe file.

#Step 4. U software di cunfigurazione serà cuminciatu. Spingi à u Login buttone (lasciate u Nome d'utilizatore è Codice campi cum'è sò pieni).

#Step 5. Allora sceglite u Selezziunà buttone à u WM-I3 dispusitivu.
2.2 Configurate a cunnessione di u dispusitivu - Configurazione remota via u protocolu LwM2M
Impurtante! Nota chì u servitore LwM2M (Leshan Server o Leshan Bootstrap server o a soluzione di u servitore LwM2M di AV System) deve esse digià stallatu è in esecuzione è u servitore deve esse cunnessu à a reta, perchè u WM-I3 pruverà à cunnette à u servitore LwM2M durante a cunnessione. cunfigurazione!

1. Sceglie u Tipu di cunnessione nant'à u latu manca di u screnu, poi sceglie u LwM2M tab.
2. Aghjunghjite a Nova cunnessione nome per i prufessiunalifile poi spinghje u Crià buttone.
3. Allora apparissi a finestra dopu cù i paràmetri di cunnessione.
4. Aghjunghjite u indirizzu IP di u servitore LwM2M chì avete digià stallatu. Per u nome di u servitore di l'indirizzu pò ancu esse usatu invece di l'indirizzu IP.
5. Aghjunghjite puru u numeru Port di u LwM2M servitore quì.
6. Aghjunghjite u nome Endpoint di u WM-I3 dispusitivu chì avete digià cunfiguratu à u LwM2M latu servitore. U LwM2M u servitore cumunicà per mezu di stu nome endpoint.
   Stu nomu Endpoint pò ancu esse dumandatu è listatu da u servitore se u dispusitivu hè digià registratu in u servitore Leshan.
7. Pudete attivà u Utilizà u proxy Supervisor se vulete, da a casella di spunta.
   Questu hè un serviziu è prugramma Windows unicu, chì pò accende è principià u servitore Leshan. Hè adattatu per aduprà è cumunicà attraversu questu cum'è proxy.
   Nota, chì sè vo vulete usà questu, avete da aghjunghje l'indirizzu di u LeshanSupervisor è u so numeru di portu, è u software WM-E Term hà da cumunicà attraversu stu proxy cù u servitore Leshan, è cù l'endpoints lwm2m (dispositivi WM-I3) .
8. Pudete selezziunate Endpoint da u valore di u servitore o lascià - INPUT MANUALMENTE -cum'è predefinitu.
9. Cliccate nant'à u Salvà buttone per salvà a cunnessione profile.

2.3 paràmetri LwM2M

Impurtante! Nota chì u servitore Leshan o Leshan Bootstrap deve esse digià stallatu, eseguitu è ​​cunnessu à a reta!

1. Scaricate u sampa cunfigurazione WM-I3 file: https://m2mserver.com/m2m-downloads/WM-I3_Sample_Config.zip
2. Per a prima volta cunfigurazione, andemu Apertu lu file in u Terminu WM-E software.
   (Se avete digià cunfiguratu u dispusitivu attraversu LwM2M, pudete aduprà u Lettura di paràmetru icona a lettura è per mudificà i paràmetri).
3. Aprite u paràmetri LwM2M gruppu di paràmetri.
4. Spingi à u Edite i valori buttone.
5. Mudificà i paràmetri è aghjunghje u servitore Leshan URL (indirizzu di u servitore LwM2M).
   U servitore Lwm2m definitu URL pò esse l'indirizzu di u servitore bootstrap o l'indirizzu di u servitore LwM2M ordinariu (cù una cumunicazione simplice o criptata). U URL  definisce u modu di cumunicazione - per esempiu, coap:// per u canali di cumunicazione generale o coaps:// per quellu assicuratu. (In casu di sicuru, u Identità è Chjave secreta (PSK) deve esse definitu ancu).
6. Aghjunghjite l'Endpoint (nome di u dispositivu WM-I3), chì avete digià cunfiguratu à u latu di u servitore Leshan. U servitore LwM2M cumunicà per mezu di stu nome di endpoint.
   Stu nomu Endpoint pò ancu esse dumandatu è listatu da u servitore se u dispusitivu hè digià registratu in u servitore Leshan.
7. Configurate a funzione Is bootstrap, chì significa chì u dispositivu hè cunnessu à u servitore bootstrap (chì crea una autentificazione primaria è decide cù quale servitore lwm2m deve cumunicà cù u dispusitivu).
   Dopu l'autentificazione di bootstrap successu, u servitore di bootstrap manda i paràmetri di cunnessione per u dispositivu endpoint (cum'è u servitore URL, Endpoint name, in casu di un tentativu di cumunicazione criptata - i paràmetri Identità è chjave secreta (PSK) ancu. Allora u dispusitivu hà da esse registratu à u servitore - chì era ghjuntu durante u prucessu di bootstrap - cù u modu di cunnessione sceltu da i paràmetri ricevuti. Durante a registrazione (login à u servitore LwM2M) una seconda autentificazione hè fatta, è u dispusitivu appariscerà cum'è un endpoint registratu. Ci hè una vita di re-registrazione (u so valore pò esse max. 86400 seconde), chì cuntrolla a durata di validità di a durata di a registrazione di u dispusitivu.
   E duie opzioni di selezzione pussibuli quì:
   – Hè bootstrap (funzione attivata): u bootstrap chì identifica l'apparecchi lwm2m di logging, è definisce u modu di cumunicazione per i dispositi: dice, chì u servitore deve esse cumunicatu cù - poi manda a chjave di criptografia per a cumunicazione - se stu servitore hè dispunibule attraversu un canale criptatu
   – Ùn bootstrap (funzione disattivata): un servitore simplice furnisce funzioni di u servitore LwM2M cù una cumunicazione ordinaria o criptata Tutti dui ponu esse criptati via u protocolu DTLS (protokollu UDP basatu TLS).
8. Aghjunghjite u Identità nome se vulete, chì hè utilizatu per l'autentificazione TLS - è pò esse u listessu cum'è u Endpoint nomu.
9. Pudete ancu aghjunghje Chjave secreta valore quì, chì hè a Chjave Pre-Shared (PSK) di u TLS in formatu hexa - per esempiu 010203040A0B0C0D
10. Cliccate nant'à u OK buttone per salvà i presets à u Terminu WM-E.

Impurtante! Nota chì in casu di usu di u LwM2M, avete bisognu di sceglie u protocolu LwM2M in ogni gruppu di paràmetri è paràmetri.
2.4 Actualizazione di u firmware
Nota chì u Strumenti menu / Actualizazione di u firmware a funzione ùn hè ancu dispunibule. L'aghjurnamentu di u firmware funziona solu in u modu LwM2M.

1. Sceglie u Strumenti menu / Actualizazione di u firmware (LwM2M) articulu.
   Allora apparirà a finestra seguente.Nota, chì u servitore LwM2M (Leshan) deve esse eseguitu è ​​cunnessu à a reta!
2. Cliccate nant'à u Cunnette buttone è i campi seranu cambiati in editable.
3. U Firmware URL cuntene u ligame di scaricamentu di u firmware, chì hè utilizatu da u dispusitivu per scaricà u firmware.
4. U gravità hè a priorità.
5. U rinviatu massimu periodu significa u ritardu di a stallazione di firmware.
6. Cambia i paràmetri è cliccate nant'à u Caricate i paràmetri buttone.
7. Cumincià l'aghjurnamentu di u firmware spinghjendu u buttone Cumincià l'aghjurnamentu buttone.

2.5 Implementazione Leshan LwM2M
U nostru sviluppu sustene duie soluzioni LwM2M. Questa suluzione basatu annantu à u servitore Leshan Lwm2m.
Più infurmazione: https://leshan.eclipseprojects.io/#/about.
A suluzione di Leshan sustene ancu u protocolu OMA Lwm2m v1.1.
U nostru modulu LwM2M sustene u protocolu Lwm2m v1.0. Inoltre, avemu definitu i nostri ogetti è parechji ogetti standard.
Se u Cliente hà bisognu di una implementazione di u servitore o un fornitore di serviziu vole usà u nostru pruduttu, di sicuru una integrazione di u sistema serà necessaria per fà. Allora, basatu annantu à i bisogni, avemu da adattà a nostra suluzione à a versione di u servitore Lwm2m chì hè utilizatu da u Cliente. Comu si pò esse previstu, questu richiederà qualchì sviluppu /
risorsi di prova è tempu.

L'espansione Lwm2m di u software di cunfigurazione WM-E Term dipende interamente da Leshan, perchè utilizendu a so API HTTP per cumunicà cù i dispositi endpoint WM-I3.
U canali di cumunicazione s'assumiglia à:

WME-Term ← → Leshan Server ← → Dispositivu WM-I3
2.6 Utilizà u protocolu LwM2M nantu à u servitore Leshan (formatu CBOR)
Una soluzione demo LwM2M hè attualmente implementata nantu à u WM-I3. U scopu di questu hè di dimustrà u funziunamentu di u servitore LwM2M-Leshan.
Sè avete una dumanda specifica in quantu à u furmatu di dati, cuntattate u nostru Merchant!
Per un servitore public Leshan avete da cunsiderà i seguenti.
I dati sò codificati in u furmatu CBOR.
Truverete qualchi dati simili cù l'uggetti durante a cumunicazione di dati di u dispusitivu (per esempiu in u nostru exampvedemu l'Oggettu 19 (BinaryAppDataContainer) chì hè guardatu in forma codificata:

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

Duvete copià è incollà una linea à a parte dritta di u CBOR webschermu pagina, è appughjà u buttone freccia manca nant'à u cima di u panel dritta. Allora l'applicazione CBOR
decodificà u cuntenutu. Duvete ripete questu da linea à linea.
Applicazione CBOR webpagina: https://cbor.me

U significatu di i valori:

1.  Valore 2 chì rapprisenta u furmatu OMA-LwM2M CBOR [interu à 8 bit]
2. ID di istanza / Classe per intervallu di tempu [interu à 16 bit]
3. Timestamp di u primu intervallu [32-bit integer] chì rapprisenta u numeru di seconde da u 1 di ghjennaghju di u 1970 in u fusu orariu UTC.
4. Intervallu di almacenamiento di dati (periodu) in seconde [interu à 32 bit]
5.  Numero di intervalli in Payload [interu à 16 bit]
6. Numero di valori da mandà per intervallu (periodu) [interu à 8 bit]
7. Dimensione di u valore 1 (valore cuntatu di impulsi) in bits [interu à 8 bit]
8. Valore 1 (valore cuntatu impulsu) in l'intervallu attuale [x bits]

2.7 Implementazione di Sistemi AV LwM2M
L'altra suluzione hè stata fatta da a soluzione di u servitore LwM2M di AV Systems.

I paràmetri necessarii ponu esse fatti in u locu da u software di cunfigurazione WM-E Term o remotamente cù l'interfaccia di Gestione di Dispositivi Coiote di u software AV Systems. Più infurmazione: https://www.avsystem.com/products/coiote-iot-device-management-platform/Interfaccia d'utilizatore di cunfigurazione di AV Systems Coiote Device Management

Segnali di impulsi entranti

Supportu

Sè avete qualchì quistione nantu à l'usu di u dispusitivu, cuntattateci à u cuntattu seguente:

E-mail: iotsupport@wmsystems.hu
Telefono: +36 20 3331111
U supportu di u produttu in linea pò esse dumandatu quì à u nostru websitu: https://www.m2mserver.com/en/support/
Per l'identificazione curretta di u vostru dispositivu, aduprate u router sticker è a so infurmazione, chì cuntene infurmazione impurtante per u call center.
A causa di e dumande di supportu, l'identificatore di u produttu hè impurtante per risolve u vostru prublema. Per piacè, quandu site tentativu di cuntà un incidente, mandateci l'infurmazioni IMEI è SN (numeru di serie) da u sticker di garanzia di u produttu (situatu nantu à a faccia frontale di l'alloghju di u produttu).
A documentazione è a liberazione di u software per stu pruduttu pò esse accessu da stu ligame: https://m2mserver.com/en/product/wm-i3/

 Avvisu legale

© 2022. WM Systems LLC.

U cuntenutu di sta ducumentazione (tutte l'infurmazioni, stampe, testi, descrizioni, guide, loghi) hè sottu a prutezzione di copyright. A copia, l'usu, a distribuzione è a publicazione sò permesse solu cù l'accunsentu di WM Systems LLC., cù l'indicazione chjara di a fonte.
L'imaghjini in a guida d'utilizatore sò solu per scopi illustrativi.
WM Systems LLC. ùn cunfirma micca o accettà rispunsabilità per ogni sbagliu in l'infurmazioni cuntenute in a guida d'utilizatore.
L'infurmazioni publicate in stu documentu sò sottumessi à cambià senza avvisu.
Tutti i dati cuntenuti in a guida d'utilizatore sò solu per scopi d'infurmazione. Per più infurmazione, per piacè cuntattate i nostri culleghi.

Attenti
Ogni errore chì si verifica durante u prucessu di aghjurnamentu di u prugramma pò esse un fallimentu di u dispusitivu.

WM Systems LLC 8 Villa str., Budapest H-1222 UNGHERIA
Telefono: +36 1 310 7075
E-mail: sales@wmsystems.hu
Web: www.wmsystems.hu
2022-07-27

Documenti / Risorse

	WM Systems WM-I3 LLC Innovazione in sistemi Smart IoT [pdfManuale d'usu WM-I3 LLC Innovazione in sistemi Smart IoT, WM-I3, LLC Innovazione in sistemi Smart IoT, LLC Innovazione in sistemi Smart IoT, sistemi Smart IoT, sistemi IoT
	WM Systems WM-I3 LLC Innovazione in sistemi Smart IoT [pdfGuida di l'utente WM-I3 LLC Innovazione in sistemi Smart IoT, WM-I3, LLC Innovazione in sistemi Smart IoT, Innovazione in sistemi Smart IoT, sistemi Smart IoT, sistemi IoT

Referenze

• Manuale d'usu