share/man/man4/run.4

   1 .\" $OpenBSD: run.4,v 1.22 2009/11/23 06:16:32 jmc Exp $
   2 .\"
   3 .\" Copyright (c) 2008 Damien Bergamini <damien.bergamini@free.fr>
   4 .\"
   5 .\" Permission to use, copy, modify, and distribute this software for any
   6 .\" purpose with or without fee is hereby granted, provided that the above
   7 .\" copyright notice and this permission notice appear in all copies.
   8 .\"
   9 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  10 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  11 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  12 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  13 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  14 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  15 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  16 .\"
  17 .\" $FreeBSD$
  18 .\"
  19 .Dd July 9, 2012
  20 .Dt RUN 4
  21 .Os
  22 .Sh NAME
  23 .Nm run
  24 .Nd Ralink Technology USB IEEE 802.11a/g/n wireless network device
  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 run"
  35 .Cd "device wlan"
  36 .Cd "device wlan_amrr"
  37 .Ed
  38 .Pp
  39 Firmware is also needed, and provided by:
  40 .Bd -ragged -offset indent
  41 .Cd "device runfw"
  42 .Ed
  43 .Pp
  44 Alternatively, to load the driver as a
  45 module at boot time, place the following lines in
  46 .Xr loader.conf 5 :
  47 .Bd -literal -offset indent
  48 if_run_load="YES"
  49 runfw_load="YES"
  50 .Ed
  51 .Sh DESCRIPTION
  52 The
  53 .Nm
  54 driver supports USB 2.0 wireless adapters based on the Ralink RT2700U,
  55 RT2800U and RT3000U chipsets.
  56 .Pp
  57 The RT2700U chipset consists of two integrated chips, an RT2770 MAC/BBP and
  58 an RT2720 (1T2R) or RT2750 (dual-band 1T2R) radio transceiver.
  59 .Pp
  60 The RT2800U chipset consists of two integrated chips, an RT2870 MAC/BBP and
  61 an RT2820 (2T3R) or RT2850 (dual-band 2T3R) radio transceiver.
  62 .Pp
  63 The RT3000U is a single-chip solution based on an RT3070 MAC/BBP and
  64 an RT3020 (1T1R), RT3021 (1T2R) or RT3022 (2T2R) single-band radio
  65 transceiver.
  66 .Pp
  67 These are the modes the
  68 .Nm
  69 driver can operate in:
  70 .Bl -tag -width "IBSS-masterXX"
  71 .It BSS mode
  72 Also known as
  73 .Em infrastructure
  74 mode, this is used when associating with an access point, through
  75 which all traffic passes.
  76 This mode is the default.
  77 .It Host AP mode
  78 In this mode the driver acts as an access point (base station)
  79 for other cards.
  80 .It monitor mode
  81 In this mode the driver is able to receive packets without
  82 associating with an access point.
  83 This disables the internal receive filter and enables the card to
  84 capture packets from networks which it wouldn't normally have access to,
  85 or to scan for access points.
  86 .El
  87 .Pp
  88 The
  89 .Nm
  90 driver can be configured to use
  91 Wired Equivalent Privacy (WEP) or
  92 Wi-Fi Protected Access (WPA-PSK and WPA2-PSK).
  93 WPA is the de facto encryption standard for wireless networks.
  94 It is strongly recommended that WEP
  95 not be used as the sole mechanism
  96 to secure wireless communication,
  97 due to serious weaknesses in it.
  98 The
  99 .Nm
 100 driver offloads both encryption and decryption of data frames to the
 101 hardware for the WEP40, WEP104, TKIP(+MIC) and CCMP ciphers.
 102 .Pp
 103 The
 104 .Nm
 105 driver can be configured at runtime with
 106 .Xr ifconfig 8 .
 107 .Sh HARDWARE
 108 The
 109 .Nm
 110 driver supports the following wireless adapters:
 111 .Pp
 112 .Bl -tag -width Ds -offset indent -compact
 113 .It Airlink101 AWLL6090
 114 .It ASUS USB-N11
 115 .It ASUS USB-N13 ver. A1
 116 .It ASUS WL-160N
 117 .It Belkin F5D8051 ver 3000
 118 .It Belkin F5D8053
 119 .It Belkin F5D8055
 120 .It Belkin F6D4050 ver 1
 121 .It Buffalo WLI-UC-AG300N
 122 .It Buffalo WLI-UC-G300N
 123 .It Buffalo WLI-UC-G301N
 124 .It Buffalo WLI-UC-GN
 125 .It Buffalo WLI-UC-GNM
 126 .It Buffalo WLI-UC-GNM2
 127 .It Corega CG-WLUSB2GNL
 128 .It Corega CG-WLUSB2GNR
 129 .It Corega CG-WLUSB300AGN
 130 .It Corega CG-WLUSB300GNM
 131 .It D-Link DWA-130 rev B1
 132 .It D-Link DWA-140 rev B1, B2
 133 .It DrayTek Vigor N61
 134 .It Edimax EW-7711UAn
 135 .It Edimax EW-7711UTn
 136 .It Edimax EW-7717Un
 137 .It Edimax EW-7718Un
 138 .It Gigabyte GN-WB30N
 139 .It Gigabyte GN-WB31N
 140 .It Gigabyte GN-WB32L
 141 .It Hawking HWDN1
 142 .It Hawking HWUN1
 143 .It Hawking HWUN2
 144 .It Hercules HWNU-300
 145 .It Linksys WUSB54GC v3
 146 .It Linksys WUSB600N
 147 .It Logitec LAN-W150N/U2
 148 .It Mvix Nubbin MS-811N
 149 .It Planex GW-USMicroN
 150 .It Planex GW-US300MiniS
 151 .It Sitecom WL-182
 152 .It Sitecom WL-188
 153 .It Sitecom WL-301
 154 .It Sitecom WL-302
 155 .It Sitecom WL-315
 156 .It SMC SMCWUSBS-N2
 157 .It Sweex LW303
 158 .It Sweex LW313
 159 .It Unex DNUR-81
 160 .It Unex DNUR-82
 161 .It ZyXEL NWD210N
 162 .It ZyXEL NWD270N
 163 .El
 164 .Sh EXAMPLES
 165 Join an existing BSS network (i.e., connect to an access point):
 166 .Bd -literal -offset indent
 167 ifconfig wlan create wlandev run0 inet 192.168.0.20 \e
 168     netmask 0xffffff00
 169 .Ed
 170 .Pp
 171 Join a specific BSS network with network name
 172 .Dq Li my_net :
 173 .Pp
 174 .Dl "ifconfig wlan create wlandev run0 ssid my_net up"
 175 .Pp
 176 Join a specific BSS network with 64-bit WEP encryption:
 177 .Bd -literal -offset indent
 178 ifconfig wlan create wlandev run0 ssid my_net \e
 179         wepmode on wepkey 0x1234567890 weptxkey 1 up
 180 .Ed
 181 .Pp
 182 Join a specific BSS network with 128-bit WEP encryption:
 183 .Bd -literal -offset indent
 184 ifconfig wlan create wlandev run0 wlanmode adhoc ssid my_net \e
 185     wepmode on wepkey 0x01020304050607080910111213 weptxkey 1
 186 .Ed
 187 .Sh DIAGNOSTICS
 188 .Bl -diag
 189 .It "run%d: faild load firmware of file runfw"
 190 For some reason, the driver was unable to read the microcode file from the
 191 filesystem.
 192 The file might be missing or corrupted.
 193 .It "run%d: could not load 8051 microcode"
 194 An error occurred while attempting to upload the microcode to the onboard 8051
 195 microcontroller unit.
 196 .It "run%d: device timeout"
 197 A frame dispatched to the hardware for transmission did not complete in time.
 198 The driver will reset the hardware.
 199 This should not happen.
 200 .El
 201 .Sh SEE ALSO
 202 .Xr runfw 4 ,
 203 .Xr intro 4 ,
 204 .Xr netintro 4 ,
 205 .Xr usb 4 ,
 206 .Xr wlan 4 ,
 207 .Xr wlan_amrr 4 ,
 208 .Xr wlan_ccmp 4 ,
 209 .Xr wlan_tkip 4 ,
 210 .Xr wlan_wep 4 ,
 211 .Xr wlan_xauth 4 ,
 212 .Xr ifconfig 8 ,
 213 .Xr hostapd 8 ,
 214 .Xr wpa_supplicant 8
 215 .Pp
 216 Ralink Technology:
 217 .Pa http://www.ralinktech.com/
 218 .Sh HISTORY
 219 The
 220 .Nm
 221 driver first appeared in
 222 .Ox 4.5 .
 223 .Sh AUTHORS
 224 The
 225 .Nm
 226 driver was written by
 227 .An Damien Bergamini Aq damien@openbsd.org .
 228 .Sh CAVEATS
 229 The
 230 .Nm
 231 driver does not support any of the 802.11n capabilities offered by the
 232 RT2800 and RT3000 chipsets.