В прошлой статье я описал мое новое приобретение - увлажнитель воздуха, а также подключил его к приложению Mi home. При покупке изначально предусматривалась интеграция этого устройства в мой умный дом на базе альтернативной системы управления Home Assistant.
Получаем токен устройства
Первым делом нужно получить токен устройства. Есть несколько способов сделать это, раньше я использовал модифицированное приложение mihome с сайта kapiba.ru, но сейчас есть другой удобный способ, который подойдёт даже владельцам айфонов, так как не нужно ставить никаких приложений ставить. Надо только воспользоваться интеграцией Home Assistant под названием XiaomiGateway3 от автора AlexxIT.
Основная цель этой интеграции - управление одноименным zigbee и ble шлюзом через telnet, который изначально был не закрыт паролем, и проброс сущностей в Home Аssistant. Сейчас купить шлюз с открытым telnet не представляется возможным, однако существуют методы перепрошивки этого шлюза с дальнейшей интеграцией в HA.
Но я немного отвлекся. Одна из фич интеграции - возможность получения токенов устройств из вашего аккаунта mihome. Для этого нет необходимости приобретать шлюз, достаточно просто добавить интеграцию.
Для этого необходимо зайти в HACS и добавить кастомный репозиторий.
В строке пишем адрес компонента на сайте github, выбираем категорию Integration и нажимаем кнопку добавить.
После этого при необходимости перезагружаем сервер и заходим в Настройки - интеграции и добавляем теперь там новую интеграцию.
Теперь поиском находится сразу три интеграции, нас интересует Xiaomi Gateway 3. Нажимаем на нее. В нашем случае выбираем действие Add Mi Cloud Account
В появившемся окне вводим данные своего аккаунта из приложения mi home и сервера, их можно выбрать несколько, если ваши устройства подключены в разных регионах.
После этого в настройках интеграции будет доступно следующее меню.
В выпадающем списке будут устройства с отображением их названия и IP адреса в вашей сети.
Нажимаем “Подтвердить” и видим интересующую нас информацию.
Кроме токена, тут также указана модель увлажнителя. В моем случае это zhimi.humidifier.ca4,что также поможет мне интегрировать данное устройство.
Добавляем устройство в Home Аssistant
При добавлении устройства я первым делом обратился к официальной документации проекта. Интеграция xiaomi_miio поддерживает работу увлажнителей воздуха Xiaomi. В списке поддерживаемых устройств есть в том числе и моя модель.
На скриншоте представлен список возможностей и атрибутов при использовании данной интеграции. Для использования интеграции необходимо добавить в файл configuration.yaml следующие строки:
fan:
# Example configuration.yaml entry
- platform: xiaomi_miio
host: 192.168.1.х
token: YOUR_TOKEN
где 192.168.1.х - ip адрес вашего увлажнителя,
YOUR_TOKEN - полученный в предыдущем шаге токен увлажнителя.
Дополнительно рекомендуется указать модель вашего устройства.
После перезагрузки конфигурации увлажнитель будет доступен в Home Assistant. Но несмотря на то, что я указал модель - не отображался один атрибут - water_level, а это достаточно критично для контроля за количеством воды в увлажнителе, особенно удаленного контроля. Поэтому я начал искать альтернативы.
На просторах HACS был найден кастомный компонент Xiaomi Mi Air Purifier & Xiaomi Mi Air Humidifier, который в итоге показывал нужный мне атрибут. При этом его не надо добавлять через кастомный репозиторий, компонент ищется поиском в самом HACS.
Для дальнейшего удобства работы с увлажнителем я создал отдельный package, доступный по ссылке.
Таким образом объявлен увлажнитель, после этого в объектах появилась сущность fan.humidifier со всеми необходимыми атрибутами.
Далее я создал несколько сенсоров, на основе этих атрибутов:
Это сенсоры температуры, влажности и уровня воды в увлажнителе. Дополнительно были созданы переключатели для управлением некоторыми функциями увлажнителя:
В принципе для комфортного управления увлажнителем достаточно вывести имеющиеся сущности в интерфейс, но есть способ лучше.
Отдельная карточка
В HACS есть карточка mini humidifier, которая в отличие от стандартной карты, умеет работать не только с сущностями humidifier, но и с fan, которым является наш увлажнитель. Добавляем ее. При настройке стоит обратить внимание на указание модели увлажнителя, оно меняется в зависимости от выбранной интеграции. Для моего случая описание карточки выглядит вот так.
А так выглядит сама карточка в кратком и развернутом варианте:
Из карточки можно выставить целевой уровень влажности и скорость вращения вентилятора (Авто, Высокая, Средняя и Низкая), наблюдать за показаниями датчиков (в том числе за количеством оборотов вентилятора) и управлять переключателями. Считаю данную карточку отличной, она дает максимальный функционал при минимальном размере.
На этом интеграция увлажнителя в умный дом Home Assistant закончена. Осталось придумать сценарии и автоматизации, тут все зависит от фантазии и привычек.
Подписывайтесь на мой канал и страницу в инстаграм @smart.home53, чтобы не пропустить новые статьи.
#умный дом #smart home #home assistant #xiaomi #умный дом xiaomi #климат #интернет вещей #iot #технологии #увлажнитель воздуха