NIRFSG_ATTR_PHASE_CONTINUITY_ENABLED

NI-RFSG C Function

NIRFSG_ATTR_PHASE_CONTINUITY_ENABLED

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

Description

Specifies whether the driver maintains phase continuity in the arbitrary waveforms. When this attribute is set to NIRFSG_VAL_ENABLE, NI-RFSG may increase the waveform size. When this attribute is set to NIRFSG_VAL_ENABLE, the NIRFSG_ATTR_FREQUENCY_TOLERANCE attribute specifies the maximum allowable frequency error that can be introduced when keeping the signal phase-continuous. To set the NIRFSG_ATTR_PHASE_CONTINUITY_ENABLED attribute, the NI-RFSG device must be in the Configuration state.

NIRFSG_ATTR_PHASE_CONTINUITY_ENABLED only applies when the NIRFSG_ATTR_GENERATION_MODE attribute is set to NIRFSG_VAL_ARB_WAVEFORM or NIRFSG_VAL_SCRIPT.

  • NI 5671 — When using the NI 5671 with IQ rates ≤ 8.33 MS/s, an input phase-continuous signal is always phase-continuous upon output, and this attribute has no effect.
  • NI 5672 — Phase continuity is always enabled on this device.

Defined Values:

Phase Continuity Enabled Attribute Settings with IQ Rates > 8.33 MS/s.
Attribute SettingArb ModeScript Mode
NIRFSG_VAL_AUTOThe arbitrary waveform may be repeated to ensure phase continuity after upconversion. This setting could cause waveform size to increase. Warning condition — NI-RFSG cannot guarantee a phase-continuous output signal in script mode. Phase continuity is automatically disabled in script mode and the arbitrary waveform is played back without regard to any possible phase discontinuities introduced by upconversion.
NIRFSG_VAL_ENABLE The arbitrary waveform may be repeated to ensure phase continuity after upconversion. Enabling this attribute could cause waveform size to increase.Error condition — NI-RFSG cannot guarantee a phase-continuous output signal in script mode.
NIRFSG_VAL_DISABLED The arbitrary waveform is played back without regard to any possible phase discontinuities introduced by upconversion. The time duration of the original waveform is maintained. The arbitrary waveform is played back without regard to any possible phase discontinuities introduced by upconversion. The time duration of the original waveform is maintained.

Default Value: NIRFSG_VAL_AUTO

Supported Devices: NI 5670/5671/5672