_bleio module provides necessary low-level functionality for communicating
using Bluetooth Low Energy (BLE). The ‘_’ prefix indicates this module is meant
for internal use by libraries but not by the end user. Its API may change incompatibly
between minor versions of CircuitPython.
Please use the
CircuitPython library instead, which builds on
provides higher-level convenience functionality, including predefined beacons, clients,
Address– BLE address
Adapter— BLE adapter
Attribute– BLE Attribute
Characteristic– BLE service characteristic
CharacteristicBuffer– BLE Service incoming values buffer.
Connection– A BLE connection
Descriptor– BLE descriptor
PacketBuffer– Packet-oriented characteristic usage.
ScanEntry– BLE scan data
ScanResults– An Iterator over BLE scanning results
Service– BLE GATT Service
UUID– BLE UUID
BLE Adapter used to manage device discovery and connections. This object is the sole instance of
Catch all exception for Bluetooth related errors.
Raised when a connection is unavailable.
Raised when a resource is used as the mismatched role. For example, if a local CCCD is attempted to be set but they can only be set when remote.
Raised when a security related error occurs.