Configurazione con account Xiaomi Home

Questo metodo dovrebbe essere utilizzato se l'aspirapolvere robot è attualmente gestito tramite l'applicazione Xiaomi Home. Per garantire la compatibilità, può essere verificata con l'app ufficiale Xiaomi Home disponibile per iOS e Android.

Requisiti

• Credenziali: Devono essere esattamente il nome utente e la password utilizzati per accedere all'applicazione mobile (non al sito ufficiale).
• Regione del server: Il paese selezionato deve corrispondere alla regione in cui il dispositivo è registrato nell'app. Le regioni non corrispondenti causeranno errori "login fallito" o "dispositivo non trovato".

Accessi di terze parti

Se l'account è stato creato utilizzando un servizio di terze parti (come Google o Apple), è necessario generare prima una password dedicata nelle impostazioni utente dell'applicazione. Le password degli account di terze parti non possono essere utilizzate per l'autenticazione.

Raccomandazione sulla scelta dell'app

Alcuni dispositivi possono essere configurati utilizzando sia l'app Dreamehome sia l'app Xiaomi Home. A meno che non sia strettamente necessaria una connessione locale, è altamente consigliato utilizzare l'app Dreamehome invece di Xiaomi Home per i dispositivi supportati:

• Flusso della fotocamera: La funzione di flusso della fotocamera non è disponibile per i dispositivi configurati tramite Xiaomi Home.
• Aggiornamenti push: La connessione Dreamehome utilizza Cloud Push per aggiornamenti in tempo reale, eliminando la necessità di richieste di polling periodiche.

Preferire l'opzione Cloud

Durante il passaggio di configurazione, è disponibile un'opzione aggiuntiva Preferire Cloud che è selezionata di default.

• Quando selezionato (Predefinito): Forza tutta la comunicazione attraverso il cloud (se supportato dal dispositivo). Questo è il comportamento predefinito perché sui dispositivi più recenti Xiaomi ha disabilitato le capacità di accesso locale. Inoltre, se il dispositivo e Home Assistant si trovano su subnet diverse, la comunicazione locale non funzionerà.
• Quando non selezionato (Consigliato per configurazioni supportate): L'integrazione recupera il token necessario dal cloud ma stabilisce una connessione locale diretta con il dispositivo (simile al metodo Connessione Locale). Questo offre il vantaggio del rinnovo automatico del token e dell'IP mantenendo tutte le comunicazioni (eccetto i dati della mappa) locali. Se questo metodo genera un errore "impossibile raggiungere il dispositivo" nell'ultimo passaggio della configurazione, la configurazione dovrebbe essere ripetuta con l'opzione Preferisci Cloud selezionata.

  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.

Verifica Captcha

Se i server Xiaomi Home segnalano il tentativo di accesso o l'indirizzo IP come non affidabile, sarà necessario un passaggio di verifica captcha. Quando ciò avviene, l'immagine captcha deve essere risolta per procedere al passaggio successivo.

Autenticazione a Due Fattori (2FA)

Oltre al captcha, un tentativo di accesso non affidabile può anche attivare l'Autenticazione a Due Fattori (2FA). L'integrazione richiederà automaticamente un codice 2FA dai server Xiaomi Home, che viene inviato al numero di telefono registrato (prioritario) o all'indirizzo email.

Questo codice deve essere recuperato e inserito nel passaggio di configurazione per completare l'accesso.

Limitazioni della 2FA

• Validità del codice: Se la finestra di configurazione viene chiusa e viene effettuato un nuovo tentativo di accesso, verrà generato un nuovo codice 2FA. Deve sempre essere utilizzato l'ultimo codice ricevuto.
• Limitazione della frequenza: Xiaomi limita rigorosamente il numero di codici 2FA che possono essere richiesti ogni giorno. Tentativi di accesso ripetuti possono comportare un blocco temporaneo.

Aggiornamenti periodici dello stato

A differenza di altri metodi di connessione cloud che supportano le notifiche push, la connessione Xiaomi Home si basa interamente sul polling in background per recuperare lo stato più recente. Per ottimizzare l'uso della rete, l'intervallo di polling viene calcolato dinamicamente in base al tempo trascorso dall'ultimo cambiamento di stato; le richieste vengono inviate frequentemente mentre il dispositivo è attivamente in funzione, ma l'intervallo aumenta gradualmente man mano che passa il tempo mentre il dispositivo rimane inattivo.

Ri-autenticazione

L'integrazione memorizza in modo sicuro un token di autenticazione dopo un login riuscito per comunicare con i server cloud. Se questo token scade o viene invalidato dal servizio cloud per qualsiasi motivo, Home Assistant avvierà automaticamente un flusso di ri-autenticazione, richiedendo nuovamente l'inserimento delle credenziali dell'account.