xref: /openbsd/share/man/man4/aue.4 (revision 4bdff4be)
1.\"	$OpenBSD: aue.4,v 1.39 2022/02/17 12:24:08 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: February 17 2022 $
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.Cd "sqphy* at mii?"
47.Sh DESCRIPTION
48The
49.Nm
50driver provides support for USB Ethernet adapters based on the ADMtek
51AN986 ("Pegasus") and ADM8511 ("Pegasus II") chipsets.
52This includes the following adapters:
53.Pp
54.Bl -tag -width Ds -offset indent -compact
55.It Tn 3Com 3c460b
56.It Tn Abocom UFE1000
57.It Tn Abocom DSB650TX
58.It Tn Accton USB320-EC
59.It Tn Accton SpeedStream Ethernet
60.It Tn Admtek Pegasus
61.It Tn Admtek Pegasus II
62.It Tn AEI USB Fast Ethernet
63.It Tn Allied Telesyn AT-USB100
64.It Tn ATEN UC-110T
65.It Tn Belkin F5D5050
66.It Tn Billionton Systems USB100
67.It Tn Billionton Systems USB100EL
68.It Tn Billionton Systems USB100LP
69.It Tn Billionton Systems USBE100
70.It Tn Corega FEther USB-TX
71.It Tn Corega FEther USB-TXS
72.It Tn D-Link DSB-650
73.It Tn D-Link DSB-650TX
74.It Tn D-Link DSB-650TX-PNA
75.It Tn ELCON Systemtechnik Goldpfeil P-LAN
76.It Tn Elecom LD-USB/TX
77.It Tn Elecom LD-USB20
78.It Tn Elecom LD-USBL/TX
79.It Tn Elsa Microlink USB2Ethernet
80.It Tn GIGABYTE GN-BR402W
81.It Tn Hawking UF100
82.It Tn HP HN210E
83.It Tn I/O DATA USB ET/TX
84.It Tn I/O DATA USB ET/TX-S
85.It Tn I/O DATA ETX-US2
86.It Tn Kingston KNU101TX
87.It Tn Laneed LD-USBL/TX
88.It Tn Linksys USB100TX
89.It Tn Linksys USB100H1
90.It Tn Linksys USB10T
91.It Tn Linksys USB10TA
92.It Tn Linksys USB10TX
93.It Tn Logitec LAN-TX/U1H2
94.It Tn Melco Inc. LUA-TX
95.It Tn Melco Inc. LUA2-TX
96.It Tn Microsoft MN110
97.It Tn Mobility EasiDock Ethernet
98.It Tn Netgear FA101
99.It Tn Omnidirectional Control Technology USB TO Ethernet
100.It Tn Siemens SpeedStream USB
101.It Tn Smartbridges smartNIC 2
102.It Tn SMC 2202USB/ETH
103.It Tn SMC 2206USB/ETH
104.It Tn SOHOware NUB100
105.It Tn SOHOware NUB110
106.El
107.Pp
108The Pegasus family of chipsets contain a 10/100
109.Tn Ethernet
110MAC with an MII interface and are designed to work with both
111.Tn Ethernet
112and HomePNA transceivers.
113Although the chipsets are designed to interface with
114100Mbps peripherals, the USB 1.x standards specify a maximum
115transfer speed of 12Mbps.
116Users should therefore not expect to actually
117achieve 100Mbps speeds with these devices.
118.Pp
119The Pegasus chipsets support a 64-bit multicast hash table, single perfect
120filter entry for the station address and promiscuous mode.
121Packets are
122received and transmitted over separate USB bulk transfer endpoints.
123.Pp
124The
125.Nm
126driver supports the following media types:
127.Bl -tag -width tenletters
128.It autoselect
129Enable autoselection of the media type and options.
130The user can manually override
131the autoselected mode by adding media options to the appropriate
132.Xr hostname.if 5
133file.
134.It 10baseT
135Set 10Mbps operation.
136The
137.Ar mediaopt
138option can also be used to enable
139.Ar full-duplex
140operation.
141Not specifying
142.Ar full duplex
143implies
144.Ar half-duplex
145mode.
146.It 100baseTX
147Set 100Mbps (Fast
148.Tn Ethernet )
149operation.
150The
151.Ar mediaopt
152option can also be used to enable
153.Ar full-duplex
154operation.
155Not specifying
156.Ar full duplex
157implies
158.Ar half-duplex
159mode.
160.El
161.Pp
162The
163.Nm
164driver supports the following media options:
165.Bl -tag -width tenletters
166.It full-duplex
167Force full duplex operation.
168The interface will operate in
169half duplex mode if this media option is not specified.
170.El
171.Pp
172For more information on configuring this device, see
173.Xr ifconfig 8 .
174.Sh DIAGNOSTICS
175.Bl -diag
176.It "aue0: watchdog timeout"
177A packet was queued for transmission and a transmit command was
178issued, however the device failed to acknowledge the transmission
179before a timeout expired.
180.It "aue0: no memory for rx list"
181The driver failed to allocate an mbuf for the receiver ring.
182.El
183.Sh SEE ALSO
184.Xr acphy 4 ,
185.Xr arp 4 ,
186.Xr bmtphy 4 ,
187.Xr ifmedia 4 ,
188.Xr intro 4 ,
189.Xr netintro 4 ,
190.Xr sqphy 4 ,
191.Xr usb 4 ,
192.Xr hostname.if 5 ,
193.Xr ifconfig 8
194.Rs
195.%T ADMtek AN986 and ADM8511 data sheets
196.Re
197.Sh HISTORY
198The
199.Nm
200device driver first appeared in
201.Fx 4.0 .
202.Ox
203support was added in
204.Ox 2.7 .
205.Sh AUTHORS
206.An -nosplit
207The
208.Nm
209driver was written by
210.An Bill Paul Aq Mt wpaul@ee.columbia.edu
211and ported to
212.Ox
213by
214.An Aaron Campbell Aq Mt aaron@openbsd.org .
215