1.\" $NetBSD: axe.4,v 1.17 2019/08/30 09:22:17 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 August 24, 2019 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 "ukphy* 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.Bl -tag -width xxxxxxxxxxxxxxxxxxxx 135.It autoselect 136Enable automatic selection of the media type and options. 137.It 10baseT/UTP 138Set 10Mbps operation. 139The 140.Ar mediaopt 141option can also be used to enable 142.Ar full-duplex 143operation. 144Not specifying 145.Ar full duplex 146implies 147.Ar half-duplex 148mode. 149.It 100baseTX 150Set 100Mbps (fast 151.Tn Ethernet ) 152operation. 153The 154.Ar mediaopt 155option can also be used to enable 156.Ar full-duplex 157operation. 158Not specifying 159.Ar full duplex 160implies 161.Ar half-duplex 162mode. 163.It 1000baseT 164Set 1000Mbps (Gigabit 165.Tn Ethernet ) 166operation (AX88178 only). 167.El 168.Pp 169The 170.Nm 171driver supports the following media options: 172.Bl -tag -width xxxxxxxxxxxxxxxxxxxx 173.It full-duplex 174Force full duplex operation. 175The interface will operate in half duplex mode 176if this media option is not specified. 177.El 178.Pp 179For more information on configuring this device, see 180.Xr ifconfig 8 . 181.Sh DIAGNOSTICS 182See 183.Xr usbnet 4 184for diagnostics. 185.Sh SEE ALSO 186.Xr arp 4 , 187.Xr ifmedia 4 , 188.Xr netintro 4 , 189.Xr usb 4 , 190.Xr usbnet 4 , 191.Xr ifconfig 8 192.Rs 193.%T ASIX AX88172 data sheet 194.%U http://www.asix.com.tw 195.Re 196.Sh HISTORY 197The 198.Nm 199device driver first appeared in 200.Fx 201and was ported to 202.Nx 3.0 . 203It replaces the 204.Nx 205uax driver. 206