1.\" $NetBSD: ep.4,v 1.18 1997/11/11 05:11:28 thorpej Exp $ 2.\" 3.\" Copyright (c) 1997 Jonathan Stone 4.\" All rights reserved. 5.\" 6.\" Copyright (c) 1994 Herb Peyerl 7.\" All rights reserved. 8.\" 9.\" Redistribution and use in source and binary forms, with or without 10.\" modification, are permitted provided that the following conditions 11.\" are met: 12.\" 1. Redistributions of source code must retain the above copyright 13.\" notice, this list of conditions and the following disclaimer. 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in the 16.\" documentation and/or other materials provided with the distribution. 17.\" 3. All advertising materials mentioning features or use of this software 18.\" must display the following acknowledgements: 19.\" This product includes software developed by Herb Peyerl 20.\" This product includes software developed by Jonathan Stone 21.\" 3. The name of the author may not be used to endorse or promote products 22.\" derived from this software without specific prior written permission 23.\" 24.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 25.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 26.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 27.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 28.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 29.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 30.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 31.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 32.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 33.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 34.\" 35.Dd October 20, 1997 36.Dt EP 4 37.Os NetBSD 38.Sh NAME 39.Nm ep 40.Nd device driver for 3Com Etherlink III family 41.Sh SYNOPSIS 42.Cd "ep0 at isa? port ? irq ?" 43.Cd "ep* at isapnp?" 44.Cd "ep* at eisa? slot ?" 45.Cd "ep* at pci? dev ? function ?" 46.Cd "ep* at pcmcia? function ?" 47.Sh DESCRIPTION 48The 49.Nm ep 50device driver supports the 3Com Etherlink III family of Ethernet cards. 51Supported Etherlink III cards include: 52.Pp 53.Bl -tag -width xxxxxx -offset indent 54.It 3c509 55ISA 10Mbit card, in BNC and multiport variants 56.It 3c509B 57ISA Plug-and-Play 10Mbit card, in BNC and multiport variants 58.It 3c579 59EISA 10Mbit card, in BNC and muiltport variants 60.It 3c592 61EISA 10Mbit card with busmastering capability 62.It 3c597 63EISA 10/100Mbit card with busmastering capability 64.It 3c590 65PCI 10Mbit multiport card with busmastering capability 66.It 3c595 67PCI 10/100Mbit multiport card with busmastering capability 68.It 3c900 69PCI 10Mbit card in 10baseT and multiport variants 70.It 3c905 71PCI 10/100Mbit cards 72.It 3c562 73PCMCIA modem/10Mbit Ethernet combo card with dongle 74.It 3c589 75PCMCIA 10Mbit card with dongle 76.El 77.Pp 78The 3c515 is an ISA 10/100 card with busmastering capability. 79The chipset is similar to that of the 3c905, with some changes to 80make it work with the more limited ISA bus address space. This card 81is not currently supported. 82.Sh MEDIA SELECTION 83Various models of these cards come with a different assortment of 84media. Supported 10Mbit Ethernet media include: 85.Pp 86.Bl -tag -width xxxxxxxxxx -offset indent 87.It 10base5 88AUI, standard 15 pin connector 89.It 10base2 90BNC, also known as thin-net 91.It 10baseT 92UTP, also known as twisted pair 93.El 94.Pp 95The 100Mbit cards each support exactly one of the following 100Mbit 96standards: 97.Pp 98.Bl -tag -width xxxxxxxxxx -offset indent 99.It 100baseTX 100100Mbit over cat-5 UTP 101.It 100baseT4 102100Mbit over all four pairs of cat-3 UTP 103.It 100baseFX 104100Mbit over fiber 105.It MII 106MII connection to external 100Mbit PHY 107.El 108.Pp 109Note that the 100baseTX and 100baseT4 cards can also run as 10baseT. 110.Pp 111The 112.Nm 113driver defaults to using the port selected via the vendor-supplied 114configuration utility. 115To choose an alternate port, 116use the following media flags with 117.Xr ifconfig 8 118or in your /etc/ifconfig.ep? file. 119.Pp 120.Bl -tag -width xxxxxxxxxx -offset indent 121.It 10base2 122Use the 10base-2 BNC port. 123.It AUI 124Use the AUI port. 125.It 10baseT 126Use the UTP port in 10base-T mode. 127.It 100baseTX 128Use the builtin 100base-Tx PHY on the UTP port. 129.It 100baseFX 130Use the builtin 100mbit fibre-optic PHY. 131.It 100baseT4 132Use the builtin 100base-T4 PHY on the UTP port. 133.El 134.Pp 135The 136.Nm 137driver no longer supports changing media via the link0/link1/link2 flags. 138.Pp 139You may specify the port and irq numbers that ISA cards are expected 140to be found at, but it is not necessary. 141The cards are sufficiently intelligent to tell us where they 142actually live on the ISA bus. 143.Sh NOTES 144Etherlink III cards have no jumpers to set the address. 1453Com supplies software to set the address of the card in software. 146To find the card on the ISA bus, the kernel performs a complex 147scan operation at IO address 0x100. 148Beware! 149Avoid placing other cards at that address! 150.Pp 151The 3Com configuration utilities can `autosense' the active media and 152save it as default. The saved default medium is the medium that 153was active atthe time the configuration utility was run. The 154.Nm 155driver does not yet re-autosense the active media at boot time. 156If the EEPROM autosense bit is set, the driver simply uses the media 157type sensed and saved when the configuration utility was run. 158.Sh DIAGNOSTICS 159.Bl -diag 160.It "ep0: reset (status: %x)" 161the driver has encountered a FIFO underrun or overrun. The driver will reset 162the card and the packet will be lost. This is not fatal. 163.It "ep0: eeprom failed to come ready" 164The eeprom failed to come ready. This probably means the card is wedged. 165.It "ep0: 3c509 in test mode. Erase pencil mark!" 166This means that someone has scribbled with pencil in the test area on the 167card. Erase the pencil mark and reboot. (This is not a joke). 168.El 169.Sh BUGS 170Support for autosensing the active media should be added to the driver. 171.Sh SEE ALSO 172.Xr ifconfig 8 , 173.Xr intro 4 , 174.Xr isa 4 , 175.Xr isapnp 4 , 176.Xr eisa 4 , 177.Xr pci 4 , 178.Xr pcmcia 4 179