Версия от 16:34, 9 июня 2026

Подключение Ensystec в XIOT через Wirenboard

Статья описывает подключение системы защиты от протечки Ensystec Leak Protect в проекте XIOT через контроллер Wiren Board. Материал основан на реальном объекте, где защита воды разделена на несколько независимых зон.

Щит защиты от протечки с 4 контроллерами Ensystec

На объекте установлен отдельный щит защиты от протечки с четырьмя контроллерами Ensystec Leak Protect. Каждый контроллер обслуживает свою зону воды и управляет своими кранами перекрытия.

Контроллер	Маркировка в щите	Зона защиты	Логика перекрытия
1	Б-1	Котельная и главный ввод воды	Перекрывает главный ввод воды при протечке в котельной, в месте ввода воды и в коллекторах водоснабжения.
2	Б-2	Санузел и кухня цокольного этажа	Перекрывает воду локально в зоне санузла и кухни цокольного этажа.
3	Б-3	Санузел 1 на первом этаже	Перекрывает воду локально в зоне первого санузла на первом этаже.
4	Б-4	Санузел 2 на первом этаже и мастер-санузел на втором этаже	Перекрывает воду локально в зоне второго санузла на первом этаже и мастер-санузла на втором этаже.

Такое разделение делает защиту более гибкой: при протечке или неисправности в одной зоне можно перекрыть только проблемный участок и не оставлять весь дом без воды на время ремонта или устранения аварии.

Общий вид щита защиты от протечки
Клеммная часть и кабельная коммутация
Подключение одного из контроллеров Ensystec

Подключение Ensystec в Wiren Board и изменение Modbus-адресов

Контроллеры Ensystec по умолчанию имеют Modbus-адрес 247. Если подключить к одной RS-485 линии несколько новых контроллеров с одинаковым адресом, Wiren Board не сможет корректно обращаться к ним по Modbus. Поэтому контроллеры подключаются и адресуются последовательно.

Порядок пусконаладки:

Подключить к RS-485 линии только один контроллер Ensystec с заводским адресом 247.
Через SSH-консоль Wiren Board изменить его Modbus-адрес. Подробная команда приведена в статье Смена Modbus адреса Ensystec через консоль Wiren Board.
Добавить следующий контроллер Ensystec с заводским адресом 247.
Назначить ему следующий свободный адрес.
Повторить процедуру для всех контроллеров.

На объекте использованы адреса 11, 12, 13 и 14.

Адрес Modbus	Контроллер	Название в Wiren Board	Зона
`11`	Б-1	Котельная ввод воды	Котельная, главный ввод воды и коллекторы водоснабжения
`12`	Б-2	Санузел и кухня цоколь	Санузел и кухня цокольного этажа
`13`	Б-3	Санузел 1	Санузел 1 на первом этаже
`14`	Б-4	Санузел 2 и мастер-санузел	Санузел 2 на первом этаже и мастер-санузел на втором этаже

Кастомный шаблон Wiren Board для XIOT

Для интеграции Ensystec с XIOT используется кастомный шаблон Wiren Board: Шаблон Wiren Board Ensystec Leak Protect для XIOT. Шаблон нужен как слой согласования между регистрами Ensystec, контролами Wiren Board и характеристиками XIOT.

Файл шаблона для скачивания:

Config-ensystec.xiot-final.json

Скачать файл: Config-ensystec.xiot-final.json

Штатный шаблон Wiren Board показывает основные состояния устройства и умеет отправлять низкоуровневые команды. Для XIOT нужны раздельные контролы состояния и управления, чтобы не привязывать характеристики напрямую к битовым командам Ensystec.

Кастомный шаблон оставляет штатные контролы Ensystec, но добавляет пары «статус + управление» для XIOT. В XIOT-EDITOR интегратор раскрывает устройство Ensystec в списке контролов драйвера WirenBoard и выбирает нужные контролы из списка, без ручного ввода адресов.

Назначение в XIOT	Контрол состояния в списке устройства	Контрол управления в списке устройства
Флаг протечки	Обнаружена протечка	Сброс протечки
Защита от протечки	Статус защиты от протечки	Управление защитой от протечки
Кран N	Кран N статус	Кран N
Диагностика крана N	Кран N состояние	—

Перед добавлением контроллеров Ensystec в веб-интерфейсе Wiren Board установите кастомный шаблон в пользовательскую директорию шаблонов:

/etc/wb-mqtt-serial.conf.d/templates/config-ensystec.json

Общая инструкция вынесена в отдельную статью: Пользовательские шаблоны устройств Wiren Board.

После назначения адресов контроллеры добавляются в веб-интерфейсе Wiren Board: Устройства → нужный порт RS-485 → Добавить любые устройства вручную. В списке выбирается шаблон Ensystec - защита от протечки, затем указывается адрес устройства и понятное название зоны.

