xref: /freebsd/share/man/man4/rtwn_usb.4 (revision 389e4940069316fe667ffa263fa7d6390d0a960f)
1.\"-
2.\" Copyright (c) 2011 Adrian Chadd, Xenion Pty Ltd
3.\" Copyright (c) 2016 Andriy Voskoboinyk <avos@FreeBSD.org>
4.\" All rights reserved.
5.\""
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer,
11.\"    without modification.
12.\" 2. Redistributions in binary form must reproduce at minimum a disclaimer
13.\"    similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
14.\"    redistribution must be conditioned upon including a substantially
15.\"    similar Disclaimer requirement for further binary redistribution.
16.\"
17.\" NO WARRANTY
18.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20.\" LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
21.\" AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
22.\" THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
23.\" OR 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
26.\" IN 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
28.\" THE POSSIBILITY OF SUCH DAMAGES.
29.\"
30.\" $FreeBSD$
31.\"/
32.Dd October 9, 2017
33.Dt RTWN_USB 4
34.Os
35.Sh NAME
36.Nm rtwn_usb
37.Nd "Realtek USB device glue"
38.Sh SYNOPSIS
39To compile this driver into the kernel,
40place the following lines in your
41kernel configuration file:
42.Bd -ragged -offset indent
43.Cd "device xhci"
44.Cd "device ehci"
45.Cd "device uhci"
46.Cd "device ohci"
47.Cd "device usb"
48.Cd "device rtwn_usb"
49.Cd "device wlan"
50.Ed
51.Sh DESCRIPTION
52This module provides the USB bus glue needed for the devices supported
53by the
54.Xr rtwn 4
55driver.
56.Sh HARDWARE
57The
58.Nm
59driver supports Realtek RTL8188CU/RTL8188RU/RTL8188EU/RTL8192CU/RTL8192EU/RTL8812AU/RTL8821AU
60based USB wireless network adapters, including:
61.Pp
62.Bl -column -compact "Belkin F7D1102 Surf Wireless Micro" "Bus"
63.It Em Card Ta Em Bus
64.It "Alfa AWUS036NHR v2" Ta USB 2.0
65.It "ASUS USB-AC56" Ta USB 3.0
66.It "ASUS USB-N10 NANO" Ta USB 2.0
67.It "Asus USB-N13, rev. B1" Ta USB 2.0
68.It "Belkin F7D1102 Surf Wireless Micro" Ta USB 2.0
69.It "Buffalo WI-U2-433DM" Ta USB 2.0
70.It "Buffalo WI-U3-866D" Ta USB 3.0
71.It "D-Link DWA-123 rev D1" Ta USB 2.0
72.It "D-Link DWA-125 rev D1" Ta USB 2.0
73.It "D-Link DWA-131" Ta USB 2.0
74.It "D-Link DWA-131 rev E1" Ta USB 2.0
75.It "D-Link DWA-171 rev A1" Ta USB 2.0
76.It "D-Link DWA-172 rev A1" Ta USB 2.0
77.It "D-Link DWA-180 rev A1" Ta USB 2.0
78.It "D-Link DWA-182 rev C1" Ta USB 3.0
79.It "Edimax EW-7811Un" Ta USB 2.0
80.It "Edimax EW-7811UTC" Ta USB 2.0
81.It "Edimax EW-7822UAC" Ta USB 3.0
82.It "Elecom WDC-150SU2M" Ta USB 2.0
83.It "EnGenius EUB1200AC" Ta USB 3.0
84.It "Hawking HD65U" Ta USB 2.0
85.It "Hercules Wireless N USB Pico" Ta USB 2.0
86.It "I-O Data WN-AC867U" Ta USB 3.0
87.It "Linksys WUSB6300" Ta USB 3.0
88.It "NEC AtermWL900U PA-WL900U" Ta USB 3.0
89.It "Netgear A6100" Ta USB 2.0
90.It "Netgear WNA1000M" Ta USB 2.0
91.It "Planex GW-900D" Ta USB 3.0
92.It "Realtek RTL8192CU" Ta USB 2.0
93.It "Realtek RTL8188CUS" Ta USB 2.0
94.It "Sitecom WLA-7100" Ta USB 3.0
95.It "TP-Link Archer T4U" Ta USB 3.0
96.It "TP-LINK TL-WN723N v3" Ta USB 2.0
97.It "TP-LINK TL-WN725N v2" Ta USB 2.0
98.It "TP-LINK TL-WN821N v4" Ta USB 2.0
99.It "TP-LINK TL-WN821N v5" Ta USB 2.0
100.It "TP-LINK TL-WN822N v4" Ta USB 2.0
101.It "TP-LINK TL-WN823N v1" Ta USB 2.0
102.It "TP-LINK TL-WN823N v2" Ta USB 2.0
103.It "TRENDnet TEW-805UB" Ta USB 3.0
104.It "ZyXEL NWD6605" Ta USB 3.0
105.El
106.Sh SEE ALSO
107.Xr rtwn 4 ,
108.Xr rtwn_pci 4 ,
109.Xr rtwnfw 4 ,
110.Xr usb 4
111.Sh BUGS
112The
113.Nm
114driver does not support any of the 802.11ac capabilities offered by the
115adapters.
116Additional work is required in
117.Xr ieee80211 9
118before those features can be supported.
119