NI RFmx LTE ACP Attributes - ni/grpc-device GitHub Wiki

ACP Attributes

RFMXLTE_ATTR_ACP_MEASUREMENT_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_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 RFMXLTE_VAL_FALSE.

Get Function: RFmxLTE_ACPGetMeasurementEnabled
Set Function: RFmxLTE_ACPSetMeasurementEnabled

RFMXLTE_ATTR_ACP_SUBBLOCK_INTEGRATION_BANDWIDTH

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Specifies the integration bandwidth of a subblock. This value is expressed in Hz. Integration bandwidth is the span from the left edge of the leftmost carrier to the right edge of the rightmost carrier within the subblock.

Use 'subblock(n)' as the selector string to read this result.

The default value is 0.

Get Function: RFmxLTE_ACPGetSubblockIntegrationBandwidth

Component Carrier

RFMXLTE_ATTR_ACP_COMPONENT_CARRIER_INTEGRATION_BANDWIDTH

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

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

The default value is 9 MHz.

Get Function: RFmxLTE_ACPGetComponentCarrierIntegrationBandwidth

ACP Offset

RFMXLTE_ATTR_ACP_CONFIGURABLE_NUMBER_OF_OFFSETS_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies whether the number of offsets is computed by measurement or configured by you.

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.

When the carrier bandwidth is 200 kHz or the RFMXLTE_ATTR_LINK_DIRECTION is RFMXLTE_VAL_LINK_DIRECTION_DOWNLINK, the default value is False. The default value is True, otherwise.

Incase of downlink, this attribute is applicable only for number of EUTRA offsets. For the number of UTRA offsets, only 3GPP specification defined values are supported.

Get Function: RFmxLTE_ACPGetConfigurableNumberOfOffsetsEnabled
Set Function: RFmxLTE_ACPSetConfigurableNumberOfOffsetsEnabled
Values:
RFMXLTE_VAL_ACP_CONFIGURABLE_NUMBER_OF_OFFSETS_ENABLED_FALSE (0) Measurement will set the number of offsets.
RFMXLTE_VAL_ACP_CONFIGURABLE_NUMBER_OF_OFFSETS_ENABLED_TRUE (1) Measurement will use the user configured value for number of offsets.

RFMXLTE_ATTR_ACP_NUMBER_OF_UTRA_OFFSETS

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies the number of universal terrestrial radio access (UTRA) adjacent channel offsets to be configured at offset positions, when you set the ACP Configurable Number of Offset Enabled attribute to True.

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

The default value is 1, when you set the RFMXLTE_ATTR_COMPONENT_CARRIER_BANDWIDTH to 200.0 k.

The default value is 0, when when you set the RFMXLTE_ATTR_BAND attribute to 46 or RFMXLTE_ATTR_DUPLEX_SCHEME attribute to RFMXLTE_VAL_DUPLEX_SCHEME_LAA.

The default value is 2 for all other configurations.In case of downlink, only 3GPP specification defined values are supported. In case of non-contiguous carrier aggregation, the configured value will be used only for the outer offsets and the offset channels in the gap region are defined as per the 3GPP specification. Offset power reference for the outer UTRA offsets are set according to the value of RFMXLTE_ATTR_ACP_EUTRA_OFFSET_DEFINITION attribute.

Get Function: RFmxLTE_ACPGetNumberOfUTRAOffsets
Set Function: RFmxLTE_ACPSetNumberOfUTRAOffsets

RFMXLTE_ATTR_ACP_NUMBER_OF_EUTRA_OFFSETS

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies the number of evolved universal terrestrial radio access (E-UTRA) adjacent channel offsets to be configured at offset positions, when you set the ACP Configurable Number of Offset Enabled attribute to True.

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

The default value is 0, when carrier bandwidth is 200 kHz. The default value is 2 for downlink and 1 for uplink, otherwise.

