1*d09093c1Skn.\" $OpenBSD: rsu.4,v 1.25 2021/10/24 12:32:42 kn Exp $ 25fdd4e61Sdamien.\" 35fdd4e61Sdamien.\" Copyright (c) 2010 Damien Bergamini <damien.bergamini@free.fr> 45fdd4e61Sdamien.\" 55fdd4e61Sdamien.\" Permission to use, copy, modify, and distribute this software for any 65fdd4e61Sdamien.\" purpose with or without fee is hereby granted, provided that the above 75fdd4e61Sdamien.\" copyright notice and this permission notice appear in all copies. 85fdd4e61Sdamien.\" 95fdd4e61Sdamien.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 105fdd4e61Sdamien.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 115fdd4e61Sdamien.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 125fdd4e61Sdamien.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 135fdd4e61Sdamien.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 145fdd4e61Sdamien.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 155fdd4e61Sdamien.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 165fdd4e61Sdamien.\" 17*d09093c1Skn.Dd $Mdocdate: October 24 2021 $ 185fdd4e61Sdamien.Dt RSU 4 195fdd4e61Sdamien.Os 205fdd4e61Sdamien.Sh NAME 215fdd4e61Sdamien.Nm rsu 225fdd4e61Sdamien.Nd Realtek RTL8188SU/RTL8192SU USB IEEE 802.11b/g/n wireless network device 235fdd4e61Sdamien.Sh SYNOPSIS 245fdd4e61Sdamien.Cd "rsu* at uhub? port ?" 255fdd4e61Sdamien.Sh DESCRIPTION 265fdd4e61SdamienThe 275fdd4e61Sdamien.Nm 285fdd4e61Sdamiendriver supports USB 2.0 wireless network devices based on Realtek 295fdd4e61SdamienRTL8188SU, RTL8191SU and RTL8192SU chipsets. 305fdd4e61Sdamien.Pp 315fdd4e61SdamienThe RTL8188SU is a highly integrated 802.11n adapter that combines 325fdd4e61Sdamiena MAC, a 1T1R capable baseband and an RF in a single chip. 335fdd4e61SdamienIt operates in the 2GHz spectrum only. 345fdd4e61Sdamien.Pp 355fdd4e61SdamienThe RTL8191SU is a highly integrated multiple-in, single-out (MISO) 365fdd4e61Sdamien802.11n adapter that combines a MAC, a 1T2R capable baseband and an 375fdd4e61SdamienRF in a single chip. 385fdd4e61SdamienIt operates in the 2GHz spectrum only. 395fdd4e61Sdamien.Pp 40a9fb92a1SdamienThe RTL8192SU is a highly integrated multiple-in, multiple-out (MIMO) 415fdd4e61Sdamien802.11n adapter that combines a MAC, a 2T2R capable baseband and an 425fdd4e61SdamienRF in a single chip. 435fdd4e61SdamienIt operates in the 2GHz spectrum only. 445fdd4e61Sdamien.Pp 455fdd4e61SdamienThese are the modes the 465fdd4e61Sdamien.Nm 475fdd4e61Sdamiendriver can operate in: 485fdd4e61Sdamien.Bl -tag -width "IBSS-masterXX" 495fdd4e61Sdamien.It BSS mode 505fdd4e61SdamienAlso known as 515fdd4e61Sdamien.Em infrastructure 525fdd4e61Sdamienmode, this is used when associating with an access point, through 535fdd4e61Sdamienwhich all traffic passes. 545fdd4e61SdamienThis mode is the default. 555fdd4e61Sdamien.El 565fdd4e61Sdamien.Pp 575fdd4e61SdamienThe 585fdd4e61Sdamien.Nm 595fdd4e61Sdamiendriver can be configured to use 605fdd4e61SdamienWired Equivalent Privacy (WEP) or 6123b4b584SsthenWi-Fi Protected Access (WPA1 and WPA2). 6223b4b584SsthenWPA2 is the current encryption standard for wireless networks. 6323b4b584SsthenIt is strongly recommended that neither WEP nor WPA1 6423b4b584Ssthenare used as the sole mechanism to secure wireless communication, 6523b4b584Ssthendue to serious weaknesses. 6623b4b584SsthenWPA1 is disabled by default and may be enabled using the option 6723b4b584Ssthen.Qq Cm wpaprotos Ar wpa1,wpa2 . 6823b4b584SsthenFor standard WPA networks which use pre-shared keys (PSK), 6923b4b584Ssthenkeys are configured using the 7023b4b584Ssthen.Qq Cm wpakey 7123b4b584Ssthenoption. 7223b4b584SsthenWPA-Enterprise networks require use of the wpa_supplicant package. 735fdd4e61Sdamien.Pp 745fdd4e61SdamienThe 755fdd4e61Sdamien.Nm 765fdd4e61Sdamiendriver can be configured at runtime with 775fdd4e61Sdamien.Xr ifconfig 8 785fdd4e61Sdamienor on boot with 795fdd4e61Sdamien.Xr hostname.if 5 . 805fdd4e61Sdamien.Sh FILES 811e1b982aSkevloThe adapter needs firmware files to run, which are loaded on demand by 821e1b982aSkevlothe driver when the device is attached: 835fdd4e61Sdamien.Pp 845fdd4e61Sdamien.Bl -tag -width Ds -offset indent -compact 851e1b982aSkevlo.It Pa /etc/firmware/rsu-rtl8712 865fdd4e61Sdamien.El 875fdd4e61Sdamien.Sh HARDWARE 885fdd4e61SdamienThe following adapters should work: 895fdd4e61Sdamien.Pp 905fdd4e61Sdamien.Bl -tag -width Ds -offset indent -compact 915fdd4e61Sdamien.It ASUS USB-N10 92dad4ca11Skirby.It ASUS WL-167G V3 93d80993c2Sstsp.It Belkin F7D1101 v1 945fdd4e61Sdamien.It D-Link DWA-131 A1 9523105fddSdamien.It Hercules HWGUn-54 965fdd4e61Sdamien.It Hercules HWNUm-300 97f010e75bSjsg.It Planex GW-USNano 98c352cd82Skettenis.It Sitecom WL-349 v1 995fdd4e61Sdamien.It Sitecom WL-353 1008b191611Sjakemsr.It Sweex LW154 1015fdd4e61Sdamien.It TRENDnet TEW-648UB 1025fdd4e61Sdamien.It TRENDnet TEW-649UB 1035fdd4e61Sdamien.El 1045fdd4e61Sdamien.Sh EXAMPLES 105f0f562a5SjmcThe following example scans for available networks: 106f0f562a5Sjmc.Pp 107f0f562a5Sjmc.Dl # ifconfig rsu0 scan 108f0f562a5Sjmc.Pp 1095fdd4e61SdamienThe following 1105fdd4e61Sdamien.Xr hostname.if 5 111f0f562a5Sjmcexample configures rsu0 to join network 112f0f562a5Sjmc.Dq mynwid , 113f0f562a5Sjmcusing WPA key 114f0f562a5Sjmc.Dq mywpakey , 115f0f562a5Sjmcobtaining an IP address using DHCP: 1165fdd4e61Sdamien.Bd -literal -offset indent 117*d09093c1Sknjoin mynwid wpakey mywpakey 118b6ef1ff8Skninet autoconf 1195fdd4e61Sdamien.Ed 1205fdd4e61Sdamien.Sh DIAGNOSTICS 1215fdd4e61Sdamien.Bl -diag 122b07071f0Stedu.It "rsu0: error N, could not read firmware ..." 1235fdd4e61SdamienFor some reason, the driver was unable to read the microcode file from the 1245fdd4e61Sdamienfilesystem. 1255fdd4e61SdamienThe file might be missing or corrupted. 126b07071f0Stedu.It "rsu0: device timeout" 1275fdd4e61SdamienA frame dispatched to the hardware for transmission did not complete in time. 1285fdd4e61SdamienThe driver will reset the hardware. 1295fdd4e61SdamienThis should not happen. 1305fdd4e61Sdamien.El 1315fdd4e61Sdamien.Sh SEE ALSO 1325fdd4e61Sdamien.Xr arp 4 , 1335fdd4e61Sdamien.Xr ifmedia 4 , 1345fdd4e61Sdamien.Xr intro 4 , 1355fdd4e61Sdamien.Xr netintro 4 , 1365fdd4e61Sdamien.Xr usb 4 , 1375fdd4e61Sdamien.Xr hostname.if 5 , 1385fdd4e61Sdamien.Xr ifconfig 8 1395fdd4e61Sdamien.Sh HISTORY 1405fdd4e61SdamienThe 1415fdd4e61Sdamien.Nm 1425fdd4e61Sdamiendriver first appeared in 1435fdd4e61Sdamien.Ox 4.9 . 1445fdd4e61Sdamien.Sh AUTHORS 1455fdd4e61SdamienThe 1465fdd4e61Sdamien.Nm 1475fdd4e61Sdamiendriver was written by 148c110737dSmillert.An Damien Bergamini Aq Mt damien.bergamini@free.fr . 1495fdd4e61Sdamien.Sh CAVEATS 1505fdd4e61SdamienThe 1515fdd4e61Sdamien.Nm 1525fdd4e61Sdamiendriver does not support any of the 802.11n capabilities offered by the 1535fdd4e61Sdamienadapters. 1545fdd4e61SdamienAdditional work is required in 1555fdd4e61Sdamien.Xr ieee80211 9 1565fdd4e61Sdamienbefore those features can be supported. 157abf2c0f4Sjmc.Pp 158abf2c0f4SjmcThis driver does not support powersave mode. 159