Modbus да MQTT
Advantech Czech sro, Sokolska 71, 562 04 Usti nad Orlici, Чэхія
Дакумент № APP-0087-EN, версія ад 12 кастрычніка 2023 г.
Прыкладанне для маршрутызатара Modbus да MQTT
© 2023 Advantech Czech sro Ніякая частка гэтай публікацыі не можа быць прайграная або перададзена ў любой форме або любымі сродкамі, электроннымі або механічнымі, уключаючы фатаграфію, запіс або любую сістэму захоўвання і пошуку інфармацыі без пісьмовай згоды. Інфармацыя ў гэтым кіраўніцтве можа быць зменена без папярэдняга паведамлення і не з'яўляецца абавязацельствам з боку Advantech.
Кампанія Advantech Czech sro не нясе адказнасці за выпадковыя або ўскосныя пашкоджанні ў выніку размяшчэння, выканання або выкарыстання гэтага кіраўніцтва.
Усе гандлёвыя маркі, якія выкарыстоўваюцца ў гэтым кіраўніцтве, з'яўляюцца зарэгістраванымі гандлёвымі маркамі іх адпаведных уладальнікаў. Выкарыстанне таварных знакаў або іншых абазначэнняў у гэтай публікацыі прызначана толькі ў даведачных мэтах і не з'яўляецца адабрэннем уладальнікам таварнага знака.
Выкарыстоўваная сімволіка
 |
Небяспека – інфармацыя аб бяспецы карыстальніка або патэнцыйным пашкоджанні маршрутызатара. |
 |
Увага - Праблемы, якія могуць узнікнуць у канкрэтных сітуацыях. |
 |
Інфармацыя – Карысныя парады або асабліва цікавая інфармацыя. |
 |
