Domesticando o Zoo da Tuya e Esquecendo as Nuvens Chinesas

Vamos dizer que você comprou um aquecedor inteligente, uma lâmpada ou um sensor de vazamento de água. A caixa exibe orgulhosamente o logo Tuya ou SmartLife. Você conecta o dispositivo, instala o app, e tudo parece funcionar. Mas no momento em que a internet falha ou os servidores da China começam a passar por problemas, sua casa "inteligente" vira uma abóbora. História familiar?

Muitos de nós chegamos ao Home Assistant justamente para arrancar o controle de nossas casas das garras dos serviços em nuvem. Mas a Tuya sempre teve um porém: a integração oficial funciona através da API deles, que é paga, tem um período de teste limitado, ou simplesmente é lenta. O projeto tuya-local resolve esse problema radicalmente — ele faz os dispositivos se comunicarem com seu servidor diretamente pela rede local.

Qual é o Objetivo Deste Projeto

Resumindo: é um componente personalizado para o Home Assistant que permite controlar dispositivos Tuya via Wi-Fi sem intermediários.

O principal destaque aqui não é apenas a velocidade (embora a resposta realmente se torne quase instantânea). O valor central é que a integração pode "extrair" funcionalidades que a nuvem oficial não mostra de jeito nenhum. Por exemplo, modos específicos de operação de equipamentos de climatização ou estatísticas detalhadas de consumo de energia que os chineses decidiram esconder no app mas não expuseram através da API.

Aliás, o projeto suporta mais do que apenas dispositivos Wi-Fi. Se você tem um gateway Tuya, pode conectar periféricos Zigbee através dele, embora o autor alerte honestamente: as capacidades do hub para conexões locais simultâneas são severamente limitadas.

O Que o tuya-local Pode Fazer

O repositório alega suporte para mais de mil dispositivos. Não é apenas "ligar/desligar" — é operação completa com entidades complexas.

1. Climatização e aquecimento. Convectores inteligentes, ar-condicionados e umidificadores funcionam com todos os seus sensores e presets.
2. Iluminação. Suporte para diferentes protocolos (de 3.1 a 3.5) permite fazer até lâmpadas exigentes funcionarem localmente que antes se recusavam a cooperar.
3. Segurança. Há suporte para alguns modelos de fechaduras. Implementa um esquema inteligente para interceptar chaves de desbloqueio, o que é geralmente raro para integrações open-source.
4. Eletrodomésticos. De comedouros para pets (com suporte a agendamento de alimentação) a controles IR que podem aprender comandos direto da interface do Home Assistant.

Como Colocar Isso Para Funcionar Sem Arrebentar

Antes, configurar Tuya local era parecido com um ritual de invocação de demônios: você precisava criar uma conta de desenvolvedor, extrair local_key através do console, e sofrer. No tuya-local, o processo foi significativamente simplificado.

A integração tem dois caminhos de configuração. O primeiro é o "assistente de nuvem". Você faz login com sua conta SmartLife uma vez, a integração busca a lista de dispositivos e suas chaves secretas automaticamente, e então trabalha com eles localmente apenas. Isso te poupa de ter que renovar o período de teste a cada seis meses no portal Tuya IoT.

O segundo caminho é manual. Se você é um paranoico raiz que já obteve todos os IDs e chaves por conta própria, basta digitá-los no cartão do dispositivo.

Pecadilhos e Armadilhas

Há nuances, é claro. Tuya não é um único padrão — é mais um mosaico de diferentes versões de firmware.

Primeiro, muitos dispositivos suportam apenas uma conexão local ativa. Se você tiver o app aberto no celular ou outra integração rodando (por exemplo, a antiga localtuya), a nova simplesmente não conseguirá alcançar o hardware.

Segundo, dispositivos alimentados por bateria (sensores de porta ou fumaça) não funcionam localmente sem um hub. Eles dormem para economizar energia e só acordam para "pingar" dados para a nuvem. Você não pode enganar a física aqui — para esses, é melhor usar versões Zigbee com um stick adequado.

Terceiro, alguns hardwares começam a se comportar de forma estranha se você bloquear completamente o acesso à internet no roteador. Eles podem acabar em um loop infinito de reinicialização. O autor recomenda bloquear não apenas TCP mas também requisições DNS do dispositivo nesses casos.

Por Que Isso Supera as Alternativas

Há uma alternativa popular — localtuya. Eu testei ambas. localtuya é mais flexível quando se trata de configurar manualmente cada ponto de dados específico (DP), mas isso também é sua queda: configurar um termostato complexo vira uma hora de fuçar com tabelas.

tuya-local segue o caminho das configurações prontas. Se seu dispositivo está na lista de suportados, você apenas seleciona o tipo dele, e todos os sensores/botões aparecem por conta própria. Isso economiza um tempão. Se seu dispositivo não é suportado, você pode ajudar o projeto enviando logs com um dump de dados — a comunidade lá é muito ativa.

Se sua casa está gradualmente sendo tomada por dispositivos Tuya, instalar essa integração é obrigatório. Se fosse apenas pelo fato de que as luzes acendem instantaneamente, em vez de um segundo depois do sinal fazer uma viagem de ida e volta até Frankfurt ou Xangai.

O projeto é maduro, com um banco de dados sólido de dispositivos e lógica de configuração sensata. Sim, Tuya ainda é um "zoo", mas com essa ferramenta em mãos, você pelo menos ganha um chicote adequado e um saco de petiscos de treinamento.

Vale a pena experimentar se:

• Você está cansado de atrasos da API em nuvem.
• Você tem um dispositivo Tuya específico que não porta bem para o HA usando métodos padrão.
• Você quer automações que funcionem mesmo quando seu ISP cair.

Você pode encontrar o projeto no HACS pelo nome ou diretamente no GitHub: make-all/tuya-local.