nrf-softdevice-s122

Crates

git

Versions

default

Flavors

pub unsafe fn sd_ble_gap_evt_trigger_start(
role: u8,
handle: u16,
p_params: *const ble_gap_event_trigger_t
) -> u32
Expand description

@brief Start triggering a given task on the start of a Bluetooth Link Layer event.

@details When enabled, this feature will trigger a PPI task at the start of Bluetooth Link Layer events.

@param[in] role The role to start the event trigger for. The following roles are supported on this SoftDevice: - @ref BLE_GAP_LL_ROLE_CONN - @ref BLE_GAP_LL_ROLE_SCAN - @ref BLE_GAP_LL_ROLE_INIT @param[in] handle The handle parameter is interpreted depending on role: - If role is @ref BLE_GAP_LL_ROLE_CONN, this value is the specific connection handle. - For all other roles, handle is ignored. @param[in] p_params Event trigger parameters.

@retval ::NRF_SUCCESS Success. @retval ::BLE_ERROR_INVALID_CONN_HANDLE Invalid connection handle supplied. @retval ::NRF_ERROR_INVALID_ADDR Invalid pointer supplied. @retval ::NRF_ERROR_INVALID_PARAM Invalid parameter supplied. See @ref ble_gap_event_trigger_t. @retval ::NRF_ERROR_INVALID_STATE Either: - Trying to start event triggering when it is already ongoing. - @ref ble_gap_event_trigger_t::conn_evt_counter_start is in the past. Use @ref sd_ble_gap_next_conn_evt_counter_get to find a new value to be used as ble_gap_event_trigger_t::conn_evt_counter_start. - Trying to start the event triggering for @ref BLE_GAP_LL_ROLE_SCAN or @ref BLE_GAP_LL_ROLE_INIT when the corresponding LL role is not active.