Struct riot_wrappers::bluetil::Ad

pub struct Ad<B: AsRef<[u8]>>(/* private fields */);

Available on riot_module_bluetil_ad only.

Wrapper around bluetil_ad (BLE Advertising Data)

This is implemented as a possibly owned buffer, as that should make usage straightforward both for read-only data (not practically usable yet) and for writing; it remains to be seen whether that’s viable.

Implementations

impl<B: AsRef<[u8]>> Ad<B>

pub fn destroy(self) -> B

Reclaim the buffer that the AD was built around.

This is particularly useful when an AD object was populated, and in the end the buffer needs to be obtained in order to send it.

impl<const L: usize> Ad<Vec<u8, L>>

pub fn new() -> Self

Create an empty AD object around owned memory; the size is given by the type parameter.

pub fn add_flags(&mut self, flags: u32) -> Result<(), Error>

Add a “flags” field with the given flag value to the AD (convenience function)

pub fn add(&mut self, type_: u32, data: &[u8]) -> Result<(), Error>

Add an arbitrary typed field to the AD

impl Ad<Vec<u8, 31>>

pub fn new_maximal() -> Self

Create an empty AD object around owned memory with the maximum sendable size.

This is often more convenient than new as it’s not too large anyway (31 bytes).