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