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

◆ sdc_hci_cmd_le_cs_read_local_supported_capabilities()

uint8_t sdc_hci_cmd_le_cs_read_local_supported_capabilities ( sdc_hci_cmd_le_cs_read_local_supported_capabilities_return_t p_return)

#include <softdevice_controller/include/sdc_hci_cmd_le.h>

LE CS Read Local Supported Capabilities.

The description below is extracted from Core_v6.0, Vol 4, Part E, Section 7.8.130

The HCI_LE_CS_Read_Local_Supported_Capabilities command allows a Host to read the CS capabilities that are supported by the local Controller. This command may be used along with the local supported features to provide additional details of the supported CS capabilities.

The Num_Config_Supported parameter indicates the number of CS configurations that are supported by the Controller.

The Max_Consecutive_Procedures_Supported parameter indicates the maximum number of consecutive CS procedures that are supported by the local Controller.

The Num_Antennas_Supported parameter indicates the number of antenna elements that are available for CS tone exchanges. The Max_Antenna_Paths_Supported parameter indicates the maximum number of antenna paths that are supported by the local Controller for CS tone exchanges.

The Roles_Supported parameter indicates the CS roles that are supported by the local Controller.

The Modes_Supported parameter indicates the optional CS modes that are supported by the local Controller.

The RTT_Capability, RTT_AA_Only_N, RTT_Sounding_N, and the RTT_Random_- Payload_N parameters indicate the time-of-flight accuracy as described in [Vol 6] Part B, Section 2.4.2.44.

The NADM_Sounding_Capability and NADM_Random_Capability parameters indicate the support by the local Controller for reporting Normalized Attack Detector Metric (NADM) when a CS_SYNC with a sounding sequence or random sequence is received.

The CS_SYNC_PHYs_Supported parameter indicates the optional transmit and receive PHYs that are supported by the local Controller for CS_SYNC exchanges as described in [Vol 6] Part H, Section 4.3.

The Subfeatures_Supported parameter indicates which of the following optional subfeatures are supported by the local Controller:

• A Frequency Actuation Error of zero for all allowed CS channels relative to mode-0 transmissions when in the reflector role as described in [Vol 6] Part A, Section 3.5. • Channel Selection Algorithm #3c as described in [Vol 6] Part H, Section 4.1.4.2. • Phase-based ranging from a sounding sequence as described in [Vol 6] Part H, Section 3.3.1.

The T_IP1_Times_Supported, T_IP2_Times_Supported, T_FCS_Times_Supported, T_PM_Times_Supported, and T_SW_Time_Supported parameters indicate the supported optional time durations used in CS steps as described in [Vol 6] Part H, Section 4.3.

The TX_SNR_Capability parameter indicates the supported SNR levels used in RTT packets as described in [Vol 6] Part A, Section 3.1.3.

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

Event(s) generated (unless masked away): When the HCI_LE_CS_Read_Local_Supported_Capabilities command has completed, an HCI_Command_Complete event shall be generated.

Parameters
[out]p_returnExtra return 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.