CompuScope SDK Manua.. - Egmont Instruments

gage_trigger_control_2
Syntax
C:
int16 GAGEAPI gage_trigger_control_2 (int16 source_1, int16 source_2, int16 ext_coupling,
int16 ext_gain, int16 slope_1, int16 slope_2, int16 level_1,
int16 level_2, int32 depth, int16 trigger_from_bus, int16 trigger_to_bus);
Visual BASIC:
Function gage_trigger_control_2 (ByVal source_1 As Integer, ByVal source_2 As Integer,
ByVal ext_coupling As Integer, ByVal ext_gain As Integer,
ByVal slope_1 As Integer, ByVal slope_2 As Integer,
ByVal level_1 As Integer, ByVal level_2 As Integer,
ByVal depth As Long, ByVal trigger_from_bus As Integer,
ByVal trigger_to_bus As Integer) As Integer
Remarks
gage_trigger_control_2 is used to set the trigger parameters and capture depth on CompuScope hardware.
The routine accepts two sets of values for the three main trigger parameters, the trigger source, the trigger
level and the trigger slope.
Some CompuScope models, such as the CS14100, have two separate trigger circuits. The two sets of
trigger parameters are used to control each of these trigger circuits. The outputs of each circuit are
logically ORed together to specify the trigger event. The two trigger circuits may be used, for instance, to
effect "absolute value triggering" on channel A. This is done by setting both source_1 and source_2 to
GAGE_CHAN_A, setting level_1 and level_2 values that correspond to equal and opposite voltages and
setting slope_1 and slope_2 to GAGE_POSITIVE and GAGE_NEGATIVE, respectively. In this way, the
CompuScope will trigger whenever the voltage on the channel A input goes above level_1 or below
level_2.
In order to disable the second trigger circuit, simply set source_2 to GAGE_SOFTWARE. For
CompuScopes that are not equipped with two trigger circuits, the "_2" parameters have no effect.
source_1 and source_2 can be either channel A, B, external trigger or software trigger. The constants
GAGE_CHAN_A, GAGE_CHAN_B, GAGE_EXTERNAL and GAGE_SOFTWARE should be used to
specify their respective sources. The two sources do not have to be the same. To disable one of the
triggers, set it to GAGE_SOFTWARE. If a software trigger is desired, then both trigger sources must be
set to GAGE_SOFTWARE.
ext_coupling controls the coupling of the EXTERNAL TRIGGER BNC input on the CompuScope
hardware. ext_coupling can be set to either DC or AC by using the constants GAGE_DC and GAGE_AC,
respectively. If the trigger source is not external, this parameter will be ignored, although it should be set
to a valid value.
ext_gain controls the input sensitivity of the EXTERNAL TRIGGER BNC input on the CompuScope
hardware. ext_gain can be set to either ±5 Volt or ±1 Volt by using the constants GAGE_PM_5_V and
GAGE_PM_1_V, respectively. If the trigger source is not external, this parameter will be ignored,
although it should be set to a valid value.
CompuScope API Reference Manual
55