O que você vai precisar
Passo a passo
1. Confirme se o dispositivo vale o esforço
LocalTuya faz mais sentido em tomadas, relés, luzes e dispositivos simples. Equipamento complexo pode exigir DPS manual e tentativa cuidadosa.
Dica: Se o aparelho é crítico, teste local em paralelo antes de remover a integração oficial.2. Instale LocalTuya pelo HACS
Adicione o repositório, instale a integração e reinicie o Home Assistant. O repositório do LocalTuya descreve instalação manual e por custom_components, mas HACS reduz erro operacional.
Dica: Custom integration exige mais disciplina de atualização.3. Obtenha device ID e local key
A integração pode usar APIs Tuya IoT Cloud para recuperar local keys, embora a conta cloud não seja obrigatória para operar localmente. Ela é fortemente recomendada para facilitar chaves e atualizações após reparing.
Dica: Guarde chaves em local seguro. Se parear de novo, a chave pode mudar.4. Fixe IP e mapeie DPS
No roteador, reserve IP para cada dispositivo. Depois, configure cada entidade: switch, light, cover, fan ou sensor de energia, associando DPS certo a cada função.
Dica: Anote DPS ligado/desligado, brilho, potência e modo antes de criar automações.5. Teste sem internet antes de automatizar
Desconecte a internet por alguns minutos e veja se o controle local responde. Depois teste retorno de estado ao acionar fisicamente o dispositivo.
Dica: Controle local que não atualiza estado vira armadilha.
A luz Tuya acende mais rápido quando não precisa atravessar a nuvem. O efeito aparece antes da teoria: toque no painel, resposta quase imediata, menos atraso no Home Assistant.
Volto ao mesmo ponto em camadas. Primeiro vem a promessa: controle local. Depois vem a realidade: local key, DPS, IP, firmware, categoria e suporte parcial. O detalhe histórico é que Tuya se popularizou justamente por hardware barato e nuvem fácil; tirar a nuvem do caminho exige pagar com configuração.
1. Escolha o dispositivo certo#
Nem todo Tuya compensa#
Tomada e interruptor simples costumam ir bem. Ar-condicionado, robô e aparelho cheio de modo proprietário podem dar trabalho.
2. Instale a integração#
HACS reduz atrito#
LocalTuya é custom integration. Atualize com cuidado e mantenha backup.
3. Recupere a local key#
A chave é o coração#
Sem local key correta, não há controle local confiável.
4. Mapeie DPS#
Aqui mora o trabalho#
DPS errado transforma brilho em modo, potência em corrente e botão em nada.
5. Valide estado#
Controle não basta#
O dispositivo precisa responder e atualizar estado quando alguém aciona fisicamente.
Tuya local é ótimo quando funciona. Quando não funciona, geralmente faltou mapear o DPS certo.