share/man/man4/rum.4

   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
  26 To compile this driver into the kernel,
  27 place the following lines in your
  28 kernel 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
  39 Alternatively, to load the driver as a
  40 module at boot time, place the following line in
  41 .Xr loader.conf 5 :
  42 .Bd -literal -offset indent
  43 if_rum_load="YES"
  44 .Ed
  45 .Sh DESCRIPTION
  46 The
  47 .Nm
  48 driver supports USB 2.0 and and PCI Express Mini Card wireless adapters based on
  49 the Ralink RT2501USB and RT2601USB chipsets.
  50 .Pp
  51 Ralink PCI Express Mini Card adapters show up as normal USB 2.0 devices and
  52 are thus handled by the
  53 .Nm
  54 driver.
  55 .Pp
  56 The RT2501USB chipset is the second generation of 802.11a/b/g adapters
  57 from Ralink.
  58 It consists of two integrated chips,
  59 an RT2571W MAC/BBP and an RT2528 or RT5226 radio transceiver.
  60 .Pp
  61 The RT2601USB chipset consists of two integrated chips,
  62 an RT2671 MAC/BBP and an RT2527 or RT5225 radio transceiver.
  63 This chipset uses the MIMO (multiple-input multiple-output) technology with
  64 multiple antennas to extend the operating range of the adapter and to achieve
  65 higher throughput.
  66 MIMO is the basis of the forthcoming IEEE 802.11n standard.
  67 .Sh HARDWARE
  68 The
  69 .Nm
  70 driver supports the following adapters:
  71 .Pp
  72 .Bl -bullet -compact
  73 .It
  74 3Com Aolynk WUB320g
  75 .It
  76 Abocom WUG2700
  77 .It
  78 Airlink101 AWLL5025
  79 .It
  80 ASUS WL-167g ver 2
  81 .It
  82 Belkin F5D7050 ver 3
  83 .It
  84 Belkin F5D9050 ver 3
  85 .It
  86 Buffalo WLI-U2-SG54HP
  87 .It
  88 Buffalo WLI-U2-G54HP
  89 .It
  90 CNet CWD-854 ver F
  91 .It
  92 Cisco-Linksys WUSB54G rev C
  93 .It
  94 Conceptronic C54RU ver 2
  95 .It
  96 Corega CG-WLUSB2GO
  97 .It
  98 D-Link DWL-G122 rev C1
  99 .It
 100 D-Link WUA-1340
 101 .It
 102 Digitus DN-7003GR
 103 .It
 104 Edimax EW-7318USG
 105 .It
 106 Gigabyte GN-WB01GS
 107 .It
 108 Gigabyte GN-WI05GS
 109 .It
 110 Hawking HWUG1
 111 .It
 112 Hawking HWU54DM
 113 .It
 114 Hercules HWGUSB2-54-LB
 115 .It
 116 Hercules HWGUSB2-54V2-AP
 117 .It
 118 LevelOne WNC-0301USB v3
 119 .It
 120 Linksys WUSB54G rev C
 121 .It
 122 Linksys WUSB54GR
 123 .It
 124 Planex GW-US54HP
 125 .It
 126 Planex GW-US54Mini2
 127 .It
 128 Planex GW-USMM
 129 .It
 130 Senao NUB-3701
 131 .It
 132 Sitecom WL-113 ver 2
 133 .It
 134 Sitecom WL-172
 135 .It
 136 Sweex LW053
 137 .It
 138 TP-LINK TL-WN321G
 139 .El
 140 .Sh EXAMPLES
 141 Join 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
 145 Join 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
 150 Join a specific BSS network with 40-bit WEP encryption:
 151 .Bd -literal -offset indent
 152 ifconfig rum0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e
 153     wepmode on wepkey 0x1234567890 weptxkey 1
 154 .Ed
 155 .Pp
 156 Join a specific BSS network with 104-bit WEP encryption:
 157 .Bd -literal -offset indent
 158 ifconfig 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"
 164 An error occurred while attempting to upload the microcode to the onboard 8051
 165 microcontroller unit.
 166 .It "rum%d: device timeout"
 167 The driver will reset the hardware.
 168 This 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
 185 The
 186 .Nm
 187 driver first appeared in
 188 .Ox 4.0 .
 189 .Sh CAVEATS
 190 The
 191 .Nm
 192 driver supports automatic adaptation of the transmit speed in IBSS
 193 and HostAP operating modes,
 194 but it does not work well if there are more than one peer node.
 195 .Sh AUTHORS
 196 .An -nosplit
 197 The
 198 .Nm
 199 driver was written by
 200 .An Niall O'Higgins Aq niallo@openbsd.org
 201 and
 202 .An Damien Bergamini Aq damien@openbsd.org .