niBTDTM_HCILEEnhancedReceiverTest

NI Bluetooth Toolkit Direct Test Mode 19.1 Help

Edition Date: October 2019

Part Number: 375699E-01

»View Product Info
Download Help (Windows Only)

int32 __stdcall niBTDTM_HCILEEnhancedReceiverTest( niBTDTMSession session, int32 channelNumber, int32 modulationIndex, int32 PHY, int32 *status);

Purpose

Sends the command to the device under test (DUT) to start the transmitter test.

Parameters

Input
Name Type Description
session niBTDTMSession Specifies the name of the communication port to which the DUT is connected.
channelNumber int32 Specifies the Bluetooth transmit channel number of the generated signal. The default value is 0.
modulationIndex int32 Specifies the type of modulation index at the generator. The default value is NIBTDTM_VAL_MODULATION_INDEX_STANDARD.
NIBTDTM_VAL_MODULATION_INDEX_STANDARD (0)

The packets are generated with standard modulation index.

NIBTDTM_VAL_MODULATION_INDEX_STABLE (1)

The packets are generated with stable modulation index.

PHY int32 Specifies the type of the generated packet by the physical layer of the DUT. The default value is NIBTDTM_VAL_RECEIVER_PHY_1MBPS.
NIBTDTM_VAL_RECEIVER_PHY_1MBPS (0)

Receiver is set to use the LE 1M PHY.

NIBTDTM_VAL_RECEIVER_PHY_2MBPS (1)

Receiver is set to use the LE 2M PHY.

NIBTDTM_VAL_RECEIVER_PHY_CODED (2)

Receiver is set to use the Coded PHY.

Output
Name Type Description
status int32 Returns the status of the receiver test command. The DUT receives and executes the receiver test command if the status parameter returns a 0x00 value. The transmitter test command fails if the status parameter returns a non-zero (0x01-0xFF) value.

Return Value

Name Type Description
returnValue int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning. Examine the status code from each call to an niBTDTM function to determine if an error has occurred.

The general meaning of the status code is as follows:

Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

WAS THIS ARTICLE HELPFUL?

Not Helpful