Was tun, wenn Ihr neuer Tuya Zigbee Sensor in ZHA nicht wie erwartet funktioniert?

Einer der Hauptgründe, warum wir Kunden und Klienten empfehlen, auf die native Zigbee-Schnittstelle in Home Assistant, genannt Zigbee Home Automation (oder kurz ZHA), zu verzichten, sind Kompatibilitätsprobleme mit neueren Geräten. Der Grund ist einfach: ZHA ist ein offizielles Add-on, das vom Home Assistant (Nabu Casa) Team verwaltet wird, und alle neuen Geräte müssen einen schrittweisen Prüf- und Freigabeprozess durchlaufen, der mehrere Monate dauern kann. Im Gegensatz dazu ist Zigbee2MQTT ein von der Community entwickeltes Add-on, bei dem die Freigabe deutlich schneller erfolgt.

Nutzen Sie noch ZHA statt Zigbee2MQTT?

Wir verstehen vollkommen, wenn Sie ZHA verwenden – es ist offiziell, nativ und sehr einfach einzurichten und zu bedienen. Ich selbst habe damit angefangen und war zufrieden, bis ich auf Kompatibilitätsprobleme gestoßen bin. In diesem Artikel konzentrieren wir uns hauptsächlich auf zwei Tuya-Sensoren, die relativ neu und sehr beliebt sind. Allerdings wurden sie noch nicht offiziell zu ZHA hinzugefügt. Wir zeigen Ihnen Schritt für Schritt, wie die Situation aussieht und wie Sie dennoch das gewünschte Ergebnis erzielen können. Die gleiche Vorgehensweise haben wir auch in diesem Artikel über den Tongou Zigbee-Leistungsschalter verwendet.

Erstes Unboxing und Koppeln

Das Koppeln selbst verläuft reibungslos, aber der Sensor erscheint entweder ohne die erwarteten Entitäten, mit falschen Entitäten oder vielleicht nur mit dem falschen Dezimaltrennzeichen bei den Einheiten? Das ist ein typisches Zeichen für einen fehlenden Quirk in ZHA:

Google, Neu-Koppeln und alle Möglichkeiten ausprobieren

Als Nächstes kommt das erneute Koppeln, das Nachschlagen im Handbuch, die Google-Suche oder vielleicht sogar eine verärgerte E-Mail an den Verkäufer (uns :D), dass der Sensor nicht funktioniert! Im Idealfall sind Sie direkt auf diesen Artikel gestoßen. Die Lösung für diese beiden Sensoren ist einfach. Gehen Sie einfach auf die Produktseite und laden Sie den passenden Custom Quirk herunter.

ts0201_tz3000_yupc0pb7.py – Tuya Zigbee Smart Outdoor Hygrometer und Thermometer – IP65 Wasserdicht

ts0601_tze284_snx96j9e.py – Tuya Zigbee Temperatursensor mit externem Fühler

Quirk in Home Assistant installieren (File Editor)

Es ist nicht nötig, den Quellcode von Home Assistant zu verändern. Der Quirk wird als benutzerdefinierter Tuya Quirk im Verzeichnis /config installiert, genauso wie andere benutzerdefinierte ZHA-Quirks.

1. File Editor Add-on installieren

   • Einstellungen → Add-ons → Add-on Store.

   • Installieren Sie File Editor (oder Studio Code Server).

2. Ordner für Tuya-Quirks anlegen

   • Öffnen Sie im File Editor das Verzeichnis /config.

   • Erstellen Sie einen Ordner, z. B.:
     tuya_quirks

   • Legen Sie die .py-Dateien in diesem Ordner ab

   • 

3. Einfache Anpassung der configuration.yaml

   • Fügen Sie folgenden Code in der configuration.yaml in einer neuen Zeile hinzu:

   • zha:
       enable_quirks: true
       custom_quirks_path: zha_quirks/

4. Home Assistant neu starten

   • Ein vollständiger Neustart wird empfohlen, damit das ZHA-Add-on den neuen Quirk lädt.

5. Sie können im Home Assistant-Log prüfen, ob die Custom Quirks geladen wurden

   • Einstellungen → System → Protokolle
   • 

Neu koppeln und fertig!

Nach einem schnellen erneuten Koppeln sollten alle erwarteten Entitäten erscheinen. Das war’s – Sie sind fertig! Sie müssen nichts weiter tun und brauchen sich keine Sorgen machen, dass zukünftige Updates Ihr Gerät beeinträchtigen. Das Mapping erfolgt direkt über Ihre eigenen .py-Dateien. Ich hoffe, dieser Artikel konnte Ihnen helfen :)