Документация eWeLinkHome Assistant
Узнайте, как подключить устройства eWeLink к Home Assistant с помощью официального дополнения eWeLink Smart Home.
I. Возможности
- В настоящее время официальное дополнение поддерживает выключатели и розетки eWeLink. Поддержка дополнительных устройств eWeLink будет добавлена в последующих версиях.
- Поддержка режима DIY Sonoff.
- Приоритетное управление устройствами по локальной сети. Если устройство не поддерживает режим LAN или не находится в локальной сети, вы можете управлять им через облако.
- Синхронизация статуса устройства и информации о конфигурации в реальном времени. Название и конфигурация устройства могут быть изменены позднее.
- Поддерживается только Home Assistant, установленный через HassOS и Supervisor.
II. Предварительные условия
Создание долгосрочных токенов доступа
Дополнение eWeLink подключает поддерживаемые устройства eWeLink через REST API и WebSocket API Home Assistant. Для этого необходим долгосрочный токен доступа.
Войдите в консоль Home Assistant Lovelace (обычно URL-адрес — http://homeassistant.local:8123/), нажмите на имя пользователя в самом низу боковой панели, чтобы перейти в профиль пользователя, найдите раздел «Долгосрочные токены доступа» внизу страницы и нажмите СОЗДАТЬ ТОКЕН. Введите имя токена в диалоговом окне (рекомендуется eWeLink_HA_AddOn) и нажмите OK. Скопируйте сгенерированный токен и сохраните его в надёжном месте.
III. Установка
Войдите в консоль Home Assistant Lovelace (обычно URL-адрес — http://homeassistant.local:8123/), нажмите Supervisor на боковой панели, чтобы открыть панель управления HassOS, и перейдите на вкладку Add-on Store. Нажмите на вертикальное многоточие (три вертикальные точки) в правом верхнем углу, выберите Repositories во всплывающем меню, введите официальный адрес дополнения eWeLink: https://github.com/CoolKit-Technologies/ha-addon в диалоговом окне «Управление репозиториями дополнений» и нажмите ADD. После закрытия диалогового окна вы увидите только что добавленное дополнение eWeLink на странице Add-on Store.
Нажмите на карточку eWeLink Smart Home, чтобы открыть страницу информации о дополнении, нажмите INSTALL и дождитесь завершения установки. После завершения не нажимайте сразу START, вместо этого перейдите на вкладку Configuration, введите долгосрочный токен доступа и нажмите Save. Затем вернитесь на вкладку Information и нажмите START, чтобы активировать дополнение «eWeLink Smart Home».
Для быстрого доступа к дополнению eWeLink Smart Home вы можете включить опцию Show in sidebar (Показать на боковой панели).
Необходимо изменить home_assistant_url, если вы используете Docker или другие версии Home Assistant, отличные от Home Assistant OS.
IV. Настройка
Управление DIY-устройствами eWeLink
Управляйте DIY-устройствами eWeLink в локальной сети или войдите в аккаунт eWeLink, чтобы управлять всеми поддерживаемыми устройствами eWeLink.
Войдите в консоль Home Assistant Lovelace (обычно URL-адрес — http://homeassistant.local:8123/), нажмите Supervisor на боковой панели, чтобы открыть панель управления HassOS, затем нажмите на карточку eWeLink Smart Home, чтобы перейти на страницу информации о дополнении. Нажмите OPEN WEB UI, страница веб-интерфейса eWeLink Smart Home отобразит все DIY-устройства в локальной сети, обнаруженные через mDNS. Вы также можете нажать кнопку Login в левом верхнем углу и войти в аккаунт eWeLink, чтобы подключить все поддерживаемые устройства.
В настоящее время бета-версия поддерживает только выключатели и розетки; поддержка других типов устройств будет добавлена в ближайшее время.
Настройка сцен и автоматизаций
Устройства, подключённые через REST API и WebSocket API Home Assistant, могут быть сопоставлены только как сущности, а не как устройства, что делает невозможным прямое управление устройствами через сцены и автоматизации Home Assistant.
Для решения этой проблемы необходимо включить Расширенный режим (Консоль Lovelace > Профиль > Advanced Mode).
Чтобы использовать устройства eWeLink в автоматизациях, сначала создайте сцену, содержащую ваши устройства, затем выберите Активировать сценарий в разделе Действие > Тип действия автоматизации.
