hap-ble 0.3.0

HomeKit Accessory Protocol (HAP) Bluetooth LE transport: discover, pair, read, and stream events from HomeKit accessories over BLE.
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

# hap-ble

A Bluetooth LE transport for the [hap-rust](https://github.com/phunapps/hap-rust)
HomeKit controller stack. Discover, pair with, read from, and stream events off
a HomeKit accessory over BLE, reusing the same Pair Setup / Pair Verify crypto
as the IP transport.

> **Status:** stable transport (`0.3`). Usable standalone, or unified with the
> IP transport under one `hap-controller` API via its `ble` feature
> (Milestone B). Characteristic read/write, connected events, and durable
> sleepy-device notifications (encrypted broadcasts + disconnected-event polls)
> are supported. Thread is out of scope.

## Example

```rust,no_run
use std::time::Duration;

# async fn run() -> Result<(), Box<dyn std::error::Error>> {
let found = hap_ble::scan(Duration::from_secs(5)).await?;
let Some(target) = found.iter().find(|a| !a.paired) else { return Ok(()) };

let gatt = hap_ble::connect_gatt(target).await?;
let controller = hap_ble::BleController::generate("my-controller".into());
let (accessory, _pairing) = controller.pair(gatt, target, "123-45-678").await?;

for acc in accessory.accessories() {
    println!("accessory with {} services", acc.services.len());
}
# Ok(())
# }
```

## Platform notes

- **macOS:** uses CoreBluetooth; the first run triggers the system Bluetooth
  permission prompt.
- **Linux:** uses BlueZ over D-Bus.

See the workspace `CHANGELOG.md` and the design spec in `docs/superpowers/specs/`.