Xiaomi Miot Auto в Home Assistant: установка, настройка и подключение устройств Xiaomi

Xiaomi — пожалуй, самый массовый производитель умных устройств на российском рынке. Пылесосы, лампы, розетки, датчики, очистители воздуха, увлажнители — всё это есть почти в каждом доме. Но вот беда: родное приложение Mi Home работает через облако, а это значит — задержки, зависимость от серверов и отсутствие нормальной локальной автоматизации.

Решение — интеграция Xiaomi Miot Auto для Home Assistant. Она умеет подключать устройства Xiaomi как через облако, так и локально, открывая доступ к десяткам параметров, которые не видны в стандартном приложении. Сегодня разберём установку, настройку и типичные грабли.

Что такое Xiaomi Miot Auto и зачем она нужна

Xiaomi Miot Auto — это пользовательская интеграция (custom component) для Home Assistant, которая позволяет управлять устройствами экосистемы Xiaomi через протокол MiIO и MiOT. В отличие от официального компонента Xiaomi Miio, Miot Auto поддерживает гораздо больше моделей устройств и открывает доступ к расширенным возможностям: мониторинг состояния фильтров, управление режимами, получение телеметрии с датчиков и многое другое.

Ключевые возможности:

• подключение устройств через облако Xiaomi или по локальной сети;
• автоматическое определение модели и доступных сервисов;
• поддержка более 2000 моделей устройств;
• регулярные обновления с добавлением новых устройств;
• возможность использовать несколько аккаунтов Xiaomi;
• работа с устройствами через Mi Home, а также с устройствами, привязанными к региону Китай.

Интеграция распространяется через HACS (Home Assistant Community Store). Если вы ещё не знакомы с HACS, рекомендую прочитать статью HACS: установка, настройка и безопасное обновление пользовательских интеграций Home Assistant — там подробно описан процесс установки и обновления сторонних компонентов.

Подготовка: что нужно знать до установки

Прежде чем приступать к установке, соберите информацию:

1. Аккаунт Xiaomi — тот же, что используется в приложении Mi Home.
2. Регион аккаунта — Россия, Китай, Сингапур и т.д. Это критически важно: если регион указан неверно, интеграция не сможет авторизоваться.
3. IP-адреса устройств — желательно зарезервировать их в роутере по MAC-адресу, чтобы адреса не менялись.
4. Токен устройства — понадобится для локального подключения. О способах его получения расскажу ниже.

Важный момент: интеграция работает с устройствами, которые уже добавлены в приложение Mi Home. Если устройство не привязано к аккаунту, сначала добавьте его в Mi Home.

Установка Xiaomi Miot Auto через HACS

Шаг 1. Установка HACS

Если HACS ещё не установлен, сначала поставьте его. Подробная инструкция есть в статье Как устанавливать репозитории из GitHub в Home Assistant: HACS, custom_components и ручной способ. Кратко: скачайте архив с GitHub, распакуйте в папку custom_components/hacs и перезапустите Home Assistant.

Шаг 2. Добавление репозитория Xiaomi Miot Auto

В HACS перейдите в раздел Интеграции (Integrations), нажмите на три точки в правом верхнем углу и выберите Пользовательские репозитории (Custom repositories).

В поле для URL вставьте:

https://github.com/al-one/hass-xiaomi-miot

В выпадающем списке категорий выберите Интеграция и нажмите Добавить.

Шаг 3. Установка интеграции

После добавления репозитория найдите Xiaomi Miot Auto в списке интеграций HACS и нажмите Скачать (Download). HACS предложит выбрать версию — оставьте последнюю стабильную.

После завершения загрузки перезапустите Home Assistant:

ha core restart

Или через интерфейс: Настройки → Система → Перезапустить.

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

После перезапуска переходим в Настройки → Устройства и службы и нажимаем Добавить интеграцию. В поиске введите Xiaomi Miot Auto.

Способ 1: Подключение через облако

Самый простой способ — авторизация через аккаунт Xiaomi:

1. Выберите Добавить аккаунт Xiaomi.
2. Укажите регион вашего аккаунта (Россия — ru, Китай — cn, и т.д.).
3. Введите имя пользователя и пароль от Mi Home.
4. Нажмите Вход.

Интеграция подключится к облаку Xiaomi и автоматически обнаружит все устройства, привязанные к аккаунту. Этот способ удобен для первичной настройки, но для постоянной работы лучше использовать локальное подключение — оно быстрее и не зависит от облака.

Способ 2: Локальное подключение по IP

Для локального подключения нужно знать IP-адрес устройства и его токен. Если токен неизвестен, есть несколько способов его получить.

Способ A: Извлечение токена из резервной копии Mi Home

