VTI Instruments EX1629 - Vtex1629_Set_Dio_Config_Events

VTI Instruments Corp.
250 EX1629 Command Set
vtex1629_set_dio_config_events
FUNCTION PROTOTYPE
ViStatus vtex1629_set_dio_config_events (ViSession vi, ViInt32 inputLine, ViInt32 inputTrigType, ViInt32
numActions, ViInt32 _VI_FAR outputLineArr[], ViInt32 _VI_FAR outputActionTypeArr[]);
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.
inputLine = defines the DIO input line whose configuration is being queried. Valid input values: 0 through 7.
inputTrigType = defines the input trigger type. Valid input values: 0 (high-to-low transition) or 1 (low-to-high
transition).
numActions = defines the size of the outputLineArr[] and outputActionTypeArr[] arrays. Valid input values: 0
through 8.
outputLineArr[] = an integer array containing a list of digital output lines that are affected by the inputLine and
inputTrigType combination. Valid input values: 0 through 7.
outputActionTypeArr[] = an integer array containing a list of the output action that will occur based on the
inputLine and inputTrigType parameters. Valid input values: 0 through 3.
DATA ITEM RESET VALUE
pullup = 0 (passive pull-up mode)
DESCRIPTION
This function sets the conditions under which DIO event transitions will occur.
The numActions parameter defines the size of both the outputLineArr[] and outputActionTypeArr[] arrays.
Although any value 0 through 8 is acceptable, to avoid possible errors, it is recommended that this parameter be set
to 8.
The outputActionTypeArr[] parameter is an array which contains a list of output actions that will occur based on
events that occur on the specified inputLine. Note that each element of this array corresponds to the equivalent
index in the outputLineArr[] parameter. For example, the action type at element i in this array corresponds to (i.e.
will occur on) the line designated in element i of the outputLineArr[] array. This parameter has the following
acceptable values:
Decimal
Value
Hex
Value
#define Symbol
outputActionTypeArr
Description
0
0x00
DO_LOW
Low
1
0x01
DO_HIGH
High
2
0x02
DO_PULSE
Pulse
3
0x03
DO_TOGGLE
Toggle
The DIO Event-Action items are saved in the configuration XML file as shown below:
<dioeventactions_0>
<numActions> x </numActions>
<inputLine> x </inputLine>
<inputTriggerType> x </inputTriggerType>
<outputLine_0> x </outputLine_0>
:
<outputLine_7> x </outputLine_7>
</dioeventactions_0>
:
<dioeventactions_15>
:
</dioeventactions_15>