VTI Instruments EX1629 - Vtex1629_Set_Arm_Source

www.vtiinstruments.com
EX1629 Command Set 235
vtex1629_set_arm_source
FUNCTION PROTOTYPE
ViStatus vtex1629_set_arm_source (ViSession vi, ViInt32 armSource);
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.
armSource = an integer input value that indicates the desired source to be monitored for ARM events. See the
Description section below for more information. Valid input values: 0 to 17.
DATA ITEM RESET VALUE
armSource = 0 (immediate)
DESCRIPTION
This function sets the arm source on the EX1629. Possible values for the armSource 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 ARM source. After initialization of the trigger system, the trigger state machine will
bypass the ARM layer and will automatically transition into the TRIG layer.
Pattern (1): this arm source allows the EX1629 to accept ARM events on multiple sources. Specifically, the
EX1629 can be configured to accept ARM events on any LXI Trigger Bus channel, any digital I/O channel, on a
timer, or for software arms. The instrument can be configured to accept any combination of these events
simultaneously. The specific pattern is set with the vtex1629_set_pattern_arm_configuration command.
LXI n Positive Edge (2 – 9): these arm sources refer to ARM events coming from the LXI Trigger Bus. More
specifically, these arm sources will cause the EX1629 to arm on the positive edge of signals coming into the LXI
Trigger Bus.
LXI n Negative Edge (10 – 17): these arm sources are referring to ARM events coming from the LXI Trigger Bus.
More specifically, these arm sources will cause the EX1629 to arm on the negative edge of signals coming into the
LXI Trigger Bus.
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
…
status = vtex1629_set_arm_source(instrumentHandle, VTEX1629_TRIG_SRC_PATTERN);