Modbus na MQTT
Advantech Czech sro, Sokolská 71, 562 04 Ústí nad Orlicí, Česká republika
Dokument č. APP-0087-EN, revize z 12. října 2023.
Aplikace Modbus To MQTT Router
© 2023 Advantech Czech sro Žádná část této publikace nesmí být reprodukována nebo přenášena v jakékoli formě nebo jakýmikoli prostředky, elektronickými nebo mechanickými, včetně fotografií, záznamů nebo jakéhokoli systému pro ukládání a vyhledávání informací bez písemného souhlasu. Informace v této příručce se mohou bez upozornění změnit a nepředstavují závazek ze strany společnosti Advantech.
Advantech Czech sro nenese odpovědnost za náhodné nebo následné škody vzniklé v důsledku poskytnutí, provedení nebo použití tohoto návodu.
Všechny názvy značek použité v této příručce jsou registrované ochranné známky příslušných vlastníků. Použití ochranných známek nebo jiných označení v této publikaci je pouze pro referenční účely a nepředstavuje podporu držitele ochranné známky.
Použité symboly
 |
Nebezpečí – Informace týkající se bezpečnosti uživatele nebo možného poškození routeru. |
 |
Pozor – Problémy, které mohou nastat v konkrétních situacích. |
 |
Informace – užitečné tipy nebo informace zvláštního zájmu. |
 |
