blog.vyoralek.cz

Centrum chytré domácnosti – HomeAssistant (Hass.io) – 9 část – Integrace ZigBee Xiaomi Mijia a Aqara

V dnešní deváté části o HomeAssistentovi se podíváme na integraci s produkty Xiaomi Mijia a Aqara používající technologii ZigBee. To vše za použití Xiaomi Gateway jako prostředníka.

Co budeme potřebovat?

  1. Instanci HomeAssistenta
  2. Xiaomi Gateway
  3. Produkty nesoucí označení Xiaomi Mijia a nebo Aqara

1. Instance HomeAssistenta (Hass.io)

Prvotním předpokladem je běžící instance HomeAssistenta minimálně ve verzi 0.57.

Pokud ještě z nějakého nemáte HomeAssistent nainstalovaný, doporučuji kouknout na první díl tohoto seriálu.

2. Xiaomi Gateway

Dále budeme potřebovat prostředníka mezi WiFi a Zigbee technlogií – gateway. Dobrou zprávou je, že pro HomeAssistant jsou podporovány hned tři verze:

  1. Xiaomi Gateway (označována jako lumi.gateway)
  2. Xiaomi Mijia Gateway (označována jako lumi.gateway.v2)
  3. Xiaomi Mijia Gateway 2018 (označována jako lumi.gateway.v3)

Naopak nepodporována je stále nejnovější verze Xiaomi Aqara Gateway (označována jako lumi.gateway.aqhm01) a to z důvodu, že není znám způsob jak ji přepnout v Mi Home aplikaci do dev módu (co je tento mód si řekneme dále v článku).

Xiaomi Mijia brána
Xiaomi Mijia brána

Pokud ještě bránu nemáte, tak z pohledu integrace mezi verzemi nejsou větší rozdíly a měla by vám vpohodě fungovat jakákoliv verze. Já mám odzkoušenou poslední třetí verzi.

3. Produkty nesoucí označení Xiaomi Mijia a/nebo Aqara

K dispozici máme opravdu velké množství produktů. Od sensorů teploty, otevření dvěří, pohybu až po detekci kouře či úniku vody.

Velký přehled produktů najdete v článku ZigBee ekosystém Xiaomi.

Xiaomi Mijia produkty
Xiaomi Mijia produkty

Nastavení integrace

Pro postup instalace Gateway a jednotlivých produktů koukněte do už zmiňovaného článku ZigBee ekosystém Xioami – ve svém důsledku je instalace poměrně intuitivní a měl by jí zvládnout vpohodě každý.

Dále se koukneme na specifické věci k integraci s HomeAssistentem a budu předpokládat, že produkty už máte s Gateway spárovány.

1. Zapnutí dev módu Gateway

Prvním předpokladem pro napojení na HomeAssistentem je zapnutí tzv. dev módu na Gateway.

To můžeme udělat z Mi Home aplikace poměrně šalamonským způsobem:

  1. Klikneme na ikonku Xiaomi Gateway
  2. Klikneme na tři tečky v pravém horním rohu (Settings)
  3. Zvolíme první volbu About
  4. 3x rychle klikneme na plochu pod dvěmi položkami – do menu by nám měli přibýt 3 nové položky v čínštině
  5. Klikneme na třetí položku v pořadí
  6. Zapneme přepínač na prvním řádku a opíšeme si kód na druhém řádku

2. Nastavení Xiaomi Gateway komponenty pro HomeAssistent

Otevřeme si hlavní konfigurační soubor HomeAssistenta configuration.yaml a přidáme řádek:

xiaomi_aqara:
  discovery_retry: 5
  gateways:
    - key: <KodzHomeMiAplikace>

🥁 Podle všeho u poslední verze Mijia Gateway V3 se u zařízení s MAC adresou začínající na 04:CF:8C může objevit problém (u mě se toto neprojevilo) s dev módem, kdy hub HomeAssistent nenajde. Je potřeba se připojit do Hubu přes UART a spustit příkaz: psm-set network.open_pf 3. Více k problému najdete zde.

HomeAssistant zrestartujeme a po naběhnutí bychom měli vidět v systému nové entity. V mém ukázkovém případu můžete vidět:

