1.\" $NetBSD: ep.4,v 1.15 1997/04/10 06:36:28 jeremy 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 February 16, 1997 36.Dt EP 4 37.Os NetBSD 38.Sh NAME 39.Nm ep 40.Nd Ethernet driver for 3Com Etherlink III (3c509, 3c579, 3c59x) 41.Sh SYNOPSIS 42.Cd "ep? at isa? port ? irq ?" 43.Cd "ep* at isapnp?" 44.Cd "ep* at eisa? slot ?" 45.Cd "ep* at pci? dev ? function ?" 46.Sh DESCRIPTION 47The 48.Nm ep 49device driver supports the 3Com Etherlink III family of cards on Alpha 50and i386 CPUs. Supported Etherlink III cards include: 51.Pp 52.Bl -tag -width xxxxxx 53.It 3c509 54ISA 10Mbit card, in BNC and multiport variants 55.It 3c509B 56ISA plug-and-play 10Mbit card, in BNC and multiport variants 57.It 3c515 58ISA 10Mbit and 10/100 card with busmastering capability (untested) 59.It 3c579 60EISA 10Mbit card, in BNC and muiltport variants 61.It 3c592 62EISA 10Mbit card with busmastering capability 63.It 3c597 64EISA 10/100Mbit card with busmastering capability 65.It 3c590 66PCI 10Mbit multiport card with busmastering capability 67.It 3c595 68PCI 10/100Mbit multiport card with busmastering capability 69.It 3c900 70PCI 10Mbit card in UTP and multiport variants 71.It 3c905 72PCI 10/100Mbit cards 73.El 74 75The 76.Nm ep 77driver provides full support for the 10Mbit-only cards. 78Due to limitations in 79.Xr ifconfig 8 , 80the 81.Nm ep 82driver does not provide full support for selecting and switching 83media on the 10/100 cards. (In all other respects, the 84.Nm ep 85driver supports the 10/100 cards as completely as the 10Mbit cards.) 86The 87.Nm ep 88driver also works with 3c589 PCMCIA cards, if pre-configured to 89work as ISA devices. NetBSD does not include PCMCIA support at this time. 90.Sh 10MBIT MEDIA SELECTION 91Various models of these cards come with a different assortment of 92media. Supported 10Mbit Ethernet media include: 93.Pp 94.Bl -tag -width xxxxxxxxxxxxxxxx 95.It AUI/DIX 96Standard 15 pin connector 97.It 10Base2 98BNC, also known as thin-net 99.It 10BaseT 100UTP, also known as twisted pair 101.El 102.Pp 103The 104.Nm 105driver defaults to using the BNC port. 106To choose an alternative port, 107use the following media flags with 108.Xr ifconfig 8 109or in your /etc/ifconfig.ep? file. 110.Pp 111.Bl -tag -width xxxxxxxxxxxxxxxx 112.It 10base2/BNC 113Use the BNC port (default). 114.It 10base5/AUI 115Use the AUI port. 116.It 10baseT/UTP 117Use the UTP port. 118.El 119.Pp 120If there are multiple cards in the computer, they are searched for 121in the following order: 122The 3c579 EISA cards are searched for first -- they will be found 123in EISA slot# order. 124Next, the 3c509 ISA cards are searched -- they are found in increasing 125ethernet address order. 126This is an example of how they will probe: 127.Pp 128ep0 at isa0 port 0x6000-0x600f irq 10: aui/bnc address 00:60:8c:70:e5:c5 129ep1 at isa0 port 0x300-0x30f irq 3: aui/bnc/utp address 00:20:af:10:62:ab 130.Pp 131You may specify the port and irq numbers that the cards are expected 132to be found at, but it is not necessary. 133The cards are sufficiently intelligent to tell us where they 134actually live on the ISA bus. 135.Pp 136Some models of 3c5x9 have all three connectors on them. 137In the case of these cards; you must configure the transceiver type 138with the 3Com supplied DOS configuration disk before the link0/link1 139flags will operate correctly. (This is a bug). 140.Pp 141.Sh 100MBIT MEDIA SELECTION 142Supported 100Mbit Ethernet media include: 143.Pp 144.Bl -tag -width xxxxxxxxxxxxxxxx 145.It 100baseTX 146100Mbit Ethernet over Cat-5 unshielded twisted pair 147.It 100baseFX 148100Mbit Ethernet over fibre-optic media 149.It 100baseT4 150100Mbit Ethernet over all four pairs of Cat-3 UTP 151.It MII 152Media Independent Interface connector. 153.El 154.Pp 155.Xr ifconfig 8 156does not properly support selecting 100Mbit media. To 157change media, you must configure the desired media with the 3Com 158supplied DOS configuration disk before booting or installing NetBSD. 159Set the media you want to use as the default in the config utility. 160 161Even then, the link0/link1 flags will have no effect on 100Mbit cards. 162.Sh NOTES 163The 3c509 card has no jumpers to set the address. 1643Com supplies software to set the address of the card in software. 165To find the card on the ISA bus, the kernel performs a complex 166scan operation at IO address 0x100. 167Beware! 168Avoid placing other cards at that address! 169.Pp 170The 3Com configuration utilities can `autosense' the active media and 171save it as default. The saved default medium is the media active at 172the time the configuration utility was run. The 173.Nm ep 174driver does not yet re-autosense the active media at boot time; 175it simply uses the media type sensed and saved when the configuration 176utility was run. 177.Sh DIAGNOSTICS 178ep0: reset (status: %x) 179.in +4 180the driver has encountered a FIFO underrun or overrun. The driver will reset 181the card and the packet will be lost. This is not fatal. 182.in -4 183ep0: eeprom failed to come ready 184.in +4 185The eeprom failed to come ready. This probably means the card is wedged. 186.in -4 187ep0: 3c509 in test mode. Erase pencil mark! 188.in +4 189This means that someone has scribbled with pencil in the test area on the 190card. Erase the pencil mark and reboot. (This is not a joke). 191.in -4 192.Sh BUGS 193.Xr ifconfig 8 194and the link0/link1/link2 interface flags need to be extended to handle 195the four additional media types available with Fast (100Mbit) 196Ethernet. 197The requirement to pre-configure combo cards should be removed. 198Support for autosensing the active media should be added to the driver. 199.Sh SEE ALSO 200.Xr ifconfig 8 , 201.Xr intro 4 , 202.Xr ed 4 , 203.Xr eg 4 , 204.Xr el 4 , 205.Xr ie 4 , 206.Xr le 4 207.Sh STANDARDS 208are great. There's so many to choose from. 209