ieee1284_read_data (3)
Leading comments
Title: ieee1284_data
Author: Tim Waugh <twaugh@redhat.com>
Generator: DocBook XSL Stylesheets v1.72.0 <http://docbook.sf.net/>
Date: 09/18/2007
Manual: Functions
Source:
NAME
ieee1284_read_data, ieee1284_write_data, ieee1284_data_dir, ieee1284_wait_data - control the data linesSYNOPSIS
#include <ieee1284.h>
-
int ieee1284_read_data(struct parport *port);
- void ieee1284_write_data(struct parport *port, unsigned char dt);
- int ieee1284_data_dir(struct parport *port, int reverse);
- int ieee1284_wait_data(struct parport *port, unsigned char mask, unsigned char val, struct timeval *timeout);
- void ieee1284_write_data(struct parport *port, unsigned char dt);
DESCRIPTION
For ieee1284_data_dir the reverse parameter should be zero to turn the data line drivers on and non-zero to turn them off. Some port types may be unable to switch off the data line drivers.
Setting the data lines may have side effects on some port types (for example, some Amiga ports pulse nStrobe).
ieee1284_wait_data waits, up until the timeout, for the data bits specified in mask to have the corresponding values in val.
RETURN VALUE
ieee1284_read_data returns the 8-bit number representing the data lines unless it is not possible to return such a value with this port type, in which case it returns an error code. Possible error codes:
E1284_NOTAVAIL
- Bi-directional data lines are not available on this system.
E1284_INVALIDPORT
- The port parameter is invalid (perhaps it has not been claimed, for instance).
E1284_SYS
- There was an error at the operating system level, and errno has been set accordingly.
E1284_TIMEDOUT
- The timeout has elapsed.
Whereas ieee1284_read_data may return E1284_NOTAVAIL on its first invocation on the port, if it does not do so then it cannot until ieee1284_close is called for that port.
AUTHOR
Tim Waugh <twaugh@redhat.com>
- Author.