diff options
Diffstat (limited to 'static/netbsd/man4/ral.4 3.html')
| -rw-r--r-- | static/netbsd/man4/ral.4 3.html | 325 |
1 files changed, 0 insertions, 325 deletions
diff --git a/static/netbsd/man4/ral.4 3.html b/static/netbsd/man4/ral.4 3.html deleted file mode 100644 index 126128b5..00000000 --- a/static/netbsd/man4/ral.4 3.html +++ /dev/null @@ -1,325 +0,0 @@ -<table class="head"> - <tr> - <td class="head-ltitle">RAL(4)</td> - <td class="head-vol">Device Drivers Manual</td> - <td class="head-rtitle">RAL(4)</td> - </tr> -</table> -<div class="manual-text"> -<section class="Sh"> -<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1> -<p class="Pp"><code class="Nm">ral</code> — <span class="Nd">Ralink - Technology IEEE 802.11a/b/g wireless network driver</span></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1> -<p class="Pp"><code class="Cd">ral* at cardbus?</code> - <br/> - <code class="Cd">ral* at pci?</code> - <br/> - <code class="Cd">ral* at uhub? port ?</code></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1> -<p class="Pp">The <code class="Nm">ral</code> driver supports PCI/CardBus - wireless adapters based on the Ralink RT2500, RT2501, and RT2600 chipsets. - The <code class="Nm">ral</code> driver supports USB 2.0 wireless adapters - based on the Ralink RT2500USB chipset.</p> -<p class="Pp">The RT2500 chipset is the first generation of 802.11b/g adapters - from Ralink. It consists of two integrated chips, an RT2560 or RT2570(USB) - MAC/BBP and an RT2525 or RT2526(USB) radio transceiver.</p> -<p class="Pp">The RT2501 chipset is the second generation of 802.11b/g adapters - from Ralink. It consists of two integrated chips, 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 allows - scatter/gather for efficient DMA operations.</p> -<p class="Pp">The RT2600 chipset consists of two integrated chips, an RT2661 - MAC/BBP and an 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.</p> -<p class="Pp">These are the modes the <code class="Nm">ral</code> driver can - operate in:</p> -<dl class="Bl-tag"> - <dt id="infrastructure">BSS mode</dt> - <dd>Also known as - <a class="permalink" href="#infrastructure"><i class="Em">infrastructure</i></a> - mode, this is used when associating with an access point, through which - all traffic passes. This mode is the default.</dd> - <dt id="IEEE">IBSS mode</dt> - <dd>Also known as <a class="permalink" href="#IEEE"><i class="Em">IEEE - ad-hoc</i></a> mode or - <a class="permalink" href="#peer-to-peer"><i class="Em" id="peer-to-peer">peer-to-peer</i></a> - mode. This is the standardized method of operating without an access - point. Stations associate with a service set. However, actual connections - between stations are peer-to-peer.</dd> - <dt>Host AP</dt> - <dd>In this mode the driver acts as an access point (base station) for other - cards.</dd> - <dt>monitor mode</dt> - <dd>In this mode the driver is able to receive packets without associating - with an access point. This disables the internal receive filter and - enables the card to capture packets from networks which it wouldn't - normally have access to, or to scan for access points.</dd> -</dl> -<p class="Pp"><code class="Nm">ral</code> supports software WEP. Wired - Equivalent Privacy (WEP) is the de facto encryption standard for wireless - networks. It can be typically configured in one of three modes: no - encryption; 40-bit encryption; or 104-bit encryption. Unfortunately, due to - serious weaknesses in WEP protocol it is strongly recommended that it not be - used as the sole mechanism to secure wireless communication. WEP is not - enabled by default.</p> -<p class="Pp">The transmit speed is user-selectable or can be adapted - automatically by the driver depending on the received signal strength and on - the number of hardware transmission retries. See - <a class="Xr">rssadapt(9)</a> for more information.</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="CONFIGURATION"><a class="permalink" href="#CONFIGURATION">CONFIGURATION</a></h1> -<p class="Pp">The <code class="Nm">ral</code> driver can be configured at - runtime with <a class="Xr">ifconfig(8)</a> or on boot with - <a class="Xr">ifconfig.if(5)</a> using the following parameters:</p> -<dl class="Bl-tag"> - <dt id="bssid"><a class="permalink" href="#bssid"><code class="Cm">bssid</code></a> - <var class="Ar">bssid</var></dt> - <dd>Set the desired BSSID.</dd> - <dt id="bssid~2"><a class="permalink" href="#bssid~2"><code class="Fl">-bssid</code></a></dt> - <dd>Unset the desired BSSID. The interface will automatically select a BSSID - in this mode, which is the default.</dd> - <dt id="chan"><a class="permalink" href="#chan"><code class="Cm">chan</code></a> - <var class="Ar">n</var></dt> - <dd>Set the channel (radio frequency) to be used by the driver based on the - given channel ID <var class="Ar">n</var>.</dd> - <dt id="chan~2"><a class="permalink" href="#chan~2"><code class="Fl">-chan</code></a></dt> - <dd>Unset the desired channel to be used by the driver. The driver will - automatically select a channel in this mode, which is the default.</dd> - <dt id="media"><a class="permalink" href="#media"><code class="Cm">media</code></a> - <var class="Ar">media</var></dt> - <dd>The <code class="Nm">ral</code> driver supports the following - <var class="Ar">media</var> types: - <p class="Pp"></p> - <dl class="Bl-tag Bl-compact"> - <dt id="autoselect"><a class="permalink" href="#autoselect"><code class="Cm">autoselect</code></a></dt> - <dd>Enable autoselection of the media type and options.</dd> - <dt id="DS1"><a class="permalink" href="#DS1"><code class="Cm">DS1</code></a></dt> - <dd>Set 802.11b DS 1Mbps operation.</dd> - <dt id="DS2"><a class="permalink" href="#DS2"><code class="Cm">DS2</code></a></dt> - <dd>Set 802.11b DS 2Mbps operation.</dd> - <dt id="DS5"><a class="permalink" href="#DS5"><code class="Cm">DS5</code></a></dt> - <dd>Set 802.11b DS 5.5Mbps operation.</dd> - <dt id="DS11"><a class="permalink" href="#DS11"><code class="Cm">DS11</code></a></dt> - <dd>Set 802.11b DS 11Mbps operation.</dd> - <dt id="OFDM6"><a class="permalink" href="#OFDM6"><code class="Cm">OFDM6</code></a></dt> - <dd>Set 802.11a/g OFDM 6Mbps operation.</dd> - <dt id="OFDM9"><a class="permalink" href="#OFDM9"><code class="Cm">OFDM9</code></a></dt> - <dd>Set 802.11a/g OFDM 9Mbps operation.</dd> - <dt id="OFDM12"><a class="permalink" href="#OFDM12"><code class="Cm">OFDM12</code></a></dt> - <dd>Set 802.11a/g OFDM 12Mbps operation.</dd> - <dt id="OFDM18"><a class="permalink" href="#OFDM18"><code class="Cm">OFDM18</code></a></dt> - <dd>Set 802.11a/g OFDM 18Mbps operation.</dd> - <dt id="OFDM24"><a class="permalink" href="#OFDM24"><code class="Cm">OFDM24</code></a></dt> - <dd>Set 802.11a/g OFDM 24Mbps operation.</dd> - <dt id="OFDM36"><a class="permalink" href="#OFDM36"><code class="Cm">OFDM36</code></a></dt> - <dd>Set 802.11a/g OFDM 36Mbps operation.</dd> - <dt id="OFDM48"><a class="permalink" href="#OFDM48"><code class="Cm">OFDM48</code></a></dt> - <dd>Set 802.11a/g OFDM 48Mbps operation.</dd> - <dt id="OFDM54"><a class="permalink" href="#OFDM54"><code class="Cm">OFDM54</code></a></dt> - <dd>Set 802.11a/g OFDM 54Mbps operation.</dd> - </dl> - </dd> - <dt id="mediaopt"><a class="permalink" href="#mediaopt"><code class="Cm">mediaopt</code></a> - <var class="Ar">opts</var></dt> - <dd>The <code class="Nm">ral</code> driver supports the following media - options: - <p class="Pp"></p> - <dl class="Bl-tag Bl-compact"> - <dt id="hostap"><a class="permalink" href="#hostap"><code class="Cm">hostap</code></a></dt> - <dd>Select Host AP operation.</dd> - <dt id="ibss"><a class="permalink" href="#ibss"><code class="Cm">ibss</code></a></dt> - <dd>Select IBSS operation.</dd> - <dt id="monitor"><a class="permalink" href="#monitor"><code class="Cm">monitor</code></a></dt> - <dd>Select monitor mode.</dd> - </dl> - </dd> - <dt id="mediaopt~2"><a class="permalink" href="#mediaopt~2"><code class="Fl">-mediaopt</code></a> - <var class="Ar">opts</var></dt> - <dd>Disable the specified media options on the driver and return it to the - default mode of operation (BSS).</dd> - <dt id="mode"><a class="permalink" href="#mode"><code class="Cm">mode</code></a> - <var class="Ar">mode</var></dt> - <dd>The <code class="Nm">ral</code> driver supports the following modes: - <p class="Pp"></p> - <dl class="Bl-tag Bl-compact"> - <dt id="11a"><a class="permalink" href="#11a"><code class="Cm">11a</code></a></dt> - <dd>Force 802.11a operation.</dd> - <dt id="11b"><a class="permalink" href="#11b"><code class="Cm">11b</code></a></dt> - <dd>Force 802.11b operation.</dd> - <dt id="11g"><a class="permalink" href="#11g"><code class="Cm">11g</code></a></dt> - <dd>Force 802.11g operation.</dd> - </dl> - </dd> - <dt id="nwid"><a class="permalink" href="#nwid"><code class="Cm">nwid</code></a> - <var class="Ar">id</var></dt> - <dd>Set the network ID. The <var class="Ar">id</var> can either be any text - string up to 32 characters in length, or a series of hexadecimal digits up - to 64 digits. An empty <var class="Ar">id</var> string allows the - interface to connect to any available access points. By default the - <code class="Nm">ral</code> driver uses an empty string. Note that network - ID is synonymous with Extended Service Set ID (ESSID).</dd> - <dt id="nwkey"><a class="permalink" href="#nwkey"><code class="Cm">nwkey</code></a> - <var class="Ar">key</var></dt> - <dd>Enable WEP encryption using the specified <var class="Ar">key</var>. The - <var class="Ar">key</var> can either be a string, a series of hexadecimal - digits (preceded by ‘0x’), or a set of keys of the form - “n:k1,k2,k3,k4”, where ‘n’ specifies which of - the keys will be used for transmitted packets, and the four keys, - “k1” through “k4”, are configured as WEP keys. - If a set of keys is specified, a comma (‘,’) within the key - must be escaped with a backslash. Note that if multiple keys are used, - their order must be the same within the network. - <code class="Nm">ral</code> is capable of using both 40-bit (5 characters - or 10 hexadecimal digits) or 104-bit (13 characters or 26 hexadecimal - digits) keys.</dd> - <dt id="nwkey~2"><a class="permalink" href="#nwkey~2"><code class="Fl">-nwkey</code></a></dt> - <dd>Disable WEP encryption. This is the default mode of operation.</dd> -</dl> -</section> -<section class="Sh"> -<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1> -<p class="Pp">The following firmware files are potentially loaded when an - interface is brought up:</p> -<p class="Pp"></p> -<div class="Bd-indent"> -<dl class="Bl-tag Bl-compact"> - <dt>/libdata/firmware/ral/ral-rt2561</dt> - <dd style="width: auto;"> </dd> - <dt>/libdata/firmware/ral/ral-rt2561s</dt> - <dd style="width: auto;"> </dd> - <dt>/libdata/firmware/ral/ral-rt2661</dt> - <dd style="width: auto;"> </dd> -</dl> -</div> -<p class="Pp">RT2500 adapters do not require a firmware to operate.</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1> -<p class="Pp">The following PCI adapters should work:</p> -<div class="Bd Pp">A-Link WL54H. Amigo AWI-926W. AMIT WL531P. AOpen AOI-831. - ASUS WL-130g. ASUS WIFI-G-AAY. Atlantis Land A02-PCI-W54. Belkin F5D7000 v3. - Canyon CN-WF511. CNet CWP-854. Compex WLP54G. Conceptronic C54Ri. Corega - CG-WLPCI54GL. Digitus DN-7006G-RA. Dynalink WLG25PCI. E-Tech WGPI02. Edimax - EW-7128g. Eminent EM3037. Encore ENLWI-G-RLAM. Eusso UGL2454-VPR. Fiberline - WL-400P. Foxconn WLL-3350. Gigabyte GN-WPKG. Hama WLAN PCI Card 54 Mbps. - Hawking HWP54GR. Hercules HWGPCI-54. iNexQ CR054g-009 (R03). JAHT WN-4054PCI. - KCORP LifeStyle KLS-660. LevelOne WNC-0301 v2. Linksys WMP54G v4. Micronet - SP906GK. Minitar MN54GPC-R. MSI MS-6834. MSI PC54G2. OvisLink EVO-W54PCI. - PheeNet HWL-PCIG/RA. Pro-Nets PC80211G. Repotec RP-WP0854. SATech SN-54P. - Signamax 065-1798. Sitecom WL-115. SparkLAN WL-660R. Surecom EP-9321-g. Sweex - LC700030. TekComm NE-9321-g. Tonze PC-6200C. Unex CR054g-R02. Zinwell - ZWX-G361. Zonet ZEW1600.</div> -<p class="Pp">The following CardBus adapters should work:</p> -<div class="Bd Pp">A-Link WL54PC. Alfa AWPC036. Amigo AWI-914W. AMIT WL531C. - ASUS WL-107G. Atlantis Land A02-PCM-W54. Belkin F5D7010 v2. Canyon CN-WF513. - CC&C WL-2102. CNet CWC-854. Conceptronic C54RC. Corega CG-WLCB54GL. - Digitus DN-7001G-RA. Dynalink WLG25CARDBUS. E-Tech WGPC02. E-Tech WGPC03. - Edimax EW-7108PCg. Eminent EM3036. Encore ENPWI-G-RLAM. Eusso UGL2454-01R. - Fiberline WL-400X. Gigabyte GN-WMKG. Hawking HWC54GR. Hercules HWGPCMCIA-54. - JAHT WN-4054P(E). KCORP LifeStyle KLS-611. LevelOne WPC-0301 v2. Micronet - SP908GK V3. Minitar MN54GCB-R. MSI CB54G2. MSI MS-6835. Pro-Nets CB80211G. - Repotec RP-WB7108. SATech SN-54C. Sitecom WL-112. SparkLAN WL-611R. Surecom - EP-9428-g. Sweex LC500050. TekComm NE-9428-g. Tonze PW-6200C. Unex MR054g-R02. - Zinwell ZWX-G160. Zonet ZEW1500.</div> -<p class="Pp">The following Mini PCI adapters should work:</p> -<div class="Bd Pp">Amigo AWI-922W. Billionton MIWLGRL. Gigabyte GN-WIKG. MSI - MP54G2. MSI MS-6833. Tonze PC-620C. Zinwell ZWX-G360.</div> -<p class="Pp">The following USB 2.0 adapters should work:</p> -<div class="Bd Pp">AMIT WL532U. ASUS WL-167g. Belkin F5D7050 v2000. Buffalo - WLI-U2-KG54. Buffalo WLI-U2-KG54-AI. Buffalo WLI-U2-KG54-YB. CNet CWD-854. - Compex WLU54G 2A1100. Conceptronic C54RU. D-Link DWL-G122 (b1). Dynalink - WLG25USB. E-Tech WGUS02. Gigabyte GN-WBKG. Hercules HWGUSB2-54. KCORP - LifeStyle KLS-685. Linksys HU200-TS. Linksys WUSB54G v4. Linksys WUSB54GP v4. - MSI MS-6861. MSI MS-6865. MSI MS-6869. Nintendo Wi-Fi USB Connector. OvisLink - Evo-W54USB. SerComm UB801R. SparkLAN WL-685R. Surecom EP-9001-g. Sweex - LC100060. Tonze UW-6200C. Zinwell ZWX-G261. Zonet ZEW2500P.</div> -</section> -<section class="Sh"> -<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1> -<p class="Pp">The following <a class="Xr">ifconfig.if(5)</a> example creates a - host-based access point on boot:</p> -<div class="Bd Pp Bd-indent Li"> -<pre>inet 192.168.1.1 netmask 255.255.255.0 media autoselect \ - mediaopt hostap nwid my_net chan 11</pre> -</div> -<p class="Pp">Configure ral0 for WEP, using hex key - “0x1deadbeef1”:</p> -<div class="Bd Pp Bd-indent Li"> -<pre># ifconfig ral0 nwkey 0x1deadbeef1</pre> -</div> -<p class="Pp">Return ral0 to its default settings:</p> -<div class="Bd Pp Bd-indent Li"> -<pre># ifconfig ral0 -bssid -chan media autoselect \ - nwid "" -nwkey</pre> -</div> -<p class="Pp">Join an existing BSS network, “my_net”:</p> -<div class="Bd Pp Bd-indent Li"> -<pre># ifconfig ral0 192.168.1.1 netmask 0xffffff00 nwid my_net</pre> -</div> -</section> -<section class="Sh"> -<h1 class="Sh" id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">DIAGNOSTICS</a></h1> -<dl class="Bl-diag"> - <dt>ral%d: could not read microcode %s</dt> - <dd>For some reason, the driver was unable to read the microcode file from the - filesystem. The file might be missing or corrupted.</dd> - <dt>ral%d: could not load 8051 microcode</dt> - <dd>An error occurred while attempting to upload the microcode to the onboard - 8051 microcontroller unit.</dd> - <dt>ral%d: timeout waiting for MCU to initialize</dt> - <dd>The onboard 8051 microcontroller unit failed to initialize in time.</dd> - <dt>ral%d: device timeout</dt> - <dd>A frame dispatched to the hardware for transmission did not complete in - time. The driver will reset the hardware. This should not happen.</dd> -</dl> -</section> -<section class="Sh"> -<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE - ALSO</a></h1> -<p class="Pp"><a class="Xr">arp(4)</a>, <a class="Xr">cardbus(4)</a>, - <a class="Xr">ifmedia(4)</a>, <a class="Xr">intro(4)</a>, - <a class="Xr">netintro(4)</a>, <a class="Xr">pci(4)</a>, - <a class="Xr">usb(4)</a>, <a class="Xr">ifconfig.if(5)</a>, - <a class="Xr">hostapd(8)</a>, <a class="Xr">ifconfig(8)</a></p> -<p class="Pp"><a class="Lk" href="http://www.ralinktech.com">Ralink - Technology</a></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1> -<p class="Pp">The <code class="Nm">ral</code> driver first appeared in - <span class="Ux">OpenBSD 3.7</span> and in <span class="Ux">NetBSD - 3.0</span>. Support for the RT2501 and RT2600 chipsets was added in - <span class="Ux">OpenBSD 3.9</span> and in <span class="Ux">NetBSD - 4.0</span>.</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1> -<p class="Pp">The <code class="Nm">ral</code> driver was written by - <span class="An">Damien Bergamini</span> - <<a class="Mt" href="mailto:damien@openbsd.org">damien@openbsd.org</a>>.</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="CAVEATS"><a class="permalink" href="#CAVEATS">CAVEATS</a></h1> -<p class="Pp">Some PCI <code class="Nm">ral</code> adapters seem to strictly - require a system supporting PCI 2.2 or greater and will likely not work in - systems based on older revisions of the PCI specification. Check the board's - PCI version before purchasing the card.</p> -<p class="Pp">The USB <code class="Nm">ral</code> driver supports automatic - control of the transmit speed in BSS mode only. Therefore the use of a USB - <code class="Nm">ral</code> adapter in Host AP mode is discouraged.</p> -</section> -</div> -<table class="foot"> - <tr> - <td class="foot-date">December 13, 2009</td> - <td class="foot-os">NetBSD 10.1</td> - </tr> -</table> |