Xiaomi Mijia a Aqara entity v HomeAssistentovi
Xiaomi Mijia a Aqara entity v HomeAssistentovi

Platí tedy, že podporované produkty připojené k bráně jsou při nastavení brány automaticky do HomeAssistenta přidány a na konci názvu mají jedinečný kód.

V případě, že byste si do budoucna pořídili další produkt je potřeba ho nejprve spárovat s Hubem a pak provést restart HomeAssistenta. Zařízení by pak mělo být během startu HA přidáno automaticky.

Atributy produktů

Jak si můžete všimnout na obrázku výše se seznamem entit máme u jednotlivých produktů k dispozici hned několik atributů:

  1. friendly_name – automaticky generovaný název
  2. battery_level – úroveň stavu baterie
  3. unit_of_measurement – pokud to dává smysl tak jednotku měřené veličiny
  4. device_class – pokud to dává smysl tak typ měřené veličiny

Zejména battery_level je velkým přínosem, jelikož ten v originální aplikaci Mi Home není vidět.

Jak vidíme integrace je poměrně jednodnoduchá, pokud vše šlape jak drátkách.

5 komentářů

Napsat komentář

Tato stránka používá Akismet k omezení spamu. Podívejte se, jak vaše data z komentářů zpracováváme..

  • Díky za Vaše články. Brána mi přišla před pár dny. Bohužel jsou s ní od začátku problémy. Objednal jsem starší verzi – podporu HomeKitu nepotřebuji, používám Home Assistent (HA), ovšem tahle brána nejprve nešla přidat ani do aplikace MiHome. Vyměnit telefon nepomohlo, teprve po mnoha pokusech mě napadlo dát bránu hned vedle jednoho z routerů (v domě máme 3, signál nikde neklesne pod 80 %) a telefon položit vedle. Fajn, brána se konečně přidala do aplikace.

    Další problém byl s jejím přepnutím do dev modu. Aplikace totiž ihned po vybrání brány v menu nabízela update FW a dál člověka nepustila. To bylo k vzteku, zablokování přístupu brány k internetu na hlavním routeru nepomohlo, když se od netu odřízl telefon, tak s bránou nekomunikoval vůbec. Řešením se ukázalo být prosté vytažení kabelu od antény do master routeru :-). Konečně přestal otravovat update, byl povolen dev mód, získáno heslo a brána připojena k HA. Přidání senzorů proběhlo bez problémů (2x teplota a vlhkost, 2x PIR). Na cestě jsou dveřní čidla, wireless button a kostka. Brána je nyní pomocí FW odříznuta od přístupu k internetu, což mobilní aplikaci činí nepoužitelnou, což ovšem díky HA vůbec nevadí (minimálně do okamžiku, kdy budu potřebovat přidat další sensory).

    Určitě dokoupím další teplotní čidla a PIR do míst, kde není jednoduchý přístup k elektřině, protože jinak dávám přednost DIY přístupu s Wemos D1 mini nebo NodemCu v hlavních rolích. Po počátečních problémech s bránou ale silně uvažuji o tom, že se jí zbavím a nahradím ji opensource řešením.

    • O alternativě brány bych chtěl dokončit článek tenhle víkend. Čili pokud mi do toho nic nevleze tak budu mít návod a první zkušenosti 🙂

      • Tak článek bohužel nebude. Zjistil jsem, že jsem si objednal nesprávný USB stick CC2540 namísto CC2531, čili ho budu schopen dokončit až tak za měsíc 🙁

        • Nevadí, rád počkám :-). V jednom z komentářů u minulého článku píšete, že máte vaše brána má MAC začínající 04:cf:8c – zrovna jako ta moje. Můžu vědět, jakou verzi FW máte? V aplikaci mi visí update na 1.4.1_167.0158, u kterého se tak trošku bojím, aby nezpůsobil rozpad komunikace mezi bránou a Home Assistantem.

          • Jj, mám právě tento. Nicméně bych bych asi opatrný. Já ten update provedl ještě před zapnutím lokálního sdílení a tuším, že v komentářích někdo psal, že s tím měl problém. Pokud vám vše funguje tak bych asi zůstal raději u toho stávajícího dokud nebudete mít zálohu v podobě alternativní brány o které jak to půjde napíšu článek 🙂

%d blogerům se to líbí: