beautypg.com

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

Page 362

background image

III. COMMAND REFERENCES - 15. Command References

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

Personal488 User’s Manual, Rev. 3.0

III-347

SPollList

SYNTAX

int pascal SPollList(DevHandlePT devHandles, unsigned char

*result, char untilflag);

devHandles

is a pointer to a list of external devices.

result

is an array that is filled in with the Serial Poll results of the corresponding

external devices.

untilflag

refers to either

ALL

,

WHILE_SRQ

, or

UNTIL_RSV

.

RETURNS

-1 if error

MODE

*CA

BUS STATES

ATN

UNL, MLA, TAG, SPE, *ATN, ATNSPD, UNT

SEE ALSO

SPoll, PPoll

EXAMPLE

deviceList[0] = wave;
deviceList[1] = timer;
deviceList[2] = dmm;
deviceList[3] = NODEVICE;
result = SPollList(deviceList,

resultList, ALL);

Return the Serial Poll response for a

list of device handles.

In Active Controller mode, the

SPollList

(Serial Poll) command performs a Serial Poll of the bus

devices specified and responds with a number from

0

to

255

(representing the decimal equivalent of

the eight-bit device response) for each device on the list. If

rsv

(

DIO7

, decimal value

64

) is set, then

that device is signaling that it requires service. The meanings of the other bits are device-specific.

Serial Polls are normally performed in response to assertion of the Service Request (

SRQ

) bus signal by

some bus device. In Active Controller mode with the interface device specified, the

SPollList

command returns the internal

SRQ

status for each device. If the internal

SRQ

status is set, it usually

indicates that the

SRQ

line is asserted. Driver488 then returns a

64

. If it is not set, indicating that

SRQ

is not asserted, then Driver488 returns a

0

. With an external device specified,

SPollList

returns the

Serial Poll status of the specified external device.

In Peripheral mode, the

SPollList

command is issued only to the interface and returns the Serial Poll

status. If

rsv

(

DIO7

, decimal value

64

) is set, then Driver488 has not been Serial Polled since the last

Request

command was issued. The

rsv

is reset whenever Driver488 is Serial Polled by the

Controller.

The

untilflag

refers to either

ALL

,

WHILE_SRQ

, or

UNTIL_RSV

. If

ALL

is chosen, all the devices are

Serial Polled and their results placed into the result array. If

untilflag

is

WHILE_SRQ

, Driver488

Serial Polls the devices until the

SRQ

bus signal becomes unasserted, and the results are put into the

result array. If

untilflag

is

UNTIL_RSV

, Driver488 Serial Polls the devices until the first device

whose

rsv

bit is set, is found and the results are put into the result array.

Status

SYNTAX

int pascal Status(DevHandleT devHandle, IeeeStatusT *result);

devHandle

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

devHandle

refers to an external device,

Status

acts on the hardware

interface to which the external device is attached.

result

is a pointer to a

Status

structure.

RETURNS

-1 if error

MODE

Any

BUS STATES

None

SEE ALSO

GetError, SPoll