NI Bluetooth Analysis Toolkit

niBTSA_SelectMeasurementsWithTraces

  • Updated2023-02-21
  • 1 minute(s) read

int32 __stdcall niBTSA_SelectMeasurementsWithTraces (niBTSASession session, int32 measurements, int32 enableTraces);

Purpose

Enables all the measurements and traces that you specify in the measurements parameter and disables all other measurements.

Parameters

Input
Name Type Description
session niBTSASession Specifies the niBT SA session. Use this parameter to configure the behavior and operation of the appropriate NI Bluetooth Analysis Toolkit function that accepts the niBTSASession as an input.
measurements int32 Specifies a list of measurements to perform. You can choose from the following measurements.

NIBTSA_VAL_TXP_MEASUREMENT(1) Enables transmit power (TxP) measurements.
NIBTSA_VAL_DF1_MEASUREMENT(2) Enables DF1 measurements.
NIBTSA_VAL_DF2_MEASUREMENT(4) Enables DF2 measurements.
NIBTSA_VAL_CFO_MEASUREMENT(8) Enables carrier frequency offset (CFO) measurements.
NIBTSA_VAL_DEVM_MEASUREMENT(16) Enables differential error vector magnitude (DEVM) measurements.
NIBTSA_VAL_BER_MEASUREMENT(32) Enables bit error rate (BER) measurements.
NIBTSA_VAL_TXSPECTRUM_MEASUREMENT(64) Enables transmit spectrum (TxSpectrum) measurements.
NIBTSA_VAL_ACP_MEASUREMENT(128) Enables adjacent channel power (ACP) measurements.
NIBTSA_VAL_EDR_INBAND_EMISSION_MEASUREMENT(256) Enables EDRInBandEmission measurements.
NIBTSA_VAL_LE_INBAND_EMISSION_MEASUREMENT(512) Enables LEInBandEmission measurements.
NIBTSA_VAL_PER_MEASUREMENT(1024) Enables PER measurements.
enableTraces int32 Specifies whether to enable traces for the selected measurement.

Return Value

Name Type Description
status 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 niBT SA function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the niBTSA_GetErrorString function.

The general meaning of the status code is as follows:

Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

Log in to get a better experience