#bluetooth #battery #ble #bluetooth-le #bms #serial-communication #li-gen

batteread

Read status data from certain models of LiFePO4 Battery Management Systems over Bluetooth Low Energy. Tested with a battery made by li-gen.net.

1 unstable release

0.1.0 Oct 18, 2024

#1009 in Hardware support

Download history 121/week @ 2024-10-14 22/week @ 2024-10-21 14/week @ 2024-11-04

157 downloads per month

MIT license

19KB
287 lines

Batteread

Read status data from certain models of LiFePO4 Battery Management Systems over Bluetooth Low Energy

Tested with a 400ah 24v battery manufactured by https://www.li-gen.net/ and sold around the year 2022.

The BMS has a BLE interface. On top of that the NordicUART protocol is used for serial communication. On top of that there seems to be a proprietary request-response protocol which I have attempted to partially reverse engineer.

Currently the following data can be accessed:

  • State of charge (%)
  • Residual capacity (Ah)
  • Cycles (count)
  • Cell voltages (v)
  • Battery voltage (v)

Example

# use std::time::Duration;
#
# #[tokio::main]
# pub async fn main(){
    let mut battery_client = batteread::BatteryClient::new_default_name().await.unwrap();
    loop {
        let battery_state = battery_client.fetch_state().await.unwrap();
        println!("{battery_state:?}");
        tokio::time::sleep(Duration::from_secs(5)).await;
    }
# }

lib.rs:

Read status data from certain models of LiFePO4 Battery Management Systems over Bluetooth Low Energy

Tested with a 400ah 24v battery manufactured by https://www.li-gen.net/ and sold around the year 2022.

The BMS has a BLE interface. On top of that the NordicUART protocol is used for serial communication. On top of that there seems to be a proprietary request-response protocol which I have attempted to partially reverse engineer.

Currently the following data can be accessed:

  • State of charge (%)
  • Residual capacity (Ah)
  • Cycles (count)
  • Cell voltages (v)
  • Battery voltage (v)

Example

#
    let mut battery_client = batteread::BatteryClient::new_default_name().await.unwrap();
    loop {
        let battery_state = battery_client.fetch_state().await.unwrap();
        println!("{battery_state:?}");
        tokio::time::sleep(Duration::from_secs(5)).await;
    }

Dependencies

~5–33MB
~489K SLoC