Skip to main content

​
Gree

Controla splits e ar-condicionados Gree — e uma longa lista de OEMs que usam o mesmo protocolo (Cooper&Hunter, Sinclair, Tosot, Kinghome, entre outros) — pela rede local. A comunicação é feita por UDP criptografado na porta 7000, sem depender da nuvem do fabricante nem do app Gree+. Suporta ligar/desligar, modos HVAC (auto, refrigerar, secar, ventilar, aquecer), temperatura alvo, velocidade do ventilador, oscilação e presets (eco, boost, dormir, ausente).

​
Pré-requisitos

  • O ar-condicionado precisa estar conectado ao Wi-Fi da casa (configure pelo app Gree+ uma única vez, ou pelo modo AP).
  • Recomenda-se reservar o IP do aparelho no DHCP do roteador — o Portal se conecta pelo IP informado.
  • A integração precisa rodar em um edge local. Crie um em Configurações → Edges antes de adicionar.

​
Configurar

1

Adicione a integração

Vá em Configurações → Integrações → Adicionar → Gree Ar-Condicionado.
2

Informe o IP

Digite o IP local do aparelho (ex: 192.168.0.50). A porta padrão é 7000 e normalmente não precisa ser alterada.
3

Pronto

O Portal faz o scan e o bind automaticamente (negociando a chave de criptografia do aparelho) e cria uma entidade climate.

​
Funcionalidades

  • Ligar/desligar (climate.turn_on / climate.turn_off)
  • Modo HVAC (climate.set_hvac_mode): off, auto, cool, dry, fan_only, heat
  • Temperatura alvo (climate.set_temperature): 16 °C a 30 °C, passo de 1°
  • Velocidade do ventilador (climate.set_fan_mode): auto, low, medium_low, medium, medium_high, high
  • Oscilação (climate.set_swing_mode): off, vertical, horizontal, both
  • Presets (climate.set_preset_mode): none, eco (economia), boost (turbo), sleep (dormir), away (aquecimento mínimo)
  • Temperatura ambiente — exibida quando o aparelho reporta o sensor interno (TemSen); modelos mais antigos podem não expor esse dado.
O estado é atualizado por polling a cada 60 segundos; comandos aplicam uma atualização otimista imediata na interface.

​
Compatibilidade de criptografia

O Portal detecta automaticamente o esquema de criptografia do aparelho:
  • V1 — firmware mais antigo, AES-128-ECB.
  • V2 — firmware mais novo, AES-128-GCM.
Nenhuma configuração manual é necessária.

​
Solução de problemas

  • “Não foi possível conectar ao dispositivo Gree”: confirme que o IP está correto, que o aparelho está no Wi-Fi e que o edge está na mesma sub-rede (o protocolo Gree não roteia entre VLANs sem broadcast/relay).
  • Aparelho some após trocar de rede/IP: como o pareamento é por IP, se o IP mudar remova e adicione a integração novamente (ou fixe o IP no roteador).
  • Sem leitura de temperatura ambiente: alguns modelos não possuem sensor interno reportável — apenas a temperatura alvo será exibida.