xref: /netbsd-src/share/man/man4/aue.4 (revision 6cf6fe02a981b55727c49c3d37b0d8191a98c0ee)
1.\"	$NetBSD: aue.4,v 1.20 2010/09/25 22:14:07 wiz 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 September 25, 2010
36.Dt AUE 4
37.Os
38.Sh NAME
39.Nm aue
40.Nd ADMtek AN986 and AN8511 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 @Home USB 10/100
51.It Tn Abocom DSB650TX
52.It Tn Billionton Systems USB100
53.It Tn Compaq HNE-200
54.It Tn Corega FEther USB-TX
55.It Tn Corega FEther USB-TXS
56.It Tn D-Link DSB-650
57.It Tn D-Link DSB-650TX
58.It Tn D-Link DSB-650TX-PNA
59.It Tn I/O DATA USB ET/TX
60.It Tn I/O DATA USB ET/TXS
61.It Tn I/O DATA ETX-US2
62.It Tn Hawking UF100
63.It Tn Kingston KNU101TX
64.It Tn LinkSys USB100TX
65.It Tn LinkSys USB100H1
66.It Tn LinkSys USB10TA
67.It Tn Melco Inc. LU-ATX
68.It Tn Microsoft MN110
69.It Tn SOHOware NUB100
70.It Tn SMC 2202USB
71.It Tn SMC 2206USB/ETH
72.El
73.Sh DESCRIPTION
74The
75.Nm
76driver provides support for USB
77.Tn Ethernet
78adapters based on the ADMtek AN986 Pegasus and AN8511 Pegasus II chipsets.
79.Pp
80The Pegasus contains a 10/100
81.Tn Ethernet
82MAC with MII interface and is designed to work with both
83.Tn Ethernet
84and HomePNA transceivers.
85Although designed to interface with 100Mbps peripherals, the existing
86USB standard specifies a maximum transfer speed of 12Mbps.
87Users should therefore not expect to actually
88achieve 100Mbps speeds with these devices.
89.Pp
90The Pegasus supports a 64-bit multicast hash table, single perfect
91filter entry for the station address and promiscuous mode.
92Packets are
93received and transmitted over separate USB bulk transfer endpoints.
94.Pp
95The
96.Nm
97driver supports the following media types:
98.Pp
99.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
100.It autoselect
101Enable automatic selection of the media type and options.
102The user can manually override the automatically selected mode by
103adding media options to the
104.Pa /etc/rc.conf
105file.
106.It 10baseT/UTP
107Set 10Mbps operation.
108The
109.Ar mediaopt
110option can also be used to enable
111.Ar full-duplex
112operation.
113Not specifying
114.Ar full duplex
115implies
116.Ar half-duplex
117mode.
118.It 100baseTX
119Set 100Mbps (fast
120.Tn Ethernet )
121operation.
122The
123.Ar mediaopt
124option can also be used to enable
125.Ar full-duplex
126operation.
127Not specifying
128.Ar full duplex
129implies
130.Ar half-duplex
131mode.
132.El
133.Pp
134The
135.Nm
136driver supports the following media options:
137.Pp
138.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
139.It full-duplex
140Force full duplex operation.
141The interface will operate in half duplex mode
142if this media option is not specified.
143.El
144.Pp
145For more information on configuring this device, see
146.Xr ifconfig 8 .
147.Sh DIAGNOSTICS
148.Bl -diag
149.It "aue%d: watchdog timeout"
150A packet was queued for transmission and a transmit command was
151issued, however the device failed to acknowledge the transmission
152before a timeout expired.
153.It "aue%d: no memory for rx list"
154The driver failed to allocate an mbuf for the receiver ring.
155.El
156.Sh SEE ALSO
157.Xr arp 4 ,
158.Xr netintro 4 ,
159.Xr usb 4 ,
160.Xr ifconfig 8
161.Rs
162.%T ADMtek AN986 data sheet
163.%U http://www.admtek.com.tw
164.Re
165.Sh HISTORY
166The
167.Nm
168device driver first appeared in
169.Fx 4.0 ,
170and in
171.Nx 1.5 .
172.Sh AUTHORS
173The
174.Nm
175driver was written by
176.An Bill Paul
177.Aq wpaul@ee.columbia.edu .
178