xref: /netbsd/share/man/man4/aue.4 (revision 8bd7cb6a)
1.\"	$NetBSD: aue.4,v 1.8 2002/02/07 03:15:08 ross Exp $
2.\"
3.\" Copyright (c) 1997, 1998, 1999
4.\"     Bill Paul <wpaul@ee.columbia.edu>. 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 Bill Paul.
17.\" 4. Neither the name of the author nor the names of any co-contributors
18.\"    may be used to endorse or promote products derived from this software
19.\"   without specific prior written permission.
20.\"
21.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
22.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24.\" ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
25.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
31.\" THE POSSIBILITY OF SUCH DAMAGE.
32.\"
33.\" FreeBSD: src/share/man/man4/aue.4,v 1.2 2000/01/07 22:18:47 wpaul Exp
34.\"
35.Dd December 25, 1999
36.Dt AUE 4
37.Os
38.Sh NAME
39.Nm aue
40.Nd ADMtek AN986 Pegasus USB Ethernet driver
41.Sh SYNOPSIS
42.Cd "aue*   at uhub?"
43.Cd "ukphy* at mii?"
44.Sh HARDWARE
45The
46.Nm
47driver supports the following adapters:
48.Pp
49.Bl -tag -width Dv -offset indent -compact
50.It Tn Abocom DSB650TX
51.It Tn Billionton Systems USB100
52.It Tn Corega FEther USB-TX
53.It Tn D-Link DSB-650
54.It Tn D-Link DSB-650TX
55.It Tn D-Link DSB-650TX-PNA
56.It Tn I/O DATA USB ETTX
57.It Tn Kingston KNU101TX
58.It Tn LinkSys USB100TX
59.It Tn LinkSys USB100H1
60.It Tn LinkSys USB10TA
61.It Tn Melco Inc. LU-ATX
62.It Tn SOHOware NUB100
63.It Tn SMC 2202USB
64.El
65.Sh DESCRIPTION
66The
67.Nm
68driver provides support for USB
69.Tn Ethernet
70adapters based on the ADMtek AN986 Pegasus chipset.
71.Pp
72The Pegasus contains a 10/100
73.Tn Ethernet
74MAC with MII interface and is designed to work with both
75.Tn Ethernet
76and HomePNA transceivers.  Although designed to interface with
77100Mbps peripherals, the existing USB standard specifies a maximum
78transfer speed of 12Mbps.  Users should therefore not expect to actually
79achieve 100Mbps speeds with these devices.
80.Pp
81The Pegasus supports a 64-bit multicast hash table, single perfect
82filter entry for the station address and promiscuous mode.  Packets are
83received and transmitted over separate USB bulk transfer endpoints.
84.Pp
85The
86.Nm
87driver supports the following media types:
88.Pp
89.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
90.It autoselect
91Enable automatic selection of the media type and options.  The user can
92manually override the automatically selected mode by adding media options to
93the
94.Pa /etc/rc.conf
95file.
96.It 10baseT/UTP
97Set 10Mbps operation.  The
98.Ar mediaopt
99option can also be used to enable
100.Ar full-duplex
101operation.  Not specifying
102.Ar full duplex
103implies
104.Ar half-duplex
105mode.
106.It 100baseTX
107Set 100Mbps (fast
108.Tn Ethernet )
109operation.  The
110.Ar mediaopt
111option can also be used to enable
112.Ar full-duplex
113operation.  Not specifying
114.Ar full duplex
115implies
116.Ar half-duplex
117mode.
118.El
119.Pp
120The
121.Nm
122driver supports the following media options:
123.Pp
124.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
125.It full-duplex
126Force full duplex operation.  The interface will operate in half duplex mode
127if this media option is not specified.
128.El
129.Pp
130For more information on configuring this device, see
131.Xr ifconfig 8 .
132.Sh DIAGNOSTICS
133.Bl -diag
134.It "aue%d: watchdog timeout"
135A packet was queued for transmission and a transmit command was
136issued, however the device failed to acknowledge the transmission
137before a timeout expired.
138.It "aue%d: no memory for rx list"
139The driver failed to allocate an mbuf for the receiver ring.
140.El
141.Sh SEE ALSO
142.Xr arp 4 ,
143.Xr netintro 4 ,
144.Xr usb 4 ,
145.Xr ifconfig 8
146.Rs
147.%T ADMtek AN986 data sheet
148.%O http://www.admtek.com.tw
149.Re
150.Sh HISTORY
151The
152.Nm
153device driver first appeared in
154.Fx 4.0 ,
155and in
156.Nx 1.5 .
157.Sh AUTHORS
158The
159.Nm
160driver was written by
161.An Bill Paul
162.Aq wpaul@ee.columbia.edu .
163