Интеграция экосистемы Xiaomi в единую систему умного дома

Иван Корнев·06.04.2026·⏱7 мин

Подключить устройства Xiaomi к Home Assistant можно двумя основными способами: через официальную облачную интеграцию для быстрого старта или через кастомное решение Xiaomi Miot Auto для локального управления без задержек. Выбор метода зависит от типа устройств (Wi-Fi, Zigbee, Bluetooth) и требований к скорости реакции системы. Локальный режим предпочтителен для сценариев, где важна мгновенная реакция (освещение, датчики безопасности), тогда как облако удобно для управления из любой точки мира без сложной настройки сети.

Краткий итог: Для большинства пользователей оптимальным решением является установка интеграции Xiaomi Miot Auto через HACS с выбором режима «Local» (если шлюз поддерживает) или «Cloud». Это обеспечивает баланс между стабильностью и функциональностью.

Поддерживаемые устройства и протоколы

Экосистема Xiaomi обширна, и поддержка в Home Assistant варьируется в зависимости от протокола связи устройства.

Wi-Fi устройства (Yeelight, розетки, очистители): Поддерживаются наилучшим образом. Работают как напрямую, так и через облако.
Zigbee устройства (Aqara, датчики): Требуют наличия шлюза (Hub). В Home Assistant они могут отображаться как устройства самого шлюза или (при использовании альтернативных прошивок шлюза) как отдельные Zigbee-устройства через координатор Zigbee2MQTT.
Bluetooth и BLE устройства: Часто требуют шлюза с поддержкой Bluetooth (например, некоторые модели Xiaomi Gateway 3 или отдельный Bluetooth-адаптер на сервере HA).
Камеры: Подключаются преимущественно через протокол RTSP/ONVIF, если эта функция активирована в приложении Mi Home.

Тип устройства	Рекомендуемый метод подключения	Примечание
Лампы Yeelight	Официальная интеграция / Miot Auto	Мгновенная реакция, работа без интернета
Датчики Aqara (Zigbee)	Шлюз + Miot Auto / Zigbee2MQTT	Через шлюз есть задержка, через Z2M — нативно
Роботы-пылесосы	Miot Auto / Xiaomi Cloud Map Extractor	Позволяет видеть карту помещения в интерфейсе
Камеры	RTSP поток / Интеграция Generic Camera	Требуется включение RTSP в настройках камеры

Подготовка окружения и аккаунта

Перед началом настройки убедитесь, что выполнена базовая подготовка, которая сэкономит время на устранение ошибок.

Единый аккаунт: Все устройства должны быть привязаны к одному аккаунту Xiaomi (Mi Account). Если устройства разбросаны по разным аккаунтам, объедините их или выберите основной.
Регион аккаунта: Запомните регион, выбранный при регистрации (Китай, Европа, Россия, США). Он критически важен для настройки интеграции.
Сетевая доступность: Сервер Home Assistant должен иметь доступ в интернет для облачных методов и находиться в одной локальной подсети с устройствами для локальных методов.
Установка HACS: Для использования расширенных функций настоятельно рекомендуется установить менеджер сообществ HACS (Home Assistant Community Store), если он еще не установлен.

Проблема регионов: Устройства, купленные для китайского рынка (CN), часто не видны в европейской или российской версии облака, и наоборот. Если устройство не находится, проверьте, не сменили ли вы регион в приложении Mi Home после добавления устройства.

Способ 1: Кастомная интеграция Xiaomi Miot Auto (Рекомендуется)

Интеграция Xiaomi Miot Auto является де-факто стандартом для продвинутых пользователей. Она предоставляет доступ к большему количеству параметров устройств, поддерживает локальное управление (где это возможно) и позволяет создавать детальные автоматизации.

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

Откройте интерфейс Home Assistant, перейдите в HACS → Интеграции.
Нажмите кнопку «+» (Добавить репозиторий) или найдите в поиске Xiaomi Miot Auto.
Выберите репозиторий автора al-one и нажмите Скачать.
После загрузки перезагрузите Home Assistant (Настройки → Система → Перезагрузка).

Настройка и подключение

Перейдите в Настройки → Устройства и службы → Добавить интеграцию.
Найдите в списке Xiaomi Miot Auto.
Введите данные своего аккаунта Xiaomi (логин/пароль) и выберите правильный Регион.
Выбор режима работы:
- Cloud: Управление через серверы Xiaomi. Работает всегда, но есть задержка и зависимость от интернета.
- Local: Прямое общение с устройством в локальной сети. Мгновенная реакция, работает без интернета. Доступно не для всех устройств (требуется поддержка со стороны прошивки устройства или шлюза).
- Auto: Система сама попытается выбрать лучший доступный метод.
После авторизации выберите устройства, которые хотите импортировать. Можно выбрать все сразу или добавлять выборочно.

Локальный контроль: Если у вас есть шлюз Xiaomi Gateway 3 (модель ZNDMWG03LM) с прошивкой от pvvx или аналогичной, вы можете получить полный локальный контроль над всеми подключенными к нему Zigbee-устройствами, полностью исключив облако из цепочки.

