> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unicontrol.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Gree

> Controle ar-condicionado Gree (e OEMs compatíveis) pelo Portal

# 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

<Steps>
  <Step title="Adicione a integração">
    Vá em **Configurações → Integrações → Adicionar → Gree Ar-Condicionado**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Pronto">
    O Portal faz o *scan* e o *bind* automaticamente (negociando a chave de
    criptografia do aparelho) e cria uma entidade `climate`.
  </Step>
</Steps>

## 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.