Python library for PowerQueen LiFePO4 batteries with BMS Bluetooth connection. Main purpose is to read battery stats from BMS.
Note
The code does not make any changes or change any settings in BMS of battery. Only reading information.
Warning
This is unofficial PowerQueen library. Use at your own risc.
Clone and create python virtual environment
git clone https://github.com/dmytro-tsepilov/pq_bms_bluetooth.git
cd ./pq_bms_bluetooth
python -m venv venv
source venv/bin/activate
Install requirements
pip install -r requirements.txt
Find Bluetooth MAC address of your battery.
On linux it is possible to do with bluez tool.
sudo apt install bluez
Start bluetooth tool bluetoothctl and scan for available bluetooth devices scan on.
Once it find some devices and shows the list, stop scanning with command scan off
Note
There is no need to Trust, Pair or Connect to battery via bluez. Just find MAC address of battery.
[bluetooth]# scan on
Discovery started
[CHG] Controller 12:34:56:78:AA:CC Discovering: yes
[NEW] Device 12:34:56:78:CC:12 Some Sound Device etc.
[NEW] Device 12:34:56:78:29:CF P-12100BXXX77-A00123
[NEW] Device 12:34:56:78:F8:7C 12-33-44-55-F8-7C
[NEW] Device 12:34:56:78:D4:3D 33-44-55-EE-D4-3D
[bluetooth]# scan off
# python main.py --help
usage: main.py [-h] [--bms] [--pair] [-s] [--verbose] DEVICE_MAC
positional arguments:
DEVICE_MAC Bluetooth device MAC address in format 12:34:56:78:AA:CC
options:
-h, --help show this help message and exit
--bms Get battery BMS info
--pair Pair with device before interacting
-s, --services List device GATT services and characteristics
--verbose Verbose logs
Get BMS information
# python main.py 12:34:56:78:AA:CC --bms
{
"packVoltage": 12793,
"voltage": 13338,
"batteryPack": {
"1": 3.335,
"2": 3.335,
"3": 3.335,
"4": 3.333
},
"current": 15.04,
"watt": 189.435,
"remianAh": 105.0,
"factoryAh": 105.0,
"cellTemperature": 25,
"mosfetTemperature": 26,
"heat": [
0,
0,
0,
0
],
"protectState": [
0,
0,
0,
0
],
"failureState": [
0,
0,
0,
0
],
"equilibriumState": 0,
"batteryState": 1,
"SOC": "100%",
"SOH": "105%",
"dischargesCount": 0,
"dischargesAHCount": 101,
"firmwareVersion": "1.4.0",
"manfactureDate": "1980-01-01",
"hardwareVersion": "T12345678",
"battery_status": "Charging",
"balance_status": "All cells are well-balanced.",
"cell_status": "Battery is in optimal working condition.",
"bms_status": null,
"heat_status": null
}
List device GATT services and characteristics
# python main.py 12:34:56:78:AA:CC --services
Software:
- Python 3.10, 3.11
- Linux Ubuntu 22.04
- Raspberry Pi OS Debian 12 (bookworm) (kernel 6.6+)
Hardware:
- Power Queen LiFePO4 12V 100A