xref: /netbsd-src/share/man/man4/aue.4 (revision 386e0403d4814a97e906d9575cacaeb797a3789c)
1.\"	$NetBSD: aue.4,v 1.23 2019/08/30 09:24:19 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 August 24, 2019
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.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
99.It autoselect
100Enable automatic selection of the media type and options.
101The user can manually override the automatically selected mode by
102adding media options to the
103.Pa /etc/rc.conf
104file.
105.It 10baseT/UTP
106Set 10Mbps operation.
107The
108.Ar mediaopt
109option can also be used to enable
110.Ar full-duplex
111operation.
112Not specifying
113.Ar full duplex
114implies
115.Ar half-duplex
116mode.
117.It 100baseTX
118Set 100Mbps (fast
119.Tn Ethernet )
120operation.
121The
122.Ar mediaopt
123option can also be used to enable
124.Ar full-duplex
125operation.
126Not specifying
127.Ar full duplex
128implies
129.Ar half-duplex
130mode.
131.El
132.Pp
133The
134.Nm
135driver supports the following media options:
136.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
137.It full-duplex
138Force full duplex operation.
139The interface will operate in half duplex mode
140if this media option is not specified.
141.El
142.Pp
143For more information on configuring this device, see
144.Xr ifconfig 8 .
145.Sh DIAGNOSTICS
146See
147.Xr usbnet 4
148for diagnostics.
149.Sh SEE ALSO
150.Xr arp 4 ,
151.Xr netintro 4 ,
152.Xr usb 4 ,
153.Xr usbnet 4 ,
154.Xr ifconfig 8
155.Rs
156.%T ADMtek AN986 data sheet
157.%U http://www.admtek.com.tw
158.Re
159.Sh HISTORY
160The
161.Nm
162device driver first appeared in
163.Fx 4.0 ,
164and in
165.Nx 1.5 .
166.Sh AUTHORS
167The
168.Nm
169driver was written by
170.An Bill Paul
171.Aq wpaul@ee.columbia.edu .
172