xref: /freebsd/share/man/man4/rtwn_usb.4 (revision 52f45d8acee95199159b65a33c94142492c38e41)
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 November 1, 2021
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"
49.Cd "device rtwn_usb"
50.Cd "device wlan"
51.Ed
52.SH DESCRIPTION
53This module provides the USB bus glue needed for the devices supported
54by the
55.Xr rtwn 4
56driver.
57.Sh HARDWARE
58The
59.Nm
60driver supports Realtek RTL8188CUS/RTL8188RU/RTL8188EU/RTL8192CU/RTL8192EU/RTL8812AU/RTL8821AU
61based USB wireless network adapters, including:
62.Pp
63.Bl -column -compact "Belkin F7D1102 Surf Wireless Micro" "RTL8188CUS" "Bus"
64.It Em Card Ta Em Chip Ta Em Bus
65.It "Alfa AWUS036NHR v2" Ta RTL8188RU Ta USB 2.0
66.It "ASUS USB-AC56" Ta RTL8812AU Ta USB 3.0
67.It "ASUS USB-N10 NANO" Ta RTL8188CUS Ta USB 2.0
68.It "ASUS USB-N10 NANO rev B1" Ta RTL8188EUS Ta USB 2.0
69.It "Asus USB-N13, rev. B1" Ta RTL8192CU Ta USB 2.0
70.It "Belkin F7D1102 Surf Wireless Micro" Ta RTL8188CUS Ta USB 2.0
71.It "Buffalo WI-U2-433DHP" Ta RTL8821AU Ta USB 2.0
72.It "Buffalo WI-U2-433DM" Ta RTL8821AU Ta USB 2.0
73.It "Buffalo WI-U3-866D" Ta RTL8812AU Ta USB 3.0
74.It "D-Link DWA-121 rev C1A (N150 Nano)" Ta RTL8188EU Ta USB 2.0
75.It "D-Link DWA-123 rev D1" Ta RTL8188EU Ta USB 2.0
76.It "D-Link DWA-125 rev D1" Ta RTL8188EU Ta USB 2.0
77.It "D-Link DWA-131" Ta RTL8192CU Ta USB 2.0
78.It "D-Link DWA-131 rev E1" Ta RTL8192EU Ta USB 2.0
79.It "D-Link DWA-171 rev A1" Ta RTL8821AU Ta USB 2.0
80.It "D-Link DWA-172 rev A1" Ta RTL8821AU Ta USB 2.0
81.It "D-Link DWA-180 rev A1" Ta RTL8812AU Ta USB 2.0
82.It "D-Link DWA-182 rev C1" Ta RTL8812AU Ta USB 3.0
83.It "Edimax EW-7811Un" Ta RTL8188CUS Ta USB 2.0
84.It "Edimax EW-7811UTC" Ta RTL8821AU Ta USB 2.0
85.It "Edimax EW-7822UAC" Ta RTL8812AU Ta USB 3.0
86.It "EDUP EP-AC1620" Ta RTL8821AU Ta USB 2.0
87.It "Elecom WDC-150SU2M" Ta RTL8188EU Ta USB 2.0
88.It "EnGenius EUB1200AC" Ta RTL8812AU Ta USB 3.0
89.It "Foxconn WFUR6" Ta RTL8812AU Ta USB 2.0
90.It "Hawking HD65U" Ta RTL8821AU Ta USB 2.0
91.It "Hercules Wireless N USB Pico" Ta RTL8188CUS Ta USB 2.0
92.It "I-O Data WN-AC867U" Ta RTL8812AU Ta USB 3.0
93.It "Linksys WUSB6300" Ta RTL8812AU Ta USB 3.0
94.It "NEC AtermWL900U PA-WL900U" Ta RTL8812AU Ta USB 3.0
95.It "Netgear A6100" Ta RTL8821AU Ta USB 2.0
96.It "Netgear WNA1000M" Ta RTL8188CUS Ta USB 2.0
97.It "Mercusys MW150US" Ta RTL8188EU Ta USB 2.0
98.It "Planex GW-900D" Ta RTL8812AU Ta USB 3.0
99.It "Realtek RTL8192CU" Ta RTL8192CU Ta USB 2.0
100.It "Realtek RTL8188CUS" Ta RTL8188CUS Ta USB 2.0
101.It "Sitecom WLA-7100" Ta RTL8812AU Ta USB 3.0
102.It "TP-Link Archer T2U Nano" Ta RTL8821AU Ta USB 2.0
103.It "TP-Link Archer T2U Plus" Ta RTL8821AU Ta USB 2.0
104.It "TP-Link Archer T2U v3" Ta RTL8821AU Ta USB 2.0
105.It "TP-Link Archer T4U" Ta RTL8812AU Ta USB 3.0
106.It "TP-Link Archer T4U v2" Ta RTL8812AU Ta USB 3.0
107.It "TP-Link Archer T4UH v1" Ta RTL8812AU Ta USB 3.0
108.It "TP-Link Archer T4UH v2" Ta RTL8812AU Ta USB 3.0
109.It "TP-Link TL-WN722N v2" Ta RTL8188EU Ta USB 2.0
110.It "TP-LINK TL-WN723N v3" Ta RTL8188EU Ta USB 2.0
111.It "TP-LINK TL-WN725N v2" Ta RTL8188EU Ta USB 2.0
112.It "TP-LINK TL-WN727N v5" Ta RTL8188EU Ta USB 2.0
113.It "TP-LINK TL-WN821N v4" Ta RTL8192CU Ta USB 2.0
114.It "TP-LINK TL-WN821N v5" Ta RTL8192EU Ta USB 2.0
115.It "TP-LINK TL-WN822N v4" Ta RTL8192EU Ta USB 2.0
116.It "TP-LINK TL-WN823N v1" Ta RTL8192CU Ta USB 2.0
117.It "TP-LINK TL-WN823N v2" Ta RTL8192EU Ta USB 2.0
118.It "TRENDnet TEW-805UB" Ta RTL8812AU Ta USB 3.0
119.It "ZyXEL NWD6605" Ta RTL8812AU Ta USB 3.0
120.El
121.Sh SEE ALSO
122.Xr rtwn 4 ,
123.Xr rtwn_pci 4 ,
124.Xr rtwnfw 4 ,
125.Xr usb 4
126.Sh BUGS
127The
128.Nm
129driver does not support any of the 802.11ac capabilities offered by the
130adapters.
131Additional work is required in
132.Xr ieee80211 9
133before those features can be supported.
134