nrfxlib API 2.7.99
Loading...
Searching...
No Matches

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

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

If the Host issues this command when the local or remote 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).

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

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.

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