IviRFSigGen_ConfigureSweep

CVI/LabWindows IVI Class Driver

IviRFSigGen_ConfigureSweep

IviRFSigGenSweep Capability Group

C Function Prototype

ViStatus IviRFSigGen_ConfigureSweep (ViSession vi, ViInt32 mode, ViInt32 triggerSource);

Purpose

This function configures the signal generator sweep mode and trigger source.

Parameters

Name Type Description
vi ViSession The ViSession handle that you obtain from the IviRFSigGen_init or IviRFSigGen_InitWithOptions function. The handle identifies a particular instrument session.

Default Value: None

mode ViInt32 Specifies the sweep mode applied to the output signal. The driver uses this value to set the IVIRFSIGGEN_ATTR_SWEEP_MODE attribute.

Defined Values:

IVIRFSIGGEN_VAL_SWEEP_MODE_NONE - The RF output of
the signal generator is a non-swept signal (Continuous
Wave) using the frequency and power/level specified in
the IviRFSigGen_ConfigureRF function.

IVIRFSIGGEN_VAL_SWEEP_MODE_FREQUENCY_SWEEP - The signal
generator sweeps the RF output signal's frequency
in an analog form (non-stepped).

IVIRFSIGGEN_VAL_SWEEP_MODE_POWER_SWEEP - The signal
generator sweeps the RF output signal's power
in an analog form (non-stepped).

IVIRFSIGGEN_VAL_SWEEP_MODE_FREQUENCY_STEP - The
signal generator sweeps the RF output signals frequency in
steps.

IVIRFSIGGEN_VAL_SWEEP_MODE_POWER_STEP - The signal
generator sweeps the RF output signals power level in steps.

IVIRFSIGGEN_VAL_SWEEP_MODE_LIST - The signal
generator uses two lists with frequency and power level
values to sweep the RF output signals.

Default Value: IVIRFSIGGEN_VAL_SWEEP_MODE_NONE

triggerSource ViInt32 Specifies the trigger used to start a sweep operation. The driver uses this value to set the IVIRFSIGGEN_ATTR_SWEEP_TRIGGER_SOURCE attribute.

Defined Values:

IVIRFSIGGEN_VAL_SWEEP_TRIGGER_SOURCE_IMMEDIATE - The
sweep system does not wait for a trigger of any kind, so it
is running continuously.

IVIRFSIGGEN_VAL_SWEEP_TRIGGER_SOURCE_EXTERNAL - The
sweep is started with an external signal.

IVIRFSIGGEN_VAL_SWEEP_TRIGGER_SOURCE_SOFTWARE - The
sweep is started with a software programmable trigger.

Default Value: IVIRFSIGGEN_VAL_SWEEP_TRIGGER_SOURCE_IMMEDIATE

Return Values