e3dsetup(ADM) e3dsetup(ADM)
Name
e3dsetup - configure 3Com 3c507 EtherLink 16 and 16 T network adapter
cards
Syntax
e3dsetup [-option] [value]
e3dsetup -conn:[aui|other]
-data:[data addressing mode]
-help
-io:[base I/O address]
-irq:[IRQ line]
-ram:[RAM window starting address]
-ramsize:[RAM window size]
-rom:[boot ROM starting address]
-romsize:[boot ROM size]
-zerowait:[e|d]
Description
The e3dsetup command configures 3Com EtherLink 16 network adapter cards.
For your protection, only the superuser in single-user (or maintenance)
mode should run this command. If you attempt to run e3dsetup without
entering single-user mode, the command produces the following message:
WARNING: All networking must be stopped and the system
should be in Single-User mode, Do you wish to continue? (y/n) [y]
See the ``Warnings'' section for more information before running this
command.
Because e3dsetup can only configure one card at a time, only one 3c507
adapter card may be physically installed in your computer for configura-
tion at one time. If you intend to install more than one 3c507 card, you
must install, configure and remove them sequentially. After you have
configured all of your network adapter cards, you may install as many as
four of them in your computer, provided that you have assigned each of
them a unique base I/O address and a unique IRQ line. You should also
make sure that the RAM window and the boot ROM address spaces, if
defined, do not overlap address spaces defined for other adapter cards or
devices. See the -ram, -ramsize, -rom and -romsize options for more in-
formation.
If you install more than one 3c507 card, and later want to reconfigure
one or more of them, you must remove all of the cards except the one to
be reconfigured. If you want to reconfigure any of the others, you must
remove the first reconfigured card and install the next card to be recon-
figured. Proceed in this manner until all your 3c507 cards have been
reconfigured. Once the last card has been reconfigured, all the remain-
ing cards may be reinstalled.
To display or change adapter card configurations interactively, enter the
e3dsetup command with no options. The command begins by attempting to
find all software configurable cards (up to four) installed in the com-
puter. If more than one 3Com 3c507 adapter card is found, the e3dsetup
command prints the current configurations for all of them, then prints a
warning message and exits. If, however, you have only one card
installed, the command displays the configuration of that card and
prompts you to change the configuration. If you want to change the con-
figuration of the adapter card, enter y. If you do not want to change
the configuration, enter n.
If you enter y, the command presents each configuration option in
sequence and displays its current value. If you want to retain the dis-
played value for that option, press <Enter>. If you want to change the
configuration value for that option, enter the new value and press
<Enter>.
To change the configuration of an adapter card from the command line,
enter the following:
e3dsetup [option]:[value]
The command first verifies that there is only one 3Com 3c507 adapter card
installed in the computer. If more than one card is found, e3dsetup
prints the current configurations for all the cards found, then prints a
warning message and exits. If only one card is found, the command reads
the option(s) and their value(s), verifies that the value(s) specified
are valid, and changes the configuration. All omitted options retain
their current values.
Options
-conn:connection type specifies the type of physical connection
used between the network adapter card and the
network. Acceptable values are aui (thick
Ethernet, external transceiver) or other
(either twisted pair or thin Ethernet with a
built in transceiver).
-data specifies whether 8- or 16-bit data transfers
are used. Acceptable values for this option
are s for standard 8-bit data transfer and t
for turbo 16-bit data transfer. Note that the
3c507 card does not work in 16-bit mode with
some motherboard chip sets. If your 3c507
card does not work in 16-bit mode, try the
8-bit mode.
-help displays the help screen.
-io:I/O base address specifies the base I/O address for the net-
work adapter card. The address must be
specified using three hexadecimal digits, lie
in the range from 200 through 3E0 inclusive,
and be a multiple of hexadecimal 10. In
other words, legal addresses are 200, 210,
220, and so forth. However, the following
are not allowed: 2F0, 370, 3B0, 3C0 and 3D0.
-irq:Interrupt request specifies the Interrupt request (IRQ) used by
the network adapter card. Acceptable values
are 3, 5, 7, 9, 10, 11, 12 and 15. Network
adapter cards prior to Revision 04 do not
support IRQ 11.
-ram:RAM address specifies the starting address of the RAM
window. The RAM window is adapter card mem-
ory that is mapped into the physical address
space of the computer. Acceptable values for
this option are: C0000, C8000, D0000, D8000,
F00000, F20000, F40000, F60000 or F80000.
Note that addresses above D0000 limit accept-
able values of the ramsize options. This
option is used in conjunction with the ram-
size option to specify the address space of
the RAM window. See the ramsize option for
more information.
ramsize:RAM size specifies the size of the RAM window in Kilo-
bytes. The RAM window is adapter card memory
that is mapped into the physical address
space of the computer. In general, accept-
able values for this option are 16, 32, 48,
and 64. However, if you specify a RAM window
starting address of D8000, the only accept-
able values are 16 or 32. Furthermore, if
you specify a RAM window starting address of
F00000 or greater, the only acceptable value
is 64. This option is used in conjunction
with the ram option to fully specify the
address space of the RAM window. Note that
the address space of the RAM window may not
overlap address spaces defined for other
adapter cards or other devices.
-rom:boot ROM address specifies the starting address of the boot
ROM. The address must be a hexadecimal value
in the range from C0000 through DE000.
Further, the address must be an integral mul-
tiple of hexadecimal 2000. In other words,
legal addresses are C0000, C2000, C4000, and
so forth.
-romsize:boot ROM size specifies the size of the boot ROM in Kilo-
bytes. Acceptable values for this option are
0, 16, 32, and 64. Specify a size of 0 if the
adapter card has no boot ROM or if you want
to disable the boot ROM.
-zerowait:e or d specifies whether the adapter card is to use
zero wait states for RAM access. Wait
states, if used, effectively slow down the
data transfer rate of the RAM on board the
adapter card. Acceptable values for this
option are d for disable and e for enable. If
you specify d, wait states are added. If you
specify e, no wait states are added.
Warnings
You should first use netconfig or mkdev to configure the device driver
before you run e3dsetup to configure your card. Both netconfig and mkdev
check the parameters you supply for conflicts with those already in use
by other devices. Once you resolve the conflicts, use the device driver's
values to configure the card.
You are strongly urged to run this program in single-user mode only.
This precaution avoids problems that might arise from specifying an
incorrect base I/O address for the network adapter card or from specify-
ing a base I/O address or IRQ that is already used by another adapter
card or device. It is also important that no part of the RAM and ROM
address spaces defined for the network adapter card overlaps address
spaces defined for other adapter cards or other devices. This includes
devices such as small built-in LED or LCD displays used to show disk
cylinder data or CPU clock speed.
See also
Consult the documentation accompanying the 3Com 3C507 EtherLink 16 or
16TP network adapter card for additional information about installing and
configuring the card.