smcsetup(ADM) 24 August 1992 smcsetup(ADM) Name smcsetup - configures supported Standard Microsystems (SMC) and Western Digital 8003 and 8013 series network adapter cards Syntax smcsetup [option] [configuration option] smcsetup -default -factory -help -io:baseI/Oaddress [configurationoption:value] -node:nodeaddress [configurationoption: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:baseI/Oaddress or smcsetup -node:nodeaddress 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:cardaddress 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:nodeaddress nodeaddress 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:baseI/0address 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:nodeaddress 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:interruptrequest 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. -linkint: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 -linkint option. -netconn:connectiontype 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/Oaddress 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:RAMaddress 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:RAMsize 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:bootROMaddress 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:bootROMsize 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 | 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.