Nastavení s lokálním připojením Nedoporučeno

Tato metoda by měla být použita k navázání přímého lokálního připojení k robotickému vysavači bez závislosti na nepřetržitém připojení k cloudu. Pro použití této metody musí být zařízení alespoň jednou úspěšně přidáno do oficiální aplikace Xiaomi Home (k dispozici pro iOS a Android) za účelem vygenerování platného tokenu. Dále musí zůstat během tohoto kroku nastavení propojeno s účtem, aby integrace mohla získat požadovanou IP adresu a token z cloudu.

Kompatibilita zařízení

Tato metoda připojení je výlučně podporována pro zařízení vyrobená před rokem 2022, která jsou podporována aplikací Xiaomi Home. Pokud nelze zařízení přidat do aplikace Xiaomi Home, za žádných okolností neposkytne lokální API s žádným tokenem.

Podpora mapy není k dispozici Nedoporučeno

Technicky není možné získat mapová data prostřednictvím lokálního API. V důsledku toho lokální metoda připojení poskytuje žádnou podporu map, což úplně deaktivuje několik klíčových funkcí, které závisí na mapových datech, jako jsou Historie úklidu, Obnova mapy a dynamické Entity místností. Protože mapa a její závislé funkce jsou středobodem klíčové funkcionality integrace, tato metoda připojení se rozhodně nedoporučuje. Pro kompletní a plně funkční zážitek se důrazně doporučuje místo toho použít jednu z metod připojení přes cloud.

Získání IP a tokenu

Pro nastavení lokálního připojení musíte ručně zadat IP adresu zařízení a token.

Požadavek na podsíť

Z bezpečnostních důvodů zařízení reaguje pouze na požadavky pocházející z vlastní podsítě. Proto musí být robotický vysavač a Home Assistant ve stejné podsíti, aby lokální komunikace fungovala. Viz tento článek python-miio pro řešení problémů s komunikací mezi podsítěmi.

Metoda 1: Xiaomi Cloud Tokens Extractor Doporučeno

Toto je nejspolehlivější metoda. Funguje na Windows, macOS nebo Linuxu a přímo se připojuje k serverům Xiaomi cloud, aby současně načetl IP adresy a tokeny pro všechna zařízení propojená s účtem.

1. Stáhnout nástroj: Stáhněte si příslušnou verzi (např. .exe pro Windows) Xiaomi Cloud Tokens Extractor z GitHubu.
2. Spustit aplikaci: Spusťte stažený soubor a otevřete terminálové rozhraní.
3. Zadat přihlašovací údaje: Zadejte přesné uživatelské jméno (Email nebo Xiaomi ID) a heslo používané pro aplikaci Xiaomi Home.
4. Vybrat region serveru: Určete region serveru odpovídající aplikaci Xiaomi Home (např. de pro Evropu). Pokud region není znám, ponechte výzvu prázdnou a stiskněte Enter pro skenování všech dostupných serverů.
5. Získání tokenu: Nástroj zobrazí seznam všech zařízení připojených k účtu. V seznamu najděte cílový vysavač a zkopírujte jeho odpovídající 32místný token.

Metoda 2: Desktopová GUI aplikace (Get_MiHome_devices_token)

Pro uživatele, kteří preferují grafické uživatelské rozhraní před nástrojem příkazového řádku, je k dispozici desktopová aplikace.

1. Stažení aplikace: Stáhněte a nainstalujte aplikaci Get_MiHome_devices_token z GitHubu.
2. Přihlášení: Otevřete aplikaci, zadejte přihlašovací údaje k účtu Xiaomi a vyberte příslušnou serverovou oblast.
3. Získání tokenu: Po autentizaci se zobrazí všechna propojená zařízení spolu s jejich IP adresami a tokeny v tabulkovém formátu.

Metoda 3: Modifikovaná aplikace Mi Home pro Android Nedoporučeno

Uživatelé Androidu mohou využít upravenou verzi aplikace Mi Home pro zobrazení tokenů přímo v rozhraní aplikace na svém mobilním zařízení.

1. Odinstalujte originální aplikaci: Úplně odinstalujte oficiální aplikaci Mi Home z zařízení Android. (Poznámka: Zařízení zůstanou bezpečně propojena s cloudovým účtem).
2. Nainstalujte upravenou aplikaci: Vyhledejte online modifikovaný APK soubor "MiHome by Vevs", stáhněte nejnovější verzi a nainstalujte ji do zařízení.
3. Přihlášení: Otevřete upravenou aplikaci a přihlaste se pomocí přihlašovacích údajů Xiaomi účtu.
4. Získejte token: Vyberte cílový vysavač, aby se otevřelo jeho ovládací rozhraní. Klepněte na tři tečky v pravém horním rohu pro přístup do nastavení, poté přejděte do sekce Informace o síti nebo Obecná nastavení. IP adresa zařízení a token budou přímo viditelné na této obrazovce.