Wiren-board-connection: различия между версиями

Текущая версия от 22:15, 2 октября 2026

Эта статья — полный маршрут подключения Wiren Board к XIOT. Она разделяет разные операции: питание и сеть контроллера, подключение физического оборудования, установку XIOT-PLC, привязку к проекту, настройку MQTT-драйвера и связывание физических адресов с виртуальными устройствами.

Результат: контроллер Wiren Board подготовлен, XIOT-PLC привязан к проекту, драйвер получает MQTT-топики, а физические устройства управляются из XIOT с обратной связью.

Что именно подключается

Этап	Что подключаем	Где выполняется	Результат
Питание и сеть	Контроллер Wiren Board	Электрощит и локальная сеть	Контроллер стабильно работает и доступен по IP-адресу
Физическое оборудование	Реле, датчики и другие модули	Клеммы и веб-интерфейс Wiren Board	Устройства видны и проверены в Wiren Board
XIOT-PLC	Программный сервер XIOT	Linux на Wiren Board или другом поддерживаемом хосте	Служба `xiot.service` запущена
Проект XIOT	XIOT-PLC и выбранный проект	Локальный интерфейс XIOT-PLC	В редакторе виден связанный XIOT-PLC
Драйвер Wiren Board	XIOT-PLC и MQTT-брокер Wiren Board	XIOT-EDITOR	Статус ПОДКЛЮЧЕН, получен список топиков
Устройства XIOT	Виртуальные характеристики и физические MQTT-адреса	XIOT-EDITOR	Команда выполняется, адрес состояния показывает обратную связь

1. Подготовьте питание и локальную сеть

Подключите питание по документации точной модели и ревизии Wiren Board.
Подключите контроллер к доверенной локальной сети и определите его IP-адрес.
Смените заводские пароли и не публикуйте веб-интерфейс, SSH и MQTT-порт в интернет.

Подробно: Базовая настройка Wiren Board. Для WB8 также доступна статья Первое включение контроллера Wiren Board 8.

Результат: Wiren Board стабильно включён и доступен в локальной сети.

2. Подключите и проверьте физическое оборудование

При снятом питании подключите модули, линии RS-485 и полевые устройства по проекту и документации производителя.
Настройте устройства в веб-интерфейсе Wiren Board.
Проверьте безопасную тестовую нагрузку и показания датчиков непосредственно в Wiren Board.

Не переходите к XIOT, пока физическое оборудование не работает в самом Wiren Board. Подробно: Базовая настройка Wiren Board.

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

Результат: нужные устройства и параметры видны в разделе Devices контроллера.

3. Установите XIOT-PLC

Установите пакет по инструкции Установка XIOT-PLC на контроллер. XIOT-PLC может работать на этом же Wiren Board или на другом поддерживаемом устройстве-хосте.

Результат: служба xiot.service имеет состояние active (running).

4. Привяжите XIOT-PLC к проекту

Выполните привязку XIOT-PLC к выбранному проекту. Локальный порт 5551 используйте только из доверенной локальной сети.

Результат: в проекте отображается XIOT-PLC и зелёный индикатор связи.

5. Настройте драйвер Wiren Board

Откройте отдельную инструкцию Настройка драйвера Wiren Board в XIOT. В ней задаются адрес MQTT-брокера, порт и реквизиты, затем проверяются статус ПОДКЛЮЧЕН и полученные топики.

Результат: XIOT-PLC получает физические адреса Wiren Board по MQTT.

6. Свяжите физические и виртуальные устройства

Создайте виртуальное устройство в нужной комнате проекта.
Назначьте характеристике адрес управления и адрес состояния из полученных MQTT-топиков.
Нажмите Загрузить конфигурацию на контроллер. Команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает.
Проверьте команду на безопасной тестовой нагрузке и фактическую обратную связь в XIOT-APP.

Подробно: Привязка реальных устройств к виртуальным. Минимальный сквозной пример: Первая лампа в XIOT.

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

Текущая архитектура

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

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

Проверяйте этапы по порядку. Если устройство не работает в веб-интерфейсе Wiren Board, исправьте питание, линию или конфигурацию оборудования. Если xiot.service не запущена, устраните ошибку установки. Если XIOT-PLC не привязан, не переходите к драйверу. Если драйвер не подключён, проверьте сеть, MQTT-порт и реквизиты, не открывая порт в интернет.

