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.Dt URAL 4 20.Os 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.Bd -literal -offset indent 109ifconfig wlan create wlandev ural0 inet 192.168.0.20 \e 110 netmask 0xffffff00 111.Ed 112.Pp 113Join a specific BSS network with network name 114.Dq Li my_net : 115.Pp 116.Dl "ifconfig wlan create wlandev ural0 ssid my_net up" 117.Pp 118Join a specific BSS network with 64-bit WEP encryption: 119.Bd -literal -offset indent 120ifconfig wlan create wlandev ural0 ssid my_net \e 121 wepmode on wepkey 0x1234567890 weptxkey 1 up 122.Ed 123.Pp 124Join a specific BSS network with 128-bit WEP encryption: 125.Bd -literal -offset indent 126ifconfig wlan create wlandev ural0 wlanmode adhoc ssid my_net \e 127 wepmode on wepkey 0x01020304050607080910111213 weptxkey 1 128.Ed 129.Sh DIAGNOSTICS 130.Bl -diag 131.It "ural%d: device timeout" 132The driver will reset the hardware. 133This should not happen. 134.El 135.Sh SEE ALSO 136.Xr intro 4 , 137.Xr netintro 4 , 138.Xr usb 4 , 139.Xr wlan 4 , 140.Xr wlan_amrr 4 , 141.Xr wlan_ccmp 4 , 142.Xr wlan_tkip 4 , 143.Xr wlan_wep 4 , 144.Xr wlan_xauth 4 , 145.Xr hostapd 8 , 146.Xr ifconfig 8 , 147.Xr wpa_supplicant 8 148.Sh HISTORY 149The 150.Nm 151driver first appeared in 152.Ox 3.7 . 153.Sh AUTHORS 154The original 155.Nm 156driver was written by 157.An Damien Bergamini Aq Mt damien.bergamini@free.fr . 158.Sh BUGS 159Host AP mode doesn't support client power save. 160Clients using power save mode will experience 161packet loss (disabling power saving on the client will fix this). 162