In case of non-contiguous carrier aggregation, the configured value will be used only for the outer offsets and the offset channels in the gap region are defined as per the 3GPP specification. Offset integration bandwidth and offset power reference for the outer E-UTRA offsets are set according to the value of RFMXLTE_ATTR_ACP_EUTRA_OFFSET_DEFINITION attribute.

Get Function: RFmxLTE_ACPGetNumberOfEUTRAOffsets
Set Function: RFmxLTE_ACPSetNumberOfEUTRAOffsets

RFMXLTE_ATTR_ACP_EUTRA_OFFSET_DEFINITION

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies the evolved universal terrestrial radio access (E-UTRA) offset channel definition.

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.

In case of non-contiguous, the inner offset channel definition will be configured internally as per the 3GPP specification. Offset power reference for the outer UTRA offsets are set according to RFMXLTE_ATTR_ACP_EUTRA_OFFSET_DEFINITION attribute.

The default value is RFMXLTE_VAL_ACP_EUTRA_OFFSET_DEFINITION_AUTO.

Get Function: RFmxLTE_ACPGetEUTRAOffsetDefinition
Set Function: RFmxLTE_ACPSetEUTRAOffsetDefinition
Values:
RFMXLTE_VAL_ACP_EUTRA_OFFSET_DEFINITION_AUTO (0) Measurement will set the EUTRA definition and offset power reference based on the link direction. For downlink, the definition is Closest and for uplink, it is Composite.
RFMXLTE_VAL_ACP_EUTRA_OFFSET_DEFINITION_CLOSEST (1) Integration bandwidth is derived from the closest LTE carrier. Offset power reference is set to Closest internally.
RFMXLTE_VAL_ACP_EUTRA_OFFSET_DEFINITION_COMPOSITE (2) Integration bandwidth is derived from the aggregated sub-block bandwidth. Offset power reference is set as Composite Sub-Block.

RFMXLTE_ATTR_ACP_NUMBER_OF_GSM_OFFSETS

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies the number of GSM adjacent channel offsets to be configured when you set the RFMXLTE_ATTR_COMPONENT_CARRIER_BANDWIDTH to 200.0 k and the ACP Configurable Number of Offset Enabled attribute to True.

The frequency offset from the center of NB-IOT carrier to the center of the first offset is 300 kHz as defined in the 3GPP specification. The center of every other offset is placed at 200 kHz from the previous offset's center.

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

The default value is 1, when you set the RFMXLTE_ATTR_COMPONENT_CARRIER_BANDWIDTH attribute to is 200.0 k. The default value is 0, otherwise.

Get Function: RFmxLTE_ACPGetNumberOfGSMOffsets
Set Function: RFmxLTE_ACPSetNumberOfGSMOffsets

RFMXLTE_ATTR_ACP_OFFSET_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Specifies the offset frequency of an offset channel. This value is expressed in Hz. When you set the RFMXLTE_ATTR_LINK_DIRECTION attribute to RFMXLTE_VAL_LINK_DIRECTION_UPLINK, 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. When you set the RFMXLTE_ATTR_LINK_DIRECTION attribute to RFMXLTE_VAL_LINK_DIRECTION_DOWNLINK, the offset frequency is computed from the center of the closest component carrier to the center of the nearest RBW filter of the offset channel.

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

The default value is 10 MHz.

Get Function: RFmxLTE_ACPGetOffsetFrequency

RFMXLTE_ATTR_ACP_OFFSET_INTEGRATION_BANDWIDTH

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Specifies the integration bandwidth of an offset carrier. This value is expressed in Hz.

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

The default value is 9 MHz.

Get Function: RFmxLTE_ACPGetOffsetIntegrationBandwidth

ACP Rbwfilter

RFMXLTE_ATTR_ACP_RBW_FILTER_AUTO_BANDWIDTH

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_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 RFMXLTE_VAL_ACP_RBW_FILTER_AUTO_BANDWIDTH_TRUE.

