Modbus à MQTT
Advantech Czech sro, Sokolska 71, 562 04 Usti nad Orlici, Czech Republic
Document n° APP-0087-EN, révision du 12 octobre 2023.
Modbus To MQTT Router App
© 2023 Advantech Czech sro Nisuna parte di sta publicazione pò esse riprodotta o trasmessa in ogni forma o per qualsiasi mezzu, elettronicu o meccanicu, cumpresa a fotografia, a registrazione, o qualsiasi sistema di almacenamentu è ricuperazione di l'infurmazioni senza accunsentu scrittu. L'infurmazioni in stu manuale sò sottumessi à cambià senza avvisu, è ùn rapprisentanu micca un impegnu da parte di Advantech.
Advantech Czech sro ùn hè micca rispunsevule per danni incidentali o cunsequenziali risultanti da a furnizzioni, a prestazione o l'usu di stu manuale.
Tutti i nomi di marca utilizati in stu manuale sò marchi registrati di i so rispettivi pruprietarii. L'usu di marchi o altre designazioni in questa publicazione hè solu per scopi di riferimentu è ùn custituisce micca un appruvamentu da u titulare di a marca.
Simbuli usati
 |
Periculu - Informazione riguardanti a sicurità di l'utilizatori o danni potenziali à u router. |
 |
Attenzione - Problemi chì ponu esse in situazioni specifiche. |
 |
Informazione - Cunsiglii utili o informazioni d'interessu speciale. |
 |
Example - Esample di funzione, cumandamentu o script. |
Changelog
- Modbus à MQTT Changelog
v2.0.5
• Cambia openssl (1.0.2u) à biblioteca statica.
v2.0.6
• Aghjunghjite l'opzione di generazione Azure SAS-token.
• Necessità di stallà u modulu d'utilizatore Python3.
• Add Data Type: Double World - Frame.
• Aghjunghjite u campu "Byte Swap" in csv file.
• Add suppurtatu tipu Dati "String".
• Add "Word Swap" è "Byte Swap" per String Data Type.
v2.0.7
• Add mostra codice errore mosquitto è missaghju errore in a funzione cunnessi / disconnected.
v2.0.8
• Aghjunghjite l'upload di u certificatu lucali è e funzioni chjave lucali per AWS.
v2.0.9
• Cambia cumandante modbus massimu da 100 à 500.
v2.0.10
• Add polling i prucessi di u modulu di l'utilizatori per ogni 5 seconde, se u modulu di l'utilizatore crashed, si currerà di novu.
v2.0.11
• Aghjunghjite u campu "Custom2 Field" in csv file.
• Aghjunghjite u campu "Send Group" in csv file, per a funzione di u gruppu di mandà MQTT.
• Aghjunghjite u campu "Invia intervallu" in csv file, per a funzione di u gruppu di mandà MQTT.
v2.0.12
• Add Azure SAS-token generation (senza modulu d'utilizatore Python3). Quandu u modulu d'utilizatore Python3 installatu, utilizerà a generazione di SAS-token da python.
v2.0.13
• Added capacità à edità CSV, certificatu CA, certificatu Local è Chjave Privata Local da WebUI.
v2.0.14
• Prublemu risoltu quandu l'App Router mb2mqtt carica a cunfigurazione predeterminata dopu l'aghjurnamentu di u Firmware.
v2.0.15
• Fixed un prublema cù a visualizazione di i valori di u spaziu in a pagina Mapping Table.
• Fixed un prublemu induve u vechju valore hè statu affissatu in a pagina Mapping Table quandu u valore di cunfigurazione era viotu. v2.0.16
• Per WADMP: Fixed the issue that the default value has whitespaces.
v2.0.17
• Per sustene Integer cù 2 bytes size (Example: cunvertisce 0xFFFF à -1).
• Set permissions à 755 per tutti files in u Modulu User.
v2.0.18
• Fixed un prublema cù a cunversione integer-to-float.
• Add più missaghju log per valore MQTT.
v2.0.19
• Aumentà i campi persunalizati à 10 (campi di cunfigurazione CSV: Q, R, U AB)
v2.0.20
Fixed un prublema induve i cumenti di cunfigurazione causavanu prublemi in u sistema di gestione WADMP.
Descrizzione di u modulu
Questa app Router ùn hè micca contenuta in u firmware standard di u router. A carica di sta app router hè descritta in u Manuale di cunfigurazione (vede Capitulu Documenti Relativi).
L'app router hè compatibile cù a piattaforma di router v2.
Modbus à MQTT hè una app di router per furnisce una cumunicazione perfetta trà i dispositi Modbus / TCP è u dispositivu MQTT. Modbus à MQTT funziona cum'è u maestru Modbus / TCP per cumunicà cù i dispositi Modbus / TCP, è travaglia cum'è editore / abbonatu MQTT per cumunicà cù u broker MQTT.
Web Interfaccia
Una volta chì a stallazione di u modulu hè cumpleta, a GUI di u modulu pò esse invucata clicchendu u nome di u modulu nantu à a pagina di Apps Router di u router. web interfaccia.
A parte manca di sta GUI cuntene menu cù a sezione di menu Router. Ritorna à a sezione di menu Router torna da u modulu web pagina à u router web pagine di cunfigurazione. U menu principale di a GUI di u modulu hè mostratu in Figura 1.
- Router
1.1 Impostazioni
A cunfigurazione di sta app router pò esse fatta in a pagina Settings, sottu Router menu section. Tutti l'articuli di cunfigurazione per a pagina di cunfigurazione di Settings sò descritti in a tabella sottu.
Articulu Descrizzione Abilitazione di serviziu Abilitatu, a funziunalità Modbus à MQTT APN di u modulu hè attivata. Log Habilita l'APN Habilita u Logu di serviziu. Indirizzu di u broker Inserite l'indirizzu remoto di u Broker Server. Broker Server Port Inserite u Broker Server Port Number (1-65535). MQTT Keepalive Inserite l'intervallu MQTT keepalive (1-3600). MQTT QoS Inserite u valore MQTT QoS (0,1,2). MQTT mantene Habilita per a conservazione di u messagiu. ID cliente Inserite l'ID Cliente. MQTT anonimu Habilita MQTT Anonymous Nome d'utilizatore MQTT Inserite u nome d'utilizatore MQTT. Password MQTT Inserite Password MQTT. MQTT TLS Habilita MQTT TLS. intervallu (ms) Inserite l'Intervallu di polling Modbus TCP. Timeout (ms) Inserite Modbus TCP Timeout. CSV Config Caricate u file cuntene a vostra cunfigurazione CSV quì. Certificatu CA Caricate u vostru Certificatu CA quì. Certificatu Locale Caricate u vostru Certificatu Locale quì. Chjave Privata Locale Caricate a vostra Chjave Privata Locale quì. Table 1: Settings Example Articuli Description
1.2 Config file
In Modbus à MQTT, l'utente configura a mappatura trà Modbus/TCP è MQTT attraversu CSV file. In u csv file, u separatore di campu (delimitatore) hè una virgola.
Articulu Descrizzione Sugettu tema MQTT Nome U nome per identificà a mappa. IP L'indirizzu IP di u dispositivu Modbus. Portu U numeru di portu TCP di u dispositivu slave Modbus remoto. ID di u dispusitivu L'ID slave Modbus/TCP. Codice di Funzione Codice di funzione Modbus (FC). In Modbus à MQTT, i codici di funzione supportati sò: 1, 2, 3, 4, 5, 6, 15, 16
01: Leghjite bobine;
02: Leghjite inputs discreti;
03: Leghjite i registri di tene;
04: Leghjite u registru di input;
05: Scrivite una sola bobina;
06: Scrive un registru unicu;
15: Scrivite parechje bobine;
16: Scrivite parechji registri.Indirizzu Designate a lettura da / scrive à l'indirizzu iniziale per u registru Modbus. Lunghezza di dati Quandu FC = 1, 2, 5 o 15, l'unità hè bit(s)
Quandu FC = 3, 4, 6 o 16, l'unità hè a parolla (s)Modbus Tipu di dati Tipu di dati Modbus.
Opzioni: Boolean, Integer, Unsigned Integer, FloatScambiu di dati U campu di Data Swap determina l'ordine in quale i byte particulari di e dati ricevuti / trasmessi sò mandati.
Nisunu: Ùn scambià micca; Parola: 0x01, 0x02 diventa 0x02, 0x01;
Parola doppia: 0x01, 0x02, 0x03, 0x04 diventa 0x04, 0x03, 0x02, 0x01.
Double Word - Frame: 0x01, 0x02, 0x03, 0x04 diventa 0x04, 0x03, 0x02, 0x01.
Quad Word: 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07980 diventa 0x07980, 0x05, 0x06, 0x03, 0x04, 0x01, 0x02.Swap di byte Opzione: True, False
Quandu l'opzione hè True: 0x01, 0x02 diventa 0x01, 0x02.
0x01, 0x02, 0x03, 0x04 diventa 0x01, 0x02, 0x03, 0x04.Tipu di dati MQTT tipu di dati MQTT.
Opzioni: Boolean, Integer, Unsigned Integer, Float, Long Integer, UnsignedMultiplicatore U valore utilizatu per multiplicà u valore di dati. Offset U valore utilizatu per aghjunghje / sottrae u valore di dati. Intervallu di polling (ms) Intervallu di polling Modbus, unità: millisecondi.
A gamma di valori: 1 10000000Mandate Quandu Cambia Selezziunate chì i dati sò mandati immediatamente quandu u cambiamentu succede in modbus slave.
Opzioni: Sì, NoCampu persunalizatu Valore di definizione persunalizata Custom2 Field Valore di definizione persunalizata Mandate u gruppu Stabilite u numeru di gruppu per MQTT parechji missaghji à un missaghju.
U valore hè da 0 à 500. Quandu u valore hè 0, sta funzione hè disattivata.Mandà Interval Mandate l'intervallu di messagiu MQTT per u gruppu in seconde. A gamma di valori hè da 1 à 10000 seconde. Tabella 2: Descrizzione di l'articuli di cunfigurazione
U CSV file pò esse impurtatu in u router Advantech in l'Configurazione di l'app router WEB pagina. Dopu à impurtà CSV file è cliccate nant'à u buttone "Salvà", a nova cunfigurazione mapping hà da esse effettu subitu.
1.3 Tavola di mappatura
A mappatura Modbus/TCP à MQTT serà mostrata in a Tabella di Mapping WEB pagina.
Format di dati 1.4MQTT
Quandu Modbus / TCP FC hè 1, 2, 3 o 4, Modbus à MQTT hà da travaglià cum'è editore MQTT per postà dati Modbus / TCP in formatu JSON à u broker MQTT. Quandu Modbus/TCP FC hè 5, 6, 15 o 16, Modbus à MQTT hà da travaglià cum'è abbonatu MQTT per dumandà l'infurmazioni di abbunamentu, è trasmette i dati à u dispositivu Modbus/TCP.
Eccu l'example di dati MQTT chì hè publicatu da Modbus à MQTT.
Innota chì Modbus à MQTT verifica solu i campi di tema, nome è valore di l'infurmazioni di abbunamentu ricevuti.
Pudete ottene documenti in relazione à u produttu nantu à u Portal di Ingegneria à icr.advantech.cz indirizzu.
Per uttene a Guida Rapida di Avviamentu di u vostru router, Manuale d'Usuariu, Manuale di Cunfigurazione, o Firmware andate à u Modelli di Router pagina, truvate u mudellu necessariu, è passà à a tabulazione Manuali o Firmware, rispettivamente.
I pacchetti di stallazione Router Apps è manuali sò dispunibuli nant'à u Apps Router pagina.
Per i Documenti di Sviluppu, andate à u DevZone pagina.
Manuale di Modbus à MQTT
Documenti / Risorse
 |
ADVANTECH Modbus To MQTT Router App [pdfGuida di l'utente Modbus To MQTT Router App, Modbus, To MQTT Router App, MQTT Router App, App Router |
