Skip to content
/ btle Public

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

License

Notifications You must be signed in to change notification settings

AndrewGi/btle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

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

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages