Skip to content

NI RFmx NR ACP Attributes

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

ACP Attributes

RFMXNR_ATTR_ACP_MEASUREMENT_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies whether to enable the ACP 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_ACPGetMeasurementEnabled
Set Function: RFmxNR_ACPSetMeasurementEnabled

RFMXNR_ATTR_ACP_CHANNEL_CONFIGURATION_TYPE

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the method to configure the carrier and the offset channel settings.

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

Get Function: RFmxNR_ACPGetChannelConfigurationType
Set Function: RFmxNR_ACPSetChannelConfigurationType
Values:
RFMXNR_VAL_ACP_CHANNEL_CONFIGURATION_TYPE_STANDARD (0) All settings will be 3GPP compliant.
RFMXNR_VAL_ACP_CHANNEL_CONFIGURATION_TYPE_CUSTOM (1) The user can manually configure integration bandwidth and offset frequencies for the ACP measurement.

RFMXNR_ATTR_ACP_SUBBLOCK_INTEGRATION_BANDWIDTH

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the integration bandwidth of a subblock. This value is expressed in Hz.

Use 'subblock(n)' as the Selector Strings to read this result.

Integration bandwidth is the span from the left edge of the leftmost carrier to the right edge of the rightmost carrier within the subblock. The default value is 9 MHz.

Get Function: RFmxNR_ACPGetSubblockIntegrationBandwidth
Set Function: RFmxNR_ACPSetSubblockIntegrationBandwidth

RFMXNR_ATTR_ACP_SUBBLOCK_OFFSET

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the offset of the subblock measurement relative to the subblock center. This value is expressed in Hz.

Use 'subblock(n)' as the Selector Strings to read this result.

The default value is 0.

Get Function: RFmxNR_ACPGetSubblockOffset
Set Function: RFmxNR_ACPSetSubblockOffset

ACP Component Carrier

RFMXNR_ATTR_ACP_COMPONENT_CARRIER_INTEGRATION_BANDWIDTH

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the integration bandwidth of the component carrier (CC). This value is expressed in Hz.

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

The default value is 9 MHz.

Get Function: RFmxNR_ACPGetComponentCarrierIntegrationBandwidth
Set Function: RFmxNR_ACPSetComponentCarrierIntegrationBandwidth

Offset

RFMXNR_ATTR_ACP_NUMBER_OF_UTRA_OFFSETS

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the number of universal terrestrial radio access (UTRA) adjacent channel offsets to be configured at offset positions. For uplink ACP measurement in frequency range 2, and for downlink ACP measurement, the RFMXNR_ATTR_ACP_NUMBER_OF_UTRA_OFFSETS has to be 0.

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

The default value is dependent on 3GPP specification.

Get Function: RFmxNR_ACPGetNumberOfUTRAOffsets
Set Function: RFmxNR_ACPSetNumberOfUTRAOffsets

RFMXNR_ATTR_ACP_NUMBER_OF_EUTRA_OFFSETS

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the number of evolved universal terrestrial radio access (E-UTRA) adjacent channel offsets to be configured at offset positions. For uplink ACP measurement, and for downlink ACP measurement in frequency range 2, this attribute has to be 0.

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

The default value is dependent on 3GPP specification.

Get Function: RFmxNR_ACPGetNumberOfEUTRAOffsets
Set Function: RFmxNR_ACPSetNumberOfEUTRAOffsets

RFMXNR_ATTR_ACP_NUMBER_OF_NR_OFFSETS

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the number of NR adjacent channel offsets to be configured at offset positions.

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

The default value is dependent on 3GPP specification.

Get Function: RFmxNR_ACPGetNumberOfNROffsets
Set Function: RFmxNR_ACPSetNumberOfNROffsets

RFMXNR_ATTR_ACP_NUMBER_OF_ENDC_OFFSETS

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the number of ENDC adjacent channel offsets to be configured at offset positions.

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

The default value is dependent on 3GPP specification.

Get Function: RFmxNR_ACPGetNumberOfENDCOffsets
Set Function: RFmxNR_ACPSetNumberOfENDCOffsets

RFMXNR_ATTR_ACP_NUMBER_OF_OFFSETS

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the number of configured offset channels.

Use 'subblock(n)' as the selector string to configure or read this attribute.

