sd_ble_gap_conn_param_update()

uint32_t sd_ble_gap_conn_param_update	(	uint16_t	conn_handle,
		ble_gap_conn_params_t const *	p_conn_params )

#include <ble_gap.h>

Update connection parameters.

In the central role this will initiate a Link Layer connection parameter update procedure. This function can be used as a central both to reply to a BLE_GAP_EVT_CONN_PARAM_UPDATE_REQUEST or to start the procedure unrequested.

In the peripheral role, this will send the corresponding L2CAP request and wait for the central to perform the procedure. Regardless of success or failure, the application will be informed of the result with a BLE_GAP_EVT_CONN_PARAM_UPDATE event.

Events generated

BLE_GAP_EVT_CONN_PARAM_UPDATE

Result of the connection parameter update procedure.

Relevant Message Sequence Charts

Peripheral Connection Parameter Update

Central Connection Parameter Update

Central Encryption and Authentication mutual exclusion

Parameters

[in]	conn_handle	Connection handle.
[in]	p_conn_params	Pointer to desired connection parameters. If NULL is provided on a peripheral role, the parameters in the PPCP characteristic of the GAP service will be used instead. This is only allowed if no field in the PPCP characteristic is set to "No specific values indication (0xFFFF)". If NULL is provided on a central role and in response to a BLE_GAP_EVT_CONN_PARAM_UPDATE_REQUEST, the peripheral request will be rejected.

Return values

NRF_SUCCESS	The Connection Update procedure has been started successfully.
NRF_ERROR_INVALID_ADDR	Invalid pointer supplied.
NRF_ERROR_INVALID_PARAM	Invalid parameter(s) supplied, check parameter limits and constraints.
NRF_ERROR_INVALID_STATE	Either: Disconnection in progress Link has not been established.
NRF_ERROR_BUSY	Procedure already in progress, wait for pending procedures to complete and retry.
BLE_ERROR_INVALID_CONN_HANDLE	Invalid connection handle supplied.