Hello, Intlevel – Measurement Computing Personal488 rev.3.0 For DOS & Windows 3.Xi User Manual
Page 343

15B. Driver488/SUB, W31, W95, & WNT
III. COMMAND REFERENCES - 15. Command References
III-328
Personal488 User’s Manual, Rev. 3.0
Hello
SYNTAX
int pascal Hello(DevHandleT devHandle, char *message);
devHandle
refers to either an IEEE 488 interface or an external device. If
devHandle
refers to an external device, the
Hello
command acts on the
hardware interface to which the external device is attached.
message
is a character pointer that contains the returned message.
RETURNS
-1 if error.
MODE
Any
BUS STATES
None
SEE ALSO
Status, OpenName, GetError
EXAMPLE
char message[247];
result = Hello(ieee,message);
printf(“%s\n”,message);
The
Hello
command is used to verify communication with Driver488, and to read the software
revision number. If a non-null string pointer is passed,
Hello
fills in up to 247 bytes in the string. The
application must ensure that sufficient space is available. When the command is sent, Driver488
returns a string similar to the following:
Driver488 Revision X.X (C)199X IOtech, Inc.
where
X
is the appropriate revision or year number.
IntLevel
Driver488/SUB and Driver488/W31 only
SYNTAX
int pascal IntLevel(DevHandleT devHandle, int channel);
devHandle
refers to either an IEEE 488 interface or an external device. If
devHandle
refers to an external device, then the
IntLevel
command acts on
the hardware interface to which the external device is attached.
channel
is a valid interrupt channel, or
-1
to specify
NONE
.
RETURNS
-1 if error
MODE
Any
BUS STATES
None
SEE ALSO
DmaChannel, TimeOut
EXAMPLE
errorcode = IntLevel(ieee, 7);
The
IntLevel
command specifies the hardware interrupt level that is used by the I/O adapter.
Driver488 uses hardware interrupts, if available, to improve the efficiency of I/O adapter control and
communication. The interrupt level is specified by an integer in the range 2 through 15 as appropriate
to the host computer bus and interface card type. The interrupt level value must match the hardware
settings on the interface card.