Интегрируем контроллер BCG-1.1.3-WF управления котлом в Home Assistant
NEVOTON BCG-1.1.3-WF
в популярную систему автоматики Home Assistant. Система автоматики Home Assistant может взаимодействовать с модулем управления котлом через MQTT-брокера. Мы использовали MQTT-брокер, встроенный в ПО контроллера Wiren Board 6 (WB6), но может быть использован и другой MQTT-брокер. Соответственно, в Home Assistant должна быть установлена интеграция MQTT (НАСТРОЙКИ/ИНТЕГРАЦИИ…). Эта интеграция должна быть настроена (указан IP-адрес и порт используемого брокера).Там же необходимо указать префикс топиков, который будет использоваться модулем для связи с брокером. Можно оставить префикс без изменений и будет использован прописанный по умолчанию. Не забудьте перевести переключатель «Клиент» в положение «Включен» и нажать на кнопку «Сохранить» внизу экрана. После этого модуль управления соединится с указанным брокером. Об успешном выполнении этой операции сообщит зеленый цвет индикатора «Соединение» на странице «Настройки» WEB-интерфейса модуля.
Обращаю ваше внимание на то, что модуль может использовать для работы информацию о температуре не только от подключенного к нему NTC-датчика, но и информацию от сторонних датчиков температуры, публикующих свои данные на MQTT-брокере. Для этого надо на странице «Настройки» выбрать датчик «MQTT, API» и в поле «Топик Temp MQTT» указать топик, в который публикует свои данные нужный вам датчик температуры. Теперь можно, например, для работы в погодозависимом режиме использовать уже работающий в вашей системе автоматики датчик уличной температуры. Модуль подпишется на его топик на брокере и будет использовать эти данные для управления котлом.
После соединения с брокером модуль сразу начинает публиковать там свои данные. Для внешней автоматики модуль управления представляет собой 29 сущностей (из них 18 Sensor, 5 Binary sensor, 1 Switch и остальные Text).
Рассмотрим ручной способ интеграции устройств в Home Assistant через MQTT.
Сначала проверяем установкe в Home Assistant интеграциb с MQTT (Настройки/Устройства и интеграции). Установленная интеграция MQTT должна быть настроена для работы с тем же MQTT-брокером, к которому подключен модуль управления (в настройке интеграции задать адрес и порт брокера).
Затем потребуется описать каждую сущность устройства в конфигурационном файле. Для Home Assistant их надо описать в конфигурационном файле с именем mqtt.yaml и разместить этот файл в каталоге /config вместе с файлом configuration.yaml. В сам конфигурационный файл configuration.yaml обязательно надо добавить ссылку на файл с настройками MQTT-устройств следующего вида:
mqtt: !include mqtt.yaml без отступа слева. Это обычная практика при выделении раздела настроек в отдельный файл.
Работа по описанию сущностей устройства кропотливая, требует внимания и усидчивости. Для упрощения задачи выкладываем на сервере уже подготовленный конфигурационный файл mqtt.yaml. В этом файле прописаны конкретные топики, формируемые модулем при сохранении настроек по умолчанию. Если вы в настройках модуля меняли префикс топиков, то во всем файле надо будет привести в соответствие имена топиков.
После создания (редактирования) файла mqtt.yaml в каталоге /config следует произвести «перезагрузку конфигурации YAML объектов интеграции MQTT, настроенных вручную» (ПАНЕЛЬ РАЗРАБОТЧИКА /YAML) и новые сущности модуля управления котлом станут доступны для использования. Их можно будет увидеть в списке объектов (ПАНЕЛЬ РАЗРАБОТЧИКА/СОСТОЯНИЯ) и можно использовать для организации интерфейса, а также в автоматизациях.
Для того, чтобы сущности отобразить в интерфейсе Home Assistant в виде панели управления, воспользуемся средствами описания пользовательского интерфейса Lovelace.
Модуль управления может работать в четырех основных режимах, которые задаются при настройке в WEB-интерфейсе (постоянная температура подачи, программный термостат по комнатной температуре, погодозависимое управление и работа со внешним термостатом) . Установленный режим публикуется модулем в топике /devices/BCG113/controls/BCGRegim. Для каждого из режимов строится свой специфический интерфейс с набором необходимых органов управления.
Будем использовать набор карточек, часть из которых будет условная, то есть эти карточки будут отображаться только при работе модуля в определенном режиме.
Для того, чтобы без трудоемкого ручного ввода описания карточек Lovelace-интерфейса вы могли попробовать работу с этими интерфейсами, я подготовил и выложил на сервере yaml-файл, содержащий описание карточек. При создании этого интерфейса были использованы загруженные из открытого community-репозитория библиотеки карточек Mushroom Cards, button-card, Better Thermostat UI, Dark Thermostat, Simple Thermostat и тема Mushroom Shadow. Перед загрузкой этого примера интерфейса перечисленные библиотеки карточек надо установить в ваш Home Assistant используя HACS. Как это сделать есть много инструкций на просторах интернета.
На главной панели входим в режим редактирования (правый верхний угол экрана три точки). Создаем новую вкладку или даже новую дополнительную панель, входим в режим ее изменения. Жмем синюю кнопку «Добавить карточку», в открывшемся окне выбора типа карточки проматываем в самый низ и выбираем «Ручная настройка». Откроется окно «Настройка карточки» с текстовым редактором в левой части. Надо в этом редакторе удалить подсказку и вставить содержимое файла интерфейса модуля. Затем, внизу справа нажимаем «Сохранить» и завершаем процесс изменения панели, нажав на кнопку в рамке «Готово» в правом верхнем углу экрана. Внешний вид панели будет соответствовать одной из четырех картинок в зависимости от того в каком режиме сконфигурирован модуль управления котлом.
Теперь мы можем из автоматики Home Assistant полноценно взаимодействовать с отопительным оборудованием дома, видеть всю доступную телеметрическую информацию от котла, управлять работой отопления и горячего водоснабжения.
Вот только 2 примера использования данных, полученных от котла, в автоматизациях:
- Работа по расписанию – поддержание температуры в помещениях по заданному расписанию либо по событиям (например, дом поставлен на охрану и отопление переводится на пониженные значения с подтверждением изменения режима через уведомления в Telegram).
- Контроль давления в котловом контуре – при снижении давления в котловом контуре ниже установленного порога отправка уведомления с предупреждением. Своевременное восстановление давления в контуре и выяснение причин снижения давления позволит предотвратить неожиданную остановку котла при критической потере давления, когда сработает защитная автоматика самого котла. Вообще, наблюдение за изменением давления в отопительном контуре в разных режимах работы котла позволяет заблаговременно обнаружить целый ряд неисправностей в отопительной системе, но это, пожалуй, тема для отдельной статьи.