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

Версия от 07:41, 29 августа 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.

Результат: нужные устройства и параметры видны в разделе 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 точный снимок этой версии.
Проверьте команду на безопасной тестовой нагрузке и фактическую обратную связь в XIOT-APP.

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

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

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

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

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

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

@@ Строка 1: / Строка 1: @@
-'''Wiren Board''' — промышленный контроллер, который может использоваться как платформа для XIOT-PLC и как источник данных физических устройств через MQTT. XIOT поддерживает Wiren Board 6, 7, 8 и 9.
+Эта статья — полный маршрут подключения Wiren Board к XIOT. Она разделяет разные операции: питание и сеть контроллера, подключение физического оборудования, установку XIOT-PLC, привязку к проекту, настройку MQTT-драйвера и связывание физических адресов с виртуальными устройствами.
-== 📦 Что необходимо ==
+'''Результат:''' контроллер Wiren Board подготовлен, XIOT-PLC привязан к проекту, драйвер получает MQTT-топики, а физические устройства управляются из XIOT с обратной связью.
-Для интеграции контроллера Wiren Board с системой XIOT вам потребуется:
+== Что именно подключается ==
-* '''Контроллер Wiren Board 6, 7, 8 или 9'''
+{| class="wikitable"
-* '''Модуль WBE2-I-KNX''' — необходим для подключения к шине KNX (опционально, если используется KNX)
+! Этап
-* '''Настроенные модули расширения''' — реле, диммеры, датчики и другие устройства должны быть предварительно подключены и сконфигурированы в веб-интерфейсе Wiren Board
+! Что подключаем
-* '''Программный сервер XIOT-PLC''', установленный на этом же контроллере или на другом устройстве
+! Где выполняется
-* '''Настроенное подключение к Wiren Board в XIOT-EDITOR''' — укажите адрес и порт MQTT-брокера. Если XIOT-PLC работает на том же устройстве, обычно используются <code>localhost</code> и порт <code>1883</code>. Для другого контроллера используйте его адрес в доверенной локальной или защищённой частной сети; не публикуйте MQTT-порт в интернет
+! Результат
+|-
+| Питание и сеть
+| Контроллер 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
+| Команда выполняется, адрес состояния показывает обратную связь
+|}
-== 🔌 Подключение контроллера ==
+== 1. Подготовьте питание и локальную сеть ==
-. В редакторе XIOT откройте раздел '''Драйверы''' и перейдите на вкладку '''Wiren Board'''.
+# Подключите питание по документации точной модели и ревизии Wiren Board.
+# Подключите контроллер к доверенной локальной сети и определите его IP-адрес.
+# Смените заводские пароли и не публикуйте веб-интерфейс, SSH и MQTT-порт в интернет.
-. Активируйте переключатель, чтобы включить подключение к контроллеру.
+Подробно: [[Базовая настройка Wiren Board]]. Для WB8 также доступна статья [[Первое включение контроллера Wiren Board 8]].
-. Можно настроить до '''шести''' отдельных MQTT-подключений Wiren Board. Все они обслуживаются одним XIOT-PLC, привязанным к проекту.
+'''Результат:''' Wiren Board стабильно включён и доступен в локальной сети.
-. Если XIOT-PLC установлен на том же контроллере Wiren Board, к которому вы настраиваете подключение, оставьте параметры подключения по умолчанию:
+== 2. Подключите и проверьте физическое оборудование ==
-* IP-адрес: <code>localhost</code>
-* Порт: <code>1883</code>
-. Если XIOT-PLC установлен на другом устройстве (например, JetHome или отдельном сервере), укажите локальный IP-адрес или имя нужного контроллера Wiren Board и порт его MQTT-брокера. Межсетевой доступ организуйте через защищённую частную сеть.
+# При снятом питании подключите модули, линии RS-485 и полевые устройства по проекту и документации производителя.
+# Настройте устройства в веб-интерфейсе Wiren Board.
+# Проверьте безопасную тестовую нагрузку и показания датчиков непосредственно в Wiren Board.
-. Заполните поля '''логин''' и '''пароль''' в соответствии с настройками MQTT-брокера. Если брокер намеренно настроен без аутентификации, оставляйте поля пустыми только в изолированной доверенной локальной сети.
+Не переходите к XIOT, пока физическое оборудование не работает в самом Wiren Board. Подробно: [[Базовая настройка Wiren Board]].
-. Нажмите '''Загрузить конфигурацию на контроллер'''. Команда сама сохранит проект, создаст одну новую версию и передаст на привязанный XIOT-PLC точный снимок этой версии.
+'''Результат:''' нужные устройства и параметры видны в разделе Devices контроллера.
-. После загрузки конфигурации вернитесь на вкладку '''Wiren Board''' и проверьте статус подключения. При корректной связи отображается статус '''ПОДКЛЮЧЕН'''.
+== 3. Установите XIOT-PLC ==
-. Нажмите кнопку '''Получить топики''' — система загрузит список всех устройств, доступных по MQTT.
+Установите пакет по инструкции [[Установка XIOT-PLC на контроллер]]. XIOT-PLC может работать на этом же Wiren Board или на другом поддерживаемом устройстве-хосте.
-Отдельная команда '''Сохранить проект''' нужна только для самостоятельной контрольной точки или передачи версии через облако. Не выполняйте её непосредственно перед загрузкой без отдельной причины, иначе появятся две версии.
+'''Результат:''' служба <code>xiot.service</code> имеет состояние <code>active (running)</code>.
-== 🔍 Что отображается ==
+== 4. Привяжите XIOT-PLC к проекту ==
-После подключения вы увидите список устройств, доступных через MQTT от контроллера Wiren Board. Они формируются на основе данных, опубликованных контроллером в структуре <code>/devices/*</code>.
+Выполните [[Связываем XIOT-PLC с редактором XIOT|привязку 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
-Каждое устройство включает набор физических параметров, доступных в XIOT как адреса управления и состояния:
+Откройте отдельную инструкцию [[Настройка драйвера Wiren Board в XIOT]]. В ней задаются адрес MQTT-брокера, порт и реквизиты, затем проверяются статус '''ПОДКЛЮЧЕН''' и полученные топики.
-* Эти адреса соответствуют MQTT-топикам Wiren Board в формате <code>/devices/имя_устройства/controls/имя_параметра</code>
+'''Результат:''' XIOT-PLC получает физические адреса Wiren Board по MQTT.
-* Полный список вы также можете просматривать в веб-интерфейсе Wiren Board в разделе '''Устройства'''
-== 📲 Привязка устройств в XIOT ==
+== 6. Свяжите физические и виртуальные устройства ==
-. Добавьте виртуальное устройство (например, светильник, реле или датчик) в нужную комнату проекта.
+# Создайте виртуальное устройство в нужной комнате проекта.
+# Назначьте характеристике адрес управления и адрес состояния из полученных MQTT-топиков.
+# Нажмите '''Загрузить конфигурацию на контроллер'''. Команда сама сохранит проект, создаст одну новую версию и передаст на XIOT-PLC точный снимок этой версии.
+# Проверьте команду на безопасной тестовой нагрузке и фактическую обратную связь в XIOT-APP.
-. Перейдите в его '''настройки''' и активируйте нужные характеристики в зависимости от функций устройства:
+Подробно: [[Привязка реальных устройств к виртуальным]]. Минимальный сквозной пример: [[Первая лампа в 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-PLC точный снимок этой версии.
+[[Категория:Документация XIOT]]
+[[Категория:Драйверы XIOT]]
-'''Пример:'''
-При включении лампы в приложении характеристика '''включение''' поменяется на 1.
-Если галочка у адреса состояния '''не стоит''', лампа отобразится как включённая сразу.
-Если галочка '''установлена''', система дождётся подтверждения от контроллера через MQTT, прежде чем изменить состояние в интерфейсе.
-Это важно для случаев, когда требуется точная и подтверждённая работа с физическим оборудованием.
-== 🔄 Множественные подключения ==
-Если вы работаете с несколькими устройствами Wiren Board, переключайтесь между вкладками WB-подключений и настраивайте каждое отдельно. Поддерживается до шести MQTT-подключений Wiren Board. Это не несколько XIOT-PLC: в текущей версии у проекта один PLC-слот (<code>plc1</code>). Возможность нескольких XIOT-PLC в одном проекте пока находится в разработке.
-== 🧠 Автоматизация и сценарии ==
-Управление устройствами Wiren Board в системе XIOT осуществляется через виртуальные устройства.
-Сценарии воздействуют на виртуальные устройства, а те, в свою очередь, управляют физическими.
-Такая структура обеспечивает удобство, наглядность и гибкость конфигурации.
-Если физическое устройство (например, реле или диммер) вышло из строя или было заменено, привяжите виртуальное устройство к новым адресам — даже если у нового устройства изменилась структура топиков или Modbus-адрес. Затем нажмите '''Загрузить конфигурацию на контроллер''': команда сама сохранит проект, создаст одну новую версию и передаст на XIOT-PLC точный снимок этой версии. После загрузки проверьте устройство.
-При этом само виртуальное устройство остаётся на своём месте:
-* Не выпадает из сценариев
-* Сохраняет свою логику
-* Продолжает отображаться в структуре дома
-* Остаётся доступным в Яндекс Станции
-При необходимости можно обойтись без виртуальных устройств и взаимодействовать с физическими устройствами напрямую через кастомные сценарии.
-Вы можете:
-* Подписаться на изменение любого физического адреса и выполнить действие
-* Записать значение в нужный MQTT-топик напрямую
-Это особенно полезно для работы с системными параметрами Wiren Board, например: температура контроллера, перезапуск, статус сети и другие.
-== 📝 Примечания ==
-* Если интерфейс должен ожидать подтверждённое физическое состояние устройства, укажите адрес состояния и активируйте галочку ожидания обратной связи. Само наличие только адреса состояния не делает характеристику безопасной для управления: возможность команды определяется типом характеристики, правами и наличием адреса управления.
-* Драйвер XIOT для работы с Wiren Board использует структуру MQTT-топиков Wiren Board; см. [https://github.com/wirenboard/conventions официальное описание conventions].

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