| S130 SoftDevice v2.0.1 |

Choose documentation: | nRF5 SDK | S130 SoftDevice API | S132 SoftDevice API | S212 SoftDevice API | S332 SoftDevice API

All Data Structures Functions Variables Typedefs Enumerations Enumerator Groups Pages
Data Fields
ble_gap_opt_local_conn_latency_t Struct Reference
Structures

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 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.