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

# Midea CCM15

> Controle centrais de ar-condicionado Midea CCM15 pelo Portal

# Midea CCM15

Controla centrais de ar-condicionado gerenciadas por um **gateway Midea CCM15**
(e OEMs compatíveis que usam o mesmo módulo) pela rede local. A comunicação é
feita por **HTTP simples** com a central, sem depender da nuvem do fabricante.

Uma única central CCM15 pode gerenciar dezenas de evaporadoras: o Portal cria
**uma entidade `climate` para cada unidade** reportada pela central.

Suporta ligar/desligar, modos HVAC (refrigerar, aquecer, secar, ventilar, auto),
temperatura alvo e velocidade do ventilador.

## Pré-requisitos

* A central CCM15 precisa estar **conectada à rede** da casa com um IP acessível.
* Recomenda-se **reservar o IP** do gateway 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 → Midea CCM15**.
  </Step>

  <Step title="Informe o IP">
    Digite o IP local do gateway (ex: `192.168.1.100`). A porta padrão é `80` e
    normalmente não precisa ser alterada.
  </Step>

  <Step title="Pronto">
    O Portal consulta a central e cria uma entidade `climate` para cada
    evaporadora encontrada.
  </Step>
</Steps>

## Funcionalidades

* **Ligar/desligar** (`climate.turn_on` / `climate.turn_off`) — ligar assume o
  modo `auto`.
* **Modo HVAC** (`climate.set_hvac_mode`): `off`, `cool`, `heat`, `dry`,
  `fan_only`, `auto`
* **Temperatura alvo** (`climate.set_temperature`): 16 °C a 31 °C, passo de 1°
* **Velocidade do ventilador** (`climate.set_fan_mode`): `auto`, `low`,
  `medium`, `high`
* **Temperatura ambiente** — exibida quando a unidade reporta o sensor interno.
* **Código de erro** — exposto no atributo `error_code` quando a unidade reporta
  uma falha.

O estado é atualizado por *polling* a cada **30 segundos**; comandos aplicam uma
atualização otimista imediata na interface.

<Note>
  O protocolo de controle da CCM15 (`ctrl.xml`) reescreve o estado completo da
  unidade a cada comando. Por isso, antes de enviar uma alteração o Portal lê o
  estado atual da unidade e mescla apenas o campo alterado — assim mudar só a
  temperatura não zera o modo/ventilador.
</Note>

## Solução de problemas

* **"Não foi possível conectar à central CCM15"**: confirme que o IP está
  correto, que o gateway está na rede e que o edge está na **mesma sub-rede**.
* **"Nenhuma unidade de ar-condicionado foi encontrada"**: a central respondeu,
  mas não reportou evaporadoras. Verifique o cabeamento/endereçamento das
  unidades no barramento da CCM15.
* **Central 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).