1.\" $OpenBSD: rum.4,v 1.16 2006/10/19 16:53:48 jsg Exp $ 2.\" 3.\" Copyright (c) 2005, 2006 4.\" 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 26, 2008 19.Os 20.Dt RUM 4 21.Sh NAME 22.Nm rum 23.Nd "Ralink Technology RT2501USB/RT2601USB IEEE 802.11 driver" 24.Sh SYNOPSIS 25To compile this driver into the kernel, 26place the following lines in your 27kernel configuration file: 28.Bd -ragged -offset indent 29.Cd "device ehci" 30.Cd "device uhci" 31.Cd "device ohci" 32.Cd "device usb" 33.Cd "device rum" 34.Cd "device wlan" 35.Cd "device wlan_ratectl_onoe" 36.Ed 37.Pp 38Alternatively, to load the driver as a 39module at boot time, place the following line in 40.Xr loader.conf 5 : 41.Bd -literal -offset indent 42if_rum_load="YES" 43.Ed 44.Sh DESCRIPTION 45The 46.Nm 47driver supports USB 2.0 and and PCI Express Mini Card wireless adapters based on 48the Ralink RT2501USB and RT2601USB chipsets. 49.Pp 50Ralink PCI Express Mini Card adapters show up as normal USB 2.0 devices and 51are thus handled by the 52.Nm 53driver. 54.Pp 55The RT2501USB chipset is the second generation of 802.11a/b/g adapters 56from Ralink. 57It consists of two integrated chips, 58an RT2571W MAC/BBP and an RT2528 or RT5226 radio transceiver. 59.Pp 60The RT2601USB chipset consists of two integrated chips, 61an RT2671 MAC/BBP and an RT2527 or RT5225 radio transceiver. 62This chipset uses the MIMO (multiple-input multiple-output) technology with 63multiple antennas to extend the operating range of the adapter and to achieve 64higher throughput. 65MIMO is the basis of the forthcoming IEEE 802.11n standard. 66.Sh HARDWARE 67The 68.Nm 69driver supports the following adapters: 70.Pp 71.Bl -bullet -compact 72.It 733Com Aolynk WUB320g 74.It 75Abocom WUG2700 76.It 77Airlink101 AWLL5025 78.It 79ASUS WL-167g ver 2 80.It 81Belkin F5D7050 ver 3 82.It 83Belkin F5D9050 ver 3 84.It 85Buffalo WLI-U2-SG54HP 86.It 87Buffalo WLI-U2-G54HP 88.It 89CNet CWD-854 ver F 90.It 91Cisco-Linksys WUSB54G rev C 92.It 93Conceptronic C54RU ver 2 94.It 95Corega CG-WLUSB2GO 96.It 97D-Link DWL-G122 rev C1 98.It 99D-Link WUA-1340 100.It 101Digitus DN-7003GR 102.It 103Edimax EW-7318USG 104.It 105Gigabyte GN-WB01GS 106.It 107Gigabyte GN-WI05GS 108.It 109Hawking HWUG1 110.It 111Hawking HWU54DM 112.It 113Hercules HWGUSB2-54-LB 114.It 115Hercules HWGUSB2-54V2-AP 116.It 117LevelOne WNC-0301USB v3 118.It 119Linksys WUSB54G rev C 120.It 121Linksys WUSB54GR 122.It 123Planex GW-US54HP 124.It 125Planex GW-US54Mini2 126.It 127Planex GW-USMM 128.It 129Senao NUB-3701 130.It 131Sitecom WL-113 ver 2 132.It 133Sitecom WL-172 134.It 135Sweex LW053 136.It 137TP-LINK TL-WN321G 138.El 139.Sh EXAMPLES 140Refer to the 141.Sx EXAMPLES 142section of 143.Xr wlan 4 . 144.Sh DIAGNOSTICS 145.Bl -diag 146.It "rum%d: could not load 8051 microcode" 147An error occurred while attempting to upload the microcode to the onboard 8051 148microcontroller unit. 149.It "rum%d: device timeout" 150The driver will reset the hardware. 151This should not happen. 152.El 153.Sh SEE ALSO 154.Xr arp 4 , 155.Xr ifmedia 4 , 156.Xr netintro 4 , 157.Xr usb 4 , 158.Xr wlan 4 , 159.Xr wlan_ratectl 4 , 160.Xr hostapd 8 , 161.Xr ifconfig 8 , 162.Xr wpa_supplicant 8 163.Rs 164.%T "Ralink Technology" 165.%O http://www.ralinktech.com/ 166.Re 167.Sh HISTORY 168The 169.Nm 170driver first appeared in 171.Ox 4.0 . 172.Sh CAVEATS 173The 174.Nm 175driver supports automatic adaptation of the transmit speed in IBSS 176and HostAP operating modes, 177but it does not work well if there are more than one peer node. 178.Sh AUTHORS 179.An -nosplit 180The 181.Nm 182driver was written by 183.An Niall O'Higgins Aq Mt niallo@openbsd.org 184and 185.An Damien Bergamini Aq Mt damien@openbsd.org . 186