Software Keywords

Table of Contents

APPENDIX B: Software Keywords (For All Drivers)

This section describes software keywords that may be needed while configuring PCnet adapter cards. There are two sections of keywords discussed below: common keywords and AMD driver specific keywords. Also, a table is provided to show the valid combinations of keywords with the various PCnet adapter cards.

Common Keywords

Common keywords may be used by any of the operating systems to configure a PCnet adapter card.

PORT

The I/O base address keyword may be used to specify the I/O address of the PCnet adapter card. There are different formats for I/O address settings in each Network Operating System environment. Refer to the appropriate driver installation section (Operating System/Driver Keywords) for correct format and usage.

For all of the PCnet adapter cards, the I/O base address does not need to be specified for driver configuration. Software will scan for this information for any bus type (ISA, VL, PCI). See the table below.

INT

An interrupt channel keyword may be set when loading drivers for the PCnet adapter cards. Each Network Operating System environment has different formats and syntax for interrupt settings. Refer to the appropriate driver installation section (Operating System/Driver Keywords) for correct format and usage. See the table below.

For PCnet-ISA cards, the interrupt channel should be specified to match the jumper setting on the adapter card. If no interrupt setting is specified, the driver will use the default setting of "3" for the IRQ channel.

For PCnet-ISA+, PCnet-ISA II, and PCnet-PCI boards, the interrupt keyword should not be used. Software will determine the interrupt channel. For PCnet-ISA+ and PCnet-ISA II, the driver will use the interrupt channel set by the Plug and Play (PnP) ISA Configuration Manager for PnP mode or by the on-board EEPROM when PnP is disabled. For PCnet-32 adapter cards (VL-based), the driver will use the interrupt channel provided by the on-board EEPROM (which may be changed using the PCnet AMINSTAL Utility). For PCnet-PCI (PCI-based) adapter cards, the driver will use the interrupt set by the PCI system BIOS.

DMA

The DMA keyword may be used when loading drivers. There are different formats and syntax for DMA keywords. Refer to the appropriate driver installation section (Operating System/Driver Keywords) for correct format and usage. See the Table 7 below for Common Keywords and Table 8 following for Valid Keyword Combinations.

For PCnet-ISA adapter cards, the DMA keyword should be used to match the jumper setting on the adapter card. If no DMA keyword is specified, the default setting of "5" will be used for the DMA channel.

For PCnet-ISA+, PCnet-ISA II, PCnet-32, and PCnet-PCI adapter cards, the DMA keyword should not be used. Software will determine the DMA channel. For PCnet-ISA+, software will use the DMA channel set by the PnP ISA Configuration Manager for PnP mode or by the on-board EEPROM when PnP is disabled. For PCnet-32 adapter cards (VL-based) and PCnet-PCI adapter cards (PCI-based) adapter cards, software will use the DMA channel provided by the bus.

Full Duplex

The full duplex keyword may only be used with the PCnet-ISA II adapter card. This keyword enables (UTP or AUI) or disable (OFF) full duplex support on the 10BaseT and AUI ports. See Tables 7 and 8 below.

Table 7. Common Keywords

Keyword Name	PCnet Adapter Card	Range	Default
PORT	PCnet-ISA	300h, 320h, 340h, 360h (jumper selectable)	Driver will scan for I/O address
	PCnet-ISA+ PCnet-ISA II	200h-3FFh (per 20h offset)	Found by scan. Determined by PnP Configuration Mgr. or by on-board EEPROM when PnP is disabled
	PCnet-32	200h-3FFh (per 20h offset)	Found by scan. Determined by on-board EEPROM
	PCnet-PCI	0000-FFFFh	Found by scan. Determined by PCI system BIOS.
