VTI Instruments EX1629 - Vtex1629_Get_Trigger_Source

VTI Instruments Corp.
194 EX1629 Command Set
vtex1629_get_trigger_source
FUNCTION PROTOTYPE
ViStatus vtex1629_get_trigger_source (ViSession vi, ViPInt32 triggerSource);
FUNCTION PARAMETERS
vi = contains a session handle to the instrument. This handle is obtained by the function and remains valid until the
session is closed.
triggerSource = an integer return value that indicates the current source the EX1629 monitors for TRIG events. See
the Description below for more information. Valid return values: 0 to 17.
DATA ITEM RESET VALUE
Not applicable to this function.
DESCRIPTION
This function queries and returns the current setting for the trigger source. Possible values for the triggerSource
parameter are:
Decimal
Value
Hex
Value
#define
armSource Description
0
0x00
VTEX1629_TRIG_SRC_IMMEDIATE
Immediate
1
0x01
VTEX1629_TRIG_SRC_PATTERN
Pattern
2
0x02
VTEX1629_TRIG_SRC_LXI0_POS
LXI 0 Positive Edge
3
0x03
VTEX1629_TRIG_SRC_LXI1_POS
LXI 1 Positive Edge
4
0x04
VTEX1629_TRIG_SRC_LXI2_POS
LXI 2 Positive Edge
5
0x05
VTEX1629_TRIG_SRC_LXI3_POS
LXI 3 Positive Edge
6
0x06
VTEX1629_TRIG_SRC_LXI4_POS
LXI 4 Positive Edge
7
0x07
VTEX1629_TRIG_SRC_LXI5_POS
LXI 5 Positive Edge
8
0x08
VTEX1629_TRIG_SRC_LXI6_POS
LXI 6 Positive Edge
9
0x09
VTEX1629_TRIG_SRC_LXI7_POS
LXI 7 Positive Edge
10
0x0A
VTEX1629_TRIG_SRC_LXI0_NEG
LXI 0 Negative Edge
11
0x0B
VTEX1629_TRIG_SRC_LXI1_NEG
LXI 1 Negative Edge
12
0x0C
VTEX1629_TRIG_SRC_LXI2_NEG
LXI 2 Negative Edge
13
0x0D
VTEX1629_TRIG_SRC_LXI3_NEG
LXI 3 Negative Edge
14
0x0E
VTEX1629_TRIG_SRC_LXI4_NEG
LXI 4 Negative Edge
15
0x0F
VTEX1629_TRIG_SRC_LXI5_NEG
LXI 5 Negative Edge
16
0x10
VTEX1629_TRIG_SRC_LXI6_NEG
LXI 6 Negative Edge
17
0x11
VTEX1629_TRIG_SRC_LXI7_NEG
LXI 7 Negative Edge
Immediate (0): an immediate TRIG source. After receiving the ARM event, the trigger state machine will bypass
the TRIG layer and will automatically begin to acquire data.
Pattern (1): this trigger source allows the EX1629 to “listen” for TRIG events on multiple sources. The EX1629 can
be configured to “listen” for TRIG events on LXI Trigger Bus channels, digital I/O channels, a timer, and software
triggers. The EX1629 can simultaneously “listen” for any combination of these events. The specific pattern is
queried with the vtex1629_get_pattern_trig_configuration call.
LXI n Positive Edge (2 – 9): these trigger sources refer to TRIG events coming from the LXI Trigger Bus and will
cause the EX1629 to trigger on the positive edge of signals coming into the LXI Trigger Bus.
LXI n Negative Edge (10 – 17): these trigger sources refer to TRIG events coming from the LXI Trigger Bus and
will cause the EX1629 to trigger on the negative edge of signals coming into the LXI Trigger Bus.
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 trigsource;
…
status = vtex1629_get_trigger_source(instrumentHandle, &trigsource);