1.\" $OpenBSD: rum.4,v 1.17 2006/10/22 08:29:01 damien Exp $ 2.\" $NetBSD: rum.4,v 1.11 2020/09/21 17:52:31 nia Exp $ 3.\" 4.\" Copyright (c) 2005, 2006 5.\" Damien Bergamini <damien.bergamini@free.fr> 6.\" 7.\" Permission to use, copy, modify, and distribute this software for any 8.\" purpose with or without fee is hereby granted, provided that the above 9.\" copyright notice and this permission notice appear in all copies. 10.\" 11.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 12.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 13.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 14.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 15.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 16.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 17.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 18.\" 19.Dd September 21, 2020 20.Dt RUM 4 21.Os 22.Sh NAME 23.Nm rum 24.Nd Ralink Technology USB IEEE 802.11a/b/g wireless network device 25.Sh SYNOPSIS 26.Cd "rum* at uhub? port ?" 27.Sh DESCRIPTION 28The 29.Nm 30driver supports USB 2.0 wireless adapters based on the Ralink RT2501USB 31and RT2601USB chipsets. 32.Pp 33The RT2501USB chipset is the second generation of 802.11a/b/g adapters from 34Ralink. 35It consists of two integrated chips, an RT2571W MAC/BBP and an RT2528 or 36RT5226 radio transceiver. 37.Pp 38The RT2601USB chipset consists of two integrated chips, an RT2671 MAC/BBP and 39an RT2527 or RT5225 radio transceiver. 40This chipset uses the MIMO (multiple-input multiple-output) technology with 41multiple antennas to extend the operating range of the adapter and to achieve 42higher throughput. 43MIMO is the basis of the forthcoming IEEE 802.11n standard. 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.Sh CONFIGURATION 86The 87.Nm 88driver can be configured at runtime with 89.Xr ifconfig 8 90or on boot with 91.Xr ifconfig.if 5 92using the following parameters: 93.Bl -tag -width Ds 94.It Cm bssid Ar bssid 95Set the desired BSSID. 96.It Fl bssid 97Unset the desired BSSID. 98The interface will automatically select a BSSID in this mode, which is 99the default. 100.It Cm chan Ar n 101Set the channel (radio frequency) to be used by the driver based on 102the given channel ID 103.Ar n . 104.It Fl chan 105Unset the desired channel to be used by the driver. 106The driver will automatically select a channel in this mode, which is 107the default. 108.It Cm media Ar media 109The 110.Nm 111driver supports the following 112.Ar media 113types: 114.Pp 115.Bl -tag -width autoselect -compact 116.It Cm autoselect 117Enable autoselection of the media type and options. 118.It Cm DS1 119Set 802.11b DS 1Mbps operation. 120.It Cm DS2 121Set 802.11b DS 2Mbps operation. 122.It Cm DS5 123Set 802.11b DS 5.5Mbps operation. 124.It Cm DS11 125Set 802.11b DS 11Mbps operation. 126.It Cm OFDM6 127Set 802.11a/g OFDM 6Mbps operation. 128.It Cm OFDM9 129Set 802.11a/g OFDM 9Mbps operation. 130.It Cm OFDM12 131Set 802.11a/g OFDM 12Mbps operation. 132.It Cm OFDM18 133Set 802.11a/g OFDM 18Mbps operation. 134.It Cm OFDM24 135Set 802.11a/g OFDM 24Mbps operation. 136.It Cm OFDM36 137Set 802.11a/g OFDM 36Mbps operation. 138.It Cm OFDM48 139Set 802.11a/g OFDM 48Mbps operation. 140.It Cm OFDM54 141Set 802.11a/g OFDM 54Mbps operation. 142.El 143.It Cm mediaopt Ar opts 144The 145.Nm 146driver supports the following media options: 147.Pp 148.Bl -tag -width monitor -compact 149.It Cm hostap 150Select Host AP operation. 151.It Cm ibss 152Select IBSS operation. 153.It Cm monitor 154Select monitor mode. 155.El 156.It Fl mediaopt Ar opts 157Disable the specified media options on the driver and return it to the 158default mode of operation (BSS). 159.It Cm mode Ar mode 160The 161.Nm 162driver supports the following modes: 163.Pp 164.Bl -tag -width 11b -compact 165.It Cm 11a 166Force 802.11a operation. 167.It Cm 11b 168Force 802.11b operation. 169.It Cm 11g 170Force 802.11g operation. 171.El 172.It Cm nwid Ar id 173Set the network ID. 174The 175.Ar id 176can either be any text string up to 32 characters in length, 177or a series of hexadecimal digits up to 64 digits. 178An empty 179.Ar id 180string allows the interface to connect to any available access points. 181By default the 182.Nm 183driver uses an empty string. 184Note that network ID is synonymous with Extended Service Set ID (ESSID). 185.It Cm nwkey Ar key 186Enable WEP encryption using the specified 187.Ar key . 188The 189.Ar key 190can either be a string, a series of hexadecimal digits (preceded by 191.Sq 0x ) , 192or a set of keys of the form 193.Dq n:k1,k2,k3,k4 , 194where 195.Sq n 196specifies which of the keys will be used for transmitted packets, 197and the four keys, 198.Dq k1 199through 200.Dq k4 , 201are configured as WEP keys. 202If a set of keys is specified, a comma 203.Pq Sq \&, 204within the key must be escaped with a backslash. 205Note that if multiple keys are used, their order must be the same within 206the network. 207.Nm 208is capable of using both 40-bit (5 characters or 10 hexadecimal digits) 209or 104-bit (13 characters or 26 hexadecimal digits) keys. 210.It Fl nwkey 211Disable WEP encryption. 212This is the default mode of operation. 213.El 214.Sh FILES 215The following firmware file is loaded when an interface is brought up: 216.Pp 217.Bl -tag -width Ds -offset indent -compact 218.It /libdata/firmware/rum/rum-rt2573 219.El 220See 221.Xr firmload 9 222for how to change this. 223.Sh HARDWARE 224The following adapters should work: 225.Pp 226.Bl -tag -width Ds -offset indent -compact 227.It Airlink101 AWLL5025 228.It ASUS WL-167g ver 2 229.It Belkin F5D7050 ver 3 230.It Belkin F5D9050 ver 3 231.It CNet CWD-854 ver F 232.It Conceptronic C54RU ver 2 233.It D-Link DWL-G122 rev C1 234.It D-Link WUA-1340 235.It Edimax EW-7318USG 236.It Gigabyte GN-WB01GS 237.It Hawking HWUG1 238.It LevelOne WNC-0301USB 239.It Linksys WUSB54G rev C 240.It Planex GW-USMM 241.It Senao NUB-3701 242.It Sitecom WL-113 ver 2 243.It Sitecom WL-172 244.It Synet MW-P54SS 245.It TP-LINK TL-WN321G 246.El 247.Sh EXAMPLES 248The following 249.Xr ifconfig.if 5 250example configures rum0 to join whatever network is available on boot, 251using WEP key 252.Dq 0x1deadbeef1 , 253channel 11: 254.Bd -literal -offset indent 255inet 192.168.1.1 netmask 255.255.255.0 nwkey 0x1deadbeef1 chan 11 256.Ed 257.Pp 258The following 259.Xr ifconfig.if 5 260example creates a host-based access point on boot: 261.Bd -literal -offset indent 262inet 192.168.1.1 netmask 255.255.255.0 media autoselect \e 263 mediaopt hostap nwid my_net chan 11 264.Ed 265.Pp 266Configure rum0 for WEP, using hex key 267.Dq 0x1deadbeef1 : 268.Bd -literal -offset indent 269# ifconfig rum0 nwkey 0x1deadbeef1 270.Ed 271.Pp 272Return rum0 to its default settings: 273.Bd -literal -offset indent 274# ifconfig rum0 -bssid -chan media autoselect \e 275 nwid "" -nwkey 276.Ed 277.Pp 278Join an existing BSS network, 279.Dq my_net : 280.Bd -literal -offset indent 281# ifconfig rum0 192.168.1.1 netmask 0xffffff00 nwid my_net 282.Ed 283.Sh DIAGNOSTICS 284.Bl -diag 285.It "rum%d: failed loadfirmware of file %s" 286For some reason, the driver was unable to read the microcode file from the 287filesystem. 288The file might be missing or corrupted. 289.It "rum%d: could not load 8051 microcode" 290An error occurred while attempting to upload the microcode to the onboard 8051 291microcontroller unit. 292.It "rum%d: device timeout" 293A frame dispatched to the hardware for transmission did not complete in time. 294The driver will reset the hardware. 295This should not happen. 296.El 297.Sh SEE ALSO 298.Xr arp 4 , 299.Xr ifmedia 4 , 300.Xr netintro 4 , 301.Xr usb 4 , 302.Xr ifconfig.if 5 , 303.Xr hostapd 8 , 304.Xr ifconfig 8 , 305.Xr firmload 9 306.Pp 307.Lk http://www.ralinktech.com "Ralink Technology" 308.Sh HISTORY 309The 310.Nm 311driver first appeared in 312.Nx 4.0 313and 314.Ox 4.0 . 315.Sh AUTHORS 316The 317.Nm 318driver was written by 319.An Niall O'Higgins Aq Mt niallo@openbsd.org 320and 321.An Damien Bergamini Aq Mt damien@openbsd.org . 322.Sh CAVEATS 323The 324.Nm 325driver supports automatic control of the transmit speed in BSS mode only. 326Therefore the use of a 327.Nm 328adapter in Host AP mode is discouraged. 329.Pp 330The Synet MW-P54SS USB Wireless Broadband Router first attaches as a virtual 331.Xr cd 4 332device on the 333.Xr umass 4 334mass storage bus. 335It will re-attach with this driver after using 336.Xr eject 1 337on the corresponding device. 338