beautypg.com

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

Page 343

background image

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.