sd_ble_gap_evt_trigger_set()

uint32_t sd_ble_gap_evt_trigger_set	(	uint8_t	role,
		uint16_t	handle,
		uint32_t	task_address )

#include <ble_gap.h>

Configure triggering a peripheral task register on the start of a Bluetooth Link Layer event.

When enabled, this feature will trigger the specified peripheral task register right before the first radio activity of a timing-event.

Parameters

[in]	role	The role to start the event trigger for. The following roles are supported on this SoftDevice: BLE_GAP_LL_ROLE_CONN BLE_GAP_LL_ROLE_SCAN BLE_GAP_LL_ROLE_INIT BLE_GAP_LL_ROLE_ADV
[in]	handle	The handle parameter is interpreted depending on role: If role is BLE_GAP_LL_ROLE_CONN, this value is the specific connection handle. If role is BLE_GAP_LL_ROLE_ADV, this value is the advertising handle. For all other roles, handle is ignored.
[in]	task_address	Task to trigger. Set to 0 to stop a previously configured trigger.

Return values

NRF_SUCCESS	Success.
BLE_ERROR_INVALID_CONN_HANDLE	Invalid connection handle supplied.
BLE_ERROR_INVALID_ADV_HANDLE	Invalid advertising handle supplied.
NRF_ERROR_INVALID_PARAM	Invalid parameter supplied.
NRF_ERROR_INVALID_STATE	Trying to start event triggering when it is already ongoing.