 |
nrfxlib API 3.3.99
|
|
nrfxlib API 3.3.99
|
| 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 [v1].
The description below is extracted from Core_v6.3, Vol 4, Part E, Section 7.8.130
This 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 per connection 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_Antennae_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_2M_AA_Only_N, RTT_Sounding_N, RTT_2M_Sounding_N, RTT_Random_Sequence_N, and RTT_2M_Random_Sequence_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. • IPT in the CS reflector as described in [Vol 6] Part H, Section 4.3.3. • RTT_PHY support denoting the setting of the RTT accuracy requirements for optional LE 2M and LE 2M 2BT PHYs separate from the RTT accuracy requirements for the mandatory LE 1M PHY as described in [Vol 6] Part B, Section 2.4.2.44. This bit shall only be set to 1 if [v2] or above of this command is being used.
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 for the CS_SYNC packets used in mode-1 and mode-3 steps as described in [Vol 6] Part A, Section 3.1.3.
The T_IP2_IPT_Times_Supported and T_SW_IPT_Times_Supported parameters indicate the supported optional time durations used in CS steps if the CS reflector supports the Channel Sounding Enhancement #1 feature and the IPT capability (see [Vol 6] Part H, Section 4.3).
Errors:
See Section 4.5.2 for a list of error types and descriptions.
Type Condition Error code
MC The local Channel Sounding (Host Support) feature bit (see [Vol 6] Command
Part B, Section 4.6.33.4) is not set. 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.
| [out] | p_return | Extra return parameters. |
| 0 | if success. |
1.12.0