На Android-устройствах можно вытащить токен из бэкапа приложения Mi Home. Для этого понадобится root-доступ или специальные инструменты. Процесс нетривиальный, поэтому большинство пользователей идут другим путём.

Способ B: Использование сторонних инструментов

Существуют утилиты для извлечения токенов, например, micloud или скрипты на Python. Один из популярных вариантов — использование библиотеки python-miio:

pip install python-miio
miio device --ip 192.168.1.100 --token YOUR_TOKEN info

Но чтобы получить токен, нужно сначала его где-то взять. Наиболее рабочий способ — перехват трафика при добавлении устройства в Mi Home или использование инструментов вроде mi-cloud-tokens.

Способ C: Использование облачного подключения для получения токена

На практике проще сначала подключить устройство через облако (способ 1), а затем в настройках интеграции посмотреть, какие параметры доступны. Многие устройства Miot Auto автоматически определяют токен при облачном подключении и сохраняют его для последующего локального использования.

Добавление устройства вручную

Если автоматическое обнаружение не сработало, добавьте устройство вручную:

1. В мастере настройки выберите Добавить устройство вручную.
2. Укажите IP-адрес устройства.
3. Введите токен (если есть).
4. Выберите модель устройства из списка.

После добавления устройства проверьте, что оно появилось в списке объектов Home Assistant.

Настройка через configuration.yaml

Xiaomi Miot Auto поддерживает настройку через configuration.yaml. Это удобно для тонкой настройки и автоматизации. Вот пример базовой конфигурации:

# Пример настройки Xiaomi Miot Auto
xiaomi_miot:
  - host: 192.168.1.100
    token: "ваш_токен"
    model: "zhimi.airpurifier.m1"
    name: "Очиститель воздуха"
  - host: 192.168.1.101
    token: "ваш_токен"
    model: "roborock.vacuum.s5"
    name: "Робот-пылесос"

Параметры:

• host — IP-адрес устройства;
• token — токен устройства (обязателен для локального подключения);
• model — модель устройства (можно посмотреть в Mi Home или в логах);
• name — понятное имя для отображения в Home Assistant.

После изменения конфигурации перезапустите Home Assistant:

ha core restart

Подключение конкретных типов устройств

Пылесосы Roborock и Xiaomi

Пылесосы подключаются через Miot Auto с полной поддержкой карт и зон уборки. После подключения в Home Assistant появятся следующие сущности:

• vacuum.robot_pylesos — основная сущность для управления;
• sensor.robot_pylesos_battery — уровень заряда;
• sensor.robot_pylesos_main_brush_life — ресурс основного вала;
• switch.robot_pylesos_carpet_mode — режим ковров.

Для управления зонами уборки потребуется дополнительная настройка карт. Miot Auto поддерживает загрузку карт через облако, но для этого нужно указать map_type в конфигурации:

xiaomi_miot:
  - host: 192.168.1.100
    token: "ваш_токен"
    model: "roborock.vacuum.s5"
    attributes:
      - map_type: "full"

Очистители воздуха

Для очистителей воздуха Miot Auto открывает доступ к датчикам качества воздуха, ресурсу фильтра и режимам работы. Пример сущностей:

• fan.ochistitel_vozduha — управление скоростью и режимами;
• sensor.ochistitel_vozduha_aqi — индекс качества воздуха;
• sensor.ochistitel_vozduha_filter_life — остаток ресурса фильтра;
• switch.ochistitel_vozduha_child_lock — блокировка от детей.

Умные розетки и выключатели

С розетками всё просто: Miot Auto создаёт стандартные сущности switch, которые можно использовать в автоматизациях. Дополнительно доступны датчики мощности и энергии:

• switch.umnaya_rozetka — вкл/выкл;
• sensor.umnaya_rozetka_power — текущая мощность в Вт;
• sensor.umnaya_rozetka_energy — накопленная энергия в кВт·ч.

Датчики температуры и влажности

Датчики Xiaomi (например, Mijia BT Temp & Humidity) подключаются через шлюз или напрямую через Bluetooth. Miot Auto поддерживает работу через шлюз Zigbee. После подключения появятся:

• sensor.temperatura — температура;
• sensor.vlazhnost — влажность.

Если вы используете Zigbee-устройства, возможно, стоит рассмотреть альтернативный вариант подключения через Zigbee2MQTT — об этом есть отдельная статья Sonoff Zigbee 3.0 USB Dongle Plus в Home Assistant: настройка ZHA и Zigbee2MQTT.

Типичные ошибки и их решение

Ошибка авторизации: «Неверный регион»

