xref: /freebsd/share/man/man4/rum.4 (revision 0738dfc386ffa043d9a5345f34d401dc3bbed885)
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