Struct nrf_softdevice::ble::Connection

pub struct Connection { /* private fields */ }

Implementations

impl Connection

pub fn role(&self) -> Role

pub fn peer_address(&self) -> Address

pub fn disconnect(&self) -> Result<(), DisconnectedError>

pub fn handle(&self) -> Option<u16>

pub fn from_handle(conn_handle: u16) -> Option<Connection>

pub fn start_rssi(&self)

Start measuring RSSI on this connection.

pub fn rssi(&self) -> Option<i8>

Get the connection’s RSSI.

This will return None if start_rssi has not been called yet, or if no measurement has been done yet.

pub fn conn_params(&self) -> ble_gap_conn_params_t

Get the currently active connection params.

pub fn att_mtu(&self) -> u16

Get the currently active ATT MTU.

pub fn security_mode(&self) -> SecurityMode

pub fn security_handler(&self) -> Option<&dyn SecurityHandler>

pub fn set_conn_params(
&self,
conn_params: ble_gap_conn_params_t
) -> Result<(), SetConnParamsError>

Set the connection params.

Note that this just initiates the connection param change, it does not wait for completion. Immediately after return, the active params will still be the old ones, and after some time they should change to the new ones.

For central connections, this will initiate a Link Layer connection parameter update procedure. For peripheral connections, this will send the corresponding L2CAP request to the central. It is then up to the central to accept or deny the request.

pub fn ignore_slave_latency(
&mut self,
ignore: bool
) -> Result<(), IgnoreSlaveLatencyError>

Temporarily ignore slave latency for peripehral connections.

“Slave latency” is a setting in the conn params that allows the peripheral to intentionally sleep through and miss up to N connection events if it doesn’t have any data to send to the central.

Slave latency is useful because it can yield the same power savings on the peripheral as increasing the conn interval, but it only impacts latency in the central->peripheral direction, not both.

However, in some cases, if the peripheral knows the central will send it some data soon it might be useful to temporarily force ignoring the slave latency setting, ie waking up at every single conn interval, to lower the latency.

This only works on peripheral connections.

pub fn iter() -> ConnectionIter

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.

impl Hash for Connection

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
H: Hasher,
Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Connection

fn cmp(&self, other: &Connection) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere
Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere
Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere
Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl PartialEq<Connection> for Connection

fn eq(&self, other: &Connection) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd<Connection> for Connection

fn partial_cmp(&self, other: &Connection) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for Connection

impl StructuralEq for Connection

impl StructuralPartialEq for Connection