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

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

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.