Ringraziamenti: Questo tutorial si basa sulle documentazioni README e sui dati di progetto resi pubblicamente disponibili su GitHub dall'autore del progetto BatMON (batmon-ha). Ringraziamo espressamente lo sviluppatore originale per i contenuti tecnici e i dati messi a disposizione.
Fonte del progetto (GitHub): https://github.com/fl4p/batmon-ha
In questo articolo viene spiegato passo dopo passo come BatMON in Home Assistant viene installato, configurato e utilizzato per leggere i dati della batteria direttamente dal Bluetooth Low Energy (BLE) del sistema di gestione della batteria (BMS) e visualizzarli in modo affidabile in Home Assistant.
Le procedure descritte sono particolarmente adatte per batterie LiFePO₄ con BMS Bluetooth, come ad es. B. batterie Bluetooth Lithink, e sono pensate per l'impiego in camper, sistemi off-grid e accumuli energetici stazionari.
Nota importante: BatMON utilizza Bluetooth Low Energy per la trasmissione dei dati. A seconda delle condizioni ambientali (distanza, schermatura metallica, interferenze radio o hardware Bluetooth dell'host), possono verificarsi brevi interruzioni della connessione. Di norma ciò non indica un guasto della batteria o del BMS.
1) Che cos'è BatMON e quale funzione svolge in Home Assistant?
BatMON è un add-on sviluppato appositamente per Home Assistant per il monitoraggio dei sistemi di batterie. Tramite Bluetooth Low Energy (BLE) viene stabilita una connessione diretta al sistema di gestione della batteria (BMS), attraverso la quale i dati di funzionamento vengono letti continuamente.
I dati letti vengono trasmessi a Home Assistant tramite MQTT e resi disponibili come entità sensore. Su questa base è possibile realizzare visualizzazioni, registrazioni e automazioni.
Per le batterie Lithink LiFePO₄ con BMS Bluetooth, BatMON consente un'architettura di sistema particolarmente snella, poiché non sono necessari gateway aggiuntivi né interfacce seriali.
- Connessione BLE diretta al BMS della batteria
- Rilevamento di tensione, corrente e stato di carica della batteria (SoC)
- Lettura delle tensioni delle celle e delle temperature (a seconda del BMS)
- Supporto per più batterie in parallelo
- MQTT Auto-Discovery per Home Assistant
- Integrazione in dashboard e panoramiche energetiche
In pratica BatMON si è dimostrato particolarmente affidabile in sistemi in funzione continua, ad esempio in camper o in impianti energetici indipendenti dalla rete. Con le batterie Bluetooth Lithink i dati forniti dal BMS vengono acquisiti direttamente e mappati come entità separate di Home Assistant.
2) Requisiti
- Home Assistant installato con supporto Supervisor.
- Supporto Bluetooth sul sistema host (interno o tramite adattatore USB).
- Broker MQTT installato, ad es. Mosquitto.
- Batteria compatibile Bluetooth, eingeschaltet und in Reichweite, z. B. eine Lithink Bluetooth-LiFePO₄-Batterie.
Nelle batterie Bluetooth Lithink la funzione Bluetooth è attivata in fabbrica. Non è necessaria alcuna attivazione aggiuntiva né modifiche al firmware. Durante la configurazione, la batteria non dovrebbe essere collegata in modo permanente a un'app per smartphone in parallelo.
3) Passaggio 1: aggiungere il repository BatMON
- Aprire Home Assistant.
- Navigare in Supervisor → Add-on Store.
- Dal menu ⋮ → Repositories aggiungere un nuovo repository.
- Inserire il seguente URL:
https://github.com/fl4p/home-assistant-addons4) Passaggio 2: installare l'add-on BatMON
- Nel negozio add-on selezionare BatMON.
- Fare clic su Install.
- Attendere il completamento dell'installazione.
5) Passaggio 3: installare e configurare il broker MQTT
- Installare l'add-on Mosquitto MQTT.
- Avviare il servizio MQTT.
- Abilitare l'integrazione MQTT in Home Assistant.
- Configurare correttamente nome utente e password.
6) Passaggio 4: configurare BatMON (collegare la batteria Bluetooth)
devices:
- address: CC:44:8C:F7:AD:BB
type: jk
alias: lithink_battery
pin: "12345"
adapter: "hci0"
debug: true
current_calibration: 1.0Nei sistemi con più batterie è possibile definire più dispositivi con un alias proprio. Ogni batteria Bluetooth Lithink viene quindi gestita come entità separata in Home Assistant.
7) Passaggio 5: avviare BatMON
- Avviare l'add-on.
- Controllare i log.
- Assicurarsi che sia presente una connessione stabile alla batteria e che i dati MQTT vengano inviati.
8) Passaggio 6: visualizzare i dati della batteria in Home Assistant
Dopo l'avvio corretto, i dati dei sensori vengono integrati automaticamente in Home Assistant tramite MQTT Discovery. I valori visualizzati corrispondono ai dati forniti dal BMS della batteria e coincidono con le informazioni mostrate dall'app della batteria.
9) Risoluzione dei problemi
La batteria non viene visualizzata o non si connette
- Controllare l'indirizzo MAC.
- Configurare correttamente il tipo di BMS.
- Ridurre la distanza tra batteria e host.
- Analizzare i log di BatMON.
- Verificare il broker MQTT.
La connessione esiste, ma non si vedono entità in Home Assistant
- Integrazione MQTT attiva?
- Credenziali MQTT corrette?
- Messaggi MQTT Publish presenti nel log?
- Ricaricare l'integrazione MQTT o riavviare Home Assistant.
Connessione Bluetooth instabile
- Evitare connessioni parallele con app per smartphone.
- Ridurre le interferenze radio.
- Utilizzare adattatori Bluetooth USB esterni.
- In stationären Systemen (z. B. Wohnmobil oder Off-Grid) empfiehlt sich eine einzelne, dauerhafte Bluetooth-Verbindung über Home Assistant, insbesondere bei Lithink Bluetooth-Batterien.
10) Ringraziamenti e fonte del progetto
Questo tutorial si basa completamente sulle documentazioni README e sui dati di progetto disponibili pubblicamente del progetto BatMON. Ringraziamo lo sviluppatore originale per la messa a disposizione di queste informazioni tecniche.
Fonte del progetto: https://github.com/fl4p/batmon-ha
Condividi:
Victron Venus OS: Integrare le batterie Lithink via Bluetooth e visualizzare i dati della batteria
Cause e soluzioni per la caduta di tensione all'avvio dell'inverter