VTI Instruments EX1629 - Vtex1629_Set_Synch_Source

www.vtiinstruments.com
EX1629 Command Set 285
vtex1629_set_synch_source
FUNCTION PROTOTYPE
ViStatus vtex1629_set_synch_source (ViSession vi, ViInt32 synchMode, ViInt32 inLine, ViInt32 outLine);
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.
synchMode = an integer input value that indicates whether the EX1629 is operating as a master, slave, or as a
standalone. Valid input values: VTEX1629_SYNC_MODE_MASTER or VTEX1629_SYNC_MODE_SLAVE.
inLine = an integer input value that indicates the trigger bus line to receive synch events. Valid input values:
VTEX1629_LXI_LINE_ZERO to VTEX1629_LXI_LINE_SEVEN, VTEX1629_LXI_LINE_NONE.
outLine = an integer input value that indicates the trigger bus line to output synch events. Valid input values:
VTEX1629_LXI_LINE_ZERO to VTEX1629_LXI_LINE_SEVEN, VTEX1629_LXI_LINE_NONE.
DATA ITEM RESET VALUE
synchMode = VTEX1629_SYNC_MODE_MASTER inLine = VTEX1629_LXI_LINE_NONE
outLine = VTEX1629_LXI_LINE_NONE
DESCRIPTION
This function sets the synchronization source.
The synchMode value indicates whether the EX1629 is configured as a master device that outputs a synch signal for
itself and other devices or as a slave device that receives its synch signal from another device. When operating in
standalone mode, synchMode should be configured as a master.
The inLine value indicates the LXI line that should be used as the synch input. This value is applicable regardless of
whether the device is configured as a master or a slave. When inLine is set to VTEX1629_LXI_LINE_NONE, the
special, internal synch line is used.
The outLine value indicates the LXI line that should be used as the synch output. This value is only applicable when
the device is configured as a master. When outLine is set to VTEX1629_LXI_LINE_NONE, the synch signal is
output on the special, internal synch line only. When in Slave mode, no output line can be used, so
VTEX1629_LXI_LINE_NONE must be specified.
Decimal
Value
Hex
Value
#define Symbol
inLine/outLine
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
When in master mode, the inLine and outLine values may be the same or they may be different. One case where
they would be different is if the master is outputting the synch signal on one LXI line and receiving it back in from a
LXI Trigger Bus hub on another line. When in standalone mode, inLine and outLine should always be
VTEX1629_LXI_LINE_NONE.