5 releases

0.1.4 Nov 7, 2020
0.1.3 Mar 19, 2020
0.1.2 Mar 12, 2020
0.1.1 Feb 22, 2020
0.1.0 Feb 2, 2020

27 downloads per month
Used in bluetooth_mesh

GPL-3.0-only

295KB
8K SLoC

btle - Rust Bluetooth Low Energy Driver

crates.io docs.rs last commit

Cross-platform Bluetooth Low Energy library for Rust. Supports Central, Peripheral, Broadcaster and Observer GAP roles. Also supports custom device drivers to enable platform support for custom platforms (embedded, etc).

Very much WIP.

Supported Platforms so far:

  • Linux (BlueZ)
  • HCI
  • USB (using libusb)
  • Proxy
  • Windows 10 / UWP
  • Windows 7 (must use libusb drivers)
  • macOS
  • iOS
  • Android

Any platforms missings drivers should still be able to compile, just without any built in way to talk to the BLE controller.

Supported GAP Roles so far:

  • Observer (Receiver Advertisements)
  • Broadcaster (Send Advertisements)
  • (WIP) Central (Initiate GATT Connection)
  • (WIP) Peripheral (GATT Connectable)

WIP Example (API may change later):

pub async fn dump_adapter<A: btle::hci::adapter::Adapter>(adapter: A) -> Result<(), CLIError> {
    let adapter = btle::hci::adapters::Adapter::new(adapter);
    let mut le = adapter.le();
    println!("resetting adapter...");
    le.adapter.reset().await?;
    println!("settings scan parameters...");
    // Set BLE Scan parameters (when to scan, how long, etc)
    le.set_scan_parameters(btle::le::scan::ScanParameters::DEFAULT)
        .await?;
    // Enable scanning for advertisement packets.
    le.set_scan_enable(true, false).await?;

    println!("waiting for advertisements...");
    // Create the advertisement stream from the LEAdapter.
    let mut stream = le.advertisement_stream::<Box<[ReportInfo]>>().await?;
    // Pin it.
    let mut stream = unsafe { Pin::new_unchecked(&mut stream) };
    loop {
        // Asynchronously iterate through the stream and print each advertisement report.
        while let Some(report) = stream.next().await {
            println!("report: {:?}", &report);
        }
    }
}

Dependencies

~1–2.5MB
~50K SLoC