Code: Select all
* README
*
* Ralink Tech Inc.
*
* http://www.ralinktech.com
*
=======================================================================
ModelName:
===========
RT61 Wireless Lan Linux Driver
=======================================================================
Driver lName:
===========
rt61.o/rt61.ko
=======================================================================
Supporting Kernel:
===================
linux kernel 2.4 and 2.6 series.
Tested in Redhat 7.3 or later.
=======================================================================
Description:
=============
This is a linux device driver for Ralink RT61 a/b/g WLAN Card.
=======================================================================
Contents:
=============
Makefile.4 : Makefile for kernel 2.4 series
Makefile.6 : Makefile for kernel 2.6 series
Makefile.RTL865x : Makefile for big endian platform
*.c : c files
*.h : header files
=======================================================================
Features:
==========
This driver implements basic IEEE802.11. Infrastructure and adhoc mode with
open or shared or WPA-PSK or WPA2-PSK authentication method.
NONE, WEP, TKIP and AES encryption.
=======================================================================
Build Instructions:
====================
1> $tar -xvzf RT61_Linux_STA_Drv_x.x.x.x.tar.gz
go to "./RT61_Linux_STA_Drv_x.x.x.x/Module" directory.
2> $cp Makefile.4 ./Makefile # [kernel 2.4]
or
$cp Makefile.6 ./Makefile # [kernel 2.6]
or
$cp Makefile.RTL865x ./Makefile # big endian platform
3> [kernel 2.4]
$chmod 755 Configure
$make config # config build linux os version
4> $make all # compile driver source code
4.1> $make install
5> $cp rt2561.bin /etc/Wireless/RT61STA/ # copy firmware
$cp rt2561s.bin /etc/Wireless/RT61STA/
$cp rt2661.bin /etc/Wireless/RT61STA/
6> $dos2unix rt61sta.dat
$cp rt61sta.dat /etc/Wireless/RT61STA/rt61sta.dat
# !!!check if it is a binary file before loading !!!
7> $load
#[kernel 2.4]
# $/sbin/insmod rt61.o
# $/sbin/ifconfig ra0 inet YOUR_IP up
#[kernel 2.6]
# $/sbin/insmod rt61.ko
# $/sbin/ifconfig ra0 inet YOUR_IP up
Note: Script functionality:
load load module to kernel
unload unload module from kernel
Configure retrieve linux version
=======================================================================
CONFIGURATION:
====================
RT61 driver can be configured via following interfaces,
i.e. (i)"iwconfig" command, (ii)"iwpriv" command, (iii) configuration file,
(iv)RaConfig61
i) iwconfig comes with kernel.
ii) iwpriv usage, please refer to file "iwpriv_usage.txt" for details.
iii)copy configuration file "rt61sta.dat" to /etc/Wireless/RT61STA/rt61sta.dat.
iv) RaConfig61 is utility for rt61.
Configuration File : rt61sta.dat
---------------------------------------
# Copy this file to /etc/Wireless/RT61STA/rt61sta.dat
# This file is a binary file and will be read on loading rt.o module.
#
# Use "vi -b rt61sta.dat" to modify settings according to your need.
#
# 1.) set NetworkType to "Adhoc" for using Adhoc-mode, otherwise using Infrastructure
# 2.) set Channel to "0" for auto-select on Infrastructure mode
# 3.) set SSID for connecting to your Accss-point.
# 4.) AuthMode can be "WEPAUTO", "OPEN", "SHARED", "WPAPSK", "WPA2PSK", "WPANONE"
# 5.) EncrypType can be "NONE", "WEP", "TKIP", "AES"
# for more information refer to the Readme file.
#
# The word of "[Default]" must not be removed
[Default]
CountryRegion=0
CountryRegionABand=7
WirelessMode=0
SSID=AP350
NetworkType=Infra
Channel=0
AuthMode=OPEN
EncrypType=NONE
DefaultKeyID=1
Key1Type=0
Key1Str=0123456789
Key2Type=0
Key2Str=
Key3Type=0
Key3Str=
Key4Type=0
Key4Str=
WPAPSK=abcdefghijklmnopqrstuvwxyz
TxBurst=0
PktAggregate=0
WmmCapable=0
APSDCapable=0
APSDAC=0;0;0;0
BGProtection=0
ShortSlot=0
IEEE80211H=0
TxRate=0
RTSThreshold=2347
FragThreshold=2346
PSMode=CAM
TxPreamble=0
FastRoaming=0
NativeWpa=1
-----------------------------------------------
*NOTE:
WMM parameters:
1.) WmmCapable
Set it as 1 to turn on WMM Qos support
2.) APSDCapable
Set it as 1 to use automatic power-save delivery(APSD) on an Non-AP QSTA
3.) APSDAC
Set ACs corresponding BE, BK, VI and VO as delivery-enabled or delivery-disabled
All WMM parameters do not support iwpriv command but WmmCapable,
please store all parameter to rt61sta.dat, and restart driver.
NetworkManager and WPS:
If Native WPA Supplicant (NetworkManager) is enabled, WPS CAN NOT be triggered.
For this case, we have to set NativeWpa=1 in rt61sta.dat.
Otherwise, if we want to use WPS, we have to disable NetworkManager by setting
NativeWpa=0 in rt61sta.dat.
-----------------------------------------------
syntax is 'Param'='Value' and describes below.
1. CountryRegion=value
value
0: use 1 ~ 11 Channel
1: use 1 ~ 13 Channel
2: use 10, 11 Channel
3: use 10 ~ 13 Channel
4: use 14 Channel
5: use 1 ~ 14 Channel
6: use 3 ~ 9 Channel
7: use 5 ~ 13 Channel
2. CountryRegionABand=value
value
0: use 36, 40, 44, 48, 52, 56, 60, 64, 149, 153, 157, 161, 165 Channel
1: use 36, 40, 44, 48, 52, 56, 60, 64, 100, 104, 108, 112, 116, 120, 124, 128, 132, 136, 140 Channel
2: use 36, 40, 44, 48, 52, 56, 60, 64 Channel
3: use 52, 56, 60, 64, 149, 153, 157, 161 Channel
4: use 149, 153, 157, 161, 165 Channel
5: use 149, 153, 157, 161 Channel
6: use 36, 40, 44, 48 Channel
7: use 36, 40, 44, 48, 52, 56, 60, 64, 100, 104, 108, 112, 116, 120, 124, 128, 132, 136, 140, 149, 153, 157, 161, 165 Channel
8: 52, 56, 60, 64 Channel
9: 34, 38, 42, 46 Channel
10: 34, 36, 38, 40, 42, 44, 46, 48, 52, 56, 60, 64 Channel
3. SSID=value
value
0~z, 1~32 ascii characters.
4. WirelessMode=value
value
0: 11b/g mixed
1: 11B only
2: 11A only //Support in RfIcType=1(id=RFIC_5225) or RfIcType=2(id=RFIC_5325)
3: 11a/b/g mixed //Support in RfIcType=1(id=RFIC_5225) or RfIcType=2(id=RFIC_5325)
4: 11G only
5. TxRate=value
value
0: Auto //WirelessMode=0~4
1: 1 Mbps //WirelessMode=0 or 1 or 3
2: 2 Mbps //WirelessMode=0 or 1 or 3
3: 5.5 Mbps //WirelessMode=0 or 1 or 3
4: 11 Mbps //WirelessMode=0 or 1 or 3
5: 6 Mbps //WirelessMode=0 or 2 or 3 or 4
6: 9 Mbps //WirelessMode=0 or 2 or 3 or 4
7: 12 Mbps //WirelessMode=0 or 2 or 3 or 4
8: 18 Mbps //WirelessMode=0 or 2 or 3 or 4
9: 24 Mbps //WirelessMode=0 or 2 or 3 or 4
10: 36 Mbps //WirelessMode=0 or 2 or 3 or 4
11: 48 Mbps //WirelessMode=0 or 2 or 3 or 4
12: 54 Mbps //WirelessMode=0 or 2 or 3 or 4
6. Channel=value
value
depends on CountryRegion or CountryRegionABand
7. BGProtection=value
value
0: Auto
1: Always on
2: Always off
8. TxPreamble=value
value
0:Preamble Long
1:Preamble Short
2:Auto
9. RTSThreshold=value
value
1~2347
10. FragThreshold=value
value
256~2346
11. TxBurst=value
value
0: Disable
1: Enable
12. NetworkType=value
value
Infra: infrastructure mode
Adhoc: adhoc mode
13. AuthMode=value
value
OPEN For open system
SHARED For shared key system
WEPAUTO Auto switch between OPEN and SHARED
WPAPSK For WPA pre-shared key (Infra)
WPA2PSK For WPA2 pre-shared key (Infra)
WPANONE For WPA pre-shared key (Adhoc)
WPA Use WPA_Supplicant
WPA2 Use WPA_Supplicant
14. EncrypType=value
value
NONE For AuthMode=OPEN
WEP For AuthMode=OPEN or AuthMode=SHARED
TKIP For AuthMode=WPAPSK or WPA2PSK
AES For AuthMode=WPAPSK or WPA2PSK
15. DefaultKeyID=value
value
1~4
16. Key1=value
Key2=value
Key3=value
Key4=value
value
10 or 26 hexadecimal characters eg: 012345678
5 or 13 ascii characters eg: passd
(usage : "iwpriv" only)
17. Key1Type=vaule
Key2Type=value
Key3Type=vaule
Key4Type=vaule
value
0 hexadecimal type
1 assic type
(usage : reading profile only)
18. Key1Str=value
Key2Str=value
Key3Str=vaule
Key4Str=vaule
value
10 or 26 characters (key type=0)
5 or 13 characters (key type=1)
(usage : reading profile only)
19. WPAPSK=value
value
8~63 ASCII or
64 HEX characters
20. PktAggregate=value
value
0: Disable
1: Enable when the peer supports it
21. WmmCapable=value
value
0: Disable WMM
1: Enable WMM
22. PSMode=value
value
CAM Constantly Awake Mode
Fast_PSP Power Save Mode
MAX_PSP Max power save mode
23. IEEE80211H=value
value
0: Disable
1: Enable Spectrum management
(This field can be enable only in A band)
24. FastRoaming=value
value
0: Disable Fast Roaming
1: Enable Fast Roaming
25. RoamThreshold=value
value [Valid on FastRoaming=1]
60~90
26. APSDCapable=value
value [Valid on WmmCapable=1]
0: Disable APSD
1: Enable APSD
27. APSDAC=value
value [Valid on APSDCapable=1]
0: Delivery-disabled AC
1: Delivery-enabled AC
//========================//
AC_BE AC_BK AC_VI AC_VO
{0, 1};{0, 1};{0, 1};{0, 1}
//========================//
MORE INFORMATION
=================================================================================
If you want for rt61 driver to auto-load at boot time:
A) choose ra0 for first RT61 WLAN card, ra1 for second RT61 WLAN card, etc.
B) go to "./RT61_Linux_STA_Drv_x.x.x.x/Module" directory.
$make install
NOTE:
if you use dhcp,
add this line
BOOTPROTO='dhcp'
in the file ifcfg-ra0 .
*C) To ease the Default Gateway setting,
add the line
GATEWAY=x.x.x.x
in /etc/sysconfig/network
D) When build for SUSE, please unmark the part for SUSE in Makefile.
When build for Mandriva 2007.1, please unmark the part for Mandriva in Makefile.