Lines Matching refs:the
9 described below. In general, you should use the driver version which
25 1.2.2 File in the Driver Package
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
42 5.2 Testing the Adapter
45 5.3 Using the Adapter's LEDs
51 6.3 Obtaining the Latest Driver Version
69 CS8920-based adapters are similar to the CS8900-based adapter with additional
71 such, the configuration procedures differ somewhat between the two types of
72 adapters. Refer to the "Adapter Configuration" section for details on
78 The CS8900/CS8920 Ethernet Adapter driver for Linux supports the Linux
79 v2.3.48 or greater kernel. It can be compiled directly into the kernel
84 1.2.2 Files in the Driver Archive:
86 The files in the driver at Cirrus' website include:
93 config/Config.in - sample file to include cs89x0 driver in the kernel.
94 config/Makefile - sample file to include cs89x0 driver in the kernel.
95 config/Space.c - sample file to include cs89x0 driver in the kernel.
108 * One available IRQ (5,10,11,or 12 for the CS8900, 3-7,9-15 for CS8920).
129 the terms of the GNU General Public License as published by the Free Software
132 This program is distributed in the hope that it will be useful, but WITHOUT
133 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
134 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
137 For a full copy of the GNU General Public License, write to the Free Software
145 Both the CS8900 and CS8920-based adapters can be configured using parameters
146 stored in an on-board EEPROM. You must use the DOS-based CS8900/20 Setup
147 Utility if you want to change the adapter's configuration in EEPROM.
149 When loading the driver as a module, you can specify many of the adapter's
150 configuration parameters on the command-line to override the EEPROM's settings
154 Since the CS8900/20 Setup Utility is a DOS-based application, you must install
155 and configure the adapter in a DOS-based system using the CS8900/20 Setup
156 Utility before installation in the target LINUX system. (Not required if
157 installing a CS8900-based adapter and the default configuration is acceptable.)
163 with the following "default" settings:
175 You should only change the default configuration settings if conflicts with
176 another adapter exists. To change the adapter's configuration, run the
183 and Play (PnP) enabled. However, since the cs89x0 driver does NOT
184 support PnP, you must install the CS8920 adapter in a DOS-based PC and
185 run the CS8900/20 Setup Utility to disable PnP and configure the
186 adapter before installation in the target Linux system. Failure to do
187 this will leave the adapter inactive and the driver will be unable to
188 communicate with the adapter.
206 If the driver is compiled as a loadable module, you can load the driver module
207 with the 'modprobe' command. Many of the adapter's configuration parameters can
208 be specified as command-line arguments to the load command. This facility
209 provides a means to override the EEPROM's settings or for interface
216 This example loads the module and configures the adapter to use an IO port base
217 address of 200h, interrupt 10, and use the AUI media connection. The following
218 configuration options are available on the command line:
233 * debug=# - debug level (only available if the driver was compiled
239 will override the corresponding configuration value stored in
242 b) The "io" parameter must be specified on the command-line.
246 card at the written addresses. This could cause problems
248 to the `io=' module parameter. This doesn't actually change
249 the I/O address, but it is a flag to tell the driver
250 to partially initialise the hardware before trying to
251 identify the card. This could be dangerous if you are
252 not sure that there is a cs89x0 card at the provided address.
257 d) The "duplex=auto" parameter is only supported for the CS8920.
277 g) You can use ifconfig to set the adapter's Ethernet address.
279 h) Many Linux distributions use the 'modprobe' command to load
280 modules. This program uses the '/etc/conf.modules' file to
282 module when it is loaded. All the configuration options which are
293 In this example we are telling the module system that the
294 ethernet driver for this machine should use the cs89x0 driver. We
295 are asking 'modprobe' to pass the 'io', 'dma' and 'use_dma'
296 arguments to the driver when it is loaded.
298 i) Cirrus recommend that the cs89x0 use the ISA DMA channels 5, 6 or
307 support you will be able to find information about the cs89x0 card
308 with the command
313 corruption you should use your PC's BIOS to slow the EISA bus clock.
315 m) If the cs89x0 driver is compiled directly into the kernel
318 from the card's EEPROM.
320 n) If the cs89x0 driver is compiled directly into the kernel, DMA
321 mode may be selected by providing the kernel with a boot option
322 'cs89x0_dma=N' where 'N' is the desired DMA channel number (5, 6 or 7).
324 Kernel boot options may be provided on the LILO command line:
343 The cs89x0 driver can be compiled directly into the kernel or compiled into
349 To compile the driver into a loadable module, use the following command
358 Support for memory mode was not carried over into the 2.3 series kernels.
362 The compile-time optionality for DMA was removed in the 2.3 kernel
363 series. DMA support is now unconditionally part of the driver. It is
364 enabled by the 'use_dma=1' module option.
372 Refer to the RELEASE.TXT file distributed as part of this archive for a list of
378 Once the adapter has been installed and configured, the diagnostic option of
379 the CS8900/20 Setup Utility can be used to test the functionality of the
380 adapter and its network connection. Use the diagnostics 'Self Test' option to
381 test the functionality of the adapter with the hardware configuration you have
382 assigned. You can use the diagnostics 'Network Test' to test the ability of the
383 adapter to communicate across the Ethernet with another PC equipped with a
384 CS8900/20-based adapter card (it must also be running the CS8900/20 Setup
388 DOS-only operating system environment. DO NOT run the diagnostics
392 To run the diagnostics tests on the CS8900/20 adapter:
394 1.) Boot DOS on the PC and start the CS8900/20 Setup Utility.
396 2.) The adapter's current configuration is displayed. Hit the ENTER key to
397 get to the main menu.
399 4.) Select 'Diagnostics' (ALT-G) from the main menu.
400 * Select 'Self-Test' to test the adapter's basic functionality.
401 * Select 'Network Test' to test the network connection and cabling.
406 The diagnostic self-test checks the adapter's basic functionality as well as
407 its ability to communicate across the ISA bus based on the system resources
411 The IO Register Read/Write test insures that the CS8900/20 can be
412 accessed in IO mode, and that the IO base address is correct.
415 The Shared Memory test insures the CS8900/20 can be accessed in memory
416 mode and that the range of memory addresses assigned does not conflict
417 with other devices in the system.
420 The Interrupt test insures there are no conflicts with the assigned IRQ
424 The EEPROM test insures the EEPROM can be read.
427 The Chip RAM test insures the 4K of memory internal to the CS8900/20 is
431 The Internal Loop Back test insures the adapter's transmitter and
432 receiver are operating properly. If this test fails, make sure the
433 adapter's cable is connected to the network (check for LED activity for
437 The Boot PROM test insures the Boot PROM is present, and can be read.
438 Failure indicates the Boot PROM was not successfully read due to a
439 hardware problem or due to a conflicts on the Boot PROM address
440 assignment. (Test only applies if the adapter is configured to use the
444 another device on the ISA bus. In this case, you should use the Manual Setup
445 option to reconfigure the adapter by selecting a different value for the system
453 on the same network. (Note: the diagnostic network test should not be run
456 This test requires that each of the two PCs have a CS8900/20-based adapter
457 installed and have the CS8900/20 Setup Utility running. The first PC is
458 configured as a Responder and the other PC is configured as an Initiator.
459 Once the Initiator is started, it sends data frames to the Responder which
460 returns the frames to the Initiator.
462 The total number of frames received and transmitted are displayed on the
463 Initiator's display, along with a count of the number of frames received and
464 transmitted OK or in error. The test can be terminated anytime by the user at
467 To setup the Diagnostic Network Test:
470 connection to act as the Responder. Run the CS8900/20 Setup Utility
471 and select 'Diagnostics -> Network Test -> Responder' from the main
472 menu. Hit ENTER to start the Responder.
474 2.) Return to the PC with the CS8900/20-based adapter you want to test and
475 start the CS8900/20 Setup Utility.
477 3.) From the main menu, Select 'Diagnostic -> Network Test -> Initiator'.
478 Hit ENTER to start the test.
480 You may stop the test on the Initiator at any time while allowing the Responder
482 them by starting the Initiator on another PC without having to stop/start the
489 The 2 and 3-media adapters have two LEDs visible on the back end of the board
490 located near the 10Base-T connector.
492 Link Integrity LED: A "steady" ON of the green LED indicates a valid 10Base-T
496 TX/RX LED: The yellow LED lights briefly each time the adapter transmits or
502 An IO conflict occurs when two or more adapter use the same ISA resource (IO
504 of four ways after installing and or configuring the CS8900/20-based adapter:
508 2.) The driver cannot communicate with the adapter, reporting an "Adapter
511 3.) You cannot connect to the network or the driver will not load.
513 4.) If you have configured the adapter to run in memory mode but the driver
517 If an IO conflict occurs, run the CS8900/20 Setup Utility and perform a
518 diagnostic self-test. Normally, the ISA resource in conflict will fail the
519 self-test. If so, reconfigure the adapter selecting another choice for the
520 resource in conflict. Run the diagnostics again to check for further IO
523 In some cases, such as when the PC will not boot, it may be necessary to remove
524 the adapter and reconfigure it by installing it in another PC to run the
525 CS8900/20 Setup Utility. Once reinstalled in the target system, run the
526 diagnostics self-test to ensure the new configuration is free of conflicts
527 before loading the driver again.
529 When manually configuring the adapter, keep in mind the typical ISA system
530 resource usage as indicated in the tables below.
561 :(512) 442-7555 (from outside the U.S. and Canada)
570 Much of the following information as possible.
602 You can obtain the latest CS89XX drivers and support software from Cirrus Logic's
607 Cirrus Logic maintains a web page at http://www.cirrus.com with the
613 In February 2000 the maintenance of this driver was assumed by Andrew
618 For use in embedded environments with no cs89x0 EEPROM, the kernel boot