@@ Строка 1: / Строка 1: @@
-__NOTOC__
+{{DISPLAYTITLE:Подключение Wiren Board}}
+Эта статья — полный маршрут подключения Wiren Board к XIOT. Она разделяет разные операции: питание и сеть контроллера, подключение физического оборудования, установку XIOT-PLC, привязку к проекту, настройку MQTT-драйвера и связывание физических адресов с виртуальными устройствами.
-=  Подключение Wiren Board в XIOT =
+'''Результат:''' контроллер Wiren Board подготовлен, XIOT-PLC привязан к проекту, драйвер получает MQTT-топики, а физические устройства управляются из XIOT с обратной связью.
-'''Wiren Board''' — это промышленный контроллер, поддерживающий подключение расширений и работу с различными протоколами: Modbus, KNX, DALI, MQTT, 1-Wire и др. В системе XIOT контроллер используется как платформа для установки сервера XIOT-PLC и подключения физических устройств.
+== Что именно подключается ==
-== 📦 Что необходимо ==
+{| class="wikitable"
+! Этап
+! Что подключаем
+! Где выполняется
+! Результат
+|-
+| Питание и сеть
+| Контроллер Wiren Board
+| Электрощит и локальная сеть
+| Контроллер стабильно работает и доступен по IP-адресу
+|-
+| Физическое оборудование
+| Реле, датчики и другие модули
+| Клеммы и веб-интерфейс Wiren Board
+| Устройства видны и проверены в Wiren Board
+|-
+| XIOT-PLC
+| Программный сервер XIOT
+| Linux на Wiren Board или другом поддерживаемом хосте
+| Служба <code>xiot.service</code> запущена
+|-
+| Проект XIOT
+| XIOT-PLC и выбранный проект
+| Локальный интерфейс XIOT-PLC
+| В редакторе виден связанный XIOT-PLC
+|-
+| Драйвер Wiren Board
+| XIOT-PLC и MQTT-брокер Wiren Board
+| XIOT-EDITOR
+| Статус '''ПОДКЛЮЧЕН''', получен список топиков
+|-
+| Устройства XIOT
+| Виртуальные характеристики и физические MQTT-адреса
+| XIOT-EDITOR
+| Команда выполняется, адрес состояния показывает обратную связь
+|}
-Для интеграции контроллера Wiren Board с системой XIOT вам потребуется:
+== 1. Подготовьте питание и локальную сеть ==
-* '''Контроллер Wiren Board''' — рекомендуется использовать модели WB6, WB7 или WB8
+# Подключите питание по документации точной модели и ревизии Wiren Board.
-* '''Модуль WBE2-I-KNX''' — необходим для подключения к шине KNX (опционально, если используется KNX)
+# Подключите контроллер к доверенной локальной сети и определите его IP-адрес.
-* '''Настроенные модули расширения''' — реле, диммеры, датчики и другие устройства должны быть предварительно подключены и сконфигурированы в веб-интерфейсе Wiren Board
+# Смените заводские пароли и не публикуйте веб-интерфейс, SSH и MQTT-порт в интернет.
-* '''Программный сервер XIOT-PLC''', установленный на этом же контроллере или на другом устройстве
-* '''Настроенное подключение к Wiren Board в редакторе XIOT''' — укажите IP-адрес и порт MQTT-брокера (обычно `localhost`, порт `1883`), если XIOT-PLC работает на том же устройстве. При подключении к удалённому контроллеру укажите внешний IP-адрес
-== 🔌 Подключение контроллера ==
+Подробно: [[Wiren-board-basic-setup|Базовая настройка Wiren Board]]. Для WB8 также доступна статья [[Wiren-board-8-first-start|Первое включение контроллера Wiren Board 8]].
-. В редакторе XIOT откройте раздел '''Драйверы''' и перейдите на вкладку '''Wiren Board'''.
+'''Результат:''' Wiren Board стабильно включён и доступен в локальной сети.
-. Активируйте переключатель, чтобы включить подключение к контроллеру.
+== 2. Подключите и проверьте физическое оборудование ==
-. Вы можете настроить до 5 подключений одновременно — это позволяет подключить до пяти разных контроллеров Wiren Board в одном проекте.
+# При снятом питании подключите модули, линии RS-485 и полевые устройства по проекту и документации производителя.
+# Настройте устройства в веб-интерфейсе Wiren Board.
+# Проверьте безопасную тестовую нагрузку и показания датчиков непосредственно в Wiren Board.
-. Если XIOT-PLC установлен на том же контроллере Wiren Board, к которому вы настраиваете подключение, оставьте параметры подключения по умолчанию:
+Не переходите к XIOT, пока физическое оборудование не работает в самом Wiren Board. Подробно: [[Wiren-board-basic-setup|Базовая настройка Wiren Board]].
-   * IP-адрес: `localhost`
-   * Порт: `1883`
-. Если XIOT-PLC установлен на другом устройстве (например, Jet Home или отдельном сервере), укажите IP-адрес и порт нужного контроллера Wiren Board.
+Для кнопок и настенных выключателей используйте отдельную инструкцию [[Wiren-board-switch-wiring|Подключение кнопочных выключателей к Wiren Board]]: в ней разделены низковольтные входы «сухой контакт» и входы наличия напряжения разных модификаций модулей.
-. Поля '''логин''' и '''пароль''' по умолчанию пустые.
+'''Результат:''' нужные устройства и параметры видны в разделе Devices контроллера.
-   В стандартной конфигурации Wiren Board не требует авторизации для подключения к MQTT, поэтому в XIOT логин и пароль не заполняются.
-   Если вы вручную настраивали аутентификацию в MQTT в Wiren Board, укажите соответствующие данные.
-. Нажмите кнопку '''Загрузить конфигурацию''', чтобы передать параметры в XIOT-PLC и активировать подключение.
+== 3. Установите XIOT-PLC ==
-. После загрузки конфигурации вернитесь на вкладку '''Wiren Board''' и убедитесь, что статус подключения изменился на '''ПОДКЛЮЧЕН'''.
+Установите пакет по инструкции [[Xiot-plc-installation|Установка XIOT-PLC на контроллер]]. XIOT-PLC может работать на этом же Wiren Board или на другом поддерживаемом устройстве-хосте.
-. Нажмите кнопку '''Получить топики''' — система загрузит список всех устройств, доступных по MQTT.
+'''Результат:''' служба <code>xiot.service</code> имеет состояние <code>active (running)</code>.
-== 🔍 Что отображается ==
+== 4. Привяжите XIOT-PLC к проекту ==
-После подключения вы увидите список всех устройств, доступных через MQTT от контроллера Wiren Board. Эти устройства формируются на основе данных, опубликованных контроллером в MQTT структуре `/devices/*`.
+Выполните [[Connect-xiot-plc-to-editor|привязку XIOT-PLC к выбранному проекту]]. Локальный порт <code>5551</code> используйте только из доверенной локальной сети.
-Возможные типы устройств:
+'''Результат:''' в проекте отображается XIOT-PLC и зелёный индикатор связи.
-* '''Реле''' — например, WB-MR6CU, WB-MR6C
+== 5. Настройте драйвер Wiren Board ==
-* '''Диммеры''' — например, WB-MDM3, WB-LED
-* '''Датчики''' — например, WB-MSW-V3 (температура, влажность, CO₂, освещённость)
-* '''Счётчики''' — например, WB-MAP3E (электроэнергия, ток, напряжение)
-* '''Системные и внутренние сервисы''' — например, buzzer, network, встроенные GPIO
-Каждое устройство включает набор параметров, называемых '''тегами''':
+Откройте отдельную инструкцию [[Wiren-board-driver-setup|Настройка драйвера Wiren Board в XIOT]]. В ней задаются адрес MQTT-брокера, порт и реквизиты, затем проверяются статус '''ПОДКЛЮЧЕН''' и полученные топики.
-* Эти теги соответствуют MQTT-топикам в формате `/devices/имя_устройства/controls/имя_тега`
+'''Результат:''' XIOT-PLC получает физические адреса Wiren Board по MQTT.
-* Полный список вы также можете просматривать в веб-интерфейсе Wiren Board в разделе '''Устройства'''
-== 📲 Привязка устройств в XIOT ==
+== 6. Свяжите физические и виртуальные устройства ==
-. Добавьте виртуальное устройство (например, светильник, реле или датчик) в нужную комнату проекта.
+# Создайте виртуальное устройство в нужной комнате проекта.
+# Назначьте характеристике адрес управления и адрес состояния из полученных MQTT-топиков.
+# Нажмите '''Загрузить конфигурацию на контроллер'''. Команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает.
+# Проверьте команду на безопасной тестовой нагрузке и фактическую обратную связь в XIOT-APP.
-. Перейдите в его '''настройки''' и активируйте нужные характеристики в зависимости от функций устройства:
+Подробно: [[Device-bindings|Привязка реальных устройств к виртуальным]]. Минимальный сквозной пример: [[First-light-in-xiot|Первая лампа в XIOT]].
-   * '''включение''' — для включения/выключения
-   * '''яркость''' — для регулировки уровня света
-   * '''температура цвета''' — для настройки оттенка света (тёплый/холодный)
-   * '''цвет''' — для RGB-ламп и управления оттенками
-. Включённые характеристики определяют внешний вид устройства в приложении XIOT и позволяют использовать его в управлении помещением, даже без физической привязки.
+'''Результат:''' физическое устройство выполняет команду, а интерфейс показывает подтверждённое состояние.
-. Для привязки характеристик к физическим устройствам, укажите теги:
+== Текущая архитектура ==
-   * '''тег управления''' — используется для отправки команды (например, '''/wb/wb-mdm3_23/K1''')
-   * '''тег статуса''' — используется для получения обратной связи от устройства
-Для интеграции с '''Wiren Board''' тег управления и тег статуса, как правило, совпадают.
+* К одному проекту сейчас привязывается один XIOT-PLC (<code>plc1</code>).
-Это связано с тем, что Wiren Board использует один и тот же MQTT-топик как для отправки команды, так и для публикации текущего состояния.
+* Один XIOT-PLC поддерживает до шести отдельных MQTT-подключений Wiren Board.
-XIOT автоматически добавляет суффикс '''/on''' при передаче управляющего значения, если это требуется, а статус приходит обратно в тот же топик.
+* Это шесть подключений к оборудованию, а не шесть XIOT-PLC. Несколько XIOT-PLC в одном проекте пока находятся в разработке.
-В других интеграциях, например с '''KNX''', теги управления и статуса могут отличаться — в KNX часто используются разные групповые адреса для отправки команды и получения состояния.
+== Если не получилось ==
-. Обработка тега статуса зависит от галочки:
+Проверяйте этапы по порядку. Если устройство не работает в веб-интерфейсе Wiren Board, исправьте питание, линию или конфигурацию оборудования. Если <code>xiot.service</code> не запущена, устраните ошибку установки. Если XIOT-PLC не привязан, не переходите к драйверу. Если драйвер не подключён, проверьте сеть, MQTT-порт и реквизиты, не открывая порт в интернет.
-   * Если галочка у тега статуса '''не установлена''', характеристика изменится сразу после действия пользователя — до получения подтверждения от устройства.
-   * Если галочка '''установлена''', характеристика изменится только после получения значения из тега статуса. Это обеспечивает надёжную синхронизацию с физическим устройством и гарантирует, что оно действительно выполнило команду.
-. После настройки нажмите кнопку '''Загрузить конфигурацию''', чтобы сохранить изменения и передать их на контроллер.
+[[Категория:Документация XIOT]]
+[[Категория:Драйверы XIOT]]
-'''Пример:'''
+{{DEFAULTSORT:Подключение Wiren Board}}
-При включении лампы в приложении характеристика '''включение''' поменяется на 1.
-Если галочка у тега статуса '''не стоит''', лампа отобразится как включённая сразу.
-Если галочка '''установлена''', система дождётся подтверждения от контроллера через MQTT, прежде чем изменить состояние в интерфейсе.
-Это важно для случаев, когда требуется точная и подтверждённая работа с физическим оборудованием.
-== 🔄 Множественные подключения ==
-Если вы работаете с несколькими контроллерами, переключитесь на '''WB 2''', '''WB 3''' и т.д. и настройте подключение — поддерживается до 5 подключенных контроллеров Wiren Board.
-== 🧠 Автоматизация и сценарии ==
-Управление устройствами Wiren Board в системе XIOT осуществляется через виртуальные устройства.
-Сценарии воздействуют на виртуальные устройства, а те, в свою очередь, управляют физическими.
-Такая структура обеспечивает удобство, наглядность и гибкость конфигурации.
-Если физическое устройство (например, реле или диммер) вышло из строя или было заменено, достаточно привязать виртуальное устройство к новым тегам — даже если у нового устройства изменилась структура топиков или Modbus-адрес.
-При этом само виртуальное устройство остаётся на своём месте:
-* Не выпадает из сценариев
-* Сохраняет свою логику
-* Продолжает отображаться в структуре дома
-* Остаётся доступным в Яндекс Станции
-При необходимости можно обойтись без виртуальных устройств и взаимодействовать с физическими устройствами напрямую через кастомные сценарии.
-Вы можете:
-* Подписаться на изменение любого тега и выполнить действие
-* Записать значение в нужный MQTT-тег напрямую
-Это особенно полезно для работы с системными параметрами Wiren Board, например: температура контроллера, перезапуск, статус сети и другие.
-== 📝 Примечания ==
-* Если вы хотите добиться синхронизации между интерфейсом XIOT и физическим состоянием устройства — обязательно указывайте тег статуса и активируйте галочку слежения.
-* Драйвер XIOT для работы с Wiren Board использует стандартную структуру MQTT-топиков согласно официальной документации: [https://github.com/wirenboard/conventions](https://github.com/wirenboard/conventions)

Admin (обсуждение | вклад)