Agradecimentos: Este tutorial baseia-se nas documentações README e nos dados do projeto disponibilizados publicamente no GitHub pelo autor do projeto BatMON (batmon-ha). Agradecemos expressamente ao desenvolvedor original pelos conteúdos técnicos e dados disponibilizados.
Fonte do projeto (GitHub): https://github.com/fl4p/batmon-ha
Neste artigo, é explicado passo a passo como instalar, configurar e operar o BatMON no Home Assistant, para ler dados da bateria através de Bluetooth Low Energy (BLE) diretamente do Sistema de Gestão de Bateria (BMS) e apresentá-los de forma fiável no Home Assistant.
Os procedimentos descritos são particularmente adequados para baterias LiFePO₄ com Bluetooth-BMS, como p. ex. baterias Bluetooth Lithink, e destinam-se a utilização em autocaravanas, sistemas off-grid e armazenamentos de energia estacionários.
Nota importante: O BatMON utiliza Bluetooth Low Energy para a transmissão de dados. Dependendo de fatores do ambiente (distância, blindagem metálica, interferências de rádio ou hardware Bluetooth do anfitrião), podem ocorrer interrupções de ligação de curta duração. Em regra, isto não indica um defeito da bateria ou do BMS.
1) O que é o BatMON e que função desempenha no Home Assistant?
BatMON é um add-on desenvolvido especificamente para o Home Assistant para monitorizar sistemas de baterias. Através de Bluetooth Low Energy (BLE), é estabelecida uma ligação direta ao Sistema de Gestão de Bateria (BMS), por meio da qual os dados operacionais são lidos continuamente.
Os dados lidos são transmitidos para o Home Assistant através de MQTT e disponibilizados aí como entidades de sensores. Com base nisso, é possível criar visualizações, registos e automações.
Para baterias Lithink LiFePO₄ com Bluetooth-BMS, o BatMON permite uma arquitetura de sistema particularmente simples, uma vez que não são necessários gateways adicionais nem interfaces seriais.
- Ligação BLE direta ao BMS da bateria
- Leitura da tensão da bateria, corrente e estado de carga (SoC)
- Leitura das tensões das células e temperaturas (dependente do BMS)
- Suporte para várias baterias em paralelo
- MQTT Auto-Discovery para o Home Assistant
- Integração em painéis e vistas de energia
Na prática, o BatMON tem-se revelado especialmente eficaz em sistemas em funcionamento permanente, como autocaravanas ou sistemas de energia fora da rede. Em baterias Bluetooth Lithink, os dados fornecidos pelo BMS são assumidos diretamente e representados como entidades independentes do Home Assistant.
2) Pré-requisitos
- Home Assistant instalado com suporte para Supervisor.
- Suporte Bluetooth no sistema anfitrião (interno ou através de adaptador USB).
- Broker MQTT instalado, por ex. Mosquitto.
- Bateria com Bluetooth, ligada e ao alcance, p. ex. uma bateria Bluetooth LiFePO₄ da Lithink.
Nas baterias Bluetooth Lithink, a função Bluetooth vem ativada de fábrica. Não é necessária qualquer ativação adicional nem ajuste de firmware. Durante a configuração, a bateria não deve estar ligada permanentemente em paralelo a uma aplicação para smartphone.
3) Passo 1: adicionar o repositório BatMON
- Abrir o Home Assistant.
- Navegar para Supervisor → Add-on Store.
- Através do menu ⋮ → Repositories, adicionar um novo repositório.
- Introduzir o seguinte URL:
https://github.com/fl4p/home-assistant-addons4) Passo 2: instalar o add-on BatMON
- No Add-on Store, selecionar BatMON.
- Clicar em Install.
- Aguardar até a instalação estar concluída.
5) Passo 3: instalar e configurar o broker MQTT
- Instalar o add-on Mosquitto MQTT.
- Iniciar o serviço MQTT.
- Ativar a integração MQTT no Home Assistant.
- Configurar corretamente o nome de utilizador e a palavra-passe.
6) Passo 4: configurar o BatMON (ligar a bateria Bluetooth)
devices:
- address: CC:44:8C:F7:AD:BB
type: jk
alias: lithink_battery
pin: "12345"
adapter: "hci0"
debug: true
current_calibration: 1.0Em sistemas com várias baterias, podem ser definidos vários dispositivos, cada um com o respetivo alias. Cada bateria Bluetooth Lithink é depois apresentada como uma entidade separada no Home Assistant.
7) Passo 5: iniciar o BatMON
- Iniciar o add-on.
- Verificar as saídas do log.
- Garantir que existe uma ligação estável à bateria e que os dados MQTT estão a ser enviados.
8) Passo 6: mostrar os dados da bateria no Home Assistant
Após o arranque com sucesso, os dados dos sensores são integrados automaticamente no Home Assistant através do MQTT Discovery. Os valores apresentados correspondem aos dados fornecidos pelo BMS da bateria e coincidem com as informações da aplicação da bateria.
9) Resolução de problemas
A bateria não é apresentada ou não se liga
- Verificar o endereço MAC.
- Configurar corretamente o tipo de BMS.
- Reduzir a distância entre a bateria e o anfitrião.
- Analisar os registos do BatMON.
- Verificar o broker MQTT.
A ligação existe, mas não há entidades visíveis no Home Assistant
- Integração MQTT ativa?
- Credenciais MQTT corretas?
- Mensagens MQTT publish presentes no log?
- Recarregar a integração MQTT ou reiniciar o Home Assistant.
Ligação Bluetooth instável
- Evitar ligações paralelas com aplicações de smartphone.
- Reduzir interferências de rádio.
- Utilizar adaptadores USB Bluetooth externos.
- Em sistemas estacionários (p. ex. autocaravana ou off-grid), recomenda-se uma única ligação Bluetooth permanente através do Home Assistant, especialmente no caso das baterias Bluetooth Lithink.
10) Agradecimentos & fonte do projeto
Este tutorial baseia-se totalmente nas documentações README e nos dados do projeto BatMON disponíveis publicamente. Agradecemos ao desenvolvedor original pela disponibilização destas informações técnicas.
Fonte do projeto: https://github.com/fl4p/batmon-ha
Partilhar:
Victron Venus OS: integrar baterias Lithink por Bluetooth e apresentar dados da bateria
Causas e soluções para queda de tensão ao arrancar o inversor
8 comentários
test
test
test