NI RFmx LTE CHP Attributes - ni/grpc-device GitHub Wiki
- RFMXLTE_ATTR_CHP_MEASUREMENT_ENABLED
- RFMXLTE_ATTR_CHP_INTEGRATION_BANDWIDTH_TYPE
- RFMXLTE_ATTR_CHP_SUBBLOCK_INTEGRATION_BANDWIDTH
- Component Carrier
- RBW Filter
- Sweep Time
- Noise Calibration
- Noise Compensation
- Averaging
- RFMXLTE_ATTR_CHP_MEASUREMENT_MODE
- RFMXLTE_ATTR_CHP_AMPLITUDE_CORRECTION_TYPE
- RFMXLTE_ATTR_CHP_ALL_TRACES_ENABLED
- RFMXLTE_ATTR_CHP_NUMBER_OF_ANALYSIS_THREADS
- Results
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 |
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. |
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 |
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 |
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. |
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 |
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. |
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. |
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 |
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. |
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. |
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 |
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. |
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. |
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. |
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 |
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. |
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. |
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. |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |