NI RFmx NR Pvt Attributes - ni/grpc-device GitHub Wiki
- RFMXNR_ATTR_PVT_MEASUREMENT_ENABLED
- RFMXNR_ATTR_PVT_MEASUREMENT_INTERVAL_AUTO
- RFMXNR_ATTR_PVT_MEASUREMENT_INTERVAL
- RFMXNR_ATTR_PVT_MEASUREMENT_METHOD
- Averaging
- RFMXNR_ATTR_PVT_OFF_POWER_EXCLUSION_BEFORE
- RFMXNR_ATTR_PVT_OFF_POWER_EXCLUSION_AFTER
- RFMXNR_ATTR_PVT_ALL_TRACES_ENABLED
- RFMXNR_ATTR_PVT_NUMBER_OF_ANALYSIS_THREADS
-
Results
- RFMXNR_ATTR_PVT_RESULTS_MEASUREMENT_STATUS
- RFMXNR_ATTR_PVT_RESULTS_ABSOLUTE_OFF_POWER_BEFORE
- RFMXNR_ATTR_PVT_RESULTS_ABSOLUTE_OFF_POWER_AFTER
- RFMXNR_ATTR_PVT_RESULTS_ABSOLUTE_ON_POWER
- RFMXNR_ATTR_PVT_RESULTS_BURST_WIDTH
- RFMXNR_ATTR_PVT_RESULTS_PEAK_WINDOWED_OFF_POWER
- RFMXNR_ATTR_PVT_RESULTS_PEAK_WINDOWED_OFF_POWER_MARGIN
- RFMXNR_ATTR_PVT_RESULTS_PEAK_WINDOWED_OFF_POWER_TIME
| 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 |
| 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. |
| 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 |
| 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. |
| 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. |
| 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 |
| 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. |
| 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 |
| 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 |
| 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 |
| 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 |
| 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. |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |