1.\" $OpenBSD: rsu.4,v 1.21 2019/03/29 17:16:35 jmc 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: March 29 2019 $ 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 Pa /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 wpakey mywpakey 115dhcp 116.Ed 117.Sh DIAGNOSTICS 118.Bl -diag 119.It "rsu0: error N, could not read firmware ..." 120For some reason, the driver was unable to read the microcode file from the 121filesystem. 122The file might be missing or corrupted. 123.It "rsu0: device timeout" 124A frame dispatched to the hardware for transmission did not complete in time. 125The driver will reset the hardware. 126This should not happen. 127.El 128.Sh SEE ALSO 129.Xr arp 4 , 130.Xr ifmedia 4 , 131.Xr intro 4 , 132.Xr netintro 4 , 133.Xr usb 4 , 134.Xr hostname.if 5 , 135.Xr ifconfig 8 136.Sh HISTORY 137The 138.Nm 139driver first appeared in 140.Ox 4.9 . 141.Sh AUTHORS 142The 143.Nm 144driver was written by 145.An Damien Bergamini Aq Mt damien.bergamini@free.fr . 146.Sh CAVEATS 147The 148.Nm 149driver does not support any of the 802.11n capabilities offered by the 150adapters. 151Additional work is required in 152.Xr ieee80211 9 153before those features can be supported. 154.Pp 155This driver does not support powersave mode. 156