Modbus al MQTT

Advantech Czech sro, Sokolska 71, 562 04 Usti nad Orlici, Ĉeĥio
Dokumento n-ro APP-0087-EN, revizio de la 12-a de oktobro 2023.

Modbus Al MQTT Enkursigilo Apo

© 2023 Advantech Czech sro Neniu parto de ĉi tiu eldonaĵo povas esti reproduktita aŭ transdonita en ajna formo aŭ per iu ajn rimedo, elektronika aŭ mekanika, inkluzive de fotado, registrado aŭ ajna informstokado kaj retrovosistemo sen skriba konsento. Informoj en ĉi tiu manlibro povas ŝanĝiĝi sen avizo, kaj ĝi ne reprezentas devontigon de Advantech.
Advantech Czech sro ne respondecas pri hazardaj aŭ konsekvencaj damaĝoj rezultantaj de la liverado, agado aŭ uzo de ĉi tiu manlibro.
Ĉiuj markonomoj uzataj en ĉi tiu manlibro estas la registritaj varmarkoj de siaj respektivaj posedantoj. La uzo de varmarkoj aŭ aliaj nomoj en ĉi tiu publikigado estas nur por referencaj celoj kaj ne konsistigas subtenon de la posedanto de la varmarko.

Uzitaj simboloj

	Danĝero - Informoj pri uzantsekureco aŭ ebla damaĝo al la enkursigilo.
	Atentu - Problemoj kiuj povas aperi en specifaj situacioj.
	Informoj - Utilaj konsiletoj aŭ informoj de speciala intereso.
	Example – Ekzample de funkcio, komando aŭ skripto.

Ŝanĝprotokolo

1. Modbus al MQTT Changelog
   v2.0.5
   • Ŝanĝu openssl (1.0.2u) al statika biblioteko.
   v2.0.6
   • Aldoni opcion de Azure SAS-token-generacio.
   • Necesas instali Python3 uzantan modulon.
   • Aldonu Tipon de Datumoj: Duobla Mondo - Kadro.
   • Aldonu kampon "Byte Swap" en csv file.
   • Aldoni subtenataj Datumoj tipo "String".
   • Aldonu "Vortŝanĝo" kaj "Byte Swap" por Ŝnuro-Datumtipo.
   v2.0.7
   • Aldonu montri erarkodon de moskito kaj erarmesaĝon en la funkcio konektita/malkonektita.
   v2.0.8
   • Aldonu alŝuti lokajn certaĵojn kaj lokajn ŝlosilajn funkciojn por AWS.
   v2.0.9
   • Ŝanĝu modbus komandon maksimumon de 100 al 500.
   v2.0.10
   • Aldonu voĉdonante la uzantmodulprocezojn por ĉiu 5 sekundoj, se la uzantmodulo kraŝis, ĝi kuros denove.
   v2.0.11
   • Aldonu kampon "Custom2 Field" en csv file.
   • Aldonu kampon "Sendu Grupon" en csv file, por MQTT sendu grupfunkcion.
   • Aldonu kampon "Sendu intervalon" en csv file, por MQTT sendu grupfunkcion.
   v2.0.12
   • Aldonu Azure SAS-token-generacion (sen Python3 uzantomodulo). Kiam Python3 uzantmodulo instalita, ĝi uzos SAS-token-generacion per python.
   v2.0.13
   • Aldonita kapablo redakti CSV, CA atestilo, Loka atestilo kaj Loka Privata Ŝlosilo de WebUI.
   v2.0.14
   • Riparita problemo kiam la Router App mb2mqtt ŝarĝas defaŭltan agordon post Firmware-ĝisdatigo.
   v2.0.15
   • Korektis problemon kun montrado de spacaj valoroj en la paĝo de Mapo de Tabelo.
   • Riparis problemon, kie la malnova valoro estis montrita en la paĝo de Mapo de Tabelo kiam la agorda valoro estis malplena. v2.0.16
   • Por WADMP: Korektis la problemon, ke la defaŭlta valoro havas blankspacojn.
   v2.0.17
   • Por subteni Entjeron kun 2 bajtoj grandeco (Ekzample: konverti 0xFFFF al -1).
   • Agordu permesojn al 755 por ĉiuj files en la Uzanto-Modulo.
   v2.0.18
   • Korektis problemon kun entjero-al-flosiga konvertiĝo.
   • Aldonu pli da protokolo-mesaĝo por MQTT-valoro.
   v2.0.19
   • Pliigu Proprajn Kampojn al 10 (CSV-agordaj kampoj: Q, R, U AB)
   v2.0.20
   Riparis problemon, kie agordaj komentoj kaŭzis problemojn en la administradsistemo WADMP.