Способ 2: Официальная интеграция Xiaomi Home

Этот метод подходит для новичков или для устройств, которые плохо поддерживаются сторонними решениями. Он проще в настройке, но функционал может быть ограничен.

В меню Настройки → Устройства и службы нажмите Добавить интеграцию.
Найдите Xiaomi Home (официальная).
Авторизуйтесь, используя свой Mi Account.
Система автоматически подтянет список устройств, доступных в облаке для выбранного региона.

Ограничения:

Часто отсутствуют расширенные настройки (например, яркость цветовой температуры с шагом в 1%, а не 10%).
Зависимость от облака означает, что при отключении интернета автоматизации, завязанные на эти устройства, перестанут работать.
Меньше типов сущностей (entities) доступно для создания сложных сценариев.

Организация локального управления

Для максимальной надежности умного дома важно минимизировать зависимость от внешних серверов.

Устройства Yeelight: Большинство ламп и светильников Yeelight поддерживают режим «LAN Control». В официальном приложении Yeelight нужно включить эту опцию для каждой лампы. После этого Home Assistant будет управлять ими напрямую по локальному IP.
Шлюзы Aqara/Xiaomi: Стандартные шлюзы работают через облако. Для локальной работы требуется либо использование протокола Zigbee2MQTT с отдельным USB-стиком (игнорируя родной шлюз), либо перепрошивка шлюза Xiaomi Gateway 3.
Камеры: В приложении Mi Home для камер включите функцию RTSP. Полученную ссылку (вида rtsp://admin:password@ip_address:554/stream) добавьте в Home Assistant через интеграцию Generic Camera или ONVIF.

Безопасность локальной сети: При включении локального управления (особенно на камерах и розетках) убедитесь, что ваша сеть Wi-Fi защищена надежным паролем и сегментирована (например, через гостевую сеть или VLAN), чтобы скомпрометированное устройство умного дома не дало доступа к основным компьютерам.

Создание полезных автоматизаций

Мощь Home Assistant раскрывается в связке устройств разных производителей. Вот примеры сценариев с участием техники Xiaomi.

Сценарий «Умный свет в коридоре»

Используем датчик движения Aqara и лампу Yeelight.

Триггер: Состояние датчика движения меняется на on.
Условие: Уровень освещенности (если есть в датчике) ниже 50 люкс И время между 23:00 и 07:00.
Действие: Включить лампу Yeelight с яркостью 20% и теплой температурой (чтобы не будить себя ярким светом).
Доп. действие: Через 1 минуту без движения выключить свет.

Сценарий «Безопасный уход из дома»

Используем датчик открытия двери и умные розетки.

Триггер: Датчик открытия входной двери меняет состояние на off (дверь закрыта).
Условие: Режим охраны активирован (или геолокация показывает, что все жильцы ушли).
Действие: Выключить все розетки в группе «Развлечения» (ТВ, приставка, колонки) для экономии энергии и пожарной безопасности.

Частые ошибки и их решение

Проблема	Возможная причина	Решение
Ошибка авторизации	Неверный регион или двухфакторная аутентификация	Проверьте регион аккаунта. Если включена 2FA, может потребоваться создание специального пароля приложения в настройках аккаунта Xiaomi.
Устройства «Недоступны»	Смена локального IP или проблемы с сетью	Закрепите статический IP-адрес для шлюза и устройств в настройках роутера. Проверьте, не блокирует ли фаервол порты.
Задержка команд	Используется только облачный режим	Переключите режим интеграции Miot Auto на «Local» или настройте локальный контроль для конкретных устройств (Yeelight).
Отсутствуют некоторые параметры	Официальная интеграция ограничена	Перейдите на использование Miot Auto, она вытягивает больше свойств (properties) из спецификации устройства.

FAQ

В: Можно ли использовать устройства Xiaomi без интернета? О: Да, но только частично. Устройства с прямым управлением по локальной сети (некоторые Yeelight, перепрошитые шлюзы) будут работать. Устройства, требующие облачного туннеля (большинство стандартных шлюзов Aqara), без интернета функционировать не смогут.

В: Что лучше: родной шлюз Xiaomi или стик Zigbee2MQTT? О: Для глубокой интеграции в Home Assistant стик Zigbee2MQTT (например, Sonoff Zigbee 3.0) значительно лучше. Он делает каждое устройство нативным для HA, убирает задержки шлюза и позволяет обновлять прошивки устройств прямо из интерфейса. Родной шлюз проще для начальной настройки, но выступает как «черный ящик».

В: Как добавить карту робота-пылесоса Xiaomi в интерфейс? О: Используйте интеграцию Xiaomi Cloud Map Extractor (доступна в HACS). Она позволяет выгружать карту уборки, зоны и виртуальные стены прямо в панель управления Home Assistant, создавая красивые визуализации статуса уборки.