Broadlink (RM5 Plus) — Home Assistant custom component

Fork da integração oficial Broadlink do Home Assistant com uma única alteração funcional: adiciona suporte ao RM5 Plus (product ID 0x5224), que ainda não é reconhecido pela python-broadlink publicada no PyPI nem pela integração built-in.

O RM5 Plus fala o mesmo protocolo da família RM4 pro, por isso é tratado como variante da classe rm4pro. Todas as plataformas (remote, sensor, switch) funcionam tal como nos restantes RM4.

Referências

• PR upstream para python-broadlink — adiciona 0x5224 ao dict rm4pro
• Issue no Home Assistant

Como funciona

Este custom component declara o mesmo domain: broadlink que o built-in, por isso substitui a integração oficial enquanto estiver instalado. Ao carregar, aplica um monkey-patch em runtime a broadlink.SUPPORTED_TYPES[rm4pro] inserindo 0x5224: ("RM5 plus", "Broadlink") antes de o config flow tentar identificar o dispositivo.

Quando o PR upstream for merged e publicado numa nova versão da lib, este custom component deixa de ser necessário — podes removê-lo e voltar ao built-in.

Instalação

Via HACS (recomendado)

1. Em HACS → Integrations → ⋮ → Custom repositories.
2. Adiciona o URL deste repositório, categoria Integration.
3. Procura por "Broadlink (RM5 Plus)" e instala.
4. Reinicia o Home Assistant.

Manual

1. Copia a pasta custom_components/broadlink/ para config/custom_components/broadlink/ na tua instalação do Home Assistant.
2. Reinicia o Home Assistant.

Em qualquer dos métodos, ao reiniciar vais ver no log:

You are using a custom integration broadlink which has not been tested by Home Assistant.

É esperado. É só o aviso standard do HA para integrações custom que fazem override de built-ins.

Adicionar o RM5 Plus

1. Configurações → Dispositivos e serviços → Adicionar integração.
2. Escolhe Broadlink.
3. Introduz o IP do RM5 Plus (o mesmo que vês na app Broadlink).
4. Dá um nome ao dispositivo e conclui.

Se aparecer "Device not supported": confirma que reiniciaste o HA depois de instalar o custom component, e que não há outra instalação da integração broadlink a competir (ex. ficheiros deixados de outro fork).

Compatibilidade

• Home Assistant 2024.1.0 ou superior.
• broadlink==0.19.0 (declarada em manifest.json; instalada automaticamente pelo HA).

Desinstalar

Após o PR upstream ser merged e o HA atualizar a lib:

1. Remove a pasta config/custom_components/broadlink/.
2. Reinicia o HA.

As entidades existentes continuam a funcionar com o built-in (mesmo domain).

Licença

MIT para as alterações deste repositório. O código derivado do Home Assistant core mantém-se sob Apache 2.0 — ver LICENSE.