Pull error-inject into release branch
[linux-2.6] / Documentation / networking / 3c505.txt
1 The 3Com Etherlink Plus (3c505) driver.
2
3 This driver now uses DMA.  There is currently no support for PIO operation.
4 The default DMA channel is 6; this is _not_ autoprobed, so you must
5 make sure you configure it correctly.  If loading the driver as a
6 module, you can do this with "modprobe 3c505 dma=n".  If the driver is
7 linked statically into the kernel, you must either use an "ether="
8 statement on the command line, or change the definition of ELP_DMA in 3c505.h.
9
10 The driver will warn you if it has to fall back on the compiled in
11 default DMA channel. 
12
13 If no base address is given at boot time, the driver will autoprobe
14 ports 0x300, 0x280 and 0x310 (in that order).  If no IRQ is given, the driver
15 will try to probe for it.
16
17 The driver can be used as a loadable module.  See net-modules.txt for details
18 of the parameters it can take.  
19
20 Theoretically, one instance of the driver can now run multiple cards,
21 in the standard way (when loading a module, say "modprobe 3c505
22 io=0x300,0x340 irq=10,11 dma=6,7" or whatever).  I have not tested
23 this, though.
24
25 The driver may now support revision 2 hardware; the dependency on
26 being able to read the host control register has been removed.  This
27 is also untested, since I don't have a suitable card.
28
29 Known problems:
30  I still see "DMA upload timed out" messages from time to time.  These
31 seem to be fairly non-fatal though.
32  The card is old and slow.
33
34 To do:
35  Improve probe/setup code
36  Test multicast and promiscuous operation
37
38 Authors:
39  The driver is mainly written by Craig Southeren, email
40  <craigs@ineluki.apana.org.au>.
41  Parts of the driver (adapting the driver to 1.1.4+ kernels,
42  IRQ/address detection, some changes) and this README by
43  Juha Laiho <jlaiho@ichaos.nullnet.fi>.
44  DMA mode, more fixes, etc, by Philip Blundell <pjb27@cam.ac.uk>
45  Multicard support, Software configurable DMA, etc., by
46  Christopher Collins <ccollins@pcug.org.au>