◆ sdc_hci_cmd_le_add_device_to_resolving_list()

uint8_t sdc_hci_cmd_le_add_device_to_resolving_list ( const sdc_hci_cmd_le_add_device_to_resolving_list_t * p_params )

#include <softdevice_controller/include/sdc_hci_cmd_le.h>

LE Add Device To Resolving List.

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

This command is used to add one device to the resolving list used to generate and resolve Resolvable Private Addresses in the Controller.

This command shall not be used when address resolution is enabled in the Controller and:

• Advertising (other than periodic advertising) is enabled, • Scanning is enabled, or • an HCI_LE_Create_Connection, HCI_LE_Extended_Create_Connection, or HCI_LE_Periodic_Advertising_Create_Sync command is pending.

This command may be used at any time when address resolution is disabled in the Controller.

The added device shall be set to Network Privacy mode.

If an entry already exists in the resolving list with the same four parameter values, the Controller shall not add the device to the resolving list again.

Note: In this situation the command can either succeed or fail; the only difference is the returned status code.

Errors:

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

Type   Condition                                                              Error code
RC     Peer_Identity_Address_Type is 0x01 and Peer_Identity_Address is a      Invalid HCI
       non-static address.                                                    Command
                                                                              Parameters (0x12)
MC     There is no space available to add a device to the list.               Memory Capacity
                                                                              Exceeded (0x07)
RC     An entry with the same Peer_Identity_Address and                       Invalid HCI
       Peer_Identity_Address_Type, or with the same non-zero Peer_IRK,        Command
       already exists in the resolving list.                                  Parameters (0x12)
O      An entry with the same four parameter values already exists in the     Invalid HCI
       resolving list.                                                        Command
                                                                              Parameters (0x12)

Event(s) generated (unless masked away):

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