Example – Выклampфайл функцыі, каманды або сцэнара. |
Журнал змяненняў
- Журнал змяненняў Modbus для MQTT
v2.0.5
• Змяніць openssl (1.0.2u) на статычную бібліятэку.
v2.0.6
• Дадаць опцыю генерацыі SAS-токена Azure.
• Неабходнасць усталявання карыстальніцкага модуля Python3.
• Дадаць тып даных: двайны свет – рамка.
• Дадайце поле «Замена байтаў» у CSV file.
• Дадайце падтрымоўваны тып даных "Страд".
• Дадайце «Замену слоў» і «Замену байтаў» для тыпу даных String.
v2.0.7
• Дадайце код памылкі show mosquitto і паведамленне пра памылку ў функцыі падключэння/адключэння.
v2.0.8
• Дадайце лакальны сертыфікат і лакальныя ключавыя функцыі для AWS.
v2.0.9
• Змяніце максімум каманд Modbus са 100 на 500.
v2.0.10
• Дадайце апытанне працэсаў карыстальніцкага модуля кожныя 5 секунд, калі карыстальніцкі модуль выйдзе з ладу, ён запусціцца зноў.
v2.0.11
• Дадайце поле «Custom2 Field» у CSV file.
• Дадаць поле «Адправіць групу» ў CSV file, для функцыі групавой адпраўкі MQTT.
• Дадаць поле «Інтэрвал адпраўкі» ў CSV file, для функцыі групавой адпраўкі MQTT.
v2.0.12
• Дадайце генерацыю токенаў Azure SAS (без карыстальніцкага модуля Python3). Калі карыстальніцкі модуль Python3 усталяваны, ён будзе выкарыстоўваць генерацыю SAS-токенаў з дапамогай python.
v2.0.13
• Дададзена магчымасць рэдагавання CSV, сертыфіката ЦС, лакальнага сертыфіката і лакальнага закрытага ключа WebUI.
v2.0.14
• Выпраўлена праблема, калі праграма маршрутызатара mb2mqtt загружае канфігурацыю па змаўчанні пасля абнаўлення прашыўкі.
v2.0.15
• Выпраўлена праблема з адлюстраваннем значэнняў прасторы на старонцы табліцы адлюстравання.
• Выпраўлена праблема, з-за якой старое значэнне адлюстроўвалася на старонцы табліцы адлюстравання, калі значэнне канфігурацыі было пустым. версія 2.0.16
• Для WADMP: выпраўлена праблема, што значэнне па змаўчанні мае прабелы.
v2.0.17
• Для падтрымкі Integer з памерам 2 байт (Напрample: пераўтварыць 0xFFFF у -1).
• Усталюйце дазволы 755 для ўсіх files у модулі карыстальніка.
v2.0.18
• Выпраўлена праблема з пераўтварэннем цэлага ліку ў плыўнае.
• Дадайце больш паведамленняў часопіса для значэння MQTT.
v2.0.19
• Павялічыць карыстальніцкія палі да 10 (палі канфігурацыі CSV: Q, R, U AB)
v2.0.20
Выпраўлена праблема, пры якой каментарыі канфігурацыі выклікалі праблемы ў сістэме кіравання WADMP.
Апісанне модуля
Гэта дадатак маршрутызатара не ўваходзіць у стандартную прашыўку маршрутызатара. Загрузка гэтага прыкладання маршрутызатара апісана ў кіраўніцтве па канфігурацыі (гл. раздзел «Звязаныя дакументы»).
Дадатак маршрутызатара сумяшчальна з платформай маршрутызатара v2.
Modbus to MQTT - гэта праграма маршрутызатара для бесперашкоднай сувязі паміж прыладамі Modbus/TCP і прыладамі MQTT. Modbus to MQTT працуе як майстар Modbus/TCP для сувязі з прыладамі Modbus/TCP і працуе як выдавец/падпісчык MQTT для сувязі з брокерам MQTT.
Web Інтэрфейс
Пасля завяршэння ўстаноўкі модуля можна выклікаць графічны інтэрфейс модуля, пстрыкнуўшы назву модуля на старонцы прыкладанняў маршрутызатара маршрутызатара web інтэрфейс.
Левая частка гэтага графічнага інтэрфейсу змяшчае меню з раздзелам меню маршрутызатара. Вярнуцца да раздзела меню маршрутызатара перамыкае назад з модуля web старонку на маршрутызатар web старонкі канфігурацыі. Галоўнае меню графічнага інтэрфейсу модуля паказана на малюнку 1.
- Маршрутызатар
1.1 Налады
Канфігурацыю гэтага прыкладання маршрутызатара можна зрабіць на старонцы налад у раздзеле меню маршрутызатара. Усе элементы канфігурацыі для старонкі канфігурацыі налад апісаны ў табліцы ніжэй.
Пункт Апісанне Уключыць службу Уключана, функцыя Modbus да MQTT APN модуля ўключана. Уключыць APN для ўваходу Уключыць часопіс абслугоўвання. Адрас брокера Увядзіце аддалены адрас сервера брокера. Порт сервера брокера Увядзіце нумар порта сервера брокера (1-65535). MQTT Keepalive Увядзіце інтэрвал падтрымання актыўнасці MQTT (1-3600). QoS MQTT Увядзіце значэнне MQTT QoS (0,1,2). Захаваць MQTT Уключыць для захавання паведамленняў. Ідэнтыфікатар кліента Увядзіце ID кліента. MQTT Anonymous Уключыць MQTT Anonymous Імя карыстальніка MQTT Увядзіце імя карыстальніка MQTT. Пароль MQTT Увядзіце пароль MQTT. MQTT TLS Уключыць MQTT TLS. Інтэрвал (мс) Увядзіце інтэрвал апытання Modbus TCP. Тайм-аўт (мс) Увядзіце тайм-аўт Modbus TCP. Канфігурацыя CSV Загрузіць file які змяшчае вашу канфігурацыю CSV тут. Сертыфікат CA Загрузіце свой сертыфікат ЦС тут. Мясцовы сертыфікат Загрузіце тут свой мясцовы сертыфікат. Лакальны прыватны ключ Загрузіце тут свой лакальны прыватны ключ. Табліца 1: Налады ExampАпісанне прадметаў
1.2 Канфігурацыя file
У Modbus да MQTT карыстальнік наладжвае супастаўленне паміж Modbus/TCP і MQTT праз CSV file. У файле csv file, падзельнік палёў (падзельнік) — коска.
Пункт Апісанне Тэма Тэма MQTT Імя Імя для ідэнтыфікацыі супастаўлення. IP IP-адрас прылады Modbus. Порт Нумар TCP-порта аддаленай падпарадкаванай прылады Modbus. Ідэнтыфікатар прылады Ідэнтыфікатар падпарадкаванага Modbus/TCP. Код функцыі Функцыянальны код Modbus (FC). У Modbus да MQTT падтрымліваюцца коды функцый: 1, 2, 3, 4, 5, 6, 15, 16
01: Чытаць шпулькі;
02: Чытанне дыскрэтных уваходаў;
03: Чытанне рэестраў захоўвання;
04: Чытанне ўваходнага рэгістра;
05: Напісаць адну шпульку;
06: Напісаць адзіны рэгістр;
15: Напісаць некалькі шпулек;
16: Напісаць некалькі рэгістраў.Адрас Прызначце пачатковы адрас для чытання/запісу для рэестра Modbus. Даўжыня дадзеных Калі FC=1, 2, 5 або 15, адзінкай з'яўляецца біт(ы)
Калі FC=3, 4, 6 або 16, адзінкай з'яўляецца слова(-ы)Тып дадзеных Modbus Тып дадзеных Modbus.
Параметры: лагічны, цэлы лік, цэлы лік без знака, FloatАбмен дадзенымі Поле Data Swap вызначае парадак, у якім дастаўляюцца пэўныя байты атрыманых/перададзеных даных.
Няма: не мяняць; Слова: 0x01, 0x02 становіцца 0x02, 0x01;
Падвойнае слова: 0x01, 0x02, 0x03, 0x04 становіцца 0x04, 0x03, 0x02, 0x01.
Падвойнае слова – рамка: 0x01, 0x02, 0x03, 0x04 становіцца 0x04, 0x03, 0x02, 0x01.
Чатырохслоўнае слова: 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07980 становіцца 0x07980, 0x05, 0x06, 0x03, 0x04, 0x01, 0x02.Замена байтаў Варыянт: Праўда, Хлусня
Калі параметр мае значэнне True: 0x01, 0x02 становіцца 0x01, 0x02.
0x01, 0x02, 0x03, 0x04 становіцца 0x01, 0x02, 0x03, 0x04.Тып дадзеных MQTT Тып даных MQTT.
Параметры: лагічны, цэлы лік, цэлы лік без знака, плывучы лік, доўгі цэлы лік, без знакаМультыплікатар Значэнне, якое выкарыстоўваецца для множання значэння даных. Зрушэнне Значэнне, якое выкарыстоўваецца для дадання/аднімання значэння даных. Інтэрвал апытання (мс) Інтэрвал апытання Modbus, адзінка вымярэння: мілісекунды.
Дыяпазон значэнняў: 1 10000000Адправіць пры змене Выберыце, каб даныя адпраўляліся неадкладна, калі адбываецца змяненне на падпарадкаваным Modbus.
Варыянты: Так, НеКарыстальніцкае поле Карыстальніцкае значэнне вызначэння Custom2 Поле Карыстальніцкае значэнне вызначэння Адправіць групу Усталюйце нумар групы для некалькіх паведамленняў MQTT на адно паведамленне.
Дыяпазон значэнняў ад 0 да 500. Калі значэнне роўна 0, гэтая функцыя адключана.Адправіць інтэрвал Інтэрвал адпраўкі паведамлення MQTT для групы ў секундах. Дыяпазон значэнняў - ад 1 да 10000 секунд. Табліца 2: Апісанне элементаў канфігурацыі
CSV file можна імпартаваць у маршрутызатар Advantech у наладах праграмы маршрутызатара WEB старонка. Пасля імпарту CSV file і націсніце кнопку «Захаваць», новая канфігурацыя адлюстравання ўступіць у сілу неадкладна.
1.3 Табліца адлюстравання
Адлюстраванне Modbus/TCP і MQTT будзе паказана ў табліцы супастаўлення WEB старонка.
Фармат даных 1.4MQTT
Калі Modbus/TCP FC роўны 1, 2, 3 або 4, Modbus to MQTT будзе працаваць як выдавец MQTT для публікацыі дадзеных Modbus/TCP у фармаце JSON брокеру MQTT. Калі Modbus/TCP FC роўны 5, 6, 15 або 16, Modbus да MQTT будзе працаваць як абанент MQTT, каб запытваць інфармацыю аб падпісцы і перасылаць дадзеныя на прыладу Modbus/TCP.
Вось эксampданых MQTT, якія публікуюцца з Modbus на MQTT.
Звярніце ўвагу, што Modbus да MQTT правярае толькі тэмы, імя і значэнні палёў атрыманай інфармацыі аб падпісцы.
Вы можаце атрымаць дакументы, звязаныя з прадуктам, на інжынерным партале па адрасе icr.advantech.cz адрас.
Каб атрымаць Кароткае кіраўніцтва па запуску маршрутызатара, Кіраўніцтва карыстальніка, Кіраўніцтва па канфігурацыі або прашыўку, перайдзіце на Мадэлі маршрутызатараў знайдзіце патрэбную мадэль і пераключыцеся на ўкладку Manuals або Firmware адпаведна.
Пакеты ўстаноўкі і кіраўніцтва Router Apps даступныя на Прыкладання для маршрутызатара старонка.
Для атрымання дакументаў па распрацоўцы перайдзіце да DevZone старонка.
Кіраўніцтва Modbus - MQTT
Дакументы / Рэсурсы
 |
Дадатак ADVANTECH Modbus да маршрутызатара MQTT [pdfКіраўніцтва карыстальніка Прыкладанне для маршрутызатара Modbus да MQTT, прыкладанне для маршрутызатара Modbus, да прыкладання для маршрутызатара MQTT, прыкладанне для маршрутызатара MQTT, прыкладанне для маршрутызатара |
