Čo robiť, ak váš nový Tuya Zigbee senzor nefunguje v ZHA tak, ako by mal?

Jedným z hlavných dôvodov, prečo zákazníkom a klientom odporúčame vynechať natívne Zigbee rozhranie v Home Assistant s názvom Zigbee Home Automation (skrátene ZHA), sú problémy s kompatibilitou s novšími zariadeniami. Dôvod je jednoduchý: ZHA je oficiálny doplnok spravovaný tímom Home Assistant (Nabu Casa) a všetky nové zariadenia musia prejsť postupným procesom kontroly a schvaľovania, ktorý môže trvať niekoľko mesiacov. Naopak, Zigbee2MQTT je komunitný doplnok s otvoreným zdrojom a schvaľovanie je oveľa rýchlejšie.

Stále používate ZHA namiesto Zigbee2MQTT?

Úplne rozumieme používaniu ZHA – je oficiálny, natívny a veľmi jednoduchý na nastavenie aj používanie. Aj ja som s ním začínal a bol som spokojný, kým som nenarazil na problémy s kompatibilitou. V tomto článku sa zameriame hlavne na dva Tuya senzory, ktoré sú relatívne nové a veľmi populárne. Zatiaľ však neboli oficiálne pridané do ZHA. Ukážeme vám krok za krokom, ako situácia vyzerá a ako môžete dosiahnuť požadovaný výsledok. Rovnaký postup sme použili aj v tomto článku o Tongou Zigbee ističoch.

Prvé rozbalenie a párovanie

Párovanie prebehne hladko, ale senzor sa zobrazí bez očakávaných entít, s nesprávnymi entitami alebo napríklad s nesprávnym desatinným oddeľovačom v jednotkách? Toto je typický znak chýbajúceho quirku v ZHA:

Google, opätovné párovanie a skúšanie všetkého možného

Nasleduje opätovné párovanie, kontrola manuálu, hľadanie na Googli alebo dokonca odoslanie nahnevaného e-mailu predajcovi (nám :D), že senzor nefunguje! Ideálne je, ak ste tento článok našli hneď. Riešenie pre tieto dva senzory je jednoduché. Stačí prejsť na stránku produktu a stiahnuť si príslušný vlastný quirk.

ts0201_tz3000_yupc0pb7.py - Tuya Zigbee inteligentný vonkajší hygrometer a teplomer – IP65 vodeodolný

ts0601_tze284_snx96j9e.py - Tuya Zigbee teplotný senzor s externou sondou

Inštalácia quirku v Home Assistant (File Editor)

Nie je potrebné zasahovať do zdrojového kódu Home Assistant. Quirk sa inštaluje ako vlastný Tuya quirk do /config, rovnako ako ostatné vlastné ZHA quirky.

1. Nainštalujte doplnok File Editor

   • Nastavenia → Doplnky → Obchod s doplnkami.

   • Nainštalujte File Editor (alebo Studio Code Server).

2. Vytvorte priečinok pre Tuya quirks

   • Vo File Editor otvorte /config.

   • Vytvorte priečinok, napríklad:
     tuya_quirks

   • Umiestnite .py súbory do tohto priečinka

   • 

3. Jednoduchá úprava configuration.yaml

   • Pridajte nasledujúci kód do configuration.yaml na nový riadok:

   • zha:
       enable_quirks: true
       custom_quirks_path: zha_quirks/

4. Reštartujte Home Assistant

   • Odporúča sa úplný reštart, aby sa nový quirk načítal v ZHA doplnku.

5. Skontrolujte načítanie vlastných quirks v logu Home Assistant

   • Nastavenia → Systém → Záznamy
   • 

Opätovné párovanie a hotovo!

Po rýchlom opätovnom párovaní by sa mali zobraziť všetky očakávané entity. To je všetko – máte hotovo! Nemusíte už nič ďalšie robiť a nemusíte sa obávať, že budúce aktualizácie ovplyvnia vaše zariadenie. Mapovanie je nastavené priamo pomocou vašich vlastných .py súborov. Dúfam, že vám tento článok pomohol :)