ZoomDH – Gree AC Wi-Fi Gateway v20261027

Visão geral

Integra ao Control4 os ar-condicionados Gree com Wi-Fi (e as marcas com o mesmo módulo, como alguns modelos Agratto e Elgin, configuradas nos apps Gree+ ou EWPE Smart). O controle é feito direto pela rede local, sem nuvem. Cada aparelho ganha um termostato ZoomDH – Universal Thermostat, criado e configurado automaticamente.

• Controle 100% local: comandos e leitura de estado vão direto do controlador para o ar-condicionado pela rede. Não usa conta nem nuvem, e continua funcionando sem internet.
• Encontra os ar-condicionados na rede e cria, liga e nomeia os termostatos.
• Termostato no Navigator: ligar/desligar, modos Auto, Resfriar, Aquecer, Desumidificar e Ventilar, velocidade (Auto, Baixa, Média, Alta e Turbo), setpoint, temperatura ambiente e direção do vento.
• Interface WebView no Navigator com os recursos que o termostato não tem: Eco, Turbo, Silencioso, Sono, LED do display, X-Fan (secagem da serpentina) e umidade nos modelos que medem.
• Mudanças feitas pelo controle remoto ou pelo app aparecem no Control4 na leitura seguinte (padrão a cada 10 segundos).
• Interface e página de configuração em português e inglês.

Pré-requisitos

• Ar-condicionados já configurados no app da Gree (Gree+ ou EWPE Smart) e conectados ao Wi-Fi do cliente.
• Marcas compatíveis: Gree e as marcas que usam o mesmo módulo Wi-Fi da Gree, como alguns modelos Agratto e Elgin. Nessas marcas o módulo muda conforme o modelo, então confirme antes: se o aparelho pareia no app Gree+ ou EWPE Smart, ele funciona com este driver. Se ele usa outro app (por exemplo Smart Life), não é compatível.
• Ar-condicionados e controlador na mesma rede. Recomenda-se reservar o IP de cada aparelho no roteador.
• 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 – Gree AC Wi-Fi Gateway ao projeto, no cômodo onde os termostatos devem ser criados.
2. Na primeira vez o driver procura os aparelhos sozinho. Depois, use a ação Discover Devices para procurar de novo (leva cerca de 15 segundos).
3. Para cada ar-condicionado, o gateway cria um Universal Thermostat, liga à conexão HVAC Thermostats e escolhe o aparelho.
4. Para dar nomes aos aparelhos (por exemplo, "Ar Sala"), abra o endereço de Setup Page URL e use Renomear.
5. 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.
6. Atualize os Navigators para ver os termostatos e a interface WebView.

Se algum aparelho não for encontrado (por exemplo, numa rede diferente da do controlador), informe o IP dele em Device IP Addresses; o driver procura de novo sozinho.

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, LED do display, X-Fan, temperatura ambiente e umidade (nos modelos que medem). 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.
• Turbo, Eco e X-Fan só têm efeito nos modos em que o próprio ar-condicionado aceita (por exemplo, Eco e X-Fan em Resfriar).

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 (propriedade Setup Page URL), 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.
• Se o ambiente não for identificado (por exemplo, a interface aberta pelo endereço direto), aparecem todos os ar-condicionados.

Propriedades

Ações

Conexões

Solução de problemas

• Nenhum aparelho encontrado: confira se os aparelhos aparecem online no app da Gree e se estão na mesma rede do controlador. Se estiverem em outra rede, informe os IPs em Device IP Addresses.
• Aparelho encontrado mas sem resposta: desligue e ligue o ar-condicionado no disjuntor e rode Discover Devices. Se o aparelho foi reconfigurado no app, o driver refaz a ligação com ele sozinho.
• Aparelho offline depois de funcionar: o IP pode ter mudado. O driver procura de novo sozinho; para evitar, reserve o IP no roteador.
• Temperatura ambiente não aparece: alguns modelos não informam a temperatura ambiente pela rede.
• Termostato sem modos: aguarde a próxima leitura e confira se o termostato tem um aparelho escolhido em Device.
• 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