 |
nrfxlib API 3.3.99
|
|
nrfxlib API 3.3.99
|
| uint8_t sdc_hci_cmd_le_cs_write_cached_remote_supported_capabilities | ( | const sdc_hci_cmd_le_cs_write_cached_remote_supported_capabilities_t * | p_params, |
| sdc_hci_cmd_le_cs_write_cached_remote_supported_capabilities_return_t * | p_return ) |
#include <softdevice_controller/include/sdc_hci_cmd_le.h>
LE CS Write Cached Remote Supported Capabilities [v1].
The description below is extracted from Core_v6.3, Vol 4, Part E, Section 7.8.132
This command allows a Host to write the cached copy of the CS capabilities that are supported by the remote Controller for the connection identified by the Connection_Handle parameter.
The Num_Config_Supported parameter indicates the number of CS configurations that are supported per connection by the remote Controller.
The Max_Consecutive_Procedures_Supported parameter indicates the maximum number of consecutive CS procedures that are supported by the remote 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 remote Controller.
The Modes_Supported parameter indicates the optional CS modes that are supported by the remote 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 remote 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 remote 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 remote 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 An LL_CS_CAPABILITIES_REQ or LL_CS_CAPABILITIES_RSP PDU has Command Disallowed
been received from the remote Controller. (0x0C)
MC A CS configuration has been created in the local Controller. Command Disallowed
(0x0C)
MC The Channel Sounding (Host Support) feature bit (see [Vol 6] Command Disallowed
Part B, Section 4.6.33.4) is not set. (0x0C)
MC Connection_Handle does not identify an ACL. Unknown Connection
Identifier (0x02)
Event(s) generated (unless masked away):
When the HCI_LE_CS_Write_Cached_Remote_Supported_Capabilities command has completed, an HCI_Command_Complete event shall be generated.
| [in] | p_params | Input parameters. |
| [out] | p_return | Extra return parameters. |
| 0 | if success. |
1.12.0