NI RFSG IQ Impairment Attributes - ni/grpc-device GitHub Wiki

IQ Impairment Attributes

NIRFSG_ATTR_IQ_IMPAIRMENT_ENABLED

Numeric Value Data
type
Access Coercion High Level Functions
1150069 ViBoolean R/W None None

Description

Enables or disables I/Q impairment. The NIRFSG_ATTR_IQ_I_OFFSET, NIRFSG_ATTR_IQ_Q_OFFSET, NIRFSG_ATTR_IQ_GAIN_IMBALANCE, and NIRFSG_ATTR_IQ_SKEW attributes are ignored when the NIRFSG_ATTR_IQ_IMPAIRMENT_ENABLED attribute is disabled.

Defined Values:

VI_TRUE I/Q impairment is enabled.
VI_FALSE I/Q impairment is disabled.
Default Value: VI_TRUE

Supported Devices: PXIe-5644/5645/5646, PXIe-5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

NIRFSG_ATTR_IQ_GAIN_IMBALANCE

Numeric Value Data
type
Access Coercion High Level Functions
1150072 ViReal64 R/W None None

Description

Specifies the gain imbalance of the I/Q modulator (I versus Q).

Gain imbalance is calculated with the following equation:

Units: dB

Valid Values: -6 dB to 6 dB

Default Value: 0 dB

Supported Devices: PXIe-5644/5645/5646, PXIe-5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Impairment Calibration

Spurious Performance

NIRFSG_ATTR_IQ_I_OFFSET

Numeric Value Data
type
Access Coercion High Level Functions
1150070 ViReal64 R/W None None

Description

When using a National Instruments AWG module or vector signal transceiver (VST), this attribute specifies the I-signal DC offset. Units are either percent (%) or volts (V), depending on the NIRFSG_ATTR_IQ_OFFSET_UNITS attribute setting.

PXIe-5673/5673E: Actual AWG signal offset is equal to the I/Q modulator offset correction plus the value specified by this attribute. When using an external AWG (non–National Instruments AWG), this attribute is read-only and indicates the I/Q modulator I-offset. Units are volts, as specified by the NIRFSG_ATTR_IQ_OFFSET_UNITS attribute.

Valid Values: -100 to 100% or -0.2 V to 0.2 V

Supported Devices: PXIe-5644/5645/5646, PXIe-5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Impairment Calibration

NIRFSG_ATTR_IQ_SKEW

Numeric Value Data
type
Access Coercion High Level Functions
1150073 ViReal64 R/W None None

Description

Specifies the adjustment of the phase angle between the I and Q vectors. If the skew is zero, the phase angle is 90 degrees.

This attribute is ignored when the NIRFSG_ATTR_IQ_IMPAIRMENT_ENABLED attribute is disabled.

Units: degrees (°)

Valid Values: -30° to 30°

Supported Devices: PXIe-5644/5645/5646, PXIe-5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Impairment Calibration

NIRFSG_ATTR_IQ_OFFSET_UNITS

Numeric Value Data
type
Access Coercion High Level Functions
1150081 ViInt32 R/W None None

Description

Specifies the units of the NIRFSG_ATTR_IQ_I_OFFSET attribute and NIRFSG_ATTR_IQ_Q_OFFSET attribute. Offset units are either percent or volts.

The AWG or VST offset is the specified percentage of the AWG or VST peak power level when the NIRFSG_ATTR_IQ_OFFSET_UNITS attribute is set to NIRFSG_VAL_PERCENT. Given perfect carrier leakage suppression, the following equation is satisfied

or equivalently

If the NIRFSG_ATTR_IQ_I_OFFSET attribute is set to 100%, NIRFSG_ATTR_IQ_Q_OFFSET attribute is set to 0%, and NIRFSG_ATTR_POWER_LEVEL attribute set to 0 dBm, the desired RF signal is at 0 dBm and the carrier leakage is also at 0 dBm.

Note  For any devices except PXIe-5820, if the NIRFSG_ATTR_IQ_OFFSET_UNITS attribute is set to NIRFSG_VAL_VOLTS, a 0.1 I offset results in a 0.1 V offset in the output. For PXIe-5820 devices, 0.1 I offset results in a 10% offset in the output.
The AWG or VST peak power level changes when settings change in other attributes such as the NIRFSG_ATTR_POWER_LEVEL, NIRFSG_ATTR_FREQUENCY, NIRFSG_ATTR_IQ_SKEW, NIRFSG_ATTR_IQ_GAIN_IMBALANCE, NIRFSG_ATTR_ATTENUATOR_HOLD_ENABLED, and NIRFSG_ATTR_ARB_PRE_FILTER_GAIN attributes. When the NIRFSG_ATTR_IQ_OFFSET_UNITS attribute is set to NIRFSG_VAL_PERCENT, the actual AWG or VST offset changes as the AWG or VST peak power level changes to satisfy the preceding equations. These changes are useful if you are intentionally adding carrier leakage to test the tolerance of a receiver. When the NIRFSG_ATTR_IQ_OFFSET_UNITS attribute is set to NIRFSG_VAL_PERCENT, the carrier leakage, in dBc, remains at a consistent level.

If you are trying to eliminate residual carrier leakage due to calibration inaccuracies or drift, set the NIRFSG_ATTR_IQ_OFFSET_UNITS attribute to NIRFSG_VAL_VOLTS. Offset correction voltage is applied to the I/Q modulator or VST, regardless of changes to the AWG or VST peak power level.

NIRFSG_VAL_PERCENT Specifies the NIRFSG_ATTR_IQ_I_OFFSET and NIRFSG_ATTR_IQ_Q_OFFSET attribute units as percent.
NIRFSG_VAL_VOLTS Specifies the NIRFSG_ATTR_IQ_I_OFFSET and NIRFSG_ATTR_IQ_Q_OFFSET attribute units as volts.
Default Value: NIRFSG_VAL_PERCENT

Supported Devices: PXIe-5644/5645/5646, PXIe-5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

NIRFSG_ATTR_IQ_Q_OFFSET

Numeric Value Data
type
Access Coercion High Level Functions
1150071 ViReal64 R/W None None

Description

When using a National Instruments AWG module or VST device, this attribute specifies the Q-signal DC offset. Units are either percent (%) or volts (V), depending on the NIRFSG_ATTR_IQ_OFFSET_UNITS attribute setting.

PXIe-5673/5673E: Actual AWG signal offset is equal to the I/Q modulator offset correction plus the value specified by this attribute. When using an external AWG (non–National Instruments AWG), the NIRFSG_ATTR_IQ_Q_OFFSET attribute is read-only and indicates the I/Q modulator Q-offset. Units are volts, as indicated by the NIRFSG_ATTR_IQ_OFFSET_UNITS attribute.

Valid Values: -100% to 100% or -0.2 V to 0.2 V

Supported Devices: PXIe-5644/5645/5646, PXIe-5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Impairment Calibration

⚠️ **GitHub.com Fallback** ⚠️