GX5296, GX5961, GX5964, File
Sets the pause trigger settings.
GtDio6xTrigConfigSetPauseTrigger (nHandle, nPauseTriggerNumber, nTriggerSource, bInvertTriggerSource, nLevelOrEdge, nTriggerResetMode, 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. ● File handle is used when communicating with a file. The File handle session identifier is returned by calling GtDio6xFileOpen. |
nResumeTriggerNumber |
SHORT |
Specify the Resume trigger number to program:0. GTDIO6X_RESUME_TRIGGER_0: Resume Trigger 0. 1. GTDIO6X_RESUME_TRIGGER_1: Resume Trigger 1. |
nTriggerSource |
SHORT |
Set the trigger source as follows:0. GTDIO6X_TRIGGER_SOURCE_NONE: No Signal is used as the pause resume trigger source. 1. GTDIO6X_TRIGGER_SOURCE_AUX_0: Auxiliary channel 0 used as the pause resume trigger source. 2. GTDIO6X_TRIGGER_SOURCE_AUX_1: Auxiliary channel 1 used as the pause resume trigger source. 3. GTDIO6X_TRIGGER_SOURCE_AUX_2: Auxiliary channel 2 used as the pause resume trigger source. 4. GTDIO6X_TRIGGER_SOURCE_AUX_3: Auxiliary channel 3 used as the pause resume trigger source. 5. GTDIO6X_TRIGGER_SOURCE_AUX_4: Auxiliary channel 4 used as the pause resume trigger source. GX5961 only. 6. GTDIO6X_TRIGGER_SOURCE_AUX_5: Auxiliary channel 5 used as the pause resume trigger source. GX5961 only. 7. GTDIO6X_TRIGGER_SOURCE_AUX_6: Auxiliary channel 6 used as the pause resume trigger source. GX5961 only. 8. GTDIO6X_TRIGGER_SOURCE_AUX_7: Auxiliary channel 7 used as the pause resume trigger source. GX5961 only. 9. GTDIO6X_TRIGGER_SOURCE_AUX_8: Auxiliary channel 8 used as the pause resume trigger source. GX5296 TTL Input, GX5961 TTL Input/Output. 10. GTDIO6X_TRIGGER_SOURCE_AUX_9: Auxiliary channel 9 used as the pause resume trigger source. GX5296 TTL Input, GX5961 TTL Input/Output. 11. GTDIO6X_TRIGGER_SOURCE_AUX_10: Auxiliary channel 10 used as the pause resume trigger source. GX5296 TTL Input, GX5961 TTL Input/Output. 12. GTDIO6X_TRIGGER_SOURCE_AUX_11: Auxiliary channel 11 used as the pause resume trigger source. GX5296 TTL Input, GX5961 TTL Input/Output. 13. GTDIO6X_TRIGGER_SOURCE_CH_COMPARE_0: Channel Test Signal 0 used as the pause resume trigger source. 14. GTDIO6X_TRIGGER_SOURCE_LOCAL_BUS: Domain Resource used as the pause resume trigger source. 15. GTDIO6X_TRIGGER_SOURCE_PXI_0: PXI Trigger 0 used as the pause resume trigger source. 16. GTDIO6X_TRIGGER_SOURCE_PXI_1 PXI Trigger 1 used as the pause resume trigger source. 17. GTDIO6X_TRIGGER_SOURCE_PXI_2 PXI Trigger 2 used as the pause resume trigger source. 18. GTDIO6X_TRIGGER_SOURCE_PXI_3 PXI Trigger 3 used as the pause resume trigger source. 19. GTDIO6X_TRIGGER_SOURCE_PXI_4 PXI Trigger 4 used as the pause resume trigger source. 20. GTDIO6X_TRIGGER_SOURCE_PXI_5 PXI Trigger 5 used as the pause resume trigger source. 21. GTDIO6X_TRIGGER_SOURCE_PXI_6 PXI Trigger 6 used as the pause resume trigger source. 22. GTDIO6X_TRIGGER_SOURCE_PXI_7 PXI Trigger 7 used as the pause resume trigger source. |
bInvertTriggerSource |
BOOL |
Set 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 |
Set 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. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative value on failure. |
This function configures one of the two pause triggers. The pause triggers are comprised of a pause signal and a resume signal. The pause signal stops the vector timing and the resume continues the timing.
For each pause signal selection, there is a corresponding signal that will resume the sequencer operation. The pause trigger logic allows the user to assign a signal (Pause) that can be either an internal or external, which will pause the sequencer. When paused, the following hardware will stop:
● Phases.
● Windows.
● Waveforms.
Configuring the pause trigger consists of the following:
1. Selecting the pause source.
2. Program the pause source inverter.
3. Select the pause test mode, level (high/low) or edge (rising/falling).
4. Sets the trigger reset level/edge mode.
A pause/resume can be based on the true/false state of any of the two pause triggers. For example if pause trigger 0 was set to AUX1 'Low Level' and resume was set to AUX1 'High Level', then an if trigger 1 true would pause if the AUX1 is low and resume if AUX1 high.
See GtDio6xStepSetPauseResumeTrigger API for more details.
The following example sets the PAUSE trigger 1as follows:
● 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 nTriggerSource, nLevelOrEdge, nTriggerResetMode;
BOOL bInvertTriggerSource;
GtDio6xTrigConfigSetPauseTrigger (nHandle, GTDIO6X_PAUSE_TRIGGER_1, GTDIO6X_TRIGGER_SOURCE_CH_COMPARE_0, TRUE, GTDIO6X_TRIGGER_ON_RISING_EDGE, GTDIO6X_HALT_TRIGGER_RESET_ON_START, &nStatus);
GtDio6xTrigConfigGetPauseTrigger (nHandle, GTDIO6X_PAUSE_TRIGGER_1, &nTriggerSource, &bInvertTriggerSource, &nLevelOrEdge, &nTriggerResetMode, &nStatus);
GtDio6xTrigConfigSetHaltTrigger, GtDio6xTrigConfigSetJumpTrigger, GtDio6xTrigConfigSetLocalBusTriggerSource, GtDio6xTrigConfigSetPauseResumeTrigger, GtDio6xTrigConfigSetPxiTrigger, GtDio6xTrigConfigSetRunTrigger, GtDio6xTrigConfigSetStopTrigger, GtDio6xGetErrorString