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