Wiren-board-connection

Wiren Board — промышленный контроллер, который может использоваться как платформа для XIOT-PLC и как источник данных физических устройств через MQTT. XIOT поддерживает Wiren Board 6, 7, 8 и 9.

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

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

Контроллер Wiren Board 6, 7, 8 или 9
Модуль WBE2-I-KNX — необходим для подключения к шине KNX (опционально, если используется KNX)
Настроенные модули расширения — реле, диммеры, датчики и другие устройства должны быть предварительно подключены и сконфигурированы в веб-интерфейсе Wiren Board
Программный сервер XIOT-PLC, установленный на этом же контроллере или на другом устройстве
Настроенное подключение к Wiren Board в XIOT-EDITOR — укажите адрес и порт MQTT-брокера. Если XIOT-PLC работает на том же устройстве, обычно используются localhost и порт 1883. Для другого контроллера используйте его адрес в доверенной локальной или защищённой частной сети; не публикуйте MQTT-порт в интернет

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

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

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

3. Можно настроить до шести отдельных MQTT-подключений Wiren Board. Все они обслуживаются одним XIOT-PLC, привязанным к проекту.

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

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

5. Если XIOT-PLC установлен на другом устройстве (например, JetHome или отдельном сервере), укажите локальный IP-адрес или имя нужного контроллера Wiren Board и порт его MQTT-брокера. Межсетевой доступ организуйте через защищённую частную сеть.

6. Заполните поля логин и пароль в соответствии с настройками MQTT-брокера. Если брокер намеренно настроен без аутентификации, оставляйте поля пустыми только в изолированной доверенной локальной сети.

7. Нажмите Сохранить проект и убедитесь, что новая версия появилась в списке сохранений.

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

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

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

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

После подключения вы увидите список устройств, доступных через MQTT от контроллера Wiren Board. Они формируются на основе данных, опубликованных контроллером в структуре /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. Нажмите Сохранить проект и убедитесь, что новая версия появилась в списке сохранений.

7. Нажмите Загрузить конфигурацию на контроллер, дождитесь завершения загрузки и проверьте подключение. Сохранение проекта и загрузка конфигурации — разные действия.

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

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

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

Если вы работаете с несколькими устройствами Wiren Board, переключайтесь между вкладками WB-подключений и настраивайте каждое отдельно. Поддерживается до шести MQTT-подключений Wiren Board. Это не несколько XIOT-PLC: в текущей версии у проекта один PLC-слот (plc1). Возможность нескольких XIOT-PLC в одном проекте пока находится в разработке.

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

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

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

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

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

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

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

📝 Примечания

Если вы хотите добиться синхронизации между интерфейсом XIOT и физическим состоянием устройства — обязательно указывайте тег статуса и активируйте галочку слежения.
Драйвер XIOT для работы с Wiren Board использует структуру MQTT-топиков Wiren Board; см. официальное описание conventions.