NI RFmx Bluetooth Twenty Db Attributes

Twenty dB Attributes

• RFMXBT_ATTR_20DB_BANDWIDTH_MEASUREMENT_ENABLED
• Averaging
  • RFMXBT_ATTR_20DB_BANDWIDTH_AVERAGING_ENABLED
  • RFMXBT_ATTR_20DB_BANDWIDTH_AVERAGING_COUNT
• RFMXBT_ATTR_20DB_BANDWIDTH_ALL_TRACES_ENABLED
• RFMXBT_ATTR_20DB_BANDWIDTH_NUMBER_OF_ANALYSIS_THREADS
• Results
  • RFMXBT_ATTR_20DB_BANDWIDTH_RESULTS_PEAK_POWER
  • RFMXBT_ATTR_20DB_BANDWIDTH_RESULTS_BANDWIDTH
  • RFMXBT_ATTR_20DB_BANDWIDTH_RESULTS_HIGH_FREQUENCY
  • RFMXBT_ATTR_20DB_BANDWIDTH_RESULTS_LOW_FREQUENCY

RFMXBT_ATTR_20DB_BANDWIDTH_MEASUREMENT_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32
Description:	Specifies whether to enable the 20dBBandwidth measurement specified in section 4.5.5 of the Bluetooth Test Specification v5.1.0. The measurement uses a span of 3 MHz internally. This measurement is valid only for basic rate (BR) packets. You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals. The default value is RFMXBT_VAL_FALSE. Get Function: RFmxBT_20dBBandwidthGetMeasurementEnabled Set Function: RFmxBT_20dBBandwidthSetMeasurementEnabled

Twenty dB Averaging

RFMXBT_ATTR_20DB_BANDWIDTH_AVERAGING_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32
Description:	Specifies whether to enable averaging for the 20dBBandwidth measurement. You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals. The default value is RFMXBT_VAL_20DB_BANDWIDTH_AVERAGING_ENABLED_FALSE. Get Function: RFmxBT_20dBBandwidthGetAveragingEnabled Set Function: RFmxBT_20dBBandwidthSetAveragingEnabled

Values:
RFMXBT_VAL_20DB_BANDWIDTH_AVERAGING_ENABLED_FALSE (0)	The measurement is performed on a single acquisition.
RFMXBT_VAL_20DB_BANDWIDTH_AVERAGING_ENABLED_TRUE (1)	The 20dBBandwidth measurement uses the RFMXBT_ATTR_20DB_BANDWIDTH_AVERAGING_COUNT attribute as the number of acquisitions over which the 20dBBandwidth measurement is averaged.

RFMXBT_ATTR_20DB_BANDWIDTH_AVERAGING_COUNT

Data Type:	int32
Access:	read/write
Functions:	RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32
Description:	Specifies the number of acquisitions used for averaging when you set the RFMXBT_ATTR_20DB_BANDWIDTH_AVERAGING_ENABLED attribute to RFMXBT_VAL_20DB_BANDWIDTH_AVERAGING_ENABLED_TRUE. You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals. The default value is 10. Get Function: RFmxBT_20dBBandwidthGetAveragingCount Set Function: RFmxBT_20dBBandwidthSetAveragingCount

RFMXBT_ATTR_20DB_BANDWIDTH_ALL_TRACES_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32
Description:	Specifies whether to enable all the traces for the 20dBBandwidth measurement. You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals. The default value is RFMXBT_VAL_FALSE. Get Function: RFmxBT_20dBBandwidthGetAllTracesEnabled Set Function: RFmxBT_20dBBandwidthSetAllTracesEnabled

RFMXBT_ATTR_20DB_BANDWIDTH_NUMBER_OF_ANALYSIS_THREADS

Data Type:	int32
Access:	read/write
Functions:	RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32
Description:	Specifies the maximum number of threads used for parallelism for the 20dB bandwidth measurement. The number of threads can range from 1 to the number of physical cores. The number of threads you set may not be used in calculations. The actual number of threads used depends on the problem size, system resources, data availability, and other considerations. You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals. The default value is 1. Get Function: RFmxBT_20dBBandwidthGetNumberOfAnalysisThreads Set Function: RFmxBT_20dBBandwidthSetNumberOfAnalysisThreads

Twenty dB Results

RFMXBT_ATTR_20DB_BANDWIDTH_RESULTS_PEAK_POWER

Data Type:	float64
Access:	read only
Functions:	RFmxBT_GetAttributeF64
Description:	Returns the peak power of the measured spectrum. This value is expressed in dBm. You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results. Get Function: RFmxBT_20dBBandwidthGetResultsPeakPower

RFMXBT_ATTR_20DB_BANDWIDTH_RESULTS_BANDWIDTH

Data Type:	float64
Access:	read only
Functions:	RFmxBT_GetAttributeF64
Description:	Returns the 20dB bandwidth of the received signal. It is computed as the difference between 20dBBandwidth Results High Freq and 20dBBandwidth Results Low Freq. This value is expressed in Hz. You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results. Get Function: RFmxBT_20dBBandwidthGetResultsBandwidth

RFMXBT_ATTR_20DB_BANDWIDTH_RESULTS_HIGH_FREQUENCY

Data Type:	float64
Access:	read only
Functions:	RFmxBT_GetAttributeF64
Description:	Returns the highest frequency above the center frequency at which the transmit power drops 20 dB below the peak power. This value is expressed in Hz. You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results. Get Function: RFmxBT_20dBBandwidthGetResultsHighFrequency

RFMXBT_ATTR_20DB_BANDWIDTH_RESULTS_LOW_FREQUENCY

Data Type:	float64
Access:	read only
Functions:	RFmxBT_GetAttributeF64
Description:	Returns the lowest frequency below the center frequency at which the transmit power drops 20 dB below the peak power. This value is expressed in Hz. You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results. Get Function: RFmxBT_20dBBandwidthGetResultsLowFrequency