Usage
Install and use the SimpleRsBLE Rust binding.
SimpleRsBLE exposes SimpleBLE to Rust applications with Rust-facing types and async event streams.
Requirements
- Rust 1.82 or newer.
- CMake 3.21 or newer.
- The platform requirements from Installation.
- On Linux, DBus headers:
sudo apt-get install libdbus-1-devInstall from crates.io
cargo add simplersbleThe crate builds the native SimpleBLE components during the Cargo build.
Use a local checkout
When developing SimpleRsBLE or testing unreleased changes:
[dependencies]
simplersble = { path = "path/to/simpleble" }First scan
#[tokio::main]
async fn main() {
let mut adapters = simplersble::Adapter::get_adapters().unwrap();
if adapters.is_empty() {
println!("No Bluetooth adapters found.");
return;
}
let adapter = adapters.remove(0);
adapter.scan_for(5000).unwrap();
for peripheral in adapter.scan_get_results().unwrap() {
println!(
"{} [{}]",
peripheral.identifier().unwrap(),
peripheral.address().unwrap()
);
}
}For event streams and notification examples, see Quickstart, Read, Write, Notify, and the SimpleRsBLE Examples.