VTI Instruments EX1629, User Manual

Page: 292 / 346

VTI Instruments Corp.
292 EX1629 Command Set
vtex1629_set_trigger_source_timer
F
UNCTION
P
ROTOTYPE
ViStatus vtex1629_set_trigger_source_timer (ViSession vi , ViReal64 timerPeriod , 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.
timerPeriod = a real input value indicating the time, in seconds, the EX1629 will wait in between generating TRIG
events. Valid input values: 0 s to 167 s.
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.
D
ATA
I
TEM
R
ESET
V
ALUE
timerPeriod = 0 lxiOutput = 8 (VTEX1629_LXI_LINE_NONE)
lxiInput = 8 (VTEX1629_LXI_LINE_NONE)
D
ESCRIPTION
This is a convenience functions that configures the EX1629 to operate in pattern trigger mode using the trigger timer
as the only source and configuring the trigger timer period.
With regard to the
lxiOutput parameter, it is important to note that since the EX1629 can simultaneously accept
trigger events from multiple sources, it is necessary to reserve one of the LXI Trigger Bus line to communicate these
events within the device and to other devices in a multi-device configuration. If the EX1629 is a master driving
trigger events to peripheral slaves, the
lxiOutput parameter specifies the LXI Trigger Bus line that will be used to
communicate the trigger event to the slave devices. It is also necessary to configure this LXI Trigger Bus line to be
used as an output (see vtex1629_set_lxibus_configuration).
The
lxiInput parameter specifies which trigger bus line the master device uses for its trigger events. Although this
parameter is often set to the same value as lxiOutput , there are cases where it might be set to a different value. For
instance, when the device is configured as a master device in a star multi-box configuration, the master might output
the trigger event on LXI2 and input it back in on LXI6.
Decimal
Value
Hex
Value
#define Symbol
lxiOutput/lxiInput
Description
0 0x00 VTEX1629_LXI_LINE_ZERO LXI LINE 0
1 0x01 VTEX1629_LXI_LINE_ONE LXI LINE 1
2 0x02 VTEX1629_LXI_LINE_TWO LXI LINE 2
3 0x03 VTEX1629_LXI_LINE_THREE LXI LINE 3
4 0x04 VTEX1629_LXI_LINE_FOUR LXI LINE 4
5 0x05 VTEX1629_LXI_LINE_FIVE LXI LINE 5
6 0x06 VTEX1629_LXI_LINE_SIX LXI LINE 6
7 0x07 VTEX1629_LXI_LINE_SEVEN LXI LINE 7
8 0x08 VTEX1629_LXI_LINE_NONE None
E
XAMPLE
ViSession instrumentHandle;
ViStatus status;
…
status = vtex1629_set_trigger_source_timer(instrumentHandle,
10.0,
VTEX1629_LXI_LINE_TWO,
VTEX1629_LXI_LINE_TWO );