Dankzegging: Deze tutorial is gebaseerd op de door de auteur van het project BatMON (batmon-ha) op GitHub openbaar beschikbaar gestelde README-documentatie en projectgegevens. Wij danken de oorspronkelijke ontwikkelaar uitdrukkelijk voor de beschikbare technische inhoud en gegevens.
Projectbron (GitHub): https://github.com/fl4p/batmon-ha
In dit artikel wordt stap voor stap uitgelegd hoe BatMON in Home Assistant wordt geïnstalleerd, geconfigureerd en gebruikt om batterijgegevens via Bluetooth Low Energy (BLE) rechtstreeks uit het Batterijbeheersysteem (BMS) uit te lezen en betrouwbaar in Home Assistant weer te geven.
De beschreven aanpak is vooral geschikt voor LiFePO₄-batterijen met Bluetooth-BMS, zoals z. B. Lithink Bluetooth-batterijen, en is bedoeld voor gebruik in campers, off-grid-systemen en stationaire energieopslag.
Belangrijke opmerking: BatMON gebruikt Bluetooth Low Energy voor de gegevensoverdracht. Afhankelijk van omgevingsinvloeden (afstand, metalen afscherming, radiostoringen of Bluetooth-hardware van de host) kunnen er kortstondige verbindingsonderbrekingen optreden. Dit is doorgaans geen defect van de batterij of het BMS.
1) Wat is BatMON en welke functie vervult het in Home Assistant?
BatMON is een add-on die speciaal voor Home Assistant is ontwikkeld voor het bewaken van batterijsystemen. Via Bluetooth Low Energy (BLE) wordt een directe verbinding met het batterijbeheersysteem (BMS) gemaakt, waarna continu bedrijfsgegevens worden uitgelezen.
De uitgelezen gegevens worden via MQTT naar Home Assistant verzonden en daar beschikbaar gemaakt als sensorentiteiten. Op basis daarvan kunnen visualisaties, logboekregistratie en automatiseringen worden gerealiseerd.
Voor Lithink LiFePO₄-batterijen met Bluetooth-BMS zorgt BatMON voor een bijzonder slanke systeemarchitectuur, omdat er geen extra gateways of seriële interfaces nodig zijn.
- Directe BLE-verbinding met het batterij-BMS
- Registratie van batterijspanning, stroom en laadstatus (SoC)
- Uitlezen van celspanningen en temperaturen (afhankelijk van BMS)
- Ondersteuning van meerdere batterijen parallel
- MQTT Auto-Discovery voor Home Assistant
- Integratie in dashboards en energieoverzichten
In de praktijk heeft BatMON zich vooral bewezen in permanent draaiende systemen, zoals in campers of netonafhankelijke energiesystemen. Bij Lithink Bluetooth-batterijen worden de door het BMS geleverde gegevens direct overgenomen en als afzonderlijke Home Assistant-entiteiten weergegeven.
2) Vereisten
- Geïnstalleerde Home Assistant met Supervisor-ondersteuning.
- Bluetooth-ondersteuning op het hostsysteem (intern of via USB-adapter).
- Geïnstalleerde MQTT-broker, z. B. Mosquitto.
- Bluetooth-geschikte batterij, ingeschakeld en binnen bereik, z. B. een Lithink Bluetooth-LiFePO₄-batterij.
Bij Lithink Bluetooth-batterijen is de Bluetooth-functie af fabriek geactiveerd. Extra activering of firmwareaanpassing is niet nodig. Tijdens de installatie mag de batterij niet continu parallel verbonden zijn met een smartphone-app.
3) Stap 1: BatMON-repository toevoegen
- Home Assistant openen.
- Naar Supervisor → Add-on Store gaan.
- Via het menu ⋮ → Repositories een nieuwe repository toevoegen.
- De volgende URL invoeren:
https://github.com/fl4p/home-assistant-addons4) Stap 2: BatMON-add-on installeren
- In de Add-on Store BatMON selecteren.
- Op Install klikken.
- Wachten tot de installatie volledig is voltooid.
5) Stap 3: MQTT-broker installeren en configureren
- Add-on Mosquitto MQTT installeren.
- MQTT-dienst starten.
- MQTT-integratie in Home Assistant inschakelen.
- Gebruikersnaam en wachtwoord correct configureren.
6) Stap 4: BatMON configureren (Bluetooth-batterij koppelen)
devices:
- address: CC:44:8C:F7:AD:BB
type: jk
alias: lithink_battery
pin: "12345"
adapter: "hci0"
debug: true
current_calibration: 1.0In systemen met meerdere batterijen kunnen meerdere apparaten met elk een eigen alias worden gedefinieerd. Elke Lithink Bluetooth-batterij wordt vervolgens als afzonderlijke entiteit in Home Assistant beheerd.
7) Stap 5: BatMON starten
- Add-on starten.
- Loguitvoer controleren.
- Zorgen dat er een stabiele verbinding met de batterij bestaat en dat MQTT-gegevens worden verzonden.
8) Stap 6: Batterijgegevens in Home Assistant weergeven
Na een succesvolle start worden de sensorgegevens automatisch via MQTT Discovery in Home Assistant geïntegreerd. De weergegeven waarden komen overeen met de door het batterij-BMS geleverde gegevens en stemmen overeen met de informatie in de batterij-app.
9) Probleemoplossing
Batterij wordt niet weergegeven of maakt geen verbinding
- MAC-adres controleren.
- BMS-type correct configureren.
- Afstand tussen batterij en host verkleinen.
- BatMON-logs analyseren.
- MQTT-broker controleren.
Verbinding bestaat, maar geen entiteiten zichtbaar in Home Assistant
- MQTT-integratie actief?
- MQTT-inloggegevens correct?
- MQTT-publicatiemeldingen in het log aanwezig?
- MQTT-integratie opnieuw laden of Home Assistant opnieuw starten.
Instabiele Bluetooth-verbinding
- Parallelle verbindingen met smartphone-apps vermijden.
- Radiostoringen verminderen.
- Externe USB-Bluetooth-adapters gebruiken.
- In stationaire systemen (z. B. camper of off-grid) wordt een enkele, permanente Bluetooth-verbinding via Home Assistant aanbevolen, vooral bij Lithink Bluetooth-batterijen.
10) Dankzegging & projectbron
Deze tutorial is volledig gebaseerd op de openbaar beschikbare README-documentatie en projectgegevens van het BatMON-project. Wij danken de oorspronkelijke ontwikkelaar voor het beschikbaar stellen van deze technische informatie.
Projectbron: https://github.com/fl4p/batmon-ha
Delen:
Victron Venus OS: Lithink-batterijen via Bluetooth integreren en batterijgegevens weergeven
Oorzaken en oplossingen voor spanningsval bij het starten van de omvormer
8 opmerkingen
*
test
test
test’
test