EVBox BLE

Library extraction for Home Assistant Core consideration. This package is not yet published on PyPI and is not used by the released HACS integration. Source and CI are maintained at CReimer/evbox-ble; report library defects in its issue tracker.

Asynchronous local BLE sessions for EVBox Gen4 chargers, including authentication, configuration and the legacy EVBox/OCPP framing protocol. The protocol and client originate in the Apache-2.0 project CReimer/evbox-g4-ble, revision 5fbeec3dddbc107deac87a46f12b670b4ca3f264. No vendor applications or firmware are included.

Supply a synchronous device provider so the latest connectable adapter or Bluetooth proxy can be selected for each new session. The library has no dependency on Home Assistant. For a direct Bleak application:

from bleak import BleakScanner
from evbox_ble import EVBoxClient

device = await BleakScanner.find_device_by_address(address)
client = EVBoxClient(address, security_code, ble_device_callback=lambda: device)
config = await client.get_configuration(["evb_BootInfo"])

For Home Assistant, the integration adapter supplies lambda: bluetooth.async_ble_device_from_address(hass, address, connectable=True). A missing device raises EVBoxConnectionError; rejected authentication raises EVBoxAuthError.

Transactions serialize complete operations. A snapshot reuses one authenticated BLE session. Legacy and ESP32 characteristic layouts are supported. Optional unavailable commands are distinguished from required command failures.

Tests use simulated BLE notifications and malformed protocol inputs without hardware. Run python -m unittest discover -s tests; build source and wheel artifacts with python -m build. Before publication, configure a public library repository, issue tracker and public CI publishing workflow with PyPI Trusted Publishing. Initial library extraction does not include the Home Assistant firmware/FTP orchestration; any later Core firmware platform must move device communication into the library as well.