Custom-wiren-board-device-templates

Статья описывает пользовательские JSON-шаблоны для системной службы Wiren Board wb-mqtt-serial. Эта служба производителя не является драйвером XIOT: драйвер XIOT — отдельный интеграционный модуль XIOT-PLC. Если вы настраиваете модуль XIOT, начните со статьи Настройка драйверов.

Готовый файл шаблона с расширением .json скопируйте на контроллер в каталог:

/etc/wb-mqtt-serial.conf.d/templates/

Не копируйте пользовательский файл в /usr/share/wb-mqtt-serial/templates/. Там находятся штатные шаблоны, которые могут быть заменены при обновлении программного обеспечения контроллера.

Перед началом

Подготовьте:

• готовый файл шаблона с расширением .json, например config-soil-multi-sensor-v2.2.json;
• IP-адрес контроллера;
• имя пользователя root и пароль контроллера;
• параметры связи устройства: Modbus-адрес, скорость, чётность, число бит данных и стоп-битов.

Для подключения к файлам контроллера используется SFTP, порт 22.

Подключайтесь по SFTP или SSH только из локальной либо другой доверенной сети. Не публикуйте порт 22 контроллера в интернет и не передавайте пароль root посторонним.

Шаг 1. Скопируйте файл через SFTP

1. Откройте программу для работы с SFTP:
   • Windows — WinSCP;
   • macOS — Cyberduck;
   • Linux — файловый менеджер с поддержкой адресов вида sftp://IP-КОНТРОЛЛЕРА.
2. Создайте подключение со следующими параметрами:
   • протокол — SFTP;
   • сервер — IP-адрес контроллера;
   • порт — 22;
   • пользователь — root;
   • пароль — пароль контроллера.
3. После подключения откройте на контроллере каталог:

/etc/wb-mqtt-serial.conf.d/templates/

1. Если каталога templates нет, создайте его.
2. Если файл с таким именем уже существует, сначала скачайте его на компьютер как резервную копию.
3. Перетащите новый файл .json в открытый каталог контроллера. При обновлении шаблона подтвердите замену существующего файла.

Ожидаемый результат: файл, например config-soil-multi-sensor-v2.2.json, виден в каталоге /etc/wb-mqtt-serial.conf.d/templates/.

Обычно перезапуск служб после копирования не требуется. Если страница настройки устройств уже была открыта, обновите её.

Копирование из командной строки

Этот способ необязателен. На macOS или Linux тот же файл можно скопировать командой scp. Замените IP-адрес своим:

scp config-soil-multi-sensor-v2.2.json root@192.168.1.10:/etc/wb-mqtt-serial.conf.d/templates/

Если каталога ещё нет, сначала создайте его:

ssh root@192.168.1.10 "mkdir -p /etc/wb-mqtt-serial.conf.d/templates"

Шаг 2. Добавьте устройство в веб-интерфейсе

1. Откройте веб-интерфейс контроллера Wiren Board.
2. Перейдите: Настройки → Конфигурационные файлы → Настройка драйвера Serial-устройств.
3. Нажмите Добавить любые устройства вручную.
4. Выберите порт, к которому подключён датчик.
5. В поле Тип устройства выберите загруженный шаблон. В актуальном интерфейсе пользовательский шаблон отмечен как Пользовательский.
6. Нажмите Добавить.
7. Откройте добавленное устройство и укажите Адрес устройства — Modbus Slave ID из документации или настроек датчика.
8. Нажмите Сохранить настройки.

Если нужный порт ещё не настроен, выберите его слева, включите порт и задайте скорость, чётность, число бит данных и стоп-битов точно как в документации устройства. Затем сохраните настройки.

Если устройство уже было добавлено раньше и вы только заменили файл шаблона, повторно добавлять устройство не нужно. Откройте его настройки и нажмите Сохранить настройки, чтобы применить новую версию шаблона к опросу.

Шаг 3. Проверьте устройство

1. Откройте раздел Устройства веб-интерфейса.
2. Найдите добавленное устройство.
3. Убедитесь, что появились каналы из шаблона и значения обновляются.
4. Подождите один-два цикла опроса.

Ожидаемый результат: устройство отображается в интерфейсе, его включённые каналы получают значения без ошибок связи.

Если не получилось

• Шаблона нет в списке. Проверьте, что файл находится именно в /etc/wb-mqtt-serial.conf.d/templates/, его имя заканчивается на .json, затем обновите страницу настройки устройств.
• В журнале есть ошибка шаблона. Откройте Настройки → Системный журнал, выберите сервис wb-mqtt-serial.service, тип сообщений error и нажмите Загрузить. В сообщении будет указана строка файла с ошибкой.
• Устройство есть, но значений нет. Проверьте адрес устройства, параметры порта и подключение RS-485. Они должны совпадать с настройками датчика.
• Часть каналов отсутствует. Откройте настройки устройства, включите нужные каналы шаблона и снова нажмите Сохранить настройки.
• Новый файл заменён, но изменения не применились. Откройте уже добавленное устройство и повторно сохраните настройки.

На старом программном обеспечении контроллера, если шаблон не появился после обновления страницы и сохранения настроек, можно один раз перезапустить драйвер:

systemctl restart wb-mqtt-serial

Для актуальной версии это запасной, а не обязательный шаг. Перезапуск wb-mqtt-confed не требуется.

Как обновить шаблон

1. Скачайте установленный файл на компьютер как резервную копию.
2. Скопируйте новый файл в /etc/wb-mqtt-serial.conf.d/templates/ с заменой старого.
3. Откройте устройство в Настройке драйвера Serial-устройств и нажмите Сохранить настройки.
4. Проверьте устройство и его каналы в разделе Устройства.

Следующий шаг и связанные статьи

• Шаблон Wiren Board Ensystec Leak Protect для XIOT — пример готового пользовательского шаблона.
• Подключение Ensystec в XIOT через Wirenboard — пример его использования в XIOT.

Источники

• Как подключать сторонние Modbus-устройства — Wiren Board
• Просмотр и копирование файлов контроллера с компьютера — Wiren Board
• Настройка устройств RS-485 через веб-интерфейс — Wiren Board
• Описание и пользовательские шаблоны wb-mqtt-serial — GitHub Wiren Board