TestSys
Purpose
Cause IEEE 488.2-compliant devices to conduct self tests.
Format
C
void TestSys (int boardID, const Addr4882_t *addrlist, short *resultlist)
Visual Basic
CALL TestSys (boardID%, addrlist%(), resultlist%())
Interactive Control (Usage Notes)
TestSys addrlist
Input
| boardID | The interface number |
| addrlist | A list of device addresses terminated by NOADDR |
Output
| resultlist | A list of test results; each entry corresponds to an address in addrlist |
Description
TestSys sends the "*TST?" message to the IEEE 488.2-compliant devices described by addrlist. The "*TST?" message instructs them to conduct their self-test procedures. A 16-bit test result code is read from each device and stored in resultlist. A test result of 0\n indicates that the device passed its self test. Refer to the documentation that came with the device to determine the meaning of the failure code. Any other value indicates that the device failed its self test. If the function returns without an error (that is, the ERR bit is not set in Ibsta), Ibcnt contains the number of services that failed. Otherwise, the meaning of Ibcnt depends on the error returned. If a device fails to send a response before the timeout period expires, a test result of 1 is reported for it, and the error EABO is returned.
Possible Errors
| EABO | The interface timed out before receiving a result from a device; Ibcnt contains the index of the timed-out device. -1 is stored as the test result for the timed-out device. |
| EARG | Either an invalid address appears in addrlist or the addrlist is empty; Ibcnt is the index of the first invalid address in the addrlist array. |
| EBUS | No devices are connected to the GPIB. |
| ECIC | The interface is not the Controller-In-Charge; see SendIFC. |
| EDVR | The NI-488.2 driver is either configured incorrectly or is not properly installed. |
| EHDL | boardID is out of range. |
| ELCK | The requested operation could not be performed because of an existing lock by another process. |
| ENEB | The interface is not installed or is not properly configured. |
| ENOL | No Listeners are on the GPIB. |
| EOIP | Asynchronous I/O is in progress. |