196 lines
6.4 KiB
Groff
196 lines
6.4 KiB
Groff
.\" $NetBSD: ep.4,v 1.16 1997/04/27 09:43:05 jonathan Exp $
|
|
.\"
|
|
.\" Copyright (c) 1997 Jonathan Stone
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Copyright (c) 1994 Herb Peyerl
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgements:
|
|
.\" This product includes software developed by Herb Peyerl
|
|
.\" This product includes software developed by Jonathan Stone
|
|
.\" 3. The name of the author may not be used to endorse or promote products
|
|
.\" derived from this software without specific prior written permission
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
.\"
|
|
.Dd February 16, 1997
|
|
.Dt EP 4
|
|
.Os NetBSD
|
|
.Sh NAME
|
|
.Nm ep
|
|
.Nd Ethernet driver for 3Com Etherlink III (3c509, 3c579, 3c59x)
|
|
.Sh SYNOPSIS
|
|
.Cd "ep? at isa? port ? irq ?"
|
|
.Cd "ep* at isapnp?"
|
|
.Cd "ep* at eisa? slot ?"
|
|
.Cd "ep* at pci? dev ? function ?"
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm ep
|
|
device driver supports the 3Com Etherlink III family of cards on Alpha
|
|
and i386 CPUs. Supported Etherlink III cards include:
|
|
.Pp
|
|
.Bl -tag -width xxxxxx -offset indent
|
|
.It 3c509
|
|
ISA 10Mbit card, in BNC and multiport variants
|
|
.It 3c509B
|
|
ISA plug-and-play 10Mbit card, in BNC and multiport variants
|
|
.It 3c515
|
|
ISA 10Mbit and 10/100 card with busmastering capability (untested)
|
|
.It 3c579
|
|
EISA 10Mbit card, in BNC and muiltport variants
|
|
.It 3c592
|
|
EISA 10Mbit card with busmastering capability
|
|
.It 3c597
|
|
EISA 10/100Mbit card with busmastering capability
|
|
.It 3c590
|
|
PCI 10Mbit multiport card with busmastering capability
|
|
.It 3c595
|
|
PCI 10/100Mbit multiport card with busmastering capability
|
|
.It 3c900
|
|
PCI 10Mbit card in 10baseT and multiport variants
|
|
.It 3c905
|
|
PCI 10/100Mbit cards
|
|
.El
|
|
|
|
The
|
|
.Nm ep
|
|
driver also works with 3c589 PCMCIA cards, if pre-configured to
|
|
work as ISA devices. NetBSD does not include PCMCIA support at this time.
|
|
.Sh MEDIA SELECTION
|
|
Various models of these cards come with a different assortment of
|
|
media. Supported 10Mbit Ethernet media include:
|
|
.Pp
|
|
.Bl -tag -width xxxxxxxxxx -offset indent
|
|
.It AUI/DIX
|
|
Standard 15 pin connector
|
|
.It 10Base2
|
|
BNC, also known as thin-net
|
|
.It 10BaseT
|
|
UTP, also known as twisted pair
|
|
.El
|
|
.Pp
|
|
The 100Mbit cards each support exactly one of the following 100Mbit
|
|
standards:
|
|
.Pp
|
|
.Bl -tag -width xxxxxxxxxx -offset indent
|
|
.It 100baseTX
|
|
100Mbit over cat-5 UTP
|
|
.It 100baseT4
|
|
100Mbit over all four pairs of cat-3 UTP
|
|
.It 100baseFX
|
|
100Mbit over fiber
|
|
.It MII
|
|
MII connection to external 100Mbit PHY
|
|
.El
|
|
|
|
Note that the 100baseTX and 100baseT4 cards can also run as 10baseT.
|
|
.Pp
|
|
The
|
|
.Nm
|
|
driver defaults to using the port selected via the vendor-supplied
|
|
configuration utility.
|
|
To choose an alternate port,
|
|
use the following media flags with
|
|
.Xr ifconfig 8
|
|
or in your /etc/ifconfig.ep? file.
|
|
.Pp
|
|
.Bl -tag -width xxxxxxxxxx -offset indent
|
|
.It 10base2
|
|
Use the 10base-2 BNC port.
|
|
.It AUI
|
|
Use the AUI port.
|
|
.It 10baseT
|
|
Use the UTP port in 10base-T mode.
|
|
.It 100baseTX
|
|
Use the builtin 100base-Tx PHY on the UTP port.
|
|
.It 100baseFX
|
|
Use the builtin 100mbit fibre-optic PHY.
|
|
.It 100baseT4
|
|
Use the builtin 100base-T4 PHY on the UTP port.
|
|
.El
|
|
|
|
The
|
|
.Nm
|
|
driver no longer supports changing media via the link0/link1/link2 flags.
|
|
.Pp
|
|
If there are multiple cards in the computer, they are searched for
|
|
in the following order:
|
|
The 3c579 EISA cards are searched for first -- they will be found
|
|
in EISA slot# order.
|
|
Next, the 3c509 ISA cards are searched -- they are found in increasing
|
|
ethernet address order.
|
|
This is an example of how they will probe:
|
|
.Pp
|
|
ep0 at isa0 port 0x6000-0x600f irq 10: aui/bnc address 00:60:8c:70:e5:c5
|
|
ep1 at isa0 port 0x300-0x30f irq 3: aui/bnc/utp address 00:20:af:10:62:ab
|
|
.Pp
|
|
You may specify the port and irq numbers that ISA cards are expected
|
|
to be found at, but it is not necessary.
|
|
The cards are sufficiently intelligent to tell us where they
|
|
actually live on the ISA bus.
|
|
.Sh NOTES
|
|
Etherlink III cards have no jumpers to set the address.
|
|
3Com supplies software to set the address of the card in software.
|
|
To find the card on the ISA bus, the kernel performs a complex
|
|
scan operation at IO address 0x100.
|
|
Beware!
|
|
Avoid placing other cards at that address!
|
|
.Pp
|
|
The 3Com configuration utilities can `autosense' the active media and
|
|
save it as default. The saved default medium is the medium that
|
|
was active atthe time the configuration utility was run. The
|
|
.Nm ep
|
|
driver does not yet re-autosense the active media at boot time.
|
|
If the EEPROM autosense bit is set, the driver simply uses the media
|
|
type sensed and saved when the configuration utility was run.
|
|
.Sh DIAGNOSTICS
|
|
ep0: reset (status: %x)
|
|
.in +4
|
|
the driver has encountered a FIFO underrun or overrun. The driver will reset
|
|
the card and the packet will be lost. This is not fatal.
|
|
.in -4
|
|
ep0: eeprom failed to come ready
|
|
.in +4
|
|
The eeprom failed to come ready. This probably means the card is wedged.
|
|
.in -4
|
|
ep0: 3c509 in test mode. Erase pencil mark!
|
|
.in +4
|
|
This means that someone has scribbled with pencil in the test area on the
|
|
card. Erase the pencil mark and reboot. (This is not a joke).
|
|
.in -4
|
|
.Sh BUGS
|
|
Support for autosensing the active media should be added to the driver.
|
|
.Sh SEE ALSO
|
|
.Xr ifconfig 8 ,
|
|
.Xr intro 4 ,
|
|
.Xr isa 4 ,
|
|
.Xr isapnp 4 ,
|
|
.Xr eisa 4 ,
|
|
.Xr pci 4
|
|
.Xr ed 4 ,
|
|
.Xr eg 4 ,
|
|
.Xr el 4 ,
|
|
.Xr ie 4 .
|
|
.Sh STANDARDS
|
|
are great. There's so many to choose from.
|