Skip to content

NI RFmx NR Pvt Attributes

Ryan Eckenrode edited this page Mar 1, 2022 · 3 revisions

Pvt Attributes

RFMXNR_ATTR_PVT_MEASUREMENT_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies whether to enable the 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 RFMXNR_VAL_FALSE.

Get Function: RFmxNR_PVTGetMeasurementEnabled
Set Function: RFmxNR_PVTSetMeasurementEnabled

RFMXNR_ATTR_PVT_MEASUREMENT_INTERVAL_AUTO

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies whether the measurement interval is computed by the measurement or configured by the user through 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.

Setting this attribute to RFMXNR_VAL_PVT_MEASUREMENT_INTERVAL_AUTO_FALSE is valid for downlink only. The default value is RFMXNR_VAL_PVT_MEASUREMENT_INTERVAL_AUTO_TRUE. Refer to measurement guidelines details in the NR Power Vs Time concept help for more information.

Get Function: RFmxNR_PVTGetMeasurementIntervalAuto
Set Function: RFmxNR_PVTSetMeasurementIntervalAuto
Values:
RFMXNR_VAL_PVT_MEASUREMENT_INTERVAL_AUTO_FALSE (0) Measurement Interval is defined by the Measurement Interval attribute.
RFMXNR_VAL_PVT_MEASUREMENT_INTERVAL_AUTO_TRUE (1) Measurement Inteval is computed by the measurement.

RFMXNR_ATTR_PVT_MEASUREMENT_INTERVAL

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the measurement interval when the Measurement Interval Auto attribute is set to False. 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.

The default value is 10 ms.

Get Function: RFmxNR_PVTGetMeasurementInterval
Set Function: RFmxNR_PVTSetMeasurementInterval

RFMXNR_ATTR_PVT_MEASUREMENT_METHOD

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the PVT measurement method.

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 RFMXNR_VAL_PVT_MEASUREMENT_METHOD_NORMAL.

Get Function: RFmxNR_PVTGetMeasurementMethod
Set Function: RFmxNR_PVTSetMeasurementMethod
Values:
RFMXNR_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.
RFMXNR_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.

Pvt Averaging

RFMXNR_ATTR_PVT_AVERAGING_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_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 RFMXNR_VAL_PVT_AVERAGING_ENABLED_FALSE.

Get Function: RFmxNR_PVTGetAveragingEnabled
Set Function: RFmxNR_PVTSetAveragingEnabled
Values:
RFMXNR_VAL_PVT_AVERAGING_ENABLED_FALSE (0) The measurement is performed on a single acquisition.
RFMXNR_VAL_PVT_AVERAGING_ENABLED_TRUE (1) The measurement uses the value of the RFMXNR_ATTR_PVT_AVERAGING_COUNT attribute as the number of acquisitions over which the PVT measurement is averaged.

RFMXNR_ATTR_PVT_AVERAGING_COUNT

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the number of acquisitions used for averaging when you set the RFMXNR_ATTR_PVT_AVERAGING_ENABLED attribute to RFMXNR_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: RFmxNR_PVTGetAveragingCount
Set Function: RFmxNR_PVTSetAveragingCount

RFMXNR_ATTR_PVT_AVERAGING_TYPE

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the measurement averaging type.

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 RFMXNR_VAL_PVT_AVERAGING_TYPE_RMS.

Get Function: RFmxNR_PVTGetAveragingType
Set Function: RFmxNR_PVTSetAveragingType
Values:
RFMXNR_VAL_PVT_AVERAGING_TYPE_RMS (0) The power spectrum is linearly averaged.
RFMXNR_VAL_PVT_AVERAGING_TYPE_LOG (1) The power spectrum is averaged in a logarithmic scale.

RFMXNR_ATTR_PVT_OFF_POWER_EXCLUSION_BEFORE

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the time excluded from the OFF region before the burst and at the beginning for uplink and downlink, respectively. The 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.

The default value is 0. Refer to measurement guidelines details in the NR Power Vs Time concept help for more information.

Get Function: RFmxNR_PVTGetOFFPowerExclusionBefore
Set Function: RFmxNR_PVTSetOFFPowerExclusionBefore

RFMXNR_ATTR_PVT_OFF_POWER_EXCLUSION_AFTER

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the time excluded from the OFF region after the burst and at the end for uplink and downlink, respectively. The 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.

The default value is 0. Refer to measurement guidelines details in the NR Power Vs Time concept help for more information.

Get Function: RFmxNR_PVTGetOFFPowerExclusionAfter
Set Function: RFmxNR_PVTSetOFFPowerExclusionAfter

RFMXNR_ATTR_PVT_ALL_TRACES_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_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 RFMXNR_VAL_FALSE.

Get Function: RFmxNR_PVTGetAllTracesEnabled
Set Function: RFmxNR_PVTSetAllTracesEnabled

RFMXNR_ATTR_PVT_NUMBER_OF_ANALYSIS_THREADS

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the maximum number of threads used for parallelism inside the 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: RFmxNR_PVTGetNumberOfAnalysisThreads
Set Function: RFmxNR_PVTSetNumberOfAnalysisThreads

