Tak til: Denne tutorial bygger på den README-dokumentation og de projektdatа, som projektets forfatter BatMON (batmon-ha) har gjort offentligt tilgængelige på GitHub. Vi takker udtrykkeligt den oprindelige udvikler for de tekniske oplysninger og data, der er stillet til rådighed.
Projektkilde (GitHub): https://github.com/fl4p/batmon-ha
I denne artikel forklares trin for trin, hvordan BatMON installeres, konfigureres og drives i Home Assistant, så batteridata kan aflæses direkte fra Batteri-Management-Systemet (BMS) via Bluetooth Low Energy (BLE) og vises pålideligt i Home Assistant.
De beskrevne fremgangsmåder er især velegnede til LiFePO₄-batterier med Bluetooth-BMS, som f. eks. Lithink Bluetooth-batterier, og er designet til brug i autocampere, off-grid-systemer og stationære energilagre.
Vigtig bemærkning: BatMON bruger Bluetooth Low Energy til dataoverførsel. Afhængigt af miljøpåvirkninger (afstand, metalskærmning, radiostøj eller værtens Bluetooth-hardware) kan der forekomme kortvarige forbindelsesafbrydelser. Dette er som regel ikke en fejl ved batteriet eller BMS'et.
1) Hvad er BatMON, og hvilken funktion har det i Home Assistant?
BatMON er et add-on, der er udviklet specifikt til Home Assistant til overvågning af batterisystemer. Via Bluetooth Low Energy (BLE) etableres en direkte forbindelse til batteri-management-systemet (BMS), hvorfra driftsdata løbende aflæses.
De aflæste data overføres til Home Assistant via MQTT og gøres tilgængelige som sensor-entiteter. På den baggrund kan man lave visualiseringer, logning og automationer.
For Lithink LiFePO₄-batterier med Bluetooth-BMS muliggør BatMON en særligt slank systemarkitektur, da der ikke kræves yderligere gateways eller serielle grænseflader.
- Direkte BLE-forbindelse til batteriets BMS
- Registrering af batterispænding, strøm og ladetilstand (SoC)
- Aflæsning af cellespeninger og temperaturer (afhængigt af BMS)
- Understøttelse af flere batterier parallelt
- MQTT Auto-Discovery til Home Assistant
- Integration i dashboards og energioversigter
I praksis har BatMON vist sig særligt velegnet i systemer, der kører konstant, f.eks. i autocampere eller off-grid-energisystemer. Ved Lithink Bluetooth-batterier overføres de data, som BMS'et stiller til rådighed, direkte og vises som selvstændige Home Assistant-entiteter.
2) Forudsætninger
- Installeret Home Assistant med Supervisor-understøttelse.
- Bluetooth-understøttelse på hostsystеmet (internt eller via USB-adapter).
- Installeret MQTT Broker, f. eks. Mosquitto.
- Bluetooth-kompatibelt batteri, tændt og inden for rækkevidde, f. eks. et Lithink Bluetooth-LiFePO₄-batteri.
På Lithink Bluetooth-batterier er Bluetooth-funktionen aktiveret fra fabrikken. Yderligere aktivering eller ændring af firmwaren er ikke nødvendig. Under opsætningen bør batteriet ikke være permanent forbundet parallelt med en smartphone-app.
3) Trin 1: Tilføj BatMON-repositoriet
- Åbn Home Assistant.
- Gå til Supervisor → Add-on Store.
- Tilføj et nyt repository via menuen ⋮ → Repositories.
- Indtast følgende URL:
https://github.com/fl4p/home-assistant-addons
4) Trin 2: Installer BatMON-add-on
- Vælg BatMON i Add-on Store.
- Klik på Install.
- Vent til installationen er helt færdig.
5) Trin 3: Installer og konfigurer MQTT Broker
- Installer add-on'et Mosquitto MQTT.
- Start MQTT-tjenesten.
- Aktivér MQTT-integration i Home Assistant.
- Konfigurer brugernavn og adgangskode korrekt.
6) Trin 4: Konfigurer BatMON (tilslut Bluetooth-batteri)
devices:
- address: CC:44:8C:F7:AD:BB
type: jk
alias: lithink_battery
pin: "12345"
adapter: "hci0"
debug: true
current_calibration: 1.0
I systemer med flere batterier kan flere enheder defineres med hver deres alias. Hvert Lithink Bluetooth-batteri oprettes derefter som en separat entitet i Home Assistant.
7) Trin 5: Start BatMON
- Start add-on'et.
- Kontrollér logudskrifterne.
- Sørg for, at der er en stabil forbindelse til batteriet, og at MQTT-data bliver sendt.
8) Trin 6: Vis batteridata i Home Assistant
Efter en vellykket start integreres sensordata automatisk i Home Assistant via MQTT Discovery. De viste værdier svarer til de data, som batteriets BMS leverer, og stemmer overens med oplysningerne i batteri-appen.
9) Fejlfinding
Batteriet vises ikke eller forbinder ikke
- Kontrollér MAC-adressen.
- Konfigurer BMS-typen korrekt.
- Reducer afstanden mellem batteri og host.
- Gennemgå BatMON-loggene.
- Kontrollér MQTT Broker.
Forbindelsen er der, men ingen entiteter er synlige i Home Assistant
- Er MQTT-integration aktiveret?
- Er MQTT-loginoplysningerne korrekte?
- Findes der MQTT-publiseringsmeddelelser i loggen?
- Genindlæs MQTT-integration, eller genstart Home Assistant.
Ustabil Bluetooth-forbindelse
- Undgå parallelle forbindelser med smartphone-apps.
- Reducer radiostøj.
- Brug eksterne USB-Bluetooth-adaptere.
- 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) Tak til & projektkilde
Denne tutorial bygger udelukkende på de offentligt tilgængelige README-dokumentationer og projektdatа fra BatMON-projektet. Vi takker den oprindelige udvikler for at have stillet disse tekniske oplysninger til rådighed.
Projektkilde: https://github.com/fl4p/batmon-ha



Del:
Victron Venus OS: Integrer Lithink-batterier via Bluetooth og vis batteridata
Årsager og løsninger til spændingsfald ved inverterstart
8 kommentarer
test
test
test