NAME

hpib_wait_on_ppoll − wait until a particular parallel poll value occurs

SYNOPSIS

int hpib_wait_on_ppoll (eid, mask, sense);
int eid, mask, sense;

DESCRIPTION

Hpib_wait_on_ppoll waits for a parallel poll response to occur on one or more lines.  Eid is an entity identifier of an open HP-IB raw bus device file obtained from an open(2), dup(2), fcntl(2), or creat(2) call. 

Mask is an integer that specifies on which line the parallel poll response is expected.  Mask’s value is obtained from an 8-bit binary number, each bit of which corresponds to one of the eight lines.  For example, if you want to wait for a response on lines 2 and 6, the correct binary number is 01000100.  This converts to a decimal equivalent of 68, which is the number you should assign to mask. 

Sense simply specifies what response you are expecting on the selected lines.  Sense is constructed in the same way as mask − eight bits for eight lines.  If a bit is set, then the function returns when the line corresponding to that bit is cleared.  Similarly, if a bit in sense is clear, the function returns when the corresponding line is set.  Using the previous example, a sense = 00000100 = 4 (decimal) causes the function to return when line 6 is set, and return when line 2 is cleared. 

RETURN VALUE

Hpib_wait_on_ppoll returns a value of −1 if an error or timeout condition occurs. A successful completion of the function returns the response byte XOR-ed with the sense value and AND-ed with the mask. 

ERRORS

Hpib_wait_on_ppoll fails under the following circumstances, and sets errno (see errno(2)) to the value in square brackets:

­[EBADF] eid does not refer to an open file. 

­[ENOTTY] eid does not refer to an HP-IB raw bus device file. 

­[EIO] a timeout occurred. 

­[EIO] the interface is not currently the active controller. 

AUTHOR

Hpib_wait_on_ppoll was developed by the Hewlett-Packard Company. 

Hewlett-Packard Company  —  Version B.1,  May 11, 2021