How deviceplug/btleplug works
btleplug is an async Rust Bluetooth LE central library. Its main workflow obtains platform adapters, scans for peripherals, connects, discovers GATT services and characteristics, then reads, writes, or subscribes to values. The graph separates the shared API from the Linux, Apple, Android, and Windows backends. README capabilities include descriptor access, notifications, adapter state, and platform-specific address/connection features; backend details beyond the excerpts are represented at subsystem level where needed. Some internal links rely on the SOURCE INDEX rather than inspected implementation excerpts.
Main entry points: platform.rs Platform exports · objects.rs JNI object bridge · mod.rs Peripheral API · adapter.rs BlueZ adapter
Components 24
Shared API
- Manager API
src/api/mod.rs - Central API
src/api/mod.rs - Peripheral API
src/api/mod.rs - BLE types
src/api/bdaddr.rs - Advertisement parser
src/advertisement.rs - Platform exports
src/platform.rs - Adapter manager state
src/common/adapter_manager.rs
Linux BlueZ
- BlueZ manager
src/bluez/manager.rs - BlueZ adapter
src/bluez/adapter.rs - BlueZ peripheral
src/bluez/peripheral.rs
Apple CoreBluetooth
- CoreBluetooth manager
src/corebluetooth/manager.rs - CoreBluetooth adapter
src/corebluetooth/adapter.rs - CoreBluetooth peripheral
src/corebluetooth/peripheral.rs
Android JNI
- Android manager
src/droidplug/manager.rs - Android adapter
src/droidplug/adapter.rs - Android peripheral
src/droidplug/peripheral.rs - JNI object bridge
src/droidplug/jni/objects.rs - JNI async utilities
src/droidplug/jni_utils/future.rs - Android Java BLE
src/droidplug/java/src/main/java/com/nonpolynomial/btleplug/android/impl/Peripheral.java
Windows WinRT
- WinRT manager
src/winrtble/manager.rs - WinRT adapter
src/winrtble/adapter.rs - WinRT peripheral
src/winrtble/peripheral.rs - WinRT GATT objects
src/winrtble/ble/characteristic.rs
Other components
- Rust application
Connections 24
- Rust application → Manager API: creates
- Rust application → Central API: scans
- Rust application → Peripheral API: connects and uses
- Manager API → Platform exports: resolves implementation
src/platform.rs - Platform exports → BlueZ manager: exports on Linux
src/platform.rs - Platform exports → CoreBluetooth manager: exports on Apple
src/platform.rs - Platform exports → Android manager: exports on Android
src/platform.rs - Platform exports → WinRT manager: exports on Windows
src/platform.rs - BlueZ manager → BlueZ adapter: creates adapters
src/bluez/manager.rs - BlueZ adapter → BlueZ peripheral: uses peripherals
src/bluez/adapter.rs - CoreBluetooth manager → CoreBluetooth adapter: creates adapter
src/corebluetooth/manager.rs - Android manager → Android adapter: returns adapter
src/droidplug/manager.rs - Android adapter → JNI object bridge: uses JNI objects
src/droidplug/adapter.rs - Android peripheral → JNI object bridge: uses JNI objects
src/droidplug/peripheral.rs - JNI object bridge → JNI async utilities: uses futures and streams
src/droidplug/jni/objects.rs - JNI object bridge → Android Java BLE: calls Java BLE methods
- WinRT manager → WinRT adapter: creates adapters
src/winrtble/manager.rs - WinRT adapter → WinRT peripheral: uses peripherals
src/winrtble/adapter.rs - WinRT peripheral → WinRT GATT objects: uses GATT objects
src/winrtble/peripheral.rs - BlueZ peripheral → Peripheral API: implements
src/bluez/peripheral.rs - WinRT peripheral → Peripheral API: implements
src/winrtble/peripheral.rs - BLE types → Peripheral API: defines shared types
src/api/mod.rs - Advertisement parser → BLE types: parses advertising data
- BlueZ adapter → Adapter manager state: uses shared state