Corte automático da água com o Home Assistant: opções de integração e automatizações

Este detetor de fugas e válvula de corte é controlado através da aplicação Smart Life, que funciona na plataforma da Tuya, e os dispositivos Tuya são precisamente aquilo que a integração oficial da Tuya no Home Assistant foi concebida para reconhecer. Isto significa que existe um caminho documentado para integrar esta categoria de dispositivos no Home Assistant: associe a mesma conta Smart Life e o Home Assistant poderá detetar os dispositivos associados. O que não está documentado é se todas as funcionalidades disponibilizadas por esta válvula na aplicação — monitorização do caudal, alertas e a própria ação de corte — aparecem como entidades utilizáveis depois de estabelecida a ligação, nem se uma alternativa exclusivamente local é compatível com este produto e firmware específicos. Vale a pena confirmar ambos os aspetos antes de planear uma automatização com base nesta válvula.

• A válvula integra-se no Home Assistant através do mesmo mecanismo «Powered by Tuya» utilizado por outros dispositivos Smart Life, e não através de um complemento específico para o dispositivo; por isso, a ligação à conta é mais importante do que o produto individual.
• A integração oficial da Tuya no Home Assistant funciona através da nuvem da Tuya, enquanto um projeto comunitário separado, chamado tuya-local, controla diretamente os dispositivos compatíveis na rede doméstica — e os dois métodos têm requisitos e limitações diferentes.
• Uma automatização de deteção de fugas e corte da válvula no Home Assistant é composta por um acionador, uma condição opcional e uma ação, e o tipo de entidade válvula aceita comandos para abrir, fechar, parar e definir a posição.
• O fabricante documenta uma bateria recarregável de reserva para falhas de energia, mas não indica a posição em que a válvula fica se a alimentação da rede elétrica e essa bateria se esgotarem. Este aspeto é importante quando se adiciona uma automatização.
• Nada do que é apresentado aqui confirma que este dispositivo tenha sido testado internamente com o Home Assistant; considere as secções seguintes uma explicação do funcionamento estrutural da integração, e não uma garantia de compatibilidade com esta unidade específica.

Como Esta Válvula se Integra numa Configuração do Home Assistant

O dispositivo emparelha com a aplicação Smart Life através de Wi-Fi de 2,4G ou 5G, um pormenor mais importante do que parece. A Smart Life é a aplicação de consumo da Tuya, e o rótulo «Powered by Tuya» determina se um dispositivo pode ou não ser integrado na integração oficial da Tuya no Home Assistant. O Home Assistant não estabelece ligação à válvula pelo nome do produto; liga-se à conta Tuya ou Smart Life à qual a válvula foi adicionada e, depois, deteta os dispositivos e as funcionalidades disponibilizados por essa conta.

É por isso que a compatibilidade ao nível da conta e a compatibilidade ao nível das funcionalidades são duas questões distintas. A primeira é quase certa: um dispositivo baseado na Tuya, adicionado à Smart Life, é o tipo de dispositivo para o qual a integração foi concebida. A segunda depende das plataformas de entidades atualmente suportadas pela integração da Tuya no Home Assistant — esta abrange a maioria dos tipos de dispositivos, incluindo interruptores e válvulas, mas exclui explicitamente algumas plataformas, como fechaduras e comandos remotos. Só é possível confirmar se as leituras específicas desta válvula (caudal, temperatura, histórico de utilização) são disponibilizadas como entidades de sensor ou se apenas o controlo de abertura e fecho fica disponível ligando a conta e verificando, e não lendo a página do produto.

Duas Formas de Integrar uma Válvula Baseada na Tuya no Home Assistant

Depois de confirmar que o dispositivo é baseado na Tuya, há duas formas estruturalmente diferentes de o integrar no Home Assistant, com diferentes compromissos entre conveniência e controlo.

A integração oficial da Tuya baseada na nuvem

A integração da Tuya incluída no Home Assistant é configurada no próprio Home Assistant: inicia sessão com a conta Tuya Smart ou Smart Life à qual a válvula já foi adicionada e, em seguida, lê um código QR utilizando um código de utilizador gerado na aplicação. A partir daí, o Home Assistant pode detetar os dispositivos associados e as respetivas entidades suportadas. O compromisso está na forma como funciona no dia a dia: esta integração é classificada como «Cloud Push», o que significa que os comandos e as atualizações de estado passam normalmente pelos servidores na nuvem da Tuya, em vez de permanecerem na rede doméstica. Se a ligação à Internet cair, a comunicação através da nuvem também deixa de funcionar, apesar de a válvula estar a poucos metros do router.

Integrações locais comunitárias e as respetivas limitações

Um projeto separado, mantido pela comunidade e chamado tuya-local, adota uma abordagem diferente: comunica diretamente com dispositivos compatíveis com firmware Tuya na rede local, utilizando uma chave local específica para cada dispositivo, para que o controlo diário continue a funcionar sem ligação à Internet. É uma solução não oficial, mantida fora do projeto principal do Home Assistant, e a respetiva documentação esclarece que a sua utilização não impede o dispositivo de continuar a comunicar com a nuvem da Tuya em segundo plano — os dois métodos coexistem, em vez de se substituírem.

A ressalva é que os projetos exclusivamente locais publicam as suas próprias listas de dispositivos compatíveis, criadas e testadas com produtos específicos, e as diferenças de firmware entre unidades do mesmo modelo podem alterar o reconhecimento de uma determinada unidade. É necessário verificar o dispositivo na lista atual; não se pode presumir a compatibilidade com base no nome ou na categoria do produto. E é precisamente esse tipo de verificação que ainda não foi feito para esta válvula.

