EtherLink III Series Setup Program for Linux

EtherLink III Series Setup Program for Linux

This page describes an EEPROM setup program for the 3Com EtherLink III ISA and EISA boards, the 3c509 and 3c579.

Compiling the Setup Programs

To use this setup program, transfer the 3c5x9setup.c C source code and compile it on your Linux system. This program must be compiled with '-O'. The minimal suggested compile command is

cc -O -o 3c5x9 3c5x9setup.c which is also at the bottom of the source file. If you do not use '-O' you will have unresolved references to inlined functions e.g. inw().

Using the Setup Program

The diagnostic and setup programs attempt have a consistent basic interface, so the support information on the diagnostics page is valid for this setup program as well.

This program directly accesses the hardware, and thus must be run as root.

The following options are implemented:

-a
Show all registers
-E
Do an Emergency rewrite of a completely corrupted EEPROM. This option should never be used without reading and editing the source file emergency recovery table first.
-f
Force operations. This option causes the diagnostic program to proceed even if it detects that the adapter is currently active. With this setup program only, using "-f -f" overrides the failure to detect the chip.
-F media-type
Set the transceiver selection to the specified type. Valid media types are 10baseT, 10base2, 10base5, AUI and the indices 0 1 2 3.
-Q IRQ
Set the card to use the specified IRQ (interrupt line). Valid values are 3, 4, 5, 7, and 9-15. The new IRQ is written into the EEPROM and takes effect at the next hardware reset.
-p I/O-port
Specify the I/O port at which to find the card. The default value is 0x300. The number is assumed to be hexademical, and may optionally be prefixed by "0x".
-P I/O-port
Set the card's I/O address to the specified value. This is for ISA cards only. Acceptable values are chip specific. The 3c509 may be set to addresses on 0x10 byte boundaries from 0x200 to 0x3e0. The new address is written into the EEPROM and takes effect at the next hardware reset.
-v
Increase the verbosity level. Additional "-v" options increase the level further.
-V
Show the program version information.
-w
Write the EEPROM with the specified updated values.
-?
Emit usage information.

Linux Network Drivers Page
SCYLD information.
Author: Donald Becker
See the drivers for the contact email address. Do not bother sending email to zinc.anode@scyld.com, as email to that address adds your domain or IP address to the known-spammer list.