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.