xref: /netbsd-src/share/man/man4/axe.4 (revision bdc22b2e01993381dcefeff2bc9b56ca75a4235c)
1.\" $NetBSD: axe.4,v 1.13 2017/01/21 09:53:29 skrll 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 December 19, 2016
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 Buffalo(MELCO) LUA3-U2-ATX
85.It Corega FEther USB2-TX
86.It D-Link DUB-E100
87.It Good Way GWUSB2E
88.It Hawking UF200
89.It Intellinet USB 2.0 to Ethernet (rev A)
90.It IO-Data ETG-US2
91.It JVC MP-PRX1
92.It Konig CMP-NWUSB20
93.It Level One USB-0200
94.It Linksys USB200M
95.It Linksys USB1000
96.It Logitec LAN-GTJ/U2
97.It Logitec LAN-TXU2C
98.It Logitec LAN-TXU2H3A
99.It Netgear FA120
100.It Nintendo Wii USB Lan Ethernet Adapter RVL-015
101.It OQO model 01+ Ethernet
102.It Planex UE-200TX-G
103.It Sitecom LN-029
104.It SMC 2209USB/ETH
105.It SnapPort USB 2.0 LAN Adapter
106.It ST Lab USB 2.0 Fast Ethernet
107.It Surecom EP-1427X-2
108.It System TALKS SGC-X2UL
109.It TRENDnet TU2-ET100
110.It Z-TEK ZK-R01-2
111.El
112.Sh DESCRIPTION
113The
114.Nm
115driver provides support for USB
116.Tn Ethernet
117adapters based on the ASIX Electronics AX88172, AX88178, AX88772, AX88772A,
118AX88772B USB 2.0 chipsets.
119.Pp
120The chip contains a 10/100
121.Tn Ethernet
122MAC with MII interface and is designed to work with both
123.Tn Ethernet
124and HomePNA transceivers.
125The AX88172 and AX88772 contain 10/100 Ethernet MACs with MII interfaces.
126The AX88178 contains a 10/100/1000 Gigabit
127.Tn Ethernet
128MAC with a GMII/MII interface.
129The chip also supports USB 2.0, thereby accommodating 100 Mb/s data rates.
130.Pp
131The
132.Nm
133driver supports the following media types:
134.Pp
135.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
136.It autoselect
137Enable automatic selection of the media type and options.
138.It 10baseT/UTP
139Set 10Mbps operation.
140The
141.Ar mediaopt
142option can also be used to enable
143.Ar full-duplex
144operation.
145Not specifying
146.Ar full duplex
147implies
148.Ar half-duplex
149mode.
150.It 100baseTX
151Set 100Mbps (fast
152.Tn Ethernet )
153operation.
154The
155.Ar mediaopt
156option can also be used to enable
157.Ar full-duplex
158operation.
159Not specifying
160.Ar full duplex
161implies
162.Ar half-duplex
163mode.
164.It 1000baseT
165Set 1000Mbps (Gigabit
166.Tn Ethernet )
167operation (AX88178 only).
168.El
169.Pp
170The
171.Nm
172driver supports the following media options:
173.Pp
174.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
175.It full-duplex
176Force full duplex operation.
177The interface will operate in half duplex mode
178if this media option is not specified.
179.El
180.Pp
181For more information on configuring this device, see
182.Xr ifconfig 8 .
183.Sh SEE ALSO
184.Xr arp 4 ,
185.Xr ifmedia 4 ,
186.Xr netintro 4 ,
187.Xr usb 4 ,
188.Xr ifconfig 8
189.Rs
190.%T ASIX AX88172 data sheet
191.%U http://www.asix.com.tw
192.Re
193.Sh HISTORY
194The
195.Nm
196device driver first appeared in
197.Fx
198and was ported to
199.Nx 3.0 .
200It replaces the
201.Nx
202uax driver.
203