Como se Constrói uma Automatização de Deteção de Fugas e Corte da Válvula

Quando as entidades de um dispositivo ficam visíveis no Home Assistant, uma automatização que responda a essas entidades segue a estrutura básica comum a todas as automatizações do Home Assistant: um acionador, uma condição opcional e uma ação que chama um serviço numa entidade já reconhecida pelo Home Assistant. Num cenário de fuga de água, o acionador é normalmente uma alteração de estado de um sensor — um sensor de fugas que se ativa ou uma leitura de caudal que ultrapassa um limite definido por si — e a ação chama um serviço na entidade da válvula.

O tipo de entidade válvula do Home Assistant é um domínio definido, com os seus próprios estados — aberta, fechada, a abrir, a fechar, parada, indisponível e desconhecida — e as suas próprias ações suportadas, incluindo abrir, fechar, parar e definir a posição, além de alternar o estado. Isto significa que uma condição pode aguardar que a válvula chegue efetivamente ao estado fechado antes de fazer qualquer outra coisa, em vez de presumir que o comando de fecho funcionou. Um padrão realista associa a ação de corte a uma ação de notificação separada na mesma automatização, para que o fecho da válvula e o alerta à família resultem de um único acionador, em vez de deixar a válvula comunicar algo por si própria — porque uma entidade válvula não consegue enviar uma notificação push nem fazer uma chamada telefónica por conta própria; isso já é feito através da aplicação e do sistema de alertas do fabricante, independentemente do que o Home Assistant faça.

A Questão da Segurança em Caso de Falha a Considerar Antes de Confiar numa Automatização

Em termos gerais, na engenharia de válvulas, a posição «segura em caso de falha» é o estado para o qual uma válvula motorizada foi concebida para se deslocar — ou que deve manter — quando perde a alimentação ou o sinal de controlo: aberta, fechada ou simplesmente na posição em que se encontrava. Qual delas é considerada segura depende inteiramente do sistema: no caso do abastecimento de água de toda a casa, a maioria das pessoas presumiria que «fechada» é a opção predefinida mais segura, mas essa suposição deve ser confirmada para o produto concreto, em vez de ser inferida com base no que parece intuitivo.

Para este dispositivo, o fabricante documenta uma bateria recarregável de reserva que mantém a unidade em funcionamento durante uma falha de energia — uma informação útil e uma característica de conceção real. O que não é divulgado é a posição predefinida da válvula se a falha durar o suficiente para esgotar tanto a alimentação da rede elétrica como essa bateria. Essa lacuna torna-se ainda mais importante quando se adiciona uma automatização do Home Assistant ao dispositivo, porque uma automatização que presuma que «a válvula se fechará sozinha» durante uma falha prolongada está a presumir algo que a documentação não confirma. Quando se planeia utilizar uma válvula num sistema tão importante como o abastecimento de água de toda a casa, é razoável perguntar diretamente ao fabricante, em vez de adivinhar.

O Que Confirmar Antes de Basear uma Configuração Nesta Válvula

Nenhum dos aspetos acima constitui uma declaração de compatibilidade confirmada para este produto específico — descrevem o funcionamento geral da integração entre a Tuya e o Home Assistant, tendo esta válvula como dispositivo em questão. Antes de criar uma automatização com base nela, vale a pena fazer algumas verificações, por esta ordem:

• Ligue a conta Smart Life à integração da Tuya no Home Assistant e confirme se o dispositivo aparece como entidade de válvula ou interruptor, uma vez que não é garantido que todas as funcionalidades apresentadas na aplicação sejam disponibilizadas através da integração.
• Se o controlo exclusivamente local for importante para si — por exemplo, porque quer que a válvula continue a responder durante uma falha de ligação à Internet — consulte a lista atual de dispositivos compatíveis do tuya-local para verificar se inclui este produto e a versão específica do firmware, antes de presumir que são compatíveis.
• Mantenha a válvula de corte manual da casa e os alertas da própria aplicação do dispositivo (notificação push, SMS, chamada telefónica) como camada de segurança principal, e considere qualquer automatização do Home Assistant uma conveniência adicional, não um substituto.

Se ainda não instalou a válvula, vale a pena começar por preparar tudo: os passos de instalação e a lista de ferramentas para esta válvula de corte são apresentados à parte, antes de planear automatizações para um dispositivo que ainda não está instalado na tubagem. Se a Alexa ou o Google Home forem mais adequados à sua casa do que uma configuração baseada num hub, a configuração desta válvula com a Alexa e o Google Home aborda diretamente essas integrações. E se o dispositivo ou a aplicação aparecer como estando offline durante a configuração, as soluções para o problema de um dispositivo Smart Life aparecer como offline na rede Wi-Fi costumam resolver a situação — vale a pena guardar esta página, uma vez que uma automatização baseada na nuvem depende de a ligação se manter ativa.

Para compreender como o sensor e a válvula de corte funcionam em conjunto, antes mesmo de entrar em cena qualquer plataforma de casa inteligente, como funcionam os detetores inteligentes de fugas de água e as válvulas de corte automático explica o funcionamento da deteção e do corte por si só.

Em resumo: esta válvula tem uma via real e documentada para se integrar no Home Assistant através da integração oficial da Tuya, e uma possível segunda via através de uma integração local comunitária, se a unidade específica constar da lista de dispositivos compatíveis. Ainda não foi possível confirmar internamente a compatibilidade de nenhuma das duas vias com este produto; por isso, o mais sensato é começar por verificar a ligação à sua conta e a lista de entidades e, em seguida, decidir em que medida quer confiar numa automatização para gerir a resposta a uma fuga de água.