Valvola di chiusura automatica e Home Assistant: guida all'integrazione

Questo rilevatore di perdite e valvola di chiusura è controllato tramite l'app Smart Life, che funziona sulla piattaforma di Tuya, e i dispositivi Tuya sono proprio quelli per cui è stata progettata l'integrazione ufficiale di Home Assistant. Ciò significa che esiste un percorso documentato per integrare questa categoria di dispositivi in Home Assistant: basta collegare lo stesso account Smart Life perché Home Assistant possa vedere i dispositivi associati. Non è documentato, invece, se tutte le funzioni che questa valvola mette a disposizione nell'app — monitoraggio del flusso, avvisi e la chiusura stessa — siano disponibili come entità utilizzabili una volta effettuato il collegamento, né se un'alternativa esclusivamente locale supporti questo specifico prodotto e firmware. Vale la pena verificare entrambe le cose prima di pianificare un'automazione.

• La valvola si integra con Home Assistant attraverso lo stesso meccanismo «Powered by Tuya» degli altri dispositivi Smart Life, non tramite un plugin specifico per il dispositivo: perciò il collegamento dell'account conta più del singolo prodotto.
• L'integrazione ufficiale Tuya per Home Assistant funziona tramite il cloud di Tuya, mentre un progetto separato della community, chiamato tuya-local, controlla direttamente i dispositivi supportati sulla rete domestica: i due percorsi hanno requisiti e limiti diversi.
• In Home Assistant, un'automazione che reagisce a una perdita e aziona la valvola è composta da un trigger, una condizione facoltativa e un'azione; il tipo di entità valvola supporta i comandi di apertura, chiusura, arresto e impostazione della posizione.
• Il produttore documenta una batteria ricaricabile di riserva in caso di interruzione di corrente, ma non specifica in quale posizione rimanga la valvola se, alla fine, si esauriscono sia l'alimentazione di rete sia la batteria: un dettaglio importante quando si aggiunge un'automazione.
• Qui non si conferma che il dispositivo sia stato testato internamente con Home Assistant: considera le sezioni seguenti una spiegazione del funzionamento strutturale dell'integrazione, non una garanzia di compatibilità per questo specifico modello.

Come si integra questa valvola in una configurazione Home Assistant

Il dispositivo si connette all'app Smart Life tramite Wi-Fi a 2,4G o 5G, un dettaglio più importante di quanto possa sembrare. Smart Life è l'app consumer di Tuya, e l'etichetta «Powered by Tuya» determina se un dispositivo può essere integrato o meno nell'integrazione ufficiale Tuya di Home Assistant. Home Assistant non si collega a questa valvola come prodotto specifico: si collega all'account Tuya o Smart Life a cui è stata aggiunta, quindi legge i dispositivi e le funzionalità che l'account rende disponibili.

È per questo che la compatibilità a livello di account e quella a livello di funzionalità sono due questioni distinte. La prima è quasi certa: un dispositivo basato su Tuya aggiunto a Smart Life è proprio il tipo di dispositivo per cui è stata progettata l'integrazione. La seconda dipende dai tipi di piattaforme di entità supportati al momento dall'integrazione Tuya di Home Assistant: copre la maggior parte dei tipi di dispositivi, inclusi interruttori e valvole, ma esclude esplicitamente alcune piattaforme, come serrature e telecomandi. Per sapere se le letture specifiche di questa valvola (portata, temperatura, cronologia dei consumi) saranno disponibili come entità sensore o se sarà disponibile solo il controllo di apertura e chiusura, bisogna collegare l'account e verificare: non basta leggere la pagina del prodotto.

Due modi per integrare una valvola basata su Tuya in Home Assistant

Una volta appurato che il dispositivo è basato su Tuya, ci sono due modi strutturalmente diversi per integrarlo in Home Assistant, con un compromesso tra praticità e controllo.

L'integrazione ufficiale Tuya basata sul cloud

L'integrazione Tuya integrata in Home Assistant si configura direttamente da Home Assistant: si accede con il proprio account Tuya Smart o Smart Life, a cui è già stata aggiunta la valvola, quindi si scansiona un codice QR utilizzando un User Code generato nell'app. Da quel momento, Home Assistant può vedere i dispositivi collegati e le relative entità supportate. Il compromesso riguarda il funzionamento quotidiano: questa integrazione è classificata come «Cloud Push», il che significa che i comandi e gli aggiornamenti di stato passano normalmente dai server cloud di Tuya anziché restare sulla rete domestica. Se la connessione Internet cade, cade anche il collegamento con il cloud, benché la valvola si trovi a pochi metri dal router.

Integrazioni locali della community e relativi limiti

Un progetto separato, mantenuto dalla community e chiamato tuya-local, adotta un approccio diverso: comunica direttamente sulla rete locale con i dispositivi dotati di firmware Tuya supportati, utilizzando una chiave locale specifica per ciascun dispositivo. In questo modo, il controllo quotidiano continua a funzionare anche senza connessione Internet. È un progetto non ufficiale, mantenuto al di fuori del progetto principale di Home Assistant, e la sua documentazione chiarisce esplicitamente che utilizzarlo non impedisce al dispositivo di inviare comunque informazioni al cloud di Tuya in background: i due percorsi coesistono, non si sostituiscono.

Il punto è che i progetti esclusivamente locali pubblicano elenchi dei dispositivi supportati, basati su prodotti specifici testati, e le differenze di firmware tra unità dello stesso modello possono influire sul riconoscimento di una determinata unità. Occorre quindi verificare il singolo dispositivo nell'elenco aggiornato: non lo si può dedurre dal nome o dalla categoria del prodotto. È proprio il tipo di verifica che in questo caso non è stato effettuato per questa valvola.

