NI RFmx Bluetooth Frequency Range Attributes

Frequency Range Attributes

• RFMXBT_ATTR_FREQUENCY_RANGE_MEASUREMENT_ENABLED
• RFMXBT_ATTR_FREQUENCY_RANGE_SPAN
• Averaging
  • RFMXBT_ATTR_FREQUENCY_RANGE_AVERAGING_ENABLED
  • RFMXBT_ATTR_FREQUENCY_RANGE_AVERAGING_COUNT
• RFMXBT_ATTR_FREQUENCY_RANGE_ALL_TRACES_ENABLED
• RFMXBT_ATTR_FREQUENCY_RANGE_NUMBER_OF_ANALYSIS_THREADS
• Results
  • RFMXBT_ATTR_FREQUENCY_RANGE_RESULTS_HIGH_FREQUENCY
  • RFMXBT_ATTR_FREQUENCY_RANGE_RESULTS_LOW_FREQUENCY

RFMXBT_ATTR_FREQUENCY_RANGE_MEASUREMENT_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32
Description:	Specifies whether to enable the FrequencyRange measurement specified in the section 4.5.4 of the Bluetooth Test Specification v5.1.0. 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_FrequencyRangeGetMeasurementEnabled Set Function: RFmxBT_FrequencyRangeSetMeasurementEnabled

RFMXBT_ATTR_FREQUENCY_RANGE_SPAN

Data Type:	float64
Access:	read/write
Functions:	RFmxBT_SetAttributeF64 RFmxBT_GetAttributeF64
Description:	Specifies the span for the FrequencyRange measurement. This value is expressed in Hz. You must adjust the span according the center frequency as specified in section 4.5.4 of the Bluetooth Test Specification v5.1.0. It is recommended to use the span of 6 MHz for a center frequency of 2.402 GHz and 10 MHz for a center frequency of 2.48 GHz. 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 MHz. Get Function: RFmxBT_FrequencyRangeGetSpan Set Function: RFmxBT_FrequencyRangeSetSpan

Frequency Range Averaging

RFMXBT_ATTR_FREQUENCY_RANGE_AVERAGING_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32
Description:	Specifies whether to enable averaging for the FrequencyRange 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_FREQUENCY_RANGE_AVERAGING_ENABLED_FALSE. Get Function: RFmxBT_FrequencyRangeGetAveragingEnabled Set Function: RFmxBT_FrequencyRangeSetAveragingEnabled

Values:
RFMXBT_VAL_FREQUENCY_RANGE_AVERAGING_ENABLED_FALSE (0)	The measurement is performed on a single acquisition.
RFMXBT_VAL_FREQUENCY_RANGE_AVERAGING_ENABLED_TRUE (1)	The FrequencyRange measurement uses the RFMXBT_ATTR_FREQUENCY_RANGE_AVERAGING_COUNT attribute as the number of acquisitions over which the FrequencyRange measurement is averaged.

RFMXBT_ATTR_FREQUENCY_RANGE_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_FREQUENCY_RANGE_AVERAGING_ENABLED attribute to RFMXBT_VAL_FREQUENCY_RANGE_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_FrequencyRangeGetAveragingCount Set Function: RFmxBT_FrequencyRangeSetAveragingCount

RFMXBT_ATTR_FREQUENCY_RANGE_ALL_TRACES_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32
Description:	Specifies whether to enable all the traces for FrequencyRange 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_FrequencyRangeGetAllTracesEnabled Set Function: RFmxBT_FrequencyRangeSetAllTracesEnabled

RFMXBT_ATTR_FREQUENCY_RANGE_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 frequency range 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_FrequencyRangeGetNumberOfAnalysisThreads Set Function: RFmxBT_FrequencyRangeSetNumberOfAnalysisThreads

Frequency Range Results

RFMXBT_ATTR_FREQUENCY_RANGE_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 below -30 dBm measured in a 100 kHz bandwidth. 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_FrequencyRangeGetResultsHighFrequency

RFMXBT_ATTR_FREQUENCY_RANGE_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 below -30 dBm measured in a 100 kHz bandwidth. 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_FrequencyRangeGetResultsLowFrequency