GtWaveSetTriggerMode

Supported By

GX1110, GX1120

Applies To

Function Generator and Arbitrary Waveform Generator modes.

Purpose

Sets the trigger mode.

Syntax

GtWaveSetTriggerMode (nHandle, nChannel, nMode, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Handle to a GX11X0 board.
nChannel
SHORT
Specified Channel number.
GX1120:
0 = GTWAVE_CHANNEL_A: Channel A.
GX1120:
0 = GTWAVE_CHANNEL_A: Channel A.
1 = GTWAVE_CHANNEL_B: Channel B.
nMode
SHORT
Trigger mode are:
0.        GTWAVE_TRIGGER_MODE_CONTINUOUS
1.        GTWAVE_TRIGGER_MODE_TRIGGERED
2.        GTWAVE_TRIGGER_MODE_GATED
3.        GTWAVE_TRIGGER_MODE_BURST
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

Function Generator:
GTWAVE_TRIGGER_MODE_CONTINUOUS
The waveform generates continuously by repeatedly cycling through the waveform table using the programmed waveform parameters.
GTWAVE_TRIGGER_MODE_TRIGGERED
Output is quiescent until triggered by an internal or external trigger, and then one waveform cycle is generated using the programmed waveform parameters.
GTWAVE_TRIGGER_MODE_GATED
The waveform generates continuously by repeatedly cycling through the waveform table as long as the gate is active
GTWAVE_TRIGGER_MODE_BURST
After a trigger is received, waveform generation will be executed for the number of cycles that were defined via the GtWaveGetTriggerBurstCount function
Arbitrary Waveform Generator mode:
GTWAVE_TRIGGER_MODE_CONTINUOUS
The waveform generates continuously by repeatedly cycling through the defined waveform length using the programmed waveform parameters. The waveform generation starts from the specified first address and continues through to the specified waveform length. After the last step is completed, the waveform generation loops back to the specified first address and continues until it is stopped.
GTWAVE_TRIGGER_MODE_TRIGGERED
Output is quiescent until triggered by an internal or external trigger, then one waveform cycle is generated using the programmed waveform parameters.
GTWAVE_TRIGGER_MODE_GATED
The waveform generates continuously  by repeatedly cycling through the waveform table as long as the gate is active
GTWAVE_TRIGGER_MODE_BURST
After a trigger is received, waveform generation starts from the specified first address and continues through to the specified waveform length. Waveform generation will be executed for the  number of cycles that were defined via the GtWaveGetTriggerBurstCount function.

The function calls GtWaveSynchronizePhases API before returning.

Example

The following example sets trigger mode to continuous:

 

GtWaveSetTriggerMode (nHandle, GTWAVE_CHANNEL_A, GTWAVE_TRIGGER_MODE_CONTINUOUS, &nStatus);

 

See Also

GtWaveInitialize, GtWaveGetErrorString