sdc_hci_cmd_vs_set_conn_event_trigger()

uint8_t sdc_hci_cmd_vs_set_conn_event_trigger

(

const sdc_hci_cmd_vs_set_conn_event_trigger_t *

p_params

)

#include <softdevice_controller/include/sdc_hci_vs.h>

Set Connection Event Trigger.

Start triggering a given task on radio event start.

When enabled, this feature will trigger a (D)PPI task at the start of radio events.

When used for connections, the connection event trigger can be configured to trigger every N connection events starting from a given connection event counter.

Disabling scanning, removing the advertising set, or disconnecting the connection will reset the connection event trigger configuration.

If the selected (D)PPI channel is reserved by the controller, the controller will return the error code Invalid HCI Command Parameters (0x12).

If enabling/disabling the connection event trigger and the trigger is already enabled/disabled, the controller will return the error code Command Disallowed (0x0C).

If the role is 0x1, 0x2, or 0x4, and the role is not currently active, the controller will return the error code Command Disallowed (0x0C).

If the role is 0x3 and conn_handle does not refer to an active connection, the controller will return the error code Unknown Connection Identifier (0x02).

If the role is 0x4 and legacy advertising is used, conn_handle must be set to 0. If extended advertising is used, conn_handle must refer to an active advertising set. Otherwise, the controller will return the error code Unknown Advertising Identifier (0x42).

If the role is 0x3 and conn_evt_counter_start has already passed, the controller will return the error code Command Disallowed (0x0C).

If the role is 0x3 and period_in_events is zero, the controller will return the error code Invalid HCI Command Parameters (0x12).

If the role is 0x1, 0x2, or 0x4 and conn_evt_counter_start or period_in_events is non-zero, the controller will return the error code Invalid HCI Command Parameters (0x12).

After HCI Reset, this feature is disabled.

Event(s) generated (unless masked away): When the command has completed, an HCI_Command_Complete event shall be generated.

Parameters

[in]

p_params

Input parameters.

Return values

0	if success.

Returns

Returns value between 0x01-0xFF in case of error. See Vol 2, Part D, Error for a list of error codes and descriptions.