xref: /openbsd/share/man/man4/aue.4 (revision e0d40974)
1.\"	$OpenBSD: aue.4,v 1.33 2007/11/10 22:58:24 deraadt Exp $
2.\"	$NetBSD: aue.4,v 1.9 2002/07/11 00:23:31 rh Exp $
3.\"
4.\" Copyright (c) 1997, 1998, 1999
5.\"     Bill Paul <wpaul@ee.columbia.edu>. All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\" 3. All advertising materials mentioning features or use of this software
16.\"    must display the following acknowledgement:
17.\"     This product includes software developed by Bill Paul.
18.\" 4. Neither the name of the author nor the names of any co-contributors
19.\"    may be used to endorse or promote products derived from this software
20.\"   without specific prior written permission.
21.\"
22.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25.\" ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
26.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
27.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
28.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
29.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
30.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
31.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
32.\" THE POSSIBILITY OF SUCH DAMAGE.
33.\"
34.\" $FreeBSD: src/share/man/man4/aue.4,v 1.2 2000/01/07 22:18:47 wpaul Exp $
35.\"
36.Dd $Mdocdate: November 10 2007 $
37.Dt AUE 4
38.Os
39.Sh NAME
40.Nm aue
41.Nd ADMtek AN986/ADM8511 Pegasus family 10/100 USB Ethernet device
42.Sh SYNOPSIS
43.Cd "aue* at uhub?"
44.Cd "acphy* at mii?"
45.Cd "bmtphy* at mii?"
46.Sh DESCRIPTION
47The
48.Nm
49driver provides support for USB Ethernet adapters based on the ADMtek
50AN986 ("Pegasus") and ADM8511 ("Pegasus II") chipsets.
51This includes the following adapters:
52.Pp
53.Bl -tag -width Ds -offset indent -compact
54.It Tn 3Com 3c460b
55.It Tn Abocom UFE1000
56.It Tn Abocom DSB650TX
57.It Tn Accton USB320-EC
58.It Tn Accton SpeedStream Ethernet
59.It Tn Admtek Pegasus
60.It Tn Admtek Pegasus II
61.It Tn AEI USB Fast Ethernet
62.It Tn Allied Telesyn AT-USB100
63.It Tn ATEN UC-110T
64.It Tn Belkin F5D5050
65.It Tn Billionton Systems USB100
66.It Tn Billionton Systems USB100EL
67.It Tn Billionton Systems USB100LP
68.It Tn Billionton Systems USBE100
69.It Tn Corega FEther USB-TX
70.It Tn Corega FEther USB-TXS
71.It Tn D-Link DSB-650
72.It Tn D-Link DSB-650TX
73.It Tn D-Link DSB-650TX-PNA
74.It Tn ELCON Systemtechnik Goldpfeil P-LAN
75.It Tn Elecom LD-USB/TX
76.It Tn Elecom LD-USB20
77.It Tn Elecom LD-USBL/TX
78.It Tn Elsa Microlink USB2Ethernet
79.It Tn GIGABYTE GN-BR402W
80.It Tn Hawking UF100
81.It Tn HP HN210E
82.It Tn I/O DATA USB ETTX
83.It Tn Kingston KNU101TX
84.It Tn Laneed LD-USBL/TX
85.It Tn Linksys USB100TX
86.It Tn Linksys USB100H1
87.It Tn Linksys USB10T
88.It Tn Linksys USB10TA
89.It Tn Linksys USB10TX
90.It Tn Logitec LAN-TX/U1H2
91.It Tn Melco Inc. LUA-TX
92.It Tn Melco Inc. LUA2-TX
93.It Tn Microsoft MN110
94.It Tn Mobility EasiDock Ethernet
95.It Tn Netgear FA101
96.It Tn Omnidirectional Control Technology USB TO Ethernet
97.It Tn Siemens SpeedStream USB
98.It Tn Smartbridges smartNIC 2
99.It Tn SMC 2202USB/ETH
100.It Tn SMC 2206USB/ETH
101.It Tn SOHOware NUB100
102.It Tn SOHOware NUB110
103.El
104.Pp
105The Pegasus family of chipsets contain a 10/100
106.Tn Ethernet
107MAC with an MII interface and are designed to work with both
108.Tn Ethernet
109and HomePNA transceivers.
110Although the chipsets are designed to interface with
111100Mbps peripherals, the USB 1.x standards specify a maximum
112transfer speed of 12Mbps.
113Users should therefore not expect to actually
114achieve 100Mbps speeds with these devices.
115.Pp
116The Pegasus chipsets support a 64-bit multicast hash table, single perfect
117filter entry for the station address and promiscuous mode.
118Packets are
119received and transmitted over separate USB bulk transfer endpoints.
120.Pp
121The
122.Nm
123driver supports the following media types:
124.Bl -tag -width tenletters
125.It autoselect
126Enable autoselection of the media type and options.
127The user can manually override
128the autoselected mode by adding media options to the appropriate
129.Xr hostname.if 5
130file.
131.It 10baseT
132Set 10Mbps operation.
133The
134.Ar mediaopt
135option can also be used to enable
136.Ar full-duplex
137operation.
138Not specifying
139.Ar full duplex
140implies
141.Ar half-duplex
142mode.
143.It 100baseTX
144Set 100Mbps (Fast
145.Tn Ethernet )
146operation.
147The
148.Ar mediaopt
149option can also be used to enable
150.Ar full-duplex
151operation.
152Not specifying
153.Ar full duplex
154implies
155.Ar half-duplex
156mode.
157.El
158.Pp
159The
160.Nm
161driver supports the following media options:
162.Bl -tag -width tenletters
163.It full-duplex
164Force full duplex operation.
165The interface will operate in
166half duplex mode if this media option is not specified.
167.El
168.Pp
169For more information on configuring this device, see
170.Xr ifconfig 8 .
171.Sh DIAGNOSTICS
172.Bl -diag
173.It "aue%d: watchdog timeout"
174A packet was queued for transmission and a transmit command was
175issued, however the device failed to acknowledge the transmission
176before a timeout expired.
177.It "aue%d: no memory for rx list"
178The driver failed to allocate an mbuf for the receiver ring.
179.El
180.Sh SEE ALSO
181.Xr acphy 4 ,
182.Xr arp 4 ,
183.Xr bmtphy 4 ,
184.Xr ifmedia 4 ,
185.Xr intro 4 ,
186.Xr netintro 4 ,
187.Xr usb 4 ,
188.Xr hostname.if 5 ,
189.Xr ifconfig 8
190.Rs
191.%T ADMtek AN986 and ADM8511 data sheets
192.%O http://www.admtek.com.tw
193.Re
194.Sh HISTORY
195The
196.Nm
197device driver first appeared in
198.Fx 4.0 .
199.Ox
200support was added in
201.Ox 2.7 .
202.Sh AUTHORS
203.An -nosplit
204The
205.Nm
206driver was written by
207.An Bill Paul Aq wpaul@ee.columbia.edu
208and ported to
209.Ox
210by
211.An Aaron Campbell Aq aaron@openbsd.org .
212