Всем привет! Это моя первая статья на Дзене. Я решил написать эту статью, так как, несмотря на обилие информации о HA, на русском языке мне не удалось найти подробного руководства по данной теме. В интернете есть всего одно видео на польском языке, и я хочу заполнить этот пробел в информации.
Я давно мечтал избавиться от зависимости от сторонних приложений в своем умном доме. Однако единственной проблемой, с которой я так и не смог справиться полностью в рамках HA, была интеграция моего робота-пылесоса (а именно - интеграция карты). У меня модель Viomi V2, но данное руководство будет полезным для всех владельцев пылесосов Xiaomi и Roborock. Давайте начнем!
Установка интеграций
Первым шагом в нашем процессе будет установка двух репозиториев из HACS:
- Xiaomi Cloud Map Extractor: Эта интеграция позволит нам извлекать карту, которую создает ваш робот-пылесос и хранит в облаке.
- Xiaomi Vacuum Map Card: Это пользовательский элемент интерфейса, который мы будем использовать для отображения карты, полученной с помощью первой интеграции.
Давайте разберемся, как установить и настроить эти интеграции.
- Шаг 1: Откройте Home Assistant и перейдите в раздел HACS (Home Assistant Community Store).
- Шаг 2: В HACS выберите "Интеграции" (Integrations) и в поисковой строке введите "Xiaomi Cloud Map Extractor". Найдите эту интеграцию и установите ее.
- Шаг 3: Теперь вернитесь в HACS и зайдите в раздел "Пользовательский интерфейс" (User Interface) и введите "Xiaomi Vacuum Map Card" в поисковой строке. Установите эту карточку интерфейса.
- Шаг 4: После установки обеих интеграций, перезапустите Home Assistant, чтобы изменения вступили в силу.
С этими двумя интеграциями у вас появится возможность извлекать и отображать карту, созданную вашим роботом-пылесосом.
Получение данных робота-пылесоса
Чтобы получить IP-адрес и секретный ключ вашего робота-пылесоса для интеграции с Home Assistant, вы можете воспользоваться различными методами, описанными в статье "Xiaomi-cloud-tokens-extractor". Вот наиболее простой способ для пользователей Windows:
- Заходим на GitHub по ссылке выше, листаем вниз и скачиваем файл token_extractor.exe
- Запускаем этот файл (при этом Windows может поругаться на то, что это нежелательная программа).
- Вводим свою почту или ID от MiHome, а затем пароль. Далее программа просит нас выбрать сервер, на котором находится Ваш пылесос. У меня это ru.
- Ищем в списке устройств Ваш пылесос и сохраняем полученные токен и IP-адрес (либо просто пока что не закрываем программу).
Настройка интеграции
Возвращаемся в Home Assistant и через File Editor заходим в файл configuration.yaml. Вставляем следующий код:
camera:
- platform: xiaomi_cloud_map_extractor
host: !secret xiaomi_vacuum_host
token: !secret xiaomi_vacuum_token
username: !secret xiaomi_cloud_username
password: !secret xiaomi_cloud_password
draw: ['all']
attributes:
- calibration_points
Сохраняем.
Далее заходим в файл secrets.yaml и вставляем этот код:
xiaomi_vacuum_host: "VACUUM-IP-ADDRESS"
xiaomi_vacuum_token: "VACUUM-TOKEN"
xiaomi_cloud_username: "XIAOMI-EMAIL"
xiaomi_cloud_password: "XIAOMI-PASSWORD"
Где:
- VACUUM-IP-ADDRESS - IP-адрес Вашего пылесоса из программы
- VACUUM-TOKEN - Токен пылесоса из программы
- XIAOMI-EMAIL - Ваш логин от MiHome
- XIAOMI-PASSWORD - Ваш пароль от MiHome
Обратите внимание, что все вышеперечисленные данные должны быть в кавычках!
Сохраняем и перезапускаем Home Assistant.
Добавление карточки карты пылесоса
Для добавления карточки с картой вашего робота-пылесоса в Home Assistant, у вас уже должна быть настроена интеграция с вашим роботом-пылесосом, такой как "Xiaomi Miot Auto" или другой подходящей интеграцией. После этого следуйте этим шагам:
- Войдите в режим редактирования основной панели: На главной странице Home Assistant нажмите кнопку редактирования, которая обычно выглядит как значок "Редактировать интерфейс".
- Добавьте карточку: После входа в режим редактирования, нажмите "Добавить карточку".
- Найдите и выберите Vacuum Map Card: В поиске карточек введите "Vacuum Map Card" и выберите эту карточку.
В графе "Сущность пылесоса" выбираем наш пылесос. Готово!
Итог
На карте будет видно расположение пылесоса, его передвижение и последний маршрут.
Касательно создания зон уборки и отправки робота-пылесоса убираться в определенных областях, иногда возникают ограничения, особенно в зависимости от модели робота-пылесоса и использованных интеграций. Появление ошибок при попытке создания зон может быть связано с несовместимостью или ограничениями в интеграции Xiaomi Miot Auto или другой интеграции, которую вы используете.
Для дополнительных настроек карточки, таких как изменение зума, цветов карты и добавление названий комнат, вам потребуется редактировать файл configuration.yaml. Подробные инструкции по редактированию карты можно найти в двух статьях на GitHub, указанных выше. Следуйте этим инструкциям, чтобы настроить карточку под свои потребности и предпочтения.
Благодарю вас за внимание! Надеюсь, что данная статья оказалась полезной и помогла вам разобраться в процессе добавления карточки с картой пылесоса в Home Assistant.
