beautypg.com

Timeout, Timeoutquery, Trigger – Measurement Computing Personal488 rev.3.0 For DOS & Windows 3.Xi User Manual

Page 366

background image

III. COMMAND REFERENCES - 15. Command References

15B. Driver488/SUB, W31, W95, & WNT

Personal488 User’s Manual, Rev. 3.0

III-351

This is a new function in Driver488/W95. The

TermQuery

function queries the terminators setting.

Terminators are defined by the

TermT

structure.

TimeOut

SYNTAX

int pascal TimeOut(DevHandleT devHandle, long millisec);

devHandle

refers to either an IEEE 488 interface or an external device.

millisec

is a numeric value given in milliseconds.

RETURNS

-1 if error

MODE

Any

BUS STATES

None

SEE ALSO

Reset

EXAMPLE

errorcode = TimeOut(ieee,100);

Set the timeout value to 100 msec.

The

TimeOut

command sets the number of milliseconds that Driver488 waits for a transfer before

declaring a time out error. Driver488 checks for timeout errors on every byte it transfers, except in the
case of asynchronous transfers. While the first byte of an asynchronous transfer is checked for time
out, subsequent bytes are not. The user’s program must check for timely completion of an
asynchronous transfer.

Time out checking may be suppressed by specifying a time out value of zero seconds, which specifies
an infinite timeout. The default time out is specified in the startup configuration, normally

10

seconds.

The time out interval may be specified to the nearest

0.001

seconds (1 millisecond). However, due to

the limitations of the computer, the actual interval is always a multiple of

55

milliseconds and there is

an uncertainty of

55

msec in the actual interval. Time out intervals from

1

to

110

milliseconds are

rounded to

110

milliseconds. Larger intervals are rounded to the nearest multiple of

55

msec (e.g.

165

,

220

,

275

msec, etc.).

TimeOutQuery

Driver488/W95 only

SYNTAX

INT pascal TimeOutQuery(DevHandleT devHandle, DWORD

millisec);

devHandle

refers to either an IEEE 488 interface or an external device.

millisec

is a numeric value given in milliseconds.

RETURNS

-1 if error

MODE

Any

BUS STATES

None

SEE ALSO

TimeOut, Reset

EXAMPLE

None provided.

This is a new function in Driver488/W95. The

TimeOutQuery

function queries the time out setting,

given in milliseconds.

Trigger

SYNTAX

int pascal Trigger(DevHandleT devHandle);

devHandle

refers to either an IEEE 488 interface or an external device.

RETURNS

-1 if error

MODE

CA