Skip to main content

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

1

Adicione a integração

Vá em Configurações → Integrações → Adicionar → Midea CCM15.
2

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

Pronto

O Portal consulta a central e cria uma entidade climate para cada evaporadora encontrada.

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

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