Instellen met Xiaomi Home-account

Deze methode moet worden gebruikt als de robotstofzuiger momenteel wordt beheerd via de Xiaomi Home-applicatie. Om compatibiliteit te waarborgen, kan dit worden gecontroleerd met de officiële Xiaomi Home-app beschikbaar voor iOS en Android.

Vereisten

• Inloggegevens: Moeten de exacte gebruikersnaam en het wachtwoord zijn die worden gebruikt om in te loggen op de mobiele applicatie (niet de officiële website).
• Serverregio: Het geselecteerde land moet overeenkomen met de regio waar het apparaat in de app is geregistreerd. Niet-overeenkomende regio's zullen resulteren in fouten zoals "inloggen mislukt" of "apparaat niet gevonden".

Inloggen via derden

Als het account is aangemaakt met een service van derden (zoals Google of Apple), moet er eerst een speciaal wachtwoord worden aangemaakt binnen de gebruikersinstellingen van de applicatie. Wachtwoorden van accounts van derden kunnen niet worden gebruikt voor authenticatie.

Aanbeveling voor app-selectie

Sommige apparaten kunnen worden geconfigureerd met zowel de Dreamehome- als Xiaomi Home-applicatie. Tenzij een lokale verbinding strikt noodzakelijk is, wordt sterk aanbevolen om de Dreamehome-app te gebruiken in plaats van Xiaomi Home voor ondersteunde apparaten:

• Camera Stream: De functie camera stream is niet beschikbaar voor apparaten die via Xiaomi Home zijn geconfigureerd.
• Push-updates: De Dreamehome-verbinding maakt gebruik van Cloud Push voor real-time updates, waardoor periodieke polling-verzoeken overbodig zijn.

Cloud-optie voorkeur

Tijdens de configuratiestap is een extra Cloud-voorkeur-optie beschikbaar en deze is standaard aangevinkt.

• Wanneer aangevinkt (Standaard): Dwingt alle communicatie via de cloud af (indien ondersteund door het apparaat). Dit is het standaardgedrag omdat Xiaomi bij nieuwere apparaten de mogelijkheden voor lokale toegang heeft uitgeschakeld. Bovendien, als het apparaat en Home Assistant zich op verschillende subnets bevinden, zal lokale communicatie mislukken.
• Wanneer niet aangevinkt (Aanbevolen voor ondersteunde setups): De integratie haalt de benodigde token uit de cloud, maar maakt een directe lokale verbinding met het apparaat (vergelijkbaar met de Lokale verbinding methode). Dit biedt het voordeel van automatische token- en IP-vernieuwing, terwijl alle communicatie (behalve kaartgegevens) lokaal blijft. Als deze methode resulteert in een foutmelding "kan apparaat niet bereiken" bij de laatste configuratiestap, moet de configuratie opnieuw worden geprobeerd met de Prefer Cloud optie aangevinkt.

  Subnetvereiste

  Om veiligheidsredenen reageert het apparaat alleen op verzoeken die afkomstig zijn van hetzelfde subnet. Daarom moeten de robotstofzuiger en Home Assistant zich op exact hetzelfde subnet bevinden voor lokale communicatie om te werken. Zie dit python-miio-artikel voor het oplossen van problemen met cross-subnet communicatie.

Captcha-verificatie

Als de Xiaomi Home-servers de inlogpoging of het IP-adres als onbetrouwbaar markeren, is een captcha-verificatiestap vereist. Wanneer dit gebeurt, moet de captcha-afbeelding worden opgelost om door te gaan naar de volgende stap.

Tweefactorauthenticatie (2FA)

Naast een captcha kan een onbetrouwbare inlogpoging ook Tweefactorauthenticatie (2FA) activeren. De integratie zal automatisch een 2FA-code opvragen bij de Xiaomi Home-servers, die wordt verzonden naar het geregistreerde telefoonnummer (voorrang) of e-mailadres.

Deze code moet worden opgehaald en ingevoerd in de configuratiestap om de login te voltooien.

2FA-beperkingen

• Codegeldigheid: Als het configuratievenster wordt gesloten en er een nieuwe inlogpoging wordt gedaan, wordt er een nieuwe 2FA-code gegenereerd. De meest recent ontvangen code moet altijd worden gebruikt.
• Rate Limiting: Xiaomi beperkt strikt het aantal 2FA-codes dat per dag kan worden aangevraagd. Herhaalde inlogpogingen kunnen leiden tot een tijdelijke blokkade.

Periodieke statusupdates

In tegenstelling tot andere cloudverbindingmethoden die pushmeldingen ondersteunen, vertrouwt de Xiaomi Home-verbinding volledig op achtergrondpolling om de nieuwste status op te halen. Om het netwerkgebruik te optimaliseren, wordt het pollinterval dynamisch berekend op basis van de tijd die is verstreken sinds de laatste statuswijziging; verzoeken worden vaak verzonden terwijl het apparaat actief is, maar het interval neemt geleidelijk toe naarmate er meer tijd verstrijkt terwijl het apparaat inactief blijft.

Her-authenticatie

De integratie slaat na een succesvolle login veilig een authenticatietoken op om te communiceren met de cloudservers. Als dit token verloopt of om welke reden dan ook ongeldig wordt gemaakt door de clouddienst, zal Home Assistant automatisch een her-authenticatiestroom starten, waarbij wordt gevraagd om de accountgegevens opnieuw in te voeren.