1 .\" $OpenBSD: run.4,v 1.22 2009/11/23 06:16:32 jmc Exp $
3 .\" Copyright (c) 2008 Damien Bergamini <damien.bergamini@free.fr>
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.
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.
24 .Nd Ralink Technology USB IEEE 802.11a/g/n wireless network device
26 To compile this driver into the kernel,
27 place the following lines in your
28 kernel configuration file:
29 .Bd -ragged -offset indent
36 .Cd "device wlan_amrr"
39 Firmware is also needed, and provided by:
40 .Bd -ragged -offset indent
44 Alternatively, to load the driver as a
45 module at boot time, place the following lines in
47 .Bd -literal -offset indent
54 driver supports USB 2.0 wireless adapters based on the Ralink RT2700U,
55 RT2800U, RT3000U and RT3900E chipsets.
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.
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.
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
67 The RT3900E is a single-chip USB 2.0 802.11n solution.
68 The MAC/Baseband Processor can be an RT3593, RT5390, RT5392 or an RT5592.
69 The radio can be an RT3053, RT5370, RT5372 or an RT5572.
70 The RT3053 chip operates in the 2GHz and 5GHz spectra and supports up to
71 3 transmit paths and 3 receiver paths (3T3R).
72 The RT5370 chip operates in the 2GHz spectrum and supports 1 transmit path
73 and 1 receiver path (1T1R).
74 The RT5372 chip operates in the 2GHz spectrum and supports up to 2 transmit
75 paths and 2 receiver paths (2T2R).
76 The RT5572 chip operates in the 2GHz and 5GHz spectra and supports up to
77 2 transmit paths and 2 receiver paths (2T2R).
79 These are the modes the
81 driver can operate in:
82 .Bl -tag -width "IBSS-masterXX"
86 mode, this is used when associating with an access point, through
87 which all traffic passes.
88 This mode is the default.
90 In this mode the driver acts as an access point (base station)
93 In this mode the driver is able to receive packets without
94 associating with an access point.
95 This disables the internal receive filter and enables the card to
96 capture packets from networks which it wouldn't normally have access to,
97 or to scan for access points.
102 driver can be configured to use
103 Wired Equivalent Privacy (WEP) or
104 Wi-Fi Protected Access (WPA-PSK and WPA2-PSK).
105 WPA is the de facto encryption standard for wireless networks.
106 It is strongly recommended that WEP
107 not be used as the sole mechanism
108 to secure wireless communication,
109 due to serious weaknesses in it.
112 driver offloads both encryption and decryption of data frames to the
113 hardware for the WEP40, WEP104, TKIP(+MIC) and CCMP ciphers.
117 driver can be configured at runtime with
122 driver supports the following wireless adapters:
124 .Bl -tag -width Ds -offset indent -compact
125 .It Airlink101 AWLL6090
127 .It ASUS USB-N13 ver. A1
131 .It Belkin F5D8051 ver 3000
134 .It Belkin F6D4050 ver 1
136 .It Buffalo WLI-UC-AG300N
137 .It Buffalo WLI-UC-G300HP
138 .It Buffalo WLI-UC-G300N
139 .It Buffalo WLI-UC-G301N
140 .It Buffalo WLI-UC-GN
141 .It Buffalo WLI-UC-GNM
142 .It Buffalo WLI-UC-GNM2
143 .It Corega CG-WLUSB2GNL
144 .It Corega CG-WLUSB2GNR
145 .It Corega CG-WLUSB300AGN
146 .It Corega CG-WLUSB300GNM
147 .It D-Link DWA-130 rev B1
148 .It D-Link DWA-130 rev F1
149 .It D-Link DWA-140 rev B1, B2, B3, \&D1
150 .It D-Link DWA-160 rev B2
152 .It DrayTek Vigor N61
153 .It Edimax EW-7711UAn
154 .It Edimax EW-7711UTn
157 .It Edimax EW-7733UnD
158 .It Gigabyte GN-WB30N
159 .It Gigabyte GN-WB31N
160 .It Gigabyte GN-WB32L
164 .It Hercules HWNU-300
165 .It Linksys WUSB54GC v3
167 .It Logitec LAN-W150N/U2
168 .It Mvix Nubbin MS-811N
169 .It Panda Wireless PAU06
170 .It Planex GW-USMicroN
171 .It Planex GW-US300MiniS
180 .It TP-LINK TL-WDN3200
181 .It TP-LINK TL-WN321G v4
182 .It TP-LINK TL-WN727N v3
190 Join an existing BSS network (i.e., connect to an access point):
191 .Bd -literal -offset indent
192 ifconfig wlan create wlandev run0 inet 192.168.0.20 \e
196 Join a specific BSS network with network name
199 .Dl "ifconfig wlan create wlandev run0 ssid my_net up"
201 Join a specific BSS network with 64-bit WEP encryption:
202 .Bd -literal -offset indent
203 ifconfig wlan create wlandev run0 ssid my_net \e
204 wepmode on wepkey 0x1234567890 weptxkey 1 up
207 Join a specific BSS network with 128-bit WEP encryption:
208 .Bd -literal -offset indent
209 ifconfig wlan create wlandev run0 wlanmode adhoc ssid my_net \e
210 wepmode on wepkey 0x01020304050607080910111213 weptxkey 1
214 .It "run%d: failed load firmware of file runfw"
215 For some reason, the driver was unable to read the microcode file from the
217 The file might be missing or corrupted.
218 .It "run%d: could not load 8051 microcode"
219 An error occurred while attempting to upload the microcode to the onboard 8051
220 microcontroller unit.
221 .It "run%d: device timeout"
222 A frame dispatched to the hardware for transmission did not complete in time.
223 The driver will reset the hardware.
224 This should not happen.
243 driver first appeared in
248 driver was written by
249 .An Damien Bergamini Aq Mt damien@openbsd.org .
253 driver supports some of the 11n capabilities found in the
254 RT2800, RT3000 and RT3900 chipsets.