🔌 Интеграция

Xiaomi Home

Официальная интеграция Xiaomi Home для Home Assistant с поддержкой Xiaomi IoT. Используйте устройства Xiaomi в своём умном доме.

Информация о версии

Компонент Версия
Операционная система 15.2
Home Assistant Core 2025.5.3
Xiaomi Home 0.1.4

1. Подготовка

Важно: Перед началом установки убедитесь, что вы ознакомились с базовыми учебниками по Home Assistant.

Перед установкой интеграции Xiaomi Home убедитесь, что у вас:

  • Установлен и настроен Home Assistant
  • Установлен HACS (Home Assistant Community Store)
  • Аккаунт Xiaomi (Mi Account)
  • Устройства Xiaomi, добавленные в приложение Mi Home

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

Шаг 1: Добавление пользовательского репозитория

1 Откройте HACS и перейдите в меню (три точки ︙) > Custom repositories (Пользовательские репозитории)

Шаг 2: Добавление интеграции

2 В поле Repository вставьте адрес проекта, в поле Type выберите Integration и нажмите ADD

Адрес проекта: https://github.com/XiaoMiHowMi/home_assistant_xiaomi_home

Шаг 3: Поиск интеграции

3 После успешного добавления выполните поиск "xiaomi home"

Шаг 4: Скачивание

4 Нажмите на найденную интеграцию, затем нажмите кнопку "DOWNLOAD". В появившемся диалоговом окне подтвердите скачивание.

Шаг 5: Перезагрузка

5 Перейдите в Настройки > Система > Обновления. Найдите иконку Xiaomi с надписью "restart required" и нажмите提交 (Отправить). Core автоматически перезагрузится.

3. Настройка интеграции

Шаг 1: Добавление интеграции

1 После завершения перезагрузки системы перейдите в: Настройки > Устройства и службы > Добавить интеграцию и введите в поиске "xiaomi home"

Шаг 2: Согласие с условиями

2 Поставьте галочку "Я ознакомлен с условиями..." и нажмите "Далее"

Шаг 3: Подтверждение

3 Проверьте правильность информации и нажмите "Далее"

Шаг 4: Авторизация

4 Нажмите "Нажмите здесь для входа"

Шаг 5: Вход в аккаунт Xiaomi

5 Войдите в свой аккаунт Xiaomi. После успешного входа вернитесь в HA, где вы увидите информацию об аккаунте.

Шаг 6: Выбор устройств

6 Выберите устройства, которые хотите импортировать, и режим синхронизации, затем нажмите "Далее"

Шаг 7: Завершение

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

Важные замечания

Взаимодополняемость: В настоящее время Xiaomi MIOT Auto и Xiaomi Home находятся во взаимодополняющих отношениях. Некоторые устройства могут отображаться в MIOT, но не отображаться в Home.

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

Решение проблем

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

Если ваши устройства не отображаются после настройки:

  • Проверьте, что устройства добавлены в приложение Mi Home
  • Убедитесь, что используете правильный регион в аккаунте Xiaomi
  • Попробуйте удалить и снова добавить интеграцию
  • Проверьте логи Home Assistant на наличие ошибок

Проблемы с авторизацией

Если возникают проблемы при входе в аккаунт Xiaomi:

  • Убедитесь, что используете правильные учётные данные
  • Проверьте, что двухфакторная аутентификация настроена корректно
  • Попробуйте использовать другой браузер для авторизации