btl
btle
cargo install btle
btl

btle

Cross-platform Bluetooth Low Energy library for Rust. Supports Central, Peripheral, Broadcaster and Observer GAP roles.

by Andrew Gilbrough

0.1.4 (see all)License:GPL-3.0-only
cargo install btle
Readme

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);
        }
    }
}

GitHub Stars

21

LAST COMMIT

1yr ago

MAINTAINERS

1

CONTRIBUTORS

3

OPEN ISSUES

0

OPEN PRs

0
VersionTagPublished
0.1.4
2yrs ago
0.1.3
2yrs ago
0.1.2
2yrs ago
0.1.1
2yrs ago
No alternatives found
No tutorials found
Add a tutorial