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

CHP Attributes

RFMXLTE_ATTR_CHP_MEASUREMENT_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies whether to enable the channel power 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_CHPGetMeasurementEnabled
Set Function: RFmxLTE_CHPSetMeasurementEnabled

RFMXLTE_ATTR_CHP_INTEGRATION_BANDWIDTH_TYPE

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies the integration bandwidth (IBW) type used to measure the power of the acquired signal.

Integration bandwidth is the frequency interval over which the power in each frequency bin is added to measure the total power in that interval.

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

Refer to the LTE Channel Power topic for more information about CHP IBW types.

The default value is RFMXLTE_VAL_CHP_INTEGRATION_BANDWIDTH_TYPE_SIGNAL_BANDWIDTH.

Get Function: RFmxLTE_CHPGetIntegrationBandwidthType
Set Function: RFmxLTE_CHPSetIntegrationBandwidthType
Values:
RFMXLTE_VAL_CHP_INTEGRATION_BANDWIDTH_TYPE_SIGNAL_BANDWIDTH (0) The IBW excludes the guard bands at the edges of the carrier or subblock.
RFMXLTE_VAL_CHP_INTEGRATION_BANDWIDTH_TYPE_CHANNEL_BANDWIDTH (1) The IBW includes the guard bands at the edges of the carrier or subblock.

RFMXLTE_ATTR_CHP_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_CHPGetSubblockIntegrationBandwidth

CHP Cc

RFMXLTE_ATTR_CHP_COMPONENT_CARRIER_INTEGRATION_BANDWIDTH

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Specifies the integration bandwidth of a 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_CHPGetComponentCarrierIntegrationBandwidth

CHP Rbwfilter

RFMXLTE_ATTR_CHP_RBW_FILTER_AUTO_BANDWIDTH

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

Get Function: RFmxLTE_CHPGetRBWFilterAutoBandwidth
Set Function: RFmxLTE_CHPSetRBWFilterAutoBandwidth
Values:
RFMXLTE_VAL_CHP_RBW_FILTER_AUTO_BANDWIDTH_FALSE (0) The measurement uses the RBW that you specify in the RFMXLTE_ATTR_CHP_RBW_FILTER_BANDWIDTH attribute.
RFMXLTE_VAL_CHP_RBW_FILTER_AUTO_BANDWIDTH_TRUE (1) The measurement computes the RBW.

RFMXLTE_ATTR_CHP_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_CHP_RBW_FILTER_AUTO_BANDWIDTH attribute to RFMXLTE_VAL_CHP_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_CHPGetRBWFilterBandwidth
Set Function: RFmxLTE_CHPSetRBWFilterBandwidth

RFMXLTE_ATTR_CHP_RBW_FILTER_TYPE

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies the shape of the digital 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_CHP_RBW_FILTER_TYPE_FFT_BASED.

Get Function: RFmxLTE_CHPGetRBWFilterType
Set Function: RFmxLTE_CHPSetRBWFilterType
Values:
RFMXLTE_VAL_CHP_RBW_FILTER_TYPE_FFT_BASED (0) No RBW filtering is performed.
RFMXLTE_VAL_CHP_RBW_FILTER_TYPE_GAUSSIAN (1) An RBW filter with a Gaussian response is applied.
RFMXLTE_VAL_CHP_RBW_FILTER_TYPE_FLAT (2) An RBW filter with a flat response is applied.

CHP Tweep Time

RFMXLTE_ATTR_CHP_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_CHP_SWEEP_TIME_AUTO_TRUE.

Get Function: RFmxLTE_CHPGetSweepTimeAuto
Set Function: RFmxLTE_CHPSetSweepTimeAuto
Values:
RFMXLTE_VAL_CHP_SWEEP_TIME_AUTO_FALSE (0) The measurement uses the sweep time that you specify in the RFMXLTE_ATTR_CHP_SWEEP_TIME_INTERVAL attribute.
RFMXLTE_VAL_CHP_SWEEP_TIME_AUTO_TRUE (1) The measurement uses a sweep time of 1 ms.

RFMXLTE_ATTR_CHP_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_CHP_SWEEP_TIME_AUTO attribute to RFMXLTE_VAL_CHP_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_CHPGetSweepTimeInterval
Set Function: RFmxLTE_CHPSetSweepTimeInterval

CHP Noisecal

RFMXLTE_ATTR_CHP_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 initiated 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 Auto

Get Function: RFmxLTE_CHPGetNoiseCalibrationMode
Set Function: RFmxLTE_CHPSetNoiseCalibrationMode
Values:
RFMXLTE_VAL_CHP_NOISE_CALIBRATION_MODE_MANUAL (0) When you set the RFMXLTE_ATTR_CHP_MEASUREMENT_MODE attribute to Noise Calibrate, you can initiate instrument noise calibration for CHP manually. When you set the RFMXLTE_ATTR_CHP_MEASUREMENT_MODE attribute to RFMXLTE_VAL_CHP_MEASUREMENT_MODE_MEASURE, you can initiate the CHP measurement manually.
RFMXLTE_VAL_CHP_NOISE_CALIBRATION_MODE_AUTO (1) When you set the RFMXLTE_ATTR_CHP_NOISE_COMPENSATION_ENABLED attribute to RFMXLTE_VAL_CHP_NOISE_COMPENSATION_ENABLED_TRUE, the RFmx sets the Input Isolation Enabled attribute to Enabled and calibrates the instrument noise in the current state of the instrument.The RFmx then resets the Input Isolation Enabled attribute and performs the CHP 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.

CHP Noisecal Averaging

RFMXLTE_ATTR_CHP_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_CHP_NOISE_CALIBRATION_AVERAGING_AUTO_TRUE.

Get Function: RFmxLTE_CHPGetNoiseCalibrationAveragingAuto
Set Function: RFmxLTE_CHPSetNoiseCalibrationAveragingAuto
Values:
RFMXLTE_VAL_CHP_NOISE_CALIBRATION_AVERAGING_AUTO_FALSE (0) The RFmx uses the averages that you set for the RFMXLTE_ATTR_CHP_NOISE_CALIBRATION_AVERAGING_COUNT attribute.
RFMXLTE_VAL_CHP_NOISE_CALIBRATION_AVERAGING_AUTO_TRUE (1) The RFmx uses a noise calibration averaging count of 32.

RFMXLTE_ATTR_CHP_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_CHP_NOISE_CALIBRATION_AVERAGING_AUTO attribute to RFMXLTE_VAL_CHP_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_CHPGetNoiseCalibrationAveragingCount
Set Function: RFmxLTE_CHPSetNoiseCalibrationAveragingCount

CHP Noisecomp

RFMXLTE_ATTR_CHP_NOISE_COMPENSATION_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies whether RFmx compensates for the instrument noise when performing the measurement. To compensate for instrument noise when performing a CHP measurement, set the RFMXLTE_ATTR_CHP_NOISE_CALIBRATION_MODE attribute to RFMXLTE_VAL_CHP_NOISE_CALIBRATION_MODE_AUTO, or set the RFMXLTE_ATTR_CHP_NOISE_CALIBRATION_MODE attribute to RFMXLTE_VAL_CHP_NOISE_CALIBRATION_MODE_MANUAL and the RFMXLTE_ATTR_CHP_MEASUREMENT_MODE attribute to RFMXLTE_VAL_CHP_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_CHP_NOISE_COMPENSATION_ENABLED_FALSE.

Get Function: RFmxLTE_CHPGetNoiseCompensationEnabled
Set Function: RFmxLTE_CHPSetNoiseCompensationEnabled
Values:
RFMXLTE_VAL_CHP_NOISE_COMPENSATION_ENABLED_FALSE (0) Disables noise compensation.
RFMXLTE_VAL_CHP_NOISE_COMPENSATION_ENABLED_TRUE (1) Enables noise compensation.

RFMXLTE_ATTR_CHP_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_CHP_NOISE_COMPENSATION_TYPE_ANALYZER_AND_TERMINATION.

Get Function: RFmxLTE_CHPGetNoiseCompensationType
Set Function: RFmxLTE_CHPSetNoiseCompensationType
Values:
RFMXLTE_VAL_CHP_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_CHP_NOISE_COMPENSATION_TYPE_ANALYZER_ONLY (1) Compensates only for analyzer noise.

CHP Averaging

RFMXLTE_ATTR_CHP_AVERAGING_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxLTE_SetAttributeI32
RFmxLTE_GetAttributeI32
Description: Specifies whether to enable averaging for the CHP 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_CHP_AVERAGING_ENABLED_FALSE.

Get Function: RFmxLTE_CHPGetAveragingEnabled
Set Function: RFmxLTE_CHPSetAveragingEnabled
Values:
RFMXLTE_VAL_CHP_AVERAGING_ENABLED_FALSE (0) The measurement is performed on a single acquisition.
RFMXLTE_VAL_CHP_AVERAGING_ENABLED_TRUE (1) The CHP measurement uses the value of the RFMXLTE_ATTR_CHP_AVERAGING_COUNT attribute as the number of acquisitions over which the CHP measurement is averaged.

RFMXLTE_ATTR_CHP_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_CHP_AVERAGING_ENABLED attribute to RFMXLTE_VAL_CHP_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_CHPGetAveragingCount
Set Function: RFmxLTE_CHPSetAveragingCount

RFMXLTE_ATTR_CHP_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 CHP 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_CHP_AVERAGING_TYPE_RMS.

Get Function: RFmxLTE_CHPGetAveragingType
Set Function: RFmxLTE_CHPSetAveragingType
Values:
RFMXLTE_VAL_CHP_AVERAGING_TYPE_RMS (0) The power spectrum is linearly averaged. RMS averaging reduces signal fluctuations but not the noise floor.
RFMXLTE_VAL_CHP_AVERAGING_TYPE_LOG (1) The power spectrum is averaged in a logarithmic scale.
RFMXLTE_VAL_CHP_AVERAGING_TYPE_SCALAR (2) The square root of the power spectrum is averaged.
RFMXLTE_VAL_CHP_AVERAGING_TYPE_MAXIMUM (3) The peak power in the spectrum at each frequency bin is retained from one acquisition to the next.
RFMXLTE_VAL_CHP_AVERAGING_TYPE_MINIMUM (4) The lowest power in the spectrum at each frequency bin is retained from one acquisition to the next.

RFMXLTE_ATTR_CHP_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 CHP 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_CHP_MEASUREMENT_MODE_MEASURE.

Get Function: RFmxLTE_CHPGetMeasurementMode
Set Function: RFmxLTE_CHPSetMeasurementMode
Values:
RFMXLTE_VAL_CHP_MEASUREMENT_MODE_MEASURE (0) CHP measurement is performed on the acquired signal.
RFMXLTE_VAL_CHP_MEASUREMENT_MODE_CALIBRATE_NOISE_FLOOR (1) Manual noise calibration of the signal analyzer is performed for the CHP measurement.

RFMXLTE_ATTR_CHP_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_CHP_AMPLITUDE_CORRECTION_TYPE_RF_CENTER_FREQUENCY.

Get Function: RFmxLTE_CHPGetAmplitudeCorrectionType
Set Function: RFmxLTE_CHPSetAmplitudeCorrectionType
Values:
RFMXLTE_VAL_CHP_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_CHP_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_CHP_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 CHP 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_CHPGetAllTracesEnabled
Set Function: RFmxLTE_CHPSetAllTracesEnabled

RFMXLTE_ATTR_CHP_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 CHP 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_CHPGetNumberOfAnalysisThreads
Set Function: RFmxLTE_CHPSetNumberOfAnalysisThreads

CHP Results

RFMXLTE_ATTR_CHP_RESULTS_TOTAL_AGGREGATED_POWER

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Returns the total power of all the subblocks. This value is expressed in dBm. 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.

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_CHPGetResultsTotalAggregatedPower

RFMXLTE_ATTR_CHP_RESULTS_SUBBLOCK_FREQUENCY

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

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



Get Function: RFmxLTE_CHPGetResultsSubblockFrequency

RFMXLTE_ATTR_CHP_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. Integration bandwidth is the span from left edge of the leftmost carrier to the right edge of the rightmost carrier within the subblock. This value is expressed in Hz.

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



Get Function: RFmxLTE_CHPGetResultsSubblockIntegrationBandwidth

RFMXLTE_ATTR_CHP_RESULTS_SUBBLOCK_POWER

Data Type: float64
Access: read only
Functions: RFmxLTE_GetAttributeF64
Description: Returns the sum of total power of all the frequency bins over the integration bandwidth of the subblock. This value includes the power in inter-carrier gaps within a subblock. This value is expressed in dBm.

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



Get Function: RFmxLTE_CHPGetResultsSubblockPower

CHP Results Cc

RFMXLTE_ATTR_CHP_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 component carrier. This value is expressed in dBm.

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



Get Function: RFmxLTE_CHPGetResultsComponentCarrierAbsolutePower

RFMXLTE_ATTR_CHP_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_CHPGetResultsComponentCarrierRelativePower
⚠️ **GitHub.com Fallback** ⚠️