Просмотр кода страницы Ensystec-wiren-board-integration

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

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

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

[[Файл:Ensystec щит защиты от протечки 4 контроллера.jpg|центр|800px|Щит защиты от протечки с четырьмя контроллерами Ensystec]]

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

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

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

<gallery mode="packed" heights="260">
Файл:Ensystec щит защиты от протечки 4 контроллера.jpg|Общий вид щита защиты от протечки
Файл:Ensystec коммутация щита защиты от протечки.jpg|Клеммная часть и кабельная коммутация
Файл:Ensystec подключение контроллера в щите.jpg|Подключение одного из контроллеров Ensystec
</gallery>

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

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

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

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

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

{| class="wikitable"
! Адрес Modbus !! Контроллер !! Название в Wiren Board !! Зона
|-
| <code>11</code> || Б-1 || Котельная ввод воды || Котельная, главный ввод воды и коллекторы водоснабжения
|-
| <code>12</code> || Б-2 || Санузел и кухня цоколь || Санузел и кухня цокольного этажа
|-
| <code>13</code> || Б-3 || Санузел 1 || Санузел 1 на первом этаже
|-
| <code>14</code> || Б-4 || Санузел 2 и мастер-санузел || Санузел 2 на первом этаже и мастер-санузел на втором этаже
|}

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

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

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

<pre>
Config-ensystec.xiot-final.json
</pre>

Скачать файл: [[Медиа:Config-ensystec.xiot-final.json|Config-ensystec.xiot-final.json]]

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

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

{| class="wikitable"
! Назначение в XIOT !! Контрол состояния в списке устройства !! Контрол управления в списке устройства
|-
| Флаг протечки || '''Обнаружена протечка''' || '''Сброс протечки'''
|-
| Защита от протечки || '''Статус защиты от протечки''' || '''Управление защитой от протечки'''
|-
| Кран N || '''Кран N статус''' || '''Кран N'''
|-
| Диагностика крана N || '''Кран N состояние''' || —
|}

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

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

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

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

[[Файл:Ensystec настройка устройств в Wiren Board.jpg|центр|900px|Контроллеры Ensystec на порту RS485-2 в веб-интерфейсе Wiren Board]]

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

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

[[Файл:Ensystec карточка устройства в Wiren Board.jpg|центр|520px|Карточка контроллера Ensystec в веб-интерфейсе Wiren Board]]

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

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

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

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

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

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

{| class="wikitable"
! Параметр !! Значение
|-
| IP || <code>localhost</code>
|-
| Порт MQTT || <code>1883</code>
|-
| Логин и пароль || не заполняются, если MQTT-брокер Wiren Board работает без авторизации
|}

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

[[Файл:XIOT Wiren Board получение топиков.jpg|центр|900px|Получение списка устройств и контролов Wiren Board в XIOT-EDITOR]]

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

[[Файл:XIOT Wiren Board полученные топики Ensystec.jpg|центр|900px|Полученные устройства и контролы Wiren Board в XIOT-EDITOR]]

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

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

[[Файл:XIOT список зон Ensystec.jpg|центр|900px|Список зон Ensystec, полученных из Wiren Board]]

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

[[Файл:XIOT топики Ensystec санузел 1.jpg|центр|900px|Контролы Ensystec для зоны Санузел 1]]

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

== Создание виртуальных устройств и связь с физическими контролами ==

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

=== Датчики протечки ===

Для каждого физического датчика протечки создайте виртуальное устройство [[Виртуальное устройство "Датчик протечки воды"|Датчик протечки воды]]. Название лучше задавать по месту установки, например '''Возле бойлера''' или '''Под мойкой'''. Комната выбирается отдельно в интерфейсе XIOT.

В характеристике '''обнаружена протечка''' свяжите адрес состояния с физическим контролом входа Ensystec:

{| class="wikitable"
! Характеристика виртуального датчика !! Что выбрать в списке контролов Wiren Board
|-
| '''обнаружена протечка''' → адрес состояния || '''Вход 1''', '''Вход 2''' ... '''Вход 10''' нужного контроллера Ensystec
|}

[[Файл:XIOT Ensystec датчик протечки связь.jpg|центр|900px|Связь датчика протечки XIOT с входом Ensystec]]

=== Водопроводные краны ===

Для каждого крана создайте виртуальное устройство [[Виртуальное устройство "Кран"|Кран]]. Название задавайте по назначению, например '''Главный ввод''' или '''Горячая вода'''. Комната выбирается отдельно в интерфейсе XIOT.

В характеристике '''включение''' свяжите управление и состояние с контролами крана Ensystec:

{| class="wikitable"
! Характеристика виртуального крана !! Что выбрать в списке контролов Wiren Board
|-
| '''включение''' → адрес управления || '''Кран 1''', '''Кран 2''', '''Кран 3''' или '''Кран 4''' нужного контроллера Ensystec
|-
| '''включение''' → адрес состояния || '''Кран 1 статус''', '''Кран 2 статус''', '''Кран 3 статус''' или '''Кран 4 статус'''
|}

Контролы '''Кран N состояние''' можно использовать для диагностики, потому что они показывают расширенное состояние крана: закрыт, открыт, не определено или не подключен. Для обычной связи с характеристикой '''включение''' используйте простой статус '''Кран N статус'''.

