aiobmsble

What it is and what it does

Aiobmsble is an async Python library built on Bleak that communicates with battery management systems via Bluetooth Low Energy. It handles the complexity of BMS protocol detection and device identification, allowing you to query battery data like voltage, current, temperature, and state-of-charge from compatible devices. The library supports autodetection of compatible BMSs and automatic detection of compatible BLE write modes, making it straightforward to integrate into monitoring applications.

The library is designed for non-safety-critical monitoring and telemetry—the documentation explicitly warns against using it for safety-relevant operations like preventing battery damage or fire, since correctness cannot be guaranteed due to reliance on vendor specifications and Bluetooth connection variability. It provides both command-line tools for device discovery and a Python API for programmatic use, with full async/await support for querying multiple batteries in parallel.

Use it for:

• Monitor battery status in Home Assistant via the BMS_BLE-HA integration for smart home energy management
• Query real-time battery metrics (voltage, current, temperature) from portable power systems or UPS devices
• Build a battery fleet monitoring dashboard that polls multiple BMS devices concurrently over Bluetooth
• Integrate battery telemetry into IoT applications running on Linux or Raspberry Pi systems
• Autodetect and log battery management system data for diagnostics or historical analysis

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Asynchronous Python library for querying battery management systems over Bluetooth Low Energy, with support for device autodetection and parallel operation.

Yes, if you need to read battery management system data over Bluetooth and your devices are on the supported list. The library is actively maintained, has low install friction, and carries a permissive license. However, verify that your specific BMS model is supported before committing, and do not rely on it for safety-critical battery protection—use it only for monitoring and telemetry.

Install

aiobmsble on PyPI

pip install aiobmsble

uv add aiobmsble

poetry add aiobmsble

Installing aiobmsble

Before you install

Low friction installation with only two runtime dependencies (bleak and bleak-retry-connector). Actively maintained with a release within the past week and recent commits, though the project is still in Beta status.

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions, requiring only license and copyright notice retention.

Quickstart

pip install aiobmsble

import asyncio
from bleak import BleakScanner
from aiobmsble.bms.dummy_bms import BMS

async def main():
    device = await BleakScanner.find_device_by_name("BT Device Name")
    async with BMS(ble_device=device) as bms:
        data = await bms.async_update()
        print(data)

Requires Python 3.12 or later and a Bluetooth adapter; BMS device must be on the supported devices list.

Verify before relying

• Whether the supported BMS device list is comprehensive enough for your specific hardware
• Real-world reliability of Bluetooth connection stability under interference or distance constraints
• Performance characteristics when querying multiple batteries in parallel

Package facts

Evidence: aiobmsble-0.27.0-py3-none-any.whl

Keywords: BMS, BLE, battery, Bluetooth

Tags

More Python Modules packages