xref: /openbsd/share/man/man4/aue.4 (revision 771fbea0)
1.\"	$OpenBSD: aue.4,v 1.37 2013/11/17 13:57:03 jsg 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 17 2013 $
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 ET/TX
83.It Tn I/O DATA USB ET/TX-S
84.It Tn I/O DATA ETX-US2
85.It Tn Kingston KNU101TX
86.It Tn Laneed LD-USBL/TX
87.It Tn Linksys USB100TX
88.It Tn Linksys USB100H1
89.It Tn Linksys USB10T
90.It Tn Linksys USB10TA
91.It Tn Linksys USB10TX
92.It Tn Logitec LAN-TX/U1H2
93.It Tn Melco Inc. LUA-TX
94.It Tn Melco Inc. LUA2-TX
95.It Tn Microsoft MN110
96.It Tn Mobility EasiDock Ethernet
97.It Tn Netgear FA101
98.It Tn Omnidirectional Control Technology USB TO Ethernet
99.It Tn Siemens SpeedStream USB
100.It Tn Smartbridges smartNIC 2
101.It Tn SMC 2202USB/ETH
102.It Tn SMC 2206USB/ETH
103.It Tn SOHOware NUB100
104.It Tn SOHOware NUB110
105.El
106.Pp
107The Pegasus family of chipsets contain a 10/100
108.Tn Ethernet
109MAC with an MII interface and are designed to work with both
110.Tn Ethernet
111and HomePNA transceivers.
112Although the chipsets are designed to interface with
113100Mbps peripherals, the USB 1.x standards specify a maximum
114transfer speed of 12Mbps.
115Users should therefore not expect to actually
116achieve 100Mbps speeds with these devices.
117.Pp
118The Pegasus chipsets support a 64-bit multicast hash table, single perfect
119filter entry for the station address and promiscuous mode.
120Packets are
121received and transmitted over separate USB bulk transfer endpoints.
122.Pp
123The
124.Nm
125driver supports the following media types:
126.Bl -tag -width tenletters
127.It autoselect
128Enable autoselection of the media type and options.
129The user can manually override
130the autoselected mode by adding media options to the appropriate
131.Xr hostname.if 5
132file.
133.It 10baseT
134Set 10Mbps operation.
135The
136.Ar mediaopt
137option can also be used to enable
138.Ar full-duplex
139operation.
140Not specifying
141.Ar full duplex
142implies
143.Ar half-duplex
144mode.
145.It 100baseTX
146Set 100Mbps (Fast
147.Tn Ethernet )
148operation.
149The
150.Ar mediaopt
151option can also be used to enable
152.Ar full-duplex
153operation.
154Not specifying
155.Ar full duplex
156implies
157.Ar half-duplex
158mode.
159.El
160.Pp
161The
162.Nm
163driver supports the following media options:
164.Bl -tag -width tenletters
165.It full-duplex
166Force full duplex operation.
167The interface will operate in
168half duplex mode if this media option is not specified.
169.El
170.Pp
171For more information on configuring this device, see
172.Xr ifconfig 8 .
173.Sh DIAGNOSTICS
174.Bl -diag
175.It "aue0: watchdog timeout"
176A packet was queued for transmission and a transmit command was
177issued, however the device failed to acknowledge the transmission
178before a timeout expired.
179.It "aue0: no memory for rx list"
180The driver failed to allocate an mbuf for the receiver ring.
181.El
182.Sh SEE ALSO
183.Xr acphy 4 ,
184.Xr arp 4 ,
185.Xr bmtphy 4 ,
186.Xr ifmedia 4 ,
187.Xr intro 4 ,
188.Xr netintro 4 ,
189.Xr usb 4 ,
190.Xr hostname.if 5 ,
191.Xr ifconfig 8
192.Rs
193.%T ADMtek AN986 and ADM8511 data sheets
194.%U http://www.admtek.com.tw
195.Re
196.Sh HISTORY
197The
198.Nm
199device driver first appeared in
200.Fx 4.0 .
201.Ox
202support was added in
203.Ox 2.7 .
204.Sh AUTHORS
205.An -nosplit
206The
207.Nm
208driver was written by
209.An Bill Paul Aq Mt wpaul@ee.columbia.edu
210and ported to
211.Ox
212by
213.An Aaron Campbell Aq Mt aaron@openbsd.org .
214