Get Function: RFmxLTE_ACPGetRBWFilterAutoBandwidth
Set Function: RFmxLTE_ACPSetRBWFilterAutoBandwidth
Values:
RFMXLTE_VAL_ACP_RBW_FILTER_AUTO_BANDWIDTH_FALSE (0) The measurement uses the RBW that you specify in the RFMXLTE_ATTR_ACP_RBW_FILTER_BANDWIDTH attribute.
RFMXLTE_VAL_ACP_RBW_FILTER_AUTO_BANDWIDTH_TRUE (1) The measurement computes the RBW.

RFMXLTE_ATTR_ACP_RBW_FILTER_BANDWIDTH

Data Type: float64
Access: read/write
Functions: RFmxLTE_SetAttributeF64
RFmxLTE_GetAttributeF64
Description: Specifies the bandwidth of the RBW filter, used to sweep the acquired signal, when you set the RFMXLTE_ATTR_ACP_RBW_FILTER_AUTO_BANDWIDTH attribute to RFMXLTE_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 30000.

Get Function: RFmxLTE_ACPGetRBWFilterBandwidth
Set Function: RFmxLTE_ACPSetRBWFilterBandwidth

RFMXLTE_ATTR_ACP_RBW_FILTER_TYPE

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_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 RFMXLTE_VAL_ACP_RBW_FILTER_TYPE_FFT_BASED.

Get Function: RFmxLTE_ACPGetRBWFilterType
Set Function: RFmxLTE_ACPSetRBWFilterType
Values:
RFMXLTE_VAL_ACP_RBW_FILTER_TYPE_FFT_BASED (0) No RBW filtering is performed.
RFMXLTE_VAL_ACP_RBW_FILTER_TYPE_GAUSSIAN (1) An RBW filter with a Gaussian response is applied.
RFMXLTE_VAL_ACP_RBW_FILTER_TYPE_FLAT (2) An RBW filter with a flat response is applied.

ACP Sweep Time

RFMXLTE_ATTR_ACP_SWEEP_TIME_AUTO

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies whether the measurement computes 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 RFMXLTE_VAL_ACP_SWEEP_TIME_AUTO_TRUE.

Get Function: RFmxLTE_ACPGetSweepTimeAuto
Set Function: RFmxLTE_ACPSetSweepTimeAuto
Values:
RFMXLTE_VAL_ACP_SWEEP_TIME_AUTO_FALSE (0) The measurement uses the sweep time that you specify in the RFMXLTE_ATTR_ACP_SWEEP_TIME_INTERVAL attribute.
RFMXLTE_VAL_ACP_SWEEP_TIME_AUTO_TRUE (1) The measurement uses a sweep time of 1 ms.

RFMXLTE_ATTR_ACP_SWEEP_TIME_INTERVAL

Data Type: float64
Access: read/write
Functions: RFmxLTE_SetAttributeF64
RFmxLTE_GetAttributeF64
Description: Specifies the sweep time when you set the RFMXLTE_ATTR_ACP_SWEEP_TIME_AUTO attribute to RFMXLTE_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: RFmxLTE_ACPGetSweepTimeInterval
Set Function: RFmxLTE_ACPSetSweepTimeInterval

RFMXLTE_ATTR_ACP_POWER_UNITS

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies the units 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 RFMXLTE_VAL_ACP_POWER_UNITS_DBM.

Get Function: RFmxLTE_ACPGetPowerUnits
Set Function: RFmxLTE_ACPSetPowerUnits
Values:
RFMXLTE_VAL_ACP_POWER_UNITS_DBM (0) The absolute powers are reported in dBm.
RFMXLTE_VAL_ACP_POWER_UNITS_DBM_BY_HZ (1) The absolute powers are reported in dBm/Hz.

RFMXLTE_ATTR_ACP_MEASUREMENT_METHOD

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_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 RFMXLTE_VAL_ACP_MEASUREMENT_METHOD_NORMAL.

Get Function: RFmxLTE_ACPGetMeasurementMethod
Set Function: RFmxLTE_ACPSetMeasurementMethod
Values:
RFMXLTE_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.
RFMXLTE_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/5668
RFMXLTE_VAL_ACP_MEASUREMENT_METHOD_SEQUENTIAL_FFT (2) The ACP measurement acquires all the samples specified by the RFMXLTE_ATTR_ACP_SWEEP_TIME_INTERVAL attribute and divides them in to smaller chunks of equal size defined by the RFMXLTE_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.

ACP Noisecal

RFMXLTE_ATTR_ACP_NOISE_CALIBRATION_MODE

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies whether the noise calibration and measurement is performed automatically by the measurement or by you. Refer to 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 RFMXLTE_VAL_ACP_NOISE_CALIBRATION_MODE_AUTO.

Get Function: RFmxLTE_ACPGetNoiseCalibrationMode
Set Function: RFmxLTE_ACPSetNoiseCalibrationMode
Values:
RFMXLTE_VAL_ACP_NOISE_CALIBRATION_MODE_MANUAL (0) When you set the RFMXLTE_ATTR_ACP_MEASUREMENT_MODE attribute to Noise Calibrate, you can initiate instrument noise calibration for ACP manually. When you set the RFMXLTE_ATTR_ACP_MEASUREMENT_MODE attribute to RFMXLTE_VAL_ACP_MEASUREMENT_MODE_MEASURE, you can initiate the ACP measurement manually.
RFMXLTE_VAL_ACP_NOISE_CALIBRATION_MODE_AUTO (1) When you set the RFMXLTE_ATTR_ACP_NOISE_COMPENSATION_ENABLED attribute to RFMXLTE_VAL_ACP_NOISE_COMPENSATION_ENABLED_TRUE, RFmx sets the Input Isolation Enabled attribute to Enabled and calibrates the instrument noise in the current state of the instrument. After that, the RFmx resets Input Isolation Enabled attribute and performs the ACP measurement including compensation for the noise contribution of the instrument. The RFmx skips noise calibration in this mode if valid noise calibration data is already cached.

ACP Noicecal Averaging

RFMXLTE_ATTR_ACP_NOISE_CALIBRATION_AVERAGING_AUTO

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies whether RFmx automatically computes the averaging count used for instrument noise calibration.

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

Get Function: RFmxLTE_ACPGetNoiseCalibrationAveragingAuto
Set Function: RFmxLTE_ACPSetNoiseCalibrationAveragingAuto
Values:
RFMXLTE_VAL_ACP_NOISE_CALIBRATION_AVERAGING_AUTO_FALSE (0) The RFmx uses the averages that you set for RFMXLTE_ATTR_ACP_NOISE_CALIBRATION_AVERAGING_COUNT attribute.
RFMXLTE_VAL_ACP_NOISE_CALIBRATION_AVERAGING_AUTO_TRUE (1) The RFmx uses the following averaging counts:

RFMXLTE_ATTR_ACP_NOISE_CALIBRATION_AVERAGING_COUNT

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies the averaging count used for noise calibration when you set the RFMXLTE_ATTR_ACP_NOISE_CALIBRATION_AVERAGING_AUTO attribute to RFMXLTE_VAL_ACP_NOISE_CALIBRATION_AVERAGING_AUTO_FALSE.

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

Get Function: RFmxLTE_ACPGetNoiseCalibrationAveragingCount
Set Function: RFmxLTE_ACPSetNoiseCalibrationAveragingCount

ACP Noisecomp

RFMXLTE_ATTR_ACP_NOISE_COMPENSATION_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies whether RFmx compensates for the instrument noise while performing the measurement when you set the RFMXLTE_ATTR_ACP_NOISE_CALIBRATION_MODE attribute to RFMXLTE_VAL_ACP_NOISE_CALIBRATION_MODE_AUTO, or when you set the RFMXLTE_ATTR_ACP_NOISE_CALIBRATION_MODE attribute to RFMXLTE_VAL_ACP_NOISE_CALIBRATION_MODE_MANUAL and the RFMXLTE_ATTR_ACP_MEASUREMENT_MODE attribute to RFMXLTE_VAL_ACP_MEASUREMENT_MODE_MEASURE. Refer to 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 RFMXLTE_VAL_ACP_NOISE_COMPENSATION_ENABLED_FALSE.

Get Function: RFmxLTE_ACPGetNoiseCompensationEnabled
Set Function: RFmxLTE_ACPSetNoiseCompensationEnabled
Values:
RFMXLTE_VAL_ACP_NOISE_COMPENSATION_ENABLED_FALSE (0) Disables compensation of the channel powers for the noise floor of the signal analyzer.
RFMXLTE_VAL_ACP_NOISE_COMPENSATION_ENABLED_TRUE (1) Enables compensation of the channel powers for the noise floor of the signal analyzer. The noise floor of the signal analyzer is measured for the RF path used by the ACP measurement and cached for future use. If the signal analyzer or the measurement parameters change, noise floors are remeasured. Supported Devices: PXIe-5663/5665/5668, PXIe-5830/5831/5832

RFMXLTE_ATTR_ACP_NOISE_COMPENSATION_TYPE

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies the noise compensation type. Refer to 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 RFMXLTE_VAL_ACP_NOISE_COMPENSATION_TYPE_ANALYZER_AND_TERMINATION.

Get Function: RFmxLTE_ACPGetNoiseCompensationType
Set Function: RFmxLTE_ACPSetNoiseCompensationType
Values:
RFMXLTE_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.
RFMXLTE_VAL_ACP_NOISE_COMPENSATION_TYPE_ANALYZER_ONLY (1) Compensates for analyzer noise only.

ACP Averaging

RFMXLTE_ATTR_ACP_AVERAGING_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_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 RFMXLTE_VAL_ACP_AVERAGING_ENABLED_FALSE.

Get Function: RFmxLTE_ACPGetAveragingEnabled
Set Function: RFmxLTE_ACPSetAveragingEnabled
Values:
RFMXLTE_VAL_ACP_AVERAGING_ENABLED_FALSE (0) The measurement is performed on a single acquisition.
RFMXLTE_VAL_ACP_AVERAGING_ENABLED_TRUE (1) The ACP measurement uses the value of the RFMXLTE_ATTR_ACP_AVERAGING_COUNT attribute as the number of acquisitions over which the ACP measurement is averaged.

RFMXLTE_ATTR_ACP_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_ACP_AVERAGING_ENABLED attribute to RFMXLTE_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: RFmxLTE_ACPGetAveragingCount
Set Function: RFmxLTE_ACPSetAveragingCount

RFMXLTE_ATTR_ACP_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 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 value is RMS.

Get Function: RFmxLTE_ACPGetAveragingType
Set Function: RFmxLTE_ACPSetAveragingType
Values:
RFMXLTE_VAL_ACP_AVERAGING_TYPE_RMS (0) The power spectrum is linearly averaged. RMS averaging reduces signal fluctuations, but not the noise floor.
RFMXLTE_VAL_ACP_AVERAGING_TYPE_LOG (1) The power spectrum is averaged in a logarithmic scale.
RFMXLTE_VAL_ACP_AVERAGING_TYPE_SCALAR (2) The square root of the power spectrum is averaged.
RFMXLTE_VAL_ACP_AVERAGING_TYPE_MAXIMUM (3) The peak power in the spectrum at each frequency bin is retained from one acquisition to the next.
RFMXLTE_VAL_ACP_AVERAGING_TYPE_MINIMUM (4) The lowest power in the spectrum at each frequency bin is retained from one acquisition to the next.

RFMXLTE_ATTR_ACP_MEASUREMENT_MODE

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies whether the measurement calibrates the noise floor of analyzer or performs the ACP measurement. Refer to 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 RFMXLTE_VAL_ACP_MEASUREMENT_MODE_MEASURE.

Get Function: RFmxLTE_ACPGetMeasurementMode
Set Function: RFmxLTE_ACPSetMeasurementMode
Values:
RFMXLTE_VAL_ACP_MEASUREMENT_MODE_MEASURE (0) ACP measurement is performed on the acquired signal.
RFMXLTE_VAL_ACP_MEASUREMENT_MODE_CALIBRATE_NOISE_FLOOR (1) Manual noise calibration of the signal analyzer is performed for the ACP measurement.

ACP FFT

RFMXLTE_ATTR_ACP_FFT_OVERLAP_MODE

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies how overlapping is applied when computing the FFT of the acquired samples.

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

Get Function: RFmxLTE_ACPGetFFTOverlapMode
Set Function: RFmxLTE_ACPSetFFTOverlapMode
Values:
RFMXLTE_VAL_ACP_FFT_OVERLAP_MODE_DISABLED (0) Indicates that overlapping is not applied to the acquired samples.
RFMXLTE_VAL_ACP_FFT_OVERLAP_MODE_AUTOMATIC (1) Indicates that the RFmx automatically chooses optimal values of the RFMXLTE_ATTR_ACP_FFT_OVERLAP attribute based on the measurement configuration.

RFMXLTE_ATTR_ACP_FFT_OVERLAP

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Returns the number of samples to overlap between consecutive chunks while performing FFT. This value is expressed as a percentage of Sequential FFT Size when you set the RFMXLTE_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXLTE_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.

Get Function: RFmxLTE_ACPGetFFTOverlap

ACP Advanced

RFMXLTE_ATTR_ACP_IF_OUTPUT_POWER_OFFSET_AUTO

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_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 RFMXLTE_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXLTE_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 RFMXLTE_VAL_ACP_IF_OUTPUT_POWER_OFFSET_AUTO_TRUE.

Get Function: RFmxLTE_ACPGetIFOutputPowerOffsetAuto
Set Function: RFmxLTE_ACPSetIFOutputPowerOffsetAuto
Values:
RFMXLTE_VAL_ACP_IF_OUTPUT_POWER_OFFSET_AUTO_FALSE (0) The measurement sets the IF output power level offset using the values of the RFMXLTE_ATTR_ACP_NEAR_IF_OUTPUT_POWER_OFFSET and RFMXLTE_ATTR_ACP_FAR_IF_OUTPUT_POWER_OFFSET attributes.
RFMXLTE_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.

RFMXLTE_ATTR_ACP_NEAR_IF_OUTPUT_POWER_OFFSET

Data Type: float64
Access: read/write
Functions: RFmxLTE_SetAttributeF64
RFmxLTE_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 RFMXLTE_ATTR_ACP_IF_OUTPUT_POWER_OFFSET_AUTO attribute to RFMXLTE_VAL_ACP_IF_OUTPUT_POWER_OFFSET_AUTO_FALSE and RFMXLTE_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXLTE_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: RFmxLTE_ACPGetNearIFOutputPowerOffset
Set Function: RFmxLTE_ACPSetNearIFOutputPowerOffset

RFMXLTE_ATTR_ACP_FAR_IF_OUTPUT_POWER_OFFSET

Data Type: float64
Access: read/write
Functions: RFmxLTE_SetAttributeF64
RFmxLTE_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 RFMXLTE_ATTR_ACP_IF_OUTPUT_POWER_OFFSET_AUTO attribute to RFMXLTE_VAL_ACP_IF_OUTPUT_POWER_OFFSET_AUTO_FALSE and RFMXLTE_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXLTE_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: RFmxLTE_ACPGetFarIFOutputPowerOffset
Set Function: RFmxLTE_ACPSetFarIFOutputPowerOffset

RFMXLTE_ATTR_ACP_SEQUENTIAL_FFT_SIZE

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies the FFT size, when you set the RFMXLTE_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXLTE_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: RFmxLTE_ACPGetSequentialFFTSize
Set Function: RFmxLTE_ACPSetSequentialFFTSize

RFMXLTE_ATTR_ACP_AMPLITUDE_CORRECTION_TYPE

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_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 RFMXLTE_VAL_ACP_AMPLITUDE_CORRECTION_TYPE_RF_CENTER_FREQUENCY.

Get Function: RFmxLTE_ACPGetAmplitudeCorrectionType
Set Function: RFmxLTE_ACPSetAmplitudeCorrectionType
Values:
RFMXLTE_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.
RFMXLTE_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.

RFMXLTE_ATTR_ACP_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 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 RFMXLTE_VAL_FALSE.

Get Function: RFmxLTE_ACPGetAllTracesEnabled
Set Function: RFmxLTE_ACPSetAllTracesEnabled

RFMXLTE_ATTR_ACP_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 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: RFmxLTE_ACPGetNumberOfAnalysisThreads
Set Function: RFmxLTE_ACPSetNumberOfAnalysisThreads

ACP Results

RFMXLTE_ATTR_ACP_RESULTS_TOTAL_AGGREGATED_POWER

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Returns the sum of powers of all the frequency bins over the integration bandwidths of all subblocks. The sum includes the power in inter-carrier gaps within a subblock but it does not include the power in subblock gaps.

When you set the RFMXLTE_ATTR_ACP_POWER_UNITS attribute to RFMXLTE_VAL_ACP_POWER_UNITS_DBM, the attribute returns the total integrated power in dBm of all the active carriers measured. When you set the RFMXLTE_ATTR_ACP_POWER_UNITS attribute to RFMXLTE_VAL_ACP_POWER_UNITS_DBM_BY_HZ, the attribute returns the power spectral density in dBm/Hz based on the power in all the active carriers measured.

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: RFmxLTE_ACPGetResultsTotalAggregatedPower

RFMXLTE_ATTR_ACP_RESULTS_SUBBLOCK_CENTER_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Returns the absolute center frequency of the subblock, which is the center of the subblock integration bandwidth. This value is expressed in Hz. Integration bandwidth is the span from the left edge of the leftmost carrier to the right edge of the rightmost carrier within the subblock.

Use 'subblock(n)' as the selector string to read this result.

Get Function: RFmxLTE_ACPGetResultsSubblockCenterFrequency

RFMXLTE_ATTR_ACP_RESULTS_SUBBLOCK_INTEGRATION_BANDWIDTH

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Returns the integration bandwidth used in calculating the power of the subblock. This value is expressed in Hz. Integration bandwidth is the span from left edge of the leftmost carrier to the right edge of the rightmost carrier within the subblock.

Use 'subblock(n)' as the selector string to read this result.



Get Function: RFmxLTE_ACPGetResultsSubblockIntegrationBandwidth

RFMXLTE_ATTR_ACP_RESULTS_SUBBLOCK_POWER

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Returns the sum of powers of all the frequency bins over the integration bandwidth of subblock.

When you set the RFMXLTE_ATTR_ACP_POWER_UNITS attribute to RFMXLTE_VAL_ACP_POWER_UNITS_DBM, the attribute returns the total subblock power in dBm of all the active carriers measured over the subblock. When you set the RFMXLTE_ATTR_ACP_POWER_UNITS attribute to RFMXLTE_VAL_ACP_POWER_UNITS_DBM_BY_HZ, the attribute returns the power spectral density in dBm/Hz based on the power in all the active carriers measured over the subblock.

Use 'subblock(n)' as the selector string to read this result.

