GtDio6xTrigConfigSetJumpTrigger

Applies To

GX5296, GX5961, GX5964, File

Purpose

Sets the jump trigger settings.

Syntax

GtDio6xTrigConfigSetJumpTrigger (nHandle, nJumpTriggerNumber, nTriggerSource, bInvertTriggerSource, nLevelOrEdge, nTriggerResetMode, nStatus)

Parameters

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.

●     File handle is used when communicating with a file. The File handle session identifier is  returned by calling GtDio6xFileOpen.
nJumpTriggerNumber
SHORT
Specify the Jump Trigger to program:

0.  GTDIO6X_JUMP_TRIGGER_0: Jump Trigger 0.

1.  GTDIO6X_JUMP_TRIGGER_1: Jump Trigger 1.

2.  GTDIO6X_JUMP_TRIGGER_2: Jump Trigger 2.

3.  GTDIO6X_JUMP_TRIGGER_3: Jump Trigger 3.
nTriggerSource
SHORT
Specify the trigger source as follows:

0.  GTDIO6X_TRIGGER_SOURCE_NONE: No Signal is used as the jump trigger source.

1.    GTDIO6X_TRIGGER_SOURCE_AUX_0: Auxiliary channel 0 used as the jump trigger source (GX5961 only).

2.    GTDIO6X_TRIGGER_SOURCE_AUX_1: Auxiliary channel 1 used as the jump trigger source (GX5961 only).

3.    GTDIO6X_TRIGGER_SOURCE_AUX_2: Auxiliary channel 2 used as the jump trigger source (GX5961 only).

4.    GTDIO6X_TRIGGER_SOURCE_AUX_3: Auxiliary channel 3 used as the jump trigger source (GX5961 only).

5.    GTDIO6X_TRIGGER_SOURCE_AUX_4: Auxiliary channel 4 used as the jump trigger source (GX5961 only).

6.    GTDIO6X_TRIGGER_SOURCE_AUX_5: Auxiliary channel 5 used as the jump trigger source (GX5961 only).

7.    GTDIO6X_TRIGGER_SOURCE_AUX_6: Auxiliary channel 6 used as the jump trigger source (GX5961 only).

8.    GTDIO6X_TRIGGER_SOURCE_AUX_7: Auxiliary channel 7 used as the jump trigger source (GX5961 only).

9.    GTDIO6X_TRIGGER_SOURCE_AUX_8: Auxiliary channel 8 used as the jump trigger source. GX5961 TTL Input/Output.

10.  GTDIO6X_TRIGGER_SOURCE_AUX_9: Auxiliary channel 9 used as the jump trigger source. GX5961 TTL Input/Output.

11.  GTDIO6X_TRIGGER_SOURCE_AUX_10: Auxiliary channel 10 used as the jump trigger source. GX5961 TTL Input/Output.

12.  GTDIO6X_TRIGGER_SOURCE_AUX_11: Auxiliary channel 11 used as the jump trigger source. GX5961 TTL Input/Output.

13.  GTDIO6X_TRIGGER_SOURCE_CH_COMPARE_0: Channel Test Signal 0 used as the jump trigger source (GX5961 only).

14.  GTDIO6X_TRIGGER_SOURCE_LOCAL_BUS: Domain Resource used as the jump trigger source (GX5961 only).

15. GTDIO6X_TRIGGER_SOURCE_PXI_0: PXI Trigger 0 used as the jump trigger source.

16. GTDIO6X_TRIGGER_SOURCE_PXI_1 PXI Trigger 1 used as the jump trigger source.

17. GTDIO6X_TRIGGER_SOURCE_PXI_2 PXI Trigger 2 used as the jump trigger source.

18. GTDIO6X_TRIGGER_SOURCE_PXI_3 PXI Trigger 3 used as the jump trigger source.

19. GTDIO6X_TRIGGER_SOURCE_PXI_4 PXI Trigger 4 used as the jump trigger source.

20. GTDIO6X_TRIGGER_SOURCE_PXI_5 PXI Trigger 5 used as the jump trigger source.

21. GTDIO6X_TRIGGER_SOURCE_PXI_6 PXI Trigger 6 used as the jump trigger source.

22. GTDIO6X_TRIGGER_SOURCE_PXI_7 PXI Trigger 7 used as the jump trigger source.
bInvertTriggerSource
BOOL
Specifies the trigger inverter state as follows:

0.   FALSE: Disable signal inverter, do not modify input signal before testing.

1.   TRUE: Enable signal inverter, invert input signal before testing.
nLevelOrEdge
SHORT
Specifies the trigger test mode as follows:

0.    GTDIO6X_TRIGGER_ON_LOW_LEVEL: Trigger when a low logic level is detected.

1.    GTDIO6X_TRIGGER_ON_HIGH_LEVEL: Trigger when a high logic level is detected.

2.    GTDIO6X_TRIGGER_ON_RISING_EDGE: Trigger when a rising edge is detected.

3.    GTDIO6X_TRIGGER_ON_FALLING_EDGE: Trigger when a falling edge is detected.
nTriggerResetMode
SHORT
Specifies the trigger reset level/edge mode as follows:

0.    GTDIO6X_HALT_TRIGGER_RESET_ON_START: Reset trigger only at the beginning of burst.

1.    GTDIO6X_HALT_TRIGGER_RESET_ON_STEP_START_END_STEP: Reset trigger at the beginning and end of each step.

2.  GTDIO6X_HALT_TRIGGER_RESET_ON_STEP_START_RESUME: Reset trigger at the beginning of each step and when execution is resumed.

Note: The trigger reset level/edge mode settings is common to Jump Trigger 0 through Jump Trigger 3.
pnStatus
PSHORT
Returned status: 0 on success, negative value on failure.

Comments

This function programs one of the four sequencer jump triggers. Four sequencer jumps triggers are available.  The sequencer jump triggers are used for conditional jumping/looping. A jump/loop can be based on the true/false state of any of the four sequencer jump triggers.  For example, if jump trigger 1 test mode is set to 'Low Level', then a jump if trigger 1 true would occur if the selected jump trigger 1 source is low.

Example

The following example sets the jump trigger as follows:

●     Program Jump Trigger 1.

●     Trigger source is Channel Test Signal 0 used as the halt trigger source.

●     Enable signal inverter, invert input signal before testing.

●     Trigger when a rising edge is detected.

●     Reset trigger only at the beginning of burst.

 

SHORT nJumpTriggerNumber, nTriggerSource, nLevelOrEdge, nTriggerResetMode;

SHORT nStatus;

BOOL bInvertTriggerSource;

 

GtDio6xTrigConfigSetJumpTrigger (nHandle, GTDIO6X_JUMP_TRIGGER_1, GTDIO6X_TRIGGER_SOURCE_CH_COMPARE_0, TRUE, GTDIO6X_TRIGGER_ON_RISING_EDGE, GTDIO6X_HALT_TRIGGER_RESET_ON_START, &nStatus);

 

GtDio6xTrigConfigGetJumpTrigger (nHandle, &nJumpTriggerNumber, &nTriggerSource, &bInvertTriggerSource, &nLevelOrEdge, &nTriggerResetMode, &nStatus);

 

See Also

GtDio6xTrigConfigSetHaltTrigger, GtDio6xTrigConfigSetJumpTrigger, GtDio6xTrigConfigSetLocalBusTriggerSource, GtDio6xTrigConfigSetPauseResumeTrigger, GtDio6xTrigConfigSetPxiTrigger, GtDio6xTrigConfigSetRunTrigger, GtDio6xTrigConfigSetStopTrigger, GtDio6xGetErrorString