sdc_hci_cmd_le_cs_security_enable()

uint8_t sdc_hci_cmd_le_cs_security_enable

(

const sdc_hci_cmd_le_cs_security_enable_t *

p_params

)

#include <softdevice_controller/include/sdc_hci_cmd_le.h>

LE CS Security Enable.

The description below is extracted from Core_v6.0, Vol 4, Part E, Section 7.8.133

The HCI_LE_CS_Security_Enable command is used by a Host to start or restart the Channel Sounding Security Start procedure in the local Controller for the ACL connection identified by the Connection_Handle parameter.

If the Host issues this command on a Connection_Handle where the Controller is the Peripheral, then the Controller shall return the error code Command Disallowed (0x0C).

If the connection identified by the Connection_Handle parameter is not encrypted, then the Controller shall return the error code Insufficient Security (0x2F).

If the Host sends this command with a Connection_Handle that does not exist, or the Connection_Handle is not for an ACL, then the Controller shall return the error code Unknown Connection Identifier (0x02).

If the Host issues this command when the Channel Sounding (Host Support) feature bit (see [Vol 6] Part B, Section 4.6.33.4) is not set, then the Controller shall return the error code Command Disallowed (0x0C).

Event(s) generated (unless masked away): When the Controller receives the HCI_LE_CS_Security_Enable command, the Controller shall send the HCI_Command_Status event to the Host. When the Controller has completed the Channel Sounding Security Start procedure with the remote Controller, the Controller shall generate an LE_CS_Security_Enable_Complete event.

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.