1.\" $OpenBSD: rsu.4,v 1.18 2014/02/15 20:28:19 tedu Exp $ 2.\" 3.\" Copyright (c) 2010 Damien Bergamini <damien.bergamini@free.fr> 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: February 15 2014 $ 18.Dt RSU 4 19.Os 20.Sh NAME 21.Nm rsu 22.Nd Realtek RTL8188SU/RTL8192SU USB IEEE 802.11b/g/n wireless network device 23.Sh SYNOPSIS 24.Cd "rsu* at uhub? port ?" 25.Sh DESCRIPTION 26The 27.Nm 28driver supports USB 2.0 wireless network devices based on Realtek 29RTL8188SU, RTL8191SU and RTL8192SU chipsets. 30.Pp 31The RTL8188SU is a highly integrated 802.11n adapter that combines 32a MAC, a 1T1R capable baseband and an RF in a single chip. 33It operates in the 2GHz spectrum only. 34.Pp 35The RTL8191SU is a highly integrated multiple-in, single-out (MISO) 36802.11n adapter that combines a MAC, a 1T2R capable baseband and an 37RF in a single chip. 38It operates in the 2GHz spectrum only. 39.Pp 40The RTL8192SU is a highly integrated multiple-in, multiple-out (MIMO) 41802.11n adapter that combines 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.El 56.Pp 57The 58.Nm 59driver can be configured to use 60Wired Equivalent Privacy (WEP) or 61Wi-Fi Protected Access (WPA-PSK and WPA2-PSK). 62WPA is the current encryption standard for wireless networks. 63It is strongly recommended that WEP 64not be used as the sole mechanism 65to secure wireless communication, 66due to serious weaknesses in it. 67.Pp 68The 69.Nm 70driver can be configured at runtime with 71.Xr ifconfig 8 72or on boot with 73.Xr hostname.if 5 . 74.Sh FILES 75The driver needs at least version 1.1 of the following firmware file, 76which is loaded when an interface is attached: 77.Pp 78.Bl -tag -width Ds -offset indent -compact 79.It /etc/firmware/rsu-rtl8712fw 80.El 81.Pp 82A prepackaged version of the firmware can be installed using 83.Xr fw_update 1 . 84.Sh HARDWARE 85The following adapters should work: 86.Pp 87.Bl -tag -width Ds -offset indent -compact 88.It ASUS USB-N10 89.It ASUS WL-167G V3 90.It Belkin F7D1101 v1 91.It D-Link DWA-131 A1 92.It Hercules HWGUn-54 93.It Hercules HWNUm-300 94.It Planex GW-USNano 95.It Sitecom WL-349 v1 96.It Sitecom WL-353 97.It Sweex LW154 98.It TRENDnet TEW-648UB 99.It TRENDnet TEW-649UB 100.El 101.Sh EXAMPLES 102The following example scans for available networks: 103.Pp 104.Dl # ifconfig rsu0 scan 105.Pp 106The following 107.Xr hostname.if 5 108example configures rsu0 to join network 109.Dq mynwid , 110using WPA key 111.Dq mywpakey , 112obtaining an IP address using DHCP: 113.Bd -literal -offset indent 114nwid mynwid 115wpakey mywpakey 116dhcp 117.Ed 118.Sh DIAGNOSTICS 119.Bl -diag 120.It "rsu0: error N, could not read firmware ..." 121For some reason, the driver was unable to read the microcode file from the 122filesystem. 123The file might be missing or corrupted. 124.It "rsu0: device timeout" 125A frame dispatched to the hardware for transmission did not complete in time. 126The driver will reset the hardware. 127This should not happen. 128.El 129.Sh SEE ALSO 130.Xr arp 4 , 131.Xr ifmedia 4 , 132.Xr intro 4 , 133.Xr netintro 4 , 134.Xr usb 4 , 135.Xr hostname.if 5 , 136.Xr ifconfig 8 137.Sh HISTORY 138The 139.Nm 140driver first appeared in 141.Ox 4.9 . 142.Sh AUTHORS 143The 144.Nm 145driver was written by 146.An Damien Bergamini Aq Mt damien.bergamini@free.fr . 147.Sh CAVEATS 148The 149.Nm 150driver does not support any of the 802.11n capabilities offered by the 151adapters. 152Additional work is required in 153.Xr ieee80211 9 154before those features can be supported. 155