◆ 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.3, Vol 4, Part E, Section 7.8.133

This 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.

Errors:

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

Type   Condition                                                        Error code
MC     Connection_Handle does not identify an ACL.                      Unknown Connection
                                                                        Identifier (0x02)
MC     Connection_Handle identifies an ACL where the Controller is      Command Disallowed
       the Peripheral.                                                  (0x0C)
MC     Connection_Handle identifies an unencrypted ACL.                 Insufficient Security
                                                                        (0x2F)
MC     The Channel Sounding (Host Support) feature bit (see [Vol 6]     Command Disallowed
       Part B, Section 4.6.33.4) is not set.                            (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.