xref: /netbsd-src/share/man/man4/axe.4 (revision 946379e7b37692fc43f68eb0d1c10daa0a7f3b6c)
1.\" $NetBSD: axe.4,v 1.8 2010/06/23 21:03:16 wiz Exp $
2.\"
3.\" Copyright (c) 2003-2004 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Lennart Augustsson.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE.
29.\"
30.\" Copyright (c) 1997, 1998, 1999, 2000-2003
31.\"     Bill Paul <wpaul@windriver.com>. All rights reserved.
32.\"
33.\" Redistribution and use in source and binary forms, with or without
34.\" modification, are permitted provided that the following conditions
35.\" are met:
36.\" 1. Redistributions of source code must retain the above copyright
37.\"    notice, this list of conditions and the following disclaimer.
38.\" 2. Redistributions in binary form must reproduce the above copyright
39.\"    notice, this list of conditions and the following disclaimer in the
40.\"    documentation and/or other materials provided with the distribution.
41.\" 3. All advertising materials mentioning features or use of this software
42.\"    must display the following acknowledgement:
43.\"     This product includes software developed by Bill Paul.
44.\" 4. Neither the name of the author nor the names of any co-contributors
45.\"    may be used to endorse or promote products derived from this software
46.\"   without specific prior written permission.
47.\"
48.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
49.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
50.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
51.\" ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
52.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
53.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
54.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
55.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
56.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
57.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
58.\" THE POSSIBILITY OF SUCH DAMAGE.
59.\"
60.\" $FreeBSD: /repoman/r/ncvs/src/share/man/man4/axe.4,v 1.3 2003/05/29 21:28:35 ru Exp $
61.\" $OpenBSD: axe.4,v 1.37 2009/11/08 20:25:29 jasper Exp $
62.\"
63.Dd June 23, 2010
64.Dt AXE 4
65.Os
66.Sh NAME
67.Nm axe
68.Nd ASIX Electronics AX88172/AX88178/AX88772 10/100/Gigabit USB Ethernet device
69.Sh SYNOPSIS
70.Cd "axe*   at uhub?"
71.Cd "XXphy* at mii?"
72.Sh HARDWARE
73The
74.Nm
75driver supports the following adapters:
76.Pp
77.Bl -tag -width Dv -offset indent -compact
78.It Apple USB Ethernet Adapter A1277
79.It ATEN UC-210T
80.It BAFO BF-320
81.It Billionton Systems USB2AR
82.It Buffalo(MELCO) LUA-U2-GT
83.It Buffalo(MELCO) LUA-U2-KTX
84.It Corega FEther USB2-TX
85.It D-Link DUB-E100
86.It Good Way GWUSB2E
87.It Hawking UF200
88.It Intellinet USB 2.0 to Ethernet (rev A)
89.It IO-Data ETG-US2
90.It JVC MP-PRX1
91.It Konig CMP-NWUSB20
92.It Level One USB-0200
93.It Linksys USB200M
94.It Linksys USB1000
95.It Logitec LAN-GTJ/U2
96.It Netgear FA120
97.It Nintendo Wii USB Lan Ethernet Adapter RVL-015
98.It OQO model 01+ Ethernet
99.It Sitecom LN-029
100.It SMC 2209USB/ETH
101.It SnapPort USB 2.0 LAN Adapter
102.It ST Lab USB 2.0 Fast Ethernet
103.It Surecom EP-1427X-2
104.It System TALKS SGC-X2UL
105.It TRENDnet TU2-ET100
106.It Z-TEK ZK-R01-2
107.El
108.Sh DESCRIPTION
109The
110.Nm
111driver provides support for USB
112.Tn Ethernet
113adapters based on the ASIX Electronics AX88172, AX88178, and AX88772
114USB 2.0 chipsets.
115.Pp
116The chip contains a 10/100
117.Tn Ethernet
118MAC with MII interface and is designed to work with both
119.Tn Ethernet
120and HomePNA transceivers.
121The AX8172 and AX88772 contain 10/100 Ethernet MACs with MII interfaces.
122The AX8178 contains a 10/100/1000 Gigabit
123.Tn Ethernet
124MAC with a GMII/MII interface.
125The chip also supports USB 2.0, thereby accommodating 100 Mb/s data rates.
126.Pp
127The
128.Nm
129driver supports the following media types:
130.Pp
131.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
132.It autoselect
133Enable automatic selection of the media type and options.
134.It 10baseT/UTP
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.It 1000baseT
161Set 1000Mbps (Gigabit
162.Tn Ethernet )
163operation (AX88178 only).
164.El
165.Pp
166The
167.Nm
168driver supports the following media options:
169.Pp
170.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
171.It full-duplex
172Force full duplex operation.
173The interface will operate in half duplex mode
174if this media option is not specified.
175.El
176.Pp
177For more information on configuring this device, see
178.Xr ifconfig 8 .
179.Sh SEE ALSO
180.Xr arp 4 ,
181.Xr ifmedia 4 ,
182.Xr netintro 4 ,
183.Xr usb 4 ,
184.Xr ifconfig 8
185.Rs
186.%T ASIX AX88172 data sheet
187.%U http://www.asix.com.tw
188.Re
189.Sh HISTORY
190The
191.Nm
192device driver first appeared in
193.Fx
194and was ported to
195.Nx 3.0 .
196It replaces the
197.Nx
198uax driver.
199