В этом проекте все четыре контроллера добавлены на порт RS485-2 с адресами 11, 12, 13 и 14. Для первого контроллера указано название Котельная ввод воды.

После сохранения настроек в Wiren Board контроллер появляется отдельной карточкой устройства. В карточке видны статусы внешнего питания, заряда, протечки, обрыва датчика, входов, кранов и версии контроллера.

Для локальных зон используется по три крана:

холодная вода;
горячая вода;
циркуляция горячей воды с полотенцесушителем.

Для главного ввода установлен один кран на холодную воду. Горячая вода подготавливается в котельной через бойлер косвенного нагрева; при перекрытии холодной воды давление на контуре горячего водоснабжения также пропадает.

Получение контролов Wiren Board в XIOT

После добавления контроллеров Ensystec в веб-интерфейсе Wiren Board их нужно загрузить в XIOT-EDITOR. XIOT получает список устройств и контролов из драйвера WirenBoard, после чего интегратор связывает выбранные контролы с виртуальными устройствами проекта.

В XIOT-EDITOR откройте раздел Драйверы и выберите драйвер WirenBoard. Если XIOT-PLC установлен на том же контроллере Wiren Board, используются параметры:

Параметр	Значение
IP	`localhost`
Порт MQTT	`1883`
Логин и пароль	не заполняются, если MQTT-брокер Wiren Board работает без авторизации

Включите драйвер и загрузите список устройств и контролов. Во время загрузки отображается процесс опроса структуры Wiren Board.

После успешного подключения в правой части панели появляется статус Подключен, а ниже отображается список полученных устройств и групп.

Для этого проекта из Wiren Board получены зоны Ensystec:

Котельная ввод воды;
Цоколь - санузел;
1 этаж - санузел 1;
1 этаж санузел 2 + 2 этаж мастер санузел.

При раскрытии зоны видны контролы контроллера Ensystec: питание, заряд, протечка, обрыв датчика, входы, краны и статусы кранов. Для привязки защиты воды используйте контролы из таблицы выше.

На этом этапе важно получить полный список контролов от Wiren Board и убедиться, что нужные зоны Ensystec присутствуют в XIOT. Привязка контролов к виртуальным устройствам XIOT выполняется следующим этапом.

См. также

@@ Строка 58: / Строка 58: @@
 == Кастомный шаблон Wiren Board для XIOT ==
-Для интеграции Ensystec с XIOT используется кастомный шаблон Wiren Board: [[Шаблон Wiren Board Ensystec Leak Protect для XIOT]]. Шаблон нужен как слой согласования между регистрами Ensystec, MQTT-топиками Wiren Board и характеристиками XIOT.
+Для интеграции Ensystec с XIOT используется кастомный шаблон Wiren Board: [[Шаблон Wiren Board Ensystec Leak Protect для XIOT]]. Шаблон нужен как слой согласования между регистрами Ensystec, контролами Wiren Board и характеристиками XIOT.
 Файл шаблона для скачивания:
@@ Строка 68: / Строка 68: @@
 Скачать файл: [[Медиа:Config-ensystec.xiot-final.json|Config-ensystec.xiot-final.json]]
-Штатный шаблон Wiren Board показывает основные состояния устройства и умеет отправлять низкоуровневые команды. Для XIOT нужны раздельные теги состояния и управления, чтобы не привязывать характеристики напрямую к битовым командам Ensystec.
+Штатный шаблон Wiren Board показывает основные состояния устройства и умеет отправлять низкоуровневые команды. Для XIOT нужны раздельные контролы состояния и управления, чтобы не привязывать характеристики напрямую к битовым командам Ensystec.
-Кастомный шаблон оставляет штатные контролы Ensystec, но добавляет пары «статус + управление» для XIOT:
+Кастомный шаблон оставляет штатные контролы Ensystec, но добавляет пары «статус + управление» для XIOT. В XIOT-EDITOR интегратор раскрывает устройство Ensystec в списке контролов драйвера WirenBoard и выбирает нужные контролы из списка, без ручного ввода адресов.
 {| class="wikitable"
-! Назначение в XIOT !! Тег состояния !! Тег управления
+! Назначение в XIOT !! Контрол состояния в списке устройства !! Контрол управления в списке устройства
 |-
-| Флаг протечки || <code>/wb/ensystec_leak_protect_XX/leakage_sensor</code> || <code>/wb/ensystec_leak_protect_XX/leakage_sensor_control</code>
+| Флаг протечки || '''Обнаружена протечка''' || '''Сброс протечки'''
 |-
-| Защита от протечки || <code>/wb/ensystec_leak_protect_XX/leak_protection_enabled</code> || <code>/wb/ensystec_leak_protect_XX/leak_protection_control</code>
+| Защита от протечки || '''Статус защиты от протечки''' || '''Управление защитой от протечки'''
 |-
-| Кран N || <code>/wb/ensystec_leak_protect_XX/output_kN_status_switch</code> || <code>/wb/ensystec_leak_protect_XX/output_kN</code>
+| Кран N || '''Кран N статус''' || '''Кран N'''
+|-
+| Диагностика крана N || '''Кран N состояние''' || —
 |}
