Einrichtung mit Xiaomi Home Konto

Diese Methode sollte verwendet werden, wenn der Saugroboter derzeit über die Xiaomi Home Anwendung verwaltet wird. Zur Sicherstellung der Kompatibilität kann sie mit der offiziellen Xiaomi Home App für iOS und Android überprüft werden.

Anforderungen

• Anmeldedaten: Es muss der genaue Benutzername und das Passwort verwendet werden, die zur Anmeldung in der mobilen Anwendung genutzt werden (nicht die der offiziellen Webseite).
• Serverregion: Das ausgewählte Land muss mit der Region übereinstimmen, in der das Gerät in der App registriert ist. Nicht übereinstimmende Regionen führen zu Fehlern wie "Anmeldung fehlgeschlagen" oder "Gerät nicht gefunden".

Anmeldungen von Drittanbietern

Wenn das Konto über einen Drittanbieterdienst (wie Google oder Apple) erstellt wurde, muss zunächst innerhalb der Benutzereinstellungen der Anwendung ein spezielles Passwort generiert werden. Passwörter von Drittanbieterkonten können nicht für die Authentifizierung verwendet werden.

Empfehlenswerte App-Auswahl

Einige Geräte können entweder mit der Dreamehome- oder der Xiaomi Home-Anwendung konfiguriert werden. Sofern keine lokale Verbindung unbedingt erforderlich ist, wird dringend empfohlen, die Dreamehome-App anstelle von Xiaomi Home für unterstützte Geräte zu verwenden:

• Kamerastream: Die Funktion des Kamerastreams ist für Geräte, die über Xiaomi Home konfiguriert wurden, nicht verfügbar.
• Push-Updates: Die Dreamehome-Verbindung nutzt Cloud Push für Echtzeit-Updates, wodurch periodische Abfrageanforderungen entfallen.

Bevorzugte Cloud-Option

Während des Konfigurationsschritts ist eine zusätzliche Bevorzugte Cloud-Option verfügbar und standardmäßig aktiviert.

• Wenn aktiviert (Standard): Erzwingt die gesamte Kommunikation über die Cloud (falls vom Gerät unterstützt). Dies ist das Standardverhalten, da Xiaomi auf neueren Geräten lokale Zugriffsmöglichkeiten deaktiviert hat. Außerdem schlägt die lokale Kommunikation fehl, wenn sich das Gerät und Home Assistant in unterschiedlichen Subnetzen befinden.
• Wenn deaktiviert (Empfohlen für unterstützte Setups): Die Integration ruft das benötigte Token von der Cloud ab, stellt jedoch eine direkte lokale Verbindung zum Gerät her (ähnlich der Lokale Verbindung-Methode). Dies bietet den Vorteil der automatischen Token- und IP-Erneuerung, während die gesamte Kommunikation (außer Kartendaten) lokal bleibt. Wenn diese Methode am letzten Konfigurationsschritt einen "Gerät nicht erreichbar"-Fehler verursacht, sollte die Konfiguration erneut mit der Option Cloud bevorzugen aktiviert versucht werden.

  Subnetz-Anforderung

  Aus Sicherheitsgründen reagiert das Gerät nur auf Anfragen, die von seinem eigenen Subnetz stammen. Daher müssen der Saugroboter und Home Assistant im exakt gleichen Subnetz sein, damit die lokale Kommunikation funktioniert. Siehe diesen python-miio-Artikel zur Fehlerbehebung bei Problemen über Subnetzgrenzen hinweg.

Captcha-Verifizierung

Wenn die Xiaomi Home-Server den Anmeldeversuch oder die IP-Adresse als nicht vertrauenswürdig einstufen, ist ein Captcha-Verifizierungsschritt erforderlich. In diesem Fall muss das Captcha-Bild gelöst werden, um zum nächsten Schritt zu gelangen.

Zwei-Faktor-Authentifizierung (2FA)

Zusätzlich zu einem Captcha kann ein nicht vertrauenswürdiger Anmeldeversuch auch die Zwei-Faktor-Authentifizierung (2FA) auslösen. Die Integration fordert automatisch einen 2FA-Code von den Xiaomi Home-Servern an, der an die registrierte Telefonnummer (bevorzugt) oder E-Mail-Adresse gesendet wird.

Dieser Code muss abgerufen und im Konfigurationsschritt eingegeben werden, um die Anmeldung abzuschließen.

2FA-Beschränkungen

• Code-Gültigkeit: Wenn das Konfigurationsfenster geschlossen wird und ein neuer Login-Versuch unternommen wird, wird ein neuer 2FA-Code generiert. Es muss immer der zuletzt erhaltene Code verwendet werden.
• Ratenbegrenzung: Xiaomi begrenzt strikt die Anzahl der pro Tag anforderbaren 2FA-Codes. Wiederholte Login-Versuche können zu einer vorübergehenden Sperrung führen.

Periodische Statusaktualisierungen

Im Gegensatz zu anderen Cloud-Verbindungsmethoden, die Push-Benachrichtigungen unterstützen, verlässt sich die Xiaomi Home-Verbindung vollständig auf Hintergrundabfragen, um den neuesten Status abzurufen. Um die Netzwerknutzung zu optimieren, wird das Abfrageintervall dynamisch basierend auf der seit der letzten Statusänderung verstrichenen Zeit berechnet; Anfragen werden häufig gesendet, während das Gerät aktiv läuft, aber das Intervall erhöht sich allmählich, je mehr Zeit vergeht, während das Gerät im Leerlauf bleibt.

Re-Authentifizierung

Die Integration speichert nach einer erfolgreichen Anmeldung sicher ein Authentifizierungs-Token, um mit den Cloud-Servern zu kommunizieren. Wenn dieses Token abläuft oder aus irgendeinem Grund vom Cloud-Dienst ungültig gemacht wird, löst Home Assistant automatisch einen Re-Authentifizierungsprozess aus, bei dem die Kontodaten erneut eingegeben werden müssen.