1The Digi Intl. epca driver.
2----------------------------
3The Digi Intl. epca driver for Linux supports the following boards:
4
5Digi PC/Xem, PC/Xr, PC/Xe, PC/Xi, PC/Xeve
6Digi EISA/Xem, PCI/Xem, PCI/Xr
7
8Limitations:
9------------
10Currently the driver only autoprobes for supported PCI boards.
11
12The Linux MAKEDEV command does not support generating the Digiboard
13Devices.  Users executing digiConfig to setup EISA and PC series cards
14will have their device nodes automatically constructed (cud?? for ~CLOCAL,
15and ttyD?? for CLOCAL).  Users wishing to boot their board from the LILO
16prompt, or those users booting PCI cards may use buildDIGI to construct
17the necessary nodes.
18
19Notes:
20------
21This driver may be configured via LILO.  For users who have already configured
22their driver using digiConfig, configuring from LILO will override previous
23settings.  Multiple boards may be configured by issuing multiple LILO command
24lines.  For examples see the bottom of this document.
25
26Device names start at 0 and continue up.  Beware of this as previous Digi
27drivers started device names with 1.
28
29PCI boards are auto-detected and configured by the driver.  PCI boards will
30be allocated device numbers (internally) beginning with the lowest PCI slot
31first.  In other words a PCI card in slot 3 will always have higher device
32nodes than a PCI card in slot 1.
33
34LILO config examples:
35---------------------
36Using LILO's APPEND command, a string of comma separated identifiers or
37integers can be used to configure supported boards.  The six values in order
38are:
39
40   Enable/Disable this card or Override,
41   Type of card: PC/Xe (AccelePort) (0), PC/Xeve (1), PC/Xem or PC/Xr (2),
42                 EISA/Xem (3), PC/64Xe (4), PC/Xi (5),
43   Enable/Disable alternate pin arrangement,
44   Number of ports on this card,
45   I/O Port where card is configured (in HEX if using string identifiers),
46   Base of memory window (in HEX if using string identifiers),
47
48NOTE : PCI boards are auto-detected and configured.  Do not attempt to
49configure PCI boards with the LILO append command.  If you wish to override
50previous configuration data (As set by digiConfig), but you do not wish to
51configure any specific card (Example if there are PCI cards in the system)
52the following override command will accomplish this:
53-> append="digi=2"
54
55Samples:
56   append="digiepca=E,PC/Xe,D,16,200,D0000"
57                  or
58   append="digi=1,0,0,16,512,851968"
59
60Supporting Tools:
61-----------------
62Supporting tools include digiDload, digiConfig, buildPCI, and ditty.  See
63/usr/src/linux/Documentation/README.epca.dir/user.doc for more details.  Note,
64this driver REQUIRES that digiDload be executed prior to it being used.
65Failure to do this will result in an ENODEV error.
66
67The latest version of the tool package is available at:
68ftp://ftp.dgii.com/drivers/linux/released/async/
69
70Documentation:
71--------------
72Complete documentation for this product may be found in the tool package.
73
74Sources of information and support:
75-----------------------------------
76Digi Intl. support site for this product:
77-> digilnux@dgii.com
78
79Related information and information concerning other drivers supporting
80Digi Intl. products:
81
82-> FTP: ftp://dgii.com
83-> Webpage: http://www.dgii.com
84-> Webpage: http://lameter.com/digi
85
86Acknowledgments:
87----------------
88Much of this work (And even text) was derived from a similar document
89supporting the original public domain DigiBoard driver Copyright (C)
901994,1995 Troy De Jongh.  Many thanks to Christoph Lameter
91(christoph@lameter.com) and Mike McLagan (mike.mclagan@linux.org) who authored
92and contributed to the original document.
93