10738dfc3SKevin Lo.\" 20738dfc3SKevin Lo.\" Copyright (c) 2005-2007 30738dfc3SKevin Lo.\" Damien Bergamini <damien.bergamini@free.fr> 40738dfc3SKevin Lo.\" 50738dfc3SKevin Lo.\" Permission to use, copy, modify, and distribute this software for any 60738dfc3SKevin Lo.\" purpose with or without fee is hereby granted, provided that the above 70738dfc3SKevin Lo.\" copyright notice and this permission notice appear in all copies. 80738dfc3SKevin Lo.\" 90738dfc3SKevin Lo.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 100738dfc3SKevin Lo.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 110738dfc3SKevin Lo.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 120738dfc3SKevin Lo.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 130738dfc3SKevin Lo.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 140738dfc3SKevin Lo.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 150738dfc3SKevin Lo.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 160738dfc3SKevin Lo.\" 170738dfc3SKevin Lo.\" $FreeBSD$ 180738dfc3SKevin Lo.\" 190738dfc3SKevin Lo.Dd February 19, 2006 200738dfc3SKevin Lo.Os 210738dfc3SKevin Lo.Dt RUM 4 220738dfc3SKevin Lo.Sh NAME 230738dfc3SKevin Lo.Nm rum 240738dfc3SKevin Lo.Nd Ralink Technology USB IEEE 802.11a/b/g wireless network device 250738dfc3SKevin Lo.Sh SYNOPSIS 260738dfc3SKevin LoTo compile this driver into the kernel, 270738dfc3SKevin Loplace the following lines in your 280738dfc3SKevin Lokernel configuration file: 290738dfc3SKevin Lo.Bd -ragged -offset indent 300738dfc3SKevin Lo.Cd "device ehci" 310738dfc3SKevin Lo.Cd "device uhci" 320738dfc3SKevin Lo.Cd "device ohci" 330738dfc3SKevin Lo.Cd "device usb" 340738dfc3SKevin Lo.Cd "device rum" 350738dfc3SKevin Lo.Cd "device wlan" 360738dfc3SKevin Lo.Cd "device wlan_amrr" 370738dfc3SKevin Lo.Ed 380738dfc3SKevin Lo.Pp 390738dfc3SKevin LoAlternatively, to load the driver as a 400738dfc3SKevin Lomodule at boot time, place the following line in 410738dfc3SKevin Lo.Xr loader.conf 5 : 420738dfc3SKevin Lo.Bd -literal -offset indent 430738dfc3SKevin Loif_rum_load="YES" 440738dfc3SKevin Lo.Ed 450738dfc3SKevin Lo.Sh DESCRIPTION 460738dfc3SKevin LoThe 470738dfc3SKevin Lo.Nm 480738dfc3SKevin Lodriver supports USB 2.0 and PCI Express Mini Card wireless adapters based on the 490738dfc3SKevin LoRalink RT2501USB and RT2601USB chipsets. 500738dfc3SKevin Lo.Pp 510738dfc3SKevin LoRalink PCI Express Mini Card adapters show up as normal USB 2.0 devices and are 520738dfc3SKevin Lothus handled by the 530738dfc3SKevin Lo.Nm 540738dfc3SKevin Lodriver. 550738dfc3SKevin Lo.Pp 560738dfc3SKevin LoThe RT2501USB chipset is the second generation of 802.11a/b/g adapters from 570738dfc3SKevin LoRalink. 580738dfc3SKevin LoIt consists of two integrated chips, an RT2571W MAC/BBP and an RT2528 or 590738dfc3SKevin LoRT5226 radio transceiver. 600738dfc3SKevin Lo.Pp 610738dfc3SKevin LoThe RT2601USB chipset consists of two integrated chips, an RT2671 MAC/BBP and 620738dfc3SKevin Loan RT2527 or RT5225 radio transceiver. 630738dfc3SKevin LoThis chipset uses the MIMO (multiple-input multiple-output) technology with 640738dfc3SKevin Lomultiple antennas to extend the operating range of the adapter and to achieve 650738dfc3SKevin Lohigher throughput. 660738dfc3SKevin Lo.Sh HARDWARE 670738dfc3SKevin LoThe following adapters should work: 680738dfc3SKevin Lo.Pp 690738dfc3SKevin Lo.Bl -column -compact ".Li Atlantis Land A02-PCM-W54" "Bus" 700738dfc3SKevin Lo.It Em Card Ta Em Bus 710738dfc3SKevin Lo.It Li "3Com Aolynk WUB320g" Ta USB 720738dfc3SKevin Lo.It Li "Abocom WUG2700" Ta USB 730738dfc3SKevin Lo.It Li "Airlink101 AWLL5025" Ta USB 740738dfc3SKevin Lo.It Li "ASUS WL-167g ver 2" Ta USB 750738dfc3SKevin Lo.It Li "Belkin F5D7050 ver 3" Ta USB 760738dfc3SKevin Lo.It Li "Belkin F5D9050 ver 3" Ta USB 770738dfc3SKevin Lo.It Li "Buffalo WLI-U2-SG54HP" Ta USB 780738dfc3SKevin Lo.It Li "Buffalo WLI-U2-G54HP" Ta USB 790738dfc3SKevin Lo.It Li "CNet CWD-854 ver F" Ta USB 800738dfc3SKevin Lo.It Li "Conceptronic C54RU ver 2" Ta USB 810738dfc3SKevin Lo.It Li "Corega CG-WLUSB2GO" Ta USB 820738dfc3SKevin Lo.It Li "D-Link DWL-G122 rev C1" Ta USB 830738dfc3SKevin Lo.It Li "D-Link WUA-1340" Ta USB 840738dfc3SKevin Lo.It Li "Digitus DN-7003GR" Ta USB 850738dfc3SKevin Lo.It Li "Edimax EW-7318USG" Ta USB 860738dfc3SKevin Lo.It Li "Gigabyte GN-WB01GS" Ta USB 870738dfc3SKevin Lo.It Li "Gigabyte GN-WI05GS" Ta USB 880738dfc3SKevin Lo.It Li "Hawking HWUG1" Ta USB 890738dfc3SKevin Lo.It Li "Hawking HWU54DM" Ta USB 900738dfc3SKevin Lo.It Li "Hercules HWGUSB2-54-LB" Ta USB 910738dfc3SKevin Lo.It Li "Hercules HWGUSB2-54V2-AP" Ta USB 920738dfc3SKevin Lo.It Li "LevelOne WNC-0301USB v3" Ta USB 930738dfc3SKevin Lo.It Li "Linksys WUSB54G rev C" Ta USB 940738dfc3SKevin Lo.It Li "Linksys WUSB54GR" Ta USB 950738dfc3SKevin Lo.It Li "Planex GW-US54HP" Ta USB 960738dfc3SKevin Lo.It Li "Planex GW-US54Mini2" Ta USB 970738dfc3SKevin Lo.It Li "Planex GW-USMM" Ta USB 980738dfc3SKevin Lo.It Li "Senao NUB-3701" Ta USB 990738dfc3SKevin Lo.It Li "Sitecom WL-113 ver 2" Ta USB 1000738dfc3SKevin Lo.It Li "Sitecom WL-172" Ta USB 1010738dfc3SKevin Lo.It Li "Sweex LW053" Ta USB 1020738dfc3SKevin Lo.It Li "TP-LINK TL-WN321G" Ta USB 1030738dfc3SKevin Lo.El 1040738dfc3SKevin Lo.Sh EXAMPLES 1050738dfc3SKevin LoJoin an existing BSS network (i.e., connect to an access point): 1060738dfc3SKevin Lo.Pp 1070738dfc3SKevin Lo.Dl "ifconfig rum0 inet 192.168.0.20 netmask 0xffffff00" 1080738dfc3SKevin Lo.Pp 1090738dfc3SKevin LoJoin a specific BSS network with network name 1100738dfc3SKevin Lo.Dq Li my_net : 1110738dfc3SKevin Lo.Pp 1120738dfc3SKevin Lo.Dl "ifconfig rum0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net" 1130738dfc3SKevin Lo.Pp 1140738dfc3SKevin LoJoin a specific BSS network with 40-bit WEP encryption: 1150738dfc3SKevin Lo.Bd -literal -offset indent 1160738dfc3SKevin Loifconfig rum0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e 1170738dfc3SKevin Lo wepmode on wepkey 0x1234567890 weptxkey 1 1180738dfc3SKevin Lo.Ed 1190738dfc3SKevin Lo.Pp 1200738dfc3SKevin LoJoin a specific BSS network with 104-bit WEP encryption: 1210738dfc3SKevin Lo.Bd -literal -offset indent 1220738dfc3SKevin Loifconfig rum0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e 1230738dfc3SKevin Lo wepmode on wepkey 0x01020304050607080910111213 weptxkey 1 1240738dfc3SKevin Lo.Ed 1250738dfc3SKevin Lo.Sh DIAGNOSTICS 1260738dfc3SKevin Lo.Bl -diag 1270738dfc3SKevin Lo.It "rum%d: could not load 8051 microcode" 1280738dfc3SKevin LoAn error occurred while attempting to upload the microcode to the onboard 8051 1290738dfc3SKevin Lomicrocontroller unit. 1300738dfc3SKevin LoThe driver will reset the hardware. 1310738dfc3SKevin LoThis should not happen. 1320738dfc3SKevin Lo.El 1330738dfc3SKevin Lo.Sh SEE ALSO 1340738dfc3SKevin Lo.Xr altq 4 , 1350738dfc3SKevin Lo.Xr arp 4 , 1360738dfc3SKevin Lo.Xr netintro 4 , 1370738dfc3SKevin Lo.Xr usb 4 , 1380738dfc3SKevin Lo.Xr wlan 4 , 1390738dfc3SKevin Lo.Xr ifconfig 8 1400738dfc3SKevin Lo.Rs 1410738dfc3SKevin Lo.%T "Ralink Technology" 1420738dfc3SKevin Lo.%O http://www.ralinktech.com/ 1430738dfc3SKevin Lo.Re 1440738dfc3SKevin Lo.Sh HISTORY 1450738dfc3SKevin LoThe 1460738dfc3SKevin Lo.Nm 1470738dfc3SKevin Lodriver first appeared in 1480738dfc3SKevin Lo.Ox 4.0 . 1490738dfc3SKevin Lo.Sh CAVEATS 1500738dfc3SKevin Lo.Pp 1510738dfc3SKevin LoThe 1520738dfc3SKevin Lo.Nm 1530738dfc3SKevin Lodriver supports automatic control of the transmit speed in BSS mode only. 1540738dfc3SKevin LoTherefore the use of a 1550738dfc3SKevin Lo.Nm 1560738dfc3SKevin Loadapter in Host AP mode is discouraged. 1570738dfc3SKevin Lo.Sh AUTHORS 1580738dfc3SKevin LoThe 1590738dfc3SKevin Lo.Nm 1600738dfc3SKevin Lodriver was written by 1610738dfc3SKevin Lo.An Niall O'Higgins Aq niallo@openbsd.org 1620738dfc3SKevin Loand 1630738dfc3SKevin Lo.An Damien Bergamini Aq damien@openbsd.org . 164