Co dělat, když nový Tuya Zigbee senzor nefunguje v ZHA tak, jak by měl?

Jedním z hlaních důvodů, proč zákazníkům a klientům doporučujeme nativní Zigbee rozhraní v Home Assistant, které se jmenuje Zigbee Home Automation (zkráceně již pouze jako ZHA), přeskočit je problém s kompatibilitou u novějších zařízení. Důvod je prostý. ZHA je oficiální doplněk spravován týmem Home Assistant (Nabu Casa) a všechna nová zařízení musí projít postupnou kontrolou a schválením, což může trvat i dlouhé měsíce. Naproti tomu Zigbee2MQTT je otevřený komunitní doplněk a schválení je zde mnohem rychlejší.

Stále používáte ZHA namísto Zigbee2MQTT?

Používání ZHA ale naprosto chápeme, je oficiální, nativní a velmi jednoduché na zprovoznění a použití. Také jsem s ním začínal a byl spokojen, dokud jsem nenarazil právě na problém kompatibility. V tomto článku se zaměříme zejména na 2 Tuya senzory, které jsou poměrně nové a velmi oblíbené. Zatím ale nebyly do ZHA oficiálně přidány. Krok za krokem si ukážeme, jak situace vypadá a jak lze dosáhnout tíženého výsledku. Stejnou situaci a postup jsme aplikovali již v tomto článku o Tongou Zigbee jističi.

První rozbalení a párování

Samotné párování proběhne bez problémů, ale senzor se zobrazí bez očekávaných entit, nebo jsou zde špatné entity a nebo jen špatná desetinná čárka u jednotek? Typický příznak chybějícího quirku v ZHA:

Google, přepárování a zkoušení všeho možného

Na řadu přichází přepárování, manuál, hledání na Google, případně naštvaný mail na prodejce (nás :D), že senzor nefunguje! V ideálním případě jste rovnou narazili na tento článek. Řešení u těchto dvou senzorů je na snadě. Stačí přejít na produktovou stránku a stáhnout příslušný custom quirk.

ts0201_tz3000_yupc0pb7.py - Tuya Zigbee Chytrý venkovní hygrometr a teploměr – IP65 voděodolný

ts0601_tze284_snx96j9e.py - Tuya Zigbee teplotní senzor s externím čidlem

Instalace quirku v Home Assistantu (File Editor)

Není nutné sahat do zdrojového kódu Home Assistantu. Quirk se instaluje jako vlastní Tuya quirk do /config, podobně jako custom ZHA quirks.

1. Nainstalujte doplněk File Editor

   • Nastavení → Add-ons → Add-on Store.

   • Nainstalujte File Editor (nebo Studio Code Server).

2. Vytvořte složku pro Tuya quirks

   • V File Editoru otevřete /config.

   • Vytvořte složku, např.:
     tuya_quirks

   • Do této složky vložte soubory ve formátu .py

   • 

3. Jednoduchá úprava configuration.yaml

   • Do configuration.yaml vložte na nový řádek tento kód: 

   • zha:
       enable_quirks: true
       custom_quirks_path: zha_quirks/

4. Restartujte Home Assistant

   • Doporučený je plný restart, aby doplněk ZHA načetla nový quirk.

5. Načtení custom quirks zkontrolujete v logu od Home Assistant

   • Nastavení -> systém -> logy
   • 

Přepárování a hotovo!

Po rychlém přepárování by se měly objevit všechny očekávané entity. Jsme tedy již v cíli a máme hotovo! Není třeba již dál nic dělat a není třeba se ani obávat, že by budoucí aktualizace se zařízením cokoliv udělala. Mapování máme natvrdo nastavené pomocí vlastních .py souborů. Zbývá mi tedy jen doufat, že vám článek pomohl :)