Co zrobić, jeśli nowy czujnik Tuya Zigbee nie działa poprawnie w ZHA?

Jednym z głównych powodów, dla których polecamy klientom pominięcie natywnego interfejsu Zigbee w Home Assistant, czyli Zigbee Home Automation (w skrócie ZHA), są problemy z kompatybilnością z nowszymi urządzeniami. Powód jest prosty: ZHA to oficjalny dodatek zarządzany przez zespół Home Assistant (Nabu Casa), a wszystkie nowe urządzenia muszą przejść stopniowy proces przeglądu i zatwierdzenia, który może trwać kilka miesięcy. Dla porównania, Zigbee2MQTT to otwarty dodatek społecznościowy, gdzie zatwierdzanie przebiega znacznie szybciej.

Wciąż używasz ZHA zamiast Zigbee2MQTT?

Doskonale rozumiemy korzystanie z ZHA — jest oficjalny, natywny i bardzo łatwy w konfiguracji oraz obsłudze. Sam od niego zaczynałem i byłem zadowolony, dopóki nie napotkałem problemów z kompatybilnością. W tym artykule skupimy się głównie na dwóch sensorach Tuya, które są stosunkowo nowe i bardzo popularne. Jednak nie zostały jeszcze oficjalnie dodane do ZHA. Przeprowadzimy Cię krok po kroku przez całą sytuację i pokażemy, jak osiągnąć zamierzony efekt. Ten sam sposób opisaliśmy w artykule o wyłączniku obwodu Tongou Zigbee.

Pierwsze rozpakowanie i parowanie

Samo parowanie przebiega bezproblemowo, ale sensor pojawia się bez oczekiwanych encji, z nieprawidłowymi encjami albo np. ze złym separatorem dziesiętnym w jednostkach? To typowy objaw braku odpowiedniego quirku w ZHA:

Google, ponowne parowanie i próbowanie wszystkiego

Następny krok to ponowne parowanie, sprawdzanie instrukcji, przeszukiwanie Google, a może nawet wysłanie zdenerwowanego maila do sprzedawcy (czyli do nas :D), że sensor nie działa! Idealnie, jeśli od razu trafiłeś na ten artykuł. Rozwiązanie dla tych dwóch sensorów jest proste. Wystarczy wejść na stronę produktu i pobrać odpowiedni, niestandardowy quirk.

ts0201_tz3000_yupc0pb7.py - Tuya Zigbee Inteligentny Higrometr i Termometr Zewnętrzny – Wodoodporność IP65

ts0601_tze284_snx96j9e.py - Tuya Zigbee Czujnik Temperatury z Zewnętrzną Sondą

Instalacja quirku w Home Assistant (File Editor)

Nie ma potrzeby ingerowania w kod źródłowy Home Assistant. Quirk instalujemy jako niestandardowy quirk Tuya w katalogu /config, dokładnie tak jak inne customowe quirki ZHA.

1. Zainstaluj dodatek File Editor

   • Ustawienia → Dodatki → Sklep z dodatkami.

   • Zainstaluj File Editor (lub Studio Code Server).

2. Utwórz folder na quirki Tuya

   • W File Editor otwórz /config.

   • Utwórz folder, np.:
     tuya_quirks

   • Umieść pliki .py w tym folderze

   • 

3. Prosta edycja configuration.yaml

   • Dodaj poniższy kod do configuration.yaml w nowej linii:

   • zha:
       enable_quirks: true
       custom_quirks_path: zha_quirks/

4. Zrestartuj Home Assistant

   • Zalecany jest pełny restart, aby dodatek ZHA załadował nowy quirk.

5. Możesz sprawdzić, czy customowe quirki się załadowały w logach Home Assistant

   • Ustawienia → System → Logi
   • 

Ponowne parowanie i gotowe!

Po szybkim ponownym sparowaniu powinny pojawić się wszystkie oczekiwane encje. To wszystko — gotowe! Nie musisz już nic więcej robić i nie musisz się martwić, że przyszłe aktualizacje wpłyną na Twoje urządzenie. Mapowanie jest ustawione bezpośrednio przez Twoje własne pliki .py. Mam nadzieję, że ten artykuł był pomocny :)