KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #claude-code #codex #typescript #ai-agents #dsh #dsh-plugin #deepseek-harness #ai-agent #mcp #agent-skills #macos

bms-monitoring-stack

★ 41 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# bms-monitoring-stack

This stack deployes:
  * bms-db
  * bms-exporter
  * dht-exporter (DHT22 temp/humidity sensor)
  * prometheus
  * node-exporter
  * grafana

## Overview

This tool uses python gatt to scrape the information from Xiaoxiang BMS.
Those products are used for many LifePo4 based batteries.

I personally use it for a 2019 LIONTRON 200AH 12V LifePo4 caravan battery.
Those battery use BMS that use Bluetooth Low Energy with a non-standard protocol.o

I'm basically writing the values into a sqlite3 db that gets read by the bms-exporter.

Prometheus is configured to scrape the exporter.

Grafana setups a dashboard to visualize the data.

This runs on a Raspberry Pi 3b+ directly in the caravan.

## See also
  * heavily based on https://github.com/sw-home/FHEM-BluetoothSmartBMS
  * https://github.com/simat/BatteryMonitor/wiki/Generic-Chinese-Bluetooth-BMS-communication-protocol
  * https://mono.software/2018/11/15/multiple-bms-monitor/
  * http://www.deszynski.com/wp/xiaoxiang-bms-ios-app-ist-online/

This project is only for private usage. This has been done only in a few hours, so expect shortcuts and errors on the way. If you want to use it, change the MAC address in [docker-compose.yaml](docker-compose.yaml).

## Grafana Demo

![](https://raw.githubusercontent.com/stefanandres/bms-monitoring-stack/master/screenshots/grafana-dashboard.png)

## Known issues

Sometimes the bms-db hangs when not getting data, until this is fixed you can restart the container on stalled db entries:

There is a [autoheal](docker-compose.yaml#L7) container that tries to restart the bms-db container when this happens.

This basically does

```sh
cd bms-db; while sleep 5; do find . -name bms.db -mmin +1 | grep -q bms.db && (date; cd ..; docker-compose restart bms-db); done
```

bms-monitoring-stack

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README