🚀 Xtend Tuya: como desbloquear TODOS os sensores ocultos dos teus dispositivos Tuya no Home Assistant
Já te aconteceu ligares um dispositivo Tuya ao Home Assistant e aparecer apenas uma entidade de estado genérica, ou quase só um sensor de temperatura, quando sabes que o aparelho mede muito mais? Não és o único. A integração oficial da Tuya é conhecida por ser algo limitada. Hoje mostro-te a solução definitiva: Xtend Tuya. Com este método, podes desbloquear sensores ocultos dos teus monitores de qualidade do ar, tomadas inteligentes com medição de consumo e muitos outros dispositivos Tuya e Smart Life dentro do Home Assistant.
No YouTube compartilho mais tutoriais, testes praticos e automacao residencial real. Inscrever-se no YouTube
Video relacionado no YouTube
Video❓ O problema: porque é que o Home Assistant não mostra todos os meus sensores Tuya?
A integração oficial da Tuya utiliza uma API que, por razões de eficiência ou desenho, nem sempre expõe todas as funções do dispositivo. Por exemplo, no medidor de CO2 do AliExpress que analisámos anteriormente, a integração oficial costuma ocultar os níveis de partículas PM2.5 ou o Formaldeído, mostrando apenas CO2 ou temperatura.
É aqui que entra o Xtend Tuya, um componente personalizado que força o Home Assistant a ler todos os pontos de dados disponíveis, ou DPs, expostos pelo dispositivo.
🛠️ Requisitos prévios
Antes de começares, confirma que tens:
- A integração oficial da Tuya já configurada no Home Assistant.
- HACS instalado no Home Assistant para facilitar o download de componentes personalizados.
📥 Como instalar o Xtend Tuya passo a passo
1. Instalação a partir do HACS
Procura no HACS o repositório Xtend Tuya. Se não aparecer, podes adicioná-lo manualmente usando o URL do projeto no GitHub: https://github.com/azerty9971/xtend_tuya. Depois de descarregado, reinicia o Home Assistant.
2. Configuração do componente
Vai a Definições > Dispositivos e serviços e adiciona a nova integração Xtend Tuya. É aqui que acontece a magia. O sistema vai pedir:
- As tuas credenciais da Tuya IoT Platform, as mesmas que usaste na integração oficial.
- Selecionar os dispositivos que queres estender.
3. O truque das credenciais
Para que o Xtend Tuya funcione a 100%, é recomendável usar o método de credenciais completas. Isto permite ao componente consultar diretamente os esquemas de dados do dispositivo na cloud da Tuya, desbloqueando entidades que nem sabias que existiam.
📊 Resultados: o que ganhamos realmente?
Se usarmos como exemplo o monitor de qualidade do ar do canal, a mudança é enorme:
- Antes, com a integração oficial: só víamos CO2 e temperatura.
- Depois, com Xtend Tuya: aparecem entidades para PM1.0, PM2.5, PM10, TVOC, HCHO e controlo do brilho do ecrã.
Isto não é apenas estético. Ao ter estas entidades disponíveis, podes criar automações avançadas como:
- "Se as partículas PM2.5 ultrapassarem 25 µg/m³, ligar o purificador de ar no máximo".
- "Se o nível de Formaldeído subir, enviar uma notificação crítica para o telemóvel".
🔌 Funciona com outros dispositivos?
Sim. O Xtend Tuya é uma verdadeira ferramenta suíça. É especialmente útil para:
- Extensões e tomadas inteligentes: para ver tensão, corrente e consumo atual se a integração oficial não os mostrar.
- Termóstatos: para aceder a definições de calibração ou modos especiais.
- Sensores de presença: para ajustar tempos de atraso ocultos.
Equipamento recomendado
Dispositivo usado neste projeto: Tuya 8 en 1 Air Quality Monitor. Se voce precisar dele, aqui esta onde encontra-lo:
- Tuya 8 en 1 Air Quality Monitor — Analisado no video: AliExpress
Conclusão técnica
Xtend Tuya é uma daquelas ferramentas indispensáveis para qualquer utilizador de Home Assistant que tenha dispositivos do ecossistema Tuya ou Smart Life. É a diferença entre ter um dispositivo apenas ligado e ter um dispositivo realmente sob o teu controlo.
Conseguiste desbloquear algum sensor interessante com este método? Conta-me nos comentários.
Se gostas de otimizar o Home Assistant ao máximo, subscreve a minha newsletter ou segue o meu canal para mais truques como este.
