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 and RT3000U 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 These are the modes the
69 driver can operate in:
70 .Bl -tag -width "IBSS-masterXX"
74 mode, this is used when associating with an access point, through
75 which all traffic passes.
76 This mode is the default.
78 In this mode the driver acts as an access point (base station)
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.
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.
100 driver offloads both encryption and decryption of data frames to the
101 hardware for the WEP40, WEP104, TKIP(+MIC) and CCMP ciphers.
105 driver can be configured at runtime with
110 driver supports the following wireless adapters:
112 .Bl -tag -width Ds -offset indent -compact
113 .It Airlink101 AWLL6090
117 .It Belkin F5D8051 ver 3000
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 Corega CG-WLUSB2GNL
126 .It Corega CG-WLUSB2GNR
127 .It Corega CG-WLUSB300AGN
128 .It Corega CG-WLUSB300GNM
129 .It D-Link DWA-130 rev B1
131 .It DrayTek Vigor N61
132 .It Edimax EW-7711UAn
133 .It Edimax EW-7711UTn
136 .It Gigabyte GN-WB30N
137 .It Gigabyte GN-WB31N
138 .It Gigabyte GN-WB32L
142 .It Hercules HWNU-300
143 .It Linksys WUSB54GC v3
145 .It Mvix Nubbin MS-811N
146 .It Planex GW-USMicroN
147 .It Planex GW-US300MiniS
162 Join an existing BSS network (i.e., connect to an access point):
163 .Bd -literal -offset indent
164 ifconfig wlan create wlandev run0 inet 192.168.0.20 \e
168 Join a specific BSS network with network name
171 .Dl "ifconfig wlan create wlandev run0 ssid my_net up"
173 Join a specific BSS network with 64-bit WEP encryption:
174 .Bd -literal -offset indent
175 ifconfig wlan create wlandev run0 ssid my_net \e
176 wepmode on wepkey 0x1234567890 weptxkey 1 up
179 Join a specific BSS network with 128-bit WEP encryption:
180 .Bd -literal -offset indent
181 ifconfig wlan create wlandev run0 wlanmode adhoc ssid my_net \e
182 wepmode on wepkey 0x01020304050607080910111213 weptxkey 1
186 .It "run%d: faild load firmware of file runfw"
187 For some reason, the driver was unable to read the microcode file from the
189 The file might be missing or corrupted.
190 .It "run%d: could not load 8051 microcode"
191 An error occurred while attempting to upload the microcode to the onboard 8051
192 microcontroller unit.
193 .It "run%d: device timeout"
194 A frame dispatched to the hardware for transmission did not complete in time.
195 The driver will reset the hardware.
196 This should not happen.
211 .Xr wpa_supplicant 8 .
214 .Pa http://www.ralinktech.com/
218 driver first appeared in
223 driver was written by
224 .An Damien Bergamini Aq damien@openbsd.org .
228 driver does not support any of the 802.11n capabilities offered by the
229 RT2800 and RT3000 chipsets.