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
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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

//! Test-support seam: the in-memory GATT mock and a ready-made accessory
//! fixture. Compiled for this crate's own tests and for consumers that enable
//! the `test-support` feature. **Exempt from semver guarantees.**

use crate::accessory::BleAccessory;
use crate::accessory::SecureContext;
use crate::gatt::{GattCharacteristic, GattConnection, GattService};
use crate::session::BleSession;
use hap_crypto::SessionKeys;
use std::sync::Arc;

pub use crate::gatt::MockGatt;

/// UUID of the HAP On characteristic (the single characteristic in the fixture).
const ON_CHAR_UUID: &str = "00000025-0000-1000-8000-0026bb765291";

/// UUID of the Pair Verify characteristic.
const VERIFY_CHAR_UUID: &str = "0000004e-0000-1000-8000-0026bb765291";

/// UUID of the Pairing-Pairings characteristic.
const PAIRINGS_CHAR_UUID: &str = "00000050-0000-1000-8000-0026bb765291";

#[allow(clippy::unwrap_used)] // test-support fixture: failures here are test failures
fn on_le() -> Vec<u8> {
    let hex = "00000025000010008000".to_string() + "0026bb765291";
    let mut b: Vec<u8> = (0..16)
        .map(|i| u8::from_str_radix(&hex[i * 2..i * 2 + 2], 16).unwrap())
        .collect();
    b.reverse();
    b
}

#[allow(clippy::unwrap_used)] // test-support fixture: failures here are test failures
fn on_service() -> GattService {
    GattService {
        uuid: "00000043-0000-1000-8000-0026bb765291".into(), // LightBulb
        iid: 10,
        characteristics: vec![GattCharacteristic {
            uuid: ON_CHAR_UUID.into(), // On
            iid: 11,
        }],
    }
}

#[allow(clippy::unwrap_used)] // test-support fixture: failures here are test failures
fn sig_resp() -> Vec<u8> {
    let mut body = Vec::new();
    let mut w = hap_tlv8::Tlv8Writer::new(&mut body);
    w.push(crate::pdu::param::CHAR_TYPE, &on_le());
    w.push(crate::pdu::param::PROPERTIES, &0x0083u16.to_le_bytes()); // read+write+events
    w.push(
        crate::pdu::param::PRESENTATION_FORMAT,
        &[0x01, 0, 0, 0, 0, 0, 0],
    );
    let mut resp = vec![0x02, 0x01, 0x00];
    resp.extend_from_slice(&u16::try_from(body.len()).unwrap().to_le_bytes());
    resp.extend_from_slice(&body);
    resp
}

/// Build a paired-looking accessory over the mock GATT device with one
/// LightBulb/On characteristic (aid 1, iid 11, Bool), zeroed session keys,
/// broadcast key `[0u8; 32]`, controller id `"test-controller"`, pairing id
/// `"AE:EC:86:C0:BF:D7"`.
///
/// # Panics
///
/// Panics if the mock GATT enumeration or database build fails (should never
/// happen in a correct test setup).
#[allow(clippy::unwrap_used)] // test-support fixture: failures here are test failures
pub async fn ble_accessory_with_db() -> (BleAccessory, Arc<MockGatt>) {
    let gatt = Arc::new(MockGatt::new().with_services(vec![on_service()]));
    gatt.queue_read(ON_CHAR_UUID, sig_resp());
    let session = BleSession::new(SessionKeys {
        read_key: [0; 32],
        write_key: [0; 32],
    });
    let services = gatt.enumerate().await.unwrap();
    let accessories = crate::db::build_db(gatt.as_ref(), &services, 512)
        .await
        .unwrap();
    let ctx = SecureContext {
        session,
        session_generation: 0,
        keypair: hap_crypto::ControllerKeypair::generate("test-controller".into()),
        pairing: hap_crypto::AccessoryPairing {
            pairing_id: "AE:EC:86:C0:BF:D7".into(),
            ltpk: [0; 32],
        },
        verify_char: VERIFY_CHAR_UUID.into(),
        verify_iid: 1,
        pairings_char: PAIRINGS_CHAR_UUID.into(),
        pairings_iid: 2,
        broadcast_key: hap_crypto::BroadcastKey::from_bytes([0u8; 32]),
        initial_gsn: 0,
    };
    let h = BleAccessory::new(gatt.clone(), ctx, 512, &services, accessories);
    (h, gatt)
}