◆ sdc_hci_cmd_le_receiver_test_v3()

uint8_t sdc_hci_cmd_le_receiver_test_v3 ( const sdc_hci_cmd_le_receiver_test_v3_t * p_params )

#include <softdevice_controller/include/sdc_hci_cmd_le.h>

LE Receiver Test [v3].

The description below is extracted from Core_v6.3, Vol 4, Part E, Section 7.8.28

This command is used to start a test where the IUT receives test reference packets at a fixed interval. The Lower Tester generates the test reference packets.

The RX_Channel and PHY parameters specify the RF channel and PHY to be used by the receiver.

The Modulation_Index parameter specifies whether or not the Controller should assume the receiver has a stable modulation index.

The Expected_CTE_Length and Expected_CTE_Type parameters specify the expected length and type of the Constant Tone Extensions in received test reference packets. When receiving on a PHY that allows Constant Tone Extensions, if the Constant Tone Extension in a received test reference packet does not match both of these, the IUT shall discard that packet.

Slot_Durations, Switching_Pattern_Length, and Antenna_IDs[i] are only used when expecting an AoA Constant Tone Extension and shall be ignored when expecting an AoD Constant Tone Extension. Missing parameters:

When a version of this command is issued that does not include all the parameters, the following values shall be used for any missing parameters:

Parameter Value PHY 0x01 Modulation_Index 0x00 Expected_CTE_Length 0x00 Expected_CTE_Type any valid value Slot_Durations any valid value Switching_Pattern_Length any valid value Antenna_IDs[i] any valid value

Errors:

See Section 4.5.2 for a list of error types and descriptions.

Type   Condition                                                                Error code
MC     PHY contains a bit for a PHY that the Controller does not support or     Unsupported
       is reserved for future use.                                              Feature or
                                                                                Parameter Value
                                                                                (0x11)
MC     Expected_CTE_Length is non-zero and PHY contains a bit for a PHY that    Command
       does not support CTEs.                                                   Disallowed
                                                                                (0x0C)
MC     Slot_Durations is set to 0x01 and the Controller does not support 1 μs   Unsupported
       switching and sampling.                                                  Feature or
                                                                                Parameter Value
                                                                                (0x11)
MC     Antenna_IDs[i] contains a bit for an antenna that the Controller can     Unsupported
       determine is not in the device’s antenna array (some Controllers might   Feature or
       be unable to determine which values do or do not identify an antenna).   Parameter Value
                                                                                (0x11)

Event(s) generated (unless masked away):

When the HCI_LE_Receiver_Test command has completed, an HCI_Command_- Complete event shall be generated.

If the Expected_CTE_Length parameter is not set to zero, then HCI_LE_- Connectionless_IQ_Report events may be generated by the Controller.

Parameters

[in] p_params Input parameters.

Return values

0	if 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.