Skip to content

Repository files navigation

ZONT

ZONT Local для Home Assistant

Пользовательская интеграция для прямого подключения 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-адрес контроллера;
  • имя пользователя и пароль контроллера.

Установка

Через HACS

ZONT Local пока распространяется как пользовательский репозиторий и не входит в стандартный каталог HACS.

Открыть 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.

Добавление интеграции

  1. Откройте Настройки → Устройства и службы → Добавить интеграцию.
  2. Найдите ZONT Local.
  3. Укажите IP-адрес и учётные данные контроллера.
  4. Завершите настройку, следуя подсказкам на экране.

Указывайте только IP-адрес — без протокола, порта и дополнительных путей.

Первоначальная настройка

При добавлении интеграции потребуется:

  1. Выбрать режим ZONT, который отключает контуры отопления и ГВС. Интеграция покажет только подходящие режимы с нулевыми уставками.
  2. Выбрать устройства ZONT, которые нужно добавить в Home Assistant.
  3. При необходимости оставить включённым автоматический импорт новых устройств.

Сам контроллер и его основные диагностические сущности добавляются всегда.

Настройки интеграции

Откройте Настройки → Устройства и службы → ZONT Local → Настроить.

Доступны три раздела:

  • Основные настройки — режим отключения, температура включения ГВС и интервал контрольного обновления;
  • Импорт устройств — выбор объектов ZONT и автоматическое добавление новых;
  • Экспорт в ZONT — передача показаний температурных сенсоров и состояний бинарных датчиков Home Assistant в новые или существующие виртуальные датчики ZONT.

Изменение этих параметров не требует повторного добавления интеграции. Если выбранный режим ZONT перестанет отключать все контуры, Home Assistant покажет системное уведомление с инструкцией. После выбора подходящего режима уведомление исчезнет автоматически.

Ограничения

  • поддерживается одна запись интеграции и один контроллер;
  • Home Assistant должен иметь прямой сетевой доступ к контроллеру;
  • управление насосами и смесителями не предоставляется — отображается только их фактическое состояние;
  • часть типов радиоустройств пока не создаёт сущности;
  • доступность отдельных функций зависит от модели и прошивки контроллера;
  • интеграция находится в активной разработке и не является официальным продуктом ZONT или Home Assistant.

Документация проекта

О разработке

Проект разрабатывается с помощью инструментов искусственного интеллекта. Архитектурные решения и изменения проверяются автором.

Лицензия

Исходный код распространяется по лицензии MIT. Название и изображения ZONT не входят в эту лицензию — подробнее в NOTICE.md.

About

Локальная интеграция контроллеров ZONT с Home Assistant через WebSocket

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages