xref: /openbsd-src/share/man/man4/axen.4 (revision 9060cf22087b8abfbc84b90a97c49db3aee880ce)
1.\"	$OpenBSD: axen.4,v 1.11 2024/10/07 07:35:40 kevlo Exp $
2.\"
3.\" Copyright (c) 2013 Yojiro UO <yuo@nui.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: October 7 2024 $
18.Dt AXEN 4
19.Os
20.Sh NAME
21.Nm axen
22.Nd ASIX Electronics AX88179/AX88179A/AX88772D 10/100/1Gb USB Ethernet device
23.Sh SYNOPSIS
24.Cd "axen*   at uhub?"
25.Cd "rgephy* at mii?"
26.Cd "ukphy* at mii?"
27.Sh DESCRIPTION
28The
29.Nm
30driver provides support for USB Ethernet adapters based on the ASIX
31Electronics AX88179/AX88179A/AX88772D chipset, including the following:
32.Pp
33.Bl -tag -width Ds -offset indent -compact
34.It D-Link DUB-1312
35.It Kuroutoshikou GbE-USB3.0
36.It Logitec LAN-GTJU3
37.It Sitecom LN-032
38.It StarTech USB31000S
39.It TP-LINK UE300C v2
40.It TP-Link UE306
41.It Ugreen CM650-15632
42.El
43.Pp
44The AX88772D is a USB 2.0 device which supports both
4510 and 100Mbps speeds in either full or half duplex.
46The AX88179 and AX88179A are USB 3.0 devices, which contain
47a 10/100/1Gb Ethernet MAC with a GMII/MII interface.
48.Pp
49The
50.Nm
51driver supports the following media types:
52.Bl -tag -width "autoselect"
53.It autoselect
54Enable autoselection of the media type and options (this is the default).
55The user can manually override the autoselected mode by adding media
56options to the appropriate
57.Xr hostname.if 5
58file.
59.It 10baseT
60Set 10Mbps operation.
61.It 100baseTX
62Set 100Mbps (Fast Ethernet) operation.
63.It 1000baseT
64Set 1000Mbps (Gigabit Ethernet) operation.
65.El
66.Pp
67For more information on configuring this device, see
68.Xr ifconfig 8 .
69.Sh SEE ALSO
70.Xr arp 4 ,
71.Xr ifmedia 4 ,
72.Xr intro 4 ,
73.Xr netintro 4 ,
74.Xr rgephy 4 ,
75.Xr ukphy 4 ,
76.Xr usb 4 ,
77.Xr hostname.if 5 ,
78.Xr ifconfig 8
79.Sh HISTORY
80The
81.Nm
82device driver first appeared in
83.Ox 5.4 .
84.Sh AUTHORS
85.An -nosplit
86The
87.Nm
88driver was written by
89.An Yojiro UO Aq Mt yuo@nui.org .
90