ZoomDH – Tuya AC Wi-Fi Gateway v20261027

Visão geral

Integra ao Control4 os ar-condicionados com módulo Wi-Fi Tuya, os que são configurados nos apps Smart Life ou Tuya Smart. O controle é feito direto pela rede local. A conta Smart Life é usada só para trazer a lista de aparelhos e a chave de acesso de cada um. Cada aparelho ganha um termostato ZoomDH – Universal Thermostat, criado e configurado automaticamente.

• Controle local: comandos e leitura de estado vão direto do controlador para o ar-condicionado. Depois da configuração, continua funcionando sem internet e mesmo com a conta desconectada.
• Login na conta Smart Life por QR code, sem digitar senha.
• Encontra os ar-condicionados na rede e cria, liga e nomeia os termostatos, com os nomes do app.
• Termostato no Navigator: ligar/desligar, modos, velocidades, setpoint, temperatura ambiente e direção do vento. Cada termostato mostra só o que o modelo tem.
• Interface WebView no Navigator com os recursos que o termostato não tem: Eco, Turbo, Silencioso, Sono, display, ionizador e umidade, nos modelos que têm.
• Mudanças feitas pelo controle remoto ou pelo app aparecem no Control4 na hora.
• Interface e página de configuração em português e inglês.

Pré-requisitos

• Ar-condicionados já configurados no app Smart Life ou Tuya Smart e conectados ao Wi-Fi do cliente.
• Marcas compatíveis: qualquer marca cujo módulo Wi-Fi seja Tuya. Regra prática: se o aparelho pareia no app Smart Life, ele funciona com este driver. Se a marca tem app próprio feito sobre a Tuya, adicione o aparelho também no Smart Life.
• Acesso à conta Smart Life do cliente (o app no celular, para ler o QR) na primeira configuração.
• Ar-condicionados e controlador na mesma rede. Recomenda-se reservar o IP de cada aparelho no roteador.
• Controlador com acesso à internet na primeira configuração (e quando um aparelho for reconfigurado no app).
• Driver ZoomDH_Universal_Thermostat.c4z instalado no Composer (ele é adicionado ao projeto pelo gateway).
• Chave de licença ZoomDH (sem chave, o driver funciona em teste por 30 dias).

Instalação

1. Adicione o driver ZoomDH – Tuya AC Wi-Fi Gateway ao projeto, no cômodo onde os termostatos devem ser criados.
2. Abra o endereço de Setup Page URL num navegador na rede do cliente e conecte a conta Smart Life (veja Conta Smart Life).
3. Assim que a conta conecta, o driver traz os ar-condicionados da conta e procura cada um na rede (leva cerca de 15 segundos).
4. Para cada ar-condicionado, o gateway cria um Universal Thermostat, liga à conexão HVAC Thermostats e escolhe o aparelho.
5. Para trocar os nomes, use Renomear na página de configuração.
6. Para adicionar um termostato à mão: adicione o Universal Thermostat, ligue a conexão HVAC Gateway dele à HVAC Thermostats do gateway e escolha o aparelho na propriedade Device.
7. Atualize os Navigators para ver os termostatos e a interface WebView.

Se algum aparelho não for encontrado na rede, o Status mostra quais ficaram sem IP. Informe o IP deles em Device IP Addresses; o driver procura de novo sozinho.

Conta Smart Life

1. No app Smart Life (ou Tuya Smart) do cliente, abra Eu › engrenagem (Configurações) › Conta e segurança e copie o User Code.
2. Na página de configuração, cole o User Code e toque em Gerar QR para entrar.
3. No app, toque no leitor (canto superior direito da tela inicial), leia o QR e confirme o acesso. A página mostra Conectada em alguns segundos.

• O QR vale por alguns minutos. Se expirar, gere outro.
• Depois de conectada, a conta só é usada para buscar aparelhos novos e a chave de um aparelho reconfigurado no app.
• Para trocar de conta, use Desconectar a conta na página ou a ação Disconnect Tuya Account. Os aparelhos já configurados continuam funcionando.

Interface WebView

O driver aparece no Navigator como um botão que abre a interface dos ar-condicionados: uma aba por aparelho, dial de setpoint, modos, velocidade, Normal/Eco/Turbo/Silencioso/Sono, display, ionizador, temperatura ambiente e umidade. Cada aparelho mostra só o que o modelo tem. A cor acompanha o modo. No menu ⋯ ficam a direção do vento e o idioma. A interface abre também fora de casa, pelo app do Control4.

• O idioma padrão vem da propriedade Language. No menu ⋯ da interface dá para trocar, e a escolha fica salva naquele aparelho.
• Eco, Turbo e os outros recursos só têm efeito nos modos em que o próprio ar-condicionado aceita.

Ar-condicionados por ambiente

Quando o mesmo driver aparece em vários ambientes do Navigator, dá para escolher, para cada ambiente, quais ar-condicionados aparecem na interface e qual abre primeiro. Isso fica na página de configuração, no quadro Ambientes da interface.

• Um ambiente entra no quadro sozinho na primeira vez que a interface é aberta nele. Também dá para adicionar pela lista de ambientes do projeto.
• Marque os ar-condicionados que devem aparecer e escolha o padrão. Ambiente sem configuração mostra todos.

Propriedades

Ações

Conexões

Solução de problemas

• O QR não aparece ou dá erro de User Code: confira o User Code no app (Eu › Configurações › Conta e segurança) e se o controlador tem internet.
• Conta conectada mas nenhum ar-condicionado: o aparelho precisa estar na conta que leu o QR. Se ele está em outro app da marca, adicione-o no Smart Life.
• Aparelho sem IP: confira se ele está na mesma rede do controlador. Se estiver em outra rede, informe o IP em Device IP Addresses.
• Aparelho parou de responder depois de reconfigurado no app: a chave de acesso muda quando o aparelho é pareado de novo. Com a conta conectada, o driver busca a chave nova sozinho; sem a conta, conecte de novo e rode Discover Devices.
• Aparelho offline depois de funcionar: o IP pode ter mudado. O driver procura de novo sozinho; para evitar, reserve o IP no roteador.
• Algum recurso do app não aparece: o driver mostra os recursos que o modelo informa à conta. Recursos fora do padrão Tuya podem não aparecer.
• Comandos ignorados e aviso de licença na interface: o período de teste acabou ou a chave é inválida. Confira License Key e License Status.
• WebView carregando no app: rode Resend Web URL e feche e abra o app.

Licenciamento

• Licença ZoomDH por controlador, informada em License Key. Sem chave, o driver funciona em teste por 30 dias.

• Os Universal Thermostat não têm licença própria: usam a do gateway.

Suporte e Atualizações

• Site: www.zoomdigitalhome.com.br
• Suporte: drivers@zoomdigitalhome.com.br

Release Notes