Come funziona davvero un'automazione che collega una perdita alla valvola

Quando le entità di un dispositivo sono visibili in Home Assistant, un'automazione che reagisce a esse segue la struttura di base comune a tutte le automazioni di Home Assistant: un trigger, una condizione facoltativa e un'azione che richiama un servizio su un'entità già nota a Home Assistant. In caso di perdita, il trigger è in genere un sensore che cambia stato — per esempio, un sensore di perdite che si attiva oppure una lettura del flusso che supera una soglia definita — e l'azione richiama un servizio sull'entità della valvola.

Il tipo di entità valvola di Home Assistant è un dominio definito, con stati propri — aperta, chiusa, in apertura, in chiusura, arrestata, non disponibile e sconosciuta — e azioni supportate, tra cui aprire, chiudere, arrestare e impostare la posizione, oltre all'attivazione/disattivazione. Ciò significa che una condizione può attendere che la valvola raggiunga effettivamente lo stato di chiusura prima di procedere, anziché dare per scontato che il comando di chiusura sia stato eseguito. Uno schema realistico abbina l'azione di chiusura a un'azione separata di notifica nella stessa automazione, così la chiusura della valvola e l'avviso alla famiglia vengono attivati dallo stesso trigger, invece di lasciare che la valvola comunichi qualcosa da sola. Un'entità valvola, infatti, non può inviare autonomamente una notifica push o una telefonata; queste funzioni sono già gestite dall'app e dal sistema di avvisi del produttore, indipendentemente da ciò che fa Home Assistant.

La questione della sicurezza in caso di guasto da considerare prima di affidarsi a un'automazione

In generale, nell'ingegneria delle valvole, la posizione «fail-safe» è quella in cui una valvola motorizzata è progettata per portarsi o rimanere quando perde l'alimentazione o il segnale di controllo: aperta, chiusa o semplicemente nella posizione in cui si trovava. Quale sia la posizione più sicura dipende interamente dal sistema: per l'impianto idrico di tutta la casa, la maggior parte delle persone presumerebbe che «chiusa» sia l'impostazione più sicura, ma questa ipotesi va comunque verificata per il prodotto in questione, non dedotta da ciò che sembra intuitivo.

Per questo dispositivo, il produttore documenta una batteria ricaricabile di riserva che mantiene in funzione l'unità durante un'interruzione di corrente: un'informazione utile e una caratteristica progettuale concreta. Non è invece specificato in quale posizione si trovi la valvola se l'interruzione dura abbastanza a lungo da esaurire sia l'alimentazione di rete sia la batteria. Questa lacuna diventa ancora più importante quando si aggiunge un'automazione di Home Assistant, perché un'automazione che presume che «la valvola si chiuderà da sola» durante un'interruzione prolungata dà per scontato qualcosa che la documentazione non conferma. Quando si sceglie una valvola per un impianto idrico che serve tutta la casa, con conseguenze così rilevanti, è ragionevole chiedere direttamente al produttore anziché fare supposizioni.

Cosa verificare prima di basare il sistema su questa valvola

Nessuno degli aspetti tecnici descritti sopra equivale a una conferma di compatibilità per questo specifico prodotto: spiegano in generale come funziona il percorso da Tuya a Home Assistant, prendendo in esame questa valvola. Prima di costruirci attorno un'automazione, vale la pena procedere con alcune verifiche:

• Collega l'account Smart Life nell'integrazione Tuya di Home Assistant e verifica che il dispositivo compaia effettivamente come entità valvola o interruttore, perché non è garantito che tutte le funzioni mostrate nell'app siano disponibili tramite l'integrazione.
• Se per te è importante il controllo locale — per esempio, perché vuoi che la valvola continui a rispondere durante un'interruzione di Internet — controlla l'elenco aggiornato dei dispositivi supportati da tuya-local per questo specifico prodotto e versione del firmware, prima di presumere che sia compatibile.
• Considera la valvola di chiusura manuale dell'impianto domestico e gli avvisi dell'app del dispositivo (notifica push, SMS, telefonata) come misure di sicurezza primarie; considera ogni automazione di Home Assistant una comodità aggiuntiva, non un sostituto.

Se non hai ancora installato la valvola, vale la pena preparare prima il necessario: le istruzioni di installazione e l'elenco degli attrezzi per questa valvola di chiusura sono disponibili a parte, così potrai occuparti delle automazioni solo dopo aver installato il dispositivo sulla tubazione. Se per la tua casa è più adatto Alexa o Google Home rispetto a un sistema basato su hub, la configurazione di questa valvola con Alexa e Google Home illustra direttamente queste integrazioni. Se durante la configurazione il dispositivo o l'app risultano offline, le soluzioni ai problemi Wi-Fi di un dispositivo Smart Life che risulta offline di solito risolvono il problema. Ti consigliamo di salvare la pagina tra i preferiti, perché un'automazione basata sul cloud dipende dal mantenimento della connessione.

Per capire innanzitutto come funzionano insieme il sensore e la valvola di chiusura, prima ancora di coinvolgere una piattaforma per la casa intelligente, come funzionano i rilevatori intelligenti di perdite d'acqua e le valvole di chiusura automatiche spiega il funzionamento del rilevamento e della chiusura in modo indipendente.

In breve: questa valvola dispone di un percorso documentato per integrarsi con Home Assistant tramite l'integrazione ufficiale Tuya e di un possibile secondo percorso tramite un'integrazione locale della community, se l'unità specifica compare nel relativo elenco dei dispositivi supportati. Nessuno dei due percorsi è ancora stato verificato internamente per questo prodotto. Il punto di partenza più corretto è quindi controllare il collegamento del proprio account e l'elenco delle entità, per poi decidere quanto affidare a un'automazione nel piano di risposta alle perdite.