1.\" $NetBSD: urtwn.4,v 1.15 2016/10/12 03:23:29 nat Exp $ 2.\" $OpenBSD: urtwn.4,v 1.15 2011/11/26 06:39:33 ckuethe Exp $ 3.\" 4.\" Copyright (c) 2010 Damien Bergamini <damien.bergamini@free.fr> 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 25, 2014 19.Dt URTWN 4 20.Os 21.Sh NAME 22.Nm urtwn 23.Nd Realtek RTL8188CU/RTL8188EU/RTL8192CU/RTL8192EU USB IEEE 802.11b/g/n wireless network device 24.Sh SYNOPSIS 25.Cd "urtwn* at uhub? port ?" 26.Sh DESCRIPTION 27The 28.Nm 29driver supports USB 2.0 wireless network devices based on Realtek 30RTL8188CUS, RTL8188CE-VAU, RTL8188EUS, RTL8188RU, RTL8192CU and RTL8192EU 31chipsets. 32.Pp 33The RTL8188CUS and RTL8188EUS are highly integrated 802.11n adapters that 34combine a MAC, a 1T1R capable baseband and an RF in a single chip. 35They operate in the 2GHz spectrum only. 36The RTL8188RU is a high-power variant of the RTL8188CUS. 37The RTL8188CE-VAU is a PCI Express Mini Card adapter that attaches 38to the USB interface. 39.Pp 40The RTL8192CU and RTL8192EU are highly integrated multiple-in, multiple-out 41(MIMO) 802.11n adapters that combine a MAC, a 2T2R capable baseband and an 42RF in a single chip. 43It operates in the 2GHz spectrum only. 44.Pp 45These are the modes the 46.Nm 47driver can operate in: 48.Bl -tag -width "IBSS-masterXX" 49.It BSS mode 50Also known as 51.Em infrastructure 52mode, this is used when associating with an access point, through 53which all traffic passes. 54This mode is the default. 55.It IBSS mode 56Also known as 57.Em IEEE ad-hoc 58mode or 59.Em peer-to-peer 60mode. 61This is the standardized method of operating without an access point. 62Stations associate with a service set. 63However, actual connections between stations are peer-to-peer. 64.It Host AP 65In this mode the driver acts as an access point (base station) 66for other cards. 67.It monitor mode 68In this mode the driver is able to receive packets without 69associating with an access point. 70This disables the internal receive filter and enables the card to 71capture packets from networks which it wouldn't normally have access to, 72or to scan for access points. 73.El 74.Pp 75The 76.Nm 77driver can be configured to use 78Wired Equivalent Privacy (WEP) or 79Wi-Fi Protected Access (WPA-PSK and WPA2-PSK). 80WPA is the de facto encryption standard for wireless networks. 81It is strongly recommended that WEP 82not be used as the sole mechanism 83to secure wireless communication, 84due to serious weaknesses in it. 85.Pp 86The 87.Nm 88driver can be configured at runtime with 89.Xr ifconfig 8 90or on boot with 91.Xr ifconfig.if 5 . 92.Sh FILES 93The driver needs the following firmware files, 94which are loaded when an interface is attached: 95.Pp 96.Bl -tag -width Ds -offset indent -compact 97.It /libdata/firmware/if_urtwn/rtl8188eufw.bin 98.It /libdata/firmware/if_urtwn/rtl8192cfw.bin 99.It /libdata/firmware/if_urtwn/rtl8192cfwU.bin 100.It /libdata/firmware/if_urtwn/rtl8192efw.bin 101.El 102.Sh HARDWARE 103The following adapters should work: 104.Pp 105.Bl -tag -width Ds -offset indent -compact 106.It Airlink101 AWLL5088 107.It Aus. Linx AL-9604R1S 108.It ASUSTeK USB-N10 NANO 109.It B-Link BL-LW05-5R 110.It Belkin F7D1102 Surf Wireless Micro 111.It D-Link DWA-121 112.It D-Link DWA-133 113.It D-Link DWA-135 114.It Digitus DN-7042 115.It Edimax EW-7811Un 116.It EDUP EP-N8508 117.It ELECOM WDC-150SU2M 118.It Full River FR-W100NUL 119.It Hercules Wireless N USB Pico HWNUp-150 120.It Netgear WNA1000A 121.It Planex GW-USEco300 122.It Planex GW-USNano2 123.It Planex GW-USValue-EZ 124.It Planex GW-USWExtreme 125.It POWCHIP POW-N18 126.It Sitecom N300 USB (WLA-2102 v1) 127.It Sitecom WL-365 128.It Solwise NET-WL-UMD-606N 129.It TP-LINK TL-WN723N v3 130.It TP-LINK TL-WN725N v2 131.It TRENDnet TEW-648UBM 132.El 133.Sh EXAMPLES 134The following 135.Xr ifconfig.if 5 136example configures urtwn0 to join whatever network is available on boot, 137using WEP key 138.Dq 0x1deadbeef1 , 139channel 11, obtaining an IP address using DHCP: 140.Bd -literal -offset indent 141nwkey 0x1deadbeef1 chan 11 142dhcp 143.Ed 144.Pp 145Join an existing BSS network, 146.Dq my_net : 147.Bd -literal -offset indent 148# ifconfig urtwn0 192.168.1.1 netmask 0xffffff00 nwid my_net 149.Ed 150.Sh DIAGNOSTICS 151.Bl -diag 152.It "urtwn%d: error %d, could not read firmware %s" 153For some reason, the driver was unable to read the microcode file from the 154filesystem. 155The file might be missing or corrupted. 156.It "urtwn%d: device timeout" 157A frame dispatched to the hardware for transmission did not complete in time. 158The driver will reset the hardware. 159This should not happen. 160.El 161.Sh SEE ALSO 162.Xr arp 4 , 163.Xr netintro 4 , 164.Xr usb 4 , 165.Xr ifconfig.if 5 , 166.Xr wpa_supplicant.conf 5 , 167.Xr ifconfig 8 , 168.Xr wpa_supplicant 8 169.Sh HISTORY 170The 171.Nm 172device driver first appeared in 173.Ox 4.9 174and in 175.Nx 6.0 . 176.Sh AUTHORS 177.An -nosplit 178The 179.Nm 180driver was written by 181.An Damien Bergamini 182.Aq damien@openbsd.org 183for 184.Ox 185and ported to 186.Nx 187by 188.An NONAKA Kimihiro 189.Aq nonaka@NetBSD.org . 190.Sh CAVEATS 191The 192.Nm 193driver does not support any of the 802.11n capabilities offered by the 194adapters. 195Additional work is required in 196.Xr ieee80211 9 197before those features can be supported. 198