Aqara Light Switch H1 / H2 EU v Home Assistant

O Aqara Light Switch

Aqara Light Switch je moderní chytrý vypínač, který podporuje komunikaci přes protokoly Matter over Thread i Zigbee. Díky tomu lze snadno ovládat nejen osvětlení, ale i další připojená zařízení. Vypínač je navržen tak, aby zapadl do běžných 55mm instalačních rámečků, a nabízí možnost instalace s neutrálním vodičem i bez něj, což zvyšuje variabilitu použití. Uživatelům poskytuje funkce dálkového ovládání, časového plánování i sledování spotřeby energie, takže představuje pohodlné a flexibilní řešení pro chytrou domácnost.

Dostupný je ve dvou variantách:

• H1: 2 tlačítka, z toho 1 fyzické a 1 virtuální
• H2: 4 tlačítka, z toho 2 fyzická a 2 virtuální

Integrace obou EU variant do Home Assistant je shodná. Postup níže uvádí integraci varianty Aqara Light Switch H2 EU.

Vybavení vypínače H2

• 2 fyzická tlačítka, připojená na vedení
• 2 virtuální tlačítka (lze odposlouchávat z Home Assistant) a přiřadit k nim akce

Instalace

Instalace vypínače Aqara Light Switch H2 EU do zdi je velmi jednoduchá - stačí nahradit váš stávající dvojitý vypínač za vypínač Aqara. Po napojení kabeláže dvojice fyzických tlačítek začne okamžitě fungovat - ovládat Vaše stávající světla. Nicméně, nastavení dvojice virtuálních tlačítek je v době psaní (červenec 2025) mnohem komplikovanější, viz níže.

1. Nutnost protokolu Zigbee

   Výchozím protokolem vypínače Aqara Light Switch H2 EU je Matter. Na tomto protokolu jste schopni v Home Assistant vidět události dvojice virtuálních tlačítek (jsou / byly stisknuty), avšak nejste s těmito událostmi nikterak schopni pracovat v rámci automatizace a akcí. Pro to je nutné použít protokol ZigBee.

   Přepnutí vypínače z protokolu Matter do Zigbee

   Přepnutí protokolu je možné pouze za pomocí Aqara Hubu. Nedisponujete-li žádným z Aqara Hubem, nejlevnější alternativou je nákup Hubu M100 (jste-li z Olomouce, mohu zapůjčit). K přepnutí protokolu budete dále potřebovat v telefonu nainstalovanou aplikaci Aqara Home.

   1. Ujistěte se, že máte v domácnosti zapojený Aqara Hub
   2. Na mobilním telefonu povolte Bluetooth a Wi-fi a spusťte Aqara Home aplikaci
   3. Stisknutím libovolného tlačítka na vypínači 10x v řadě aktivujte tovární nastavení vypínače (na vypínači začnou blikat modré indikátory)
   4. V aplikaci Aqara Home klepněte na "Přidat příslušenství" (ikona + vpravo nahoře) a vyberte nalezené zařízení Aqara Light Switch H2 EU, případně naskenujte kód Matter, který naleznete jak na samotném ovladači, tak i v návodě k ovladači
   5. V aplikaci, ještě před "potvrzením" přidání, na stránce vypínače, je malým modrým textem dole text "Switch Protocol" - vyberte Zigbee a vypínač přidejte. (Poznámka: Zigbee protokol po tomto zůstane výchozím i po případném opětovném resetu opět do továrního nastavení. Zpět na protokol Matter by se přešlo opětovně přes tlačítko "Switch protocol")

2. Zprovoznění Zigbee2QMTT na Home Assistant (nevyužíváte-li)

   • Ujistěte se, že v Home Assistant máte Zigbee koordinátor (např. Home Assistant Connect ZBT-1 nebo Sonoff Zigbee 3.0 USB Dongle Plus E) s aktivovaným Zigbee protokolem

   Události dvojice virtuálních (bezdrátových) tlačítek v Home Assistant je nutné odposlouchávat. To však není nutné v rámci defaultního Zigbee ovladače. Na Home Assistant je nutné používat Home Assistant addon Zigbee2MQQT + MQTT brokeru. Instalace addonu je ukázána níže:

   • Instalace MQTT brokeru

     Pro výměnu dat mezi koordinatorem a Home Assistant potřebujete prostředníka tzv. Mosquitto broker. Ten nalezneme v sekci Nastavení → doplňky. V nabídce dostupné pod modrým tlačítkem "Obchod s doplňky" vpravo dole nalezneme Mosquitto broker a nainstalujeme jej.

     V nastavení doplňku Mosquitto broker, v poli Logins, vložíme:

     - username: mqtt
       password: mqtt

     Samozřejmě, hodnoty můžeme změnit na bezpečnější.

     Mosquitto broker spustíme.

   • Instalace Zigbee2MQQT

     • V Obchodu s doplňky dále klikneme na tři tečky vpravo nahoře a zvolíme možnost repozitáře. Do okna vložíme následující adresu repozitáře:

       https://github.com/zigbee2mqtt/hassio-zigbee2mqtt

       Repozitář přidáme. Po akualizaci stránky obchodu s doplňky nalezneme doplněk "Zigbee2MQTT" a nainstalujeme jej.

       V nastavení doplňku Zigbee2MQTT:

       • do sekce mqtt vložíme následující url:

         server: mqtt://mqtt:mqtt@172.30.32.1:1883

       • Do sekce serial vložte:

         port: /dev/ttyUSB0
         adapter: ezsp

     • Spusťte Zigbee2MQTT. Pro zvýšení pohodlnosti si můžete rovněž aktivovat Zobrazení v postranním panelu a spuštění při spuštění, stejně jako hlídacího psa.

3. Přidání Aqara Light Switch H2 EU do Home Assistant

   • V Zigbee2MQTT, vpravo v liště záložek aktivujte "povolení připojení"
   • Přepněte Aqara Light Switch H2 EU do párvacího režimu následujícím způsobem:
     • Stiskněte libovolné fyzické tlačítko
     • Po cca sekundě jej stiskněte znovu
     • Po cca další sekundě jej stiskněte znovu a držte po dobu cca 5 sekund, respektive, dokud se nerozbliká jeho dioda indikující režim párování
     • Vypínač by se měl automaticky načíst do Home Assistant

4. Konfigurace virtuálních tlačítek v Home Assistant

   Prostřednictvím doplňku MQTT lze odposlouchávat veškeré datové toky jdoucí přes brokera. Spustit odposlech lze přes tlačítko nastavení a následně sekci "Listen To Topics".

   Odposlouchávat lze na zigbee2mqtt/#. Na základě mého odposloucvávání, virtuální tlačítka vypínače Aqara Light Switch H2 EU jsou dostupná v následující formě:

   Topic: zigbee2mqtt/0x54exxxxxxxxxxxxx/action  
   Payload: single_left_down

   popř Payload: single_right_down pro pravé tlačítko.

   S těmito payloads lze již pracovat v automatizacích, a to na událost "When an MQTT message has been received" viz níže: