Instellen met Lokale Verbinding Niet Aanbevolen

Deze methode moet worden gebruikt om een directe lokale verbinding met de robotstofzuiger tot stand te brengen zonder te vertrouwen op continue cloudconnectiviteit. Om deze methode te gebruiken, moet het apparaat minstens één keer succesvol zijn toegevoegd aan de officiële Xiaomi Home-applicatie (beschikbaar voor iOS en Android) om een geldige token te genereren. Bovendien moet het gekoppeld blijven aan het account tijdens deze instelfase zodat de integratie het vereiste IP-adres en token uit de cloud kan ophalen.

Compatibiliteit van Apparaat

Deze verbindingsmethode wordt uitsluitend ondersteund voor apparaten die vóór 2022 zijn vervaardigd en worden ondersteund door de Xiaomi Home-applicatie. Als een apparaat niet kan worden toegevoegd aan de Xiaomi Home-app, zal het onder geen enkele omstandigheid een lokale API met enig token blootstellen.

Geen Kaartondersteuning Niet Aanbevolen

Het is technisch niet mogelijk om kaartgegevens op te halen via de lokale API. Als gevolg hiervan biedt de lokale verbindingsmethode geen kaartondersteuning, wat verschillende kernfuncties die afhankelijk zijn van kaartgegevens volledig uitschakelt, zoals Schoonmaakhistorie, Kaartherstel, en dynamische Kamer Entiteiten. Omdat de kaart en de afhankelijk functies centraal staan in de kernfunctionaliteit van de integratie, wordt deze verbindingsmethode strikt niet aanbevolen. Voor een complete en volledig functionele ervaring wordt het sterk aangeraden om in plaats daarvan een van de cloudverbindingsmethoden te gebruiken.

IP en Token ophalen

Om de lokale verbinding te configureren, moet je handmatig het IP-adres en token van het apparaat opgeven.

Subnetvereiste

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

Methode 1: Xiaomi Cloud Tokens Extractor Aanbevolen

Dit is de meest betrouwbare methode. Het draait op Windows, macOS of Linux en maakt direct verbinding met de Xiaomi-cloudservers om de IP-adressen en tokens van alle apparaten die aan het account zijn gekoppeld, tegelijkertijd op te halen.

1. Download de Tool: Download de juiste release (bijv. .exe voor Windows) van de Xiaomi Cloud Tokens Extractor van GitHub.
2. Start de Applicatie: Voer het gedownloade bestand uit om een terminalinterface te openen.
3. Voer Inloggegevens In: Geef de exacte gebruikersnaam (e-mail of Xiaomi ID) en het wachtwoord op die gebruikt worden voor de Xiaomi Home-applicatie.
4. Selecteer Serverregio: Geef de serverregio op die overeenkomt met de Xiaomi Home-app (bijv. de voor Europa). Als de regio onbekend is, laat u de prompt leeg en drukt u op Enter om alle beschikbare servers te scannen.
5. Haal de Token op: Het gereedschap zal een lijst weergeven van alle apparaten die op het account zijn aangesloten. Zoek de doelstofzuiger in de lijst en kopieer de bijbehorende 32-teken token.

Methode 2: Desktop GUI-toepassing (Get_MiHome_devices_token)

Voor gebruikers die de voorkeur geven aan een grafische gebruikersinterface boven een commandoregeltool, is er een desktopapplicatie beschikbaar.

1. Download de Applicatie: Download en installeer de Get_MiHome_devices_token applicatie van GitHub.
2. Inloggen: Open de applicatie, voer de Xiaomi-accountgegevens in en selecteer de juiste serverregio.
3. Haal de Token op: Zodra u bent geauthenticeerd, worden alle gekoppelde apparaten, samen met hun respectieve IP-adressen en tokens, weergegeven in een tabelvorm.

Methode 3: Modded Mi Home App voor Android Niet Aanbevolen

Android-gebruikers kunnen een aangepaste versie van de Mi Home-app gebruiken om tokens direct binnen de app-interface op hun mobiele apparaat te bekijken.

1. Originele app verwijderen: Verwijder de officiële Mi Home-app volledig van het Android-apparaat. (Opmerking: apparaten blijven veilig gekoppeld aan het cloudaccount).
2. Modded app installeren: Zoek online naar de "MiHome by Vevs" aangepaste APK, download de nieuwste versie en installeer deze op het apparaat.
3. Inloggen: Open de aangepaste applicatie en log in met de Xiaomi-accountgegevens.
4. Token ophalen: Selecteer de gewenste robotstofzuiger om het bedieningspaneel te openen. Tik op de drie puntjes in de rechterbovenhoek om naar de instellingen te gaan, en navigeer vervolgens naar het Netwerkinformatie of Algemene instellingen gedeelte. Het IP-adres en de token van het apparaat zijn direct zichtbaar op dit scherm.