1.\" Copyright (c) 1997, 1998, 1999, 2000-2003 2.\" Bill Paul <wpaul@windriver.com>. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 3. All advertising materials mentioning features or use of this software 13.\" must display the following acknowledgement: 14.\" This product includes software developed by Bill Paul. 15.\" 4. Neither the name of the author nor the names of any co-contributors 16.\" may be used to endorse or promote products derived from this software 17.\" without specific prior written permission. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND 20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD 23.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 24.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 25.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 26.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 27.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 28.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 29.\" THE POSSIBILITY OF SUCH DAMAGE. 30.\" 31.\" $FreeBSD: /repoman/r/ncvs/src/share/man/man4/axe.4,v 1.3 2003/05/29 21:28:35 ru Exp $ 32.\" $OpenBSD: axe.4,v 1.38 2010/09/19 12:18:16 jmc Exp $ 33.\" 34.Dd $Mdocdate: September 19 2010 $ 35.Dt AXE 4 36.Os 37.Sh NAME 38.Nm axe 39.Nd ASIX Electronics AX88172/AX88178/AX88772 10/100/Gigabit USB Ethernet device 40.Sh SYNOPSIS 41.Cd "axe* at uhub?" 42.Cd "rlphy* at mii?" 43.Cd "eephy* at mii?" 44.Sh DESCRIPTION 45The 46.Nm 47driver provides support for USB Ethernet adapters based on the ASIX 48Electronics AX88172, AX88178, and AX88772 USB 2.0 chipsets, including the 49following: 50.Pp 51.Bl -tag -width Ds -offset indent -compact 52.It Apple USB Ethernet Adapter A1277 53.It ATEN UC-210T 54.It BAFO BF-320 55.It Billionton Systems USB2AR 56.It Buffalo(MELCO) LUA-U2-GT 57.It Buffalo(MELCO) LUA-U2-KTX 58.It Corega FEther USB2-TX 59.It D-Link DUB-E100 60.It Good Way GWUSB2E 61.It Hawking UF200 62.It Intellinet USB 2.0 to Ethernet (rev A) 63.It IO-Data ETG-US2 64.It JVC MP-PRX1 65.It Konig CMP-NWUSB20 66.It Level One USB-0200 67.It Linksys USB200M 68.It Linksys USB1000 69.It Logitec LAN-GTJ/U2 70.It Netgear FA120 71.It Nintendo Wii USB Lan Ethernet Adapter RVL-015 72.It OQO model 01+ Ethernet 73.It Sitecom LN-029 74.It SMC 2209USB/ETH 75.It SnapPort USB 2.0 LAN Adapter 76.It ST Lab USB 2.0 Fast Ethernet 77.It Surecom EP-1427X-2 78.It System TALKS SGC-X2UL 79.It TRENDnet TU2-ET100 80.It Z-TEK ZK-R01-2 81.El 82.Pp 83The AX88172, AX88178, and AX88772 are USB 2.0 devices designed to work with 84either Ethernet or HomePNA transceivers. 85The AX8172 and AX88772 contain 10/100 Ethernet MACs with MII interfaces. 86The AX8178 contains a 10/100/1000 Gigabit Ethernet MAC with a GMII/MII 87interface. 88All adapters will operate with either USB 1.x or USB 2.0 controllers, however 89performance with 1.x controllers will be limited since the USB 1.x standard 90specifies a maximum transfer speed of 12Mbps. 91Users with USB 1.x controllers should therefore not expect to actually 92achieve 100Mbps speeds with these devices. 93.Pp 94A 64-bit multicast hash table is supported, 95single perfect filter entry for the station address, 96all-multicast mode, and promiscuous mode. 97Packets are 98received and transmitted over separate USB bulk transfer endpoints. 99.Pp 100The 101.Nm 102driver supports the following media types: 103.Bl -tag -width "autoselect" 104.It autoselect 105Enable autoselection of the media type and options (this is the default). 106The user can manually override the autoselected mode by adding media 107options to the appropriate 108.Xr hostname.if 5 109file. 110.It 10baseT 111Set 10Mbps operation. 112.It 100baseTX 113Set 100Mbps (Fast Ethernet) operation. 114.It 1000baseT 115Set 1000Mbps (Gigabit Ethernet) operation (AX88178 only). 116.El 117.Pp 118The 119.Nm 120driver supports the following media options: 121.Bl -tag -width "full-duplex" 122.It full-duplex 123Force full-duplex operation. 124.It half-duplex 125Force half-duplex operation. 126.El 127.Pp 128The interface will operate in 129half-duplex mode if no media option is specified. 130.Pp 131For more information on configuring this device, see 132.Xr ifconfig 8 . 133.Sh DIAGNOSTICS 134.Bl -diag 135.It "axe%d: watchdog timeout" 136A packet was queued for transmission and a transmit command was 137issued, however the device failed to acknowledge the transmission 138before a timeout expired. 139.It "axe%d: no memory for rx list" 140The driver failed to allocate an mbuf for the receiver ring. 141.El 142.Sh SEE ALSO 143.Xr arp 4 , 144.Xr eephy 4 , 145.Xr ifmedia 4 , 146.Xr intro 4 , 147.Xr netintro 4 , 148.Xr rlphy 4 , 149.Xr usb 4 , 150.Xr hostname.if 5 , 151.Xr ifconfig 8 152.Rs 153.%T "ASIX AX88172 data sheet" 154.%O http://www.asix.com.tw 155.Re 156.Sh HISTORY 157The 158.Nm 159device driver first appeared in 160.Ox 3.6 . 161.Sh AUTHORS 162.An -nosplit 163The 164.Nm 165driver was written by 166.An Bill Paul Aq wpaul@windriver.com 167and ported to 168.Ox 169by 170.An Greg Taleck Aq taleck@oz.net . 171