16 187
правок
Wb-mqtt-serial driver: различия между версиями
Добавил диаграмму таймаутов опроса, взял на гитхабе
(Добавил диаграмму таймаутов опроса, взял на гитхабе) |
|||
| (не показано 12 промежуточных версий 2 участников) | |||
| Строка 1: | Строка 1: | ||
{{DISPLAYTITLE: Драйвер wb-mqtt-serial}} | {{DISPLAYTITLE: Драйвер wb-mqtt-serial}} | ||
[[Image: wb-mqtt-serial a few protocols.png |500px|thumb|right| Драйвер wb-mqtt-serial может одновременно опрашивать устройства, работающие по разным протоколам: <br> 1 — виртуальный порт для устройств с протоколом Modbus TCP,<br> 2 — устройство работает по протоколу Modbus RTU,<br> 3 — устройство работает по протоколу DLMS]] | |||
== Описание == | == Описание == | ||
Драйвер <code>wb-mqtt-serial</code> служит для работы с подключенными по | {{note|note| Драйвер ''wb-mqtt-serial'' ранее назывался ''wb-homa-modbus'', а конфигурационный файл <code>/etc/wb-mqtt-serial.conf</code> — <code>/etc/wb-homa-modbus.conf</code>. Учитывайте это, если используете устаревшие прошивки.}} | ||
Драйвер <code>wb-mqtt-serial</code> служит для работы с подключенными по последовательным портам, в том числе [[RS-485|RS-485]], устройствами через систему [[MQTT|MQTT]]-сообщений. | |||
Полное описание драйвера смотрите [https://github.com/contactless/wb-mqtt-serial в репозитории на Github]. | Полное описание драйвера смотрите [https://github.com/contactless/wb-mqtt-serial в репозитории на Github]. | ||
| Строка 9: | Строка 9: | ||
== Поддерживаемые устройства == | == Поддерживаемые устройства == | ||
=== Перечень === | === Перечень === | ||
Драйвер поддерживает некоторые устройства, который работают по протоколам: | |||
* | * [[Modbus | Modbus RTU и Modbus TCP]], | ||
* [http://smart.uniel.ru Uniel], | |||
* | * [http://www.eksis.ru/catalog/measures-of-relative-humidity-and-temperature/ ИВТМ], | ||
* | * [https://www.incotexcom.ru/catalogue Меркурий], | ||
* [https://miluris.ru/ Милур], | |||
* [[GOST MEK 61107 | Энергомера ГОСТ МЭК 61107]], | |||
* [[GOST MEK 61107 |НЕВА МТ 32х ГОСТ МЭК 61107]], | |||
* [[DLMS/COSEM | DLMS/COSEM, СПОДЭС (ГОСТ Р 58940-2020)]], | |||
* [[Somfy SDN | Somfy SDN]], | |||
* [[WinDeco | WinDeco]], | |||
* [[Dooya DT82 | Dooya DT82]]. | |||
Полный список поддерживаемых устройств | Полный список поддерживаемых устройств и особенности подключения, смотрите в таблице [[Supported devices#Таблица | Поддерживаемые контроллером Wiren Board протоколы и устройства]]. | ||
Учитывайте, что сторонние производители устройств могут вносить недокументированные изменения в протокол, поэтому перед покупкой устройства желательно убедиться в работоспособности выбранного решения. | Учитывайте, что сторонние производители устройств могут вносить недокументированные изменения в протокол, поэтому перед покупкой устройства желательно убедиться в работоспособности выбранного решения. | ||
| Строка 23: | Строка 30: | ||
Использовать устройства с разными протоколами на одной шине возможно, но необходимо учитывать особенности конкретных протоколов. | Использовать устройства с разными протоколами на одной шине возможно, но необходимо учитывать особенности конкретных протоколов. | ||
Например, фреймы устройств | Например, фреймы устройств Uniel начинаются с байта <code>0xff</code>, а устройств ИВТМ — с байта <code>0x24</code>. В случае с протоколами Modbus, Меркурий 230 и Милур первым байтом фрейма является идентификатор ''slave'', поэтому при совмещении таких устройств нужно внимательно подходить к выбору ''slave id''. | ||
У устройств Милур ''slave id'' по умолчанию равен <code>0xff</code>, что приведет к конфликту с устройствами | У устройств Милур ''slave id'' по умолчанию равен <code>0xff</code>, что приведет к конфликту с устройствами Uniel. Также устройства Милур требуют дополнительных задержек при опросе и при использовании на одной шине с другими устройствами могут снизить общую скорость опроса устройств. | ||
Иногда устройства, работающие на разных протоколах могут конфликтовать между собой. | Иногда устройства, работающие на разных протоколах могут конфликтовать между собой. | ||
=== Широковещательные сообщения === | === Широковещательные сообщения === | ||
[[Image:Broadcast Energometa CE102M.png |400px|thumb|right| Включение широковещательных сообщений в настройках счётчика Энергомера CE102M]] | |||
Протоколы Меркурий 230, Энергомера ГОСТ МЭК 61107, НЕВА МТ 32х ГОСТ МЭК 61107 поддерживают отправку широковещательных сообщений, если не указывать идентификатор устройства, или указать вместо него пустую строку. Это можно использовать, если на шине только одно устройство такого типа, и его адрес неизвестен. | Протоколы Меркурий 230, Энергомера ГОСТ МЭК 61107, НЕВА МТ 32х ГОСТ МЭК 61107 поддерживают отправку широковещательных сообщений, если не указывать идентификатор устройства, или указать вместо него пустую строку. Это можно использовать, если на шине только одно устройство такого типа, и его адрес неизвестен. | ||
| Строка 36: | Строка 44: | ||
=== Доработка драйвера для поддержки новых устройств === | === Доработка драйвера для поддержки новых устройств === | ||
Вы можете самостоятельно добавить поддержку новых устройств, которые работают по Modbus или по другим известным драйверу протоколам, при помощи [[ | Вы можете самостоятельно добавить поддержку новых устройств, которые работают по Modbus или по другим известным драйверу протоколам, при помощи [[Wb-mqtt-serial templates|шаблонов]]. | ||
Если у вас возникли проблемы с составлением шаблона или выбранное вами устройство имеет свой протокол обмена данными — [https://wirenboard.com/ru/pages/contacts свяжитесь с нами] и мы постараемся помочь. | Если у вас возникли проблемы с составлением шаблона или выбранное вами устройство имеет свой протокол обмена данными — [https://wirenboard.com/ru/pages/contacts свяжитесь с нами] и мы постараемся помочь. | ||
| Строка 56: | Строка 64: | ||
== Файл конфигурации драйвера == | == Файл конфигурации драйвера == | ||
[[Image: wb-mqtt-serial working diagram.png|500px|thumb|right| Диаграмма таймаутов цикла опроса]] | |||
Перед использованием драйвер нужно настроить. Конфигурация драйвера хранится в файле <code>/etc/wb-mqtt-serial.conf</code>. | Перед использованием драйвер нужно настроить. Конфигурация драйвера хранится в файле <code>/etc/wb-mqtt-serial.conf</code>. | ||