nRF51 SDK - S110 SoftDevice
 All Data Structures Functions Variables Typedefs Enumerations Enumerator Groups Pages
ble_gap_opt_local_conn_latency_t Struct Reference

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 @ref sd_ble_opt_set to set the local connection latency. The
    @ref 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 default off, and needs to be set for new connections and whenever the connection is updated.
Return values
NRF_SUCCESSSet successfully.
NRF_ERROR_NOT_SUPPORTEDGet is not supported.
BLE_ERROR_INVALID_CONN_HANDLEInvalid 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.