Vtex1629_Get_Dio_Output - VTI Instruments EX1629 User Manual

VTI Instruments Corp.
F P
UNCTION ROTOTYPE
ViStatus vtex1629_get_dio_output (ViSession vi, ViPInt32 dioOut);
F P
UNCTION ARAMETERS
vi = contains a session handle to the instrument. This handle is obtained by the function and remains valid until the
session is closed.
dioOut = an integer return value indicating the output state of the digital I/O. See the Description below for more
information concerning this parameter. Valid return values: 0 to 65535.
D I R V
ATA TEM ESET ALUE
Not applicable to this function.
D
ESCRIPTION
This function queries and returns the current programmed output state of both banks of the digital I/O. The dioOut
parameter is a decimal value that must be converted to a 16-bit binary value. Once done, the eight most significant
bits correspond to the eight channels of bank one (channels 8-15). The eight least significant bits correspond to the
eight channels of bank zero (channels 0-7). This is illustrated below.
channel #
dioOut
The upper 16-bits will always be zero.
For example, a user queries the output state and the following was returned:
dioOut = 49164 → 0x0000C00C → 11000000 00001100
This indicates that channels 2 and 3 of digital I/O bank zero and channels 14 and 15 of digital I/O bank one are
configured high, while the remaining channels are low.
E
XAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 dio_out;
...
status = vtex1629_get_dio_output(instrumentHandle, &dio_out);
150

vtex1629_get_dio_output

bank one
15 14 13 12 11 10 9
0 0 0 0 0 0 0
bank zero
8 7 6 5 4 3 2
0 0 0 0 0 0 0
1 0
0 0
EX1629 Command Set