1 .\" Copyright (c) 2005, 2006
2 .\" Damien Bergamini <damien.bergamini@free.fr>
4 .\" Permission to use, copy, modify, and distribute this software for any
5 .\" purpose with or without fee is hereby granted, provided that the above
6 .\" copyright notice and this permission notice appear in all copies.
8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16 .\" $FreeBSD: src/share/man/man4/ural.4,v 1.11 2006/10/07 18:18:40 flz Exp $
17 .\" $DragonFly: src/share/man/man4/ural.4,v 1.7 2007/09/16 19:06:26 swildner Exp $
24 .Nd "Ralink Technology RT2500USB IEEE 802.11 driver"
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_ratectl_onoe"
39 Alternatively, to load the driver as a
40 module at boot time, place the following line in
42 .Bd -literal -offset indent
48 driver supports USB 2.0 wireless adapters based on the RT2500USB chipset.
50 The RT2500USB chipset consists of two integrated chips, a RT2570 MAC/BBP
51 and a radio transceiver (the model of which depends on the card revision).
53 The RT2522, RT2523, RT2524, RT2525, RT2525e and RT2526 radio transceivers
54 operate in the 2.4GHz band (802.11b/g) whereas the RT5222 is a dual-band radio
55 transceiver that can operate in the 2.4GHz and 5.2GHz bands (802.11a).
59 driver supports the following adapters:
71 Buffalo WLI-U2-KG54-AI
73 Buffalo WLI-U2-KG54-YB
93 KCORP LifeStyle KLS-685
107 Nintendo Wi-Fi USB Connector
134 An up to date list can be found at
135 .Pa http://ralink.rapla.net/ .
137 Join an existing BSS network (i.e., connect to an access point):
139 .Dl "ifconfig ural0 inet 192.168.0.20 netmask 0xffffff00"
141 Join a specific BSS network with network name
144 .Dl "ifconfig ural0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net"
146 Join a specific BSS network with 40-bit WEP encryption:
147 .Bd -literal -offset indent
148 ifconfig ural0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e
149 wepmode on wepkey 0x1234567890 weptxkey 1
152 Join a specific BSS network with 104-bit WEP encryption:
153 .Bd -literal -offset indent
154 ifconfig ural0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e
155 wepmode on wepkey 0x01020304050607080910111213 weptxkey 1
159 .It "ural%d: device timeout"
160 The driver will reset the hardware.
161 This should not happen.
174 .%T "Ralink Technology"
175 .%O http://www.ralinktech.com/
180 driver first appeared in
185 driver supports automatic adaptation of the transmit speed in IBSS
186 and HostAP operating modes,
187 but it does not work well if there are more than one peer node.
191 driver was written by
192 .An Damien Bergamini Aq damien@FreeBSD.org .