Priskribo de la modulo

Ĉi tiu enkursigilo-programo ne estas enhavita en la norma enkursigilo-firmvaro. Alŝuto de ĉi tiu enkursigilo estas priskribita en la Agorda manlibro (vidu Ĉapitro Rilatajn Dokumentojn).
La enkursigilo-apo estas kongrua kun la platformo de enkursigilo v2.
Modbus al MQTT estas enkursigilo por provizi senjuntan komunikadon inter Modbus/TCP-aparatoj kaj MQTT-aparato. Modbus al MQTT funkcias kiel Modbus/TCP-majstro por komuniki kun Modbus/TCP-aparatoj, kaj funkcias kiel MQTT-eldonisto/abonanto por komuniki kun MQTT-broker.

Web Interfaco

Post kiam la instalado de la modulo estas kompleta, la GUI de la modulo povas esti alvokita alklakante la nomon de la modulo sur la paĝo de Router Apps de la enkursigilo. web interfaco.
Maldekstra parto de ĉi tiu GUI enhavas menuon kun Router-menusekcio. Revenu al la menuo-sekcio de Router ŝanĝas reen de la modulo web paĝo al la enkursigilo web agordaj paĝoj. La ĉefa menuo de la GUI de modulo estas montrita sur Figuro 1.

1. Enkursigilo
   1.1 Agordoj
   Agordo de ĉi tiu enkursigilo-apo povas esti farita en la paĝo Agordoj, sub la sekcio de menuo de Router. Ĉiuj agordaj eroj por la agorda paĝo de Agordoj estas priskribitaj en la suba tabelo.
   

   Ero	Priskribo
   Servo Ebligi	Ebligita, Modbus al MQTT APN-funkcieco de la modulo estas ŝaltita.
   Ensalutu Ebligu APN	Ebligu la Servan Protokolon.
   Makleristo Adreso	Enigu la foran Broker-Servilon-Adreson.
   Makleristo Servila Haveno	Entajpu Broker Servila Haveno-Numero (1-65535).
   MQTT Keepalive	Enigu MQTT keepalive intervalo (1-3600).
   MQTT QoS	Enigu MQTT QoS valoron (0,1,2).
   MQTT Retain	Ebligu por konservado de mesaĝoj.
   Klienta ID	Enigu Klienta ID.
   MQTT Anonima	Ebligu MQTT Anonima
   MQTT Uzantnomo	Enigu MQTT-Uzantnomon.
   MQTT Pasvorto	Enigu MQTT Pasvorton.
   MQTT TLS	Ebligu MQTT TLS.
   Intervalo (ms)	Enigu Modbus TCP Polling Intervalon.
   Tempo(ms)	Enigu Modbus TCP Timeout.
   CSV-agordo	Alŝutu la file enhavanta vian CSV-agordon ĉi tie.
   CA-Atestilo	Alŝutu vian CA-Atestilon ĉi tie.
   Loka Atestilo	Alŝutu vian Lokan Atestilon ĉi tie.
   Loka Privata Ŝlosilo	Alŝutu vian Lokan Privatŝlosilon ĉi tie.

   Tablo 1: Agordoj Ekzample Eroj Priskribo
   1.2 Agordo file
   En Modbus al MQTT, uzanto agordas la mapadon inter Modbus/TCP kaj MQTT tra CSV file. En la csv file, la kampa apartigilo (limigilo) estas komo.
   

   Ero	Priskribo
   Temo	MQTT temo
   Nomo	La nomo por identigi la mapadon.
   IP	La IP-adreso de Modbus-aparato.
   Haveno	La TCP-havennombro de la malproksima Modbus-sklava aparato.
   Aparato ID	La Modbus/TCP-sklava ID.
   Funkcia Kodo	Modbus Funkcia Kodo (FC). En Modbus al MQTT, subtenataj funkciokodoj estas: 1, 2, 3, 4, 5, 6, 15, 16 01: Legu bobenojn; 02: Legu diskretajn enigojn; 03: Legu posedregistrojn; 04: Legu enigregistron; 05: Skribu ununuran bobenon; 06: Skribu ununuran registron; 15: Skribu plurajn bobenojn; 16: Skribu plurajn registrojn.
   Adreso	Indiku la legadon de/skribi al komenca adreso por la Modbus-registro.
   Longo de datumoj	Kiam FC=1, 2, 5 aŭ 15, la unuo estas bito(j) Kiam FC=3, 4, 6 aŭ 16, la unuo estas vorto(j)
   Modbus-datumtipo	Modbus-datumtipo. Opcioj: Bulea, Entjero, Sensigna Entjero, Float
   Interŝanĝo de datumoj	La kampo de Interŝanĝo de Datumoj determinas la ordon en kiu la apartaj bajtoj de la ricevitaj/elsenditaj datumoj estas liveritaj. Neniu: Ne interŝanĝu; Vorto: 0x01, 0x02 fariĝas 0x02, 0x01; Duobla Vorto: 0x01, 0x02, 0x03, 0x04 fariĝas 0x04, 0x03, 0x02, 0x01. Duobla Vorto - Kadro: 0x01, 0x02, 0x03, 0x04 fariĝas 0x04, 0x03, 0x02, 0x01. Quad Word: 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07980 fariĝas 0x07980, 0x05, 0x06, 0x03, 0x04, 0x01, 0x02.
   Interŝanĝo de bajtoj	Opcio: Vera, Malvera Kiam opcio estas Vera: 0x01, 0x02 fariĝas 0x01, 0x02. 0x01, 0x02, 0x03, 0x04 fariĝas 0x01, 0x02, 0x03, 0x04.
   MQTT-datumtipo	MQTT-datumtipo. Opcioj: Bulea, Entjero, Sensigna Entjero, Flotaĵo, Longa Entjero, Sensignita
   Multobligilo	La valoro uzata por multobligi la datumvaloron.
   Ofseto	La valoro uzata por aldoni/subtrahi la datumvaloron.
   Intervalo de balotado (ms)	Modbus Polling Interval, unuo: milisekundoj. La valorintervalo: 1 10000000
   Sendu Kiam Ŝanĝi	Elektu ke la datumoj estu senditaj tuj kiam ŝanĝo okazas sur modbus-sklavo. Opcioj: Jes, Ne
   Propra Kampo	Propra difina valoro
   Propra2 Kampo	Propra difina valoro
   Sendu Grupon	Agordu grupnumeron por MQTT multoblaj mesaĝoj al unu mesaĝo. La valorintervalo estas de 0 ĝis 500. Kiam la valoro estas 0, ĉi tiu funkcio estas malŝaltita.
   Sendu Intervalon	Sendu MQTT-mesaĝo-intervalo por la grupo en sekundoj. La valorintervalo estas de 1 ĝis 10000 sekundoj.

   Tablo 2:Priskribo de agordaj eroj
   La CSV file povas esti importita en Advantech-enkursigilon en enkursigilo-agordo WEB paĝo. Post importo CSV file kaj alklaku la butonon "Konservi", la nova mapa agordo efektiviĝos tuj.
   1.3 Mapo de tablo
   La mapado de Modbus/TCP al MQTT estos montrita en Mapo de Tabelo WEB paĝo.
   1.4MQTT Datuma Formato
   Kiam Modbus/TCP FC estas 1, 2, 3 aŭ 4, Modbus al MQTT funkcios kiel MQTT-eldonisto por afiŝi Modbus/TCP-datumojn en JSON-formato al MQTT-broker. Kiam Modbus/TCP FC estas 5, 6, 15 aŭ 16, Modbus al MQTT funkcios kiel MQTT-abonanto por peti informojn pri abono kaj plusendi la datumojn al Modbus/TCP-aparato.
   Jen la eksampdosiero de MQTT-datenoj kiuj estas publikigitaj de Modbus al MQTT.
   Notu, ke Modbus al MQTT kontrolas nur temajn, nomojn kaj valorkampojn de la ricevitaj aboninformoj.
   

Rilataj Dokumentoj

Vi povas akiri produkt-rilatajn dokumentojn en Engineering Portal ĉe icr.advantech.cz adreso.
Por akiri la Rapidan Komencan Gvidilon de via enkursigilo, Uzantan Manlibron, Agordan Manlibron aŭ Firmware iru al la Enkursigilo-Modeloj paĝo, trovu la bezonatan modelon kaj ŝanĝu al la langeto Manlibroj aŭ Firmware respektive.
La pakoj kaj manlibroj pri instalado de Router Apps estas haveblaj sur la Enkursigilo-Aplikoj paĝo.
Por la Disvolvaj Dokumentoj, iru al la DevZone paĝo.

Manlibro de Modbus al MQTT

Dokumentoj/Rimedoj

ADVANTECH Modbus Al MQTT Router App [pdf] Uzantogvidilo Modbus Al MQTT-Enkursigilo-Apo, Modbus, Al MQTT-enkursigilo-apo, MQTT-enkursigilo-apo, Enkursigilo-apo

Referencoj

• Uzanto Manlibro