share/man/man4/atppc.4

   1 .\"     $NetBSD: atppc.4,v 1.14 2004/01/30 19:06:36 jdolecek 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 January 30, 2004
  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
  45 supports parallel ports and provides the low level support needed
  46 by higher level drivers such as
  47 .Xr ppbus 4 .
  48 This driver attaches where the traditional
  49 .Nx
  50 .Xr lpt 4
  51 driver would ordinarily.
  52 It provides the data transport and chip set manipulation needed by
  53 higher driver layers, such as
  54 .Xr ppbus 4
  55 and
  56 .Xr lpt 4 .
  57 This driver is designed to be one of many possible implementations
  58 supporting machine independent parallel device support via
  59 .Xr ppbus 4 .
  60 .Ss IEEE 1284 support
  61 .Nm
  62 is intended to provide to data-link like services to higher level
  63 IEEE 1284 device drivers (such as
  64 .Xr ppbus 4 ) .
  65 .Nm
  66 does not directly support IEEE 1284 features such as mode negotiation
  67 but rather provides the necessary infrastructure to allow a higher
  68 level driver to provide these services.
  69 .Pp
  70 .Nm
  71 does provide chip set manipulation, device handshakes (where
  72 appropriate), low-level error detection, and data transfer.
  73 .Ss Supported data transfer modes
  74 .Nm
  75 supports the following data transfer modes: Centronics Compatible
  76 (Standard), Nibble, Byte (PS2), Fast Centronics, ECP, and EPP.
  77 Standard and Fast Centronics modes are write only, Nibble and Byte
  78 modes 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
  91 The
  92 .Nm
  93 driver is based on the
  94 .Nm ppc
  95 driver, which originally appeared in
  96 .Fx .
  97 The driver was ported over in
  98 .Nx 2.0 .
  99 .Sh AUTHORS
 100 This manual page is based on the
 101 .Fx
 102 .Nm ppc
 103 manual page.
 104 The information has been updated for the
 105 .Nx
 106 port by Gary Thorpe.
 107 .Sh BUGS
 108 The
 109 .Fx
 110 driver includes support for some specific chip sets, specifically
 111 detection of some non-standard device I/O locations on the ISA bus.
 112 This support was not ported over to the
 113 .Nx
 114 version of the driver yet.