NI RFmx LTE Pvt Attributes

PVT Attributes

• RFMXLTE_ATTR_PVT_MEASUREMENT_ENABLED
• RFMXLTE_ATTR_PVT_MEASUREMENT_METHOD
• Averaging
  • RFMXLTE_ATTR_PVT_AVERAGING_ENABLED
  • RFMXLTE_ATTR_PVT_AVERAGING_COUNT
  • RFMXLTE_ATTR_PVT_AVERAGING_TYPE
• RFMXLTE_ATTR_PVT_OFF_POWER_EXCLUSION_BEFORE
• RFMXLTE_ATTR_PVT_OFF_POWER_EXCLUSION_AFTER
• RFMXLTE_ATTR_PVT_ALL_TRACES_ENABLED
• RFMXLTE_ATTR_PVT_NUMBER_OF_ANALYSIS_THREADS
• Tesults
  • RFMXLTE_ATTR_PVT_RESULTS_MEASUREMENT_STATUS
  • RFMXLTE_ATTR_PVT_RESULTS_MEAN_ABSOLUTE_OFF_POWER_BEFORE
  • RFMXLTE_ATTR_PVT_RESULTS_MEAN_ABSOLUTE_OFF_POWER_AFTER
  • RFMXLTE_ATTR_PVT_RESULTS_MEAN_ABSOLUTE_ON_POWER
  • RFMXLTE_ATTR_PVT_RESULTS_BURST_WIDTH

RFMXLTE_ATTR_PVT_MEASUREMENT_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxLTE_SetAttributeI32 RFmxLTE_GetAttributeI32
Description:	Specifies whether to enable the power versus time (PVT) 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 RFMXLTE_VAL_FALSE. Get Function: RFmxLTE_PVTGetMeasurementEnabled Set Function: RFmxLTE_PVTSetMeasurementEnabled

RFMXLTE_ATTR_PVT_MEASUREMENT_METHOD

Data Type:	int32
Access:	read/write
Functions:	RFmxLTE_SetAttributeI32 RFmxLTE_GetAttributeI32
Description:	Specifies the method for performing the power versus time (PVT) 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. Refer to the LTE PVT (Power Vs Time) Measurement topic for more information about multi acquisition PVT. The default value is RFMXLTE_VAL_PVT_MEASUREMENT_METHOD_NORMAL. Get Function: RFmxLTE_PVTGetMeasurementMethod Set Function: RFmxLTE_PVTSetMeasurementMethod
Values:

RFMXLTE_VAL_PVT_MEASUREMENT_METHOD_NORMAL (0)	The measurement is performed using a single acquisition. Use this method when a high dynamic range is not required.
RFMXLTE_VAL_PVT_MEASUREMENT_METHOD_DYNAMIC_RANGE (1)	The measurement is performed using two acquisitions. Use this method when a higher dynamic range is desirable over the measurement speed. Supported Devices: PXIe-5644/5645/5646, PXIe-5840/5841

PVT Averaging

RFMXLTE_ATTR_PVT_AVERAGING_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxLTE_SetAttributeI32 RFmxLTE_GetAttributeI32
Description:	Specifies whether to enable averaging for the power versus time (PVT) 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 RFMXLTE_VAL_PVT_AVERAGING_ENABLED_FALSE. Get Function: RFmxLTE_PVTGetAveragingEnabled Set Function: RFmxLTE_PVTSetAveragingEnabled
Values:

RFMXLTE_VAL_PVT_AVERAGING_ENABLED_FALSE (0)	The measurement is performed on a single acquisition.
RFMXLTE_VAL_PVT_AVERAGING_ENABLED_TRUE (1)	The PVT measurement uses the value of the RFMXLTE_ATTR_PVT_AVERAGING_COUNT attribute as the number of acquisitions over which the PVT measurement is averaged.

RFMXLTE_ATTR_PVT_AVERAGING_COUNT

Data Type:	int32
Access:	read/write
Functions:	RFmxLTE_SetAttributeI32 RFmxLTE_GetAttributeI32
Description:	Specifies the number of acquisitions used for averaging when you set the RFMXLTE_ATTR_PVT_AVERAGING_ENABLED attribute to RFMXLTE_VAL_PVT_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: RFmxLTE_PVTGetAveragingCount Set Function: RFmxLTE_PVTSetAveragingCount

RFMXLTE_ATTR_PVT_AVERAGING_TYPE

Data Type:	int32
Access:	read/write
Functions:	RFmxLTE_SetAttributeI32 RFmxLTE_GetAttributeI32
Description:	Specifies the averaging type for averaging multiple spectrum acquisitions. The averaged spectrum is used for the power versus time (PVT) 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 RFMXLTE_VAL_PVT_AVERAGING_TYPE_RMS. Get Function: RFmxLTE_PVTGetAveragingType Set Function: RFmxLTE_PVTSetAveragingType
Values:

RFMXLTE_VAL_PVT_AVERAGING_TYPE_RMS (0)	The power spectrum is linearly averaged. RMS averaging reduces signal fluctuations but not the noise floor.
RFMXLTE_VAL_PVT_AVERAGING_TYPE_LOG (1)	The power spectrum is averaged in a logarithmic scale.

RFMXLTE_ATTR_PVT_OFF_POWER_EXCLUSION_BEFORE

