beautypg.com

Hello, Hello testsys, Syntax – Measurement Computing GPIB-488.2 User Manual

Page 32

background image

3-14

IOtech to Associated MCC APIs

986992

GPIB 488.2 Porting Guide

IOtech GPIB Command

Associated MCC GPIB 488.2 Command

Hello TestSys

Limited functionality

Syntax

Hello

INT WINAPI Hello(DevHandleT devHandle,
LPSTR message);

TestSys

SendSetup(int board, short addresslist [],
short resultlist[])

Usage Notes

The Hello command, no longer to be used, verified communication with Driver488, and read
the software revision number. When the Hello command was sent, Driver488 returned a
string similar to the following: Driver488 Revision X.X (C)199X ...where X was the
appropriate revision or year number.

TestSys 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. Note: according to the
IEEE-488.2 standard, a result code of 0 indicates the device passed its test. Any other value
indicates an error.

In the following example the command is telling the devices at addresses 6 and 7 [from Board
0] to perform their self-test procedures.

Example:

short addresslist[3] = {6, 7, NOADDR};

short resultlist[2];

TestSys(0, addresslist, resultlist);