sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftargetD/translations/zh_CN/networking/device_drivers/ethernet/cirrus/cs89x0modnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetD/translations/zh_TW/networking/device_drivers/ethernet/cirrus/cs89x0modnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetD/translations/it_IT/networking/device_drivers/ethernet/cirrus/cs89x0modnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetD/translations/ja_JP/networking/device_drivers/ethernet/cirrus/cs89x0modnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetD/translations/ko_KR/networking/device_drivers/ethernet/cirrus/cs89x0modnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetD/translations/sp_SP/networking/device_drivers/ethernet/cirrus/cs89x0modnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhh^/var/lib/git/docbuild/linux/Documentation/networking/device_drivers/ethernet/cirrus/cs89x0.rsthKubhsection)}(hhh](htitle)}(h0Cirrus Logic LAN CS8900/CS8920 Ethernet Adaptersh]h0Cirrus Logic LAN CS8900/CS8920 Ethernet Adapters}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubhnote)}(hThis document was contributed by Cirrus Logic for kernel 2.2.5. This version has been updated for 2.3.48 by Andrew Morton. Still, this is too outdated! A major cleanup is needed here.h](h paragraph)}(h{This document was contributed by Cirrus Logic for kernel 2.2.5. This version has been updated for 2.3.48 by Andrew Morton.h]h{This document was contributed by Cirrus Logic for kernel 2.2.5. This version has been updated for 2.3.48 by Andrew Morton.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhubh)}(hh]h8Linux Network Interface Driver ver. 2.00 }(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hXBTABLE OF CONTENTS 1.0 CIRRUS LOGIC LAN CS8900/CS8920 ETHERNET ADAPTERS 1.1 Product Overview 1.2 Driver Description 1.2.1 Driver Name 1.2.2 File in the Driver Package 1.3 System Requirements 1.4 Licensing Information 2.0 ADAPTER INSTALLATION and CONFIGURATION 2.1 CS8900-based Adapter Configuration 2.2 CS8920-based Adapter Configuration 3.0 LOADING THE DRIVER AS A MODULE 4.0 COMPILING THE DRIVER 4.1 Compiling the Driver as a Loadable Module 4.2 Compiling the driver to support memory mode 4.3 Compiling the driver to support Rx DMA 5.0 TESTING AND TROUBLESHOOTING 5.1 Known Defects and Limitations 5.2 Testing the Adapter 5.2.1 Diagnostic Self-Test 5.2.2 Diagnostic Network Test 5.3 Using the Adapter's LEDs 5.4 Resolving I/O Conflicts 6.0 TECHNICAL SUPPORT 6.1 Contacting Cirrus Logic's Technical Support 6.2 Information Required Before Contacting Technical Support 6.3 Obtaining the Latest Driver Version 6.4 Current maintainer 6.5 Kernel boot parametersh]hXBTABLE OF CONTENTS 1.0 CIRRUS LOGIC LAN CS8900/CS8920 ETHERNET ADAPTERS 1.1 Product Overview 1.2 Driver Description 1.2.1 Driver Name 1.2.2 File in the Driver Package 1.3 System Requirements 1.4 Licensing Information 2.0 ADAPTER INSTALLATION and CONFIGURATION 2.1 CS8900-based Adapter Configuration 2.2 CS8920-based Adapter Configuration 3.0 LOADING THE DRIVER AS A MODULE 4.0 COMPILING THE DRIVER 4.1 Compiling the Driver as a Loadable Module 4.2 Compiling the driver to support memory mode 4.3 Compiling the driver to support Rx DMA 5.0 TESTING AND TROUBLESHOOTING 5.1 Known Defects and Limitations 5.2 Testing the Adapter 5.2.1 Diagnostic Self-Test 5.2.2 Diagnostic Network Test 5.3 Using the Adapter's LEDs 5.4 Resolving I/O Conflicts 6.0 TECHNICAL SUPPORT 6.1 Contacting Cirrus Logic's Technical Support 6.2 Information Required Before Contacting Technical Support 6.3 Obtaining the Latest Driver Version 6.4 Current maintainer 6.5 Kernel boot parameters}hjsbah}(h]h ]h"]h$]h&]hhuh1hhhhhhhhK:ubh)}(hhh]h)}(h31. Cirrus Logic LAN CS8900/CS8920 Ethernet Adaptersh]h31. Cirrus Logic LAN CS8900/CS8920 Ethernet Adapters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hhh](h)}(h'2.1. CS8900-based Adapter Configurationh]h'2.1. CS8900-based Adapter Configuration}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLhhhhhKubh)}(hlCS8900-based adapters shipped from Cirrus Logic have been configured with the following "default" settings::h]hoCS8900-based adapters shipped from Cirrus Logic have been configured with the following “default” settings:}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjLhhubh literal_block)}(hX0Operation Mode: Memory Mode IRQ: 10 Base I/O Address: 300 Memory Base Address: D0000 Optimization: DOS Client Transmission Mode: Half-duplex BootProm: None Media Type: Autodetect (3-media cards) or 10BASE-T (10BASE-T only adapter)h]hX0Operation Mode: Memory Mode IRQ: 10 Base I/O Address: 300 Memory Base Address: D0000 Optimization: DOS Client Transmission Mode: Half-duplex BootProm: None Media Type: Autodetect (3-media cards) or 10BASE-T (10BASE-T only adapter)}hjmsbah}(h]h ]h"]h$]h&]hhuh1jkhhhKhjLhhubh)}(hYou should only change the default configuration settings if conflicts with another adapter exists. To change the adapter's configuration, run the CS8900/20 Setup Utility.h]hYou should only change the default configuration settings if conflicts with another adapter exists. To change the adapter’s configuration, run the CS8900/20 Setup Utility.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjLhhubeh}(h]"cs8900-based-adapter-configurationah ]h"]'2.1. cs8900-based adapter configurationah$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(h'2.2. CS8920-based Adapter Configurationh]h'2.2. CS8920-based Adapter Configuration}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hXCS8920-based adapters are shipped from Cirrus Logic configured as Plug and Play (PnP) enabled. However, since the cs89x0 driver does NOT support PnP, you must install the CS8920 adapter in a DOS-based PC and run the CS8900/20 Setup Utility to disable PnP and configure the adapter before installation in the target Linux system. Failure to do this will leave the adapter inactive and the driver will be unable to communicate with the adapter.h]hXCS8920-based adapters are shipped from Cirrus Logic configured as Plug and Play (PnP) enabled. However, since the cs89x0 driver does NOT support PnP, you must install the CS8920 adapter in a DOS-based PC and run the CS8900/20 Setup Utility to disable PnP and configure the adapter before installation in the target Linux system. Failure to do this will leave the adapter inactive and the driver will be unable to communicate with the adapter.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubjl)}(hX**************************************************************** * CS8920-BASED ADAPTERS: * * * * CS8920-BASED ADAPTERS ARE PLUG and PLAY ENABLED BY DEFAULT. * * THE CS89X0 DRIVER DOES NOT SUPPORT PnP. THEREFORE, YOU MUST * * RUN THE CS8900/20 SETUP UTILITY TO DISABLE PnP SUPPORT AND * * TO ACTIVATE THE ADAPTER. * ****************************************************************h]hX**************************************************************** * CS8920-BASED ADAPTERS: * * * * CS8920-BASED ADAPTERS ARE PLUG and PLAY ENABLED BY DEFAULT. * * THE CS89X0 DRIVER DOES NOT SUPPORT PnP. THEREFORE, YOU MUST * * RUN THE CS8900/20 SETUP UTILITY TO DISABLE PnP SUPPORT AND * * TO ACTIVATE THE ADAPTER. * ****************************************************************}hjsbah}(h]h ]h"]h$]h&]hhuh1jkhhhKhjhhubeh}(h]"cs8920-based-adapter-configurationah ]h"]'2.2. cs8920-based adapter configurationah$]h&]uh1hhjhhhhhKubeh}(h]&adapter-installation-and-configurationah ]h"])2. adapter installation and configurationah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h!3. Loading the Driver as a Moduleh]h!3. Loading the Driver as a Module}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hXXIf the driver is compiled as a loadable module, you can load the driver module with the 'modprobe' command. Many of the adapter's configuration parameters can be specified as command-line arguments to the load command. This facility provides a means to override the EEPROM's settings or for interface configuration when an EEPROM is not used.h]hX`If the driver is compiled as a loadable module, you can load the driver module with the ‘modprobe’ command. Many of the adapter’s configuration parameters can be specified as command-line arguments to the load command. This facility provides a means to override the EEPROM’s settings or for interface configuration when an EEPROM is not used.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h Example::h]hExample:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubjl)}(h*insmod cs89x0.o io=0x200 irq=0xA media=auih]h*insmod cs89x0.o io=0x200 irq=0xA media=aui}hjsbah}(h]h ]h"]h$]h&]hhuh1jkhhhKhjhhubh)}(hThis example loads the module and configures the adapter to use an IO port base address of 200h, interrupt 10, and use the AUI media connection. The following configuration options are available on the command line::h]hThis example loads the module and configures the adapter to use an IO port base address of 200h, interrupt 10, and use the AUI media connection. The following configuration options are available on the command line:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubjl)}(hXkio=### - specify IO address (200h-360h) irq=## - specify interrupt level use_dma=1 - Enable DMA dma=# - specify dma channel (Driver is compiled to support Rx DMA only) dmasize=# (16 or 64) - DMA size 16K or 64K. Default value is set to 16. media=rj45 - specify media type or media=bnc or media=aui or media=auto duplex=full - specify forced half/full/autonegotiate duplex or duplex=half or duplex=auto debug=# - debug level (only available if the driver was compiled for debugging)h]hXkio=### - specify IO address (200h-360h) irq=## - specify interrupt level use_dma=1 - Enable DMA dma=# - specify dma channel (Driver is compiled to support Rx DMA only) dmasize=# (16 or 64) - DMA size 16K or 64K. Default value is set to 16. media=rj45 - specify media type or media=bnc or media=aui or media=auto duplex=full - specify forced half/full/autonegotiate duplex or duplex=half or duplex=auto debug=# - debug level (only available if the driver was compiled for debugging)}hjsbah}(h]h ]h"]h$]h&]hhuh1jkhhhKhjhhubh)}(h **Notes:**h]hstrong)}(hj'h]hNotes:}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1j)hj%ubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubhenumerated_list)}(hhh](j)}(hIf an EEPROM is present, any specified command-line parameter will override the corresponding configuration value stored in EEPROM. h]h)}(hIf an EEPROM is present, any specified command-line parameter will override the corresponding configuration value stored in EEPROM.h]hIf an EEPROM is present, any specified command-line parameter will override the corresponding configuration value stored in EEPROM.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjCubah}(h]h ]h"]h$]h&]uh1jhj@hhhhhNubj)}(h:The "io" parameter must be specified on the command-line. h]h)}(h9The "io" parameter must be specified on the command-line.h]h=The “io” parameter must be specified on the command-line.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj[ubah}(h]h ]h"]h$]h&]uh1jhj@hhhhhNubj)}(hXcThe driver's hardware probe routine is designed to avoid writing to I/O space until it knows that there is a cs89x0 card at the written addresses. This could cause problems with device probing. To avoid this behaviour, add one to the ``io=`` module parameter. This doesn't actually change the I/O address, but it is a flag to tell the driver to partially initialise the hardware before trying to identify the card. This could be dangerous if you are not sure that there is a cs89x0 card at the provided address. For example, to scan for an adapter located at IO base 0x300, specify an IO address of 0x301. h](h)}(hXThe driver's hardware probe routine is designed to avoid writing to I/O space until it knows that there is a cs89x0 card at the written addresses. This could cause problems with device probing. To avoid this behaviour, add one to the ``io=`` module parameter. This doesn't actually change the I/O address, but it is a flag to tell the driver to partially initialise the hardware before trying to identify the card. This could be dangerous if you are not sure that there is a cs89x0 card at the provided address.h](hThe driver’s hardware probe routine is designed to avoid writing to I/O space until it knows that there is a cs89x0 card at the written addresses. This could cause problems with device probing. To avoid this behaviour, add one to the }(hjwhhhNhNubhliteral)}(h``io=``h]hio=}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubhX module parameter. This doesn’t actually change the I/O address, but it is a flag to tell the driver to partially initialise the hardware before trying to identify the card. This could be dangerous if you are not sure that there is a cs89x0 card at the provided address.}(hjwhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjsubh)}(h]For example, to scan for an adapter located at IO base 0x300, specify an IO address of 0x301.h]h]For example, to scan for an adapter located at IO base 0x300, specify an IO address of 0x301.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjsubeh}(h]h ]h"]h$]h&]uh1jhj@hhhhhNubj)}(h>The "duplex=auto" parameter is only supported for the CS8920. h]h)}(h=The "duplex=auto" parameter is only supported for the CS8920.h]hAThe “duplex=auto” parameter is only supported for the CS8920.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjubah}(h]h ]h"]h$]h&]uh1jhj@hhhhhNubj)}(hsThe minimum command-line configuration required if an EEPROM is not present is: io irq media type (no autodetect) h](h)}(hOThe minimum command-line configuration required if an EEPROM is not present is:h]hOThe minimum command-line configuration required if an EEPROM is not present is:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubh)}(h!io irq media type (no autodetect)h]h!io irq media type (no autodetect)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubeh}(h]h ]h"]h$]h&]uh1jhj@hhhhhNubj)}(hXtThe following additional parameters are CS89XX defaults (values used with no EEPROM or command-line argument). * DMA Burst = enabled * IOCHRDY Enabled = enabled * UseSA = enabled * CS8900 defaults to half-duplex if not specified on command-line * CS8920 defaults to autoneg if not specified on command-line * Use reset defaults for other config parameters * dma_mode = 0 h](h)}(hnThe following additional parameters are CS89XX defaults (values used with no EEPROM or command-line argument).h]hnThe following additional parameters are CS89XX defaults (values used with no EEPROM or command-line argument).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubj)}(hhh](j)}(hDMA Burst = enabledh]h)}(hjh]hDMA Burst = enabled}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hIOCHRDY Enabled = enabledh]h)}(hjh]hIOCHRDY Enabled = enabled}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hUseSA = enabledh]h)}(hj0h]hUseSA = enabled}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj.ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h?CS8900 defaults to half-duplex if not specified on command-lineh]h)}(hjGh]h?CS8900 defaults to half-duplex if not specified on command-line}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjEubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h;CS8920 defaults to autoneg if not specified on command-lineh]h)}(hj^h]h;CS8920 defaults to autoneg if not specified on command-line}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj\ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h.Use reset defaults for other config parametersh]h)}(hjuh]h.Use reset defaults for other config parameters}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjsubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h dma_mode = 0 h]h)}(h dma_mode = 0h]h dma_mode = 0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]j,j-uh1jhhhMhjubeh}(h]h ]h"]h$]h&]uh1jhj@hhhNhNubj)}(h cat /etc/conf.modules ... alias eth0 cs89x0 options cs89x0 io=0x0200 dma=5 use_dma=1 ... In this example we are telling the module system that the ethernet driver for this machine should use the cs89x0 driver. We are asking 'modprobe' to pass the 'io', 'dma' and 'use_dma' arguments to the driver when it is loaded. h](h)}(hX2Many Linux distributions use the 'modprobe' command to load modules. This program uses the '/etc/conf.modules' file to determine configuration information which is passed to a driver module when it is loaded. All the configuration options which are described above may be placed within /etc/conf.modules.h]hX:Many Linux distributions use the ‘modprobe’ command to load modules. This program uses the ‘/etc/conf.modules’ file to determine configuration information which is passed to a driver module when it is loaded. All the configuration options which are described above may be placed within /etc/conf.modules.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM#hjubh)}(h For example::h]h For example:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM)hjubjl)}(hZ> cat /etc/conf.modules ... alias eth0 cs89x0 options cs89x0 io=0x0200 dma=5 use_dma=1 ...h]hZ> cat /etc/conf.modules ... alias eth0 cs89x0 options cs89x0 io=0x0200 dma=5 use_dma=1 ...}hjsbah}(h]h ]h"]h$]h&]hhuh1jkhhhM+hjubh)}(hIn this example we are telling the module system that the ethernet driver for this machine should use the cs89x0 driver. We are asking 'modprobe' to pass the 'io', 'dma' and 'use_dma' arguments to the driver when it is loaded.h]hIn this example we are telling the module system that the ethernet driver for this machine should use the cs89x0 driver. We are asking ‘modprobe’ to pass the ‘io’, ‘dma’ and ‘use_dma’ arguments to the driver when it is loaded.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM1hjubeh}(h]h ]h"]h$]h&]uh1jhj@hhhhhNubj)}(hCirrus recommend that the cs89x0 use the ISA DMA channels 5, 6 or 7. You will probably find that other DMA channels will not work. h]h)}(hCirrus recommend that the cs89x0 use the ISA DMA channels 5, 6 or 7. You will probably find that other DMA channels will not work.h]hCirrus recommend that the cs89x0 use the ISA DMA channels 5, 6 or 7. You will probably find that other DMA channels will not work.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM6hjubah}(h]h ]h"]h$]h&]uh1jhj@hhhhhNubj)}(hThe cs89x0 supports DMA for receiving only. DMA mode is significantly more efficient. Flooding a 400 MHz Celeron machine with large ping packets consumes 82% of its CPU capacity in non-DMA mode. With DMA this is reduced to 45%. h]h)}(hThe cs89x0 supports DMA for receiving only. DMA mode is significantly more efficient. Flooding a 400 MHz Celeron machine with large ping packets consumes 82% of its CPU capacity in non-DMA mode. With DMA this is reduced to 45%.h]hThe cs89x0 supports DMA for receiving only. DMA mode is significantly more efficient. Flooding a 400 MHz Celeron machine with large ping packets consumes 82% of its CPU capacity in non-DMA mode. With DMA this is reduced to 45%.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM9hj ubah}(h]h ]h"]h$]h&]uh1jhj@hhhhhNubj)}(hIf your Linux kernel was compiled with inbuilt plug-and-play support you will be able to find information about the cs89x0 card with the command:: cat /proc/isapnp h](h)}(hIf your Linux kernel was compiled with inbuilt plug-and-play support you will be able to find information about the cs89x0 card with the command::h]hIf your Linux kernel was compiled with inbuilt plug-and-play support you will be able to find information about the cs89x0 card with the command:}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM>hj8ubjl)}(hcat /proc/isapnph]hcat /proc/isapnp}hjJsbah}(h]h ]h"]h$]h&]hhuh1jkhhhMBhj8ubeh}(h]h ]h"]h$]h&]uh1jhj@hhhhhNubj)}(hIf during DMA operation you find erratic behavior or network data corruption you should use your PC's BIOS to slow the EISA bus clock. h]h)}(hIf during DMA operation you find erratic behavior or network data corruption you should use your PC's BIOS to slow the EISA bus clock.h]hIf during DMA operation you find erratic behavior or network data corruption you should use your PC’s BIOS to slow the EISA bus clock.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMDhj^ubah}(h]h ]h"]h$]h&]uh1jhj@hhhhhNubj)}(hIf the cs89x0 driver is compiled directly into the kernel (non-modular) then its I/O address is automatically determined by ISA bus probing. The IRQ number, media options, etc are determined from the card's EEPROM. h]h)}(hIf the cs89x0 driver is compiled directly into the kernel (non-modular) then its I/O address is automatically determined by ISA bus probing. The IRQ number, media options, etc are determined from the card's EEPROM.h]hIf the cs89x0 driver is compiled directly into the kernel (non-modular) then its I/O address is automatically determined by ISA bus probing. The IRQ number, media options, etc are determined from the card’s EEPROM.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMGhjvubah}(h]h ]h"]h$]h&]uh1jhj@hhhhhNubj)}(hX,If the cs89x0 driver is compiled directly into the kernel, DMA mode may be selected by providing the kernel with a boot option 'cs89x0_dma=N' where 'N' is the desired DMA channel number (5, 6 or 7). Kernel boot options may be provided on the LILO command line:: LILO boot: linux cs89x0_dma=5 or they may be placed in /etc/lilo.conf:: image=/boot/bzImage-2.3.48 append="cs89x0_dma=5" label=linux root=/dev/hda5 read-only The DMA Rx buffer size is hardwired to 16 kbytes in this mode. (64k mode is not available). h](h)}(hIf the cs89x0 driver is compiled directly into the kernel, DMA mode may be selected by providing the kernel with a boot option 'cs89x0_dma=N' where 'N' is the desired DMA channel number (5, 6 or 7).h]hIf the cs89x0 driver is compiled directly into the kernel, DMA mode may be selected by providing the kernel with a boot option ‘cs89x0_dma=N’ where ‘N’ is the desired DMA channel number (5, 6 or 7).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMLhjubh)}(h>Kernel boot options may be provided on the LILO command line::h]h=Kernel boot options may be provided on the LILO command line:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMPhjubjl)}(hLILO boot: linux cs89x0_dma=5h]hLILO boot: linux cs89x0_dma=5}hjsbah}(h]h ]h"]h$]h&]hhuh1jkhhhMRhjubh)}(h)or they may be placed in /etc/lilo.conf::h]h(or they may be placed in /etc/lilo.conf:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMThjubjl)}(h]image=/boot/bzImage-2.3.48 append="cs89x0_dma=5" label=linux root=/dev/hda5 read-onlyh]h]image=/boot/bzImage-2.3.48 append="cs89x0_dma=5" label=linux root=/dev/hda5 read-only}hjsbah}(h]h ]h"]h$]h&]hhuh1jkhhhMVhjubh)}(h[The DMA Rx buffer size is hardwired to 16 kbytes in this mode. (64k mode is not available).h]h[The DMA Rx buffer size is hardwired to 16 kbytes in this mode. (64k mode is not available).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM\hjubeh}(h]h ]h"]h$]h&]uh1jhj@hhhhhNubeh}(h]h ]h"]h$]h&]enumtype loweralphaprefixhsuffix)uh1j>hjhhhhhKubeh}(h]loading-the-driver-as-a-moduleah ]h"]!3. loading the driver as a moduleah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h4. Compiling the Driverh]h4. Compiling the Driver}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMaubh)}(hlThe cs89x0 driver can be compiled directly into the kernel or compiled into a loadable device driver module.h]hlThe cs89x0 driver can be compiled directly into the kernel or compiled into a loadable device driver module.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMchjhhubh)}(hIJust use the standard way to configure the driver and compile the Kernel.h]hIJust use the standard way to configure the driver and compile the Kernel.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMfhjhhubh)}(hhh](h)}(h+4.1. Compiling the Driver to Support Rx DMAh]h+4.1. Compiling the Driver to Support Rx DMA}(hj/ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj, hhhhhMjubh)}(hThe compile-time optionality for DMA was removed in the 2.3 kernel series. DMA support is now unconditionally part of the driver. It is enabled by the 'use_dma=1' module option.h]hThe compile-time optionality for DMA was removed in the 2.3 kernel series. DMA support is now unconditionally part of the driver. It is enabled by the ‘use_dma=1’ module option.}(hj= hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMlhj, hhubeh}(h]&compiling-the-driver-to-support-rx-dmaah ]h"]+4.1. compiling the driver to support rx dmaah$]h&]uh1hhjhhhhhMjubeh}(h]compiling-the-driverah ]h"]4. compiling the driverah$]h&]uh1hhhhhhhhMaubh)}(hhh](h)}(h5. Testing and Troubleshootingh]h5. Testing and Troubleshooting}(hj^ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[ hhhhhMrubh)}(hhh](h)}(h"5.1. Known Defects and Limitationsh]h"5.1. Known Defects and Limitations}(hjo hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjl hhhhhMuubh)}(hRefer to the RELEASE.TXT file distributed as part of this archive for a list of known defects, driver limitations, and work arounds.h]hRefer to the RELEASE.TXT file distributed as part of this archive for a list of known defects, driver limitations, and work arounds.}(hj} hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMwhjl hhubeh}(h]known-defects-and-limitationsah ]h"]"5.1. known defects and limitationsah$]h&]uh1hhj[ hhhhhMuubh)}(hhh](h)}(h5.2. Testing the Adapterh]h5.2. Testing the Adapter}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhM|ubh)}(hX"Once the adapter has been installed and configured, the diagnostic option of the CS8900/20 Setup Utility can be used to test the functionality of the adapter and its network connection. Use the diagnostics 'Self Test' option to test the functionality of the adapter with the hardware configuration you have assigned. You can use the diagnostics 'Network Test' to test the ability of the adapter to communicate across the Ethernet with another PC equipped with a CS8900/20-based adapter card (it must also be running the CS8900/20 Setup Utility).h]hX*Once the adapter has been installed and configured, the diagnostic option of the CS8900/20 Setup Utility can be used to test the functionality of the adapter and its network connection. Use the diagnostics ‘Self Test’ option to test the functionality of the adapter with the hardware configuration you have assigned. You can use the diagnostics ‘Network Test’ to test the ability of the adapter to communicate across the Ethernet with another PC equipped with a CS8900/20-based adapter card (it must also be running the CS8900/20 Setup Utility).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM~hj hhubh)}(hThe Setup Utility's diagnostics are designed to run in a DOS-only operating system environment. DO NOT run the diagnostics from a DOS or command prompt session under Windows 95, Windows NT, OS/2, or other operating system.h]h)}(hThe Setup Utility's diagnostics are designed to run in a DOS-only operating system environment. DO NOT run the diagnostics from a DOS or command prompt session under Windows 95, Windows NT, OS/2, or other operating system.h]hThe Setup Utility’s diagnostics are designed to run in a DOS-only operating system environment. DO NOT run the diagnostics from a DOS or command prompt session under Windows 95, Windows NT, OS/2, or other operating system.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1hhj hhhhhNubh)}(h6To run the diagnostics tests on the CS8900/20 adapter:h]h6To run the diagnostics tests on the CS8900/20 adapter:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubj)}(hXh1. Boot DOS on the PC and start the CS8900/20 Setup Utility. 2. The adapter's current configuration is displayed. Hit the ENTER key to get to the main menu. 4. Select 'Diagnostics' (ALT-G) from the main menu. * Select 'Self-Test' to test the adapter's basic functionality. * Select 'Network Test' to test the network connection and cabling. h](j?)}(hhh](j)}(h:Boot DOS on the PC and start the CS8900/20 Setup Utility. h]h)}(h9Boot DOS on the PC and start the CS8900/20 Setup Utility.h]h9Boot DOS on the PC and start the CS8900/20 Setup Utility.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(h^The adapter's current configuration is displayed. Hit the ENTER key to get to the main menu. h]h)}(h]The adapter's current configuration is displayed. Hit the ENTER key to get to the main menu.h]h_The adapter’s current configuration is displayed. Hit the ENTER key to get to the main menu.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]jarabicjhj.uh1j>hj ubj?)}(hhh]j)}(hSelect 'Diagnostics' (ALT-G) from the main menu. * Select 'Self-Test' to test the adapter's basic functionality. * Select 'Network Test' to test the network connection and cabling. h]h)}(hSelect 'Diagnostics' (ALT-G) from the main menu. * Select 'Self-Test' to test the adapter's basic functionality. * Select 'Network Test' to test the network connection and cabling.h]hSelect ‘Diagnostics’ (ALT-G) from the main menu. * Select ‘Self-Test’ to test the adapter’s basic functionality. * Select ‘Network Test’ to test the network connection and cabling.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]jj jhjj startKuh1j>hj ubeh}(h]h ]h"]h$]h&]uh1jhhhMhj hhubh)}(hhh](h)}(h5.2.1. Diagnostic Self-testh]h5.2.1. Diagnostic Self-test}(hjB hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj? hhhhhMubh)}(hThe diagnostic self-test checks the adapter's basic functionality as well as its ability to communicate across the ISA bus based on the system resources assigned during hardware configuration. The following tests are performed:h]hThe diagnostic self-test checks the adapter’s basic functionality as well as its ability to communicate across the ISA bus based on the system resources assigned during hardware configuration. The following tests are performed:}(hjP hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj? hhubj)}(hX* IO Register Read/Write Test The IO Register Read/Write test insures that the CS8900/20 can be accessed in IO mode, and that the IO base address is correct. * Shared Memory Test The Shared Memory test insures the CS8900/20 can be accessed in memory mode and that the range of memory addresses assigned does not conflict with other devices in the system. * Interrupt Test The Interrupt test insures there are no conflicts with the assigned IRQ signal. * EEPROM Test The EEPROM test insures the EEPROM can be read. * Chip RAM Test The Chip RAM test insures the 4K of memory internal to the CS8900/20 is working properly. * Internal Loop-back Test The Internal Loop Back test insures the adapter's transmitter and receiver are operating properly. If this test fails, make sure the adapter's cable is connected to the network (check for LED activity for example). * Boot PROM Test The Boot PROM test insures the Boot PROM is present, and can be read. Failure indicates the Boot PROM was not successfully read due to a hardware problem or due to a conflicts on the Boot PROM address assignment. (Test only applies if the adapter is configured to use the Boot PROM option.) h]j)}(hhh](j)}(hIO Register Read/Write Test The IO Register Read/Write test insures that the CS8900/20 can be accessed in IO mode, and that the IO base address is correct. h](h)}(hIO Register Read/Write Testh]hIO Register Read/Write Test}(hji hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhje ubh)}(hThe IO Register Read/Write test insures that the CS8900/20 can be accessed in IO mode, and that the IO base address is correct.h]hThe IO Register Read/Write test insures that the CS8900/20 can be accessed in IO mode, and that the IO base address is correct.}(hjw hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhje ubeh}(h]h ]h"]h$]h&]uh1jhjb ubj)}(hShared Memory Test The Shared Memory test insures the CS8900/20 can be accessed in memory mode and that the range of memory addresses assigned does not conflict with other devices in the system. h](h)}(hShared Memory Testh]hShared Memory Test}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubh)}(hThe Shared Memory test insures the CS8900/20 can be accessed in memory mode and that the range of memory addresses assigned does not conflict with other devices in the system.h]hThe Shared Memory test insures the CS8900/20 can be accessed in memory mode and that the range of memory addresses assigned does not conflict with other devices in the system.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubeh}(h]h ]h"]h$]h&]uh1jhjb ubj)}(h`Interrupt Test The Interrupt test insures there are no conflicts with the assigned IRQ signal. h](h)}(hInterrupt Testh]hInterrupt Test}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubh)}(hOThe Interrupt test insures there are no conflicts with the assigned IRQ signal.h]hOThe Interrupt test insures there are no conflicts with the assigned IRQ signal.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubeh}(h]h ]h"]h$]h&]uh1jhjb ubj)}(h=EEPROM Test The EEPROM test insures the EEPROM can be read. h](h)}(h EEPROM Testh]h EEPROM Test}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubh)}(h/The EEPROM test insures the EEPROM can be read.h]h/The EEPROM test insures the EEPROM can be read.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubeh}(h]h ]h"]h$]h&]uh1jhjb ubj)}(hiChip RAM Test The Chip RAM test insures the 4K of memory internal to the CS8900/20 is working properly. h](h)}(h Chip RAM Testh]h Chip RAM Test}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubh)}(hYThe Chip RAM test insures the 4K of memory internal to the CS8900/20 is working properly.h]hYThe Chip RAM test insures the 4K of memory internal to the CS8900/20 is working properly.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubeh}(h]h ]h"]h$]h&]uh1jhjb ubj)}(hInternal Loop-back Test The Internal Loop Back test insures the adapter's transmitter and receiver are operating properly. If this test fails, make sure the adapter's cable is connected to the network (check for LED activity for example). h](h)}(hInternal Loop-back Testh]hInternal Loop-back Test}(hj' hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj# ubh)}(hThe Internal Loop Back test insures the adapter's transmitter and receiver are operating properly. If this test fails, make sure the adapter's cable is connected to the network (check for LED activity for example).h]hThe Internal Loop Back test insures the adapter’s transmitter and receiver are operating properly. If this test fails, make sure the adapter’s cable is connected to the network (check for LED activity for example).}(hj5 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj# ubeh}(h]h ]h"]h$]h&]uh1jhjb ubj)}(hX5Boot PROM Test The Boot PROM test insures the Boot PROM is present, and can be read. Failure indicates the Boot PROM was not successfully read due to a hardware problem or due to a conflicts on the Boot PROM address assignment. (Test only applies if the adapter is configured to use the Boot PROM option.) h](h)}(hBoot PROM Testh]hBoot PROM Test}(hjM hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjI ubh)}(hX$The Boot PROM test insures the Boot PROM is present, and can be read. Failure indicates the Boot PROM was not successfully read due to a hardware problem or due to a conflicts on the Boot PROM address assignment. (Test only applies if the adapter is configured to use the Boot PROM option.)h]hX$The Boot PROM test insures the Boot PROM is present, and can be read. Failure indicates the Boot PROM was not successfully read due to a hardware problem or due to a conflicts on the Boot PROM address assignment. (Test only applies if the adapter is configured to use the Boot PROM option.)}(hj[ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjI ubeh}(h]h ]h"]h$]h&]uh1jhjb ubeh}(h]h ]h"]h$]h&]j,j-uh1jhhhMhj^ ubah}(h]h ]h"]h$]h&]uh1jhhhMhj? hhubh)}(hFailure of a test item indicates a possible system resource conflict with another device on the ISA bus. In this case, you should use the Manual Setup option to reconfigure the adapter by selecting a different value for the system resource that failed.h]hFailure of a test item indicates a possible system resource conflict with another device on the ISA bus. In this case, you should use the Manual Setup option to reconfigure the adapter by selecting a different value for the system resource that failed.}(hj{ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj? hhubeh}(h]diagnostic-self-testah ]h"]5.2.1. diagnostic self-testah$]h&]uh1hhj hhhhhMubh)}(hhh](h)}(h5.2.2. Diagnostic Network Testh]h5.2.2. Diagnostic Network Test}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubh)}(hThe Diagnostic Network Test verifies a working network connection by transferring data between two CS8900/20 adapters installed in different PCs on the same network. (Note: the diagnostic network test should not be run between two nodes across a router.)h]hThe Diagnostic Network Test verifies a working network connection by transferring data between two CS8900/20 adapters installed in different PCs on the same network. (Note: the diagnostic network test should not be run between two nodes across a router.)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(hXMThis test requires that each of the two PCs have a CS8900/20-based adapter installed and have the CS8900/20 Setup Utility running. The first PC is configured as a Responder and the other PC is configured as an Initiator. Once the Initiator is started, it sends data frames to the Responder which returns the frames to the Initiator.h]hXMThis test requires that each of the two PCs have a CS8900/20-based adapter installed and have the CS8900/20 Setup Utility running. The first PC is configured as a Responder and the other PC is configured as an Initiator. Once the Initiator is started, it sends data frames to the Responder which returns the frames to the Initiator.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(hThe total number of frames received and transmitted are displayed on the Initiator's display, along with a count of the number of frames received and transmitted OK or in error. The test can be terminated anytime by the user at either PC.h]hThe total number of frames received and transmitted are displayed on the Initiator’s display, along with a count of the number of frames received and transmitted OK or in error. The test can be terminated anytime by the user at either PC.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(h%To setup the Diagnostic Network Test:h]h%To setup the Diagnostic Network Test:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubj)}(hX1. Select a PC with a CS8900/20-based adapter and a known working network connection to act as the Responder. Run the CS8900/20 Setup Utility and select 'Diagnostics -> Network Test -> Responder' from the main menu. Hit ENTER to start the Responder. 2. Return to the PC with the CS8900/20-based adapter you want to test and start the CS8900/20 Setup Utility. 3. From the main menu, Select 'Diagnostic -> Network Test -> Initiator'. Hit ENTER to start the test. h]j?)}(hhh](j)}(hSelect a PC with a CS8900/20-based adapter and a known working network connection to act as the Responder. Run the CS8900/20 Setup Utility and select 'Diagnostics -> Network Test -> Responder' from the main menu. Hit ENTER to start the Responder. h]h)}(hSelect a PC with a CS8900/20-based adapter and a known working network connection to act as the Responder. Run the CS8900/20 Setup Utility and select 'Diagnostics -> Network Test -> Responder' from the main menu. Hit ENTER to start the Responder.h]hSelect a PC with a CS8900/20-based adapter and a known working network connection to act as the Responder. Run the CS8900/20 Setup Utility and select ‘Diagnostics -> Network Test -> Responder’ from the main menu. Hit ENTER to start the Responder.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hjReturn to the PC with the CS8900/20-based adapter you want to test and start the CS8900/20 Setup Utility. h]h)}(hiReturn to the PC with the CS8900/20-based adapter you want to test and start the CS8900/20 Setup Utility.h]hiReturn to the PC with the CS8900/20-based adapter you want to test and start the CS8900/20 Setup Utility.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hcFrom the main menu, Select 'Diagnostic -> Network Test -> Initiator'. Hit ENTER to start the test. h]h)}(hbFrom the main menu, Select 'Diagnostic -> Network Test -> Initiator'. Hit ENTER to start the test.h]hfFrom the main menu, Select ‘Diagnostic -> Network Test -> Initiator’. Hit ENTER to start the test.Z}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]jj jhjj uh1j>hj ubah}(h]h ]h"]h$]h&]uh1jhhhMhj hhubh)}(hYou may stop the test on the Initiator at any time while allowing the Responder to continue running. In this manner, you can move to additional PCs and test them by starting the Initiator on another PC without having to stop/start the Responder.h]hYou may stop the test on the Initiator at any time while allowing the Responder to continue running. In this manner, you can move to additional PCs and test them by starting the Initiator on another PC without having to stop/start the Responder.}(hj5 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubeh}(h]diagnostic-network-testah ]h"]5.2.2. diagnostic network testah$]h&]uh1hhj hhhhhMubeh}(h]testing-the-adapterah ]h"]5.2. testing the adapterah$]h&]uh1hhj[ hhhhhM|ubh)}(hhh](h)}(h5.3. Using the Adapter's LEDsh]h5.3. Using the Adapter’s LEDs}(hjV hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjS hhhhhMubh)}(hrThe 2 and 3-media adapters have two LEDs visible on the back end of the board located near the 10Base-T connector.h]hrThe 2 and 3-media adapters have two LEDs visible on the back end of the board located near the 10Base-T connector.}(hjd hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjS hhubh)}(hLink Integrity LED: A "steady" ON of the green LED indicates a valid 10Base-T connection. (Only applies to 10Base-T. The green LED has no significance for a 10Base-2 or AUI connection.)h]hLink Integrity LED: A “steady” ON of the green LED indicates a valid 10Base-T connection. (Only applies to 10Base-T. The green LED has no significance for a 10Base-2 or AUI connection.)}(hjr hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjS hhubh)}(hTX/RX LED: The yellow LED lights briefly each time the adapter transmits or receives data. (The yellow LED will appear to "flicker" on a typical network.)h]hTX/RX LED: The yellow LED lights briefly each time the adapter transmits or receives data. (The yellow LED will appear to “flicker” on a typical network.)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjS hhubeh}(h]using-the-adapter-s-ledsah ]h"]5.3. using the adapter's ledsah$]h&]uh1hhj[ hhhhhMubh)}(hhh](h)}(h5.4. Resolving I/O Conflictsh]h5.4. Resolving I/O Conflicts}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubh)}(hAn IO conflict occurs when two or more adapter use the same ISA resource (IO address, memory address or IRQ). You can usually detect an IO conflict in one of four ways after installing and or configuring the CS8900/20-based adapter:h]hAn IO conflict occurs when two or more adapter use the same ISA resource (IO address, memory address or IRQ). You can usually detect an IO conflict in one of four ways after installing and or configuring the CS8900/20-based adapter:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubj)}(hX1. The system does not boot properly (or at all). 2. The driver cannot communicate with the adapter, reporting an "Adapter not found" error message. 3. You cannot connect to the network or the driver will not load. 4. If you have configured the adapter to run in memory mode but the driver reports it is using IO mode when loading, this is an indication of a memory address conflict. h]j?)}(hhh](j)}(h/The system does not boot properly (or at all). h]h)}(h.The system does not boot properly (or at all).h]h.The system does not boot properly (or at all).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(h`The driver cannot communicate with the adapter, reporting an "Adapter not found" error message. h]h)}(h_The driver cannot communicate with the adapter, reporting an "Adapter not found" error message.h]hcThe driver cannot communicate with the adapter, reporting an “Adapter not found” error message.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(h?You cannot connect to the network or the driver will not load. h]h)}(h>You cannot connect to the network or the driver will not load.h]h>You cannot connect to the network or the driver will not load.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hIf you have configured the adapter to run in memory mode but the driver reports it is using IO mode when loading, this is an indication of a memory address conflict. h]h)}(hIf you have configured the adapter to run in memory mode but the driver reports it is using IO mode when loading, this is an indication of a memory address conflict.h]hIf you have configured the adapter to run in memory mode but the driver reports it is using IO mode when loading, this is an indication of a memory address conflict.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]jj jhjj uh1j>hj ubah}(h]h ]h"]h$]h&]uh1jhhhM hj hhubh)}(hX3If an IO conflict occurs, run the CS8900/20 Setup Utility and perform a diagnostic self-test. Normally, the ISA resource in conflict will fail the self-test. If so, reconfigure the adapter selecting another choice for the resource in conflict. Run the diagnostics again to check for further IO conflicts.h]hX3If an IO conflict occurs, run the CS8900/20 Setup Utility and perform a diagnostic self-test. Normally, the ISA resource in conflict will fail the self-test. If so, reconfigure the adapter selecting another choice for the resource in conflict. Run the diagnostics again to check for further IO conflicts.}(hj( hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(hXMIn some cases, such as when the PC will not boot, it may be necessary to remove the adapter and reconfigure it by installing it in another PC to run the CS8900/20 Setup Utility. Once reinstalled in the target system, run the diagnostics self-test to ensure the new configuration is free of conflicts before loading the driver again.h]hXMIn some cases, such as when the PC will not boot, it may be necessary to remove the adapter and reconfigure it by installing it in another PC to run the CS8900/20 Setup Utility. Once reinstalled in the target system, run the diagnostics self-test to ensure the new configuration is free of conflicts before loading the driver again.}(hj6 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(h{When manually configuring the adapter, keep in mind the typical ISA system resource usage as indicated in the tables below.h]h{When manually configuring the adapter, keep in mind the typical ISA system resource usage as indicated in the tables below.}(hjD hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM"hj hhubjl)}(hXI/O Address Device IRQ Device ----------- -------- --- -------- 200-20F Game I/O adapter 3 COM2, Bus Mouse 230-23F Bus Mouse 4 COM1 270-27F LPT3: third parallel port 5 LPT2 2F0-2FF COM2: second serial port 6 Floppy Disk controller 320-32F Fixed disk controller 7 LPT1 8 Real-time Clock 9 EGA/VGA display adapter 12 Mouse (PS/2) Memory Address Device 13 Math Coprocessor -------------- --------------------- 14 Hard Disk controller A000-BFFF EGA Graphics Adapter A000-C7FF VGA Graphics Adapter B000-BFFF Mono Graphics Adapter B800-BFFF Color Graphics Adapter E000-FFFF AT BIOSh]hXI/O Address Device IRQ Device ----------- -------- --- -------- 200-20F Game I/O adapter 3 COM2, Bus Mouse 230-23F Bus Mouse 4 COM1 270-27F LPT3: third parallel port 5 LPT2 2F0-2FF COM2: second serial port 6 Floppy Disk controller 320-32F Fixed disk controller 7 LPT1 8 Real-time Clock 9 EGA/VGA display adapter 12 Mouse (PS/2) Memory Address Device 13 Math Coprocessor -------------- --------------------- 14 Hard Disk controller A000-BFFF EGA Graphics Adapter A000-C7FF VGA Graphics Adapter B000-BFFF Mono Graphics Adapter B800-BFFF Color Graphics Adapter E000-FFFF AT BIOS}hjR sbah}(h]h ]h"]h$]h&]hhuh1jkhhhM'hj hhubeh}(h]resolving-i-o-conflictsah ]h"]5.4. resolving i/o conflictsah$]h&]uh1hhj[ hhhhhMubeh}(h]testing-and-troubleshootingah ]h"]5. testing and troubleshootingah$]h&]uh1hhhhhhhhMrubh)}(hhh](h)}(h6. Technical Supporth]h6. Technical Support}(hjs hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjp hhhhhM=ubh)}(hhh](h)}(h06.1. Contacting Cirrus Logic's Technical Supporth]h26.1. Contacting Cirrus Logic’s Technical Support}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhM@ubh)}(hGCirrus Logic's CS89XX Technical Application Support can be reached at::h]hHCirrus Logic’s CS89XX Technical Application Support can be reached at:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMBhj hhubjl)}(hTelephone :(800) 888-5016 (from inside U.S. and Canada) :(512) 442-7555 (from outside the U.S. and Canada) Fax :(512) 912-3871 Email :ethernet@crystal.cirrus.com WWW :http://www.cirrus.comh]hTelephone :(800) 888-5016 (from inside U.S. and Canada) :(512) 442-7555 (from outside the U.S. and Canada) Fax :(512) 912-3871 Email :ethernet@crystal.cirrus.com WWW :http://www.cirrus.com}hj sbah}(h]h ]h"]h$]h&]hhuh1jkhhhMDhj hhubeh}(h]+contacting-cirrus-logic-s-technical-supportah ]h"]06.1. contacting cirrus logic's technical supportah$]h&]uh1hhjp hhhhhM@ubh)}(hhh](h)}(h=6.2. Information Required before Contacting Technical Supporth]h=6.2. Information Required before Contacting Technical Support}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMLubh)}(h~Before contacting Cirrus Logic for technical support, be prepared to provide as Much of the following information as possible.h]h~Before contacting Cirrus Logic for technical support, be prepared to provide as Much of the following information as possible.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMNhj hhubh)}(h21.) Adapter type (CRD8900, CDB8900, CDB8920, etc.)h]h21.) Adapter type (CRD8900, CDB8900, CDB8920, etc.)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMQhj hhubh)}(h2.) Adapter configurationh]h2.) Adapter configuration}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMShj hhubj)}(h* IO Base, Memory Base, IO or memory mode enabled, IRQ, DMA channel * Plug and Play enabled/disabled (CS8920-based adapters only) * Configured for media auto-detect or specific media type (which type). h]j)}(hhh](j)}(hAIO Base, Memory Base, IO or memory mode enabled, IRQ, DMA channelh]h)}(hj h]hAIO Base, Memory Base, IO or memory mode enabled, IRQ, DMA channel}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMUhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(h;Plug and Play enabled/disabled (CS8920-based adapters only)h]h)}(hjh]h;Plug and Play enabled/disabled (CS8920-based adapters only)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMVhjubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hFConfigured for media auto-detect or specific media type (which type). h]h)}(hEConfigured for media auto-detect or specific media type (which type).h]hEConfigured for media auto-detect or specific media type (which type).}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMWhj&ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]j,j-uh1jhhhMUhj ubah}(h]h ]h"]h$]h&]uh1jhhhMUhj hhubh)}(h3.) PC System's Configurationh]h3.) PC System’s Configuration}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMYhj hhubj)}(h* Plug and Play system (yes/no) * BIOS (make and version) * System make and model * CPU (type and speed) * System RAM * SCSI Adapter h]j)}(hhh](j)}(hPlug and Play system (yes/no)h]h)}(hjah]hPlug and Play system (yes/no)}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM[hj_ubah}(h]h ]h"]h$]h&]uh1jhj\ubj)}(hBIOS (make and version)h]h)}(hjxh]hBIOS (make and version)}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM\hjvubah}(h]h ]h"]h$]h&]uh1jhj\ubj)}(hSystem make and modelh]h)}(hjh]hSystem make and model}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM]hjubah}(h]h ]h"]h$]h&]uh1jhj\ubj)}(hCPU (type and speed)h]h)}(hjh]hCPU (type and speed)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM^hjubah}(h]h ]h"]h$]h&]uh1jhj\ubj)}(h System RAMh]h)}(hjh]h System RAM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM_hjubah}(h]h ]h"]h$]h&]uh1jhj\ubj)}(h SCSI Adapter h]h)}(h SCSI Adapterh]h SCSI Adapter}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM`hjubah}(h]h ]h"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]j,j-uh1jhhhM[hjXubah}(h]h ]h"]h$]h&]uh1jhhhM[hj hhubh)}(h 4.) Softwareh]h 4.) Software}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMbhj hhubj)}(h* CS89XX driver and version * Your network operating system and version * Your system's OS version * Version of all protocol support files h]j)}(hhh](j)}(hCS89XX driver and versionh]h)}(hj h]hCS89XX driver and version}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMdhj ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h)Your network operating system and versionh]h)}(hj$h]h)Your network operating system and version}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMehj"ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hYour system's OS versionh]h)}(hj;h]hYour system’s OS version}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMfhj9ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h&Version of all protocol support files h]h)}(h%Version of all protocol support filesh]h%Version of all protocol support files}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMghjPubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]j,j-uh1jhhhMdhjubah}(h]h ]h"]h$]h&]uh1jhhhMdhj hhubh)}(h 5.) Any Error Message displayed.h]h 5.) Any Error Message displayed.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMihj hhubeh}(h]8information-required-before-contacting-technical-supportah ]h"]=6.2. information required before contacting technical supportah$]h&]uh1hhjp hhhhhMLubh)}(hhh](h)}(h'6.3 Obtaining the Latest Driver Versionh]h'6.3 Obtaining the Latest Driver Version}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMnubh)}(hXYou can obtain the latest CS89XX drivers and support software from Cirrus Logic's Web site. You can also contact Cirrus Logic's Technical Support (email: ethernet@crystal.cirrus.com) and request that you be registered for automatic software-update notification.h](hYou can obtain the latest CS89XX drivers and support software from Cirrus Logic’s Web site. You can also contact Cirrus Logic’s Technical Support (email: }(hjhhhNhNubh reference)}(hethernet@crystal.cirrus.comh]hethernet@crystal.cirrus.com}(hjhhhNhNubah}(h]h ]h"]h$]h&]refuri"mailto:ethernet@crystal.cirrus.comuh1jhjubhP) and request that you be registered for automatic software-update notification.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMphjhhubh)}(hnCirrus Logic maintains a web page at http://www.cirrus.com with the latest drivers and technical publications.h](h%Cirrus Logic maintains a web page at }(hjhhhNhNubj)}(hhttp://www.cirrus.comh]hhttp://www.cirrus.com}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1jhjubh4 with the latest drivers and technical publications.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMuhjhhubeh}(h]#obtaining-the-latest-driver-versionah ]h"]'6.3 obtaining the latest driver versionah$]h&]uh1hhjp hhhhhMnubh)}(hhh](h)}(h6.4. Current maintainerh]h6.4. Current maintainer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMzubh)}(hMIn February 2000 the maintenance of this driver was assumed by Andrew Morton.h]hMIn February 2000 the maintenance of this driver was assumed by Andrew Morton.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM|hjhhubeh}(h]current-maintainerah ]h"]6.4. current maintainerah$]h&]uh1hhjp hhhhhMzubh)}(hhh](h)}(h6.5 Kernel module parametersh]h6.5 Kernel module parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hFor use in embedded environments with no cs89x0 EEPROM, the kernel boot parameter ``cs89x0_media=`` has been implemented. Usage is::h](hRFor use in embedded environments with no cs89x0 EEPROM, the kernel boot parameter }(hj hhhNhNubj)}(h``cs89x0_media=``h]h cs89x0_media=}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh! has been implemented. Usage is:}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjhhubjl)}(h@cs89x0_media=rj45 or cs89x0_media=aui or cs89x0_media=bnch]h@cs89x0_media=rj45 or cs89x0_media=aui or cs89x0_media=bnc}hj@sbah}(h]h ]h"]h$]h&]hhuh1jkhhhMhjhhubeh}(h]kernel-module-parametersah ]h"]6.5 kernel module parametersah$]h&]uh1hhjp hhhhhMubeh}(h]technical-supportah ]h"]6. technical supportah$]h&]uh1hhhhhhhhM=ubeh}(h]0cirrus-logic-lan-cs8900-cs8920-ethernet-adaptersah ]h"]0cirrus logic lan cs8900/cs8920 ethernet adaptersah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksjfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(jcj`j3j0jhjejj jjjjjjjjjjjjjX jU jP jM jm jj j j jP jM j j jH jE j j je jb j[jXj j jjjjj j jSjPu nametypes}(jcj3jhjjjjjjjjX jP jm j jP j jH j je j[j jjj jSuh}(j`hj0jjej6j jkjjjjjjjjLjjjjjU jjM j, jj j[ j jl jM j j j? jE j j jS jb j jXjp j j jj jjj jjPju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}jKsRparse_messages]hsystem_message)}(hhh]h)}(h:Enumerated list start value not ordinal-1: "4" (ordinal 4)h]h>Enumerated list start value not ordinal-1: “4” (ordinal 4)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehlineKuh1jhj ubatransform_messages] transformerN include_log] decorationNhhub.