Example – Přampsoubor funkce, příkazu nebo skriptu. |
Seznam změn
- Modbus na MQTT Changelog
v2.0.5
• Změňte openssl (1.0.2u) na statickou knihovnu.
v2.0.6
• Přidejte možnost generování tokenů Azure SAS.
• Potřeba nainstalovat uživatelský modul Python3.
• Přidat typ dat: Double World – Frame.
• Přidejte pole „Byte Swap“ ve formátu csv file.
• Přidejte podporovaný typ dat „String“.
• Přidejte „Word Swap“ a „Byte Swap“ pro typ dat řetězce.
v2.0.7
• Přidejte kód chyby show mosquitto a chybovou zprávu do funkce připojeno/odpojeno.
v2.0.8
• Přidejte místní certifikaci pro nahrávání a místní klíčové funkce pro AWS.
v2.0.9
• Změňte maximum příkazu modbus ze 100 na 500.
v2.0.10
• Přidejte dotazování procesů uživatelského modulu každých 5 sekund, pokud uživatelský modul selhal, spustí se znovu.
v2.0.11
• Přidejte pole „Custom2 Field“ ve formátu csv file.
• Přidejte pole „Odeslat skupinu“ ve formátu csv file, pro funkci skupiny odesílání MQTT.
• Přidejte pole „Interval odeslání“ ve formátu csv file, pro funkci skupiny odesílání MQTT.
v2.0.12
• Přidejte generování tokenů Azure SAS (bez uživatelského modulu Python3). Když je nainstalován uživatelský modul Python3, bude používat generování tokenů SAS pomocí pythonu.
v2.0.13
• Přidána možnost upravovat CSV, certifikát CA, místní certifikát a místní soukromý klíč WebUI.
v2.0.14
• Opraven problém, kdy aplikace Router mb2mqtt načítá výchozí konfiguraci po aktualizaci firmwaru.
v2.0.15
• Opraven problém se zobrazováním hodnot prostoru na stránce Mapovací tabulka.
• Opraven problém, kdy se stará hodnota zobrazovala na stránce Tabulka mapování, když byla konfigurační hodnota prázdná. v2.0.16
• Pro WADMP: Opraven problém, že výchozí hodnota obsahuje mezery.
v2.0.17
• Pro podporu celého čísla o velikosti 2 bajty (napřample: převod 0xFFFF na -1).
• Nastavte oprávnění na 755 pro všechny files v uživatelském modulu.
v2.0.18
• Opraven problém s převodem integer-to-float.
• Přidejte další zprávu protokolu pro hodnotu MQTT.
v2.0.19
• Zvyšte vlastní pole na 10 (pole konfigurace CSV: Q, R, U AB)
v2.0.20
Opraven problém, kdy komentáře ke konfiguraci způsobovaly problémy v systému správy WADMP.
Popis modulu
Tato aplikace Router není obsažena ve standardním firmwaru routeru. Nahrání této aplikace routeru je popsáno v konfigurační příručce (viz kapitola Související dokumenty).
Aplikace routeru je kompatibilní s platformou routeru v2.
Modbus to MQTT je routerová aplikace pro zajištění bezproblémové komunikace mezi zařízeními Modbus/TCP a zařízením MQTT. Modbus to MQTT funguje jako Modbus/TCP master pro komunikaci se zařízeními Modbus/TCP a funguje jako vydavatel/odběratel MQTT pro komunikaci s MQTT brokerem.
Web Rozhraní
Po dokončení instalace modulu lze GUI modulu vyvolat kliknutím na název modulu na stránce Router Apps na routeru. web rozhraní.
Levá část tohoto GUI obsahuje menu se sekcí menu Router. Návrat do nabídky Router přepne zpět z modulu web stránku k routeru web konfigurační stránky. Hlavní nabídka GUI modulu je znázorněna na obrázku 1.
- Směrovač
NIKDY Nastavení
Konfiguraci této aplikace routeru lze provést na stránce Nastavení v části nabídky Router. Všechny položky konfigurace pro konfigurační stránku Nastavení jsou popsány v tabulce níže.
Položka Popis Povolit službu Povoleno, funkce Modbus to MQTT APN modulu je zapnutá. Protokol Povolit APN Povolte protokol služeb. Adresa makléře Zadejte adresu vzdáleného serveru brokera. Port serveru brokera Zadejte číslo portu serveru brokera (1-65535). MQTT Keepalive Zadejte interval udržování MQTT (1-3600). MQTT QoS Zadejte hodnotu QoS MQTT (0,1,2). Zachovat MQTT Povolit pro uchování zpráv. ID zákazníka Zadejte ID klienta. Anonymní MQTT Povolit MQTT Anonymous Uživatelské jméno MQTT Zadejte uživatelské jméno MQTT. Heslo MQTT Zadejte heslo MQTT. MQTT TLS Povolit MQTT TLS. Interval (ms) Zadejte interval dotazování Modbus TCP. Časový limit (ms) Zadejte časový limit protokolu Modbus TCP. Konfigurace CSV Nahrajte soubor file obsahující zde vaši konfiguraci CSV. Certifikát CA. Zde nahrajte svůj certifikát CA. Místní certifikát Zde nahrajte svůj místní certifikát. Místní soukromý klíč Zde nahrajte svůj místní soukromý klíč. Tabulka 1: Nastavení Přample Popis položek
1.2 Konfigurace file
V Modbus na MQTT uživatel konfiguruje mapování mezi Modbus/TCP a MQTT prostřednictvím CSV file. V souboru csv file, oddělovač polí (oddělovač) je čárka.
Položka Popis Téma téma MQTT Jméno Název k identifikaci mapování. IP IP adresa zařízení Modbus. Přístav Číslo TCP portu vzdáleného Modbus slave zařízení. ID zařízení ID Modbus/TCP slave. Kód funkce Kód funkce Modbus (FC). V Modbus to MQTT jsou podporované funkční kódy: 1, 2, 3, 4, 5, 6, 15, 16
01: Čtecí cívky;
02: Čtení diskrétních vstupů;
03: Čtení přídržných registrů;
04: Čtení vstupního registru;
05: Zápis jediné cívky;
06: Zápis jednoho registru;
15: Zápis více cívek;
16: Zápis více registrů.Adresa Určete počáteční adresu pro čtení z/zápis do registru Modbus. Délka dat Když FC=1, 2, 5 nebo 15, jednotka je bit(y)
Když FC=3, 4, 6 nebo 16, jednotka je slovo (slova)Modbus Typ dat Typ dat Modbus.
Možnosti: Boolean, Integer, Unsigned Integer, FloatVýměna dat Pole Data Swap určuje pořadí, ve kterém jsou jednotlivé bajty přijatých/vysílaných dat doručeny.
Žádné: Nezaměňovat; Slovo: 0x01, 0x02 se změní na 0x02, 0x01;
Dvojité slovo: 0x01, 0x02, 0x03, 0x04 se změní na 0x04, 0x03, 0x02, 0x01.
Dvojité slovo – rámec: 0x01, 0x02, 0x03, 0x04 se změní na 0x04, 0x03, 0x02, 0x01.
Quad Word: 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07980 se změní na 0x07980, 0x05, 0x06, 0x03, 0x04, 0x01, 0x02.Výměna bajtů Možnost: Pravda, nepravda
Když je volba True: 0x01, 0x02 se změní na 0x01, 0x02.
0x01, 0x02, 0x03, 0x04 se změní na 0x01, 0x02, 0x03, 0x04.MQTT Typ dat datový typ MQTT.
Možnosti: Boolean, Integer, Unsigned Integer, Float, Long Integer, UnsignedNásobitel Hodnota použitá k vynásobení hodnoty dat. Offset Hodnota použitá k přičtení/odečtení hodnoty dat. Interval dotazování (ms) Modbus Polling Interval, jednotka: milisekundy.
Rozsah hodnot: 1 10000000Odeslat při změně Vyberte, že data budou odeslána okamžitě, když dojde ke změně na modbus slave.
Možnosti: Ano, NeVlastní pole Hodnota vlastní definice Custom2 Field Hodnota vlastní definice Odeslat skupinu Nastavte číslo skupiny pro více zpráv MQTT na jednu zprávu.
Rozsah hodnot je od 0 do 500. Pokud je hodnota 0, tato funkce je deaktivována.Interval odeslání Interval odesílání zpráv MQTT pro skupinu v sekundách. Rozsah hodnot je od 1 do 10000 XNUMX sekund. Tabulka 2: Popis položek konfigurace
Soubor CSV file lze importovat do routeru Advantech v nastavení aplikace routeru WEB strana. Po importu CSV file a klikněte na tlačítko „Uložit“, nová konfigurace mapování se okamžitě projeví.
1.3 Mapovací tabulka
Mapování Modbus/TCP na MQTT se zobrazí v tabulce mapování WEB strana.
Datový formát 1.4MQTT
Když je Modbus/TCP FC 1, 2, 3 nebo 4, Modbus to MQTT bude fungovat jako vydavatel MQTT pro odesílání dat Modbus/TCP ve formátu JSON brokerovi MQTT. Když je Modbus/TCP FC 5, 6, 15 nebo 16, Modbus na MQTT bude fungovat jako předplatitel MQTT, aby si vyžádal informace o předplatném a předal data do zařízení Modbus/TCP.
Tady jsou exampsoubor dat MQTT, který je publikován z Modbus do MQTT.
Všimněte si, že Modbus to MQTT ověřuje pouze pole tématu, názvu a hodnoty přijatých informací o předplatném.
Dokumenty týkající se produktu můžete získat na Engineering Portal na adrese icr.advantech.cz adresa.
Chcete-li získat příručku pro rychlý start, uživatelskou příručku, konfigurační příručku nebo firmware vašeho routeru, přejděte na stránku Modely směrovačů vyhledejte požadovaný model a přepněte se na kartu Manuals nebo Firmware.
Instalační balíčky a příručky Router Apps jsou k dispozici na Routerové aplikace strana.
Vývojové dokumenty najdete na DevZone strana.
Manuál Modbus to MQTT
Dokumenty / zdroje
 |
ADVANTECH Modbus To MQTT Router App [pdfUživatelská příručka Modbus To MQTT Router App, Modbus, To MQTT Router App, MQTT Router App, Router App |
