From 5c88f27518464e9b1f9104e514bf6290aefe91fe Mon Sep 17 00:00:00 2001 From: Damien Bergamini Date: Sun, 5 Mar 2006 20:57:25 +0000 Subject: [PATCH] Document new chipsets (RT2561, RT2561S and RT2661). Obtained from: OpenBSD --- share/man/man4/ral.4 | 205 ++++++++++++++++++++++++------------------- 1 file changed, 113 insertions(+), 92 deletions(-) diff --git a/share/man/man4/ral.4 b/share/man/man4/ral.4 index cee59bab0028..0b3c99f6eb33 100644 --- a/share/man/man4/ral.4 +++ b/share/man/man4/ral.4 @@ -15,12 +15,12 @@ .\" .\" $FreeBSD$ .\" -.Dd January 29, 2006 +.Dd March 05, 2006 .Os .Dt RAL 4 .Sh NAME .Nm ral -.Nd "Ralink Technology RT2500 IEEE 802.11 driver" +.Nd "Ralink Technology IEEE 802.11 wireless network driver" .Sh SYNOPSIS To compile this driver into the kernel, place the following lines in your @@ -39,105 +39,116 @@ if_ral_load="YES" .Sh DESCRIPTION The .Nm -driver supports PCI/CardBus wireless adapters based on the Ralink RT2500 -chipset. +driver supports PCI/CardBus wireless adapters based on the Ralink Technology +RT2500, RT2501, and RT2600 chipsets. .Pp -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 RT2500 chipset is the first generation of 802.11b/g adapters from Ralink. +It consists of two integrated chips, a RT2560 MAC/BBP and a RT2525 radio +transceiver. .Pp -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 RT2501 chipset is the second generation of 802.11b/g adapters from Ralink. +It consists of two integrated chips, a RT2561 MAC/BBP and a RT2527 radio +transceiver. +This chipset provides support for the IEEE 802.11e standard with multiple +hardware transmission queues and allows scatter/gather for efficient DMA +operations. +.Pp +The RT2600 chipset consists of two integrated chips, a RT2661 MAC/BBP and a +RT2529 radio transceiver. +This chipset uses the MIMO (multiple-input multiple-output) technology with +multiple antennas to extend the operating range of the adapter and to achieve +higher throughput. +MIMO will be the basis of the future IEEE 802.11n standard. .Pp The transmit speed is user-selectable or can be adapted automatically by the -driver depending on the received-signal strength and the number of transmission -retries. +driver depending on the received signal strength and on the number of hardware +transmission retries. .Sh HARDWARE The .Nm driver supports the following adapters: .Pp -.Bl -column -compact ".Li Atlantis Land A02-PCM-W54" "Bus" -.It Em Card Ta Em Bus -.It Li "A-Link WL54H" Ta PCI -.It Li "A-Link WL54PC" Ta CardBus -.It Li "Amigo AWI-914W" Ta CardBus -.It Li "Amigo AWI-922W" Ta mini-PCI -.It Li "Amigo AWI-926W" Ta PCI -.It Li "AMIT WL531C" Ta CardBus -.It Li "AMIT WL531P" Ta PCI -.It Li "AOpen AOI-831" Ta PCI -.It Li "ASUS WL-107G" Ta CardBus -.It Li "ASUS WL-130g" Ta PCI -.It Li "Atlantis Land A02-PCI-W54" Ta PCI -.It Li "Atlantis Land A02-PCM-W54" Ta CardBus -.It Li "Belkin F5D7000 v3" Ta PCI -.It Li "Belkin F5D7010 v2" Ta CardBus -.It Li "Billionton MIWLGRL" Ta mini-PCI -.It Li "Canyon CN-WF511" Ta PCI -.It Li "Canyon CN-WF513" Ta CardBus -.It Li "CC&C WL-2102" Ta CardBus -.It Li "CNet CWC-854" Ta CardBus -.It Li "CNet CWP-854" Ta PCI -.It Li "Compex WL54G" Ta CardBus -.It Li "Compex WLP54G" Ta PCI -.It Li "Conceptronic C54RC" Ta CardBus -.It Li "Conceptronic C54Ri" Ta PCI -.It Li "Digitus DN-7001G-RA" Ta CardBus -.It Li "Digitus DN-7006G-RA" Ta PCI -.It Li "E-Tech WGPC02" Ta CardBus -.It Li "E-Tech WGPI02" Ta PCI -.It Li "Edimax EW-7108PCg" Ta CardBus -.It Li "Edimax EW-7128g" Ta PCI -.It Li "Eminent EM3036" Ta CardBus -.It Li "Eminent EM3037" Ta PCI -.It Li "Encore ENLWI-G-RLAM" Ta PCI -.It Li "Encore ENPWI-G-RLAM" Ta CardBus -.It Li "Fiberline WL-400P" Ta PCI -.It Li "Fibreline WL-400X" Ta CardBus -.It Li "Gigabyte GN-WIKG" Ta mini-PCI -.It Li "Gigabyte GN-WMKG" Ta CardBus -.It Li "Gigabyte GN-WPKG" Ta PCI -.It Li "Hawking HWC54GR" Ta CardBus -.It Li "Hawking HWP54GR" Ta PCI -.It Li "iNexQ CR054g-009 (R03)" Ta PCI -.It Li "JAHT WN-4054P" Ta CardBus -.It Li "JAHT WN-4054PCI" Ta PCI -.It Li "LevelOne WNC-0301 v2" Ta PCI -.It Li "LevelOne WPC-0301 v2" Ta CardBus -.It Li "Linksys WMP54G v4" Ta PCI -.It Li "Micronet SP906GK" Ta PCI -.It Li "Micronet SP908GK V3" Ta CardBus -.It Li "Minitar MN54GCB-R" Ta CardBus -.It Li "Minitar MN54GPC-R" Ta PCI -.It Li "MSI CB54G2" Ta CardBus -.It Li "MSI MP54G2" Ta mini-PCI -.It Li "MSI PC54G2" Ta PCI -.It Li "OvisLink EVO-W54PCI" Ta PCI -.It Li "PheeNet HWL-PCIG/RA" Ta PCI -.It Li "Pro-Nets CB80211G" Ta CardBus -.It Li "Pro-Nets PC80211G" Ta PCI -.It Li "Repotec RP-WB7108" Ta CardBus -.It Li "Repotec RP-WP0854" Ta PCI -.It Li "SATech SN-54C" Ta CardBus -.It Li "SATech SN-54P" Ta PCI -.It Li "Sitecom WL-112" Ta CardBus -.It Li "Sitecom WL-115" Ta PCI -.It Li "SparkLAN WL-685R" Ta CardBus -.It Li "Surecom EP-9321-g" Ta PCI -.It Li "Surecom EP-9321-g1" Ta PCI -.It Li "Surecom EP-9428-g" Ta CardBus -.It Li "Sweex LC500050" Ta CardBus -.It Li "Sweex LC700030" Ta PCI -.It Li "TekComm NE-9321-g" Ta PCI -.It Li "TekComm NE-9428-g" Ta CardBus -.It Li "Unex CR054g-R02" Ta PCI -.It Li "Unex MR054g-R02" Ta CardBus -.It Li "Zinwell ZWX-G160" Ta CardBus -.It Li "Zinwell ZWX-G360" Ta mini-PCI -.It Li "Zinwell ZWX-G361" Ta PCI -.It Li "Zonet ZEW1500" Ta CardBus -.It Li "Zonet ZEW1600" Ta PCI +.Bl -column -compact ".Li Atlantis Land A02-PCM-W54" "CardBus" "RT2561S" +.It Em Card Ta Em Bus Ta Em MAC/BBP +.It Li "A-Link WL54H" Ta PCI Ta RT2560 +.It Li "A-Link WL54PC" Ta CardBus Ta RT2560 +.It Li "Amigo AWI-914W" Ta CardBus Ta RT2560 +.It Li "Amigo AWI-922W" Ta mini-PCI Ta RT2560 +.It Li "Amigo AWI-926W" Ta PCI Ta RT2560 +.It Li "AMIT WL531C" Ta CardBus Ta RT2560 +.It Li "AMIT WL531P" Ta PCI Ta RT2560 +.It Li "AOpen AOI-831" Ta PCI Ta RT2560 +.It Li "ASUS WL-107G" Ta CardBus Ta RT2560 +.It Li "ASUS WL-130g" Ta PCI Ta RT2560 +.It Li "Atlantis Land A02-PCI-W54" Ta PCI Ta RT2560 +.It Li "Atlantis Land A02-PCM-W54" Ta CardBus Ta RT2560 +.It Li "Belkin F5D7000 v3" Ta PCI Ta RT2560 +.It Li "Belkin F5D7010 v2" Ta CardBus Ta RT2560 +.It Li "Billionton MIWLGRL" Ta mini-PCI Ta RT2560 +.It Li "Canyon CN-WF511" Ta PCI Ta RT2560 +.It Li "Canyon CN-WF513" Ta CardBus Ta RT2560 +.It Li "CC&C WL-2102" Ta CardBus Ta RT2560 +.It Li "CNet CWC-854" Ta CardBus Ta RT2560 +.It Li "CNet CWP-854" Ta PCI Ta RT2560 +.It Li "Compex WL54G" Ta CardBus Ta RT2560 +.It Li "Compex WLP54G" Ta PCI Ta RT2560 +.It Li "Conceptronic C54RC" Ta CardBus Ta RT2560 +.It Li "Conceptronic C54Ri" Ta PCI Ta RT2560 +.It Li "Digitus DN-7001G-RA" Ta CardBus Ta RT2560 +.It Li "Digitus DN-7006G-RA" Ta PCI Ta RT2560 +.It Li "E-Tech WGPC02" Ta CardBus Ta RT2560 +.It Li "E-Tech WGPI02" Ta PCI Ta RT2560 +.It Li "Edimax EW-7108PCg" Ta CardBus Ta RT2560 +.It Li "Edimax EW-7128g" Ta PCI Ta RT2560 +.It Li "Eminent EM3036" Ta CardBus Ta RT2560 +.It Li "Eminent EM3037" Ta PCI Ta RT2560 +.It Li "Encore ENLWI-G-RLAM" Ta PCI Ta RT2560 +.It Li "Encore ENPWI-G-RLAM" Ta CardBus Ta RT2560 +.It Li "Fiberline WL-400P" Ta PCI Ta RT2560 +.It Li "Fibreline WL-400X" Ta CardBus Ta RT2560 +.It Li "Gigabyte GN-WIKG" Ta mini-PCI Ta RT2560 +.It Li "Gigabyte GN-WMKG" Ta CardBus Ta RT2560 +.It Li "Gigabyte GN-WPKG" Ta PCI Ta RT2560 +.It Li "Hawking HWC54GR" Ta CardBus Ta RT2560 +.It Li "Hawking HWP54GR" Ta PCI Ta RT2560 +.It Li "iNexQ CR054g-009 (R03)" Ta PCI Ta RT2560 +.It Li "JAHT WN-4054P" Ta CardBus Ta RT2560 +.It Li "JAHT WN-4054PCI" Ta PCI Ta RT2560 +.It Li "LevelOne WNC-0301 v2" Ta PCI Ta RT2560 +.It Li "LevelOne WPC-0301 v2" Ta CardBus Ta RT2560 +.It Li "Linksys WMP54G v4" Ta PCI Ta RT2560 +.It Li "Micronet SP906GK" Ta PCI Ta RT2560 +.It Li "Micronet SP908GK V3" Ta CardBus Ta RT2560 +.It Li "Minitar MN54GCB-R" Ta CardBus Ta RT2560 +.It Li "Minitar MN54GPC-R" Ta PCI Ta RT2560 +.It Li "MSI CB54G2" Ta CardBus Ta RT2560 +.It Li "MSI MP54G2" Ta mini-PCI Ta RT2560 +.It Li "MSI PC54G2" Ta PCI Ta RT2560 +.It Li "OvisLink EVO-W54PCI" Ta PCI Ta RT2560 +.It Li "PheeNet HWL-PCIG/RA" Ta PCI Ta RT2560 +.It Li "Pro-Nets CB80211G" Ta CardBus Ta RT2560 +.It Li "Pro-Nets PC80211G" Ta PCI Ta RT2560 +.It Li "Repotec RP-WB7108" Ta CardBus Ta RT2560 +.It Li "Repotec RP-WP0854" Ta PCI Ta RT2560 +.It Li "SATech SN-54C" Ta CardBus Ta RT2560 +.It Li "SATech SN-54P" Ta PCI Ta RT2560 +.It Li "Sitecom WL-112" Ta CardBus Ta RT2560 +.It Li "Sitecom WL-115" Ta PCI Ta RT2560 +.It Li "SparkLAN WL-685R" Ta CardBus Ta RT2560 +.It Li "Surecom EP-9321-g" Ta PCI Ta RT2560 +.It Li "Surecom EP-9321-g1" Ta PCI Ta RT2560 +.It Li "Surecom EP-9428-g" Ta CardBus Ta RT2560 +.It Li "Sweex LC500050" Ta CardBus Ta RT2560 +.It Li "Sweex LC700030" Ta PCI Ta RT2560 +.It Li "TekComm NE-9321-g" Ta PCI Ta RT2560 +.It Li "TekComm NE-9428-g" Ta CardBus Ta RT2560 +.It Li "Unex CR054g-R02" Ta PCI Ta RT2560 +.It Li "Unex MR054g-R02" Ta CardBus Ta RT2560 +.It Li "Zinwell ZWX-G160" Ta CardBus Ta RT2560 +.It Li "Zinwell ZWX-G360" Ta mini-PCI Ta RT2560 +.It Li "Zinwell ZWX-G361" Ta PCI Ta RT2560 +.It Li "Zonet ZEW1500" Ta CardBus Ta RT2560 +.It Li "Zonet ZEW1600" Ta PCI Ta RT2560 .El .Pp An up to date list can be found at @@ -165,7 +176,13 @@ ifconfig ral0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e .Ed .Sh DIAGNOSTICS .Bl -diag +.It "ral%d: could not load 8051 microcode" +An error occurred while attempting to upload the microcode to the onboard 8051 +microcontroller unit. +.It "ral%d: timeout waiting for MCU to initialize" +The onboard 8051 microcontroller unit failed to initialize in time. .It "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. .El @@ -190,6 +207,10 @@ PCI .Nm adapters seem to require a PCI 2.2 compliant motherboard and will likely not work with PCI 2.1 only motherboard. +.Pp +The +.Nm +driver does not implement frame aggregation. .Sh AUTHORS The .Nm