ia64/linux-2.6.18-xen.hg

diff Documentation/digiepca.txt @ 0:831230e53067

Import 2.6.18 from kernel.org tarball.
author Ian Campbell <ian.campbell@xensource.com>
date Wed Apr 11 14:15:44 2007 +0100 (2007-04-11)
parents
children
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/Documentation/digiepca.txt	Wed Apr 11 14:15:44 2007 +0100
     1.3 @@ -0,0 +1,98 @@
     1.4 +NOTE:  This driver is obsolete.  Digi provides a 2.6 driver (dgdm) at
     1.5 +http://www.digi.com for PCI cards.  They no longer maintain this driver,
     1.6 +and have no 2.6 driver for ISA cards.
     1.7 +
     1.8 +This driver requires a number of user-space tools.  They can be acquired from
     1.9 +http://www.digi.com, but only works with 2.4 kernels.
    1.10 +
    1.11 +
    1.12 +The Digi Intl. epca driver. 
    1.13 +----------------------------
    1.14 +The Digi Intl. epca driver for Linux supports the following boards:
    1.15 +
    1.16 +Digi PC/Xem, PC/Xr, PC/Xe, PC/Xi, PC/Xeve 
    1.17 +Digi EISA/Xem, PCI/Xem, PCI/Xr 
    1.18 +
    1.19 +Limitations:
    1.20 +------------
    1.21 +Currently the driver only autoprobes for supported PCI boards. 
    1.22 +
    1.23 +The Linux MAKEDEV command does not support generating the Digiboard
    1.24 +Devices.  Users executing digiConfig to setup EISA and PC series cards
    1.25 +will have their device nodes automatically constructed (cud?? for ~CLOCAL,
    1.26 +and ttyD?? for CLOCAL).  Users wishing to boot their board from the LILO
    1.27 +prompt, or those users booting PCI cards may use buildDIGI to construct 
    1.28 +the necessary nodes. 
    1.29 +
    1.30 +Notes:
    1.31 +------
    1.32 +This driver may be configured via LILO.  For users who have already configured
    1.33 +their driver using digiConfig, configuring from LILO will override previous 
    1.34 +settings.  Multiple boards may be configured by issuing multiple LILO command 
    1.35 +lines.  For examples see the bottom of this document.
    1.36 +
    1.37 +Device names start at 0 and continue up.  Beware of this as previous Digi 
    1.38 +drivers started device names with 1.
    1.39 +
    1.40 +PCI boards are auto-detected and configured by the driver.  PCI boards will
    1.41 +be allocated device numbers (internally) beginning with the lowest PCI slot
    1.42 +first.  In other words a PCI card in slot 3 will always have higher device
    1.43 +nodes than a PCI card in slot 1. 
    1.44 +
    1.45 +LILO config examples:
    1.46 +---------------------
    1.47 +Using LILO's APPEND command, a string of comma separated identifiers or 
    1.48 +integers can be used to configure supported boards.  The six values in order 
    1.49 +are:
    1.50 +
    1.51 +   Enable/Disable this card or Override,
    1.52 +   Type of card: PC/Xe (AccelePort) (0), PC/Xeve (1), PC/Xem or PC/Xr (2), 
    1.53 +                 EISA/Xem (3), PC/64Xe (4), PC/Xi (5), 
    1.54 +   Enable/Disable alternate pin arrangement,
    1.55 +   Number of ports on this card,
    1.56 +   I/O Port where card is configured (in HEX if using string identifiers),
    1.57 +   Base of memory window (in HEX if using string identifiers), 
    1.58 +
    1.59 +NOTE : PCI boards are auto-detected and configured.  Do not attempt to 
    1.60 +configure PCI boards with the LILO append command.  If you wish to override
    1.61 +previous configuration data (As set by digiConfig), but you do not wish to
    1.62 +configure any specific card (Example if there are PCI cards in the system) 
    1.63 +the following override command will accomplish this:
    1.64 +-> append="digi=2"
    1.65 +
    1.66 +Samples:
    1.67 +   append="digiepca=E,PC/Xe,D,16,200,D0000"
    1.68 +                  or
    1.69 +   append="digi=1,0,0,16,512,851968"
    1.70 +
    1.71 +Supporting Tools:
    1.72 +-----------------
    1.73 +Supporting tools include digiDload, digiConfig, buildPCI, and ditty.  See
    1.74 +drivers/char/README.epca for more details.  Note,
    1.75 +this driver REQUIRES that digiDload be executed prior to it being used. 
    1.76 +Failure to do this will result in an ENODEV error.
    1.77 +
    1.78 +Documentation:
    1.79 +--------------
    1.80 +Complete documentation for this product may be found in the tool package. 
    1.81 +
    1.82 +Sources of information and support:
    1.83 +-----------------------------------
    1.84 +Digi Intl. support site for this product:
    1.85 +
    1.86 +->  http://www.digi.com
    1.87 +
    1.88 +Acknowledgments:
    1.89 +----------------
    1.90 +Much of this work (And even text) was derived from a similar document 
    1.91 +supporting the original public domain DigiBoard driver Copyright (C)
    1.92 +1994,1995 Troy De Jongh.  Many thanks to Christoph Lameter 
    1.93 +(christoph@lameter.com) and Mike McLagan (mike.mclagan@linux.org) who authored 
    1.94 +and contributed to the original document. 
    1.95 +
    1.96 +Changelog:
    1.97 +----------
    1.98 +10-29-04:	Update status of driver, remove dead links in document
    1.99 +		James Nelson <james4765@gmail.com>
   1.100 +
   1.101 +2000 (?)	Original Document