ble-peripheral-rust 0.2.0

A cross-platform Rust crate for building Bluetooth Low Energy peripherals
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

mod characteristic_utils;
pub mod error;
mod mac_extensions;
mod mac_utils;
pub mod peripheral_delegate;
mod peripheral_manager;

use crate::{
    error::{Error, ErrorType},
    gatt::{peripheral_event::PeripheralEvent, service::Service},
};
use async_trait::async_trait;
use peripheral_manager::{is_authorized, run_peripheral_thread, ManagerEvent};
use tokio::sync::{mpsc::Sender, oneshot};
use uuid::Uuid;

use super::PeripheralImpl;

pub struct Peripheral {
    manager_tx: Sender<ManagerEvent>,
}

#[async_trait]
impl PeripheralImpl for Peripheral {
    type Peripheral = Self;

    async fn new(sender_tx: Sender<PeripheralEvent>) -> Result<Self, Error> {
        if !is_authorized() {
            return Err(Error::from_type(ErrorType::PermissionDenied));
        }
        let (manager_tx, manager_rx) = tokio::sync::mpsc::channel(256);
        run_peripheral_thread(sender_tx, manager_rx);
        Ok(Peripheral { manager_tx })
    }

    async fn is_powered(&mut self) -> Result<bool, Error> {
        let (responder, responder_rx) = oneshot::channel();
        self.manager_tx
            .send(ManagerEvent::IsPowered { responder })
            .await?;
        return responder_rx.await?;
    }

    async fn is_advertising(&mut self) -> Result<bool, Error> {
        let (responder, responder_rx) = oneshot::channel();
        self.manager_tx
            .send(ManagerEvent::IsAdvertising { responder })
            .await?;
        return responder_rx.await?;
    }

    async fn start_advertising(&mut self, name: &str, uuids: &[Uuid]) -> Result<(), Error> {
        let (responder, responder_rx) = oneshot::channel();
        self.manager_tx
            .send(ManagerEvent::StartAdvertising {
                name: name.to_string(),
                uuids: uuids.to_vec(),
                responder,
            })
            .await?;
        return responder_rx.await?;
    }

    async fn stop_advertising(&mut self) -> Result<(), Error> {
        let (responder, responder_rx) = oneshot::channel();
        self.manager_tx
            .send(ManagerEvent::StopAdvertising { responder })
            .await?;
        return responder_rx.await?;
    }

    async fn add_service(&mut self, service: &Service) -> Result<(), Error> {
        let (responder, responder_rx) = oneshot::channel();
        self.manager_tx
            .send(ManagerEvent::AddService {
                service: service.clone(),
                responder,
            })
            .await?;
        return responder_rx.await?;
    }

    async fn update_characteristic(
        &mut self,
        characteristic: Uuid,
        value: Vec<u8>,
    ) -> Result<(), Error> {
        let (responder, responder_rx) = oneshot::channel();
        self.manager_tx
            .send(ManagerEvent::UpdateCharacteristic {
                characteristic,
                value,
                responder,
            })
            .await?;
        return responder_rx.await?;
    }
}