xref: /netbsd-src/share/man/man4/atppc.4 (revision 0c4575d68772e3ee330ea5a419f754537d6349fd)
1.\"	$NetBSD: atppc.4,v 1.16 2018/08/31 19:36:28 sevan Exp $
2.\"
3.\" Copyright (c) 1998, 1999, Nicolas Souchu
4.\" Copyright (c) 2003, 2004 Gary Thorpe <gathorpe@users.sourceforge.net>
5.\" All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.Dd August 31, 2018
29.Dt ATPPC 4
30.Os
31.Sh NAME
32.Nm atppc
33.Nd driver for AT-style parallel port chip sets
34.Sh SYNOPSIS
35.Cd "atppc* at acpi?"
36.Cd "atppc* at isa? port 0x378 irq 7 drq 3 flags 0x00"
37.Cd "atppc* at isapnp?"
38.Cd "atppc* at ofisa?"
39.Cd "atppc* at pnpbios? index ?"
40.Cd "atppc* at puc? port ?"
41.Cd options ATPPC_VERBOSE
42.Cd options ATPPC_DEBUG
43.Sh DESCRIPTION
44.Nm
45supports parallel ports and provides the low level support needed
46by higher level drivers such as
47.Xr ppbus 4 .
48This driver attaches where the traditional
49.Nx
50.Xr lpt 4
51driver would ordinarily.
52It provides the data transport and chip set manipulation needed by
53higher driver layers, such as
54.Xr ppbus 4
55and
56.Xr lpt 4 .
57This driver is designed to be one of many possible implementations
58supporting machine independent parallel device support via
59.Xr ppbus 4 .
60.Ss IEEE 1284 support
61.Nm
62is intended to provide to data-link like services to higher level
63IEEE 1284 device drivers (such as
64.Xr ppbus 4 ) .
65.Nm
66does not directly support IEEE 1284 features such as mode negotiation
67but rather provides the necessary infrastructure to allow a higher
68level driver to provide these services.
69.Pp
70.Nm
71does provide chip set manipulation, device handshakes (where
72appropriate), low-level error detection, and data transfer.
73.Ss Supported data transfer modes
74.Nm
75supports the following data transfer modes: Centronics Compatible
76(Standard), Nibble, Byte (PS2), Fast Centronics, ECP, and EPP.
77Standard and Fast Centronics modes are write only, Nibble and Byte
78modes are read only, and ECP and EPP modes are bidirectional.
79.\" .Sh FILES
80.\" .Sh EXAMPLES
81.Sh SEE ALSO
82.Xr acpi 4 ,
83.Xr i386/pnpbios 4 ,
84.Xr isa 4 ,
85.Xr isapnp 4 ,
86.Xr lpt 4 ,
87.Xr ofisa 4 ,
88.Xr ppbus 4 ,
89.Xr puc 4
90.Sh HISTORY
91The
92.Nm
93driver is based on the
94.Nm ppc
95driver, which originally appeared in
96.Fx .
97The driver was ported over in
98.Nx 2.0 .
99.Sh AUTHORS
100This manual page is based on the
101.Fx
102.Nm ppc
103manual page.
104The information has been updated for the
105.Nx
106port by
107.An "Gary Thorpe" .
108.Sh BUGS
109The
110.Fx
111driver includes support for some specific chip sets, specifically
112detection of some non-standard device I/O locations on the ISA bus.
113This support was not ported over to the
114.Nx
115version of the driver yet.
116