sdc_hci_cmd_le_add_device_to_filter_accept_list()

uint8_t sdc_hci_cmd_le_add_device_to_filter_accept_list

(

const sdc_hci_cmd_le_add_device_to_filter_accept_list_t *

p_params

)

#include <softdevice_controller/include/sdc_hci_cmd_le.h>

LE Add Device To Filter Accept List.

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

The HCI_LE_Add_Device_To_Filter_Accept_List command is used to add a single device to the Filter Accept List stored in the Controller.

This command shall not be used when: • any advertising filter policy uses the Filter Accept List and advertising is enabled, • the scanning filter policy uses the Filter Accept List and scanning is enabled, or • the initiator filter policy uses the Filter Accept List and an HCI_LE_Create_Connection or HCI_LE_Extended_Create_Connection command is pending.

When a Controller cannot add a device to the Filter Accept List because there is no space available, it shall return the error code Memory Capacity Exceeded (0x07).

If the device is already in the Filter Accept List, the Controller should not add the device to the Filter Accept List again and should return success.

Address shall be ignored when Address_Type is set to 0xFF.

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