xref: /netbsd-src/share/man/man4/axen.4 (revision bdc22b2e01993381dcefeff2bc9b56ca75a4235c)
1.\"	$NetBSD: axen.4,v 1.6 2017/04/13 07:22:50 skrll Exp $
2.\"	$OpenBSD: axen.4,v 1.2 2013/10/07 07:18:36 jmc Exp $
3.\"
4.\" Copyright (c) 2013 Yojiro UO <yuo@nui.org>
5.\"
6.\" Permission to use, copy, modify, and distribute this software for any
7.\" purpose with or without fee is hereby granted, provided that the above
8.\" copyright notice and this permission notice appear in all copies.
9.\"
10.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17.\"
18.Dd April 13, 2017
19.Dt AXEN 4
20.Os
21.Sh NAME
22.Nm axen
23.Nd ASIX Electronics AX88178a/AX88179 10/100/Gigabit USB Ethernet device
24.Sh SYNOPSIS
25.Cd "axen*   at uhub? port ?"
26.Cd "rgephy* at mii?"
27.Sh DESCRIPTION
28The
29.Nm
30driver provides support for USB Ethernet adapters based on the ASIX
31Electronics AX88178a USB 2.0 and AX88179 USB 3.0 chipsets
32including the following:
33.Pp
34.Bl -tag -width Ds -offset indent -compact
35.It Buffalo LUA4-U3-AGT
36.It Kurotoshiko GbE-USB3.0
37.It Kurotoshiko GbE-USB3.0S2
38.It Logitec LAN-GTJU3
39.It Logitec LAN-GTJU3H3
40.It Shanghai Donya DN-84327
41.El
42.Pp
43The
44.Nm
45driver supports the following media types:
46.Bl -tag -width "autoselect"
47.It autoselect
48Enable autoselection of the media type and options (this is the default).
49The user can manually override the autoselected mode by adding media
50options to the appropriate
51.Xr ifconfig.if 5
52file.
53.It 10baseT
54Set 10Mbps operation.
55.It 100baseTX
56Set 100Mbps (Fast Ethernet) operation.
57.It 1000baseT
58Set 1000Mbps (Gigabit Ethernet) operation.
59.El
60.Pp
61For more information on configuring this device, see
62.Xr ifconfig 8 .
63.Sh DIAGNOSTICS
64.Bl -diag
65.It "axen%d: watchdog timeout"
66A packet was queued for transmission and a transmit command was
67issued, however the device failed to acknowledge the transmission
68before a timeout expired.
69.El
70.Sh SEE ALSO
71.Xr arp 4 ,
72.Xr mii 4 ,
73.Xr netintro 4 ,
74.Xr rgephy 4 ,
75.Xr usb 4 ,
76.Xr ifconfig.if 5 ,
77.Xr ifconfig 8
78.Sh HISTORY
79The
80.Nm
81device driver first appeared in
82.Ox 5.4
83and in
84.Nx 7.0 .
85.Sh AUTHORS
86.An -nosplit
87The
88.Nm
89driver was written by
90.An Yojiro UO Aq Mt yuo@nui.org
91for
92.Ox
93and ported to
94.Nx
95by
96.An NONAKA Kimihiro Aq Mt nonaka@NetBSD.org .
97