RAL(4)

📦 version 15.1, in freebsd 14.5, freebsd 15.1

okay so bestie, buckle up, because ral is the Ralink Technology IEEE 802.11a/g/n wireless network driver and she has lore. this whole page is her origin story. 🦋

✨ SYNOPSIS ✨

so if you wanna get this driver into the kernel, you're gonna drop these lines in your kernel configuration file. no cap, all of them:

device ral
device ralfw
device wlan
device wlan_amrr
device firmware

OR — and honestly this is the lazy-girl route, which we respect — you can load it as a module at boot time by putting this line in loader.conf(5):

if_ral_load="YES"

slay. that's it. that's the whole vibe check. 💅

🌸 DESCRIPTION 🌸

the ral driver supports PCI/PCIe/CardBus wireless adapters based on the Ralink RT2500, RT2501, RT2600, RT2700, RT2800, RT3090 and RT3900E chipsets. that's a lot of chipsets, and each one has its own little personality, so let's go on a tour 🎀

RT2500 — the first generation of 802.11b/g adapters from Ralink. baby's first wifi. she's made of two integrated chips: an RT2560 MAC/BBP and an RT2525 radio transceiver. iconic duo, honestly.

RT2501 — second generation, 802.11a/b/g this time. two integrated chips again: an RT2561 MAC/BBP and an RT2527 radio transceiver. this chipset provides support for the IEEE 802.11e standard with multiple hardware transmission queues, and it allows scatter/gather for efficient DMA operations. she's organized. we stan an efficient queen. ✨

RT2600 — two integrated chips, an RT2661 MAC/BBP and an RT2529 radio transceiver. this chipset uses the MIMO (multiple-input multiple-output) technology with multiple radio transceivers to extend the operating range of the adapter and to achieve higher throughput. BUT — and this is the plot twist — the RT2600 chipset does not support any of the 802.11n features. tragic, i know. 💀

RT2700 — the low-cost version of the RT2800 chipset. supports a single transmit path and two receiver paths (1T2R). consists of two integrated chips: an RT2760 or RT2790 (PCIe) MAC/BBP, and an RT2720 (2.4GHz) or RT2750 (2.4GHz/5GHz) radio transceiver. budget baddie 💸

RT2800 — first generation of 802.11n adapters from Ralink, and honestly she ate. two integrated chips: an RT2860 or RT2890 (PCIe) MAC/BBP, and an RT2820 (2.4GHz) or RT2850 (2.4GHz/5GHz) radio transceiver. supports two transmit paths and up to three receiver paths (2T2R/2T3R). she can achieve speeds up to 144Mbps (20MHz bandwidth) and 300Mbps (40MHz bandwidth.) yes bestie, 300Mbps. 🔥

RT3090 — first generation of single-chip 802.11n adapters from Ralink. and here's where the modes come in, so pay attention: ral supports station, adhoc, hostap, mesh, wds, and monitor mode operation. only one hostap or mesh virtual interface may be configured at a time. any number of wds virtual interfaces may be configured together with a hostap interface. multiple station interfaces may be operated together with a hostap interface to construct a wireless repeater device. yes, you can build a repeater. main character energy fr fr 👑

RT3900E — a single-chip 802.11n adapter from Ralink. the MAC/Baseband Processor can be an RT5390 or RT5392. the RT5390 chip operates in the 2GHz spectrum and supports 1 transmit path and 1 receiver path (1T1R). the RT5392 chip operates in the 2GHz spectrum and supports up to 2 transmit paths and 2 receiver paths (2T2R). 🌈

and the transmit speed? user-selectable, OR it can be adapted automatically by the driver depending on the number of hardware transmission retries. she's adaptive. she reads the room. for more info on configuring this device, see ifconfig(8). 🫶

🎀 HARDWARE 🎀

the ral driver supports PCI/PCIe/CardBus wireless adapters based on Ralink Technology chipsets, including — okay, deep breath — all of these babes. card, then MAC/BBP, then bus:

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

like. that's 87 cards. she's well-connected. iykyk 💅

🦋 EXAMPLES 🦋

join an existing BSS network (i.e., connect to an access point) — the classic, the starter pack:

ifconfig wlan create wlandev ral0 inet 192.0.2.20/24

join a specific BSS network with network name my_net — now we're being specific:

ifconfig wlan create wlandev ral0 inet 192.0.2.20/24 \
    ssid my_net

join a specific BSS network with 40-bit WEP encryption — retro era, nostalgic but pls know WEP is old old:

ifconfig wlan create wlandev ral0 inet 192.0.2.20/24 \
    ssid my_net wepmode on wepkey 0x1234567890 weptxkey 1

join a specific BSS network with 104-bit WEP encryption — the longer key era:

ifconfig wlan create wlandev ral0 inet 192.0.2.20/24 \
    ssid my_net \
    wepmode on wepkey 0x01020304050607080910111213 weptxkey 1

look at those backslashes, she's serving continuity 🎀

💜 DIAGNOSTICS 💜

read these like your group chat read receipts, bestie:

  • ral%d: could not load 8051 microcode — an error occurred while attempting to upload the microcode to the onboard 8051 microcontroller unit. 😭
  • ral%d: timeout waiting for MCU to initialize — the onboard 8051 microcontroller unit failed to initialize in time. she was not ready.
  • ral%d: device timeout — a frame dispatched to the hardware for transmission did not complete in time. the driver will reset the hardware. this should not happen. and when a manpage says "this should not happen," you feel it in your bones 💀

⭐ SEE ALSO ⭐

cardbus(4), intro(4), wlan(4), wlan_ccmp(4), wlan_tkip(4), wlan_wep(4), wlan_xauth(4), networking(7), hostapd(8), ifconfig(8), wpa_supplicant(8) — the whole friend group, go say hi 🫶

🧚 HISTORY 🧚

the ral driver first appeared in OpenBSD 3.7. support for the RT2501 and RT2600 chipsets was added in OpenBSD 3.9. support for the RT2800 chipset was added in OpenBSD 4.3. support for the RT2700 chipset was added in OpenBSD 4.4. support for the RT3090 chipset was added in OpenBSD 4.9. she's been growing and glowing since day one ✨

👑 AUTHORS 👑

the original ral driver was written by Damien Bergamini <damien@openbsd.org>. legend behavior, honestly. 🫡

🙈 CAVEATS 🙈

okay bestie, the fine print, and we do NOT skip the fine print:

  • the ral driver does not make use of the hardware cryptographic engine.
  • the ral driver does not support any of the 802.11n capabilities offered by the RT2700 and RT2800 chipsets. additional work is required in before those features can be supported. (yes, "required in before" — that's how it's written, we don't touch the sacred text 💀)
  • Host AP mode does not support power saving. clients attempting to use power saving mode may experience significant packet loss (disabling power saving on the client will fix this). so if your packets are ghosting you, that's why.
  • some PCI ral adapters strictly require a system supporting PCI 2.2 or greater. check the board's PCI version before purchasing the card, as it is likely these adapters will not work in systems based on older revisions of the PCI specification. seriously, check first. don't be the girlie who buys the card and then finds out. 🍓
ngl, that last caveat is the realest one on this whole page. read it twice.

and that's the whole page, bestie!! this was the ral(4) manual, from the Debian fam, dated November 10, 2024. go forth and wifi responsibly 💖✨🎀🦋🌸💅🫶

📦 where this page comes from