e3dsetup(ADM) 06 January 1993 e3dsetup(ADM) Name e3dsetup - configure 3Com 3c507 EtherLink 16 and 16 T network adapter cards Syntax e3dsetup [-option] [value] e3dsetup -conn:[aui|other] -data:[dataaddressingmode] -help -io:[baseI/Oaddress] -irq:[IRQline] -ram:[RAMwindowstartingaddress] -ramsize:[RAMwindowsize] -rom:[bootROMstartingaddress] -romsize:[bootROMsize] -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 any one of them, you must remove all of the cards except the one to be reconfigured. Only the card being reconfigured can be physically installed in the computer during reconfiguration. Once the last card has been reconfigured, all the cards may be reinstalled. e3dsetup may be run interactively or from the command line. To display or change adapter card configurations interactively, enter the e3dsetup com- mand with no options. The command begins by attempting to find all soft- ware configurable cards (up to four) installed in the computer. 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 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 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:connectiontype 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:s | t 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/Obaseaddress 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:interruptrequest 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:RAMaddress 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:RAMsize 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:bootROMaddress specifies the starting address of the boot ROM. The address must be a hexadecimal value in the range from C0000 through DE00. 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:bootROMsize 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 | 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.