Struct Connection

pub struct Connection<'stack> { /* private fields */ }

Handle to a BLE connection.

When the last reference to a connection is dropped, the connection is automatically disconnected.

Implementations

impl<'stack> Connection<'stack>

pub async fn next(&self) -> ConnectionEvent<'stack>

Wait for next connection event.

pub fn is_connected(&self) -> bool

Check if still connected

pub fn handle(&self) -> ConnHandle

Connection handle of this connection.

pub fn att_mtu(&self) -> u16

Expose the att_mtu.

pub fn role(&self) -> LeConnRole

The connection role for this connection.

pub fn peer_address(&self) -> BdAddr

The peer address for this connection.

pub fn encrypted(&self) -> bool

Get the encrypted state of the connection

pub fn disconnect(&self)

Request connection to be disconnected.

pub async fn rssi<T>( &self, stack: &Stack<'_, T>, ) -> Result<i8, BleHostError<T::Error>>

where T: ControllerCmdSync<ReadRssi>,

The RSSI value for this connection.

pub async fn set_phy<T>( &self, stack: &Stack<'_, T>, phy: PhyKind, ) -> Result<(), BleHostError<T::Error>>

where T: ControllerCmdAsync<LeSetPhy>,

Update phy for this connection.

This updates both TX and RX phy of the connection. For more fine grained control, use the LeSetPhy HCI command directly.

pub async fn read_phy<T>( &self, stack: &Stack<'_, T>, ) -> Result<(PhyKind, PhyKind), BleHostError<T::Error>>

where T: ControllerCmdSync<LeReadPhy>,

Read the current phy used for the connection.

pub async fn update_connection_params<T>( &self, stack: &Stack<'_, T>, params: &ConnectParams, ) -> Result<(), BleHostError<T::Error>>

where T: ControllerCmdAsync<LeConnUpdate>,

Update connection parameters for this connection.

pub fn with_attribute_server<'values, 'server, M: RawMutex, const ATT_MAX: usize, const CCCD_MAX: usize, const CONN_MAX: usize>( self, server: &'server AttributeServer<'values, M, ATT_MAX, CCCD_MAX, CONN_MAX>, ) -> Result<GattConnection<'stack, 'server>, Error>

Transform BLE connection into a GattConnection

Trait Implementations

impl Clone for Connection<'_>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Drop for Connection<'_>

fn drop(&mut self)

Executes the destructor for this type.