Data Type:	float64
Access:	read/write
Functions:	RFmxLTE_SetAttributeF64 RFmxLTE_GetAttributeF64
Description:	Specifies the time excluded from the Off region before the burst. This value is expressed in seconds. 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. Refer to the LTE PVT (Power Vs Time) Measurement topic for more information about OFF power exclusion. The default value is 0. Get Function: RFmxLTE_PVTGetOFFPowerExclusionBefore Set Function: RFmxLTE_PVTSetOFFPowerExclusionBefore

RFMXLTE_ATTR_PVT_OFF_POWER_EXCLUSION_AFTER

Data Type:	float64
Access:	read/write
Functions:	RFmxLTE_SetAttributeF64 RFmxLTE_GetAttributeF64
Description:	Specifies the time excluded from the Off region after the burst. This value is expressed in seconds. 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. Refer to the LTE PVT (Power Vs Time) Measurement topic for more information about OFF power exclusion. The default value is 0. Get Function: RFmxLTE_PVTGetOFFPowerExclusionAfter Set Function: RFmxLTE_PVTSetOFFPowerExclusionAfter

RFMXLTE_ATTR_PVT_ALL_TRACES_ENABLED

Data Type:	int32
Access:	read/write
Functions:	RFmxLTE_SetAttributeI32 RFmxLTE_GetAttributeI32
Description:	Specifies whether to enable the traces to be stored and retrieved after performing the power versus time (PVT) 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 RFMXLTE_VAL_FALSE. Get Function: RFmxLTE_PVTGetAllTracesEnabled Set Function: RFmxLTE_PVTSetAllTracesEnabled

RFMXLTE_ATTR_PVT_NUMBER_OF_ANALYSIS_THREADS

Data Type:	int32
Access:	read/write
Functions:	RFmxLTE_SetAttributeI32 RFmxLTE_GetAttributeI32
Description:	Specifies the maximum number of threads used for parallelism for the power versus time (PVT) 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: RFmxLTE_PVTGetNumberOfAnalysisThreads Set Function: RFmxLTE_PVTSetNumberOfAnalysisThreads

PVT Results

RFMXLTE_ATTR_PVT_RESULTS_MEASUREMENT_STATUS

Data Type:	int32
Access:	read only
Functions:	RFmxLTE_GetAttributeI32
Description:	Returns the measurement status indicating whether the power before and after the burst is within the standard defined limit. Use 'carrier(k)' or 'subblock(n)/carrier(k)' as the selector string to read this result. Refer to the LTE PVT (Power Vs Time) Measurement topic for more information about measurement status. Get Function: RFmxLTE_PVTGetResultsMeasurementStatus
Values:

RFMXLTE_VAL_PVT_RESULTS_MEASUREMENT_STATUS_FAIL (0)	Indicates that the measurement has failed.
RFMXLTE_VAL_PVT_RESULTS_MEASUREMENT_STATUS_PASS (1)	Indicates that the measurement has passed.

RFMXLTE_ATTR_PVT_RESULTS_MEAN_ABSOLUTE_OFF_POWER_BEFORE

Data Type:	float64
Access:	read only
Functions:	RFmxLTE_GetAttributeF64
Description:	Returns the mean power in the segment before the captured burst. The segment is defined as one subframe prior to the burst for the FDD mode and 10 SC-FDMA symbols prior to the burst for the TDD mode. This value is expressed in dBm. Use 'carrier(k)' or 'subblock(n)/carrier(k)' as the selector string to read this result. Refer to the LTE PVT (Power Vs Time) Measurement topic for more information about OFF Power. Get Function: RFmxLTE_PVTGetResultsMeanAbsoluteOFFPowerBefore

RFMXLTE_ATTR_PVT_RESULTS_MEAN_ABSOLUTE_OFF_POWER_AFTER

Data Type:	float64
Access:	read only
Functions:	RFmxLTE_GetAttributeF64
Description:	Returns the mean power in the segment after the captured burst. This value is expressed in dBm. The segment is defined as one subframe long, excluding a transient period of 20 μs at the beginning. This value is expressed in dBm. Use 'carrier(k)' or 'subblock(n)/carrier(k)' as the selector string to read this result. Refer to the LTE PVT (Power Vs Time) Measurement topic for more information about OFF Power. Get Function: RFmxLTE_PVTGetResultsMeanAbsoluteOFFPowerAfter

RFMXLTE_ATTR_PVT_RESULTS_MEAN_ABSOLUTE_ON_POWER

Data Type:	float64
Access:	read only
Functions:	RFmxLTE_GetAttributeF64
Description:	Returns the average power of the subframes within the captured burst. The average power excludes the transient period of 20 μs at the beginning. This value is expressed in dBm. Use 'carrier(k)' or 'subblock(n)/carrier(k)' as the selector string to read this result. Get Function: RFmxLTE_PVTGetResultsMeanAbsoluteONPower

RFMXLTE_ATTR_PVT_RESULTS_BURST_WIDTH

Data Type:	float64
Access:	read only
Functions:	RFmxLTE_GetAttributeF64
Description:	Returns the width of the captured burst. This value is expressed in seconds. Use 'carrier(k)' or 'subblock(n)/carrier(k)' as the selector string to read this result. Get Function: RFmxLTE_PVTGetResultsBurstWidth