rplt_ctrl(3) CLIX rplt_ctrl(3)
NAME
rplt_ctrl, rplt_ctrl_nw - Sends a control word to the ROP parallel port
LIBRARY
Intergraph Device Library (libix.a)
SYNOPSIS
#include <sys/types.h>
#include <sys/immu.h>
#include <sys/pop.h>
#include <sys/xio/xerr.h>
#include <sys/xio/xio.h>
int rplt_ctrl(
int interface ,
int status ,
int ctrl ,
int timeout );
int rplt_ctrl_nw(
int interface ,
int status ,
int ctrl ,
int timeout ,
int pulse ,
struct xiosb *xiosb ,
int efn );
PARAMETERS
interface One of three values (see below) used to define signal mapping
for the target device
status A three-bit mask to use when testing for the clear-to-send
condition
ctrl A 16-bit word that will be sent to the device
timeout The time limit in 1/60 second intervals to wait for the device
to become ready before aborting the request.
pulse Indicates whether bit 8 is toggled as a control bit or
interpreted as a data bit.
2/94 - Intergraph Corporation 1
rplt_ctrl(3) CLIX rplt_ctrl(3)
xiosb A pointer to an xiosb structure
efn The event flag number associated with the request
DESCRIPTION
The rplt_ctrl() function provides a mechanism to send a single word
through the control register on the parallel port residing on the Raster
Operation Processor (ROP) graphics board. The interface parameter is one
of the following values defined in <sys/pop.h>: CENTRONICS, VERSATEC, or
INTERGRAPH_DIFF. These values define the signal mapping for the target
device. The user provides the three-bit mask, status, that determines
which incoming signals should be considered when testing for the clear-
to-send condition. Bits that are set in the mask indicate that the
corresponding signals received from the device should be asserted. The
format of the status word is as follows:
___________________________
| 2 | 1 | 0 |
|______|__________|________|
| READY| NO ERROR| ONLINE|
| H | H | H |
|______|__________|________|
The ctrl parameter is a 16-bit word that will be sent to the device (bits
0-7 are data; bits 8-15 are control). The control bits are as follows:
______________________________________________________________
| 15 | 14 | 13 | 12 | 11 | 10 | 9 | 8 |
|_____|_______|_______|_______|_______|_______|_______|_______|
| NOT | RESET| RFFED| REOTR| RLTER| CLEAR| PICLK| PRINT|
| USED| H | H | H | H | H | H | H |
|_____|_______|_______|_______|_______|_______|_______|_______|
The value of pulse indicates whether bit 8 (PRINT H) is toggled as a
control bit or interpreted as a data bit.
The value of timeout indicates the time limit in 1/60 second intervals to
wait for the device to become ready before aborting the request. This
value is limited to 32767.
The rplt_ctrl_nw() function is the asynchronous version of rplt_ctrl(),
providing the same capability without waiting for completion of the
request. The efn parameter is the event flag number associated with the
request. The xiosb parameter is a pointer to the xiosb structure updated
upon completion of the request (see intro(3)). The xfcnt member of the
xiosb structure is not used.
RETURN VALUES
Upon successful completion of the synchronous request, a value of 0 is
2 Intergraph Corporation - 2/94
rplt_ctrl(3) CLIX rplt_ctrl(3)
returned. Otherwise, a nonzero value is returned indicating one of two
types of errors. If the request failed, one of the following failure
codes is returned. If the output device did not accept the data, a
negative status is returned and bits 0-2 reflect the state of the status
signals from the device.
If the asynchronous request is accepted by the XIO system, a value of 0
will be returned by the request. Otherwise, XIO_FAILURE will be returned.
Upon completion of an accepted request, the status member of the xiosb
structure will be set to either 0 if successful, or to nonzero if
unsuccessful indicating one of two types of errors. If the request
failed, one of the following failure codes is returned. If the output
device did not accept the data, a negative status is returned and bits 0-2
reflect the state of the status signals from the device.
ERRORS
The rplt_ctrl() and rplt_ctrl_nw() functions will fail if one of the
following is true:
[XIO_FAILURE]
The system does not contain the driver needed to support this
request or efn is invalid.
[XIO_DEVICE_FULL]
Another process is currently using the parallel port.
RELATED INFORMATION
Functions: plt_data(3), intro(3)
Files: xplot(7)
2/94 - Intergraph Corporation 3