O seu carregador no Home Assistant
O carregador APREVSE fala API HTTP + WebSocket simples na rede local, encaixa diretamente no Home Assistant. A nossa integração comunica com o dispositivo localmente — sem ida à cloud, sem conta, sem broker MQTT. O estado é enviado em tempo real por WebSocket; os comandos vão direto ao carregador na sua rede. E funciona também no sentido inverso: as leituras do carro e da bateria doméstica podem ser enviadas do Home Assistant para o carregador, que passa a carregar com dados a que nunca chegaria sozinho.
Este guia instala a integração Homeassistant através do HACS e põe o carregador no painel em cerca de cinco minutos.
Antes de começar#
- Home Assistant 2024.12 ou mais recente.
- HACS instalado no seu Home Assistant.
- O carregador ligado e na mesma rede local que o Home Assistant. Anote o IP se possível — a maioria das instalações deteta-o automaticamente, mas um IP fixo evita dores de cabeça.
1. Adicionar o repositório personalizado ao HACS#
A integração ainda não está na loja predefinida do HACS, por isso adicione o repositório:
Ou manualmente.
No Home Assistant: HACS → menu ⋮ (canto superior direito) → Repositórios personalizados.
Cole o URL do repositório, escolha Integração como categoria e clique em Adicionar:
https://github.com/apreb/mb-homeassistant
2. Instalar e reiniciar#
O cartão APR EVSE passa a aparecer no HACS. Abra-o, clique em Download e confirme. Quando terminar, reinicie o Home Assistant para carregar a nova integração.
3. Adicionar o carregador#
Há duas formas de entrar — use a que aparecer primeiro.
Deteção automática (zeroconf). Depois de reiniciar, o Home Assistant normalmente encontra o carregador sozinho e mostra um cartão em Definições → Dispositivos e serviços. Clique em Configurar e confirme.
Manual. Se não for detetado, adicione-o à mão: Definições → Dispositivos e
serviços → Adicionar integração → APR EVSE e introduza o host ou IP do
carregador (porta 80 por predefinição).
E pronto — o dispositivo e todas as suas entidades aparecem de imediato.
4. Enviar dados do carro e da bateria doméstica para o carregador#
Requer firmware do carregador 2.2.+ ou mais recente.
Indique à integração os sensores do Home Assistant com o estado de carga do carro, o estado de carga da bateria doméstica e a corrente do inversor, e este carregador passa a receber esses valores automaticamente. Definições → Dispositivos e serviços → APR EVSE. Cada EVSE tem uma opção Configurar
| Opção | Para que serve no carregador | Quando é enviado |
|---|---|---|
| Nível da bateria do carro (%) | Alimenta a condição Usar SOC do carro | a cada alteração, válido 24 h |
| Nível da bateria doméstica (%) | SOC da bateria doméstica para o modo Solar | na alteração e repetido no intervalo |
| Corrente do inversor (A, com sinal) | Saida AC na rede para saber os limites | junto com o nível da bateria |
| Intervalo de envio da bateria doméstica | Cadência de repetição dos dois acima (1-60 s, predefinição 5) | — |
| Registar cada valor enviado | Uma linha por envio em Definições → Sistema → Registos, para diagnóstico | — |
Três pontos a reter:
- Se escolheu um sensor de corrente do inversor: Configure o mesmo valor de polling que o sensor original e conffigure ambs para ser o mais rápido possivel, idelmente entre 1-5s. O carregador segue esse valor para gerir os limites, por isso um envio lento fá-lo reagir tarde. Só com o nível da bateria, 30-60 s chega. Nunca mais do que isso — o carregador descarta os dados ao fim de 60 s.
- A corrente do inversor tem sinal, e o sinal conta. Positivo significa que o inversor está a injetar, negativo que está a carregar a bateria doméstica.
- Uma origem em falha interrompe os envios de propósito. Se o sensor ficar
unavailableou não numérico, nada é enviado, o carregador expira o valor e volta à sua própria lógica em vez de agir sobre uma leitura desatualizada.
Ignore as opções da bateria doméstica se o carregador já consultar um inversor local — ambos escrevem o mesmo estado e vale o último a escrever. Tem vários carregadores? Cada um tem a sua página Configurar, basta repetir por dispositivo.
O que obtém#
Um dispositivo com tudo ligado:
- Controlos — corrente de carga e corrente máxima de carga, modo de carga (Normal / Solar), agendamento, e interruptores para carregamento ativo e usar SOC do carro.
- Sensores — estado, potência de carga / rede / PV, energia da sessão, duração, custo e autonomia adicionada, tensão, temperatura e o preço atual da eletricidade.
- Sensores binários — veículo ligado, a carregar, falha.
- Diagnóstico — sinal Wi-Fi, tempo ligado, RAM e sistema de ficheiros livres, estado dos contadores, endereço MAC e versão de firmware.
O SOC do carro, o SOC da bateria doméstica e a potência PV vêm desativados por predefinição — a maioria das instalações não tem essas fontes. Ative-os na página do dispositivo se as tiver.
A partir daqui é tudo Home Assistant nativo: ponha as entidades num painel, ligue-as a automações, faça gráficos das sessões.
Se procurar inspiração pode ainda adicionar o dashboard exemplo que inclui todas as funcionalidades expostas no Home Assistant.
Encontrou um erro ou quer uma funcionalidade? Abra um issue.