share/man/man4/axe.4

   1 .\" $NetBSD: axe.4,v 1.4 2006/01/02 16:45:44 rumble 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 .Dd October 23, 2004
  31 .Dt AXE 4
  32 .Os
  33 .Sh NAME
  34 .Nm axe
  35 .Nd ASIX AX88172 USB Ethernet driver
  36 .Sh SYNOPSIS
  37 .Cd "axe*   at uhub?"
  38 .Cd "XXphy* at mii?"
  39 .Sh HARDWARE
  40 The
  41 .Nm
  42 driver supports the following adapters:
  43 .Pp
  44 .Bl -tag -width Dv -offset indent -compact
  45 .It Tn Corega FEther USB2-TX
  46 .It Tn D-Link DUB-E100
  47 .It Tn Linksys USB 200M
  48 .It Tn Melco LUA-U2-KTX
  49 .It Tn Netgear FA120
  50 .It Tn Sitecom LN029
  51 .It Tn Systemtalks SGCX2UL
  52 .El
  53 .Sh DESCRIPTION
  54 The
  55 .Nm
  56 driver provides support for USB (2.0)
  57 .Tn Ethernet
  58 adapters based on the ASIX AX88172 chip.
  59 .Pp
  60 The chip contains a 10/100
  61 .Tn Ethernet
  62 MAC with MII interface and is designed to work with both
  63 .Tn Ethernet
  64 and HomePNA transceivers.
  65 The chip also supports USB 2.0, thereby accommodating 100 Mb/s data rates.
  66 .Pp
  67 The
  68 .Nm
  69 driver supports the following media types:
  70 .Pp
  71 .Bl -tag -width xxxxxxxxxxxxxxxxxxxx
  72 .It autoselect
  73 Enable automatic selection of the media type and options.
  74 .It 10baseT/UTP
  75 Set 10Mbps operation.
  76 The
  77 .Ar mediaopt
  78 option can also be used to enable
  79 .Ar full-duplex
  80 operation.
  81 Not specifying
  82 .Ar full duplex
  83 implies
  84 .Ar half-duplex
  85 mode.
  86 .It 100baseTX
  87 Set 100Mbps (fast
  88 .Tn Ethernet )
  89 operation.
  90 The
  91 .Ar mediaopt
  92 option can also be used to enable
  93 .Ar full-duplex
  94 operation.
  95 Not specifying
  96 .Ar full duplex
  97 implies
  98 .Ar half-duplex
  99 mode.
 100 .El
 101 .Pp
 102 The
 103 .Nm
 104 driver supports the following media options:
 105 .Pp
 106 .Bl -tag -width xxxxxxxxxxxxxxxxxxxx
 107 .It full-duplex
 108 Force full duplex operation.
 109 The interface will operate in half duplex mode
 110 if this media option is not specified.
 111 .El
 112 .Pp
 113 For more information on configuring this device, see
 114 .Xr ifconfig 8 .
 115 .Sh SEE ALSO
 116 .Xr arp 4 ,
 117 .Xr netintro 4 ,
 118 .Xr usb 4 ,
 119 .Xr ifconfig 8
 120 .Rs
 121 .%T ASIX AX88172 data sheet
 122 .%O http://www.asix.com.tw
 123 .Re
 124 .Sh HISTORY
 125 The
 126 .Nm
 127 device driver first appeared in
 128 .Fx
 129 and was ported to
 130 .Nx 3.0 .
 131 It replaces the
 132 .Nx
 133 uax driver.