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 au
tomatically 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.

HISTORY

The ral driver first appeared in OpenBSD 3.7.

CAVEATS

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

AUTHORS

The ral driver was written by Damien Bergamini
<damien@FreeBSD.org>.
BSD July 16, 2005

docs.sk

comprehensive documentation repository

See also