-В названиях топиков <code>XX</code> нужно заменить на Modbus-адрес контроллера Ensystec.
 Перед добавлением контроллеров Ensystec в веб-интерфейсе Wiren Board установите кастомный шаблон в пользовательскую директорию шаблонов:
@@ Строка 110: / Строка 110: @@
 Для главного ввода установлен один кран на холодную воду. Горячая вода подготавливается в котельной через бойлер косвенного нагрева; при перекрытии холодной воды давление на контуре горячего водоснабжения также пропадает.
-== Получение MQTT-топиков из Wiren Board в XIOT ==
+== Получение контролов Wiren Board в XIOT ==
-После добавления контроллеров Ensystec в веб-интерфейсе Wiren Board их MQTT-топики нужно загрузить в XIOT-EDITOR. Через эти топики XIOT получает состояния физических устройств и дальше связывает их с виртуальными устройствами проекта.
+После добавления контроллеров Ensystec в веб-интерфейсе Wiren Board их нужно загрузить в XIOT-EDITOR. XIOT получает список устройств и контролов из драйвера WirenBoard, после чего интегратор связывает выбранные контролы с виртуальными устройствами проекта.
 В XIOT-EDITOR откройте раздел '''Драйверы''' и выберите драйвер '''WirenBoard'''. Если XIOT-PLC установлен на том же контроллере Wiren Board, используются параметры:
@@ Строка 126: / Строка 126: @@
 |}
-Включите драйвер и нажмите '''Получить топики'''. Во время загрузки отображается процесс опроса MQTT-структуры Wiren Board.
+Включите драйвер и загрузите список устройств и контролов. Во время загрузки отображается процесс опроса структуры Wiren Board.
-[[Файл:XIOT Wiren Board получение топиков.jpg|центр|900px|Получение MQTT-топиков Wiren Board в XIOT-EDITOR]]
+[[Файл:XIOT Wiren Board получение топиков.jpg|центр|900px|Получение списка устройств и контролов Wiren Board в XIOT-EDITOR]]
 После успешного подключения в правой части панели появляется статус '''Подключен''', а ниже отображается список полученных устройств и групп.
-[[Файл:XIOT Wiren Board полученные топики Ensystec.jpg|центр|900px|Полученные MQTT-топики Wiren Board в XIOT-EDITOR]]
+[[Файл:XIOT Wiren Board полученные топики Ensystec.jpg|центр|900px|Полученные устройства и контролы Wiren Board в XIOT-EDITOR]]
 Для этого проекта из Wiren Board получены зоны Ensystec:
@@ Строка 143: / Строка 143: @@
 [[Файл:XIOT список зон Ensystec.jpg|центр|900px|Список зон Ensystec, полученных из Wiren Board]]
-При раскрытии зоны видны отдельные MQTT-топики контроллера Ensystec. Например, для зоны '''1 этаж - санузел 1''' доступны топики внешнего питания, низкого заряда, протечки, обрыва датчика и входов контроллера.
+При раскрытии зоны видны контролы контроллера Ensystec: питание, заряд, протечка, обрыв датчика, входы, краны и статусы кранов. Для привязки защиты воды используйте контролы из таблицы выше.
-[[Файл:XIOT топики Ensystec санузел 1.jpg|центр|900px|MQTT-топики Ensystec для зоны Санузел 1]]
-Примеры топиков:
-<pre>
+[[Файл:XIOT топики Ensystec санузел 1.jpg|центр|900px|Контролы Ensystec для зоны Санузел 1]]
-/wb/ensystec_leak_protect_13/external_power_220_ac
-/wb/ensystec_leak_protect_13/low_battery_voltage
-/wb/ensystec_leak_protect_13/leakage_sensor
-/wb/ensystec_leak_protect_13/failure_sensor
-/wb/ensystec_leak_protect_13/input_1
-/wb/ensystec_leak_protect_13/input_2
-</pre>
-На этом этапе важно получить полный список топиков от Wiren Board и убедиться, что нужные зоны Ensystec присутствуют в XIOT. Привязка этих топиков к виртуальным устройствам XIOT выполняется следующим этапом.
+На этом этапе важно получить полный список контролов от Wiren Board и убедиться, что нужные зоны Ensystec присутствуют в XIOT. Привязка контролов к виртуальным устройствам XIOT выполняется следующим этапом.
 == См. также ==

Ensystec-wiren-board-integration: различия между версиями