Struct Connection

pub struct Connection<'stack, P: PacketPool> { /* private fields */ }

Handle to a BLE connection.

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

Implementations

impl<'stack, P: PacketPool> Connection<'stack, P>

pub async fn next(&self) -> ConnectionEvent

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 peer_identity(&self) -> Identity

The peer identity key 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, P>, ) -> 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, P>, 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, P>, ) -> 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, P>, params: &ConnectParams, ) -> Result<(), BleHostError<T::Error>>

where T: ControllerCmdAsync<LeConnUpdate> + ControllerCmdSync<LeReadLocalSupportedFeatures>,

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, P, ATT_MAX, CCCD_MAX, CONN_MAX>, ) -> Result<GattConnection<'stack, 'server, P>, Error>

Transform BLE connection into a GattConnection

Trait Implementations

impl<P: PacketPool> Clone for Connection<'_, P>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P: PacketPool> Drop for Connection<'_, P>

fn drop(&mut self)

Executes the destructor for this type.