Module bluez_agent

BlueZ D-Bus agent for handling BLE authentication on Linux.

Aranet devices expose a Battery Level characteristic that requires authentication. When BlueZ discovers services, it reads this characteristic and gets an “Insufficient Authentication” ATT error. BlueZ then initiates SMP pairing.

Without a registered Bluetooth agent, the pairing request has no handler, causing BlueZ to wait indefinitely and never resolve services. This blocks all subsequent GATT operations including reads on characteristics that don’t require authentication.

This module registers a minimal NoInputNoOutput agent that allows BlueZ to complete “Just Works” pairing, unblocking service discovery and characteristic reads.

Functions

ensure_agent

Ensure a BlueZ agent is registered for this process.