Самая частая проблема — неправильно указан регион аккаунта. Если вы регистрировались в Mi Home с российским номером, регион — ru. Для китайских аккаунтов — cn. Проверить регион можно в приложении Mi Home: Профиль → Настройки → Регион.

Устройство не обнаружено

Если автоматическое обнаружение не находит устройство, проверьте:

1. Устройство добавлено в Mi Home и находится в сети.
2. IP-адрес устройства доступен с хоста, где работает Home Assistant.
3. На роутере не включена изоляция клиентов (AP isolation).

Проверить доступность устройства можно командой:

ping 192.168.1.100

Устройство определяется, но не все функции доступны

Miot Auto определяет доступные сервисы на основе модели устройства. Если какие-то функции не работают, проверьте, что у вас установлена последняя версия интеграции. Также обратите внимание на модель устройства — некоторые функции доступны только через облако.

Постоянные разрывы соединения

Если локальное подключение нестабильно, попробуйте:

1. Зарезервировать IP-адрес устройства в роутере.
2. Убедиться, что устройство не уходит в спящий режим.
3. Использовать облачное подключение, если локальное нестабильно.

Автоматизации с Xiaomi Miot Auto

После подключения устройств можно создавать автоматизации. Вот несколько примеров.

Автоматизация: включение очистителя при плохом качестве воздуха

automation:
  - alias: "Включить очиститель при высоком AQI"
    trigger:
      - platform: numeric_state
        entity_id: sensor.ochistitel_vozduha_aqi
        above: 100
    action:
      - service: fan.turn_on
        target:
          entity_id: fan.ochistitel_vozduha

Автоматизация: уведомление о низком заряде пылесоса

automation:
  - alias: "Пылесос разряжен"
    trigger:
      - platform: numeric_state
        entity_id: sensor.robot_pylesos_battery
        below: 20
    action:
      - service: notify.telegram
        dаta:
          message: "Пылесос разряжен ({{ states('sensor.robot_pylesos_battery') }}%)"

Автоматизация: выключение розетки по таймеру

automation:
  - alias: "Выключить розетку через час"
    trigger:
      - platform: state
        entity_id: switch.umnaya_rozetka
        to: "on"
    action:
      - delay:
          minutes: 60
      - service: switch.turn_off
        target:
          entity_id: switch.umnaya_rozetka

Xiaomi Miot Auto и локальное управление

Одно из главных преимуществ Miot Auto — возможность локального управления без облака. Для этого нужно, чтобы устройства поддерживали локальный протокол MiIO. Большинство устройств Xiaomi, выпущенных после 2019 года, поддерживают его.

Чтобы перевести устройство в локальный режим:

1. Подключите устройство через облако.
2. В настройках интеграции найдите устройство.
3. Проверьте, что в свойствах устройства указан IP-адрес и токен.
4. Отключите интернет на роутере (или заблокируйте доступ устройства к облаку) и проверьте, работает ли управление.

Если управление работает без интернета — устройство поддерживает локальный режим. Если нет — придётся оставить облачное подключение.

Важно: некоторые устройства (особенно новые модели) могут требовать периодического подключения к облаку для синхронизации. В этом случае полный локальный режим невозможен.

Альтернативы Xiaomi Miot Auto

Если Miot Auto не справляется с вашими устройствами, есть альтернативы:

• Xiaomi Miio — официальная интеграция Home Assistant, но поддерживает ограниченное количество моделей.
• Home Assistant Cloud — платная облачная интеграция, но работает не со всеми устройствами Xiaomi.
• LocalTuya — для устройств Tuya, а не Xiaomi. Подробнее в статье LocalTuya. Перепрошивка розеток Tuya: Как отвязать розетку от облака.

Если вы только строите умный дом и выбираете между Zigbee и Wi-Fi устройствами, обратите внимание на статью Умные розетки для Home Assistant: Zigbee vs Wi-Fi — что купить. Zigbee-устройства часто работают стабильнее и не зависят от облака.

Заключение

Xiaomi Miot Auto — это мощный инструмент для интеграции устройств Xiaomi в Home Assistant. Она открывает доступ к расширенным функциям, которые недоступны в официальном приложении, и позволяет создавать сложные автоматизации.

Главное — правильно настроить подключение: указать верный регион аккаунта, получить токены устройств и по возможности перевести всё на локальное управление. Это избавит вас от задержек и зависимости от облачных серверов.

Если вы только начинаете знакомство с Home Assistant, советую также прочитать статьи о визуальной автоматизации через Node-RED и создании красивого дашборда. А если задумываетесь о покупке Zigbee-координатора для расширения экосистемы — статья Второй координатор Zigbee2MQTT: зачем нужен и как настроить будет полезна.

Удачной автоматизации!