Testsys, Testsys -27 – Measurement Computing GPIB-488 User Manual
Page 95
Chapter 4
GPIB 488.2 Library Reference
GPIB-488
4-27
TestSys
Activate self-test procedures of specified devices.
Syntax
C
SendSetup(int board, short addresslist [],
short resultlist[])
Parameters
board
is an integer which identifies the GPIB board to use for this operation. In most
applications, this value is 0.
addresslist
is an array of GPIB addresses, terminated by the value
NOADDR
. These
addresses identify the devices to perform self-tests.
Returns
resultlist
is an array which contains the results of each device's self-test procedure.
According to the IEEE-488.2 standard, a result code of 0 indicates the device passed its test.
Any other value indicates an error.
ibcnt
will contain the number of devices which failed their tests.
ibsta
will contain a 16-bit status word as described in Appendix B,
.
iberr
will contain an error code, if an error occurred.
Usage Notes
When this routine is executed, all of the devices identified within the
addresslist
array are
concurrently sent a message which directs them to perform their self-test procedures. Each
device returns an integer code indicating the results of its tests. This code is placed into the
corresponding element of the
resultlist
array.
Example
This example tells the devices at addresses 6 and 7 (from Board 0) to perform thier self-test
procedures.
C
short addresslist[3] = {6, 7, NOADDR};
short resultlist[2];
TestSys(0, addresslist, resultlist);