e3dsetup(ADM) 19 June 1992 e3dsetup(ADM) Name e3dsetup - configure 3Com 3c507 EtherLink 16 and 16 T network adapter cards Syntax e3dsetup -help e3dsetup [-data:data addressing mode] [-io:base I/O address] [-irq::IRQ line] [-conn:aui | bnc] [-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, this command can be run only by the superuser. See the ``Warnings'' section for a description of the issues to be aware of before running this command. Because e3dsetup can only configure on card at a time, only one 3c507 adapter card at a time can be physically installed in your computer while you are configuring the card. 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 can 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 information. If you install more than one 3c507 card and later want to reconfigure some or all of them, you must remove all but one of the cards before con- figuring the remaining card. Once you have configured the one card and want to configure the others, you must remove the card just configured and install the next card to be configured. Proceed in this manner untill your 3c507 cards have been reconfigured. Once the last card has been configured, all the remaining cards can be reinstalled. When power to the computer is turned on, the contents of the EEPROM chip on board the network adapter card is loaded into the configuration regis- ters of the card. These registers occupy three consecutive I/O addresses. The first of these addresses is offset thirteen memory loca- tions beyond the base I/O address configured for the card. In other words, the first address equals the base I/O address plus hexadecimal 0D. 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 and which have base I/O addresses within the range from hexadecimal 200 through 3E0. 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 Eth- erLink 16 network adapter card installed, the command displays the con- figuration of that card and prompts you to change the configuration. If you want to change the configuration 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 change the con- figuration value for that option, enter the new value and press <Return>. If you want to retain the displayed value for that option, simply press <Return>. To change the configuration of an adapter card from the command line, enter the following: e3dsetup [options] The command first verifies that there is only one 3Com 3c507 adapter card installed in the computer with a base I/O address in the range from hexa- decimal 200 through 3E0 inclusive. 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 com- mand reads the options and their values, verifies that the values speci- fied are valid, and changes the configuration values as specified by the options. All omitted options retain their current values. Options -help displays the help screen. -data specifies whether 8 or 16 bit data transfers are used. Acceptable values for this options are s for 8-bit data transfer and t for 16-bit data transfer. Note that the 3c507 card does not work in 16-bit mode with some mother- board chip sets. If your 3c507 card does not work in 16 bit mode, try the 8-bit mode -io specifies the base I/O address for the network adapter card. The address must be specified using three hexade- cimal 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 addresses are not allowed, even though they follow the rules just described: 2F0, 370, 3B0, 3C0, and 3D0. -irq specifies the Interrupt Request (IRQ) line to be used by the network adapter card. Acceptable values for this option are 3, 5, 7, 9, 10, 11, 12, and 15. Be aware that network adapter cards prior to Revision 04 do not support IRQ 11. -conn specifies the type of physical connection to be used between the network adapter card and the network. Accept- able values for this option are aui (thick Ethernet, external transceiver) or bnc (thin Ethernet, on-board transceiver). -ram specifies the starting address of the RAM window. The RAM window is memory on the adapter card 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 acceptable values of the - ramsize options. See the -ramsize option for more infor- mation. This option is used in conjunction with the - ramsize option to fully specify the address space of the RAM window. -ramsize specifies the size of the RAM window in Kbytes. The RAM window is memory on the adapter card that is mapped into the physical address space of the computer. In general, acceptable values for this option are 16, 32, 48, and 64. However, if you specify a RAM window starting address of D8000, the only acceptable values are 16 or 32. Further- more, 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 cannot overlap address spaces defined for other adapter cards or other devices. -rom 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 multiple of hexadecimal 2000. In other words, legal addresses are C0000, C2000, C4000, and so forth. -romsize specifies the size of the boot ROM in Kbytes. 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 the boot ROM. -zerowait specifies whether or not the adapter card is to use zero wait states for RAM access. Wait states, if used, effec- tively slow down the data transfer rate of the RAM on board the adapter card. Zero wait states means that no wait states are used and RAM accesses occur at full speed. 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 driver before you run e3dsetup to configure your card. Both netconfig and mkdev check the perameters 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. The purpose of this precaution is to avoid problems that might arise from specifying an incorrect base I/O address for the network adapter card or from specifying a baseI/O address or IRQ that is already being 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 overlap 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 E3c507 network adapter card for additional information about installing and configuring the card.