ble_gap_opt_local_conn_latency_t

S140 SoftDevice v6.1.1 API

Local connection latency option. More...

#include <ble_gap.h>

Data Fields

uint16_t conn_handle
uint16_t requested_latency
uint16_t * p_actual_latency

Detailed Description

Local connection latency option.

Local connection latency is a feature which enables the slave to improve current consumption by ignoring the slave latency set by the peer. The local connection latency can only be set to a multiple of the slave latency, and cannot be longer than half of the supervision timeout.

Used with sd_ble_opt_set to set the local connection latency. The sd_ble_opt_get is not supported for this option, but the actual local connection latency (unless set to NULL) is set as a return parameter when setting the option.

Note
The latency set will be truncated down to the closest slave latency event multiple, or the nearest multiple before half of the supervision timeout.
The local connection latency is disabled by default, and needs to be enabled for new connections and whenever the connection is updated.
Return values
NRF_SUCCESS Set successfully.
NRF_ERROR_NOT_SUPPORTED Get is not supported.
BLE_ERROR_INVALID_CONN_HANDLE Invalid connection handle parameter.

Field Documentation

uint16_t ble_gap_opt_local_conn_latency_t::conn_handle

Connection Handle

uint16_t* ble_gap_opt_local_conn_latency_t::p_actual_latency

Pointer to storage for the actual local connection latency (can be set to NULL to skip return value).

uint16_t ble_gap_opt_local_conn_latency_t::requested_latency

Requested local connection latency.