Configurazione con Connessione Locale Non Raccomandato

Questo metodo dovrebbe essere utilizzato per stabilire una connessione diretta locale con il robot aspirapolvere senza fare affidamento sulla connettività cloud continua. Per utilizzare questo metodo, il dispositivo deve essere stato aggiunto con successo all'applicazione ufficiale Xiaomi Home (disponibile per iOS e Android) almeno una volta per generare un token valido. Inoltre, deve rimanere collegato all'account durante questo passaggio di configurazione in modo che l'integrazione possa recuperare l'indirizzo IP e il token richiesti dal cloud.

Compatibilità del Dispositivo

Questo metodo di connessione è supportato esclusivamente per i dispositivi prodotti prima del 2022 e supportati con l'app Xiaomi Home. Se un dispositivo non può essere aggiunto all'app Xiaomi Home, non esporrà mai un'API locale in nessuna circostanza con alcun token.

Nessun Supporto per la Mappa Non Raccomandato

Non è tecnicamente possibile recuperare i dati della mappa tramite l'API locale. Di conseguenza, il metodo di connessione locale fornisce nessun supporto per la mappa, il che disabilita completamente diverse funzionalità principali che si basano sui dati della mappa come Cronologia pulizia, Ripristino mappa e Entità Stanze dinamici. Poiché la mappa e le sue funzionalità dipendenti sono centrali per il funzionamento principale dell'integrazione, questo metodo di connessione è severamente sconsigliato. Per un'esperienza completa e completamente funzionante, si consiglia vivamente di utilizzare uno dei metodi di connessione cloud.

Recupero di IP e Token

Per configurare la connessione locale, è necessario fornire manualmente l'indirizzo IP e il token del dispositivo.

Requisito di Sottorete

Per motivi di sicurezza, il dispositivo risponde solo alle richieste provenienti dalla propria sottorete. Pertanto, l'aspirapolvere robot e Home Assistant devono trovarsi esattamente sulla stessa sottorete affinché la comunicazione locale funzioni. Consulta questo articolo python-miio per la risoluzione dei problemi relativi alle sottoreti incrociate.

Metodo 1: Xiaomi Cloud Tokens Extractor Raccomandato

Questo è il metodo più affidabile. Funziona su Windows, macOS o Linux, collegandosi direttamente ai server cloud di Xiaomi per recuperare gli indirizzi IP e i token di tutti i dispositivi collegati all'account contemporaneamente.

1. Scarica lo Strumento: Scarica la versione appropriata (ad esempio, .exe per Windows) del Xiaomi Cloud Tokens Extractor da GitHub.
2. Esegui l'Applicazione: Esegui il file scaricato per aprire un'interfaccia terminale.
3. Inserisci le Credenziali: Fornisci l'esatto nome utente (Email o ID Xiaomi) e la password utilizzati per l'app Xiaomi Home.
4. Seleziona la Regione del Server: Specifica la regione del server corrispondente all'app Xiaomi Home (ad esempio, de per l'Europa). Se la regione è sconosciuta, lascia il prompt vuoto e premi Invio per scansionare tutti i server disponibili.
5. Recupera il Token: Lo strumento mostrerà un elenco di tutti i dispositivi collegati all'account. Individua l'aspirapolvere di destinazione nell'elenco e copia il relativo token di 32 caratteri.

Metodo 2: Applicazione Desktop GUI (Get_MiHome_devices_token)

Per gli utenti che preferiscono un'interfaccia grafica rispetto a uno strumento da riga di comando, è disponibile un'applicazione desktop.

1. Scarica l'Applicazione: Scarica e installa l'applicazione Get_MiHome_devices_token da GitHub.
2. Login: Apri l'applicazione, inserisci le credenziali dell'account Xiaomi e seleziona la regione del server appropriata.
3. Recupera il Token: Una volta autenticato, tutti i dispositivi collegati, insieme ai rispettivi indirizzi IP e token, verranno visualizzati in formato tabellare.

Metodo 3: App Mi Home Modificata per Android Non Raccomandato

Gli utenti Android possono utilizzare una versione modificata dell'applicazione Mi Home per visualizzare i token direttamente all'interno dell'interfaccia dell'app sul loro dispositivo mobile.

1. Disinstallare l'app originale: Disinstalla completamente l'applicazione ufficiale Mi Home dal dispositivo Android. (Nota: I dispositivi rimarranno collegati in sicurezza all'account cloud).
2. Installare l'app modificata: Cerca online l'APK modificato "MiHome by Vevs", scarica l'ultima versione e installala sul dispositivo.
3. Accedere: Apri l'applicazione modificata e accedi utilizzando le credenziali dell'account Xiaomi.
4. Recuperare il Token: Seleziona l'aspirapolvere target per aprire la sua interfaccia di controllo. Tocca i tre puntini in alto a destra per accedere alle impostazioni, quindi naviga alla sezione Informazioni di rete o Impostazioni generali. L'indirizzo IP e il token del dispositivo saranno direttamente visibili su questo schermo.