Работа с Modbus-устройствами Wiren Board без контроллера
This is the approved revision of this page, as well as being the most recent.

Аппаратная часть
Большинство устройств Wiren Board могут работать без управления контроллером, но для их настройки потребуется подключиться к ним по протоколу Modbus. Для этого вы можете использовать компьютер с ОС Windows или Linux и преобразователь интерфейса USB-RS-485, например, WB-USB485 .
Для начала работы надо клеммы A, B и GND устройства подключить к входам адаптера, подать на устройство питание и настроить программное обеспечение на компьютере.
Подготовка к работе
Перед настройкой устройства вам нужно знать:
- Modbus-адрес устройства.
- Коды функций чтения и записи регистров.
- Адреса регистров устройства.
Перечень общих для всех устройств Wiren Board регистров можно найти в таблице общих регистров. Полный список регистров для каждого устройства смотрите в документации к нему.
Программы для работы по протоколу Modbus

Рекомендуем:
- Веб-конфигуратор устройств Wiren Board — конфигуратор, доступный в формате веб-сайта;
- modbus_client — утилита для диагностики:
Альтернатива:
- Rilheva Modbus Poll — подойдёт для Windows. Она бесплатна, не требует установки, имеет понятный интерфейс и возможность сохранения настроек обмена и конфигурации регистров;
- утилиты Modbus Poll из комплекта Modbus Tools (программа платная, но с бесплатным пробным периодом в 30 дней) и termite (есть «Pro» и «Free» версии) в ОС Windows;
- wb-modbus-device-editor (более не поддерживается) — подойдет для упрощённой настройки, есть варианты для Windows и Linux. Её функционал весьма ограничен, она не позволяет просматривать значения регистров и не подходит для диагностики. На данный момент не работает с некоторыми устройствами: WB-MDM3, WB-MAO4, WB-MAI6, WB-LED, WB-MAP3ET.
Работа с Веб-конфигуратором устройств Wiren Board

Для настройки устройств Wiren Board без контроллера можно использовать конфигуратор, доступный в формате веб-сайта по адресу deveditor.wirenboard.com.
Для связи с устройствами понадобится преобразователь интерфейса USB-RS-485, например, WB-USB485.
Конфигуратор работает только в браузерах, которые поддерживают технологию Web Serial API: Google Chrome, Yandex Browser, Microsoft Edge и Opera.
Конфигуратор может работать с одним или несколькими устройствами, подключенными к одному порту. Для работы с регистрами устройств используются те же шаблоны, что и в драйвере wb-mqtt-serial.
Подробнее о работе с конфигуратором читайте на странице Веб-конфигуратор устройств Wiren Board.
Работа с программой modbus_client
Для работы с Modbus-устройством в ОС Linux и Windows также можно использовать консольную утилиту modbus_client. Где её взять, как установить и работать с ней, а также примеры использования смотрите в статье modbus_client.
Выбор порта
В ОС Windows узнать, к какому порту у вас подключен адаптер, можно в диспетчере устройств. Найдите в дереве тип устройств Порты (COM и LPT), разверните ветку и найдите в ней свой адаптер. Если устройство выделено восклицательным знаком — это значит, что драйвер не был установлен автоматически. Установите его вручную по инструкции производителя.
В ОС Linux порт можно узнать с помощью команды dmesg -wH, которую нужно запустить перед физическим подключением USB-адаптера. В диагностических сообщениях будет выведено сообщение об обнаружении адаптера и назначении ему порта:
[ +7,705022] usb 3-7: new full-speed USB device number 6 using xhci_hcd
[ +0,149142] usb 3-7: New USB device found, idVendor=1a86, idProduct=7523, bcdDevice= 2.62
[ +0,000014] usb 3-7: New USB device strings: Mfr=0, Product=2, SerialNumber=0
[ +0,000005] usb 3-7: Product: USB2.0-Serial
[ +0,001500] ch341 3-7:1.0: ch341-uart converter detected
[ +0,000549] usb 3-7: ch341-uart converter now attached to ttyUSB0
В данном примере был назначен порт /dev/ttyUSB0.
В интерфейсе программы Rilheva Modbus Poll для адаптера обычно нужно выбрать COM-порт с самым большим номером. Чтобы проверить правильность выбора порта в Linux, нужно в пользовательской директории со списком портов эмулятора wine (~/.wine/dosdevices) найти файл, который является символической ссылкой на реальный USB-порт, к которому подключен адаптер.
-
Определение номера COM-порта в диспетчере устройств ОС Windows
-
Определение номера COM-порта при работе через wine в ОС Linux
Работа с программой wb-modbus-device-editor (более не поддерживается)

В утилиту встроены шаблоны для различных устройств, поэтому всё, что вам нужно — это скачать файл с утилитой, установить её, настроить параметры подключения и выбрать нужный шаблон.
В Linux:
- Скачайте утилиту, выбрав нужную версию по ссылке.
- Установите deb-пакет с помощью пакетного менеджера.
В Windows:
- Скачайте архив с утилитой wb-modbus-device-editor-windows.zip, выбрав нужную версию по ссылке.
- Распакуйте архив в удобную папку. Запустите wb-modbus-device-editor.exe. Для удобства можно вывести ярлык на рабочий стол.