[[Файл:XIOT Ensystec кран связь.jpg|центр|900px|Связь виртуального крана XIOT с командой и статусом Ensystec]]

=== Сценарий защиты от протечки ===

Создайте сценарий [[Сценарий "Защита от протечки воды"|Защита от протечки воды]] для нужной зоны, например '''Главный ввод''' или '''Санузел 1'''. Подробное описание логики сценария находится на странице [[Сценарий "Защита от протечки воды"]].

В параметрах сценария настройте задержки, автозакрытие, работу сирены и другие параметры зоны.

[[Файл:XIOT Ensystec сценарий параметры.jpg|центр|900px|Параметры сценария защиты от протечки воды]]

В характеристиках сценария свяжите управление с контролами Ensystec:

{| class="wikitable"
! Характеристика сценария !! Контрол управления !! Контрол состояния
|-
| '''Включение защиты от протечки''' || '''Управление защитой от протечки''' || '''Статус защиты от протечки'''
|-
| '''Флаг протечки''' || '''Сброс протечки''' || '''Обнаружена протечка'''
|}

[[Файл:XIOT Ensystec сценарий характеристики.jpg|центр|900px|Связь характеристик сценария защиты от протечки с контролами Ensystec]]

После связи характеристик откройте настройки сценария и выберите устройства этой зоны:

* в блок '''Датчики протечки''' добавьте виртуальные датчики протечки нужной зоны;
* в блок '''Водопроводные краны''' добавьте краны, которые должны закрываться при аварии в этой зоне;
* при необходимости заполните блоки '''Управление сиреной''', '''Управление насосом''', '''Счетчики горячей воды''' и '''Счетчики холодной воды'''.

[[Файл:XIOT Ensystec сценарий устройства зоны.jpg|центр|900px|Выбор датчиков протечки и водопроводных кранов зоны в сценарии]]

Для объекта с несколькими независимыми зонами удобнее создавать отдельный сценарий на каждую зону Ensystec. Например, для зоны '''Котельная ввод воды''' в сценарий добавляются датчики котельной и кран главного ввода; для зоны санузла добавляются только датчики и краны этого санузла.

=== Проверка связей ===

После настройки проверьте работу зоны:

# Сработайте физический датчик протечки и убедитесь, что виртуальный датчик показывает протечку.
# Убедитесь, что сценарий выставляет '''Флаг протечки''' и закрывает выбранные краны.
# Нажмите сброс протечки и проверьте, что флаг аварии сбрасывается только после нормализации физических датчиков.
# Отключите и включите '''Включение защиты от протечки''' в сценарии и убедитесь, что состояние синхронизируется с Ensystec.
# Проверьте ручное открытие и закрытие каждого виртуального крана.

== Пользовательское приложение ==

В пользовательском приложении сценарии защиты от протечки удобно собрать на отдельной странице '''Водоснабжение'''. Такой экран показывает водоснабжение не как набор отдельных устройств, а как зоны защиты: каждая зона соответствует своему сценарию и своему контроллеру Ensystec.

На странице '''Водоснабжение''' сценарии размещаются в виде виджетов по зонам. По каждому виджету сразу видно:

* находится ли зона под защитой;
* какие краны относятся к зоне и открыты они или закрыты;
* какие датчики протечки входят в зону;
* где сработал датчик;
* какой контроллер Ensystec отвечает за эту часть системы.

[[Файл:XIOT App водоснабжение мобильная страница.jpg|центр|360px|Страница Водоснабжение в пользовательском приложении XIOT на телефоне]]

На планшете или большом экране виджеты зон можно расположить плотнее: слева отображается состояние сценария зоны, справа — краны и датчики протечки. Такой вид удобен для объекта с несколькими независимыми зонами, например '''Главный ввод''', '''Цоколь санузел и кухня''', '''Санузел 1''' и другие.

[[Файл:XIOT App водоснабжение планшет виджеты зон.jpg|центр|900px|Виджеты зон защиты от протечки на странице Водоснабжение]]

Если датчик сработал, в приложении видно, в какой зоне возникла авария. В сообщениях также фиксируются события обнаружения и устранения протечки. Это помогает быстро понять, где искать проблему и какой сценарий закрыл краны.

[[Файл:XIOT App сообщения протечки.jpg|центр|360px|Сообщения о срабатывании и устранении протечки в XIOT]]

Рекомендуемый принцип сборки интерфейса: один виджет страницы '''Водоснабжение''' соответствует одному сценарию защиты от протечки и одной зоне Ensystec. Тогда пользователь видит систему так же, как она физически разделена в щите и в сценариях XIOT.

== См. также ==

* [[Описание и схема подключения блока защиты от протечек воды Ensystec]]
* [[Смена Modbus адреса Ensystec через консоль Wiren Board]]
* [[Подключение Wiren Board]]
* [[Пользовательские шаблоны устройств Wiren Board]]
* [[Шаблон Wiren Board Ensystec Leak Protect для XIOT]]
* [[Сценарий "Защита от протечки воды"]]
* [[Виртуальное устройство "Кран"]]
* [[Виртуальное устройство "Датчик протечки воды"]]