1.\" Copyright (c) 2005, 2006 2.\" Damien Bergamini <damien.bergamini@free.fr> 3.\" 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. 7.\" 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. 15.\" 16.\" $FreeBSD$ 17.\" 18.Dd April 13, 2008 19.Os 20.Dt URAL 4 21.Sh NAME 22.Nm ural 23.Nd "Ralink Technology RT2500USB IEEE 802.11 driver" 24.Sh SYNOPSIS 25To compile this driver into the kernel, 26place the following lines in your 27kernel configuration file: 28.Bd -ragged -offset indent 29.Cd "device ehci" 30.Cd "device uhci" 31.Cd "device ohci" 32.Cd "device usb" 33.Cd "device ural" 34.Cd "device wlan" 35.Cd "device wlan_amrr" 36.Ed 37.Pp 38Alternatively, to load the driver as a 39module at boot time, place the following line in 40.Xr loader.conf 5 : 41.Bd -literal -offset indent 42if_ural_load="YES" 43.Ed 44.Sh DESCRIPTION 45The 46.Nm 47driver supports USB 2.0 wireless adapters based on the RT2500USB chipset. 48.Pp 49The RT2500USB chipset consists of two integrated chips, a RT2570 MAC/BBP 50and a radio transceiver (the model of which depends on the card revision). 51.Pp 52The RT2522, RT2523, RT2524, RT2525, RT2525e and RT2526 radio transceivers 53operate in the 2.4GHz band (802.11b/g) whereas the RT5222 is a dual-band radio 54transceiver that can operate in the 2.4GHz and 5.2GHz bands (802.11a). 55.Pp 56.Nm 57supports 58.Cm station , 59.Cm adhoc , 60.Cm hostap , 61and 62.Cm monitor 63mode operation. 64Only one virtual interface may be configured at any time. 65For more information on configuring this device, see 66.Xr ifconfig 8 . 67.Sh HARDWARE 68The 69.Nm 70driver supports USB 2.0 wireless adapters based on the Ralink Technology 71RT2500USB chipset, including: 72.Pp 73.Bl -column -compact ".Li Atlantis Land A02-PCM-W54" "Bus" 74.It Em Card Ta Em Bus 75.It "AMIT WL532U" Ta USB 76.It "ASUS WL-167g" Ta USB 77.It "Belkin F5D7050 v2000" Ta USB 78.It "Buffalo WLI-U2-KG54-AI" Ta USB 79.It "CNet CWD-854" Ta USB 80.It "Compex WLU54G 2A1100" Ta USB 81.It "Conceptronic C54RU" Ta USB 82.It "D-Link DWL-G122 b1" Ta USB 83.It "Dynalink WLG25USB" Ta USB 84.It "E-Tech WGUS02" Ta USB 85.It "Gigabyte GN-WBKG" Ta USB 86.It "Hercules HWGUSB2-54" Ta USB 87.It "KCORP LifeStyle KLS-685" Ta USB 88.It "Linksys WUSB54G v4" Ta USB 89.It "Linksys WUSB54GP v4" Ta USB 90.It "MSI MS-6861" Ta USB 91.It "MSI MS-6865" Ta USB 92.It "MSI MS-6869" Ta USB 93.It "NovaTech NV-902" Ta USB 94.It "OvisLink Evo-W54USB" Ta USB 95.It "SerComm UB801R" Ta USB 96.It "SparkLAN WL-685R" Ta USB 97.It "Surecom EP-9001-g" Ta USB 98.It "Sweex LC100060" Ta USB 99.It "Tonze UW-6200C" Ta USB 100.It "Zinwell ZWX-G261" Ta USB 101.It "Zonet ZEW2500P" Ta USB 102.El 103.Pp 104An up to date list can be found at 105.Pa http://ralink.rapla.net/ . 106.Sh EXAMPLES 107Join an existing BSS network (i.e., connect to an access point): 108.Pp 109.Bd -literal -offset indent 110ifconfig wlan create wlandev ural0 inet 192.168.0.20 \e 111 netmask 0xffffff00 112.Ed 113.Pp 114Join a specific BSS network with network name 115.Dq Li my_net : 116.Pp 117.Dl "ifconfig wlan create wlandev ural0 ssid my_net up" 118.Pp 119Join a specific BSS network with 64-bit WEP encryption: 120.Bd -literal -offset indent 121ifconfig wlan create wlandev ural0 ssid my_net \e 122 wepmode on wepkey 0x1234567890 weptxkey 1 up 123.Ed 124.Pp 125Join a specific BSS network with 128-bit WEP encryption: 126.Bd -literal -offset indent 127ifconfig wlan create wlandev ural0 wlanmode adhoc ssid my_net \e 128 wepmode on wepkey 0x01020304050607080910111213 weptxkey 1 129.Ed 130.Sh DIAGNOSTICS 131.Bl -diag 132.It "ural%d: device timeout" 133The driver will reset the hardware. 134This should not happen. 135.El 136.Sh SEE ALSO 137.Xr intro 4 , 138.Xr netintro 4 , 139.Xr usb 4 , 140.Xr wlan 4 , 141.Xr wlan_amrr 4 , 142.Xr wlan_ccmp 4 , 143.Xr wlan_tkip 4 , 144.Xr wlan_wep 4 , 145.Xr wlan_xauth 4 , 146.Xr ifconfig 8 , 147.Xr hostapd 8 , 148.Xr wpa_supplicant 8 . 149.Rs 150.%T "Ralink Technology" 151.%O http://www.ralinktech.com/ 152.Re 153.Sh HISTORY 154The 155.Nm 156driver first appeared in 157.Ox 3.7 . 158.Sh AUTHORS 159The original 160.Nm 161driver was written by 162.An Damien Bergamini Aq damien.bergamini@free.fr 163