Подключение Wiren Board в XIOT

Wiren Board — это промышленный контроллер, поддерживающий подключение расширений и работу с различными протоколами: Modbus, KNX, DALI, MQTT, 1-Wire и др. В системе XIOT контроллер используется как платформа для установки сервера XIOT-PLC и подключения физических устройств.

📦 Что необходимо

Для интеграции контроллера Wiren Board с системой XIOT вам потребуется:

Контроллер Wiren Board — рекомендуется использовать модели WB6, WB7 или WB8
Модуль WBE2-I-KNX — необходим для подключения к шине KNX (опционально, если используется KNX)
Настроенные модули расширения — реле, диммеры, датчики и другие устройства должны быть предварительно подключены и сконфигурированы в веб-интерфейсе Wiren Board
Программный сервер XIOT-PLC, установленный на этом же контроллере или на другом устройстве
Настроенное подключение к Wiren Board в редакторе XIOT — укажите IP-адрес и порт MQTT-брокера (обычно `localhost`, порт `1883`), если XIOT-PLC работает на том же устройстве. При подключении к удалённому контроллеру укажите внешний IP-адрес

🔌 Подключение контроллера

1. В редакторе XIOT откройте раздел Драйверы и перейдите на вкладку Wiren Board.

2. Активируйте переключатель, чтобы включить подключение к контроллеру.

3. Вы можете настроить до 5 подключений одновременно — это позволяет подключить до пяти разных контроллеров Wiren Board в одном проекте.

4. Если XIOT-PLC установлен на том же контроллере Wiren Board, к которому вы настраиваете подключение, оставьте параметры подключения по умолчанию:

  IP-адрес: `localhost`
  Порт: `1883`

5. Если XIOT-PLC установлен на другом устройстве (например, Jet Home или отдельном сервере), укажите IP-адрес и порт нужного контроллера Wiren Board.

6. Поля логин и пароль по умолчанию пустые.

  В стандартной конфигурации Wiren Board не требует авторизации для подключения к MQTT, поэтому в XIOT логин и пароль не заполняются.  
  Если вы вручную настраивали аутентификацию в MQTT в Wiren Board, укажите соответствующие данные.

7. Нажмите кнопку Загрузить конфигурацию, чтобы передать параметры в XIOT-PLC и активировать подключение.

8. После загрузки конфигурации вернитесь на вкладку Wiren Board и убедитесь, что статус подключения изменился на ПОДКЛЮЧЕН.

9. Нажмите кнопку Получить топики — система загрузит список всех устройств, доступных по MQTT.

🔍 Что отображается

После подключения вы увидите список всех устройств, доступных через MQTT от контроллера Wiren Board. Эти устройства формируются на основе данных, опубликованных контроллером в MQTT структуре `/devices/*`.

Возможные типы устройств:

Реле — например, WB-MR6CU, WB-MR6C
Диммеры — например, WB-MDM3, WB-LED
Датчики — например, WB-MSW-V3 (температура, влажность, CO₂, освещённость)
Счётчики — например, WB-MAP3E (электроэнергия, ток, напряжение)
Системные и внутренние сервисы — например, buzzer, network, встроенные GPIO

Каждое устройство включает набор параметров, называемых тегами:

Эти теги соответствуют MQTT-топикам в формате `/devices/имя_устройства/controls/имя_тега`
Полный список вы также можете просматривать в веб-интерфейсе Wiren Board в разделе Устройства

📲 Привязка устройств в XIOT

1. Добавьте виртуальное устройство (например, светильник, реле или датчик) в нужную комнату проекта.

2. Перейдите в его настройки и активируйте нужные характеристики в зависимости от функций устройства:

  * включение — для включения/выключения
  * яркость — для регулировки уровня света
  * температура цвета — для настройки оттенка света (тёплый/холодный)
  * цвет — для RGB-ламп и управления оттенками

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

4. Для привязки характеристик к физическим устройствам, укажите теги:

  * тег управления — используется для отправки команды (например, /wb/wb-mdm3_23/K1)
  * тег статуса — используется для получения обратной связи от устройства

Для интеграции с Wiren Board тег управления и тег статуса, как правило, совпадают. Это связано с тем, что Wiren Board использует один и тот же MQTT-топик как для отправки команды, так и для публикации текущего состояния. XIOT автоматически добавляет суффикс /on при передаче управляющего значения, если это требуется, а статус приходит обратно в тот же топик.

В других интеграциях, например с KNX, теги управления и статуса могут отличаться — в KNX часто используются разные групповые адреса для отправки команды и получения состояния.

5. Обработка тега статуса зависит от галочки:

  * Если галочка у тега статуса не установлена, характеристика изменится сразу после действия пользователя — до получения подтверждения от устройства.
  * Если галочка установлена, характеристика изменится только после получения значения из тега статуса. Это обеспечивает надёжную синхронизацию с физическим устройством и гарантирует, что оно действительно выполнило команду.

6. После настройки нажмите кнопку Загрузить конфигурацию, чтобы сохранить изменения и передать их на контроллер.

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

Это важно для случаев, когда требуется точная и подтверждённая работа с физическим оборудованием.

🔄 Множественные подключения

Если вы работаете с несколькими контроллерами, переключитесь на WB 2, WB 3 и т.д. и настройте подключение — поддерживается до 5 подключенных контроллеров Wiren Board.

🧠 Автоматизация и сценарии

Управление устройствами Wiren Board в системе XIOT осуществляется через виртуальные устройства. Сценарии воздействуют на виртуальные устройства, а те, в свою очередь, управляют физическими. Такая структура обеспечивает удобство, наглядность и гибкость конфигурации.

Если физическое устройство (например, реле или диммер) вышло из строя или было заменено, достаточно привязать виртуальное устройство к новым тегам — даже если у нового устройства изменилась структура топиков или Modbus-адрес. При этом само виртуальное устройство остаётся на своём месте:

Не выпадает из сценариев
Сохраняет свою логику
Продолжает отображаться в структуре дома
Остаётся доступным в Яндекс Станции

При необходимости можно обойтись без виртуальных устройств и взаимодействовать с физическими устройствами напрямую через кастомные сценарии. Вы можете:

Подписаться на изменение любого тега и выполнить действие
Записать значение в нужный MQTT-тег напрямую

Это особенно полезно для работы с системными параметрами Wiren Board, например: температура контроллера, перезапуск, статус сети и другие.

📝 Примечания

Если вы хотите добиться синхронизации между интерфейсом XIOT и физическим состоянием устройства — обязательно указывайте тег статуса и активируйте галочку слежения.
Драйвер XIOT для работы с Wiren Board использует стандартную структуру MQTT-топиков согласно официальной документации: [1](https://github.com/wirenboard/conventions)

Подключение Wiren Board