Addomesticare lo Zoo Tuya e Dimenticarsi delle Nuvole Cinesi
Supponiamo che tu abbia acquistato un riscaldatore intelligente, una lampadina o un sensore di perdite d'acqua. La confezione mostra orgogliosamente il logo Tuya o SmartLife. Colleghi il dispositivo, installi l'app e tutto sembra funzionare bene. Ma nel momento in cui la connessione internet vacilla o i server cinesi iniziano a sentirsi sotto tempo, la tua casa "intelligente" si trasforma in una zucca. Storia familiare?
Molti di noi arrivano a Home Assistant proprio per strappare il controllo delle nostre case dalle grinfie dei servizi cloud. Ma Tuya ha sempre avuto una fregatura: l'integrazione ufficiale funziona attraverso la loro API, che è a pagamento, ha un periodo di prova limitato, o è semplicemente lenta. Il progetto tuya-local risolve questo problema in modo radicale: fa comunicare i dispositivi direttamente con il tuo server sulla rete locale.
Qual è lo Scopo di Questo Progetto
Per dirla brevemente: è un componente personalizzato per Home Assistant che ti permette di controllare i dispositivi Tuya via Wi-Fi senza intermediari.
Il punto principale qui non è solo la velocità (anche se la risposta diventa quasi istantanea). Il valore fondamentale è che l'integrazione può "estrarre" funzionalità che il cloud ufficiale non mostra affatto. Ad esempio, modalità operative specifiche di apparecchiature climatiche o statistiche dettagliate sul consumo energetico che i cinesi hanno deciso di nascondere nell'app ma non hanno esposto tramite l'API.
A proposito, il progetto supporta più dei semplici dispositivi Wi-Fi. Se hai un gateway Tuya, puoi collegare periferiche Zigbee attraverso di esso, anche se l'autore onestamente avverte: le capacità dell'hub per connessioni locali simultanee sono severamente limitate.
Cosa Può Fare tuya-local
Il repository dichiara il supporto per oltre mille dispositivi. Non si tratta solo di "acceso/spento" — è un funzionamento a tutti gli effetti con entità complesse.
- Clima e riscaldamento. Convettori intelligenti, condizionatori d'aria e umidificatori funzionano con tutti i loro sensori e preset.
- Illuminazione. Il supporto per diversi protocolli (dalla versione 3.1 alla 3.5) ti permette di far funzionare localmente anche lampade esigenti che prima rifiutavano di collaborare.
- Sicurezza. C'è supporto per alcuni modelli di serrature. Implementa uno schema intelligente per l'intercettazione delle chiavi di sblocco, cosa generalmente rara per le integrazioni open-source.
- Elettrodomestici. Dalle mangiatoie per animali domestici (con supporto per la programmazione dei pasti) ai trasmettitori IR che possono imparare comandi direttamente dall'interfaccia di Home Assistant.
Come Far Funzionare Tutto Senza Sforzare la Schiena
In precedenza, configurare Tuya in locale ricordava un rituale di evocazione di demoni: dovevi creare un account sviluppatore, estrarre local_key attraverso la console e soffrire. In tuya-local, il processo è stato notevolmente semplificato.
L'integrazione ha due percorsi di configurazione. Il primo è l'"assistente cloud". Accedi con il tuo account SmartLife una volta, l'integrazione importa automaticamente l'elenco dei dispositivi e le loro chiavi segrete, e poi funziona con essi solo localmente. Questo ti salva dal dover rinnovare la prova ogni sei mesi sul portale Tuya IoT.
Il secondo percorso è manuale. Se sei un paranoico incallito che ha già ottenuto tutti gli ID e le chiavi da solo, li inserisci semplicemente nella scheda del dispositivo.
Sottigliezze e Insidie
Ci sono sfumature, ovviamente. Tuya non è un singolo standard — è più un patchwork di diverse versioni del firmware.
Prima di tutto, molti dispositivi mantengono solo una connessione locale attiva. Se hai l'app aperta sul telefono o un'altra integrazione in esecuzione (ad esempio la vecchia localtuya), quella nuova semplicemente non riuscirà a raggiungere l'hardware.
In secondo luogo, i dispositivi alimentati a batteria (sensori di porte o fumo) non funzioneranno localmente senza un hub. Vanno in standby per risparmiare energia e si attivano solo per "pingare" i dati al cloud. Non puoi ingannare la fisica qui — per questi, è meglio usare versioni Zigbee con un apposito stick.
Terzo, alcuni hardware iniziano a comportarsi in modo strano se blocchi completamente il loro accesso a internet sul router. Potrebbero finire in un ciclo infinito di riavvii. L'autore consiglia di bloccare non solo il TCP ma anche le richieste DNS dal dispositivo in questi casi.
Perché Questo È Meglio delle Alternative
C'è un'alternativa popolare — localtuya. Ho provato entrambi. localtuya è più flessibile quando si tratta di configurare manualmente ogni punto dati specifico (DP), ma è anche la sua rovina: configurare un singolo termostato complesso diventa un'ora di armeggiare con le tabelle.
tuya-local prende la strada delle configurazioni pronte. Se il tuo dispositivo è nell'elenco supportato, selezioni semplicemente il suo tipo, e tutti i sensori/pulsanti appaiono da soli. Questo fa risparmiare un sacco di tempo. Se il tuo dispositivo non è supportato, puoi aiutare il progetto inviando log con un dump dei dati — la comunità lì è molto attiva.
Se la tua casa sta gradualmente diventando invasa da dispositivi Tuya, installare questa integrazione è un must. Se non altro per il fatto che le luci si accendono istantaneamente, invece di un secondo dopo che il segnale fa un viaggio di andata e ritorno verso Francoforte o Shanghai.
Il progetto è maturo, con un solido database di dispositivi e una logica di configurazione sana. Sì, Tuya è ancora uno "zoo", ma con questo strumento tra le mani, ottieni almeno una frusta adeguata e un sacco di premi per l'addestramento.
Vale la pena provarlo se:
- Sei stanco dei ritardi delle API cloud.
- Hai un dispositivo Tuya specifico che non si integra bene in HA usando i metodi standard.
- Vuoi che le automazioni funzionino anche quando il tuo ISP va giù.
Puoi trovare il progetto in HACS cercandolo per nome o direttamente su GitHub: make-all/tuya-local.
Progetti correlati