RAL(4) MidnightBSD Kernel Interfaces Manual RAL(4)

NAME

ral — Ralink Technology RT2500 IEEE 802.11 driver

SYNOPSIS

To compile this driver into the kernel, place the following lines in your kernel configuration file:

device ral
device wlan

Alternatively, to load the driver as a module at boot time, place the following line in loader.conf(5):

if_ral_load="YES"

DESCRIPTION

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 ral driver supports the following adapters:

Card Bus
A-Link WL54H PCI
A-Link WL54PC CardBus
Amigo AWI-914W CardBus
Amigo AWI-922W mini-PCI
Amigo AWI-926W PCI
AMIT WL531C CardBus
AMIT WL531P PCI
AOpen AOI-831 PCI
ASUS WL-107G CardBus
ASUS WL-130g PCI
Atlantis Land A02-PCI-W54 PCI
Atlantis Land A02-PCM-W54 CardBus
Belkin F5D7000 v3 PCI
Belkin F5D7010 v2 CardBus
Billionton MIWLGRL mini-PCI
Canyon CN-WF511 PCI
Canyon CN-WF513 CardBus
CC&C WL-2102 CardBus
CNet CWC-854 CardBus
CNet CWP-854 PCI
Compex WL54G CardBus
Compex WLP54G PCI
Conceptronic C54RC CardBus
Conceptronic C54Ri PCI
Digitus DN-7001G-RA CardBus
Digitus DN-7006G-RA PCI
E-Tech WGPC02 CardBus
E-Tech WGPI02 PCI
Edimax EW-7108PCg CardBus
Edimax EW-7128g PCI
Eminent EM3036 CardBus
Eminent EM3037 PCI
Encore ENLWI-G-RLAM PCI
Encore ENPWI-G-RLAM CardBus
Fiberline WL-400P PCI
Fibreline WL-400X CardBus
Gigabyte GN-WIKG mini-PCI
Gigabyte GN-WMKG CardBus
Gigabyte GN-WPKG PCI
Hawking HWC54GR CardBus
Hawking HWP54GR PCI
iNexQ CR054g-009 (R03) PCI
JAHT WN-4054P CardBus
JAHT WN-4054PCI PCI
LevelOne WNC-0301 v2 PCI
LevelOne WPC-0301 v2 CardBus
Linksys WMP54G v4 PCI
Micronet SP906GK PCI
Micronet SP908GK V3 CardBus
Minitar MN54GCB-R CardBus
Minitar MN54GPC-R PCI
MSI CB54G2 CardBus
MSI MP54G2 mini-PCI
MSI PC54G2 PCI
OvisLink EVO-W54PCI PCI
PheeNet HWL-PCIG/RA PCI
Pro-Nets CB80211G CardBus
Pro-Nets PC80211G PCI
Repotec RP-WB7108 CardBus
Repotec RP-WP0854 PCI
SATech SN-54C CardBus
SATech SN-54P PCI
Sitecom WL-112 CardBus
Sitecom WL-115 PCI
SparkLAN WL-685R CardBus
Surecom EP-9321-g PCI
Surecom EP-9321-g1 PCI
Surecom EP-9428-g CardBus
Sweex LC500050 CardBus
Sweex LC700030 PCI
TekComm NE-9321-g PCI
TekComm NE-9428-g CardBus
Unex CR054g-R02 PCI
Unex MR054g-R02 CardBus
Zinwell ZWX-G160 CardBus
Zinwell ZWX-G360 mini-PCI
Zinwell ZWX-G361 PCI
Zonet ZEW1500 CardBus
Zonet ZEW1600 PCI

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.

SEE ALSO

arp(4), cardbus(4), netintro(4), pci(4), wlan(4), ifconfig(8)

Ralink Technology

,

http://www.ralinktech.com/ .

HISTORY

The ral driver first appeared in OpenBSD 3.7.

CAVEATS

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

AUTHORS

The ral driver was written by Damien Bergamini 〈damien@FreeBSD.org〉.

MidnightBSD 0.3 July 16, 2005 MidnightBSD 0.3