nrfxlib API 2.8.99
Loading...
Searching...
No Matches

◆ sdc_hci_cmd_le_cs_write_cached_remote_supported_capabilities()

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.

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

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

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 after an LL_CS_CAPABILITIES_REQ or LL_CS_CAPABILITIES_RSP PDU has been received from the remote Controller, then the Controller shall return the error code Command Disallowed (0x0C).

If the Host issues this command after a CS configuration has been created in the local Controller, then the Controller shall return the error code Command Disallowed (0x0C). 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).

If the Host sends this command with a Connection_Handle that does not exist, or the Connection_Handle is not for an ACL the Controller shall return the error code 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.

Parameters
[in]p_paramsInput 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.