Připojení Xiaomi (Mi Home) zařízení do Home Assistantu pomocí HACS
Co potřebujete:
- Funkční instalaci Home Assistantu
- Aktivovaný HACS (Home Assistant Community Store)
- Účet v aplikaci Mi Home (doporučeno nastavit region „Mainland China“)
- Token a IP adresu zařízení (např. vysavač, zvlhčovač, žárovka)
1. Instalace HACS (pokud ještě nemáte)
- V Home Assistantu přejděte do Settings > Add-ons > Add-on Store
- Klikněte na tři tečky > Repositories a přidejte:
https://github.com/hacs/integration - Nainstalujte HACS, restartujte Home Assistant a projděte úvodní nastavení.
Oficiální návod HACS:
https://hacs.xyz/docs/installation/manual/
2. Instalace integrace Xiaomi Miio přes HACS
- Otevřete HACS > Integrations
- Klikněte na Explore & Add Repositories
- Vyhledejte a nainstalujte Xiaomi Miio
- Restartujte Home Assistant
Poznámka: podle typu zařízení může být vhodnější jiná integrace, např. xiaomi_gateway, xiaomi_aqara, yeelight.
3. Získání tokenu a IP adresy zařízení
Získání tokenu:
- Xiaomi Cloud Tokens Extractor (doporučeno)
https://github.com/PiotrMachowski/Xiaomi-cloud-tokens-extractor - Alternativní nástroj:
https://github.com/Maxmudjon/MiToolkit - Starší Mi Home aplikace pro root/ADB extrakci:
https://www.apkmirror.com/apk/xiaomi-inc/mihome/mihome-5-4-54-release/
Získání IP adresy:
- Přes správu routeru (např. DHCP klienti)
- Nebo pomocí aplikace Fing:
https://www.fing.com/products/fing-app
4. Přidání zařízení do configuration.yaml
Do souboru configuration.yaml přidejte:
xiaomi_miio:
devices:
192.168.1.123:
token: 0123456789abcdef0123456789abcdef
name: xiaomi_vacuum
Upravte IP adresu a token podle vašeho zařízení. Uložte změny a restartujte Home Assistant.
Tabulka řešení častých problémů
| Problém | Možná příčina | Řešení |
|---|---|---|
| Home Assistant nedetekuje zařízení | Špatná IP nebo token | Ověřte IP a token, nastavte statickou IP, restartujte systém |
| Token se nedaří získat | Ochrana aplikace, špatný region | Použijte Cloud Tokens Extractor nebo starou Mi Home aplikaci |
| Zařízení reaguje částečně nebo špatně | Nepodporovaný model, nový firmware | Ověřte podporu, použijte alternativní integraci, zkontrolujte firmware |
| Zpoždění nebo žádná odezva zařízení | Síťový problém, jiná VLAN | Ověřte připojení, použijte ping, upravte nastavení firewallu |
| Zařízení se odpojuje nebo mizí | Dynamická IP, slabý Wi-Fi signál | Nastavte statickou IP, posilte Wi-Fi signál, vypněte režim úspory |