smcsetup(ADM) smcsetup(ADM)
Name
smcsetup - configures Standard Microsystems (SMC) and Western Digital
network adapter cards
Syntax
smcsetup [option] [configuration option]
smcsetup -default
-factory
-help
-io:base I/O address [configuration option:value]
-node:node address [configuration option:value]
-v
Description
The smcsetup command configures supported SMC and Western Digital network
adapter cards. For your protection, only the super user in single-user
(or maintenance) mode should run this command. If you attempt to run
smcsetup 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.
If you enter the smcsetup command without any options, the command begins
by checking to see if you are in multi- or single-user mode. It then
attempts to find all software configurable cards (up to four) installed
in the computer. It displays the configuration of each card, and asks if
you want to change the configuration. If you do not want to, enter n (or
q if you have more than one adapter card installed).
If you do want to change the configuration of an adapter card, enter the
number of that card (or enter y if you have only one card installed).
smcsetup presents the configuration options in sequence. Press <Enter> to
accept the current value. To change the current value, enter the new
value and press <Enter>.
If you have multiple cards, and you want to display or modify the config-
uration of a single adapter card, enter its base I/O address or Ethernet
node address as follows:
smcsetup -io:base I/O address
or
smcsetup -node:node address
smcsetup then presents the configuration sequence for that card only.
If you want to change a single configuration value on a single card,
first enter:
smcsetup -io:card address
card address refers to the base I/O address or the card to be reconfig-
ured. Alternatively, the card may also be specified by entering:
smcsetup -node:node address
node address refers to the ethernet node address of the card to be recon-
figured. After you specify the card to be reconfigured, enter the con-
figuration option for the value you want to change, followed by the new
value.
For example, the following commands change the interrupt request for the
specified cards to 7.
smcsetup -io:240 -irq:7
or
smcsetup -node:132.147.152.19 -irq:7
In the above example, smcsetup searchs for an SMC or Western Digital card
with either an I/O base address of 240 or an ethernet node address of
132.147.152.19. If it finds a card matching either specification, it
changes the interrupt vector for that card to 7. For each configuration
option specified, the new value replaces the current value. Omitted
options retain their current values.
You can install as many as four SMC or Western Digital network adapter
cards in your computer, provided that you have assigned each of them both
a unique base I/O address and a unique IRQ line.
Options
-default forces the adapter card to its default configuration.
This option overrides all other options, including -
factory.
-factory forces the adapter card to the factory configuration.
This option overrides all other options except -
default. The factory configuration is the same as
the default configuration, except that interrupts are
disabled.
-help displays the help screen
-io:base I/0 address
allows the user to specify a given card in a multi-
card installation by identifying its base I/O
address. Once the card is specified, the user may
reconfigure all or part of the configuration parame-
ters with the configuration options.
-node:node address allows the user to specify a given card in a
multi-card installation by identifying its Ethernet
node address. Once the card is specified, the user
may reconfigure all or part of the configuration pa-
rameters with the configuration options.
-v displays the smcsetup version number
Configuration options
-irq:Interrupt Request line specifies the Interrupt Request (IRQ) line
the network adapter card uses. This option
also has the effect of enabling the IRQ line
specified. Acceptable values for this
option are 2, 3, 4, 5, 7, 10, 11, and 15.
Note that IRQ 2 maps into IRQ 9. Also, some
adapter cards do not support all of the
above values.
-link_int:e or d specifies whether Link Integrity is enabled
or disabled. Acceptable values for this
option are e (enabled) or d (disabled).
This option cannot be used with SMC or
Western Digital 8013WC and 8013EWC series
network adapter cards. For these adapter
cards, use the -netconn option instead of
the -link_int option.
-netconn:connection type specifies the type of physical connection
used between the network adapter card and
the network. This option must be used for
those cards that lack a hardware jumper for
this purpose. Acceptable values for this
option are 1 (BNC or 10BaseT), 2 (AUI or
10BaseT), and 3 (Twisted Pair with No Link
Integrity).
-newio:I/O address specifies the new base I/O address in hexa-
decimal for a network adapter card. The
address must be in the range from hexade-
cimal 200 through 3E0 and must be a multiple
of hexadecimal 20. In other words, legal
addresses are 200, 220, 240, and so forth.
-ram:RAM address specifies the starting address of the RAM
window. The RAM window is the RAM on the
adapter card that is mapped into the physi-
cal address space of the computer. The
address must be a hexadecimal value in the
range from 80000 through FE000. Also, the
address must be an integral multiple of -
ramsize. See the -ramsize option for more
information. For 8013 adapter cards, recall
that addresses above 1 Mbyte are specified
with six hexadecimal digits.
-ramsize:RAM size specifies the size of the RAM window in
Kilobytes. The RAM window is the RAM on the
adapter card that is mapped into the physi-
cal address space of the computer. Accept-
able values for this option are 8 and 16.
The starting address of the RAM window is
specified with the -ram option. The address
space of the RAM window, defined by the -
ramsize and -ram options, must be reserved
for a given adapter card and not overlap
address spaces defined for other adapter
cards or devices.
-rom:boot ROM address specifies the base address of the boot ROM.
The address must be a hexadecimal value in
the range from 80000 through FC000. Also,
the address must be an integral multiple of
-romsize. This option is ignored if -romsize
is 0.
-romsize:boot ROM size specifies the size of the boot ROM in Kilo-
bytes. Acceptable values for this option
are 0, 16, 32, or 64. Specify a size of 0 if
the adapter card has no boot ROM or if you
want to disable it. The address space for
the boot ROM, defined by the -romsize and -
rom options, must be reserved for a given
adapter card and not overlap address spaces
defined for other adapter cards or devices.
-wait:y or n specifies whether or not the adapter card is
to use zero wait states for RAM access.
Acceptable values for this option are y for
yes and n for no. If you specify y, wait
states are added to slow down the data
transfer rate of the RAM on the adapter
card. If you specify n, no wait states are
added.
Notes
Depending on the cards you are installing, you may have to set hardware
jumpers to allow the configuration settings you specify with smcsetup to
take effect. Consult the documentation accompanying your adapter card
for more information.
Warnings
You should first use netconfig (or mkdev) to configure the driver before
you run smcsetup 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 any conflicts, use the 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 a network adapter card or from specifying
a base I/O address that is already being used by some other device. If
multiple adapters cards are to be configured, it is recommended that you
configure them one at a time to reduce the chance of configuring more
than one card with the same base I/O address. It is also important that
no part of the RAM and ROM address spaces defined for a given network
adapter card be shared with either other adapter cards or another device.
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 your network adapter card for
additional information about installing and configuring the card.