1.\" Copyright (c) 2005 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 July 16, 2005 19.Os 20.Dt RAL 4 21.Sh NAME 22.Nm ral 23.Nd "Ralink Technology RT2500 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 ral" 30.Cd "device wlan" 31.Ed 32.Pp 33Alternatively, to load the driver as a 34module at boot time, place the following line in 35.Xr loader.conf 5 : 36.Bd -literal -offset indent 37if_ral_load="YES" 38.Ed 39.Sh DESCRIPTION 40The 41.Nm 42driver supports PCI/CardBus wireless adapters based on the Ralink RT2500 43chipset. 44.Pp 45The RT2500 chipset consists of two integrated chips, a RT2560 MAC/BBP and a 46radio transceiver (the model of which depends on the card revision). 47.Pp 48The RT2522, RT2523, RT2524, RT2525, RT2525e and RT2526 radio transceivers 49operate in the 2.4GHz band (802.11b/g) whereas the RT5222 is a dual-band radio 50transceiver that can operate in the 2.4GHz and 5.2GHz bands (802.11a). 51.Pp 52The transmit speed is user-selectable or can be adapted automatically by the 53driver depending on the received-signal strength. 54.Sh HARDWARE 55The 56.Nm 57driver supports the following adapters: 58.Pp 59.Bl -column -compact ".Li Atlantis Land A02-PCM-W54" "Bus" 60.It Em Card Ta Em Bus 61.It Li "A-Link WL54H" Ta PCI 62.It Li "A-Link WL54PC" Ta CardBus 63.It Li "Amigo AWI-914W" Ta CardBus 64.It Li "Amigo AWI-922W" Ta mini-PCI 65.It Li "Amigo AWI-926W" Ta PCI 66.It Li "AMIT WL531C" Ta CardBus 67.It Li "AMIT WL531P" Ta PCI 68.It Li "AOpen AOI-831" Ta PCI 69.It Li "ASUS WL-107G" Ta CardBus 70.It Li "ASUS WL-130g" Ta PCI 71.It Li "Atlantis Land A02-PCI-W54" Ta PCI 72.It Li "Atlantis Land A02-PCM-W54" Ta CardBus 73.It Li "Belkin F5D7000 v3" Ta PCI 74.It Li "Belkin F5D7010 v2" Ta CardBus 75.It Li "Billionton MIWLGRL" Ta mini-PCI 76.It Li "Canyon CN-WF511" Ta PCI 77.It Li "Canyon CN-WF513" Ta CardBus 78.It Li "CC&C WL-2102" Ta CardBus 79.It Li "CNet CWC-854" Ta CardBus 80.It Li "CNet CWP-854" Ta PCI 81.It Li "Compex WL54G" Ta CardBus 82.It Li "Compex WLP54G" Ta PCI 83.It Li "Conceptronic C54RC" Ta CardBus 84.It Li "Conceptronic C54Ri" Ta PCI 85.It Li "Digitus DN-7001G-RA" Ta CardBus 86.It Li "Digitus DN-7006G-RA" Ta PCI 87.It Li "E-Tech WGPC02" Ta CardBus 88.It Li "E-Tech WGPI02" Ta PCI 89.It Li "Edimax EW-7108PCg" Ta CardBus 90.It Li "Edimax EW-7128g" Ta PCI 91.It Li "Eminent EM3036" Ta CardBus 92.It Li "Eminent EM3037" Ta PCI 93.It Li "Encore ENLWI-G-RLAM" Ta PCI 94.It Li "Encore ENPWI-G-RLAM" Ta CardBus 95.It Li "Fiberline WL-400P" Ta PCI 96.It Li "Fibreline WL-400X" Ta CardBus 97.It Li "Gigabyte GN-WIKG" Ta mini-PCI 98.It Li "Gigabyte GN-WMKG" Ta CardBus 99.It Li "Gigabyte GN-WPKG" Ta PCI 100.It Li "Hawking HWC54GR" Ta CardBus 101.It Li "Hawking HWP54GR" Ta PCI 102.It Li "iNexQ CR054g-009 (R03)" Ta PCI 103.It Li "JAHT WN-4054P" Ta CardBus 104.It Li "JAHT WN-4054PCI" Ta PCI 105.It Li "LevelOne WNC-0301 v2" Ta PCI 106.It Li "LevelOne WPC-0301 v2" Ta CardBus 107.It Li "Linksys WMP54G v4" Ta PCI 108.It Li "Micronet SP906GK" Ta PCI 109.It Li "Micronet SP908GK V3" Ta CardBus 110.It Li "Minitar MN54GCB-R" Ta CardBus 111.It Li "Minitar MN54GPC-R" Ta PCI 112.It Li "MSI CB54G2" Ta CardBus 113.It Li "MSI MP54G2" Ta mini-PCI 114.It Li "MSI PC54G2" Ta PCI 115.It Li "OvisLink EVO-W54PCI" Ta PCI 116.It Li "PheeNet HWL-PCIG/RA" Ta PCI 117.It Li "Pro-Nets CB80211G" Ta CardBus 118.It Li "Pro-Nets PC80211G" Ta PCI 119.It Li "Repotec RP-WB7108" Ta CardBus 120.It Li "Repotec RP-WP0854" Ta PCI 121.It Li "SATech SN-54C" Ta CardBus 122.It Li "SATech SN-54P" Ta PCI 123.It Li "Sitecom WL-112" Ta CardBus 124.It Li "Sitecom WL-115" Ta PCI 125.It Li "SparkLAN WL-685R" Ta CardBus 126.It Li "Surecom EP-9321-g" Ta PCI 127.It Li "Surecom EP-9321-g1" Ta PCI 128.It Li "Surecom EP-9428-g" Ta CardBus 129.It Li "Sweex LC500050" Ta CardBus 130.It Li "Sweex LC700030" Ta PCI 131.It Li "TekComm NE-9321-g" Ta PCI 132.It Li "TekComm NE-9428-g" Ta CardBus 133.It Li "Unex CR054g-R02" Ta PCI 134.It Li "Unex MR054g-R02" Ta CardBus 135.It Li "Zinwell ZWX-G160" Ta CardBus 136.It Li "Zinwell ZWX-G360" Ta mini-PCI 137.It Li "Zinwell ZWX-G361" Ta PCI 138.It Li "Zonet ZEW1500" Ta CardBus 139.It Li "Zonet ZEW1600" Ta PCI 140.El 141.Pp 142An up to date list can be found at 143.Pa http://damien.bergamini.free.fr/ral/list.html . 144.Sh EXAMPLES 145Join an existing BSS network (i.e., connect to an access point): 146.Pp 147.Dl "ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00" 148.Pp 149Join a specific BSS network with network name 150.Dq Li my_net : 151.Pp 152.Dl "ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net" 153.Pp 154Join a specific BSS network with 40-bit WEP encryption: 155.Bd -literal -offset indent 156ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e 157 wepmode on wepkey 0x1234567890 158.Ed 159.Pp 160Join a specific BSS network with 104-bit WEP encryption: 161.Bd -literal -offset indent 162ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e 163 wepmode on wepkey 0x01020304050607080910111213 164.Ed 165.Sh DIAGNOSTICS 166.Bl -diag 167.It "ral%d: device timeout" 168The driver will reset the hardware. 169This should not happen. 170.El 171.Sh SEE ALSO 172.Xr arp 4 , 173.Xr cardbus 4 , 174.Xr netintro 4 , 175.Xr pci 4 , 176.Xr wlan 4 , 177.Xr ifconfig 8 178.Rs 179.%T "Ralink Technology" 180.%O http://www.ralinktech.com/ 181.Re 182.Sh HISTORY 183The 184.Nm 185driver first appeared in 186.Ox 3.7 . 187.Sh CAVEATS 188PCI 189.Nm 190adapters seem to require a PCI 2.2 compliant motherboard and will likely not 191work with PCI 2.1 only motherboard. 192.Sh AUTHORS 193The 194.Nm 195driver was written by 196.An Damien Bergamini Aq damien@FreeBSD.org . 197