Get Function: RFmxLTE_ACPGetResultsSubblockPower

ACP Results Cc

RFMXLTE_ATTR_ACP_RESULTS_COMPONENT_CARRIER_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Returns the power measured over the integration bandwidth of the carrier. The carrier power is reported in dBm when you set the RFMXLTE_ATTR_ACP_POWER_UNITS attribute to RFMXLTE_VAL_ACP_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXLTE_ATTR_ACP_POWER_UNITS attribute to RFMXLTE_VAL_ACP_POWER_UNITS_DBM_BY_HZ.

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

Get Function: RFmxLTE_ACPGetResultsComponentCarrierAbsolutePower

RFMXLTE_ATTR_ACP_RESULTS_COMPONENT_CARRIER_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Returns the component carrier power relative to its subblock power. This value is expressed in dB.

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



Get Function: RFmxLTE_ACPGetResultsComponentCarrierRelativePower

ACP Results Lower Offset

RFMXLTE_ATTR_ACP_RESULTS_LOWER_OFFSET_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Returns the lower (negative) offset channel power. For the intra-band non-contiguous type of carrier aggregation, if this offset is not applicable, a NaN is returned. The offset channel power is reported in dBm when you set the RFMXLTE_ATTR_ACP_POWER_UNITS attribute to RFMXLTE_VAL_ACP_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXLTE_ATTR_ACP_POWER_UNITS attribute to RFMXLTE_VAL_ACP_POWER_UNITS_DBM_BY_HZ.

Refer to the 3GPP 36.521 specification for more information about the applicability of an offset channel. Refer to the LTE Uplink Adjacent Channel Power and LTE Downlink Adjacent Channel Power topics for more information.

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

Get Function: RFmxLTE_ACPGetResultsLowerOffsetAbsolutePower

RFMXLTE_ATTR_ACP_RESULTS_LOWER_OFFSET_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Returns the power in lower (negative) offset channel relative to the total aggregated power. This value is expressed in dB. For the intra-band noncontiguous type of carrier aggregation, if this offset is not applicable, a NaN is returned. Refer to the 3GPP TS 36.521 specification for more information about the applicability of the offset channel.

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

Refer to the LTE Uplink Adjacent Channel Power and LTE Downlink Adjacent Channel Power topics for more information.

Get Function: RFmxLTE_ACPGetResultsLowerOffsetRelativePower

ACP Results Upper Offset

RFMXLTE_ATTR_ACP_RESULTS_UPPER_OFFSET_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Returns the upper (positive) offset channel power. For the intra-band noncontiguous type of carrier aggregation, if this offset is not applicable, the attribute returns a NaN. The offset channel power is reported in dBm when you set the RFMXLTE_ATTR_ACP_POWER_UNITS attribute to RFMXLTE_VAL_ACP_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXLTE_ATTR_ACP_POWER_UNITS attribute to RFMXLTE_VAL_ACP_POWER_UNITS_DBM_BY_HZ.

Refer to the 3GPP TS 36.521 specification for more information about the applicability of offset channel. Refer to the LTE Uplink Adjacent Channel Power and LTE Downlink Adjacent Channel Power topics for more information about ACP offsets.

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

Get Function: RFmxLTE_ACPGetResultsUpperOffsetAbsolutePower

RFMXLTE_ATTR_ACP_RESULTS_UPPER_OFFSET_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Returns the power in the upper (positive) offset channel relative to the total aggregated power. This value is expressed in dB. For the intra-band noncontiguous type of carrier aggregation, if this offset is not applicable, a NaN is returned. Refer to the 3GPP TS 36.521 specification for more information about the applicability of the offset channel.

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

Refer to the LTE Uplink Adjacent Channel Power and LTE Downlink Adjacent Channel Power topics for more information about ACP offsets.

Get Function: RFmxLTE_ACPGetResultsUpperOffsetRelativePower
⚠️ **GitHub.com Fallback** ⚠️