README.md

jkbms-influxdb-grafana

Howto visualize JK BMS values in grafana

The following has been working perfectly now for months:

1. jkbms from https://github.com/jblance/mpp-solar

   • configured to read from bluetooth
   • writing output to MQTT

2. Optional, if jkbms is not started as a daemon

   • crontab to read two separate JK BMS using a script:

   */2 * * * * /root/bin/read_jkbms.sh 2>&1 >> /var/log/read_jkbms.log

   see read_jkbms.sh (insert your JKBMS BT MAC addresses)

3. telegraf with a confguration for

   • reading MQTT
   • selecting the relevant keys
   • translating the long JKBMS names into short ones for the DB
   • writing the values to influxdb v2

4. influxdb (currently I'm using version 2.10)

   • with a bucket and access token configured

5. grafana (currently I'm using version 9.4.7) with

   • a data source configured to access the influxdb bucket
   • dashboard to display the battery values

The three example configuration files are linked in this git repository for re-use.

Screenshot: