* README
*
* Ralink Tech Inc.
* 
* http://www.ralinktech.com
*

=======================================================================
ModelName:
===========
RT73(RT2571W) Wireless Lan Linux Driver


=======================================================================
Driver lName:
===========
rt73


=======================================================================
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 RT73 a/b/g WLAN Card.


=======================================================================
Contents:
=============
Makefile.4		    : Makefile for kernel 2.4 series
Makefile.6		    : Makefile for kernel 2.6 series
*.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 RT73_Linux_STA_Drv_x.x.x.x.tar.gz
    go to "./RT73_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]
   
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 rt73.bin /etc/Wireless/RT73STA/	    # copy firmware
 
6>  $dos2unix rt73sta.dat
    $cp rt73sta.dat  /etc/Wireless/RT73STA/rt73sta.dat       
    # !!!check if it is a binary file before loading !!!  
    
7> $load                
    #[kernel 2.4]
    #    $/sbin/insmod rt73.o
    #    $/sbin/ifconfig rausb0 inet YOUR_IP up
        
    #[kernel 2.6]
    #    $/sbin/insmod rt73.ko
    #    $/sbin/ifconfig rausb0 inet YOUR_IP up


=======================================================================
CONFIGURATION:  
====================
RT73 driver can be configured via following interfaces, 
i.e. (i)"iwconfig" command, (ii)"iwpriv" command, (iii) configuration file
     (iv)RaConfig

i)  iwconfig comes with kernel.  
ii) iwpriv usage, please refer to file "iwpriv_usage.txt" for details.
iii)copy configuration file "rt73sta.dat" to /etc/Wireless/RT73STA/rt73sta.dat.
iv) RaConfig is utility for rt73.

Note: 
           
Configuration File : rt73sta.dat
---------------------------------------
# Copy this file to /etc/Wireless/RT73STA/rt73sta.dat
# This file is a binary file and will be read on loading rt.o module.
#
# Use "vi -b rt73sta.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
TurboRate=0
WmmCapable=0
AckPolicy=0;0;0;0
BGProtection=0
IEEE80211H=0
TxRate=0
RTSThreshold=2347
FragThreshold=2346
PSMode=CAM
TxPreamble=0
AdhocOfdm=0
FastRoaming=0
RoamThreshold=70

-----------------------------------------------
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: use 52, 56, 60, 64 Channel
		9: use 34, 38, 42, 46 Channel
		10: use 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_5226) or RfIcType=3(id=RFIC_5225)   
		3: 11a/b/g mixed,   //Support in RfIcType=1(id=RFIC_5226) or RfIcType=3(id=RFIC_5225)
		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. AdhocOfdm=value
    value
        0: WIFI mode    (1,2,5.5,11 mbps rates)   				   
        1: b/g mixed,   (1,2,5.5,11,6,9,12,18,24,36,48,54 mbps rates)
        2: 11g only,    (6,9,12,18,24,36,48,54 mbps rates) 
        3: 11a only,    (6,9,12,18,24,36,48,54 mbps rates)
        
14. 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

15. EncrypType=value
	value
		NONE        For AuthMode=OPEN                    
		WEP         For AuthMode=OPEN or SHARED 
		TKIP        For AuthMode=WPAPSK or WPA2PSK or WPANONE                 
		AES         For AuthMode=WPAPSK or WPA2PSK or WPANONE                 
		
16. DefaultKeyID=value
	value
		1~4

17. 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)

18. Key1Type=vaule
    Key2Type=value
    Key3Type=vaule
    Key4Type=vaule
    value
		0   hexadecimal type
		1   assic type
    (usage : reading profile only)

19. 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)	
                                                    
20. WPAPSK=value              	
	value
		8~63 ASCII  		or 
		64 HEX characters

21. PSMode=value
    value
    	0: CAM			Constantly Awake Mode
		1: Max_PSP		Max Power Savings
		2: Fast_PSP		Power Save Mode
	
22. IEEE80211H=value
	value
		0:	Disable
		1:	Enable	Spectrum management
	    (This field can be enable only in A band)

23. FastRoaming=value
    value
        0: Disable
        1: Enable Fast Roaming

24. RoamThreshold=value
    vale
        61 ~ 89
        
    This value is a absolute threshold in dBm.
    The condition to roam when receiving Rssi less than (-1*value).

// //////////////////////    																		
//  No Support !!!
// /////////////////////
//  PktAggregate,            
//  TurboRate,																
//  WmmCapable,				
//  AckPolicy
// /////////////////////

MORE INFORMATION
=================================================================================
If you want for rt73 driver to auto-load at boot time:
A) choose rausb0 for first RT73 WLAN card, rausb1 for second RT73 WLAN card, etc.
 
B) go to "./RT73_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-rausb0 .


*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.

E) When build for Mandriva 2007.1, please unmark the part for Mandriva in Makefile.
   You have to remove the module pre-loaded by Mandriva 2007.1 before
   you can load our rt73sta module.
   Edit this file /lib/modules/`uname -r`/build/.kernelrelease before "4> make all"
   Change it to 2.6.17-13mdv (should be the same as "uname -r" value)
   Follow "Build Instructions: 4> and 4.1>"  then the driver should be loaded correctly on boot up.