Пользовательская интеграция для прямого подключения Home Assistant к контроллеру ZONT в локальной сети. Обмен данными идёт напрямую с контроллером и не зависит от доступности облачного сервиса ZONT.
- отображение и управление контурами отопления и ГВС;
- получение показаний температурных, аналоговых и поддерживаемых радиодатчиков;
- отображение состояния котла, насосов, смесителей и реле;
- управление реле, охранными зонами и пользовательскими элементами ZONT;
- диагностика контроллера, питания и каналов связи;
- выбор устройств, которые нужно добавить в Home Assistant;
- автоматическое добавление новых устройств ZONT;
- передача температуры и состояний бинарных датчиков из Home Assistant в ZONT;
- автоматическое восстановление соединения после временных сбоев;
- действия и события для использования в автоматизациях.
| Категория | Возможности |
|---|---|
| Контроллер | Подключение, питание, каналы связи, уровень сигнала и перезагрузка |
| Отопление | Контуры ГВС и отопления, температура, режимы и активность нагрева |
| Оборудование | Адаптеры цифровой шины, насосы, смесители и реле |
| Датчики | Аналоговые входы, цифровые и NTC-датчики температуры, подтверждённые радиодатчики |
| Безопасность | Охранные зоны и связанные с ними датчики |
| Управление | Кнопки, переключатели и статусы, настроенные в ZONT |
Фактический набор сущностей зависит от модели контроллера, его прошивки и настроенного в ZONT оборудования.
| Контроллер | Плата | Прошивка | Статус |
|---|---|---|---|
| ZONT H-1V.02 PRO | 700 | 625 | Проверено на реальном устройстве |
Другие контроллеры с совместимым локальным WebSocket-интерфейсом могут работать, но пока не проверены на реальном устройстве.
- Home Assistant 2026.3.0 или новее;
- контроллер ZONT, доступный из локальной сети Home Assistant;
- локальный IP-адрес контроллера;
- имя пользователя и пароль контроллера.
ZONT Local пока распространяется как пользовательский репозиторий и не входит в стандартный каталог HACS.
Если ссылка недоступна, откройте в HACS меню Пользовательские репозитории,
добавьте https://github.com/asamofalov/zont-local с типом Интеграция,
затем найдите ZONT Local и нажмите Скачать.
После установки перезапустите Home Assistant.
Скопируйте каталог custom_components/zont_local в
/config/custom_components/zont_local вашего Home Assistant и перезапустите
Home Assistant.
- Откройте Настройки → Устройства и службы → Добавить интеграцию.
- Найдите ZONT Local.
- Укажите IP-адрес и учётные данные контроллера.
- Завершите настройку, следуя подсказкам на экране.
Указывайте только IP-адрес — без протокола, порта и дополнительных путей.
При добавлении интеграции потребуется:
- Выбрать режим ZONT, который отключает контуры отопления и ГВС. Интеграция покажет только подходящие режимы с нулевыми уставками.
- Выбрать устройства ZONT, которые нужно добавить в Home Assistant.
- При необходимости оставить включённым автоматический импорт новых устройств.
Сам контроллер и его основные диагностические сущности добавляются всегда.
Откройте Настройки → Устройства и службы → ZONT Local → Настроить.
Доступны три раздела:
- Основные настройки — режим отключения, температура включения ГВС и интервал контрольного обновления;
- Импорт устройств — выбор объектов ZONT и автоматическое добавление новых;
- Экспорт в ZONT — передача показаний температурных сенсоров и состояний бинарных датчиков Home Assistant в новые или существующие виртуальные датчики ZONT.
Изменение этих параметров не требует повторного добавления интеграции. Если выбранный режим ZONT перестанет отключать все контуры, Home Assistant покажет системное уведомление с инструкцией. После выбора подходящего режима уведомление исчезнет автоматически.
- поддерживается одна запись интеграции и один контроллер;
- Home Assistant должен иметь прямой сетевой доступ к контроллеру;
- управление насосами и смесителями не предоставляется — отображается только их фактическое состояние;
- часть типов радиоустройств пока не создаёт сущности;
- доступность отдельных функций зависит от модели и прошивки контроллера;
- интеграция находится в активной разработке и не является официальным продуктом ZONT или Home Assistant.
Проект разрабатывается с помощью инструментов искусственного интеллекта. Архитектурные решения и изменения проверяются автором.
Исходный код распространяется по лицензии MIT. Название и изображения ZONT не входят в эту лицензию — подробнее в NOTICE.md.
