1.\" $OpenBSD: ep.4,v 1.35 2013/08/14 06:32:34 jmc 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 $Mdocdate: August 14 2013 $ 32.Dt EP 4 33.Os 34.Sh NAME 35.Nm ep 36.Nd 3Com EtherLink III and Fast EtherLink III 10/100 Ethernet device 37.Sh SYNOPSIS 38.Cd "ep* at eisa?" 39.Cd "ep* at isa?" 40.Cd "ep* at pci?" 41.Cd "ep* at pcmcia?" 42.Cd "ep* at isapnp?" 43.Cd "tqphy* at mii?" 44.Sh DESCRIPTION 45The 46.Nm 47device driver supports the 3Com EtherLink III and Fast EtherLink III family 48of Ethernet cards. 49This includes, among others, the following models: 50.Pp 51.Bl -tag -width 3CXXXX -offset indent -compact 52.It 3C509 53EtherLink III ISA 54.It 3C509B 55EtherLink III ISA (Plug-and-Play) 56.It 3C556 57EtherLink III LAN+Modem PC Card (PCMCIA) 58.It 3C562 59EtherLink III LAN+33.6K Modem PC Card (PCMCIA) 60.It 3C574 61Fast EtherLink III 10/100 LAN PC Card (PCMCIA) 62.It 3C579 63EtherLink III EISA 64.It 3C589 65EtherLink III LAN PC Card (PCMCIA) 66.It 3C590 67Fast EtherLink III PCI 68.It 3C592 69EtherLink III EISA Bus Master 70.It 3C595 71Fast EtherLink III PCI 10/100 72.It 3C597 73Fast EtherLink III EISA 10/100 74.El 75.Pp 76Category 3, 4 or 5 unshielded twisted-pair (UTP) cable should be used for 77RJ-45 (10baseT), thick Ethernet coaxial (RG59 B/U, 50 ohm) for AUI/DIX, and 78thin Ethernet coaxial (RG58 A/U or C/U, 50 ohm +/- 4) for BNC (10base2). 79Some 3Com NICs also support MII connectors (switchable 10/100Mbps UTP). 80.Pp 81The following media types and options (as given to 82.Xr ifconfig 8 ) 83are supported: 84.Bl -tag -width xxx -offset indent 85.It Cm media No autoselect 86Enable autoselection of media type and options. 87.It Cm media No 100baseTX Cm mediaopt No full-duplex 88Set 100Mbps (Fast Ethernet) operation and force full-duplex mode. 89.It Cm media No 100baseTX Cm mediaopt No half-duplex 90Set 100Mbps (Fast Ethernet) operation and force half-duplex mode. 91.It Cm media No 10baseT Cm mediaopt No full-duplex 92Set 10baseT (UTP) operation and force full-duplex mode. 93.It Cm media No 10baseT Cm mediaopt No half-duplex 94Set 10baseT (UTP) operation and force half-duplex mode. 95.It Cm media No 10base5 96Set 10base5 (thick-net) operation (half-duplex only). 97.It Cm media No 10base2 98Set 10base2 (thin-net) operation (half-duplex only). 99.El 100.Pp 101Note that the 100baseTX media type is only available if supported by the 102adapter. 103For more information on configuring this device, see 104.Xr ifconfig 8 . 105To view a list of media types and options supported by your card try 106.Dq ifconfig <device> media . 107For example, 108.Dq ifconfig ep0 media . 109.Pp 110If more than one of the supported cards is installed, they are probed for 111in the following order: 112.Pp 113.Bl -enum -offset indent -compact 114.It 115PCI cards based on PCI function number order. 116.It 117EISA cards based on EISA slot number order. 118.It 119ISA cards based on increasing Ethernet address order. 120.It 121Any ISA cards in Plug-and-Play mode, in Plug-and-Play order. 122.El 123.Pp 124You may specify the port and IRQ numbers where the cards are expected to 125be found, but it is not necessary. 126The cards are intelligent enough to let us know where they live on the bus. 127.Sh DIAGNOSTICS 128.Bl -diag 129.It ep0: reset (status: %x) 130The driver has encountered a FIFO underrun or overrun. 131The driver will reset the card and the packet will be lost. 132This is not fatal. 133.It ep0: eeprom failed to come ready 134The EEPROM failed to come ready. 135This probably means the card is wedged. 136.It ep0: erase pencil mark, or disable PnP mode! 137This means that someone has scribbled with pencil in the test area on the 138card. 139Erase the pencil mark and reboot. 140(This is not a joke). 141.El 142.Sh SEE ALSO 143.Xr eisa 4 , 144.Xr ifmedia 4 , 145.Xr intro 4 , 146.Xr isa 4 , 147.Xr isapnp 4 , 148.Xr pci 4 , 149.Xr pcmcia 4 , 150.Xr tqphy 4 , 151.Xr hostname.if 5 , 152.Xr ifconfig 8 153