1.\" $OpenBSD: ep.4,v 1.20 2001/06/22 12:15:45 mpech Exp $ 2.\" 3.\" Copyright (c) 1994 Herb Peyerl 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. All advertising materials mentioning features or use of this software 15.\" must display the following acknowledgement: 16.\" This product includes software developed by Herb Peyerl 17.\" 3. The name of the author may not be used to endorse or promote products 18.\" derived from this software without specific prior written permission 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 21.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 22.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 23.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 24.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 25.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 26.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 27.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 28.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 29.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 30.\" 31.Dd July 12, 1998 32.Dt EP 4 33.Os 34.Sh NAME 35.Nm ep 36.Nd 3Com EtherLink III and Fast EtherLink III Ethernet driver 37.Sh SYNOPSIS 38.Cd "ep? at eisa? slot ?" 39.Cd "ep? at isa? port ? irq ?" 40.Cd "ep? at pci? dev ? function ?" 41.Cd "ep? at pcmcia? port 0x300 size 0x10 irq 10 slot ?" 42.Cd "ep* at isapnp?" 43.Sh DESCRIPTION 44The 45.Nm 46device driver supports the 3Com EtherLink III and Fast EtherLink III family 47of Ethernet cards. This includes, among others, the following models: 48.Pp 49.Bl -tag -width 3CXXXX -offset indent -compact 50.It 3C509 51EtherLink III ISA 52.It 3C556 53EtherLink III LAN+Modem PC Card (PCMCIA) 54.It 3C562 55EtherLink III LAN+33.6K Modem PC Card (PCMCIA) 56.It 3C574 57Fast EtherLink III 10/100 LAN PC Card (PCMCIA) 58.It 3C579 59EtherLink III EISA 60.It 3C589 61EtherLink III LAN PC Card (PCMCIA) 62.It 3C590 63Fast EtherLink III PCI 64.It 3C595 65Fast EtherLink III 10/100 PCI 66.El 67.Pp 68Other models of 3Com network cards are supported by the 69.Xr ec 4 , 70.Xr ef 4 , 71.Xr eg 4 , 72.Xr el 4 , 73.Xr ie 4 , 74and 75.Xr xl 4 76drivers. 77.Pp 78Category 3, 4 or 5 unshielded twisted-pair (UTP) cable should be used for 79RJ-45 (10baseT), thick Ethernet coaxial (RG59 B/U, 50 ohm) for AUI/DIX, and 80thin Ethernet coaxial (RG58 A/U or C/U, 50 ohm +/- 4) for BNC (10base2). 81Some 3Com NICs also support MII connectors (switchable 10/100Mbps UTP). 82.Pp 83The following media types and options (as given to 84.Xr ifconfig 8 ) 85are supported: 86.Pp 87.Bl -tag -width xxx -offset indent 88.It Cm media No autoselect 89Enable autoselection of media type and options. 90.It Cm media No 100baseTX Cm mediaopt No full-duplex 91Set 100Mbps (Fast Ethernet) operation and force full-duplex mode. 92.It Cm media No 100baseTX Cm mediaopt No half-duplex 93Set 100Mbps (Fast Ethernet) operation and force half-duplex mode. 94.It Cm media No 10baseT Cm mediaopt No full-duplex 95Set 10baseT (UTP) operation and force full-duplex mode. 96.It Cm media No 10baseT Cm mediaopt No half-duplex 97Set 10baseT (UTP) operation and force half-duplex mode. 98.It Cm media No 10base5 99Set 10base5 (thick-net) operation (half-duplex only). 100.It Cm media No 10base2 101Set 10base2 (thin-net) operation (half-duplex only). 102.El 103.Pp 104Note that the 100baseTX media type is only available if supported by the 105adapter. For more information on configuring this device, see 106.Xr ifconfig 8 . 107To view a list of media types and options supported by your card try 108.Dq ifconfig -m <device> . 109For example, 110.Dq ifconfig -m ep0 . 111.Pp 112If more than one of the supported cards is installed, they are probed for 113in the following order: 114.Pp 115.Bl -item -offset indent -compact 116.It 1171. PCI cards based on PCI function number order. 118.It 1192. EISA cards based on EISA slot number order. 120.It 1213. ISA cards based on increasing Ethernet address order. 122.It 1234. Any ISA cards in Plug-and-Play mode, in Plug-and-Play order. 124.El 125.Pp 126You may specify the port and IRQ numbers where the cards are expected to 127be found, but it is not necessary. The cards are intelligent enough to 128let us know where they live on the bus. 129.Sh DIAGNOSTICS 130.Bl -diag 131.It ep0: reset (status: %x) 132The driver has encountered a FIFO underrun or overrun. The driver will reset 133the card and the packet will be lost. This is not fatal. 134.It ep0: eeprom failed to come ready 135The EEPROM failed to come ready. This probably means the card is wedged. 136.It ep0: 3c509 in test mode. Erase pencil mark! 137This means that someone has scribbled with pencil in the test area on the 138card. Erase the pencil mark and reboot. (This is not a joke). 139.El 140.Sh SEE ALSO 141.Xr ec 4 , 142.Xr ef 4 , 143.Xr eg 4 , 144.Xr el 4 , 145.Xr ie 4 , 146.Xr ifmedia 4 , 147.Xr xl 4 , 148.Xr ifconfig 8 149