Cosa fare se il tuo nuovo sensore Tuya Zigbee non funziona correttamente in ZHA?
Uno dei principali motivi per cui consigliamo a clienti e utenti di evitare l’interfaccia Zigbee nativa in Home Assistant, chiamata Zigbee Home Automation (o semplicemente ZHA), sono i problemi di compatibilità con i dispositivi più recenti. Il motivo è semplice: ZHA è un add-on ufficiale gestito dal team di Home Assistant (Nabu Casa), e tutti i nuovi dispositivi devono passare attraverso un processo graduale di revisione e approvazione, che può richiedere diversi mesi. Al contrario, Zigbee2MQTT è un add-on aperto alla community e l’approvazione è molto più rapida.
Stai ancora usando ZHA invece di Zigbee2MQTT?
Comprendiamo perfettamente l’utilizzo di ZHA: è ufficiale, nativo e molto facile da configurare e utilizzare. Anch’io ho iniziato con ZHA e ne sono stato soddisfatto, finché non ho incontrato problemi di compatibilità. In questo articolo ci concentreremo principalmente su due sensori Tuya che sono relativamente nuovi e molto popolari. Tuttavia, non sono ancora stati aggiunti ufficialmente a ZHA. Ti guideremo passo dopo passo su qual è la situazione e come puoi ottenere il risultato desiderato. Abbiamo utilizzato lo stesso approccio in questo articolo sul relè Zigbee Tongou.
Primo unboxing e pairing
Il pairing avviene senza problemi, ma il sensore appare senza le entità previste, oppure con entità errate, o magari solo con il separatore decimale sbagliato nelle unità? Questo è un tipico segnale della mancanza di una quirk in ZHA:

Google, nuovo pairing e tentativi di ogni tipo
Il passo successivo è ripetere il pairing, controllare il manuale, cercare su Google o magari anche inviare una mail arrabbiata al venditore (a noi :D) perché il sensore non funziona! L’ideale sarebbe che tu abbia trovato subito questo articolo. La soluzione per questi due sensori è semplice. Basta andare sulla pagina prodotto e scaricare la quirk personalizzata appropriata.
ts0201_tz3000_yupc0pb7.py - Tuya Zigbee Igrometro e Termometro Smart da Esterno – Impermeabile IP65
ts0601_tze284_snx96j9e.py - Tuya Zigbee Sensore di Temperatura con Sonda Esterna

Installazione di una Quirk in Home Assistant (File Editor)
Non è necessario modificare il codice sorgente di Home Assistant. La quirk viene installata come quirk personalizzata Tuya in /config, proprio come le altre quirks personalizzate di ZHA.
-
Installa l’add-on File Editor
-
Crea una cartella per le quirks Tuya
-
In File Editor, apri
/config. -
Crea una cartella, ad esempio:
tuya_quirks -
Inserisci i file .py in questa cartella

-
-
Modifica semplice del file configuration.yaml
-
Aggiungi il seguente codice in configuration.yaml su una nuova riga:
- zha:
enable_quirks: true
custom_quirks_path: zha_quirks/
-
-
Riavvia Home Assistant
-
Si consiglia un riavvio completo affinché l’add-on ZHA carichi la nuova quirk.
-
-
Puoi verificare se le quirks personalizzate sono state caricate nei log di Home Assistant
- Impostazioni → Sistema → Log

Nuovo pairing e fatto!
Dopo un rapido nuovo pairing, dovrebbero comparire tutte le entità previste. Ecco fatto—hai finito! Non devi fare altro e non devi preoccuparti che futuri aggiornamenti influenzino il tuo dispositivo. La mappatura è gestita direttamente tramite i tuoi file .py personalizzati. Spero davvero che questo articolo ti sia stato utile :)








