VTI Instruments EX1629 - Vtex1629_Set_Trigger_Source

www.vtiinstruments.com
EX1629 Command Set 291
vtex1629_set_trigger_source
FUNCTION PROTOTYPE
ViStatus vtex1629_set_trigger_source (ViSession vi, ViInt32 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 input value that indicates the desired source to be monitored for trigger events. Valid
input values: 0 to 17.
DATA ITEM RESET VALUE
triggerSource = 0 (immediate)
DESCRIPTION
This function sets the trigger source on the EX1629. Possible values for the trigger source include:
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 trigger source. After receiving the arm event, the trigger state machine will bypass the
trigger layer and will automatically begin to acquire data.
Pattern (1): this trigger source allows the EX1629 to accept trigger events from multiple sources. The EX1629 can
be configured to accept trigger events on LXI Trigger Bus channels, digital I/O channels, a timer, and software
triggers. The EX1629 can simultaneously accept any combination of these events. The specific pattern is set with the
vtex1629_set_pattern_trig_configuration command.
LXI n Positive Edge (2 – 9): these trigger sources refer to trigger 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 trigger 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;
…
status = vtex1629_set_trigger_source(instrumentHandle, VTEX1629_TRIG_SRC_LXI4_POS);