nrfxlib API 2.8.99
Loading...
Searching...
No Matches

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

The HCI_LE_CS_Procedure_Enable 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.

If the Host issues this command to enable a CS configuration identified by the Config_ID parameter before a corresponding HCI_LE_CS_Set_Procedure_Parameters command has been issued for the same Config_ID, then the Controller shall return the error code Command Disallowed (0x0C).

If the CS configuration corresponding to Config_ID does not exist (or has been removed using the HCI_LE_CS_Remove_Config command), then the Controller shall return the error code Invalid HCI Command Parameters (0x12).

If the CS procedure parameters associated with the given Config_ID exceed any scheduling or coexistence constraints at the time this command is issued, then the Controller shall return the error code Connection Rejected Due to Limited Resources (0x0D).

If the Host issues this command to enable a CS configuration identified by the Config_ID parameter that is already enabled using the HCI_LE_CS_Procedure_Enable command, then the Controller shall return the error code Command Disallowed (0x0C).

If the number of channels available for Channel Sounding before the start of a new CS procedure measurement is less than 15, then the Controller shall return the error code Insufficient Channels (0x48).

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

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_paramsInput parameters.
Return values
0if 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.