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. Нажмите Загрузить конфигурацию на контроллер. Команда сама сохранит проект, создаст одну новую версию и передаст на привязанный XIOT-PLC точный снимок этой версии.

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

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

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

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

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

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

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

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

Эти адреса соответствуют MQTT-топикам Wiren Board в формате /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. Нажмите Загрузить конфигурацию на контроллер, дождитесь завершения загрузки и проверьте подключение. Команда сама сохранит проект, создаст одну новую версию и передаст на XIOT-PLC точный снимок этой версии.

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

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

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

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

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

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

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

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

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

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

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

📝 Примечания

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