Ранее, в статье «Погодозависимая автоматика для газового котла своими руками. Технологии умного дома», было описано как я подключал адаптер цифровой шины ectoControl к своему газовому котлу. Можно заметить, что в статье приведено множество технических деталей и сложных настроек. Это связано с тем, что система была собрана из тех интеграций, что уже были представлены в HomeAssistant. Основной была интеграция Modbus, так как именно этот протокол управления реализован в адаптере.

Уже тогда я принял решение, что разработаю полноценную интеграцию для этих адаптеров (в линейке есть поддержка шин Navien, eBUS и OpenTherm). И вот в прошедшие выходные я закончил разработку и вышла версия v1.0.0.

В данной статье я рассмотрю функционал интеграции, её установку и настройку.

Функции интеграции

Интеграция предназначена для подключения к HomeAssistant адаптеров ectoControl, обеспечивающих управление газовыми и электрическими котлами по различным коммуникационным протоколам. В зависимости от модели адаптера поддерживаются такие протоколы, как eBUS, OpenTherm, Navien и другие.

После подключения адаптера к котлу и далее к HomeAssistant, вы получите полный набор всех возможных сенсоров и элементов управления, которые предоставляются адаптером в соответствии с документацией производителя. Перечислю только некоторые из них (остальные можно увидеть на скриншоте ниже):

• Управление:

  • Режим работы (выключен, только ГВС, отопление + ГВС)

  • Целевая Т. теплоносителя, °C

  • Целевая Т. ГВС, °C

  • Аварийная Т. теплоносителя, °C

  • Модуляция горелки, %

  • Перезагрузить адаптер

  • Сбросить ошибки котла

• Сенсоры:

  • Связь с котлом (подключен/не подключен)

  • Состояние горелки (работает/не работает)

  • Состояние отопления (работает/не работает))

  • Состояние ГВС (работает/не работает))

  • Температура теплоносителя (в отопительном контуре), °C

  • Температура в контуре ГВС, °C

  • и т.д.

Всего на данный момент интеграцией предоставляется 46 объектов. Обращу внимание, что не все возможности управления и мониторинга, поддерживаются всеми котлами, например, изменение модуляции горелки и некоторые другие параметры поддерживаются не всеми котлами.

Интеграция поддерживает одновременное подключение нескольких адаптеров ectoControl, включая возможность подключения нескольких адаптеров подключенных к одной сети RS-485, за счёт наличия внутренней очереди команд на чтение/запись. Таким образом, каждым адаптером можно будет управлять независимо.

Интеграция поддерживает физическое подключение адаптера к компьютеру с HomeAssistant как через проводные конвертеры интерфейсов RS-485 <-> USB (последовательный порт), так и через конвертеры интерфейсов RS-485 <-> Ethernet или RS-485 <-> Wi-Fi (Modbus TCP).

Могу порекомендовать проводной конвертер RS-485 <-> Ethernet от компании ZLAN, модель ZLAN5143D. Низкая цена, отлично работает и полностью гальванически развязан. Плюсом поддерживает режим Multi-Master. Ниже приведу скриншот с настройками для подключения к адаптеру ectoControl в режиме Multi-Master.

Установка

Интеграция ещё не добавлена в HomeAssistant Community Store (HACS), и поэтому на данный момент существует только один способ её установки — через пользовательские репозитории.

Предварительно должен быть установлен сам HACS. Варианты установки описаны на официальном сайте.

Для установки:

1. Перейдите в HACS, далее нажмите три точки и в меню выберите пункт «Пользовательские репозитории».

2. В поле «Репозиторий» введите https://github.com/sokolovs/ec‑adapter, в поле «Тип» выберите «Интеграция» и нажмите «Добавить».

3. В поисковой строке вбейте «ectoControl» и перейдите в интеграцию.

4. На странице интеграции выберите три точки и в меню пункт «Скачать».

5. После необходимо выполнить рестарт HomeAssistant. Поздравляю, интеграция установлена.

Подключение адаптера

1. Перейдите в «Настройки → Устройства и службы» и нажмите «Добавить интеграцию».

2. В поиске введите «ectoControl» и выберите найденную интеграцию

3. Откроется диалог настройки подключения. В нем необходимо заполнить параметры подключения к адаптеру:

   1. Заполните произвольное название (можно по модели котла). Будет создано устройство с данным именем.

   2. Выберите тип подключения:

      1. TCP, UDP, RTU over TCP в случае использования конвертера интерфейсов RS-485 <-> Ethernet или RS-485 <-> Wi-Fi. Обычно используется TCP, остальные варианты для нестандартного исполнения конвертера.

      2. Serial в случае подключения через последовательный порт RS-485, встроенный или RS-485 <-> USB.

   3. Укажите Slave/Unit ID, т.е. адрес устройства на шине. Производитель указывает в документации, что адрес по умолчанию 240 (0xF0 в HEX), но в моем случае почему-то оказался равным 1.

   4. Нажмите «Подтвердить» и перейдите к следующему этапу. На следующем этапе, в зависимости от выбора типа подключения, будет разный набор параметров:

      1. Для вариантов TCP, UDP, RTU over TCP нужно будет ввести IP + порт.

      2. Для варианта Serial нужно будет заполнить путь к устройству последовательного порта. Обычно /dev/tty0 для встроенного порта и /dev/ttyUSB0 для RS-485 <-> USB. Посмотреть точно можно по выводу команды dmesg. Все остальные параметры заполнены по умолчанию корректно и изменять их не требуется.

4. Нажимаем кнопку «Подтвердить». Будет проверена возможность подключения к устройству через опрос времени наработки. Если опрос пройдет успешно, то устройство будет добавлено.

Сценарии использования

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

Один из вариантов автоматизации я привёл в статье «Интеграция WDA Sensor для HomeAssistant: для чего она нужна и как ей пользоваться».

Замечания и предостережения

1. Обращаю внимание, что многие параметры регулирования в адаптере ectoControl записываются в ПЗУ (количество циклов записи-перезаписи 100к). Поэтому стоит избегать частого изменения с помощью автоматизаций. Этот кейс был подробно описан здесь.

2. Интеграция проверена мной на адаптере Navien, и я пока не могу дать гарантий корректной работы с другими адаптерами ectoControl. Описание протокола у всех адаптеров полностью идентичное, о чём сообщила и служба поддержки производителя, но натурных испытаний не проводилось. Надеюсь в данном вопросе на сообщество. Буду рад обратной связи.

Как обычно: вопросы, отзывы и критика приветствуются.