fs: use kmem_cache_zalloc instead
[pv_ops_mirror.git] / Documentation / networking / cs89x0.txt
blob6387d3decf858a7c83d2ae65f06c6eccdfa7dfae
2 NOTE
3 ----
5 This document was contributed by Cirrus Logic for kernel 2.2.5.  This version
6 has been updated for 2.3.48 by Andrew Morton <andrewm@uow.edu.au>
8 Cirrus make a copy of this driver available at their website, as
9 described below.  In general, you should use the driver version which
10 comes with your Linux distribution.
14 CIRRUS LOGIC LAN CS8900/CS8920 ETHERNET ADAPTERS
15 Linux Network Interface Driver ver. 2.00 <kernel 2.3.48>
16 ===============================================================================
19 TABLE OF CONTENTS
21 1.0 CIRRUS LOGIC LAN CS8900/CS8920 ETHERNET ADAPTERS
22     1.1 Product Overview 
23     1.2 Driver Description
24         1.2.1 Driver Name
25         1.2.2 File in the Driver Package
26     1.3 System Requirements
27     1.4 Licensing Information
29 2.0 ADAPTER INSTALLATION and CONFIGURATION
30     2.1 CS8900-based Adapter Configuration
31     2.2 CS8920-based Adapter Configuration 
33 3.0 LOADING THE DRIVER AS A MODULE
35 4.0 COMPILING THE DRIVER
36     4.1 Compiling the Driver as a Loadable Module
37     4.2 Compiling the driver to support memory mode
38     4.3 Compiling the driver to support Rx DMA 
39     4.4 Compiling the Driver into the Kernel
41 5.0 TESTING AND TROUBLESHOOTING
42     5.1 Known Defects and Limitations
43     5.2 Testing the Adapter
44         5.2.1 Diagnostic Self-Test
45         5.2.2 Diagnostic Network Test
46     5.3 Using the Adapter's LEDs
47     5.4 Resolving I/O Conflicts
49 6.0 TECHNICAL SUPPORT
50     6.1 Contacting Cirrus Logic's Technical Support
51     6.2 Information Required Before Contacting Technical Support
52     6.3 Obtaining the Latest Driver Version
53     6.4 Current maintainer
54     6.5 Kernel boot parameters
57 1.0 CIRRUS LOGIC LAN CS8900/CS8920 ETHERNET ADAPTERS
58 ===============================================================================
61 1.1 PRODUCT OVERVIEW
63 The CS8900-based ISA Ethernet Adapters from Cirrus Logic follow 
64 IEEE 802.3 standards and support half or full-duplex operation in ISA bus 
65 computers on 10 Mbps Ethernet networks.  The adapters are designed for operation 
66 in 16-bit ISA or EISA bus expansion slots and are available in 
67 10BaseT-only or 3-media configurations (10BaseT, 10Base2, and AUI for 10Base-5 
68 or fiber networks).  
70 CS8920-based adapters are similar to the CS8900-based adapter with additional 
71 features for Plug and Play (PnP) support and Wakeup Frame recognition.  As 
72 such, the configuration procedures differ somewhat between the two types of 
73 adapters.  Refer to the "Adapter Configuration" section for details on 
74 configuring both types of adapters.
77 1.2 DRIVER DESCRIPTION
79 The CS8900/CS8920 Ethernet Adapter driver for Linux supports the Linux
80 v2.3.48 or greater kernel.  It can be compiled directly into the kernel
81 or loaded at run-time as a device driver module.
83 1.2.1 Driver Name: cs89x0
85 1.2.2 Files in the Driver Archive:
87 The files in the driver at Cirrus' website include:
89   readme.txt         - this file
90   build              - batch file to compile cs89x0.c.
91   cs89x0.c           - driver C code
92   cs89x0.h           - driver header file
93   cs89x0.o           - pre-compiled module (for v2.2.5 kernel)
94   config/Config.in   - sample file to include cs89x0 driver in the kernel.
95   config/Makefile    - sample file to include cs89x0 driver in the kernel.
96   config/Space.c     - sample file to include cs89x0 driver in the kernel.
100 1.3 SYSTEM REQUIREMENTS
102 The following hardware is required:
104    * Cirrus Logic LAN (CS8900/20-based) Ethernet ISA Adapter   
106    * IBM or IBM-compatible PC with:
107      * An 80386 or higher processor
108      * 16 bytes of contiguous IO space available between 210h - 370h
109      * One available IRQ (5,10,11,or 12 for the CS8900, 3-7,9-15 for CS8920).
111    * Appropriate cable (and connector for AUI, 10BASE-2) for your network
112      topology.
114 The following software is required:
116 * LINUX kernel version 2.3.48 or higher
118    * CS8900/20 Setup Utility (DOS-based)
120    * LINUX kernel sources for your kernel (if compiling into kernel)
122    * GNU Toolkit (gcc and make) v2.6 or above (if compiling into kernel 
123      or a module)   
127 1.4 LICENSING INFORMATION
129 This program is free software; you can redistribute it and/or modify it under
130 the terms of the GNU General Public License as published by the Free Software
131 Foundation, version 1.
133 This program is distributed in the hope that it will be useful, but WITHOUT
134 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 
135 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for 
136 more details.
138 For a full copy of the GNU General Public License, write to the Free Software
139 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
143 2.0 ADAPTER INSTALLATION and CONFIGURATION
144 ===============================================================================
146 Both the CS8900 and CS8920-based adapters can be configured using parameters 
147 stored in an on-board EEPROM. You must use the DOS-based CS8900/20 Setup 
148 Utility if you want to change the adapter's configuration in EEPROM.  
150 When loading the driver as a module, you can specify many of the adapter's 
151 configuration parameters on the command-line to override the EEPROM's settings 
152 or for interface configuration when an EEPROM is not used. (CS8920-based 
153 adapters must use an EEPROM.) See Section 3.0 LOADING THE DRIVER AS A MODULE.
155 Since the CS8900/20 Setup Utility is a DOS-based application, you must install 
156 and configure the adapter in a DOS-based system using the CS8900/20 Setup 
157 Utility before installation in the target LINUX system.  (Not required if 
158 installing a CS8900-based adapter and the default configuration is acceptable.)
159      
161 2.1 CS8900-BASED ADAPTER CONFIGURATION
163 CS8900-based adapters shipped from Cirrus Logic have been configured 
164 with the following "default" settings:
166   Operation Mode:      Memory Mode
167   IRQ:                 10
168   Base I/O Address:    300
169   Memory Base Address: D0000
170   Optimization:        DOS Client
171   Transmission Mode:   Half-duplex
172   BootProm:            None
173   Media Type:          Autodetect (3-media cards) or 
174                        10BASE-T (10BASE-T only adapter)
176 You should only change the default configuration settings if conflicts with 
177 another adapter exists. To change the adapter's configuration, run the 
178 CS8900/20 Setup Utility. 
181 2.2 CS8920-BASED ADAPTER CONFIGURATION
183 CS8920-based adapters are shipped from Cirrus Logic configured as Plug
184 and Play (PnP) enabled.  However, since the cs89x0 driver does NOT
185 support PnP, you must install the CS8920 adapter in a DOS-based PC and
186 run the CS8900/20 Setup Utility to disable PnP and configure the
187 adapter before installation in the target Linux system.  Failure to do
188 this will leave the adapter inactive and the driver will be unable to
189 communicate with the adapter.  
192         **************************************************************** 
193         *                    CS8920-BASED ADAPTERS:                    *
194         *                                                              * 
195         * CS8920-BASED ADAPTERS ARE PLUG and PLAY ENABLED BY DEFAULT.  * 
196         * THE CS89X0 DRIVER DOES NOT SUPPORT PnP. THEREFORE, YOU MUST  *
197         * RUN THE CS8900/20 SETUP UTILITY TO DISABLE PnP SUPPORT AND   *
198         * TO ACTIVATE THE ADAPTER.                                     *
199         ****************************************************************
204 3.0 LOADING THE DRIVER AS A MODULE
205 ===============================================================================
207 If the driver is compiled as a loadable module, you can load the driver module
208 with the 'modprobe' command.  Many of the adapter's configuration parameters can 
209 be specified as command-line arguments to the load command.  This facility 
210 provides a means to override the EEPROM's settings or for interface 
211 configuration when an EEPROM is not used.
213 Example:
215     insmod cs89x0.o io=0x200 irq=0xA media=aui
217 This example loads the module and configures the adapter to use an IO port base
218 address of 200h, interrupt 10, and use the AUI media connection.  The following
219 configuration options are available on the command line:
221 * io=###               - specify IO address (200h-360h)
222 * irq=##               - specify interrupt level
223 * use_dma=1            - Enable DMA
224 * dma=#                - specify dma channel (Driver is compiled to support
225                          Rx DMA only)
226 * dmasize=# (16 or 64) - DMA size 16K or 64K.  Default value is set to 16.
227 * media=rj45           - specify media type
228    or media=bnc
229    or media=aui
230    or media=auto
231 * duplex=full          - specify forced half/full/autonegotiate duplex
232    or duplex=half
233    or duplex=auto
234 * debug=#              - debug level (only available if the driver was compiled
235                          for debugging)
237 NOTES:
239 a) If an EEPROM is present, any specified command-line parameter
240    will override the corresponding configuration value stored in
241    EEPROM.
243 b) The "io" parameter must be specified on the command-line.  
245 c) The driver's hardware probe routine is designed to avoid
246    writing to I/O space until it knows that there is a cs89x0
247    card at the written addresses.  This could cause problems
248    with device probing.  To avoid this behaviour, add one
249    to the `io=' module parameter.  This doesn't actually change
250    the I/O address, but it is a flag to tell the driver
251    to partially initialise the hardware before trying to
252    identify the card.  This could be dangerous if you are
253    not sure that there is a cs89x0 card at the provided address.
255    For example, to scan for an adapter located at IO base 0x300,
256    specify an IO address of 0x301.  
258 d) The "duplex=auto" parameter is only supported for the CS8920.
260 e) The minimum command-line configuration required if an EEPROM is
261    not present is:
263    io 
264    irq 
265    media type (no autodetect)
267 f) The following additional parameters are CS89XX defaults (values
268    used with no EEPROM or command-line argument).
270    * DMA Burst = enabled
271    * IOCHRDY Enabled = enabled
272    * UseSA = enabled
273    * CS8900 defaults to half-duplex if not specified on command-line
274    * CS8920 defaults to autoneg if not specified on command-line
275    * Use reset defaults for other config parameters
276    * dma_mode = 0
278 g) You can use ifconfig to set the adapter's Ethernet address.
280 h) Many Linux distributions use the 'modprobe' command to load
281    modules.  This program uses the '/etc/conf.modules' file to
282    determine configuration information which is passed to a driver
283    module when it is loaded.  All the configuration options which are
284    described above may be placed within /etc/conf.modules.
286    For example:
288    > cat /etc/conf.modules
289    ...
290    alias eth0 cs89x0
291    options cs89x0 io=0x0200 dma=5 use_dma=1
292    ...
294    In this example we are telling the module system that the
295    ethernet driver for this machine should use the cs89x0 driver.  We
296    are asking 'modprobe' to pass the 'io', 'dma' and 'use_dma'
297    arguments to the driver when it is loaded.
299 i) Cirrus recommend that the cs89x0 use the ISA DMA channels 5, 6 or
300    7.  You will probably find that other DMA channels will not work.
302 j) The cs89x0 supports DMA for receiving only.  DMA mode is
303    significantly more efficient.  Flooding a 400 MHz Celeron machine
304    with large ping packets consumes 82% of its CPU capacity in non-DMA
305    mode.  With DMA this is reduced to 45%.
307 k) If your Linux kernel was compiled with inbuilt plug-and-play
308    support you will be able to find information about the cs89x0 card
309    with the command
311    cat /proc/isapnp
313 l) If during DMA operation you find erratic behavior or network data
314    corruption you should use your PC's BIOS to slow the EISA bus clock.
316 m) If the cs89x0 driver is compiled directly into the kernel
317    (non-modular) then its I/O address is automatically determined by
318    ISA bus probing.  The IRQ number, media options, etc are determined
319    from the card's EEPROM.
321 n) If the cs89x0 driver is compiled directly into the kernel, DMA
322    mode may be selected by providing the kernel with a boot option
323    'cs89x0_dma=N' where 'N' is the desired DMA channel number (5, 6 or 7).
325    Kernel boot options may be provided on the LILO command line:
327         LILO boot: linux cs89x0_dma=5
329    or they may be placed in /etc/lilo.conf:
331         image=/boot/bzImage-2.3.48
332           append="cs89x0_dma=5"
333           label=linux
334           root=/dev/hda5
335           read-only
337    The DMA Rx buffer size is hardwired to 16 kbytes in this mode.
338    (64k mode is not available).
341 4.0 COMPILING THE DRIVER
342 ===============================================================================
344 The cs89x0 driver can be compiled directly into the kernel or compiled into
345 a loadable device driver module.
348 4.1 COMPILING THE DRIVER AS A LOADABLE MODULE
350 To compile the driver into a loadable module, use the following command 
351 (single command line, without quotes):
353 "gcc -D__KERNEL__ -I/usr/src/linux/include -I/usr/src/linux/net/inet -Wall 
354 -Wstrict-prototypes -O2 -fomit-frame-pointer -DMODULE -DCONFIG_MODVERSIONS 
355 -c cs89x0.c"
357 4.2 COMPILING THE DRIVER TO SUPPORT MEMORY MODE
359 Support for memory mode was not carried over into the 2.3 series kernels.
361 4.3 COMPILING THE DRIVER TO SUPPORT Rx DMA
363 The compile-time optionality for DMA was removed in the 2.3 kernel
364 series.  DMA support is now unconditionally part of the driver.  It is
365 enabled by the 'use_dma=1' module option.
367 4.4 COMPILING THE DRIVER INTO THE KERNEL
369 If your Linux distribution already has support for the cs89x0 driver
370 then simply copy the source file to the /usr/src/linux/drivers/net
371 directory to replace the original ones and run the make utility to
372 rebuild the kernel.  See Step 3 for rebuilding the kernel.
374 If your Linux does not include the cs89x0 driver, you need to edit three 
375 configuration files, copy the source file to the /usr/src/linux/drivers/net
376 directory, and then run the make utility to rebuild the kernel.
378 1. Edit the following configuration files by adding the statements as
379 indicated.  (When possible, try to locate the added text to the section of the
380 file containing similar statements).
383 a.) In /usr/src/linux/drivers/net/Config.in, add:
385 tristate 'CS89x0 support' CONFIG_CS89x0
387 Example:
389      if [ "$CONFIG_EXPERIMENTAL" = "y" ]; then
390        tristate 'ICL EtherTeam 16i/32 support' CONFIG_ETH16I
391      fi
393      tristate 'CS89x0 support' CONFIG_CS89x0
395      tristate 'NE2000/NE1000 support' CONFIG_NE2000
396      if [ "$CONFIG_EXPERIMENTAL" = "y" ]; then
397        tristate 'NI5210 support' CONFIG_NI52
400 b.) In /usr/src/linux/drivers/net/Makefile, add the following lines: 
402 ifeq ($(CONFIG_CS89x0),y)
403 L_OBJS += cs89x0.o
404 else
405   ifeq ($(CONFIG_CS89x0),m)
406   M_OBJS += cs89x0.o
407   endif
408 endif
411 c.) In /linux/drivers/net/Space.c file, add the line:
413 extern int cs89x0_probe(struct device *dev);
416 Example:
418  extern int ultra_probe(struct device *dev);
419  extern int wd_probe(struct device *dev);
420  extern int el2_probe(struct device *dev);
422  extern int cs89x0_probe(struct device *dev);
424  extern int ne_probe(struct device *dev);
425  extern int hp_probe(struct device *dev);
426  extern int hp_plus_probe(struct device *dev);
429 Also add:
431  #ifdef CONFIG_CS89x0
432         { cs89x0_probe,0 },
433  #endif
436 2.) Copy the driver source files (cs89x0.c and cs89x0.h) 
437 into the /usr/src/linux/drivers/net directory.
440 3.) Go to /usr/src/linux directory and run 'make config' followed by 'make' 
441 (or make bzImage) to rebuild the kernel. 
443 4.) Use the DOS 'setup' utility to disable plug and play on the NIC.
446 5.0 TESTING AND TROUBLESHOOTING
447 ===============================================================================
449 5.1 KNOWN DEFECTS and LIMITATIONS
451 Refer to the RELEASE.TXT file distributed as part of this archive for a list of 
452 known defects, driver limitations, and work arounds.
455 5.2 TESTING THE ADAPTER
457 Once the adapter has been installed and configured, the diagnostic option of 
458 the CS8900/20 Setup Utility can be used to test the functionality of the 
459 adapter and its network connection.  Use the diagnostics 'Self Test' option to
460 test the functionality of the adapter with the hardware configuration you have
461 assigned. You can use the diagnostics 'Network Test' to test the ability of the
462 adapter to communicate across the Ethernet with another PC equipped with a 
463 CS8900/20-based adapter card (it must also be running the CS8900/20 Setup 
464 Utility).
466          NOTE: The Setup Utility's diagnostics are designed to run in a
467          DOS-only operating system environment.  DO NOT run the diagnostics 
468          from a DOS or command prompt session under Windows 95, Windows NT, 
469          OS/2, or other operating system.
471 To run the diagnostics tests on the CS8900/20 adapter:
473    1.) Boot DOS on the PC and start the CS8900/20 Setup Utility.
475    2.) The adapter's current configuration is displayed.  Hit the ENTER key to
476        get to the main menu.
478    4.) Select 'Diagnostics' (ALT-G) from the main menu.  
479        * Select 'Self-Test' to test the adapter's basic functionality.
480        * Select 'Network Test' to test the network connection and cabling.
483 5.2.1 DIAGNOSTIC SELF-TEST
485 The diagnostic self-test checks the adapter's basic functionality as well as 
486 its ability to communicate across the ISA bus based on the system resources 
487 assigned during hardware configuration.  The following tests are performed:
489    * IO Register Read/Write Test
490      The IO Register Read/Write test insures that the CS8900/20 can be 
491      accessed in IO mode, and that the IO base address is correct.
493    * Shared Memory Test
494      The Shared Memory test insures the CS8900/20 can be accessed in memory 
495      mode and that the range of memory addresses assigned does not conflict 
496      with other devices in the system.
498    * Interrupt Test
499      The Interrupt test insures there are no conflicts with the assigned IRQ
500      signal.
502    * EEPROM Test
503      The EEPROM test insures the EEPROM can be read.
505    * Chip RAM Test
506      The Chip RAM test insures the 4K of memory internal to the CS8900/20 is
507      working properly.
509    * Internal Loop-back Test
510      The Internal Loop Back test insures the adapter's transmitter and 
511      receiver are operating properly.  If this test fails, make sure the 
512      adapter's cable is connected to the network (check for LED activity for 
513      example).
515    * Boot PROM Test
516      The Boot PROM  test insures the Boot PROM is present, and can be read.
517      Failure indicates the Boot PROM  was not successfully read due to a
518      hardware problem or due to a conflicts on the Boot PROM address
519      assignment. (Test only applies if the adapter is configured to use the
520      Boot PROM option.)
522 Failure of a test item indicates a possible system resource conflict with 
523 another device on the ISA bus.  In this case, you should use the Manual Setup 
524 option to reconfigure the adapter by selecting a different value for the system
525 resource that failed.
528 5.2.2 DIAGNOSTIC NETWORK TEST
530 The Diagnostic Network Test verifies a working network connection by 
531 transferring data between two CS8900/20 adapters installed in different PCs 
532 on the same network. (Note: the diagnostic network test should not be run 
533 between two nodes across a router.) 
535 This test requires that each of the two PCs have a CS8900/20-based adapter
536 installed and have the CS8900/20 Setup Utility running.  The first PC is 
537 configured as a Responder and the other PC is configured as an Initiator.  
538 Once the Initiator is started, it sends data frames to the Responder which 
539 returns the frames to the Initiator.
541 The total number of frames received and transmitted are displayed on the 
542 Initiator's display, along with a count of the number of frames received and 
543 transmitted OK or in error.  The test can be terminated anytime by the user at 
544 either PC.
546 To setup the Diagnostic Network Test:
548     1.) Select a PC with a CS8900/20-based adapter and a known working network
549         connection to act as the Responder.  Run the CS8900/20 Setup Utility 
550         and select 'Diagnostics -> Network Test -> Responder' from the main 
551         menu.  Hit ENTER to start the Responder.
553     2.) Return to the PC with the CS8900/20-based adapter you want to test and
554         start the CS8900/20 Setup Utility. 
556     3.) From the main menu, Select 'Diagnostic -> Network Test -> Initiator'.
557         Hit ENTER to start the test.
559 You may stop the test on the Initiator at any time while allowing the Responder
560 to continue running.  In this manner, you can move to additional PCs and test 
561 them by starting the Initiator on another PC without having to stop/start the 
562 Responder.
566 5.3 USING THE ADAPTER'S LEDs
568 The 2 and 3-media adapters have two LEDs visible on the back end of the board 
569 located near the 10Base-T connector.  
571 Link Integrity LED: A "steady" ON of the green LED indicates a valid 10Base-T 
572 connection.  (Only applies to 10Base-T.  The green LED has no significance for
573 a 10Base-2 or AUI connection.)
575 TX/RX LED: The yellow LED lights briefly each time the adapter transmits or 
576 receives data. (The yellow LED will appear to "flicker" on a typical network.)
579 5.4 RESOLVING I/O CONFLICTS
581 An IO conflict occurs when two or more adapter use the same ISA resource (IO 
582 address, memory address or IRQ).  You can usually detect an IO conflict in one 
583 of four ways after installing and or configuring the CS8900/20-based adapter:
585     1.) The system does not boot properly (or at all).
587     2.) The driver cannot communicate with the adapter, reporting an "Adapter
588         not found" error message.
590     3.) You cannot connect to the network or the driver will not load.
592     4.) If you have configured the adapter to run in memory mode but the driver
593         reports it is using IO mode when loading, this is an indication of a
594         memory address conflict.
596 If an IO conflict occurs, run the CS8900/20 Setup Utility and perform a 
597 diagnostic self-test.  Normally, the ISA resource in conflict will fail the 
598 self-test.  If so, reconfigure the adapter selecting another choice for the 
599 resource in conflict.  Run the diagnostics again to check for further IO 
600 conflicts.
602 In some cases, such as when the PC will not boot, it may be necessary to remove
603 the adapter and reconfigure it by installing it in another PC to run the 
604 CS8900/20 Setup Utility.  Once reinstalled in the target system, run the 
605 diagnostics self-test to ensure the new configuration is free of conflicts 
606 before loading the driver again.
608 When manually configuring the adapter, keep in mind the typical ISA system 
609 resource usage as indicated in the tables below.
611 I/O Address     Device                        IRQ      Device
612 -----------     --------                      ---      --------
613  200-20F        Game I/O adapter               3       COM2, Bus Mouse
614  230-23F        Bus Mouse                      4       COM1
615  270-27F        LPT3: third parallel port      5       LPT2
616  2F0-2FF        COM2: second serial port       6       Floppy Disk controller
617  320-32F        Fixed disk controller          7       LPT1
618                                                8       Real-time Clock
619                                                  9       EGA/VGA display adapter    
620                                                 12       Mouse (PS/2)                              
621 Memory Address  Device                          13       Math Coprocessor
622 --------------  ---------------------           14       Hard Disk controller
623 A000-BFFF       EGA Graphics Adapter
624 A000-C7FF       VGA Graphics Adapter
625 B000-BFFF       Mono Graphics Adapter
626 B800-BFFF       Color Graphics Adapter
627 E000-FFFF       AT BIOS
632 6.0 TECHNICAL SUPPORT
633 ===============================================================================
635 6.1 CONTACTING CIRRUS LOGIC'S TECHNICAL SUPPORT
637 Cirrus Logic's CS89XX Technical Application Support can be reached at:
639 Telephone  :(800) 888-5016 (from inside U.S. and Canada)
640            :(512) 442-7555 (from outside the U.S. and Canada)
641 Fax        :(512) 912-3871
642 Email      :ethernet@crystal.cirrus.com
643 WWW        :http://www.cirrus.com
646 6.2 INFORMATION REQUIRED BEFORE CONTACTING TECHNICAL SUPPORT
648 Before contacting Cirrus Logic for technical support, be prepared to provide as 
649 Much of the following information as possible. 
651 1.) Adapter type (CRD8900, CDB8900, CDB8920, etc.)
653 2.) Adapter configuration
655     * IO Base, Memory Base, IO or memory mode enabled, IRQ, DMA channel
656     * Plug and Play enabled/disabled (CS8920-based adapters only)
657     * Configured for media auto-detect or specific media type (which type).    
659 3.) PC System's Configuration
661     * Plug and Play system (yes/no)
662     * BIOS (make and version)
663     * System make and model
664     * CPU (type and speed)
665     * System RAM
666     * SCSI Adapter
668 4.) Software
670     * CS89XX driver and version
671     * Your network operating system and version
672     * Your system's OS version 
673     * Version of all protocol support files
675 5.) Any Error Message displayed.
679 6.3 OBTAINING THE LATEST DRIVER VERSION
681 You can obtain the latest CS89XX drivers and support software from Cirrus Logic's 
682 Web site.  You can also contact Cirrus Logic's Technical Support (email:
683 ethernet@crystal.cirrus.com) and request that you be registered for automatic 
684 software-update notification.
686 Cirrus Logic maintains a web page at http://www.cirrus.com with the
687 latest drivers and technical publications.
690 6.4 Current maintainer
692 In February 2000 the maintenance of this driver was assumed by Andrew
693 Morton <akpm@zip.com.au>
695 6.5 Kernel module parameters
697 For use in embedded environments with no cs89x0 EEPROM, the kernel boot
698 parameter `cs89x0_media=' has been implemented.  Usage is:
700         cs89x0_media=rj45    or
701         cs89x0_media=aui     or
702         cs89x0_media=bnc