Компонент для управления устройствами ZONT из Home Assistant.
Для входа в ваш аккаунт потребуется токен. Его можно получить из Home Assistant. При добавлении устройства нажмите галочку "Получить токен". При каждом получении токена создаётся новый. Что бы их не плодить на аккаунте ZONT, запишите полученный токен. Как удалить токен описано здесь.
После авторизации в Home Assistant (далее НА) можно выбрать необходимые устройства аккаунта ZONT для добавления их в НА.
* Теоретически все модели поддерживаюся интеграцией.
Warning
Интеграция основана на API V3. Реализована поддержка webhook (уведомление о событии устройства) Настраивается в меню Аккаунта - Интеграции - Webhook.
В НА из ZONT добавляются следующие объекты каждого устройства:
- Контуры отопления
- Сенсоры
- Элементы управления (кнопка, сложная кнопка или бинарный сенсор)
- Webhook (уведомление HA о событии устройства)
Контур отопления добавляется в НА в виде термостата. Шаг регулировки температуры и пределы регулировки берутся из аккаунта ZONT. Все, созданные в ZONT, режимы отопления добавляются в НА. В каждом контуре есть возможность менять режим отопления. Для изменения режима отопления во всех контурах одновременно в НА добавляются кнопки с названиями режимов.
Warning
Включение и выключение контура возможно только через режимы отопления. Управление контуром в НА через set_hvac_mode не предусмотрено. Такова особенность ZONT.
В НА добавляются все доступные сенсоры в API ZONT. Обновление сенсоров происходит примерно раз в минуту.
У радиодатчиков есть дополнительные параметры rssi и вольтаж батарейки. Эти параметры добавляются в виде отдельных сенсоров с тем же названием, что и сам датчик.
Ошибки котла добавляются отдельным сенсором, который отображает код ошибки и описание. Описание ошибок зависит от котла.
В веб интерфейсе ZONT можно добавить элементы управления и привязать на них любое доступное действие. Например, включить реле или выключить реле, включить котловой режим, включить отопительный режим на всех устройствах и др. Смотрите возможности в интерфейсе ZONT. Устройства, у которых тип элемента - статус входа/выхода, добавляются как бинарные сенсоры.
В НА добавляются все охранные зоны устройства. Можно поставить на охрану или снять с охраны охранную зону.
Webhook нужен для мгновенного изменения состояния устройства в НА. Например если вы измените заданную температуру контура в приложении ZONT, то сервер ZONT оповестит ваш НА об изменении параметра и НА отобразит актуальные данные. Так же можно настроить уведомления об аварии котла, сработки охранной зоны и тд.
Настраивается в меню Аккаунта (В браузерной версии слева вверху жмём на аккаунт) - Интеграции - Webhook. Если данного пункта меню нет в вашем приложении (ZONT), то обновите мобильное приложение (ZONT), либо используйте браузерную версию.
Жмём + и добавляем webhook. Прописываем адрес на который ZONT
бедет слать уведомления о событиях.
Например: https://my-home-assistans.ru/api/webhook/webhook_id
Где webhook_id создаётся интеграцией автоматически из вашего email,
указанного при добавлении аккаунта ZONT в HA.
Например: email: teplo@zont.ru --> webhook_id: teplozontru, то есть убираются
все символы . и @ из email.
Секретный ключ пишем любой, например zont_ha_secretkey.
Далее выбираем устройство, с которого хотим получать уведомления, и сами события этого устройства при наступлении которого ZONT будет уведомлять HA.
Warning
Обязательно используйте уникальные email для каждого добавленного хаба в интеграцию! Иначе вебхук будет работать не корректно.
Способ 1. HACS -> Интеграции -> 3 точки в правом верхнем углу -> Пользовательские репозитории
Далее вставляем репозиторий https://github.com/MihVS/zont_ha выбираем категорию "Интеграция" и жмём добавить.
Способ 2. Вручную скопируйте каталог zont_ha в директорию /config/custom_components
Настройки -> Интеграции -> Добавить интеграцию -> ZONT
Если интеграции не появилось в списке, то очистите кэш в браузере.
Чтобы изменить уровень логирования, для выявления проблем, необходимо в файле configuration.yaml добавить:
logger:
logs:
custom_components.zont_ha: debug- Любая финансовая поддержка приветствуется и мотивирует. Это можно сделать по иконке donate|T-Bank в верху документации.
- Каждая звезда интеграции так же мотивирует разработчика.