The default value is 1.

Get Function: RFmxNR_ACPGetNumberOfOffsets
Set Function: RFmxNR_ACPSetNumberOfOffsets

RFMXNR_ATTR_ACP_OFFSET_FREQUENCY

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the offset frequency of an offset channel. This value is expressed in Hz. The offset frequency is computed from the center of a reference component carrier/subblock to the center of the nearest RBW filter of the offset channel.

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

The default value is 10 MHz.

Get Function: RFmxNR_ACPGetOffsetFrequency
Set Function: RFmxNR_ACPSetOffsetFrequency

RFMXNR_ATTR_ACP_OFFSET_SIDEBAND

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the sideband measured for the offset channel.

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

The default value is RFMXNR_VAL_ACP_OFFSET_SIDEBAND_BOTH.

Get Function: RFmxNR_ACPGetOffsetSideband
Set Function: RFmxNR_ACPSetOffsetSideband
Values:
RFMXNR_VAL_ACP_OFFSET_SIDEBAND_NEGATIVE (0) Configures a lower offset segment to the left of the leftmost carrier.
RFMXNR_VAL_ACP_OFFSET_SIDEBAND_POSITIVE (1) Configures an upper offset segment to the right of the rightmost carrier.
RFMXNR_VAL_ACP_OFFSET_SIDEBAND_BOTH (2) Configures both the negative and the positive offset segments.

RFMXNR_ATTR_ACP_OFFSET_INTEGRATION_BANDWIDTH

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the integration bandwidth of an offset channel. This value is expressed in Hz.

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

The default value is 9 MHz.

Get Function: RFmxNR_ACPGetOffsetIntegrationBandwidth
Set Function: RFmxNR_ACPSetOffsetIntegrationBandwidth

RBW Filter

RFMXNR_ATTR_ACP_RBW_FILTER_AUTO_BANDWIDTH

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies whether the measurement computes the RBW.

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

Get Function: RFmxNR_ACPGetRBWFilterAutoBandwidth
Set Function: RFmxNR_ACPSetRBWFilterAutoBandwidth
Values:
RFMXNR_VAL_ACP_RBW_FILTER_AUTO_BANDWIDTH_FALSE (0) The measurement uses the RBW that you specify in the RFMXNR_ATTR_ACP_RBW_FILTER_BANDWIDTH attribute.
RFMXNR_VAL_ACP_RBW_FILTER_AUTO_BANDWIDTH_TRUE (1) The measurement computes the RBW.

RFMXNR_ATTR_ACP_RBW_FILTER_BANDWIDTH

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the bandwidth of the RBW filter, used to sweep the acquired signal, when you set the RFMXNR_ATTR_ACP_RBW_FILTER_AUTO_BANDWIDTH attribute to RFMXNR_VAL_ACP_RBW_FILTER_AUTO_BANDWIDTH_FALSE. This value is expressed in Hz.

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 30 kHz.

Get Function: RFmxNR_ACPGetRBWFilterBandwidth
Set Function: RFmxNR_ACPSetRBWFilterBandwidth

RFMXNR_ATTR_ACP_RBW_FILTER_TYPE

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the shape of the RBW filter.

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

Get Function: RFmxNR_ACPGetRBWFilterType
Set Function: RFmxNR_ACPSetRBWFilterType
Values:
RFMXNR_VAL_ACP_RBW_FILTER_TYPE_FFT_BASED (0) No RBW filtering is performed.
RFMXNR_VAL_ACP_RBW_FILTER_TYPE_GAUSSIAN (1) An RBW filter with a Gaussian response is applied.
RFMXNR_VAL_ACP_RBW_FILTER_TYPE_FLAT (2) An RBW filter with a flat response is applied.

Sweep Time

RFMXNR_ATTR_ACP_SWEEP_TIME_AUTO

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies whether the measurement sets the sweep time.

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

Get Function: RFmxNR_ACPGetSweepTimeAuto
Set Function: RFmxNR_ACPSetSweepTimeAuto
Values:
RFMXNR_VAL_ACP_SWEEP_TIME_AUTO_FALSE (0) The measurement uses the sweep time that you specify in the RFMXNR_ATTR_ACP_SWEEP_TIME_INTERVAL attribute.
RFMXNR_VAL_ACP_SWEEP_TIME_AUTO_TRUE (1) The measurement uses a sweep time of 1 ms.

RFMXNR_ATTR_ACP_SWEEP_TIME_INTERVAL

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the sweep time when you set the RFMXNR_ATTR_ACP_SWEEP_TIME_AUTO attribute to RFMXNR_VAL_ACP_SWEEP_TIME_AUTO_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 1 ms.

Get Function: RFmxNR_ACPGetSweepTimeInterval
Set Function: RFmxNR_ACPSetSweepTimeInterval

RFMXNR_ATTR_ACP_POWER_UNITS

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the unit for absolute power.

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

Get Function: RFmxNR_ACPGetPowerUnits
Set Function: RFmxNR_ACPSetPowerUnits
Values:
RFMXNR_VAL_ACP_POWER_UNITS_DBM (0) Indicates that the absolute power is expressed in dBm.
RFMXNR_VAL_ACP_POWER_UNITS_DBM_BY_HZ (1) Indicates that the absolute power is expressed in dBm/Hz.

RFMXNR_ATTR_ACP_MEASUREMENT_METHOD

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the method for performing the ACP 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_ACP_MEASUREMENT_METHOD_NORMAL.

Get Function: RFmxNR_ACPGetMeasurementMethod
Set Function: RFmxNR_ACPSetMeasurementMethod
Values:
RFMXNR_VAL_ACP_MEASUREMENT_METHOD_NORMAL (0) The ACP measurement acquires the spectrum using the same signal analyzer setting across frequency bands. Use this method when measurement speed is desirable over higher dynamic range.
RFMXNR_VAL_ACP_MEASUREMENT_METHOD_DYNAMIC_RANGE (1) The ACP measurement acquires the spectrum using the hardware-specific optimizations for different frequency bands. Use this method to get the best dynamic range. Supported Devices: PXIe 5665/5668R
RFMXNR_VAL_ACP_MEASUREMENT_METHOD_SEQUENTIAL_FFT (2) The ACP measurement acquires all the samples specified by the RFMXNR_ATTR_ACP_SWEEP_TIME_INTERVAL attribute and divides them in to smaller chunks of equal size defined by the RFMXNR_ATTR_ACP_SEQUENTIAL_FFT_SIZE attribute. FFT is computed for each chunk. The resultant FFTs are averaged to get the spectrum used to compute the ACP. If the total acquired samples is not an integer multiple of the FFT size, the remaining samples at the end of the acquisition are not used. Use this method to optimize for speed. The accuracy of results may be reduced when using this measurement method.

Noise Calibration

RFMXNR_ATTR_ACP_NOISE_CALIBRATION_MODE

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies whether the noise calibration and measurement is performed manually by the user or automatically by RFmx.

Refer to the measurement guidelines section in the Noise Compensation Algorithm topic for more information.

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

Get Function: RFmxNR_ACPGetNoiseCalibrationMode
Set Function: RFmxNR_ACPSetNoiseCalibrationMode
Values:
RFMXNR_VAL_ACP_NOISE_CALIBRATION_MODE_MANUAL (0) When you set the RFMXNR_ATTR_ACP_MEASUREMENT_MODE attribute to Noise Calibrate, you can initiate instrument noise calibration for ACP manually. When you set the RFMXNR_ATTR_ACP_MEASUREMENT_MODE attribute to RFMXNR_VAL_ACP_MEASUREMENT_MODE_MEASURE, you can initiate the ACP measurement manually.
RFMXNR_VAL_ACP_NOISE_CALIBRATION_MODE_AUTO (1) When you set the RFMXNR_ATTR_ACP_NOISE_COMPENSATION_ENABLED attribute to RFMXNR_VAL_ACP_NOISE_COMPENSATION_ENABLED_TRUE, RFmx sets Input Isolation Enabled attribute to Enabled and calibrates the instrument noise in the current state of the instrument. Next, RFmx resets the Input Isolation Enabled attribute and performs the ACP measurement, including compensation for the noise contribution of the instrument. RFmx skips noise calibration in this mode if valid noise calibration data is already cached. When you set the RFMXNR_ATTR_ACP_NOISE_COMPENSATION_ENABLED attribute to RFMXNR_VAL_ACP_NOISE_COMPENSATION_ENABLED_FALSE, RFmx does not calibrate instrument noise and performs the ACP measurement without compensating for the noise contribution of the instrument.

Noise Compensation

RFMXNR_ATTR_ACP_NOISE_COMPENSATION_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies whether RFmx compensates for the instrument noise when performing the measurement when you set RFMXNR_ATTR_ACP_NOISE_CALIBRATION_MODE attribute to RFMXNR_VAL_ACP_NOISE_CALIBRATION_MODE_AUTO, or when you set RFMXNR_ATTR_ACP_NOISE_CALIBRATION_MODE to RFMXNR_VAL_ACP_NOISE_CALIBRATION_MODE_MANUAL and RFMXNR_ATTR_ACP_MEASUREMENT_MODE attribute to RFMXNR_VAL_ACP_MEASUREMENT_MODE_MEASURE

Refer to the measurement guidelines section in the Noise Compensation Algorithm topic for more information.

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

Get Function: RFmxNR_ACPGetNoiseCompensationEnabled
Set Function: RFmxNR_ACPSetNoiseCompensationEnabled
Values:
RFMXNR_VAL_ACP_NOISE_COMPENSATION_ENABLED_FALSE (0) Disables noise compensation.
RFMXNR_VAL_ACP_NOISE_COMPENSATION_ENABLED_TRUE (1) Enables noise compensation. Supported Devices: PXIe-5663/5665/5668R, PXIe-5830/5831/5832

RFMXNR_ATTR_ACP_NOISE_COMPENSATION_TYPE

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

Refer to the measurement guidelines section in the Noise Compensation Algorithm topic for more information.

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

Get Function: RFmxNR_ACPGetNoiseCompensationType
Set Function: RFmxNR_ACPSetNoiseCompensationType
Values:
RFMXNR_VAL_ACP_NOISE_COMPENSATION_TYPE_ANALYZER_AND_TERMINATION (0) Compensates for noise from the analyzer and the 50-ohm termination. The measured power values are in excess of the thermal noise floor.
RFMXNR_VAL_ACP_NOISE_COMPENSATION_TYPE_ANALYZER_ONLY (1) Compensates only for analyzer noise only.

ACP Averaging

RFMXNR_ATTR_ACP_AVERAGING_ENABLED

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

Get Function: RFmxNR_ACPGetAveragingEnabled
Set Function: RFmxNR_ACPSetAveragingEnabled
Values:
RFMXNR_VAL_ACP_AVERAGING_ENABLED_FALSE (0) The measurement is performed on a single acquisition.
RFMXNR_VAL_ACP_AVERAGING_ENABLED_TRUE (1) The ACP measurement uses the value of the RFMXNR_ATTR_ACP_AVERAGING_COUNT attribute as the number of acquisitions over which the ACP measurement is averaged.

RFMXNR_ATTR_ACP_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_ACP_AVERAGING_ENABLED attribute to RFMXNR_VAL_ACP_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_ACPGetAveragingCount
Set Function: RFmxNR_ACPSetAveragingCount

RFMXNR_ATTR_ACP_AVERAGING_TYPE

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the averaging type for averaging multiple spectrum acquisitions. The averaged spectrum is used for ACP 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.

Default valuee is RMS.

Get Function: RFmxNR_ACPGetAveragingType
Set Function: RFmxNR_ACPSetAveragingType
Values:
RFMXNR_VAL_ACP_AVERAGING_TYPE_RMS (0) The power spectrum is linearly averaged. RMS averaging reduces signal fluctuations, but not the noise floor.
RFMXNR_VAL_ACP_AVERAGING_TYPE_LOG (1) The power spectrum is averaged in a logarithmic scale.
RFMXNR_VAL_ACP_AVERAGING_TYPE_SCALAR (2) The square root of the power spectrum is averaged.
RFMXNR_VAL_ACP_AVERAGING_TYPE_MAXIMUM (3) The peak power in the spectrum at each frequency bin is retained from one acquisition to the next.
RFMXNR_VAL_ACP_AVERAGING_TYPE_MINIMUM (4) The lowest power in the spectrum at each frequency bin is retained from one acquisition to the next.

RFMXNR_ATTR_ACP_MEASUREMENT_MODE

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies whether the measurement calibrates the noise floor of analyzer or performs the ACP measurement.

Refer to the measurement guidelines section in the Noise Compensation Algorithm topic for more information.

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

Get Function: RFmxNR_ACPGetMeasurementMode
Set Function: RFmxNR_ACPSetMeasurementMode
Values:
RFMXNR_VAL_ACP_MEASUREMENT_MODE_MEASURE (0) Performs the ACP measurement on the acquired signal.
RFMXNR_VAL_ACP_MEASUREMENT_MODE_CALIBRATE_NOISE_FLOOR (1) Performs manual noise calibration of the signal analyzer for the ACP measurement.

FFT

RFMXNR_ATTR_ACP_FFT_WINDOW

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the FFT window type to be used to reduce spectral leakage.

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

Get Function: RFmxNR_ACPGetFFTWindow
Set Function: RFmxNR_ACPSetFFTWindow
Values:
RFMXNR_VAL_ACP_FFT_WINDOW_NONE (0) No spectral leakage.
RFMXNR_VAL_ACP_FFT_WINDOW_FLAT_TOP (1) Spectral leakage is reduced using flat top window type.
RFMXNR_VAL_ACP_FFT_WINDOW_HANNING (2) Spectral leakage is reduced using Hanning window type.
RFMXNR_VAL_ACP_FFT_WINDOW_HAMMING (3) Spectral leakage is reduced using Hamming window type.
RFMXNR_VAL_ACP_FFT_WINDOW_GAUSSIAN (4) Spectral leakage is reduced using Gaussian window type.
RFMXNR_VAL_ACP_FFT_WINDOW_BLACKMAN (5) Spectral leakage is reduced using Blackman window type.
RFMXNR_VAL_ACP_FFT_WINDOW_BLACKMAN_HARRIS (6) Spectral leakage is reduced using Blackman-Harris window type.
RFMXNR_VAL_ACP_FFT_WINDOW_KAISER_BESSEL (7) Spectral leakage is reduced using Kaiser-Bessel window type.

RFMXNR_ATTR_ACP_FFT_OVERLAP_MODE

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the overlap mode when you set the RFMXNR_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXNR_VAL_ACP_MEASUREMENT_METHOD_SEQUENTIAL_FFT. In the Sequential FFT method, the measurement divides all the acquired samples into smaller FFT chunks of equal size. The FFT is then computed for each chunk. The resultant FFTs are averaged to get the spectrum used to compute the ACP.

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

Get Function: RFmxNR_ACPGetFFTOverlapMode
Set Function: RFmxNR_ACPSetFFTOverlapMode
Values:
RFMXNR_VAL_ACP_FFT_OVERLAP_MODE_DISABLED (0) Disables the overlap between the FFT chunks.
RFMXNR_VAL_ACP_FFT_OVERLAP_MODE_AUTOMATIC (1) Measurement sets the overlap based on the value you have set for the RFMXNR_ATTR_ACP_FFT_WINDOW attribute. When you set the RFMXNR_ATTR_ACP_FFT_WINDOW attribute to any value other than RFMXNR_VAL_ACP_FFT_WINDOW_NONE, the number of overlapped samples between consecutive chunks is set to 50% of the value of the RFMXNR_ATTR_ACP_SEQUENTIAL_FFT_SIZE attribute. When you set the RFMXNR_ATTR_ACP_FFT_WINDOW attribute to RFMXNR_VAL_ACP_FFT_WINDOW_NONE, the chunks are not overlapped and the overlap is set to 0%.
RFMXNR_VAL_ACP_FFT_OVERLAP_MODE_USER_DEFINED (2) Measurement uses the overlap that you specify in the RFMXNR_ATTR_ACP_FFT_OVERLAP attribute.

RFMXNR_ATTR_ACP_FFT_OVERLAP

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the samples to overlap between the consecutive chunks as a percentage of the RFMXNR_ATTR_ACP_SEQUENTIAL_FFT_SIZE attribute when you set the RFMXNR_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXNR_VAL_ACP_MEASUREMENT_METHOD_SEQUENTIAL_FFT and the RFMXNR_ATTR_ACP_FFT_OVERLAP_MODE attribute to RFMXNR_VAL_ACP_FFT_OVERLAP_MODE_USER_DEFINED. This value is expressed as a percentage.

You do not need to use a selector string to 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.

Get Function: RFmxNR_ACPGetFFTOverlap
Set Function: RFmxNR_ACPSetFFTOverlap

Advanced

RFMXNR_ATTR_ACP_IF_OUTPUT_POWER_OFFSET_AUTO

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies whether the measurement computes an appropriate IF output power level offset for the offset channels to improve the dynamic range of the ACP measurement. This attribute is applicable only when you set the RFMXNR_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXNR_VAL_ACP_MEASUREMENT_METHOD_DYNAMIC_RANGE.

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

Get Function: RFmxNR_ACPGetIFOutputPowerOffsetAuto
Set Function: RFmxNR_ACPSetIFOutputPowerOffsetAuto
Values:
RFMXNR_VAL_ACP_IF_OUTPUT_POWER_OFFSET_AUTO_FALSE (0) The measurement sets the IF output power level offset using the values of the RFMXNR_ATTR_ACP_NEAR_IF_OUTPUT_POWER_OFFSET and RFMXNR_ATTR_ACP_FAR_IF_OUTPUT_POWER_OFFSET attributes.
RFMXNR_VAL_ACP_IF_OUTPUT_POWER_OFFSET_AUTO_TRUE (1) The measurement automatically computes an IF output power level offset for the offset channels to improve the dynamic range of the ACP measurement.

RFMXNR_ATTR_ACP_NEAR_IF_OUTPUT_POWER_OFFSET

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the offset that is needed to adjust the IF output power levels for the offset channels that are near the carrier channel to improve the dynamic range. This value is expressed in dB. This attribute is applicable only when you set the RFMXNR_ATTR_ACP_IF_OUTPUT_POWER_OFFSET_AUTO attribute to RFMXNR_VAL_ACP_IF_OUTPUT_POWER_OFFSET_AUTO_FALSE and RFMXNR_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXNR_VAL_ACP_MEASUREMENT_METHOD_DYNAMIC_RANGE.

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_ACPGetNearIFOutputPowerOffset
Set Function: RFmxNR_ACPSetNearIFOutputPowerOffset

RFMXNR_ATTR_ACP_FAR_IF_OUTPUT_POWER_OFFSET

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the offset that is needed to adjust the IF output power levels for the offset channels that are far from the carrier channel to improve the dynamic range. This value is expressed in dB. This attribute is applicable only when you set the RFMXNR_ATTR_ACP_IF_OUTPUT_POWER_OFFSET_AUTO attribute to RFMXNR_VAL_ACP_IF_OUTPUT_POWER_OFFSET_AUTO_FALSE and RFMXNR_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXNR_VAL_ACP_MEASUREMENT_METHOD_DYNAMIC_RANGE.

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

Get Function: RFmxNR_ACPGetFarIFOutputPowerOffset
Set Function: RFmxNR_ACPSetFarIFOutputPowerOffset

RFMXNR_ATTR_ACP_SEQUENTIAL_FFT_SIZE

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the number of bins to be used for FFT computation, when you set the RFMXNR_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXNR_VAL_ACP_MEASUREMENT_METHOD_SEQUENTIAL_FFT.

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

Get Function: RFmxNR_ACPGetSequentialFFTSize
Set Function: RFmxNR_ACPSetSequentialFFTSize

RFMXNR_ATTR_ACP_AMPLITUDE_CORRECTION_TYPE

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies whether the amplitude of the frequency bins, used in measurements, is corrected for external attenuation at the RF center frequency, or at the individual frequency bins. Use the RFmxInstr_CfgExternalAttenuationTable function to configure the external attenuation table.

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

Get Function: RFmxNR_ACPGetAmplitudeCorrectionType
Set Function: RFmxNR_ACPSetAmplitudeCorrectionType
Values:
RFMXNR_VAL_ACP_AMPLITUDE_CORRECTION_TYPE_RF_CENTER_FREQUENCY (0) All the frequency bins in the spectrum are compensated with a single external attenuation value that corresponds to the RF center frequency.
RFMXNR_VAL_ACP_AMPLITUDE_CORRECTION_TYPE_SPECTRUM_FREQUENCY_BIN (1) An individual frequency bin in the spectrum is compensated with the external attenuation value corresponding to that frequency.

