www.vtiinstruments.com
EX10xxA Function Calls 259
vtex10xxA_set_trigger_sourceEx
FUNCTION PROTOTYPE
ViStatus vtex10xxA_set_trigger_sourceEx(ViSession vi, ViInt16 vtb_masks[], ViInt16 dio_masks[], ViInt16
lan_masks[], ViBoolean timer_enable, ViBoolean immediate, ViBoolean alarm);
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.
vtb_masks = a return array of four 8-bit integer values representing the enabled state of trigger events from the eight
channels of the trigger bus. Within the 8-bit field, the MSB corresponds to VTB channel 7 and the LSB corresponds
to VTB channel 0. Valid input values: 0 through 255.
dio_masks = a return array of four 8-bit integer values representing the enabled state of trigger events from the eight
channels of the digital I/O port. Within the 8-bit field, the MSB corresponds to DIO channel 7 and the LSB
corresponds to DIO channel 0. Valid input values: 0 through 255.
lan_masks = an array of four 8-bit integer values representing the enabling of LAN events from any of the eight
LAN events. Within the 8-bit field, the MSB corresponds to LAN 7 and the LSB corresponds to LAN 0. Valid input
values: 0 (0x00h) through 255 (0xFFh).
timer = a Boolean value indicating whether the timer is enabled as a trigger event. If this parameter is set to “1”, the
timer is enabled as a trigger. If set to “0”, timer triggering is disabled.
immediate = a Boolean value indicating whether immediate is enabled as a trigger event. If this parameter is set to
“1”, immediate triggering is enabled. If set to “0”, immediate triggering is disabled.
alarm = a Boolean value indicating whether the LXI alarm is used as an ARM event. If a “1” is set for this
parameter, the LXI alarm can act as an arm event. If a “0” is set, the LXI alarm is not a valid arm event.
DATA ITEM RESET VALUE
The trigger source is set to timer.
DESCRIPTION
This function sets the trigger source events. Regardless of this setting, software triggers are always enabled.
NOTE It is necessary to explicitly call vtex10xxA_set_alarm_enable to enable timer events even when the
alarm parameter is set to TRUE.
EXAMPLE