1.\" $FreeBSD$ 2.\" 3.\" Copyright (c) 2005 4.\" Damien Bergamini <damien.bergamini@free.fr> 5.\" 6.\" Permission to use, copy, modify, and distribute this software for any 7.\" purpose with or without fee is hereby granted, provided that the above 8.\" copyright notice and this permission notice appear in all copies. 9.\" 10.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 11.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 12.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 13.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 14.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 15.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 16.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 17.\" 18.Dd May 02, 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 25.Cd "device ral" 26.Cd "device wlan" 27.Sh DESCRIPTION 28The 29.Nm 30driver supports PCI/CardBus wireless adapters based on the Ralink RT2500 31chipset. 32.Pp 33The RT2500 chipset consists of two integrated chips, a RT2560 MAC/BBP and a 34radio transceiver (the model of which depends on the card revision). 35.Pp 36The RT2522, RT2523, RT2524, RT2525, RT2525e and RT2526 radio transceivers 37operate in the 2.4GHz band (802.11b/g) whereas the RT5222 is a dual-band radio 38transceiver that can operate in the 2.4GHz and 5.2GHz bands (802.11a). 39.Pp 40The transmit speed is user-selectable or can be adapted automatically by the 41driver depending on the received-signal strength. 42.Sh HARDWARE 43The following adapters should work: 44.Pp 45.Bl -column -compact "Atlantis Land A02-PCM-W54" "Bus" 46.It Em "Card Bus" 47.It Li "A-Link WL54H" Ta PCI 48.It Li "A-Link WL54PC" Ta CardBus 49.It Li "Amigo AWI-914W" Ta CardBus 50.It Li "Amigo AWI-922W" Ta mini-PCI 51.It Li "Amigo AWI-926W" Ta PCI 52.It Li "AMIT WL531C" Ta CardBus 53.It Li "AMIT WL531P" Ta PCI 54.It Li "AOpen AOI-831" Ta PCI 55.It Li "ASUS WL-107G" Ta CardBus 56.It Li "ASUS WL-130g" Ta PCI 57.It Li "Atlantis Land A02-PCI-W54" Ta PCI 58.It Li "Atlantis Land A02-PCM-W54" Ta CardBus 59.It Li "Belkin F5D7000 v3" Ta PCI 60.It Li "Belkin F5D7010 v2" Ta CardBus 61.It Li "Billionton MIWLGRL" Ta mini-PCI 62.It Li "Canyon CN-WF511" Ta PCI 63.It Li "Canyon CN-WF513" Ta CardBus 64.It Li "CC&C WL-2102" Ta CardBus 65.It Li "CNet CWC-854" Ta CardBus 66.It Li "CNet CWP-854" Ta PCI 67.It Li "Compex WL54G" Ta CardBus 68.It Li "Compex WLP54G" Ta PCI 69.It Li "Conceptronic C54RC" Ta CardBus 70.It Li "Conceptronic C54Ri" Ta PCI 71.It Li "Digitus DN-7001G-RA" Ta CardBus 72.It Li "Digitus DN-7006G-RA" Ta PCI 73.It Li "E-Tech WGPC02" Ta CardBus 74.It Li "E-Tech WGPI02" Ta PCI 75.It Li "Edimax EW-7108PCg" Ta CardBus 76.It Li "Edimax EW-7128g" Ta PCI 77.It Li "Eminent EM3036" Ta CardBus 78.It Li "Eminent EM3037" Ta PCI 79.It Li "Encore ENLWI-G-RLAM" Ta PCI 80.It Li "Encore ENPWI-G-RLAM" Ta CardBus 81.It Li "Fiberline WL-400P" Ta PCI 82.It Li "Fibreline WL-400X" Ta CardBus 83.It Li "Gigabyte GN-WIKG" Ta mini-PCI 84.It Li "Gigabyte GN-WMKG" Ta CardBus 85.It Li "Gigabyte GN-WPKG" Ta PCI 86.It Li "Hawking HWC54GR" Ta CardBus 87.It Li "Hawking HWP54GR" Ta PCI 88.It Li "iNexQ CR054g-009 (R03)" Ta PCI 89.It Li "JAHT WN-4054P" Ta CardBus 90.It Li "JAHT WN-4054PCI" Ta PCI 91.It Li "LevelOne WNC-0301 v2" Ta PCI 92.It Li "LevelOne WPC-0301 v2" Ta CardBus 93.It Li "Linksys WMP54G v4" Ta PCI 94.It Li "Micronet SP906GK" Ta PCI 95.It Li "Micronet SP908GK V3" Ta CardBus 96.It Li "Minitar MN54GCB-R" Ta CardBus 97.It Li "Minitar MN54GPC-R" Ta PCI 98.It Li "MSI CB54G2" Ta CardBus 99.It Li "MSI MP54G2" Ta mini-PCI 100.It Li "MSI PC54G2" Ta PCI 101.It Li "OvisLink EVO-W54PCI" Ta PCI 102.It Li "PheeNet HWL-PCIG/RA" Ta PCI 103.It Li "Pro-Nets CB80211G" Ta CardBus 104.It Li "Pro-Nets PC80211G" Ta PCI 105.It Li "Repotec RP-WB7108" Ta CardBus 106.It Li "Repotec RP-WP0854" Ta PCI 107.It Li "SATech SN-54C" Ta CardBus 108.It Li "SATech SN-54P" Ta PCI 109.It Li "Sitecom WL-112" Ta CardBus 110.It Li "Sitecom WL-115" Ta PCI 111.It Li "SparkLAN WL-685R" Ta CardBus 112.It Li "Surecom EP-9321-g" Ta PCI 113.It Li "Surecom EP-9321-g1" Ta PCI 114.It Li "Surecom EP-9428-g" Ta CardBus 115.It Li "Sweex LC500050" Ta CardBus 116.It Li "Sweex LC700030" Ta PCI 117.It Li "TekComm NE-9321-g" Ta PCI 118.It Li "TekComm NE-9428-g" Ta CardBus 119.It Li "Unex CR054g-R02" Ta PCI 120.It Li "Unex MR054g-R02" Ta CardBus 121.It Li "Zinwell ZWX-G160" Ta CardBus 122.It Li "Zinwell ZWX-G360" Ta mini-PCI 123.It Li "Zinwell ZWX-G361" Ta PCI 124.It Li "Zonet ZEW1500" Ta CardBus 125.It Li "Zonet ZEW1600" Ta PCI 126.El 127.Pp 128An up to date list can be found at 129.Pa http://damien.bergamini.free.fr/ral/list.html 130.Sh EXAMPLES 131Join an existing BSS network (ie: connect to an access point): 132.Pp 133.Dl "ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00" 134.Pp 135Join a specific BSS network with network name 136.Dq Li my_net : 137.Pp 138.Dl "ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net" 139.Pp 140Join a specific BSS network with 40bit WEP encryption: 141.Bd -literal -offset indent 142ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e 143 wepmode on wepkey 0x1234567890 144.Ed 145.Pp 146Join a specific BSS network with 104bit WEP encryption: 147.Bd -literal -offset indent 148ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e 149 wepmode on wepkey 0x01020304050607080910111213 150.Ed 151.Sh DIAGNOSTICS 152.Bl -diag 153.It "ral%d: device timeout" 154The driver will reset the hardware. 155This should not happen. 156.El 157.Sh SEE ALSO 158.Xr arp 4 , 159.Xr cardbus 4 , 160.Xr netintro 4 , 161.Xr pci 4 , 162.Xr wlan 4 , 163.Xr ifconfig 8 164.Rs 165.%T Ralink Technology 166.%O http://www.ralinktech.com 167.Re 168.Sh AUTHORS 169The 170.Nm 171driver was written by 172.An Damien Bergamini Aq damien@freebsd.org . 173.Sh HISTORY 174The 175.Nm 176driver first appeared in 177.Ox 3.7 . 178.Sh CAVEATS 179PCI 180.Nm 181adapters seem to require a PCI 2.2 compliant motherboard and will likely not 182work with PCI 2.1 only motherboard. 183