NI RFmx WLAN TXP Attributes

TXP Attributes

• RFMXWLAN_ATTR_TXP_MEASUREMENT_ENABLED
• RFMXWLAN_ATTR_TXP_MAXIMUM_MEASUREMENT_INTERVAL
• RFMXWLAN_ATTR_TXP_BURST_DETECTION_ENABLED
• Averaging
  • RFMXWLAN_ATTR_TXP_AVERAGING_ENABLED
  • RFMXWLAN_ATTR_TXP_AVERAGING_COUNT
• RFMXWLAN_ATTR_TXP_ALL_TRACES_ENABLED
• RFMXWLAN_ATTR_TXP_NUMBER_OF_ANALYSIS_THREADS
• Results
  • RFMXWLAN_ATTR_TXP_RESULTS_AVERAGE_POWER_MEAN
  • RFMXWLAN_ATTR_TXP_RESULTS_PEAK_POWER_MAXIMUM

RFMXWLAN_ATTR_TXP_MEASUREMENT_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32
Description:	Specifies whether to enable the transmit power (TXP) 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 RFMXWLAN_VAL_FALSE. Get Function: RFmxWLAN_TXPGetMeasurementEnabled Set Function: RFmxWLAN_TXPSetMeasurementEnabled

RFMXWLAN_ATTR_TXP_MAXIMUM_MEASUREMENT_INTERVAL

Data Type:	float64
Access:	read/write
Functions:	RFmxWLAN_SetAttributeF64 RFmxWLAN_GetAttributeF64
Description:	Specifies the maximum measurement interval. This value is expressed in seconds. When you set the RFMXWLAN_ATTR_TXP_BURST_DETECTION_ENABLED attribute to RFMXWLAN_VAL_TXP_BURST_DETECTION_ENABLED_TRUE, the measurement interval used is equal to the smaller of the duration of the WLAN packet under analysis or the value you set for this attribute. 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 millisecond. Get Function: RFmxWLAN_TXPGetMaximumMeasurementInterval Set Function: RFmxWLAN_TXPSetMaximumMeasurementInterval

RFMXWLAN_ATTR_TXP_BURST_DETECTION_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32
Description:	Specifies whether the measurement detects the start and the end of a WLAN packet automatically. When you set this attribute to True, the measurement interval used is equal to the smaller of the duration of the WLAN packet under analysis or the value you set for the RFMXWLAN_ATTR_TXP_MAXIMUM_MEASUREMENT_INTERVAL attribute. 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 RFMXWLAN_VAL_TXP_BURST_DETECTION_ENABLED_TRUE. Get Function: RFmxWLAN_TXPGetBurstDetectionEnabled Set Function: RFmxWLAN_TXPSetBurstDetectionEnabled
Values:

RFMXWLAN_VAL_TXP_BURST_DETECTION_ENABLED_FALSE (0)	Disables burst detection.
RFMXWLAN_VAL_TXP_BURST_DETECTION_ENABLED_TRUE (1)	Enables burst detection.

| :- | :- |

TXP Averaging

RFMXWLAN_ATTR_TXP_AVERAGING_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32
Description:	Specifies whether to enable averaging for the TXP 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 RFMXWLAN_VAL_TXP_AVERAGING_ENABLED_FALSE. Get Function: RFmxWLAN_TXPGetAveragingEnabled Set Function: RFmxWLAN_TXPSetAveragingEnabled
Values:

RFMXWLAN_VAL_TXP_AVERAGING_ENABLED_FALSE (0)	The measurement is performed on a single acquisition.
RFMXWLAN_VAL_TXP_AVERAGING_ENABLED_TRUE (1)	The TXP measurement uses the RFMXWLAN_ATTR_TXP_AVERAGING_COUNT attribute as the number of acquisitions over which the TXP measurement is averaged.

| :- | :- |

RFMXWLAN_ATTR_TXP_AVERAGING_COUNT

Data Type:	int32
Access:	read/write
Functions:	RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32
Description:	Specifies the number of acquisitions used for averaging when you set the RFMXWLAN_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_TXP_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: RFmxWLAN_TXPGetAveragingCount Set Function: RFmxWLAN_TXPSetAveragingCount

RFMXWLAN_ATTR_TXP_ALL_TRACES_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32
Description:	Specifies whether to enable the traces to be stored and retrieved after performing the TXP 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 RFMXWLAN_VAL_FALSE. Get Function: RFmxWLAN_TXPGetAllTracesEnabled Set Function: RFmxWLAN_TXPSetAllTracesEnabled

RFMXWLAN_ATTR_TXP_NUMBER_OF_ANALYSIS_THREADS

Data Type:	int32
Access:	read/write
Functions:	RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32
Description:	Specifies the maximum number of threads used for parallelism for TXP 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: RFmxWLAN_TXPGetNumberOfAnalysisThreads Set Function: RFmxWLAN_TXPSetNumberOfAnalysisThreads

TXP Results

RFMXWLAN_ATTR_TXP_RESULTS_AVERAGE_POWER_MEAN

Data Type:	float64
Access:	read only
Functions:	RFmxWLAN_GetAttributeF64
Description:	Returns the average power of the acquired signal. This value is expressed in dBm. When you set the RFMXWLAN_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_TXP_AVERAGING_ENABLED_TRUE, this attribute returns the mean of the average power computed for each averaging count. You do not need to use a selector string to read this result for default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results. Get Function: RFmxWLAN_TXPGetResultsAveragePowerMean

RFMXWLAN_ATTR_TXP_RESULTS_PEAK_POWER_MAXIMUM

Data Type:	float64
Access:	read only
Functions:	RFmxWLAN_GetAttributeF64
Description:	Returns the peak power of the acquired signal. This value is expressed in dBm. When you set the RFMXWLAN_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_TXP_AVERAGING_ENABLED_TRUE, this attribute returns the maximum value of the peak power computed for each averaging count. You do not need to use a selector string to read this result for default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results. Get Function: RFmxWLAN_TXPGetResultsPeakPowerMaximum