patch-2.1.4 linux/Documentation/networking/3c505.txt

Next file: linux/Documentation/networking/net-modules.txt
Previous file: linux/Documentation/locks.txt
Back to the patch index
Back to the overall index

diff -u --recursive --new-file v2.1.3/linux/Documentation/networking/3c505.txt linux/Documentation/networking/3c505.txt
@@ -1,26 +1,37 @@
 The 3Com Etherlink Plus (3c505) driver.
 
 This driver now uses DMA.  There is currently no support for PIO operation.
-The default DMA channel is 6, and is set at compile time.
+The default DMA channel is 6; this is _not_ autoprobed, so you must
+make sure you configure it correctly.  If loading the driver as a
+module, you can do this with "modprobe 3c505 dma=n".  If the driver is
+linked statically into the kernel, you must either use an "ether="
+statement on the command line, or change the definition of ELP_DMA in 3c505.h.
+
+The driver will warn you if it has to fall back on the compiled in
+default DMA channel. 
 
 If no base address is given at boot time, the driver will autoprobe
 ports 0x300, 0x280 and 0x310 (in that order).  If no IRQ is given, the driver
 will try to probe for it.
 
 The driver can be used as a loadable module.  See net-modules.txt for details
-of the parameters it can take.
-
-At the moment, the driver probably won't work with old (revision 2) hardware.
+of the parameters it can take.  
 
-There is one compile-time setting in the CONFIG file:
-ELP_DEBUG
- The driver debug level.  It's probably best to leave it at 0 most of the time.
- If you are having trouble, setting it to 1 may give you more information.
- Any higher setting is too verbose for most purposes.
+Theoretically, one instance of the driver can now run multiple cards,
+in the standard way (when loading a module, say "modprobe 3c505
+io=0x300,0x340 irq=10,11 dma=6,7" or whatever).  I have not tested
+this, though.
+
+The driver may now support revision 2 hardware; the dependency on
+being able to read the host control register has been removed.  This
+is also untested, since I don't have a suitable card.
+
+Known problems:
+ I still see "DMA upload timed out" messages from time to time.  These
+seem to be fairly non-fatal though.
+ The card is old and slow.
 
 To do:
- Support for old boards
- Make DMA configurable at run time
  Improve probe/setup code
  Test multicast and promiscuous operation
 
@@ -31,3 +42,5 @@
  IRQ/address detection, some changes) and this README by
  Juha Laiho <jlaiho@ichaos.nullnet.fi>.
  DMA mode, more fixes, etc, by Philip Blundell <pjb27@cam.ac.uk>
+ Multicard support, Software configurable DMA, etc., by
+ Christopher Collins <ccollins@pcug.org.au>

FUNET's LINUX-ADM group, linux-adm@nic.funet.fi
TCL-scripts by Sam Shen, slshen@lbl.gov