https://github.com/sokolovs/ec-adapter
ectoControl Adapter Integration for HomeAssistant
https://github.com/sokolovs/ec-adapter
ec-adapter ectocontrol heating heating-control heating-monitoring home-assistant
Last synced: about 2 months ago
JSON representation
ectoControl Adapter Integration for HomeAssistant
- Host: GitHub
- URL: https://github.com/sokolovs/ec-adapter
- Owner: sokolovs
- License: mit
- Created: 2025-10-20T20:21:25.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-01-22T23:10:35.000Z (5 months ago)
- Last Synced: 2026-01-23T16:38:27.558Z (5 months ago)
- Topics: ec-adapter, ectocontrol, heating, heating-control, heating-monitoring, home-assistant
- Language: Python
- Homepage:
- Size: 300 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# RU: 🔥 Интеграция адаптера цифровой шины ectoControl для Home Assistant
Интеграция предназначена для подключения адаптеров **ectoControl**, обеспечивающих управление газовыми и электрическими котлами по различным коммуникационным шинам. В зависимости от модели адаптера поддерживаются такие протоколы, как **eBUS**, **OpenTherm**, **Navien** и другие.
## Возможности
### ✔ Автоматическое создание сенсоров
Интеграция формирует сенсоры для всех **MODBUS-регистров чтения**, описанных в документации адаптера.
Это позволяет получать актуальные параметры работы котла — температуру в контурах, статус, расход и другие данные (зависит от модели котла) и и создавать собственные автоматизации на их основе.
### ✔ Создание элементов управления
Для всех **MODBUS-регистров записи** создаются соответствующие управляющие сущности (числовые регуляторы, селекторы и т. д.).
Это даёт возможность изменять параметры работы котла из Home Assistant и создавать собственные автоматизации с использованием данных сущностей.
### ✔ Мониторинг соединения с котлом
Интеграция отслеживает текущее состояние подключения адаптера к котлу и отображает соответствующий статус в Home Assistant.
### ✔ Автоматическая отправка необходимых параметров
При установлении соединения адаптера с котлом интеграция отправляет все требуемые параметры, обеспечивая корректный запуск и работу отопительного оборудования при перезапусках.
### ✔ Корректная работа после рестарта Home Assistant
После перезапуска Home Assistant интеграция отслеживает собственный запуск и повторно отправляет котлу необходимые значения для восстановления корректной работы.
---
# EN: 🔥 ectoControl Adapter Integration for Home Assistant
This integration connects **ectoControl** adapters that provide control of gas and electric boilers via various communication buses. Depending on the adapter model, supported protocols include **eBUS**, **OpenTherm**, **Navien**, and others.
## Features
### ✔ Automatic sensor creation
The integration generates sensors for all **MODBUS read registers** described in the adapter documentation.
This allows Home Assistant to receive up-to-date boiler parameters — such as circuit temperatures, system status, flow rate, and other values (depending on the boiler model) — and use them to build custom automations.
### ✔ Creation of control entities
For all **MODBUS write registers**, the integration creates corresponding control entities (numeric, selectors, etc.).
This makes it possible to adjust boiler parameters directly from Home Assistant and build automations using these entities.
### ✔ Monitoring of the boiler connection
The integration continuously monitors the connection status between the adapter and the boiler and exposes this status in Home Assistant.
### ✔ Automatic transmission of required parameters
When the adapter establishes a connection with the boiler, the integration automatically sends all required configuration parameters, ensuring proper boiler startup and operation during reconnections.
### ✔ Proper behavior after Home Assistant restarts
After Home Assistant restarts, the integration detects its own initialization and re-sends the necessary values to the boiler to restore correct operation.