wdnsetup(ADM) 19 June 1992 wdnsetup(ADM) Name wdnsetup - configures Western Digital network adapter cards Syntax wdnsetup [option] [configuration option] wdnsetup -v -help -factory -default [-io:base I/O address] [configuration option] [-node:node address] [configuration option] Description The wdnsetup command configures supported Western Digital network adapter cards. Only the super user can run this command. See the ``Warnings'' section before running this command. If you enter the wdnsetup command without any options, the command begins by attempting to find all software configurable cards (up to four) installed in the computer that have base I/O addresses within the range from hexadecimal 200 through 3E0. It then displays the configuration of each card, and prompts you to change the configuration. If you do not want to change configurations, enter q (or n if you have only 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). wdnsetup presents the configuration options in sequence. Press <Return> to accept the current value. To change the current value, enter the new value and press <Return>. 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: wdnsetup -io:base I/O address or wdnsetup -node:node address wdnsetup then presents the configuration sequence for that card only. If you want to change a single configuration value on a single card, first enter either wdnsetup -io:card address with the base I/O address, or wdnsetup -nodecard node with the node address of the card to be recon- figured. Then enter the configuation option for the value you want to change followed by the new value. For example the following command changes the interrupt request for the card located at I/O address 240 to 7. wdnsetup -io:240 -irq: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 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 -v displays the wdnsetup version number -help displays the help screen -factory forces the adapter card to the factory configura- tion. This option overrides all other options except -default. The factory configuration is the same as the default configuration, except that interrupts are disabled. -default forces the adapter card to its default configura- tion. This option overrides all other options, including -factory. -node:node address allows the user to specify a given card by identi- fying its Ethernet node address. -io:base I/0 address allows the user to specify a given card by identi- fying its base I/O address. Configuration options -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. When power to the computer is turned on, the contents of the EEROM chips on the adapter card are loaded into the internal registers of the WD83C583 or WD83C584 Bus Interface Controller Device. These registers occupy eight consecutive I/O addresses, starting at the base I/O address configured for the adapter card. -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. -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 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. -netconn:type of connection specifies the type of physical connection to be 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). -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 WD8013WC and WD8013EWC network adapter cards. For these adapter cards, use the -netconn option instead of the -linkint option. Notes Depending on the cards you are installing, you may have to set hardware jumpers to allow the configuration settings you specify with wdnsetup 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 wdnsetup 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 driver's values to configure the card. You are strongly urged to run this program in single-user mode only. This precaution is 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.