VTI Instruments EX1629 - Vtex1629_Set_Pattern_Arm_Configuration

www.vtiinstruments.com
EX1629 Command Set 271
vtex1629_set_pattern_arm_configuration
FUNCTION PROTOTYPE
ViStatus vtex1629_set_pattern_arm_configuration (ViSession vi, ViInt16 _VI_FAR lxiTrigLines[], ViInt16
_VI_FAR dioLines[], ViBoolean timer, ViInt32 lxiOutput, ViInt32 lxiInput);
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.
lxiTrigLines[] = an integer input array specifying the LXI Trigger Bus channel states that will be accepted as arm
events. This includes both levels (high and low) and edges (rising and falling). Valid input values: 0 to 255.
dioLines = an integer input array specifying the digital I/O channels that will be accepted as arm events. This
includes both levels (high and low) and edges (rising and falling). Valid input values: 0 to 255.
timer = a Boolean input value that indicates whether the EX1629 will generate ARM events based on the internal
timer. Setting this parameter to VI_TRUE (1) will cause arm events to be generated. Valid input values: VI_FALSE
(0) or VI_TRUE(1).
lxiOutput = this parameter specifies which LXI Trigger Bus line will be used to output the ARM event signals.
Valid input values: VTEX1629_LXI_LINE_ZERO to VTEX1629_LXI_LINE_SEVEN,
VTEX1629_LXI_LINE_NONE.
lxiInput = this parameter specifies which LXI Trigger Bus line will be used to input the ARM event signals. Valid
input values: VTEX1629_LXI_LINE_ZERO to VTEX1629_LXI_LINE_SEVEN, VTEX1629_LXI_LINE_NONE.
DATA ITEM RESET VALUE
lxiTrigLines[] = [0, 0, 0, 0] dioLines = [0, 0, 0, 0]
timer = 0 lxiOutput= 8 (VTEX1629_LXI_LINE_NONE)
lxiInput = 8 (VTEX1629_LXI_LINE_NONE)
DESCRIPTION
This function configures the EX1629’s pattern arm operation mode. This mode allows the EX1629 to accept arm
events from multiple sources. While in pattern mode, the instrument can accept arm events from the LXI Trigger
Bus, digital I/O bus, internal timer, and the software ARM command. There is no need to explicitly enable the
software arm source – it is always available for use while in pattern arm mode.
The lxiTrigLines[] parameter is an array of four elements with each array element being an unsigned 8-bit integer.
Each bit of this integer corresponds to an LXI Trigger Bus channel. Specifically, the least significant bit corresponds
to LXI Trigger Bus channel zero and the most significant bit corresponds to LXI Trigger Bus channel seven. Each
element specifies which events the EX1629 will accept as arm events on the LXI Trigger Bus for different edges or
states. If a user wants to specify a channel to for arm events, the corresponding bit should be set to “1”. The
individual array elements specify the following:
0 = lxiTrigLines (Positive Edge) 1 = lxiTrigLines (Negative Edge)
2 = lxiTrigLines (Positive Level) 3 = lxiTrigLines (Negative Level)
For example, if a user wishes to arm the EX1629 on a negative edge signal coming into the LXI Trigger Bus on
channel 0 and a positive level on channels 3 and 6, then: lxiTrigLines[1] = 00000001b = 0x01 = 1 and
lxiTrigLines[2] = 01001000b = 0x48 = 72.
The dioLines parameter is an array of four elements with each array element being an unsigned 16-bit integer. Each
bit of this integer corresponds to a digital I/O channel. Specifically, the least significant bit corresponds to a digital
I/O channel zero, and the most significant bit corresponds to digital I/O channel seven. Each element specifies which
events the EX1629 will accept as arm events on the digital I/O bus for different clock edges or states. If a user wants
to specify a channel to for arm events, the corresponding bit should be set to “1”. Specifically, the individual array
elements specify the following:
0 = dioLines[0] Positive Edge 1 = dioLines[1] Negative Edge
2 = dioLines[2] Positive Level 3 = dioLines[3] Negative Level