RFMXNR_ATTR_ACP_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 ACP 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_ACPGetAllTracesEnabled
Set Function: RFmxNR_ACPSetAllTracesEnabled

RFMXNR_ATTR_ACP_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 for the ACP 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_ACPGetNumberOfAnalysisThreads
Set Function: RFmxNR_ACPSetNumberOfAnalysisThreads

Results

RFMXNR_ATTR_ACP_RESULTS_TOTAL_AGGREGATED_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the total power of all the subblocks. The power in each subblock is the sum of powers of all the frequency bins over the integration bandwidth of the subblocks. This value includes the power in the inter-carrier gaps within a subblock, but it does not include the power within the subblock gaps.

The carrier power is reported in dBm when you set the RFMXNR_ATTR_ACP_POWER_UNITS attribute to RFMXNR_VAL_ACP_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXNR_ATTR_ACP_POWER_UNITS attribute to RFMXNR_VAL_ACP_POWER_UNITS_DBM_BY_HZ.

You do not need to use a selector string to read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

Get Function: RFmxNR_ACPGetResultsTotalAggregatedPower

RFMXNR_ATTR_ACP_RESULTS_SUBBLOCK_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the sum of powers of all the frequency bins over the integration bandwidth of the subblock. The carrier power is reported in dBm when you set the RFMXNR_ATTR_ACP_POWER_UNITS attribute to RFMXNR_VAL_ACP_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXNR_ATTR_ACP_POWER_UNITS attribute to RFMXNR_VAL_ACP_POWER_UNITS_DBM_BY_HZ.

Use 'subblock(n)' as the Selector Strings to read this result.

Get Function: RFmxNR_ACPGetResultsSubblockPower

ACP Results Component Carrier

RFMXNR_ATTR_ACP_RESULTS_COMPONENT_CARRIER_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the power measured over the integration bandwidth of the component carrier. The carrier power is reported in dBm when you set the RFMXNR_ATTR_ACP_POWER_UNITS attribute to RFMXNR_VAL_ACP_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXNR_ATTR_ACP_POWER_UNITS attribute to RFMXNR_VAL_ACP_POWER_UNITS_DBM_BY_HZ.

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

Get Function: RFmxNR_ACPGetResultsComponentCarrierAbsolutePower

RFMXNR_ATTR_ACP_RESULTS_COMPONENT_CARRIER_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the component carrier power relative to its subblock power. 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_ACPGetResultsComponentCarrierRelativePower

Lower Offset

RFMXNR_ATTR_ACP_RESULTS_LOWER_OFFSET_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the lower (negative) offset channel power. The carrier power is reported in dBm when you set the RFMXNR_ATTR_ACP_POWER_UNITS attribute to RFMXNR_VAL_ACP_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXNR_ATTR_ACP_POWER_UNITS attribute to RFMXNR_VAL_ACP_POWER_UNITS_DBM_BY_HZ.

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

Get Function: RFmxNR_ACPGetResultsLowerOffsetAbsolutePower

RFMXNR_ATTR_ACP_RESULTS_LOWER_OFFSET_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the power in lower (negative) offset channel relative to the total aggregated power. This value is expressed in dB.

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

Get Function: RFmxNR_ACPGetResultsLowerOffsetRelativePower

Upper Offset

RFMXNR_ATTR_ACP_RESULTS_UPPER_OFFSET_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the upper (positive) offset channel power. The carrier power is reported in dBm when you set the RFMXNR_ATTR_ACP_POWER_UNITS attribute to RFMXNR_VAL_ACP_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXNR_ATTR_ACP_POWER_UNITS attribute to RFMXNR_VAL_ACP_POWER_UNITS_DBM_BY_HZ.

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

Get Function: RFmxNR_ACPGetResultsUpperOffsetAbsolutePower

RFMXNR_ATTR_ACP_RESULTS_UPPER_OFFSET_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the power in the upper (positive) offset channel relative to the total aggregated power. This value is expressed in dB.

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

Get Function: RFmxNR_ACPGetResultsUpperOffsetRelativePower

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