bluebus 0.1.10

A Rust library for interacting with Bluetooth devices using the org.bluez D-Bus API.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

# BlueBus

<a href="https://crates.io/crates/bluebus">
    <img style="display: inline!important" src="https://img.shields.io/crates/v/bluebus.svg"></img>
</a>
<a href="https://docs.rs/bluebus">
    <img style="display: inline!important" src="https://docs.rs/bluebus/badge.svg"></img>
</a>
<a href="https://docs.rs/bluebus">
    <img style="display: inline!important" src="https://img.shields.io/crates/d/bluebus"></img>
</a>

BlueBus is a Rust library for interacting with Bluetooth devices using the **zbus**. It provides an **async-first** interface for scanning, managing, and communicating with Bluetooth devices on Linux systems.

## Features
✅ **Device Discovery**: Scan for available Bluetooth devices.  
✅ **Device Management**: Connect, pair, unpair, and trust devices.  
✅ **GATT Support**: Read and write Bluetooth characteristics.  
✅ **Low Energy Advertisement**: Manage Bluetooth LE advertisements.  
✅ **Async Support**: Fully compatible with `tokio` and `async/await`.

## Installation
Add `bluebus` to your `Cargo.toml`:

```toml
[dependencies]
bluebus = "0.1.10"
```

## Example Usage
This example scans for Bluetooth devices and prints their addresses:

```rust
#[tokio::main]
async fn main() -> zbus::Result<()> {
    let conn = bluebus::get_system_connection().await.unwrap();
    let adapter = bluebus::AdapterProxy::builder(&conn)
        .path(bluebus::ADAPTER_PATH)?.build().await?;

    if !adapter.powered().await? {
        adapter.set_powered(true).await?;
    }

    adapter.start_discovery().await?;
    tokio::time::sleep(tokio::time::Duration::from_secs(3)).await;
    adapter.stop_discovery().await?;
    let monitor = Arc::new(bluebus::Monitor::new(conn.clone(), manager).await);
    let monitor_clone = Arc::clone(&monitor);
    bluebus::print_avaiable_devices(&objects);
    tokio::spawn(async move {monitor.monitor_device_added().await;});
    tokio::spawn(async move {monitor_clone.monitor_device_removed().await;});
    Ok(())
}
```

## Documentation
Detailed API documentation is available on [docs.rs](https://docs.rs/bluebus).

## License
BlueBus is licensed under either:
- [MIT License](LICENSE-MIT)
- [Apache License (Version 2.0)](LICENSE-APACHE)

## Contributing
Contributions are welcome! Feel free to open an issue or submit a pull request on [GitHub](https://github.com/bluebus-rs/bluebus).

---

## Acknowledgments

#### Special thanks to [REM Vision Lab](https://remvisionlab.com/) and [Sezai Acer](https://github.com/sezaiacers) for their support in improving this library.