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