◆ sdc_hci_cmd_le_cs_procedure_enable()

uint8_t sdc_hci_cmd_le_cs_procedure_enable ( const sdc_hci_cmd_le_cs_procedure_enable_t * p_params )

#include <softdevice_controller/include/sdc_hci_cmd_le.h>

LE CS Procedure Enable.

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

This command is used by a Host to enable or disable the scheduling of CS procedures by the local Controller, with the remote device for the 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     A corresponding HCI_LE_CS_Set_Procedure_Parameters command has     Command Disallowed
       not been issued for the same Config_ID.                            (0x0C)
MC     Config_ID does not identify a CS configuration.                    Invalid HCI Command
                                                                          Parameters (0x12)
MC     Config_ID identifies a CS configuration that has been removed.     Invalid HCI Command
                                                                          Parameters (0x12)
MC     The CS procedure parameters associated with Config_ID exceed any   Rejected Due To
       scheduling or coexistence constraints.                             Limited Resources
                                                                          (0x0D).
MC     The CS configuration identified by Config_ID is already enabled.   Command Disallowed
                                                                          (0x0C)
MC     The number of channels available for Channel Sounding before the   Insufficient Channels
       start of a new CS procedure measurement is less than 15.           (0x48)
MC     Connection_Handle does not identify an ACL.                        Unknown Connection
                                                                          Identifier (0x02)

Event(s) generated (unless masked away):

When the Controller receives the HCI_LE_CS_Procedure_Enable command, the Controller shall send the HCI_Command_Status event to the Host. When the locally initiated Channel Sounding Start procedure has completed or when the Controller has received the LL_CS_IND PDU, it shall generate an LE_CS_Procedure_Enable_Complete event. When the Host has issued a command to disable an active CS procedure, the Controller shall generate an LE_CS_Procedure_Enable_Complete event after any pending CS subevent results have been sent to the Host and the LL_CS_TERMINATE_RSP PDU has been successfully sent or received.

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.