Results

RFMXNR_ATTR_PVT_RESULTS_MEASUREMENT_STATUS

Data Type: int32
Access: read only
Functions: RFmxNR_GetAttributeI32
Description: Returns the measurement status indicating whether the off power before and after is within the standard defined limit.

Use 'carrier(k)' or 'subblock(n)' or 'subblock(n)/carrier(k)' as the Selector Strings to read this attribute.

The default value is 0.

Get Function: RFmxNR_PVTGetResultsMeasurementStatus
Values:
RFMXNR_VAL_PVT_MEASUREMENT_STATUS_FAIL (0) Indicates that the measurement has failed.
RFMXNR_VAL_PVT_MEASUREMENT_STATUS_PASS (1) Indicates that the measurement has passed.

RFMXNR_ATTR_PVT_RESULTS_ABSOLUTE_OFF_POWER_BEFORE

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the OFF power in the segment before the captured burst for the uplink direction, while it returns NaN in the segment after the captured burst for the downlink direction. The segment is defined as one slot prior to a short transient segment and the burst.

This value is expressed in dBm.

Use 'carrier(k)' or 'subblock(n)' or 'subblock(n)/carrier(k)' as the Selector Strings to read this result.

The default value is 0.

Get Function: RFmxNR_PVTGetResultsAbsoluteOFFPowerBefore

RFMXNR_ATTR_PVT_RESULTS_ABSOLUTE_OFF_POWER_AFTER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the OFF power in the segment after the captured burst for the uplink direction, while it returns NaN in the segment after the captured burst for the downlink direction. The segment is defined as one slot after the burst and a short transient segment. This value is expressed in dBm.

Use 'carrier(k)' or 'subblock(n)' or 'subblock(n)/carrier(k)' as the Selector Strings to read this result.

The default value is 0.

Get Function: RFmxNR_PVTGetResultsAbsoluteOFFPowerAfter

RFMXNR_ATTR_PVT_RESULTS_ABSOLUTE_ON_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the average ON power within the measurement interval. This value is expressed in dBm.

Use 'carrier(k)' or 'subblock(n)' or 'subblock(n)/carrier(k)' as the Selector Strings to read this result.

The default value is 0.

Get Function: RFmxNR_PVTGetResultsAbsoluteONPower

RFMXNR_ATTR_PVT_RESULTS_BURST_WIDTH

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the width of the captured burst for the uplink direction, while it returns NaN of the captured burst for the downlink direction. This value is expressed in seconds.

Use 'carrier(k)' or 'subblock(n)' or 'subblock(n)/carrier(k)' as the Selector Strings to read this result.

The default value is 0.

Get Function: RFmxNR_PVTGetResultsBurstWidth

RFMXNR_ATTR_PVT_RESULTS_PEAK_WINDOWED_OFF_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the NaN for the uplink direction, while it returns the peak power value of 70/N us windowed power during all OFF regions in the measurement interval. This value is expressed in dBm/MHz.

Use 'carrier(k)' or 'subblock(n)' or 'subblock(n)/carrier(k)' as the Selector Strings to read this result.

The default value is 0.

Get Function: RFmxNR_PVTGetResultsPeakWindowedOFFPower

RFMXNR_ATTR_PVT_RESULTS_PEAK_WINDOWED_OFF_POWER_MARGIN

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the NaN for the uplink direction, while it returns the RFMXNR_ATTR_PVT_RESULTS_PEAK_WINDOWED_OFF_POWER to the 3GPP limit. This value is expressed in dB.

Use 'carrier(k)' or 'subblock(n)' or 'subblock(n)/carrier(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_PVTGetResultsPeakWindowedOFFPowerMargin

RFMXNR_ATTR_PVT_RESULTS_PEAK_WINDOWED_OFF_POWER_TIME

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the NaN for the uplink direction, while it returns the time offset of the RFMXNR_ATTR_PVT_RESULTS_PEAK_WINDOWED_OFF_POWER. This value is expressed in seconds.



Get Function: RFmxNR_PVTGetResultsPeakWindowedOFFPowerTime

Table of Contents

Internal Development

Creating and Setting Up a gRPC Server

Server Security Support

Creating a gRPC Client

gRPC Client Examples

Session Utilities API Reference

Driver Documentation

gRPC API Differences From C API

Sharing Driver Sessions Between Clients

C API Docs
NI-DAQmx
NI-DCPOWER
NI-DIGITAL PATTERN DRIVER
NI-DMM
NI-FGEN
NI-FPGA
NI-RFmx Bluetooth
NI-RFmx NR
NI-RFmx WCDMA
NI-RFmx GSM
NI-RFmx CDMA2k
NI-RFmx Instr
NI-RFmx LTE
NI-RFmx SpecAn
NI-RFmx TD-SCDMA
NI-RFmx WLAN
NI-RFSA
NI-RFSG
NI-SCOPE
NI-SWITCH
NI-TCLK
NI-XNET
Clone this wiki locally