Configuración con Conexión Local No Recomendado

Este método debe utilizarse para establecer una conexión local directa con el robot aspirador sin depender de la conectividad continua en la nube. Para usar este método, el dispositivo debe haber sido agregado con éxito a la aplicación oficial Xiaomi Home (disponible para iOS y Android) al menos una vez para generar un token válido. Además, debe permanecer vinculado a la cuenta durante este paso de configuración para que la integración pueda recuperar la dirección IP y el token necesarios desde la nube.

Compatibilidad del Dispositivo

Este método de conexión se admite exclusivamente para dispositivos fabricados antes de 2022 que sean compatibles con la aplicación Xiaomi Home. Si un dispositivo no puede ser agregado a la aplicación Xiaomi Home, no expondrá ninguna API local bajo ninguna circunstancia con ningún token.

Sin soporte de mapa No Recomendado

No es técnicamente posible recuperar datos del mapa a través de la API local. Como resultado, el método de conexión local proporciona sin soporte de mapa, lo que desactiva completamente varias funciones principales que dependen de los datos del mapa, tales como Historial limpieza, Recuperar mapa y Entidades de Habitación dinámicos. Dado que el mapa y sus funciones dependientes son centrales para la funcionalidad principal de la integración, este método de conexión se no recomienda estrictamente. Para una experiencia completa y totalmente funcional, se aconseja encarecidamente utilizar uno de los métodos de conexión en la nube en su lugar.

Recuperación de IP y Token

Para configurar la conexión local, debe proporcionar manualmente la dirección IP y el token del dispositivo.

Requisito de Subred

Por razones de seguridad, el dispositivo solo responde a solicitudes que provienen de su propia subred. Por lo tanto, la aspiradora robótica y Home Assistant deben estar en la misma subred exacta para que la comunicación local funcione. Consulte este artículo de python-miio para la resolución de problemas de comunicación entre subredes.

Método 1: Extractor de Tokens de Xiaomi Cloud Recomendado

Este es el método más confiable. Funciona en Windows, macOS o Linux, conectándose directamente a los servidores de Xiaomi cloud para obtener las direcciones IP y los tokens de todos los dispositivos vinculados a la cuenta simultáneamente.

1. Descargar la Herramienta: Descargue la versión correspondiente (por ejemplo, .exe para Windows) del Extractor de Tokens de Xiaomi Cloud desde GitHub.
2. Ejecutar la Aplicación: Ejecute el archivo descargado para abrir una interfaz de terminal.
3. Ingresar Credenciales: Proporcione el nombre de usuario exacto (Correo electrónico o ID de Xiaomi) y la contraseña utilizada para la aplicación Xiaomi Home.
4. Seleccionar Región del Servidor: Especifique la región del servidor que coincida con la aplicación Xiaomi Home (por ejemplo, de para Europa). Si se desconoce la región, deje el campo en blanco y presione Enter para escanear todos los servidores disponibles.
5. Recuperar el Token: La herramienta mostrará una lista de todos los dispositivos conectados a la cuenta. Localiza el aspirador objetivo en la lista y copia su token correspondiente de 32 caracteres.

Método 2: Aplicación de Escritorio con Interfaz Gráfica (Get_MiHome_devices_token)

Para usuarios que prefieren una interfaz gráfica en lugar de una herramienta de línea de comandos, hay disponible una aplicación de escritorio.

1. Descargar la Aplicación: Descarga e instala la aplicación Get_MiHome_devices_token desde GitHub.
2. Iniciar Sesión: Abre la aplicación, ingresa las credenciales de la cuenta de Xiaomi y selecciona la región del servidor correspondiente.
3. Recuperar el Token: Una vez autenticado, todos los dispositivos vinculados, junto con sus respectivas direcciones IP y tokens, se mostrarán en un formato de tabla.

Método 3: App Modificada de Mi Home para Android No Recomendado

Los usuarios de Android pueden utilizar una versión modificada de la aplicación Mi Home para ver los tokens directamente dentro de la interfaz de la app en su dispositivo móvil.

1. Desinstalar la aplicación original: Desinstala completamente la aplicación oficial Mi Home del dispositivo Android. (Nota: Los dispositivos permanecerán vinculados de forma segura a la cuenta en la nube).
2. Instalar la aplicación modificada: Busca en línea el APK modificado "MiHome by Vevs", descarga la última versión e instálala en el dispositivo.
3. Iniciar sesión: Abre la aplicación modificada e inicia sesión usando las credenciales de la cuenta Xiaomi.
4. Recuperar el Token: Selecciona el aspirador objetivo para abrir su interfaz de control. Toca los tres puntos en la esquina superior derecha para acceder a los ajustes, luego navega a la sección Información de red o Ajustes generales. La dirección IP y el token del dispositivo serán visibles directamente en esta pantalla.