Einrichtung mit lokaler Verbindung Nicht empfohlen

Diese Methode sollte verwendet werden, um eine direkte lokale Verbindung zum Saugroboter herzustellen, ohne auf eine kontinuierliche Cloud-Konnektivität angewiesen zu sein. Um diese Methode zu verwenden, muss das Gerät mindestens einmal erfolgreich zur offiziellen Xiaomi Home-Anwendung (verfügbar für iOS und Android) hinzugefügt worden sein, um ein gültiges Token zu generieren. Außerdem muss es während dieses Einrichtungsschrittes mit dem Konto verbunden bleiben, damit die Integration die benötigte IP-Adresse und das Token aus der Cloud abrufen kann.

Gerätekompatibilität

Diese Verbindungsmethode wird ausschließlich für Geräte unterstützt, die vor 2022 hergestellt wurden und mit der Xiaomi Home-Anwendung kompatibel sind. Wenn ein Gerät nicht zur Xiaomi Home-App hinzugefügt werden kann, wird es unter keinen Umständen mit irgendeinem Token eine lokale API bereitstellen.

Keine Kartendarstellung Nicht empfohlen

Es ist technisch nicht möglich, Kartendaten über die lokale API abzurufen. Infolgedessen bietet die lokale Verbindungsmethode keine Kartenunterstützung, was mehrere Kernfunktionen, die auf Kartendaten angewiesen sind, wie zum Beispiel Reinigungshistorie, Karten-Wiederherst. und dynamische Raum-Entitäten, vollständig deaktiviert. Da die Karte und ihre abhängigen Funktionen zentral für die Kernfunktionalität der Integration sind, wird diese Verbindungsmethode dringend nicht empfohlen. Für ein vollständiges und voll funktionsfähiges Erlebnis wird dringend empfohlen, stattdessen eine der Cloud-Verbindungsmethoden zu verwenden.

Abrufen von IP und Token

Um die lokale Verbindung zu konfigurieren, müssen Sie die IP-Adresse und den Token des Geräts manuell angeben.

Subnetz-Anforderung

Aus Sicherheitsgründen reagiert das Gerät nur auf Anfragen, die aus 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 Behebung von Problemen mit Subnetzen.

Methode 1: Xiaomi Cloud Tokens Extraktor Empfohlen

Dies ist die zuverlässigste Methode. Sie läuft auf Windows, macOS oder Linux und verbindet sich direkt mit den Xiaomi-Cloud-Servern, um die IP-Adressen und Tokens aller mit dem Konto verknüpften Geräte gleichzeitig abzurufen.

1. Tool herunterladen: Laden Sie die entsprechende Version (z.B. .exe für Windows) des Xiaomi Cloud Tokens Extraktors von GitHub herunter.
2. Anwendung ausführen: Führen Sie die heruntergeladene Datei aus, um eine Terminal-Oberfläche zu öffnen.
3. Anmeldedaten eingeben: Geben Sie den genauen Benutzernamen (E-Mail oder Xiaomi-ID) und das Passwort ein, die für die Xiaomi Home-Anwendung verwendet werden.
4. Serverregion auswählen: Geben Sie die Serverregion an, die mit der Xiaomi Home-App übereinstimmt (z.B. de für Europa). Wenn die Region unbekannt ist, lassen Sie die Eingabeaufforderung leer und drücken Sie Enter, um alle verfügbaren Server zu scannen.
5. Token abrufen: Das Tool gibt eine Liste aller mit dem Konto verbundenen Geräte aus. Suchen Sie den Zielstaubsauger in der Liste und kopieren Sie das entsprechende 32-stellige Token.

Methode 2: Desktop-GUI-Anwendung (Get_MiHome_devices_token)

Für Benutzer, die eine grafische Benutzeroberfläche einer Befehlszeilenanwendung vorziehen, steht eine Desktop-Anwendung zur Verfügung.

1. Anwendung herunterladen: Laden Sie die Get_MiHome_devices_token-Anwendung von GitHub herunter und installieren Sie sie.
2. Anmelden: Öffnen Sie die Anwendung, geben Sie die Xiaomi-Kontoanmeldedaten ein und wählen Sie die entsprechende Serverregion.
3. Token abrufen: Nach der Authentifizierung werden alle verknüpften Geräte zusammen mit ihren jeweiligen IP-Adressen und Tokens in tabellarischer Form angezeigt.

Methode 3: Modifizierte Mi Home App für Android Nicht empfohlen

Android-Benutzer können eine modifizierte Version der Mi Home-Anwendung verwenden, um Tokens direkt in der App-Oberfläche auf ihrem mobilen Gerät anzuzeigen.

1. Original-App deinstallieren: Deinstallieren Sie die offizielle Mi Home-Anwendung vollständig vom Android-Gerät. (Hinweis: Geräte bleiben sicher mit dem Cloud-Konto verknüpft).
2. Modifizierte App installieren: Suchen Sie online nach der modifizierten APK „MiHome by Vevs“, laden Sie die neueste Version herunter und installieren Sie sie auf dem Gerät.
3. Anmelden: Öffnen Sie die modifizierte Anwendung und melden Sie sich mit den Xiaomi-Konto-Anmeldedaten an.
4. Token abrufen: Wählen Sie den Zielstaubsauger aus, um dessen Steueroberfläche zu öffnen. Tippen Sie auf die drei Punkte in der oberen rechten Ecke, um zu den Einstellungen zu gelangen, und navigieren Sie dann zum Abschnitt Netzwerkinfo oder Allgemeine Einstellungen. Die IP-Adresse und das Token des Geräts werden direkt auf diesem Bildschirm angezeigt.