NI RFmx WLAN Powerramp Attributes

PowerRamp Attributes

• RFMXWLAN_ATTR_POWERRAMP_MEASUREMENT_ENABLED
• RFMXWLAN_ATTR_POWERRAMP_ACQUISITION_LENGTH
• Averaging
  • RFMXWLAN_ATTR_POWERRAMP_AVERAGING_ENABLED
  • RFMXWLAN_ATTR_POWERRAMP_AVERAGING_COUNT
• RFMXWLAN_ATTR_POWERRAMP_ALL_TRACES_ENABLED
• RFMXWLAN_ATTR_POWERRAMP_NUMBER_OF_ANALYSIS_THREADS
• Results
  • RFMXWLAN_ATTR_POWERRAMP_RESULTS_RISE_TIME_MEAN
  • RFMXWLAN_ATTR_POWERRAMP_RESULTS_FALL_TIME_MEAN

RFMXWLAN_ATTR_POWERRAMP_MEASUREMENT_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32
Description:	Specifies whether to enable PowerRamp 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_PowerRampGetMeasurementEnabled Set Function: RFmxWLAN_PowerRampSetMeasurementEnabled

RFMXWLAN_ATTR_POWERRAMP_ACQUISITION_LENGTH

Data Type:	float64
Access:	read/write
Functions:	RFmxWLAN_SetAttributeF64 RFmxWLAN_GetAttributeF64
Description:	Specifies the duration of the signal to be acquired for the PowerRamp measurement. This value is expressed in seconds. You must set this to a value that is greater than or equal to the duration of the PPDU under analysis, so that the acquired signal contains both rising and falling power ramp transitions. 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_PowerRampGetAcquisitionLength Set Function: RFmxWLAN_PowerRampSetAcquisitionLength

PowerRamp Averaging

RFMXWLAN_ATTR_POWERRAMP_AVERAGING_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32
Description:	Specifies if averaging is enabled for PowerRamp measurements. 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_POWERRAMP_AVERAGING_ENABLED_FALSE. Get Function: RFmxWLAN_PowerRampGetAveragingEnabled Set Function: RFmxWLAN_PowerRampSetAveragingEnabled
Values:

RFMXWLAN_VAL_POWERRAMP_AVERAGING_ENABLED_FALSE (0)	The measurement is performed on a single acquisition.
RFMXWLAN_VAL_POWERRAMP_AVERAGING_ENABLED_TRUE (1)	The measurement uses the RFMXWLAN_ATTR_POWERRAMP_AVERAGING_COUNT attribute as the number of acquisitions using which the results are averaged.

| :- | :- |

RFMXWLAN_ATTR_POWERRAMP_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_POWERRAMP_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_POWERRAMP_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_PowerRampGetAveragingCount Set Function: RFmxWLAN_PowerRampSetAveragingCount

RFMXWLAN_ATTR_POWERRAMP_ALL_TRACES_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32
Description:	Specifies whether to enable all the traces computed by the PowerRamp 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_PowerRampGetAllTracesEnabled Set Function: RFmxWLAN_PowerRampSetAllTracesEnabled

RFMXWLAN_ATTR_POWERRAMP_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 PowerRamp 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_PowerRampGetNumberOfAnalysisThreads Set Function: RFmxWLAN_PowerRampSetNumberOfAnalysisThreads

PowerRamp Results

RFMXWLAN_ATTR_POWERRAMP_RESULTS_RISE_TIME_MEAN

Data Type:	float64
Access:	read only
Functions:	RFmxWLAN_GetAttributeF64
Description:	Returns the power-ramp rise time of the burst. This value is expressed in seconds. This measurement is performed in accordance with section 16.3.7.7 of IEEE Standard 802.11-2016. When you set the RFMXWLAN_ATTR_POWERRAMP_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_POWERRAMP_AVERAGING_ENABLED_TRUE, this attribute returns the mean of the rise time results 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_PowerRampGetResultsRiseTimeMean

RFMXWLAN_ATTR_POWERRAMP_RESULTS_FALL_TIME_MEAN

Data Type:	float64
Access:	read only
Functions:	RFmxWLAN_GetAttributeF64
Description:	Returns the power-ramp fall time of the burst. This value is expressed in seconds. This measurement is performed in accordance with section 16.3.7.7 of IEEE Standard 802.11-2016. When you set the RFMXWLAN_ATTR_POWERRAMP_AVERAGING_ENABLED attribute to RFMXWLAN_VAL_POWERRAMP_AVERAGING_ENABLED_TRUE, this attribute returns the mean of the fall time results 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_PowerRampGetResultsFallTimeMean