Modbus a MQTT

Advantech Czech sro, Sokolska 71, 562 04 Usti nad Orlici, República Txeca
Document núm. APP-0087-EN, revisió del 12 d'octubre de 2023.

Aplicació d'encaminador Modbus a MQTT

© 2023 Advantech Czech sro Cap part d'aquesta publicació no es pot reproduir ni transmetre de cap forma ni per cap mitjà, electrònic o mecànic, inclosa la fotografia, l'enregistrament o qualsevol sistema d'emmagatzematge i recuperació d'informació sense el consentiment per escrit. La informació d'aquest manual està subjecta a canvis sense previ avís i no representa cap compromís per part d'Advantech.
Advantech Czech sro no serà responsable dels danys incidentals o conseqüents derivats del subministrament, el rendiment o l'ús d'aquest manual.
Totes les marques utilitzades en aquest manual són marques registrades dels seus respectius propietaris. L'ús de marques comercials o altres designacions en aquesta publicació només té finalitats de referència i no constitueix un aval per part del titular de la marca comercial.

Símbols utilitzats

	Perill: informació sobre la seguretat de l'usuari o possibles danys a l'encaminador.
	Atenció: problemes que poden sorgir en situacions específiques.
	Informació: consells útils o informació d'interès especial.
	Example – Exampfitxer de funció, comanda o script.

Registre de canvis

1. Registre de canvis de Modbus a MQTT
   v2.0.5
   • Canvia openssl (1.0.2u) a biblioteca estàtica.
   v2.0.6
   • Afegeix l'opció de generació de testimoni SAS d'Azure.
   • Cal instal·lar el mòdul d'usuari Python3.
   • Afegeix el tipus de dades: Double World – Frame.
   • Afegiu el camp "Byte Swap" al csv file.
   • Afegiu el tipus de dades compatible "String".
   • Afegiu “Intercanvi de paraules” i “Canvi de bytes” per al tipus de dades de cadena.
   v2.0.7
   • Afegiu el codi d'error del mosquit i el missatge d'error a la funció connectada/desconnectada.
   v2.0.8
   • Afegiu un certificat local de càrrega i funcions de clau local per a AWS.
   v2.0.9
   • Canviar el màxim de comandament modbus de 100 a 500.
   v2.0.10
   • Afegiu l'enquesta dels processos del mòdul d'usuari per cada 5 segons, si el mòdul d'usuari falla, es tornarà a executar.
   v2.0.11
   • Afegiu el camp “Custom2 Field” al csv file.
   • Afegiu el camp "Envia el grup" al csv file, per a la funció de grup d'enviament MQTT.
   • Afegiu el camp "Interval d'enviament" al csv file, per a la funció de grup d'enviament MQTT.
   v2.0.12
   • Afegiu la generació de testimonis SAS d'Azure (sense mòdul d'usuari Python3). Quan s'instal·li el mòdul d'usuari Python3, utilitzarà la generació de testimoni SAS per Python.
   v2.0.13
   • S'ha afegit la possibilitat d'editar CSV, certificat CA, certificat local i clau privada local des WebIU.
   v2.0.14
   • S'ha solucionat el problema quan l'aplicació del router mb2mqtt carregava la configuració predeterminada després de l'actualització del firmware.
   v2.0.15
   • S'ha solucionat un problema amb la visualització dels valors d'espai a la pàgina Taula de mapes.
   • S'ha solucionat un problema en què el valor antic es mostrava a la pàgina Taula de mapes quan el valor de configuració estava buit. v2.0.16
   • Per a WADMP: S'ha solucionat el problema que el valor predeterminat tenia espais en blanc.
   v2.0.17
   • Per suportar Enter amb una mida de 2 bytes (Example: converteix 0xFFFF a -1).
   • Establiu els permisos a 755 per a tots files al mòdul d'usuari.
   v2.0.18
   • S'ha solucionat un problema amb la conversió d'enter a flotant.
   • Afegiu més missatge de registre per al valor MQTT.
   v2.0.19
   • Augmenta els camps personalitzats a 10 (camps de configuració CSV: Q, R, U AB)
   v2.0.20
   S'ha solucionat un problema en què els comentaris de configuració causaven problemes al sistema de gestió WADMP.

