sdc_hci_cmd_le_set_data_related_address_changes()

uint8_t sdc_hci_cmd_le_set_data_related_address_changes

(

const sdc_hci_cmd_le_set_data_related_address_changes_t *

p_params

)

#include <softdevice_controller/include/sdc_hci_cmd_le.h>

LE Set Data Related Address Changes.

The description below is extracted from Core_v5.4, Vol 4, Part E, Section 7.8.122

The HCI_LE_Set_Data_Related_Address_Changes command specifies circumstances when the Controller shall refresh any Resolvable Private Address used by the advertising set identified by the Advertising_Handle parameter, whether or not the address timeout period has been reached. This command may be used while advertising is enabled.

The Change_Reasons parameter specifies the reason(s) for refreshing addresses. The default when an advertising set is created, or if legacy advertising commands (see Section 3.1.1) are used, is for all bits to be clear.

If extended advertising commands (see Section 3.1.1) are being used and the advertising set corresponding to the Advertising_Handle parameter does not exist, or if no command specified in Table 3.2 has been used, then the Controller shall return the error code Unknown Advertising Identifier (0x42).

If legacy advertising commands are being used, the Controller shall ignore the Advertising_Handle parameter.

Event(s) generated (unless masked away): When the HCI_LE_Set_Data_Related_Address_Changes 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.