◆ sdc_hci_cmd_le_set_adv_set_random_address()

uint8_t sdc_hci_cmd_le_set_adv_set_random_address ( const sdc_hci_cmd_le_set_adv_set_random_address_t * p_params )

#include <softdevice_controller/include/sdc_hci_cmd_le.h>

LE Set Advertising Set Random Address.

The description below is extracted from Core_v6.3, Vol 4, Part E, Section 7.8.52

This command is used by the Host to set the random device address specified by the Random_Address parameter. This address is used in the Controller (see [Vol 6] Part B, Section 1.3.2 ) for the advertiser's address contained in the advertising PDUs for the advertising set specified by the Advertising_Handle parameter.

This command may be issued at any time after an advertising set identified by the Advertising_Handle parameter has been created using the HCI_LE_Set_Extended_Advertising_Parameters command (see Section 7.8.53).

If this command is used to change the address, the new random address shall take effect for advertising no later than the next successful HCI_LE_Set_Extended_Advertising_Enable command and for periodic advertising no later than the next successful HCI_LE_Periodic_Advertising_Enable command.

Errors:

See Section 4.5.2 for a list of error types and descriptions.

Type   Condition                                                               Error code
MC     Advertising_Handle identifies an advertising set that is enabled and    Command
       is using connectable advertising.                                       Disallowed
                                                                               (0x0C)

Event(s) generated (unless masked away):

When the HCI_LE_Set_Advertising_Set_Random_Address 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.