Descripció del mòdul

Aquesta aplicació d'encaminador no està inclosa al microprogramari estàndard de l'encaminador. La càrrega d'aquesta aplicació d'encaminador es descriu al manual de configuració (vegeu el capítol Documents relacionats).
L'aplicació d'encaminador és compatible amb la plataforma d'encaminador v2.
Modbus to MQTT és una aplicació d'encaminador per proporcionar una comunicació perfecta entre els dispositius Modbus/TCP i el dispositiu MQTT. Modbus a MQTT funciona com a mestre Modbus/TCP per comunicar-se amb dispositius Modbus/TCP i funciona com a editor/subscriptor MQTT per comunicar-se amb l'agent MQTT.

Web Interfície

Un cop finalitzada la instal·lació del mòdul, es pot invocar la GUI del mòdul fent clic al nom del mòdul a la pàgina d'aplicacions d'encaminador del router. web interfície.
La part esquerra d'aquesta GUI conté un menú amb la secció de menú de l'encaminador. Tornar a la secció del menú de l'encaminador torna a canviar des del mòdul web pàgina a l'encaminador web pàgines de configuració. El menú principal de la GUI del mòdul es mostra a la figura 1.

1. Encaminador
   1.1 Configuració
   La configuració d'aquesta aplicació d'encaminador es pot fer a la pàgina Configuració, a la secció del menú de l'encaminador. Tots els elements de configuració de la pàgina de configuració de configuració es descriuen a la taula següent.
   

   Item	Descripció
   Habilita el servei	Habilitat, la funcionalitat Modbus a MQTT APN del mòdul està activada.
   Registre Habilita APN	Habiliteu el registre de servei.
   Adreça del corredor	Introduïu l'adreça remota del servidor del corredor.
   Port del servidor del corredor	Introduïu el número de port del servidor del corredor (1-65535).
   MQTT Keepalive	Introduïu l'interval de manteniment MQTT (1-3600).
   QoS MQTT	Introduïu el valor MQTT QoS (0,1,2).
   Retenció de MQTT	Habilita per a la retenció de missatges.
   Identificador de client	Introduïu l'identificador de client.
   MQTT Anònim	Activa MQTT Anonymous
   Nom d'usuari MQTT	Introduïu el nom d'usuari MQTT.
   Contrasenya MQTT	Introduïu la contrasenya MQTT.
   MQTT TLS	Habilita MQTT TLS.
   Interval (ms)	Introduïu l'interval de sondeig Modbus TCP.
   Temps d'espera (ms)	Introduïu el temps d'espera de Modbus TCP.
   Configuració CSV	Carregueu el file que conté la vostra configuració CSV aquí.
   Certificat CA	Carregueu el vostre certificat CA aquí.
   Certificat local	Carregueu el vostre certificat local aquí.
   Clau privada local	Carregueu aquí la vostra clau privada local.

   Taula 1: Configuració Example Elements Descripció
   1.2 Configuració file
   A Modbus a MQTT, l'usuari configura l'assignació entre Modbus/TCP i MQTT mitjançant CSV file. En el csv file, el separador de camps (delimitador) és una coma.
   

   Item	Descripció
   Tema	Tema MQTT
   Nom	El nom per identificar el mapeig.
   IP	L'adreça IP del dispositiu Modbus.
   Port	El número de port TCP del dispositiu esclau Modbus remot.
   ID del dispositiu	L'identificador de l'esclau Modbus/TCP.
   Codi de funció	Codi de funció Modbus (FC). A Modbus a MQTT, els codis de funció admesos són: 1, 2, 3, 4, 5, 6, 15, 16 01: Llegir bobines; 02: Llegir les entrades discretes; 03: Llegir registres de retenció; 04: Llegir el registre d'entrada; 05: Escriure bobina única; 06: Escriure registre únic; 15: Escriu múltiples bobines; 16: Escriu diversos registres.
   Adreça	Designeu l'adreça d'inici de lectura/escriptura per al registre Modbus.
   Longitud de dades	Quan FC=1, 2, 5 o 15, la unitat és bit(s) Quan FC=3, 4, 6 o 16, la unitat és paraula(s)
   Tipus de dades Modbus	Tipus de dades Modbus. Opcions: booleà, enter, enter sense signe, flotant
   Intercanvi de dades	El camp Data Swap determina l'ordre en què s'entreguen els bytes particulars de les dades rebudes/transmeses. Cap: no intercanvieu; Paraula: 0x01, 0x02 es converteix en 0x02, 0x01; Paraula doble: 0x01, 0x02, 0x03, 0x04 es converteix en 0x04, 0x03, 0x02, 0x01. Paraula doble: marc: 0x01, 0x02, 0x03, 0x04 es converteix en 0x04, 0x03, 0x02, 0x01. Paraula quàdruple: 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07980 es converteix en 0x07980, 0x05, 0x06, 0x03, 0x04, 0x01, 0x02.
   Canvi de bytes	Opció: vertader, fals Quan l'opció és True: 0x01, 0x02 es converteix en 0x01, 0x02. 0x01, 0x02, 0x03, 0x04 es converteix en 0x01, 0x02, 0x03, 0x04.
   Tipus de dades MQTT	Tipus de dades MQTT. Opcions: booleà, enter, enter sense signe, flotant, enter llarg, sense signar
   Multiplicador	El valor utilitzat per multiplicar el valor de les dades.
   Offset	El valor utilitzat per afegir/retreure el valor de les dades.
   Interval de sondeig (ms)	Interval de sondeig Modbus, unitat: mil·lisegons. Interval de valors: 1 10000000
   Envia quan canviï	Seleccioneu que les dades s'enviïn immediatament quan es produeixi un canvi a l'esclau modbus. Opcions: Sí, No
   Camp personalitzat	Valor de definició personalitzat
   Camp personalitzat 2	Valor de definició personalitzat
   Enviar grup	Estableix el número de grup per a diversos missatges MQTT en un missatge. L'interval de valors és de 0 a 500. Quan el valor és 0, aquesta funció està desactivada.
   Interval d'enviament	Envieu l'interval de missatges MQTT per al grup en segons. L'interval de valors és d'1 a 10000 segons.

   Taula 2:Descripció dels elements de configuració
   El CSV file es pot importar a l'encaminador Advantech a la configuració de l'aplicació de l'encaminador WEB pàgina. Després d'importar CSV file i feu clic al botó "Desa", la nova configuració de mapes tindrà efecte immediatament.
   1.3 Taula de mapes
   L'assignació de Modbus/TCP a MQTT es mostrarà a la taula de mapes WEB pàgina.
   Format de dades 1.4MQTT
   Quan Modbus/TCP FC és 1, 2, 3 o 4, Modbus a MQTT funcionarà com a editor MQTT per publicar dades Modbus/TCP en format JSON al corredor MQTT. Quan Modbus/TCP FC és 5, 6, 15 o 16, Modbus a MQTT funcionarà com a subscriptor MQTT per demanar informació de subscripció i reenviar les dades al dispositiu Modbus/TCP.
   Aquí teniu els exampfitxer de dades MQTT que es publica de Modbus a MQTT.
   Tingueu en compte que Modbus a MQTT verifica només els camps de tema, nom i valor de la informació de subscripció rebuda.
   

Documents relacionats

Podeu obtenir documents relacionats amb el producte al portal d'enginyeria a icr.advantech.cz adreça.
Per obtenir la Guia d'inici ràpid, el manual d'usuari, el manual de configuració o el firmware del vostre enrutador, aneu a Models d'encaminador pàgina, cerqueu el model necessari i canvieu a la pestanya Manuals o Firmware, respectivament.
Els manuals i els paquets d'instal·lació de les aplicacions d'encaminador estan disponibles a Aplicacions d'encaminador pàgina.
Per als documents de desenvolupament, aneu a DevZone pàgina.

Manual de Modbus a MQTT

Documents/Recursos

Aplicació d'encaminador ADVANTECH Modbus a MQTT [pdfGuia de l'usuari Aplicació d'encaminador Modbus a MQTT, Modbus, aplicació d'encaminador MQTT, aplicació d'encaminador MQTT, aplicació d'encaminador

Referències

• Manual d'usuari