Настройка с локальным подключением Не рекомендуется

Этот метод следует использовать для установления прямого локального подключения к роботу-пылесосу без необходимости постоянного облачного соединения. Чтобы использовать этот метод, устройство должно быть успешно добавлено в официальное приложение Xiaomi Home (доступное для iOS и Android) хотя бы один раз для генерации действительного токена. Кроме того, оно должно оставаться привязанным к аккаунту во время этого шага настройки, чтобы интеграция могла получить необходимый IP-адрес и токен из облака.

Совместимость устройств

Этот метод подключения поддерживается исключительно для устройств, выпущенных до 2022 года и поддерживаемых приложением Xiaomi Home. Если устройство не может быть добавлено в приложение Xiaomi Home, оно ни при каких условиях не предоставит локальный API с любым токеном.

Поддержка карт отсутствует Не рекомендуется

Технически невозможно получить данные карты через локальный API. В результате метод локального подключения предоставляет отсутствие поддержки карты, что полностью отключает несколько ключевых функций, зависящих от данных карты, таких как История уборок, Восстановление карт, и динамическое Сущности комнат. Поскольку карта и зависимые от нее функции являются центральными для основной функциональности интеграции, этот метод подключения строго не рекомендуется. Для полного и полностью функционального использования настоятельно рекомендуется использовать один из методов облачного подключения.

Получение IP и токена

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

Требование к подсети

По соображениям безопасности устройство отвечает только на запросы, поступающие из своей собственной подсети. Следовательно, робот-пылесос и Home Assistant должны находиться точно в одной и той же подсети, чтобы локальная связь работала. См. эту статью python-miio для устранения проблем с межподсетевым взаимодействием.

Метод 1: Извлечение токенов Xiaomi Cloud Рекомендуется

Это самый надёжный метод. Он работает на Windows, macOS или Linux, подключаясь напрямую к серверам Xiaomi Cloud для получения IP-адресов и токенов всех устройств, связанных с аккаунтом, одновременно.

1. Скачать инструмент: Скачайте соответствующую версию (например, .exe для Windows) Xiaomi Cloud Tokens Extractor с GitHub.
2. Запустить приложение: Выполните загруженный файл, чтобы открыть терминальный интерфейс.
3. Введите учётные данные: Укажите точное имя пользователя (Email или Xiaomi ID) и пароль, используемые в приложении Xiaomi Home.
4. Выберите регион сервера: Укажите регион сервера, соответствующий приложению Xiaomi Home (например, de для Европы). Если регион неизвестен, оставьте поле пустым и нажмите Enter, чтобы просканировать все доступные серверы.
5. Получение токена: Инструмент выведет список всех устройств, подключенных к аккаунту. Найдите целевой пылесос в списке и скопируйте соответствующий ему 32-значный токен.

Метод 2: Настольное GUI-приложение (Get_MiHome_devices_token)

Для пользователей, которые предпочитают графический интерфейс командной строке, доступно настольное приложение.

1. Скачать приложение: Скачайте и установите приложение Get_MiHome_devices_token с GitHub.
2. Вход в систему: Откройте приложение, введите учетные данные Xiaomi и выберите соответствующий регион сервера.
3. Получение токена: После аутентификации будут отображены все связанные устройства вместе с их IP-адресами и токенами в табличном формате.

Метод 3: Модифицированное приложение Mi Home для Android Не рекомендуется

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

1. Удаление оригинального приложения: Полностью удалите официальное приложение Mi Home с Android-устройства. (Примечание: Устройства останутся безопасно привязанными к учетной записи в облаке).
2. Установка модифицированного приложения: Поискать в интернете модифицированный APK "MiHome от Vevs", скачать последнюю версию и установить её на устройство.
3. Вход в систему: Откройте модифицированное приложение и войдите, используя учетные данные Xiaomi.
4. Получение токена: Выберите целевой пылесос, чтобы открыть его интерфейс управления. Нажмите на три точки в правом верхнем углу, чтобы зайти в настройки, затем перейдите в раздел Сетевые данные или Основные настройки. IP-адрес устройства и токен будут непосредственно видны на этом экране.