Как узнать токен робота пылесоса Xiaomi Vacuum Mop Essential

Владельцы умной техники Xiaomi часто сталкиваются с необходимостью интеграции своих устройств в сторонние системы управления, такие как Home Assistant, или просто хотят получить доступ к расширенным функциям через локальный API. Ключевым элементом в этой цепочке становится токен устройства — уникальный цифровой ключ, который позволяет внешним приложениям управлять роботом-пылесосом без участия облачного сервера Mi Home. Без этого кода большинство продвинутых сценариев автоматизации останутся недоступными.

Модель Xiaomi Vacuum Mop Essential (часто маркируемая как STYTJ01YM или MJSTG1) имеет свои особенности подключения, отличные от флагманских версий с лазерным дальномером. Процесс получения токена здесь может быть сопряжен с определенными трудностями из-за специфики протокола шифрования и требований к сети WiFi. Токен генерируется при первой авторизации и хранится в защищенной памяти, поэтому для его извлечения иногда приходится прибегать к специальным методам.

В этой статье мы подробно разберем все актуальные способы получения ключа доступа для вашего робота. Мы рассмотрим как программные методы через отладку Android, так и более простые варианты через сторонние плагины, а также уделим внимание частым ошибкам, которые возникают при попытке «подружить» пылесос с новыми системами.

Зачем нужен токен и где он применяется

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

Чаще всего токен необходим для интеграции робота в систему Home Assistant. Это позволяет создавать сложные сценарии: запускать уборку при выходе из дома, получать уведомления о состоянии фильтров прямо в Telegram или синхронизировать работу пылесоса с умными розетками. Без токена Home Assistant не сможет отправлять команды на Xiaomi Vacuum Mop Essential, ограничиваясь лишь статусом «онлайн» или полностью игнорируя устройство.

⚠️ Внимание: Токен является чувствительной информацией. Любой, кто обладает этим кодом и находится в вашей WiFi-сети, теоретически может управлять вашим пылесосом. Никогда не публикуйте его в открытом доступе и не передавайте третьим лицам.

Также токен может потребоваться при смене региона в приложении или при переносе устройства на другой аккаунт, если стандартные методы привязки дают сбой. В некоторых случаях разработчики сторонних плагинов для Mi Home (например, для управления голосом через Алису или Google Assistant с расширенными командами) также запрашивают этот ключ для настройки проброса устройств.

Подготовка устройства и сети к процедуре

Прежде чем приступать к извлечению ключа, необходимо убедиться, что ваше окружение соответствует требованиям. Робот-пылесос Xiaomi Vacuum Mop Essential, как и большинство устройств экосистемы, работает в диапазоне частот 2.4 ГГц. Если ваш роутер транслирует сеть 5 ГГц с тем же именем (SSID), процесс может пойти не по плану. Рекомендуется временно разделить сети или создать гостевую сеть исключительно на частоте 2.4 ГГц для проведения настроек.

Второй важный аспект — регион аккаунта. Модель STYTJ01YM часто поставляется с региональной привязкой. Если вы купили глобальную версию, но в приложении выбран регион «Россия», а пылесос «китаец», могут возникнуть проблемы с отображением устройства в списке для получения токена. Убедитесь, что в настройках Mi Home выбран правильный регион, соответствующий вашему аккаунту.

Также стоит проверить версию прошивки робота. Иногда в старых версиях ПО встречаются баги, мешающие корректной работе с токенами, а в новых — усиленная защита. Зайдите в настройки устройства в приложении и убедитесь, что Xiaomi Vacuum Mop Essential обновлен до последней доступной версии. Это минимизирует риски возникновения ошибок при запросе данных.

Способ 1: Использование плагина Mi Home для Android

Наиболее доступный метод для обычных пользователей — установка модифицированной версии приложения Mi Home или специального плагина, который умеет отображать скрытые данные устройств. Официальное приложение никогда не покажет вам токен в открытом виде, поэтому придется воспользоваться сторонними решениями, такими как Vevs Mi Home или плагины для Home Assistant, имеющие функцию извлечения.

Для реализации этого способа вам понадобится Android-смартфон. На iPhone данная процедура через плагины часто ограничена системой безопасности iOS. Вам нужно будет скачать APK-файл модифицированного приложения из проверенного источника (например, GitHub или профильные форумы) и установить его, разрешив установку из неизвестных источников. После установки войдите в свой аккаунт Xiaomi.

В модифицированной версии приложения часто появляется дополнительное меню или кнопка «Token» прямо в карточке устройства. Нажав на нее, вы увидите длинную строку символов — это и есть искомый токен. Скопируйте его и сохраните в надежном месте. Если прямой кнопки нет, попробуйте.long-press (долгое нажатие) на карточку робота в списке устройств.

Где искать модифицированные версии?

Официальные магазины приложений (Google Play, AppStore) не допускают модифицированные версии Mi Home из-за нарушения правил безопасности. Искать их следует на GitHub (репозитории разработчиков вроде vevs или mha) или на специализированных форумах, таких как 4PDA. Будьте осторожны и проверяйте файлы антивирусом перед установкой.

Способ 2: Извлечение токена через ADB на Android

Более сложный, но универсальный метод — использование отладки по USB (ADB). Этот способ не требует установки подозрительных модов, но требует наличия компьютера и минимальных технических навыков. Суть метода заключается в том, чтобы считать базу данных приложения Mi Home, где токены хранятся в зашифрованном, но доступном виде.

Для начала вам нужно включить режим разработчика на вашем Android-смартфоне. Зайдите в Настройки → О телефоне и нажмите 7-10 раз на пункт «Номер сборки». После этого в меню настроек появится раздел «Для разработчиков». Активируйте в нем пункт Отладка по USB. Подключите телефон к компьютеру через USB-кабель.

