From 7c48ffbe41b4c3205d546ac389cf9f307f0719ae Mon Sep 17 00:00:00 2001 From: damien Date: Fri, 25 Jul 2008 16:18:54 +0000 Subject: [PATCH] document RT2700 (tested by bernd@) and try documenting WPA support. --- share/man/man4/ral.4 | 61 ++++++++++++++++++++++++++------------------ 1 file changed, 36 insertions(+), 25 deletions(-) diff --git a/share/man/man4/ral.4 b/share/man/man4/ral.4 index 5a71bd5a62e..f4c37595021 100644 --- a/share/man/man4/ral.4 +++ b/share/man/man4/ral.4 @@ -1,6 +1,6 @@ -.\" $OpenBSD: ral.4,v 1.80 2008/04/17 14:01:22 jmc Exp $ +.\" $OpenBSD: ral.4,v 1.81 2008/07/25 16:18:54 damien Exp $ .\" -.\" Copyright (c) 2005-2007 +.\" Copyright (c) 2005-2008 .\" Damien Bergamini .\" .\" Permission to use, copy, modify, and distribute this software for any @@ -15,7 +15,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: April 17 2008 $ +.Dd $Mdocdate: July 25 2008 $ .Os .Dt RAL 4 .Sh NAME @@ -49,15 +49,19 @@ multiple radio transceivers to extend the operating range of the adapter and to achieve higher throughput. However, the RT2600 chipset does not support any of the 802.11n features. .Pp -The RT2800 chipset is the first generation of 802.11n-Draft 2.0 adapters -from Ralink. -It consists of two integrated chips, an RT2860 or RT2890 MAC/BBP and an -RT2820 (2.4GHz) or RT2850 (2.4GHz/5GHz) radio transceiver. -The RT2800 chipset supports up to two transmit paths and three receiver paths -(aka 2T3R). +The RT2800 chipset is the first generation of 802.11n adapters from Ralink. +It consists of two integrated chips, an RT2860 or RT2890 (PCIe) MAC/BBP and +an RT2820 (2.4GHz) or RT2850 (2.4GHz/5GHz) radio transceiver. +The RT2800 chipset supports two transmit paths and up to three receiver +paths (2T2R/2T3R). It can achieve speeds up to 144Mbps (20MHz bandwidth) and 300Mbps (40MHz bandwidth.) .Pp +The RT2700 chipset is a low-cost version of the RT2800 chipset. +It supports a single transmit path and two receiver paths (1T2R). +It consists of two integrated chips, an RT2760 or RT2790 (PCIe) MAC/BBP and +an RT2720 (2.4GHz) or RT2750 (2.4GHz/5GHz) radio transceiver. +.Pp These are the modes the .Nm driver can operate in: @@ -88,16 +92,18 @@ capture packets from networks which it wouldn't normally have access to, or to scan for access points. .El .Pp +The +.Nm +driver can be configured to use the WEP, WPA-PSK and WPA2-PSK protocols. +.Pp +The +.Nm +driver relies on the software 802.11 stack for both encryption and +decryption of data frames on the RT2500, RT2501 and RT2600 chipsets. +On the RT2700 and RT2800 chipsets, the .Nm -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. +driver offloads both encryption and decryption of data frames to the +hardware for the WEP40, WEP104, TKIP(+MIC) and CCMP ciphers. .Pp The transmit speed is user-selectable or can be adapted automatically by the driver depending on the number of hardware transmission retries. @@ -109,7 +115,7 @@ driver can be configured at runtime with or on boot with .Xr hostname.if 5 . .Sh FILES -The RT2501, RT2600 and RT2800 chipsets require the following firmware +The RT2501, RT2600, RT2700 and RT2800 chipsets require the following firmware files to be loaded when an interface is brought up: .Pp .Bl -tag -width Ds -offset indent -compact @@ -267,16 +273,19 @@ inet 192.168.1.1 255.255.255.0 NONE media autoselect \e mediaopt hostap nwid my_net chan 11 .Ed .Pp -Configure ral0 for WEP, using hex key -.Dq 0x1deadbeef1 : +Configure ral0 to join network +.Dq my_net +using WPA-PSK with passphrase +.Dq my_passphrase : .Bd -literal -offset indent -# ifconfig ral0 nwkey 0x1deadbeef1 +# PSK=$(wpa-psk my_net my_passphrase) +# ifconfig ral0 nwid my_net wpa wpapsk $PSK .Ed .Pp Return ral0 to its default settings: .Bd -literal -offset indent # ifconfig ral0 -bssid -chan media autoselect \e - nwid "" -nwkey + nwid "" -nwkey -wpa .Ed .Pp Join an existing BSS network, @@ -322,6 +331,8 @@ Support for the RT2501 and RT2600 chipsets was added in .Ox 3.9 . Support for the RT2800 chipset was added in .Ox 4.3 . +Support for the RT2700 chipset was added in +.Ox 4.4 . .Sh AUTHORS The .Nm @@ -330,8 +341,8 @@ driver was written by .Sh CAVEATS The .Nm -driver does not support any of the 802.11n-Draft 2.0 capabilities offered by -the RT2800 chipset. +driver does not support any of the 802.11n capabilities offered by +the RT2700 and RT2800 chipsets. Additional work is required in .Xr ieee80211 9 before those features can be supported. -- 2.20.1