Local Tuya in Home Assistant: configurazione passo-passo per il controllo locale

Hai una casa piena di dispositivi Tuya economici che funzionano bene, tranne quando il cloud decide di prendersi una pausa. La risposta è lenta, le automazioni saltano, e il dispositivo risulta "irraggiungibile". Local Tuya risolve tutto portando il controllo in rete locale. Ma il setup non è banale.

Tuya: il bene e il male

Tuya è un ecosistema enorme. Centinaia di brand usano il firmware e il cloud Tuya per i loro prodotti: prese smart, lampadine, sensori, relè. Il vantaggio è il prezzo (dispositivi a metà costo rispetto ai brand premium) e la varietà. Lo svantaggio è la dipendenza dal cloud cinese.

Quando usi l'app Smart Life per accendere una presa, il comando fa: telefono -> cloud Tuya -> presa nella tua rete locale. Questo giro causa latenza variabile (da mezzo secondo a 10 secondi), dipendenza dalla connessione internet (cloud down = casa ferma), e invio continuo di dati a server esterni.

Il punto chiave: i dispositivi Tuya supportano già la comunicazione locale. Parlano sulla tua rete. Ma servono chiavi di sicurezza specifiche per sbloccare questa comunicazione diretta.

Setup di Local Tuya passo per passo

Il processo richiede tre fasi principali:

1. Account developer Tuya: su iot.tuya.com, creare un progetto Cloud con industria "Smart Home" e metodo "Smart Home". Selezionare il data center più vicino. Sotto "Authorized API Services", attivare "Device Log Query". Collegare l'account Smart Life/Tuya Smart al progetto developer scansionando un QR code dall'app.

2. Installazione integrazione: in HACS (Home Assistant Community Store), cercare "Local Tuya", installare e riavviare Home Assistant. Andare in Settings -> Integrations -> Add Integration -> Local Tuya. Inserire regione, Client ID (Access ID), Client Secret e User ID (UUID dell'account, non l'email).

3. Configurazione dispositivi: ogni dispositivo va aggiunto manualmente. L'integrazione scansiona la sottorete locale e mostra i dispositivi trovati. Per ciascuno, bisogna configurare i datapoint corretti (es. datapoint 1 = switch on/off, datapoint 20 = corrente, ecc.). Questo è il passaggio più complesso: ogni tipo di dispositivo ha datapoint diversi e non sempre documentati.

Un'osservazione importante: si possono collegare massimo due progetti allo stesso account device Tuya. Se si esauriscono, bisogna creare un nuovo account.

Risultati e limiti

Dopo la configurazione, i dispositivi rispondono istantaneamente. Gli aggiornamenti di stato arrivano via push (non polling), il che riduce il traffico di rete e migliora la reattività. I dispositivi funzionano anche senza internet.

I limiti: la configurazione manuale di ogni datapoint è tediosa e soggetta a errori. Gli aggiornamenti firmware Tuya possono cambiare i datapoint e rompere l'integrazione. Alcuni dispositivi non supportano completamente il protocollo locale.

Come farlo con Roraima

Il gateway IoT di Roraima implementa l'integrazione Tuya locale come funzionalità nativa, senza richiedere configurazione manuale al buyer:

Il Tuya Device Sharing via QR è il metodo principale. Il vendor configura il dispositivo nel suo account Tuya, genera un QR di condivisione dall'app Smart Life, e il gateway gestisce tutto il processo di pairing. Nessun account developer necessario per il buyer, nessun datapoint da configurare manualmente, nessun HACS da installare.

Per i dispositivi già estratti dal cloud (firmware custom, Tuya Convert), il gateway supporta connessione diretta via MQTT adapter. Il dispositivo pubblica su un topic MQTT, il broker integrato nel gateway riceve e rende i dati disponibili nel pannello di controllo e nello scenario engine.

La Tuya Cloud API resta disponibile come metodo di backup per dispositivi che non supportano né lo sharing QR né MQTT. Il gateway gestisce le credenziali del vendor in modo sicuro, con rotazione automatica dei token.

Lo scenario engine tratta i dispositivi Tuya esattamente come qualsiasi altro protocollo. Un trigger device_threshold su un sensore di temperatura Tuya funziona con la stessa sintassi e velocità di un trigger su un Shelly: "se la temperatura in camera supera 26 gradi per 10 minuti, attiva il condizionatore". Con il controllo locale via MQTT, la risposta è istantanea.

Le 13 categorie ambientali del marketplace includono molti dispositivi Tuya: sensori di temperatura e umidità (Clima ed Energia), prese smart (Soggiorno, Cucina), sensori di sicurezza (Sicurezza), lampadine (tutte le categorie). Il buyer sceglie per funzione, non per protocollo.

Conclusione

Local Tuya dimostra che i dispositivi economici Tuya possono funzionare in modo affidabile e sicuro quando si elimina la dipendenza dal cloud. Roraima automatizza questa transizione: il gateway gestisce protocolli e chiavi, il marketplace offre dispositivi già integrati, e il buyer gode di controllo locale senza mai aprire un terminale.