Далее на компьютере необходимо установить Android Debug Bridge (ADB). Откройте командную строку и введите команду для проверки подключения:

adb devices

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

⚠️ Внимание: Данный метод требует наличия прав суперпользователя (Root) на Android-устройстве для прямого доступа к файловой директории /data/data/com.xiaomi.smarthome/. Без root-прав извлечь базу данных стандартными средствами ADB не получится.

Если root-права есть, перейдите в директорию базы данных:

adb shell
cd /data/data/com.xiaomi.smarthome/databases
sqlite3 miio.db "select name, token from device WHERE name like '%vacuum%';"

В ответ вы получите список устройств и их токены. Найдите строку, соответствующую Xiaomi Vacuum Mop Essential, и скопируйте значение.

Способ 3: Использование Python-скрипта miio

Для пользователей, предпочитающих работу с ПК и командной строкой, отличным решением является утилита python-miio. Это официальный инструмент сообщества для управления устройствами Xiaomi, который умеет, среди прочего, вытаскивать токены из облака Mi Cloud, если у вас есть логин и пароль от аккаунта.

Сначала убедитесь, что на компьютере установлен Python версии 3.7 или выше. Затем установите библиотеку через pip:

pip install python-miio

После установки можно использовать команду для извлечения токена. Вам понадобятся логин, пароль и регион аккаунта (например, ru, de, cn). Команда выглядит следующим образом:

miio-cloud --username ваш_логин --password ваш_пароль --region ru

Скрипт авторизуется в облаке Xiaomi, получит список всех устройств, привязанных к аккаунту, и выведет их токены в консоль. Найдите в списке модель STYTJ01YM или MJSTG1. Этот метод хорош тем, что не требует наличия самого робота под рукой в момент извлечения, достаточно данных аккаунта.

Таблица: Сравнение методов получения токена

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

Как видно из таблицы, использование Python-скрипта или ADB с root-правами является наиболее безопасным, так как не требует установки модифицированного ПО от неизвестных разработчиков. Однако для разовой процедуры плагин может оказаться быстрее.

Что делать, если токен не получается найти

Иногда пользователи сталкиваются с ситуацией, когда ни один из методов не дает результата. Робот Xiaomi Vacuum Mop Essential может не отображаться в списке, или скрипт выдавать ошибку авторизации. Частая причина — использование неправильного региона или сервера. Убедитесь, что вы указываете правильный сервер (например, mi.com для глобальных аккаунтов или mi.com.cn для китайских).

Еще одна распространенная проблема — блокировка со стороны Xiaomi. Компания периодически меняет алгоритмы шифрования и API. Если скрипт python-miio перестал работать, проверьте обновления на GitHub репозитории проекта. Возможно, вышла новая версия, исправляющая проблему с токенами.

Также стоит попробовать временно отключить VPN, если он активен. Xiaomi может блокировать запросы с IP-адресов, которые часто меняют геолокацию, считая их подозрительными. Выполняйте все действия с IP-адреса вашей страны регистрации аккаунта.

Сброс WiFi и повторная привязка устройства

Если вы сменили роутер, пароль от WiFi или просто хотите «освежить» соединение, может потребоваться сброс настроек сети на роботе. Для Xiaomi Vacuum Mop Essential процедура выглядит специфично. На верхней панели устройства есть две кнопки: включения и режима работы (или зарядки, в зависимости от ревизии).

Чтобы сбросить настройки WiFi, необходимо нажать и удерживать две кнопки одновременно в течение 5-7 секунд. Вы услышите голосовое сообщение о переходе в режим сопряжения, а индикатор WiFi начнет мигать. После этого робот можно заново добавить в приложение Mi Home.

⚠️ Внимание: При повторном добавлении устройства в аккаунт его токен не меняется. Токен привязан к самому устройству, а не к сессии подключения. Поэтому, если вы уже добыли токен ранее, после сброса WiFi использовать старый токен все еще можно.

Если он не может найти знакомую сеть, он переходит в режим ожидания. Убедитесь, что телефон находится рядом с пылесосом во время настройки, так как Xiaomi Vacuum Mop Essential использует Bluetooth для первичной конфигурации в некоторых версиях прошивки.

Часто задаваемые вопросы (FAQ)

Меняется ли токен после перепрошивки робота?

Нет, токен хранится в энергонезависимой памяти устройства и привязывается к его уникальному идентификатору (MAC-адресу или DID). Обновление прошивки или полный сброс до заводских настроек не изменяют токен. Он останется прежним до тех пор, пока устройство не будет удалено из аккаунта Xiaomi и добавлено заново (хотя даже это не всегда меняет токен, зависит от серверной логики).

Можно ли узнать токен без root-прав на iPhone?

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

Безопасно ли использовать модифицированное приложение Mi Home?

Использование модов несет определенные риски, так как вы передаете логин и пароль от аккаунта стороннему ПО. Хотя сообщество проверяет популярные сборки (например, от vevs), риск утечки данных или блокировки аккаунта компанией Xiaomi теоретически существует. Используйте этот метод только если понимаете риски.

Что делать, если робот пишет «Устройство офлайн» после ввода токена?

Это означает, что устройство не отвечает по локальному IP-адресу. Убедитесь, что телефон/сервер Home Assistant и робот находятся в одной подсети. Также проверьте, не блокирует ли роутер локальные запросы (функция AP Isolation). Токен сам по себе не обеспечивает соединение, он лишь дает право на управление.

Где найти модель моего пылесоса Essential?

Модель указана на наклейке на нижней части корпуса робота. Ищите код вида STYTJ01YM, MJSTG1 или MJSTG1W. Эта информация важна при поиске токена, чтобы не перепутать устройство с другими гаджетами Xiaomi в списке.