GX5296, GX5961, GX5964
Runs the sequencer starting at the specified Step with the specified run mode.
GtDio6xSequencerRunEx (nHandle, lStep, nRunMode, pnStatus)
Name |
Type |
Comments |
nHandle |
SHORT |
Session identifier:● Board handle is used when communicating with the hardware. The Board handle session identifier is returned by calling GtDio6xInitialize or GtDio6xSetupInitialization. |
lStep |
LONG |
Specify the Step number to start execute form, 0-4095. |
nRunMode |
SHORT |
Specify the sequencer run mode as follows:0. GTDIO6X_SEQUENCER_RUN_MODE_DEFAULT: In this mode the function primes the sequencer and all of its components (Timing sets values, Vector contents, Steps vector count and offsets) and issues a software trigger. The function runs the same as calling GtDio6xSequencerRun() API.1. GTDIO6X_SEQUENCER_RUN_MODE_FAST: Fastest execution of the Sequencer run command, this mode should only be used if the DIO domain was set, and Timing sets values, Vector contents, Steps vector count and offsets are unchanged between runs. The user will need to issues GtDio6xSequencerArm command prior using this mode. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative value on failure. |
Using the GTDIO6X_SEQUENCER_RUN_MODE_FAST mode, there is no latency between consecutive run commands, while the DIO domain settings (Timing sets values, Vector contents, Steps vector count and offsets) was not changed. The user must call GtDio6xSequencerArm API prior to using this mode.
The following example runs Step 0, with a fast execution:
SHORT nStatus;
GtDio6xArm(nHandle, 0,&nStatus);
GtDio6xSequencerRunEx(nHandle, 0, GTDIO6X_SEQUENCER_RUN_MODE_FAST, &nStatus);
GtDio6xSequencerArm, GtDio6xSequencerArmIdleStep, GtDio6xSequencerHalt, GtDio6xSequencerReset, GtDio6xSequencerResume, GtDio6xSequencerRun, GtDio6xSequencerRunIdleStep, GtDio6xSequencerSetBurstCount, GtDio6xSequencerSetChannelsCompareTrigger, GtDio6xSequencerSetRunCompletionMode, GtDio6xSequencerSetFreqSynth, GtDio6xSequencerSetHaltMode, GtDio6xSequencerSetIdleStep, GtDio6xSequencerSetLoopCounterMode, GtDio6xSequencerSetMasterClockSource, GtDio6xSequencerSetRecordOffset, GtDio6xSequencerSetRecordParameters, GtDio6xSequencerSetStopMode, GtDio6xSequencerSetSyncPulseSource, GtDio6xSequencerSetSyncPulseParameters, GtDio6xSequencerSetSystemClockExternal, GtDio6xSequencerSetSystemClockSource, GtDio6xSequencerStop, GtDio6xGetErrorString