burble 0.2.2

A cross-platform user-mode Bluetooth LE library
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

//! Generic Access Profile ([Vol 3] Part C).

use burble_const::{Characteristic, Service};
pub use burble_const::{Uuid, Uuid16, UuidType, UuidVec};
pub use {consts::*, response_data::*};

use crate::att::Access;
use crate::gatt::{Builder, Db};

mod consts;
mod response_data;

/// Generic Access Profile service.
#[derive(Clone, Debug, Default)]
#[non_exhaustive]
pub struct GapService {
    device_name: String,
    appearance: Appearance,
}

impl GapService {
    /// Creates a new GAP service.
    ///
    /// # Panics
    ///
    /// Panics if `device_name` is longer than 248 bytes.
    #[inline]
    pub fn new(device_name: impl Into<String>, appearance: Appearance) -> Self {
        let device_name = device_name.into();
        assert!(device_name.len() <= 248);
        Self {
            device_name,
            appearance,
        }
    }

    /// Defines the service structure.
    pub fn define(&self, db: &mut Builder<Db>) {
        db.primary_service(Service::GenericAccess, [], |db| {
            use Characteristic::*;
            db.ro_characteristic(DeviceName, Access::READ, &self.device_name, |_| {});
            db.ro_characteristic(
                Appearance,
                Access::READ,
                (self.appearance as u16).to_le_bytes(),
                |_| {},
            );
        });
    }
}