Подключение Ensystec в XIOT через Wirenboard
Подключение 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 выполняется следующим этапом.
Создание виртуальных устройств и связь с физическими контролами
После загрузки контролов Wiren Board в XIOT нужно создать виртуальные устройства проекта и связать их с физическими контролами Ensystec. Интегратор работает со списком контролов в XIOT-EDITOR: выбирает нужное устройство Ensystec, затем выбирает контрол по названию.
Датчики протечки
Для каждого физического датчика протечки создайте виртуальное устройство Датчик протечки воды. Название лучше задавать по месту установки, например Возле бойлера или Под мойкой. Комната выбирается отдельно в интерфейсе XIOT.
В характеристике обнаружена протечка свяжите адрес состояния с физическим контролом входа Ensystec:
| Характеристика виртуального датчика | Что выбрать в списке контролов Wiren Board |
|---|---|
| обнаружена протечка → адрес состояния | Вход 1, Вход 2 ... Вход 10 нужного контроллера Ensystec |
Водопроводные краны
Для каждого крана создайте виртуальное устройство Кран. Название задавайте по назначению, например Главный ввод или Горячая вода. Комната выбирается отдельно в интерфейсе XIOT.
В характеристике включение свяжите управление и состояние с контролами крана Ensystec:
| Характеристика виртуального крана | Что выбрать в списке контролов Wiren Board |
|---|---|
| включение → адрес управления | Кран 1, Кран 2, Кран 3 или Кран 4 нужного контроллера Ensystec |
| включение → адрес состояния | Кран 1 статус, Кран 2 статус, Кран 3 статус или Кран 4 статус |
Контролы Кран N состояние можно использовать для диагностики, потому что они показывают расширенное состояние крана: закрыт, открыт, не определено или не подключен. Для обычной связи с характеристикой включение используйте простой статус Кран N статус.
Сценарий защиты от протечки
Создайте сценарий Защита от протечки воды для нужной зоны, например Главный ввод или Санузел 1. Подробное описание логики сценария находится на странице Сценарий "Защита от протечки воды".
В параметрах сценария настройте задержки, автозакрытие, работу сирены и другие параметры зоны.
В характеристиках сценария свяжите управление с контролами Ensystec:
| Характеристика сценария | Контрол управления | Контрол состояния |
|---|---|---|
| Включение защиты от протечки | Управление защитой от протечки | Статус защиты от протечки |
| Флаг протечки | Сброс протечки | Обнаружена протечка |
После связи характеристик откройте настройки сценария и выберите устройства этой зоны:
- в блок Датчики протечки добавьте виртуальные датчики протечки нужной зоны;
- в блок Водопроводные краны добавьте краны, которые должны закрываться при аварии в этой зоне;
- при необходимости заполните блоки Управление сиреной, Управление насосом, Счетчики горячей воды и Счетчики холодной воды.
Для объекта с несколькими независимыми зонами удобнее создавать отдельный сценарий на каждую зону Ensystec. Например, для зоны Котельная ввод воды в сценарий добавляются датчики котельной и кран главного ввода; для зоны санузла добавляются только датчики и краны этого санузла.
Проверка связей
После настройки проверьте работу зоны:
- Сработайте физический датчик протечки и убедитесь, что виртуальный датчик показывает протечку.
- Убедитесь, что сценарий выставляет Флаг протечки и закрывает выбранные краны.
- Нажмите сброс протечки и проверьте, что флаг аварии сбрасывается только после нормализации физических датчиков.
- Отключите и включите Включение защиты от протечки в сценарии и убедитесь, что состояние синхронизируется с Ensystec.
- Проверьте ручное открытие и закрытие каждого виртуального крана.
Пользовательское приложение
В пользовательском приложении сценарии защиты от протечки удобно собрать на отдельной странице Водоснабжение. Такой экран показывает водоснабжение не как набор отдельных устройств, а как зоны защиты: каждая зона соответствует своему сценарию и своему контроллеру Ensystec.
На странице Водоснабжение сценарии размещаются в виде виджетов по зонам. По каждому виджету сразу видно:
- находится ли зона под защитой;
- какие краны относятся к зоне и открыты они или закрыты;
- какие датчики протечки входят в зону;
- где сработал датчик;
- какой контроллер Ensystec отвечает за эту часть системы.
На планшете или большом экране виджеты зон можно расположить плотнее: слева отображается состояние сценария зоны, справа — краны и датчики протечки. Такой вид удобен для объекта с несколькими независимыми зонами, например Главный ввод, Цоколь санузел и кухня, Санузел 1 и другие.
Если датчик сработал, в приложении видно, в какой зоне возникла авария. В сообщениях также фиксируются события обнаружения и устранения протечки. Это помогает быстро понять, где искать проблему и какой сценарий закрыл краны.
Рекомендуемый принцип сборки интерфейса: один виджет страницы Водоснабжение соответствует одному сценарию защиты от протечки и одной зоне Ensystec. Тогда пользователь видит систему так же, как она физически разделена в щите и в сценариях XIOT.
См. также
- Описание и схема подключения блока защиты от протечек воды Ensystec
- Смена Modbus адреса Ensystec через консоль Wiren Board
- Подключение Wiren Board
- Пользовательские шаблоны устройств Wiren Board
- Шаблон Wiren Board Ensystec Leak Protect для XIOT
- Сценарий "Защита от протечки воды"
- Виртуальное устройство "Кран"
- Виртуальное устройство "Датчик протечки воды"