Struct BluetoothDeviceList 

pub struct BluetoothDeviceList { /* private fields */ }

Bluetooth device list structure

This structure represents a list of up to 10 Bluetooth devices, including their configuration and connection status. It’s used for managing multiple Bluetooth devices in embedded systems.

Memory Layout

The structure uses #[repr(C)] to ensure predictable memory layout, making it suitable for serialization and inter-process communication.

Security Note

This structure may store sensitive pairing data. Ensure proper memory protection and secure storage mechanisms when persisting this data.

Fields

• magic: Structure validation (0x42544C53)
• devices: Array of up to 10 device configurations
• device_count: Number of valid devices in the list
• _padding: Ensures 4-byte alignment

Errors

• Error::DeviceListFull if adding more than 10 devices
• Error::IndexOutOfBounds for invalid indices

Examples

use renik::{BluetoothDeviceInfo, BluetoothDeviceList};

let mac_addr1 = [0x12, 0x34, 0x56, 0x78, 0x9A, 0xBC];
let mac_addr2 = [0x98, 0x76, 0x54, 0x32, 0x10, 0xFE];
let device1 = BluetoothDeviceInfo::new(&mac_addr1, b"Device 1").unwrap();
let device2 = BluetoothDeviceInfo::new(&mac_addr2, b"Device 2").unwrap();
let mut device_list = BluetoothDeviceList::default();
device_list.add_device(device1).unwrap();
device_list.add_device(device2).unwrap();
assert_eq!(device_list.len(), 2);

Implementations

impl BluetoothDeviceList

pub fn add_device( &mut self, device_config: BluetoothDeviceInfo, ) -> Result<(), Error>

Adds a Bluetooth device configuration to the list

Parameters

• device_config: Bluetooth device configuration

Returns

• Ok(()) if the device was added successfully
• Err(Error) if the device list is full

Errors

Returns Error::DeviceListFull if the device list is already at maximum capacity.

pub fn remove_device(&mut self, index: usize) -> Result<(), Error>

Removes a Bluetooth device configuration from the list

Parameters

• index: Index of the device to remove (0-based)

Returns

• Ok(()) if the device was removed successfully
• Err(Error) if the index is out of bounds

Errors

Returns Error::IndexOutOfBounds if the specified index is not valid.

pub fn device(&self, index: usize) -> Result<&BluetoothDeviceInfo, Error>

Returns a reference to a Bluetooth device configuration

Parameters

• index: Index of the device to retrieve (0-based)

Returns

• Ok(&BluetoothDeviceInfo) if the index is valid
• Err(Error) if the index is out of bounds

Errors

Returns Error::IndexOutOfBounds if the specified index is not valid.

pub fn len(&self) -> usize

Returns the number of devices in the list

Returns

The current device count

pub fn is_empty(&self) -> bool

Checks if the device list is empty

Returns

• true if there are no devices in the list
• false otherwise

Trait Implementations

impl Clone for BluetoothDeviceList

fn clone(&self) -> BluetoothDeviceList

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BluetoothDeviceList

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BluetoothDeviceList

fn default() -> Self

Creates a new Bluetooth device list with default values

The structure is initialized with the correct magic number and an empty device list.

impl Zeroable for BluetoothDeviceList

fn zeroed() -> Self

Calls zeroed.

impl Copy for BluetoothDeviceList

impl Pod for BluetoothDeviceList