NIRFSG_ATTR_UPCONVERTER_FREQUENCY_OFFSET_MODE
- Updated2025-05-22
- 2 minute(s) read
NIRFSG_ATTR_UPCONVERTER_FREQUENCY_OFFSET_MODE
Specific Attribute
| Numeric Value | Data type |
Access | Coercion | High Level Functions |
|---|---|---|---|---|
| 1150248 | ViInt32 | R/W | None | None |
Description
Specifies whether to allow NI-RFSG to select the upconverter frequency offset. You can either set an offset yourself or let NI-RFSG select one for you.
Placing the upconverter center frequency outside the bandwidth of your waveform can help avoid issues such as LO leakage.
To set an offset yourself, set this attribute to NIRFSG_VAL_AUTOMATIC or NIRFSG_VAL_USER_DEFINED, and set either the NIRFSG_ATTR_UPCONVERTER_CENTER_FREQUENCY or the NIRFSG_ATTR_UPCONVERTER_FREQUENCY_OFFSET attribute.
To allow NI-RFSG to automatically select the upconverter frequency offset, set this attribute to NIRFSG_VAL_AUTOMATIC or NIRFSG_VAL_ENABLED and set the NIRFSG_ATTR_SIGNAL_BANDWIDTH to describe the bandwidth of your waveform. The signal bandwidth must be no greater than half the value of the NIRFSG_ATTR_DEVICE_INSTANTANEOUS_BANDWIDTH attribute, minus a device-specific guard band. Do not set the NIRFSG_ATTR_UPCONVERTER_CENTER_FREQUENCY or NIRFSG_ATTR_UPCONVERTER_FREQUENCY_OFFSET attributes. If all conditions are met, NI-RFSG places the upconverter center frequency outside the signal bandwidth. Set this attribute to NIRFSG_VAL_ENABLED if you want to receive an error any time NI-RFSG is unable to apply automatic offset.
When you set an offset yourself or do not use an offset, the reference frequency for gain is near the upconverter center frequency, and NIRFSG_UPCONVERTER_FREQUENCY_OFFSET_MODE returns NIRFSG_VAL_USER_DEFINED. When NI-RFSG automatically sets an offset, the reference frequency for gain is near the RF frequency, and NIRFSG_UPCONVERTER_FREQUENCY_OFFSET_MODE returns NIRFSG_VAL_ENABLED.
 |
Note Below 120 MHz, the PXIe-5841 does not use an LO and NIRFSG_VAL_ENABLED is unavailable. Refer to the PXIe-5841 Automatic Frequency Offset topic for more information about using an automatic offset with an external LO. |
| NIRFSG_VAL_ENABLE | NI-RFSG places the upconverter center frequency outside of the signal bandwidth if the NIRFSG_ATTR_SIGNAL_BANDWIDTH attribute has been set and can be avoided. NI-RFSG returns an error if the NIRFSG_ATTR_SIGNAL_BANDWIDTH attribute has not been set, or if the signal bandwidth is too large. |
| NIRFSG_VAL_AUTO | NI-RFSG places the upconverter center frequency outside of the signal bandwidth if the NIRFSG_ATTR_SIGNAL_BANDWIDTH attribute has been set and can be avoided. |
| NIRFSG_VAL_USER_DEFINED | NI-RFSG uses the offset that you specified with the NIRFSG_ATTR_UPCONVERTER_FREQUENCY_OFFSET or NIRFSG_ATTR_UPCONVERTER_CENTER_FREQUENCY attributes. |
Default Value: NIRFSG_VAL_AUTO
Supported Devices: PXIe-5830/5831/5832/5841/5842
Related Topics
PXIe-5830 Automatic Frequency Offset