VTI Instruments EX1000A, User Manual

Page: 229 / 320

www.vtiinstruments.com
EX10xxA Function Calls 229
vtex10xxA_set_arm_source
F
UNCTION
P
ROTOTYPE
ViStatus vtex10xxA_set_arm_source (ViSession vi , ViInt16 _VI_FAR vtb_masks[] ,ViInt16 _VI_FAR
dio_masks[] ,ViBoolean timer_enable ,ViBoolean immediate );
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.
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.
timer_enable = a Boolean value indicating whether the timer is enabled as an arm event. If this parameter is set to
“1”, the timer will act as an arm event. If set to “0”, the timer is not a valid arm event.
immediate = a Boolean value indicating whether immediate is enabled as an arm event. If this parameter is set to
“1”, arm is set to immediate. If a “0” is returned, immediate arm is disabled.
D
ATA
I
TEM
R
ESET
V
ALUE
Not applicable to this function.
D
ESCRIPTION
This function sets the arm source events. Regardless of this setting, software arms are always enabled. For the
vtb_masks and dio_masks parameters, the data items in these arrays are ordered as follows: positive edge, negative
edge, positive level, negative level. Note that , to identify a LAN
E
XAMPLE
// enable timer arm only
ViUInt16 vtb_masks[4] = {0,0,0,0};
ViUInt16 dio_masks[4] = {0,0,0,0};
vtex10xxA_set_arm_source(vi, vtb_masks, dio_masks,1,0);
// enable arm on a positive level on DIO channels 0-3 and a negative edge on VTB channel 6
ViUInt16 vtb_masks[4] = {0,64,0,0};
ViUInt16 dio_masks[4] = {0,0,0x0F,0};
vtex10xxA_set_arm_source(vi, vtb_masks, dio_masks,0,0);
// enable software arm only
ViUInt16 vtb_masks[4] = {0,0,0,0};
ViUInt16 dio_masks[4] = {0,0,0,0};
vtex10xxA_set_arm_source(vi, vtb_masks, dio_masks,0, 0);