Xiaomi в Home Assistant подключается несколькими способами: встроенной интеграцией Xiaomi Miio (по токену устройства), официальной интеграцией Xiaomi Home из HACS (вход через аккаунт Mi Home), популярным компонентом Xiaomi Miot Auto и напрямую через Zigbee и Bluetooth для датчиков. Какой выбрать — зависит от модели устройства: пылесос, увлажнитель, лампа или датчик. Ниже — разбор способов, получение токена и типичные ошибки.
1Способы подключения устройств Xiaomi
Экосистема Xiaomi состоит из устройств разных поколений и протоколов: Wi-Fi-приборы с протоколом miIO, новые устройства на спецификации MIoT, Zigbee-датчики и Bluetooth-термометры. Единого способа для всех нет, поэтому сначала определите, что именно вы подключаете.
| Способ | Для чего | Нужен токен | Облако |
|---|---|---|---|
| Xiaomi Miio (встроена) | Пылесосы, очистители воздуха, увлажнители, лампы | Да | Нет, локально |
| Xiaomi Home (HACS, официальная) | Широкий набор устройств из аккаунта Mi Home | Нет, вход через аккаунт | Облако и локальные возможности |
| Xiaomi Miot Auto (HACS) | Устройства MIoT, нестандартные функции | Да или вход в аккаунт | Локально и облако |
| Zigbee (ZHA / Zigbee2MQTT) | Датчики Xiaomi/Aqara | Нет | Нет |
| Xiaomi BLE (встроена) | Bluetooth-термометры и датчики | Ключ для части моделей | Нет |
Состав интеграций и их возможности меняются от релиза к релизу, поэтому перед установкой прочитайте актуальное описание на странице проекта в HACS.
2Подключение через Xiaomi Home и HACS
Это самый простой способ для новичка, если устройства уже добавлены в приложение Mi Home. Интеграция использует вход в учётную запись и подтягивает устройства, которые умеет обрабатывать.
- Установите HACS (см. нашу статью про HACS), затем найдите в нём интеграцию Xiaomi Home и установите её.
- Перезагрузите Home Assistant.
- Откройте «Настройки» → «Устройства и службы» → «Добавить интеграцию» и выберите Xiaomi Home.
- Выберите регион сервера, где зарегистрирован ваш аккаунт. Для России обычно используют сервер Russia или Mainland China: сверьтесь с региональными настройками в приложении Mi Home.
- Авторизуйтесь через аккаунт Xiaomi и разрешите доступ.
- Выберите устройства и помещения для импорта.
Часть функций (например, управление через локальную сеть) требует дополнительных условий, в том числе центрального шлюза Xiaomi. Читайте требования в документации интеграции.
3Как получить токен для Xiaomi Miio и Miot
Для локального управления Wi-Fi-устройств нужен токен: 32-символьный ключ. Его можно получить несколькими способами.
- Установите интеграцию Xiaomi Miot Auto через HACS: при входе в аккаунт Xiaomi она сама получает токены ваших устройств из облака.
- Либо воспользуйтесь открытыми утилитами для извлечения токенов из аккаунта Xiaomi (например, Xiaomi Cloud Tokens Extractor). Запускайте только проверенные утилиты из открытых репозиториев и никогда не вводите пароль на непонятных сайтах.
- Зафиксируйте IP-адрес устройства в роутере.
- В Home Assistant добавьте интеграцию Xiaomi Miio, укажите IP и токен.
Если вы сбросите устройство или заново подключите его к Wi-Fi, токен может измениться, и интеграцию придётся перенастроить.
Нет времени разбираться с токенами? Мы можем настроить Home Assistant под ключ и подключить вашу технику Xiaomi.
4Xiaomi Miot Auto: когда нужен
Компонент Xiaomi Miot Auto поддерживает огромное число устройств по спецификации MIoT и автоматически создаёт сущности для всех свойств и действий. Это удобно для техники, у которой стандартная интеграция даёт только базовые функции: например, режимы очистителя, расписания пылесоса или детальные настройки кондиционера. Плата за гибкость — большое количество сущностей и возможные изменения после обновлений. Отключайте всё лишнее, чтобы не засорять систему.
5Xiaomi Zigbee и Bluetooth датчики
Датчики температуры, движения, открытия двери и кнопки Xiaomi работают по Zigbee. Подключайте их напрямую к Zigbee-стику через ZHA или Zigbee2MQTT и не используйте родной шлюз Xiaomi в Home Assistant, если нет особой причины: так всё остаётся локальным. Это относится и к датчикам Aqara, о которых мы пишем в отдельной статье. Bluetooth-термометры Xiaomi (например, на чипе LYWSD03MMC) работают через встроенные интеграции Bluetooth и Xiaomi BLE; для части моделей потребуется ключ шифрования (bindkey).
6Пример автоматизации с пылесосом
После подключения пылесос управляется как сущность vacuum. Пример запуска уборки, когда все уходят из дома:
alias: Уборка при уходе из дома
triggers:
- trigger: state
entity_id: zone.home
to: "0"
conditions:
- condition: time
after: "09:00:00"
before: "20:00:00"
actions:
- action: vacuum.start
target:
entity_id: vacuum.robot_pylesos
mode: singleТакой сценарий можно быстро собрать в конструкторе автоматизаций. Если нужна логика посложнее, например уборка по расписанию с учётом присутствия гостей, закажите автоматизацию на заказ.
7Региональные особенности и подводные камни
- Регион сервера. Устройства привязаны к региональному серверу аккаунта. Если выбрать не тот, список окажется пустым.
- Облачные ограничения. Xiaomi периодически меняет правила доступа к облаку. Локальные интеграции устойчивее.
- Различия версий. Устройства для китайского рынка и глобальные версии отличаются по прошивке и функциям; на китайских версиях может не быть русского языка.
- Смена Wi-Fi. После смены роутера или пароля сети придётся заново подключать устройства к Wi-Fi, что часто меняет токен.
- Несколько сетей. Если у Home Assistant и устройств разные подсети, локальные запросы не пройдут.
8Пример: очиститель воздуха Xiaomi
Очиститель воздуха Xiaomi удобно связать с датчиком качества воздуха: при превышении порога прибор переходит в автоматический режим, а ночью снижает шум. После подключения через Xiaomi Miio или Miot Auto вы получаете сущности вентилятора, датчиков PM2.5, влажности и температуры. Используйте их в графиках на дашборде: так видно, как работает фильтр и когда пора его менять.
Для увлажнителей и климатической техники действует то же правило: сначала проверьте, какие функции предоставляет интеграция, затем соберите сценарии вокруг реальных данных датчиков. Не забывайте про срок службы расходников: Home Assistant может отправлять уведомление, когда ресурс фильтра близок к нулю, если интеграция отдаёт такой параметр.
9Приватность и аккаунт Xiaomi
Для облачных интеграций вы передаёте в Home Assistant доступ к аккаунту. Поэтому заведите отдельную учётную запись только для умного дома и пригласите её в семью Mi Home, вместо того чтобы использовать основной аккаунт со всеми покупками и платёжными данными. Включите двухфакторную защиту, а токены не сохраняйте в открытом виде вне Home Assistant. После окончания эксперимента отозвайте доступ и удалите неиспользуемые интеграции.
Если вы живёте в России, учитывайте и доступность сервисов: облако Xiaomi может отвечать медленнее и периодически менять правила доступа. Это ещё один довод в пользу локальных способов.
Для начала достаточно одного-двух устройств: подключите, проверьте стабильность на протяжении недели и только потом расширяйте систему. Так проще заметить, какая из интеграций ведёт себя нестабильно.
10Частые вопросы
Нужно ли отключать приложение Mi Home?
Нет. Приложение и Home Assistant могут работать одновременно, но управление лучше вести из одного места, чтобы избежать конфликтов расписаний.
Что делать, если токен не подходит?
Проверьте IP-адрес и модель устройства. Попробуйте получить токен заново, а также убедитесь, что устройство подключено к той же сети.
Как подключить Xiaomi Gateway?
Современный способ — не использовать шлюз для Zigbee, а подключать датчики к собственному стику. Шлюз остаётся полезен для устройств, которые иначе недоступны, но для него потребуется отдельный компонент из HACS.
Безопасно ли вводить аккаунт Xiaomi в интеграции?
Устанавливайте только популярные интеграции из HACS с открытым кодом и активным сопровождением. Для дополнительной защиты используйте отдельный аккаунт Xiaomi только для умного дома.
11Итог
Для новых устройств попробуйте Xiaomi Home или Xiaomi Miot Auto через HACS, для классической техники — встроенную Xiaomi Miio с токеном, а датчики лучше подключать по Zigbee напрямую. Так вы получите быстрый локальный отклик и не будете зависеть от облака.