INT	PCnet-ISA	3, 4, 5, 9 (jumper selectable)	3
	PCnet-ISA+ PCnet-ISA II	3 (IRQ3), 4 (IRQ4), 5 (IRQ5), 9 (IRQ9), 10 (IRQ10), 11 (IRQ11), 12 (IRQ12), 15 (IRQ15)	Found by scan. Determined by PnP Configuration Mgr. or by on-board EEPROM when PnP is disabled
	PCnet-32	IRQ (0 -15)	Found by scan. Determined by the on-board EEPROM. IRQ read from I/O offset 08h
	PCnet-PCI	0-15 (INTA#)	Found by scan. Determined by the PCI system BIOS
DMA	PCnet-ISA	3, 5, 6, 7 (jumper selectable)	5

Keyword Name	PCnet Adapter Card	Range	Default
	PCnet-32	N/A	N/A
	PCnet-PCI	N/A	N/A
FDUP	PCnet-ISA	UTP AUI OFF	N/A
	PCnet-ISA+ PCnet-ISA II	UTP AUI OFF	N/A
	PCnet-32	UTP AUI OFF	N/A
	PCnet-PCI	UTP AUI OFF	N/A

Table 8. Valid Keyword Combinations

Keyword	PCnet-ISA	PCnet-ISA+	PCnet-ISA II	PCnet-32	PCnet-PCI
INT	X	X	X	X
DMA	X	X	X
PORT	X	X	X	X
BUSTYPE	X	X	X	X	X
DMAROTATE	X	X	X
TP	X	X	X	X	X
LED[0-3]	X	X	X	X	X
FDUP			X

Note: If PORT is specified, then the BUSTYPE keyword will not function. If no PORT or BUSTYPE is specified, the software will automatically scan all buses until a PCnet adapter card is found. Once the PCnet adapter card is found, the driver will load.

AMD Driver Specific Keywords

DMAROTATE

This keyword applies to the PCnet-ISA, PCnet-ISA+, and PCnet-ISA II adapter cards only. When present, this keyword will force the system 8237 controller into rotating priority mode. The default mode for the 8237 controller is fixed priority.

BUSTYPE = bus

This keyword applies to all of the PCnet adapter cards. If this keyword is specified with one of the above mentioned options, the driver software will only scan the specified bus for the presence of the PCnet adapter card. If this keyword is not specified the software will scan all the buses.

Valid values for "bus" include: PCI, PCI1, PCI2, PNP, ISA, and VESA.

TP

This keyword applies to all of the PCnet adapter cards. When present, this keyword will force the PCnet adapter card into using the 10BASE-T port. The PCnet controller will use the 10BASE-T port even if no link beat pulse is generated from the 10BASE-T hub. If not set, auto port detection will be used.

LED0 = XXXX

This keyword applies to all of the PCnet adapter cards except for PCnet-ISA+ and PCnet-ISA II. When present, this keyword should have a hexadecimal value which indicates the function of LED0. The software reads the hex value of the keyword and programs the LED0 register (BCR4) with the value specified. The user should be careful about what hex value is specified because the hex value is programmed directly into the device register.

"xxxx" is a hex value for the BCR4 register. Some of the valid values are listed below:

0001h Indicates collision activity on the network

0002h Indicates PCnet is jabbering on the network

0004h Indicates promiscuous receive activity on the network

0008h Indicates the current receive polarity condition

0010h Indicates the transmit activity

0020h Indicates receive activity for this station

0040h Indicates the current link status

0030h Indicates the transmit and receive activity for this station

0034h Indicates the transmit and promiscuous receive activity

LED1 = XXXX

"xxxx" is a hex value for the BCR5 register. Same description as LED0.

LED2 = XXXX

"xxxx" is a hex value for the BCR6 register. Same description as LED0.

Note: LED2 is not available for the PCnet-PCI device.

LED3 = XXXX

"xxxx" is a hex value for the BCR7 register. Same description as LED0.

See Table 9 for AMD Driver Specific Keywords.

Table 9. AMD Driver Specific Keywords

Keyword Description	Keyword Name	Range	Default
DMA Rotate	DMAROTATE	Present or Not Present	Not Present (Fixed Priority)
Bus Type to Scan	BUSTYPE BUS_TO_SCAN	PCI PCI1 PCI2 PNP ISA VESA Not Present (All) * PCI1 is used for mechanism 1 and PCI2 is for mechanism 2.	Not Present (represents All buses)
Twisted Pair	TP * TP is void if FDUP=AUI	Present or Not Present	Not Present (Auto Detect)
LED0 Function	LED0 * LED0 not available for PCnet-ISA+ or PCnet-ISA-II	00 - FFh For sample values: see LED0 description on previous page.	See appropriate PCnet Ethernet Controller Hardware User's Manual
LED1 Function	LED1	00 - FFh For sample values: see LED1 description on previous page.	See appropriate PCnet Ethernet Controller Hardware User's Manual
LED2 Function	LED2 * LED2 not available for PCnet-PCI	00 - FFh For sample values: see LED2 description on previous page.	See appropriate PCnet Ethernet Controller Hardware User's Manual
LED3 Function	LED3	00 - FFh For sample values: see LED3 description on previous page.	See appropriate PCnet Ethernet Controller Hardware User's Manual
Full Duplex	FDUP	UTP AUI OFF	OFF

Note: All drivers support the above keywords; however, please refer to the Table of Valid Keyword Combinations for valid combinations with each PCnet adapter cards.