Code:
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 ******** 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.
Thank's MickeySa ... Now it's working !!! :respect-046:
Bookmarks