◆ sdc_hci_cmd_le_cs_read_remote_supported_capabilities()

uint8_t sdc_hci_cmd_le_cs_read_remote_supported_capabilities ( const sdc_hci_cmd_le_cs_read_remote_supported_capabilities_t * p_params )

#include <softdevice_controller/include/sdc_hci_cmd_le.h>

LE CS Read Remote Supported Capabilities.

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

This command allows a Host to query the CS capabilities that are supported by the remote Controller. If no Channel Sounding Capability Exchange procedure has been initiated on the ACL connection specified by the Connection_Handle and if no prior HCI_LE_CS_Write_Cached_Remote_Supported_Capabilities command has been issued by the Host, then the Controller shall initiate a Channel Sounding Capabilities Exchange procedure on the ACL. Otherwise, the Controller may use a cached copy of the capabilities of the remote device.

If this command is issued on the Central or Peripheral before the devices have performed the Feature Exchange procedure, then the Controller of the Central or Peripheral shall complete that procedure before initiating the Channel Sounding Capability Exchange procedure (see [Vol 6] Part B, Section 5.1.24).

The Host may store a copy of the remote device’s capabilities and write the remote capabilities in the local Controller when it reconnects to the same remote device by using the HCI_LE_CS_Write_Cached_Remote_Supported_Capabilities command.

Errors:

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

Type   Condition                                                           Error code
MC     The local or remote Channel Sounding (Host Support) feature bit     Command Disallowed
       (see [Vol 6] Part B, Section 4.6.33.4) is not set.                  (0x0C)
MC     Connection_Handle does not exist or is not for an ACL.              Unknown Connection
                                                                           Identifier (0x02)

Event(s) generated (unless masked away):

When the Controller receives the HCI_LE_CS_Read_Remote_Supported_Capabilities command, the Controller shall send the HCI_Command_Status event to the Host. When the Controller has completed the Channel Sounding Capability Exchange procedure with the remote Controller or has a cached copy of the capabilities of the remote Controller, the Controller shall generate an HCI_LE_CS_Read_Remote_Supported_Capabilities_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.