blew 0.2.0-alpha.2

Cross-platform async BLE library for Rust (Apple, Linux, Android)
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

//! Shared helpers for Apple platform backends.

use objc2::rc::Retained;
use objc2_core_bluetooth::CBUUID;
use objc2_foundation::NSString;
use uuid::Uuid;

use crate::types::DeviceId;

/// Wraps `Retained<T>` to assert `Send + Sync`.
///
/// # Safety
/// CoreBluetooth is documented thread-safe on macOS 10.15+ / iOS 13+.
pub(crate) struct ObjcSend<T: objc2::Message>(pub(crate) Retained<T>);

// SAFETY: CoreBluetooth is thread-safe on macOS 10.15+ / iOS 13+.
unsafe impl<T: objc2::Message> Send for ObjcSend<T> {}
unsafe impl<T: objc2::Message> Sync for ObjcSend<T> {}

impl<T: objc2::Message> std::ops::Deref for ObjcSend<T> {
    type Target = T;
    fn deref(&self) -> &T {
        &self.0
    }
}

/// Retain an ObjC reference, wrapping in `ObjcSend`.
///
/// # Safety
/// The pointer must be non-null and point to a valid ObjC object.
pub(crate) unsafe fn retain_send<T: objc2::Message>(obj: &T) -> ObjcSend<T> {
    ObjcSend(unsafe { Retained::retain(std::ptr::from_ref::<T>(obj).cast_mut()).expect("retain") })
}

pub(crate) fn uuid_to_cbuuid(uuid: Uuid) -> Retained<CBUUID> {
    unsafe { CBUUID::UUIDWithString(&NSString::from_str(&uuid.to_string())) }
}

pub(crate) fn cbuuid_to_uuid(cb: &CBUUID) -> Option<Uuid> {
    unsafe { cb.UUIDString() }.to_string().parse().ok()
}

pub(crate) fn peripheral_device_id(p: &objc2_core_bluetooth::CBPeripheral) -> DeviceId {
    DeviceId(unsafe { p.identifier().UUIDString() }.to_string())
}

pub(crate) fn central_device_id(c: &objc2_core_bluetooth::CBCentral) -> DeviceId {
    DeviceId(unsafe { c.identifier().UUIDString() }.to_string())
}