ral(4)

ral4

Ralink technology rt2500 ieee 802.11 driver

Usage

To compile support for the

ral driver into your kernel, place the following lines in your kernel configuration file:

device ral device wlan

Alternatively, to load the

ral driver at boot time, place the following line in loader.conf(5):

if_ral_load="YES"

Overview

The ral driver supports PCI/CardBus wireless adapters based on the Ralink RT2500 chipset.

The RT2500 chipset consists of two integrated chips, a RT2560 MAC/BBP and a radio transceiver (the model of which depends on the card revision).

The RT2522, RT2523, RT2524, RT2525, RT2525e and RT2526 radio transceivers operate in the 2.4GHz band (802.11b/g) whereas the RT5222 is a dual-band radio transceiver that can operate in the 2.4GHz and 5.2GHz bands (802.11a).

The transmit speed is user-selectable or can be adapted automatically by the driver depending on the received-signal strength.

Hardware

The following adapters should work:

CardBus
A-Link WL54HPCI
A-Link WL54PCCardBus
Amigo AWI-914WCardBus
Amigo AWI-922Wmini-PCI
Amigo AWI-926WPCI
AMIT WL531CCardBus
AMIT WL531PPCI
AOpen AOI-831PCI
ASUS WL-107GCardBus
ASUS WL-130gPCI
Atlantis Land A02-PCI-W54PCI
Atlantis Land A02-PCM-W54CardBus
Belkin F5D7000 v3PCI
Belkin F5D7010 v2CardBus
Billionton MIWLGRLmini-PCI
Canyon CN-WF511PCI
Canyon CN-WF513CardBus
CC&C WL-2102CardBus
CNet CWC-854CardBus
CNet CWP-854PCI
Compex WL54GCardBus
Compex WLP54GPCI
Conceptronic C54RCCardBus
Conceptronic C54RiPCI
Digitus DN-7001G-RACardBus
Digitus DN-7006G-RAPCI
E-Tech WGPC02CardBus
E-Tech WGPI02PCI
Edimax EW-7108PCgCardBus
Edimax EW-7128gPCI
Eminent EM3036CardBus
Eminent EM3037PCI
Encore ENLWI-G-RLAMPCI
Encore ENPWI-G-RLAMCardBus
Fiberline WL-400PPCI
Fibreline WL-400XCardBus
Gigabyte GN-WIKGmini-PCI
Gigabyte GN-WMKGCardBus
Gigabyte GN-WPKGPCI
Hawking HWC54GRCardBus
Hawking HWP54GRPCI
iNexQ CR054g-009 (R03)PCI
JAHT WN-4054PCardBus
JAHT WN-4054PCIPCI
LevelOne WNC-0301 v2PCI
LevelOne WPC-0301 v2CardBus
Linksys WMP54G v4PCI
Micronet SP906GKPCI
Micronet SP908GK V3CardBus
Minitar MN54GCB-RCardBus
Minitar MN54GPC-RPCI
MSI CB54G2CardBus
MSI MP54G2mini-PCI
MSI PC54G2PCI
OvisLink EVO-W54PCIPCI
PheeNet HWL-PCIG/RAPCI
Pro-Nets CB80211GCardBus
Pro-Nets PC80211GPCI
Repotec RP-WB7108CardBus
Repotec RP-WP0854PCI
SATech SN-54CCardBus
SATech SN-54PPCI
Sitecom WL-112CardBus
Sitecom WL-115PCI
SparkLAN WL-685RCardBus
Surecom EP-9321-gPCI
Surecom EP-9321-g1PCI
Surecom EP-9428-gCardBus
Sweex LC500050CardBus
Sweex LC700030PCI
TekComm NE-9321-gPCI
TekComm NE-9428-gCardBus
Unex CR054g-R02PCI
Unex MR054g-R02CardBus
Zinwell ZWX-G160CardBus
Zinwell ZWX-G360mini-PCI
Zinwell ZWX-G361PCI
Zonet ZEW1500CardBus
Zonet ZEW1600PCI

An up to date list can be found at http://damien.bergamini.free.fr/ral/list.html.

Examples

Join an existing BSS network (i.e., connect to an access point):

ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00

Join a specific BSS network with network name “my_net”:

ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net

Join a specific BSS network with 40-bit WEP encryption:

ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \
    wepmode on wepkey 0x1234567890

Join a specific BSS network with 104-bit WEP encryption:

ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \
    wepmode on wepkey 0x01020304050607080910111213

Diagnostics

ral%d: device timeout

The driver will reset the hardware. This should not happen.

Caveats

PCI ral adapters seem to require a PCI 2.2 compliant motherboard and will likely not work with PCI 2.1 only motherboard.

History

The ral driver first appeared in OpenBSD 3.7.

Authors

The ral driver was written by Damien Bergamini ⟨[email protected]⟩.

From freebsd-manpages 6.0-5 in Debian 4.0 (Etch). Parsed by carta from the page's mdoc source.