VTI Instruments EX1629, Руководство пользователя

Страница: 273 / 346

www.vtiinstruments.com
EX1629 Command Set 273
vtex1629_set_pattern_trig_configuration
F
UNCTION
P
ROTOTYPE
ViStatus vtex1629_set_pattern_trig_configuration (ViSession vi , ViInt16 _VI_FAR lxiTrigLines[] , ViInt16
_VI_FAR dioLines[] , ViBoolean timer , ViInt32 lxiOutput , ViInt32 lxiInput );
F
UNCTION
P
ARAMETERS
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 trigger
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 trigger 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 TRIG events based on the internal
timer. Setting this parameter to VI_TRUE(1) will cause TRIG 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 trigger 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 trigger event signals. Valid
input values: VTEX1629_LXI_LINE_ZERO to VTEX1629_LXI_LINE_SEVEN, VTEX1629_LXI_LINE_NONE.
D
ATA
I
TEM
R
ESET
V
ALUE
lxiTrigLines[] = [0, 0 ,0 ,0] dioLines = [0, 0 ,0 ,0]
timer = 0 lxiOutput = VTEX1629_LXI_LINE_NONE
lxiInput = VTEX1629_LXI_LINE_NONE
D
ESCRIPTION
This function configures the EX1629’s pattern trigger mode of operation. This mode allows the EX1629 to accept
trigger events from multiple sources. While in pattern mode, the instrument can accept trigger events from the LXI
Trigger Bus, digital I/O bus, internal timer, and the software trigger command. There is no need to explicitly enable
the software trigger source – it is always available for use while in pattern trigger mode. All of the conditions
specified must be met for a trigger event to be generated. If multiple conditions are specified for the same LXI or
DIO line, any of the conditions for that line can be met to satisfy the trigger pattern requirements for that line.
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 trigger events on the LXI Trigger Bus for different edges
or states. If a user wants to specify a channel to for trigger 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 trigger 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.