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.

  1. Installa l’add-on File Editor

    • Impostazioni → Add-on → Add-on Store.

    • Installa File Editor (o Studio Code Server).

  2. 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

  3. 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/
  4. Riavvia Home Assistant

    • Si consiglia un riavvio completo affinché l’add-on ZHA carichi la nuova quirk.

  5. 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 :)

%s ...
%s
%image %title %code %s