Struct BleController 

pub struct BleController { /* private fields */ }

A BLE HAP controller: holds the long-term controller identity used for pairing and verification.

Implementations

impl BleController

pub fn new(keypair: ControllerKeypair) -> Self

Create a controller from a long-term identity.

pub fn generate(id: String) -> Self

Generate a fresh controller identity with the given pairing id.

pub fn keypair(&self) -> &ControllerKeypair

The controller’s pairing identity.

pub async fn pair( &self, gatt: Arc<dyn GattConnection>, _accessory: &DiscoveredBleAccessory, setup_code: &str, ) -> Result<Paired>

Pair with a discovered accessory: run Pair Setup, then Pair Verify, then build the attribute database. Returns a Paired containing the ready accessory handle, the persisted AccessoryPairing, and initial broadcast material.

Errors

Propagates connection, pairing, and model errors.

pub async fn connect( &self, gatt: Arc<dyn GattConnection>, pairing: &AccessoryPairing, broadcast: Option<BleBroadcastState>, ) -> Result<BleAccessory>

Connect to an already-paired accessory via Pair Verify, then build the DB.

broadcast is optional previously-persisted broadcast state. Its gsn seeds last_gsn so the accessory handle does not re-emit already-seen events after a restart. The key in broadcast is the previously-persisted one — Pair Verify derives a fresh per-session broadcast key, which becomes the accessory’s current key.

NOTE

Decrypting pre-connect broadcasts with the persisted key (vs the fresh per-session key derived here) is a documented follow-up task — the fresh key covers forward broadcasts.

Errors

Propagates connection, verify, and model errors.