Tuya no Home Assistant
tuya
parte do Home Assistant desde 0.74
A integração Tuya conecta Home Assistant a dispositivos via nuvem ou gateway, permitindo o controlo de equipamentos como sensores, câmeras, luzes e climatização. É usada para automação residencial e monitoramento remoto.
Utilização típica
- Controle de dispositivos inteligentes
- Monitoramento de segurança com câmeras e sensores
- Controle de clima e iluminação
- Automatização de tarefas domésticas
Factos sobre esta integração
- Compatível com o Home Assistant
- sim, integração oficial
- Ligação
- Nuvem, empurra – Funciona através da nuvem do fabricante; as atualizações chegam imediatamente, mas somente enquanto a ligação à Internet e o serviço estão ativos.
- Configurar
- na interface do utilizador
- Tipo
- Hub – vários dispositivos por meio de um gateway ou conta
- Instalações
- 167.555 (23,3 % das instalações que partilham estatísticas)
- Categorias
- Sensor binário, Câmera, Clima, Coberturas, Campainha, Evento, Ventilador, Humidificador, Luz, Número, Cena, Seleccionar, Sirene, Interruptor, Aspirador, Válvula
- Fornece
- Painel de controle de alarme, Sensor binário, Botão, Câmera, Clima, Coberturas, Diagnósticos, Evento, Ventilador, Humidificador, Luz, Número, Cena, Seleccionar, Sensor, Sirene, Interruptor, Aspirador, Válvula
- Encontrado automaticamente através de
- Descoberta de rede (DHCP)
- Mantido por
- @Tuya, @zlinoliver
- Pacotes Python
tuya-device-handlers==0.0.33, tuya-device-sharing-sdk==0.2.15
Configurar
- Home Assistant pode encontrar esta integração por conta própria: se for sugerido em Definições → Dispositivos e serviços, confirme-o lá.
- No Home Assistant abrir Definições → Dispositivos e serviços.
- Clique em "Adicionar integração" e procure por Tuya.
- Siga o diálogo – pede tudo o que a integração precisa.
Adicionar ao meu Home Assistant
O link passa por my.home-assistant.io e abre o diálogo de configuração em sua própria instância – nenhum endereço nosso está envolvido.
Problemas e correções conhecidos
No rastreador de problemas do Home Assistant estão registados para Tuya 68 problemas abertos e 33 correções de erros nos últimos doze meses. Se algo não funcionar, atualize primeiro: a correção mais recente incluída com Home Assistant 2026.10.0.
Abrir
- aberto A conexão com dispositivos Tuya pode ser perdida aleatoriamente com erro de autenticação
- aberto Erro de rede com código -9999999 e assinatura inválida ocorre frequentemente
- aberto Dispositivos Tuya aparecem como indisponíveis no Home Assistant
- aberto Dispositivos climáticos Tuya mostram temperatura alvo incorreta após atualização
- aberto Erro de rede -9999999 aparece com falha no API remoto
- aberto Controle de dispositivos Tuya fica instável após atualização
- aberto A integração Tuya entra em autenticação após o limite de API
- aberto Câmeras Tuya não são suportadas pela integração
Fixo
- fixado em 2026.10.0 Erros ao enviar comandos para dispositivos Tuya são notificados corretamente
- fixado em 2026.9.4 Ventiladores Tuya desligam corretamente quando a velocidade é definida como 0%
- fixado em 2026.9.0 Tradução do indicador de luz do Tuya foi adicionada
- fixado em 2026.9.0 Payloads do Tuya não são mais chamados de campainha
- fixado em 2026.6.4 Tradução de campo faltante no fluxo da integração Tuya foi corrigida
- fixado em 2026.4.3 Unidade kWh foi adicionada ao sensor de energia dlq ADD_ELE
- fixado em 2026.4.1 Unidades do sensor de energia Tuya foram corrigidas
- fixado em 2026.2.2 Status indisponível no Tuya foi corrigido
- fixado em 2026.2.1 Opção redundante 'off' no preset do clima Tuya foi removida
- fixado em 2026.1.0 Dados de cor da luz Tuya foram corrigidos
- fixado em 2025.12.3 Parse do BitmapTypeInformation no Tuya foi corrigido
- fixado em 2025.12.3 Tratamento do modo HVAC no Tuya foi melhorado
Fonte: o rastreador de problemas do Home Assistant, a partir de 25 de Outubro, 2026. As frases são escritas por um modelo de linguagem a partir dos títulos das questões; os próprios relatórios estão no GitHub.
Verifique um dispositivo específico para problemas conhecidos na verificação do produto →
Fonte desta entrada: documentação oficial da integração
A descrição foi escrita por um modelo de linguagem a partir dos fatos aqui listados, não retirado da documentação.