xref: /netbsd-src/share/man/man4/axen.4 (revision f3cfa6f6ce31685c6c4a758bc430e69eb99f50a4)
1.\"	$NetBSD: axen.4,v 1.7 2018/07/27 19:11:56 snj 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 July 27, 2018
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 D-Link DUB-1312
37.It Kurotoshiko GbE-USB3.0
38.It Kurotoshiko GbE-USB3.0S2
39.It Logitec LAN-GTJU3
40.It Logitec LAN-GTJU3H3
41.It Shanghai Donya DN-84327
42.El
43.Pp
44The
45.Nm
46driver supports the following media types:
47.Bl -tag -width "autoselect"
48.It autoselect
49Enable autoselection of the media type and options (this is the default).
50The user can manually override the autoselected mode by adding media
51options to the appropriate
52.Xr ifconfig.if 5
53file.
54.It 10baseT
55Set 10Mbps operation.
56.It 100baseTX
57Set 100Mbps (Fast Ethernet) operation.
58.It 1000baseT
59Set 1000Mbps (Gigabit Ethernet) operation.
60.El
61.Pp
62For more information on configuring this device, see
63.Xr ifconfig 8 .
64.Sh DIAGNOSTICS
65.Bl -diag
66.It "axen%d: watchdog timeout"
67A packet was queued for transmission and a transmit command was
68issued, however the device failed to acknowledge the transmission
69before a timeout expired.
70.El
71.Sh SEE ALSO
72.Xr arp 4 ,
73.Xr mii 4 ,
74.Xr netintro 4 ,
75.Xr rgephy 4 ,
76.Xr usb 4 ,
77.Xr ifconfig.if 5 ,
78.Xr ifconfig 8
79.Sh HISTORY
80The
81.Nm
82device driver first appeared in
83.Ox 5.4
84and in
85.Nx 7.0 .
86.Sh AUTHORS
87.An -nosplit
88The
89.Nm
90driver was written by
91.An Yojiro UO Aq Mt yuo@nui.org
92for
93.Ox
94and ported to
95.Nx
96by
97.An NONAKA Kimihiro Aq Mt nonaka@NetBSD.org .
98