VTI Instruments EX1629 - Vtex1629_Set_Trigger_Source_Timer

VTI Instruments Corp.
292 EX1629 Command Set
vtex1629_set_trigger_source_timer
FUNCTION PROTOTYPE
ViStatus vtex1629_set_trigger_source_timer (ViSession vi, ViReal64 timerPeriod, 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.
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.
DATA ITEM RESET VALUE
timerPeriod = 0 lxiOutput = 8 (VTEX1629_LXI_LINE_NONE)
lxiInput = 8 (VTEX1629_LXI_LINE_NONE)
DESCRIPTION
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
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
…
status = vtex1629_set_trigger_source_timer(instrumentHandle,
10.0,
VTEX1629_LXI_LINE_TWO,
VTEX1629_LXI_LINE_TWO );