* README
*
* Ralink Tech Inc. 2006/10/23
*
* 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 Fedora 1 and Fedora 4 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 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_AP_Drv_x.x.x.x.tar.gz
    go to "./RT73_Linux_AP_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

5> mkdir /etc/Wireless/RT73
   $cp rt73.bin /etc/Wireless/RT73/	    # copy firmware

6>  $dos2unix rt73.dat
    $cp rt73.dat  /etc/Wireless/RT73/rt73.dat
    # !!!check if it is a binary file before loading !!!

7> $./load      # modify your IP in the file, 'load' & 'unload'
    #[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

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

Note:

Configuration File : rt73.dat
---------------------------------------
# Copy this file to /etc/Wireless/RT73/rt73.dat
# This file is a binary file and will be read on loading rt.o module.
#
# Use "vi -b rt73.dat" to modify settings according to your need.
#
# 2.) set Channel to "0" for auto-select on Infrastructure mode
# 3.) set SSID for your Accss-point.
# 4.) AuthMode can be "WEPAUTO", "OPEN", "SHARED", "WPAPSK", "WPA2PSK"
# 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]
OpMode=1
CountryRegion=0
CountryRegionABand=7
WirelessMode=0
SSID=SampleAP
Channel=1
BasicRate=15
BeaconPeriod=100
DtimPeriod=1
TxPower=50
AuthMode=OPEN
EncrypType=NONE
RekeyInterval=0
RekeyMethod=TIME
DefaultKeyID=1
Key1Type=0
Key1Str=1234567890
Key2Type=0
Key2Str=1234567891
Key3Type=0
Key3Str=1234567892
Key4Type=0
Key4Str=1234567893
WPAPSK=12345678
TxBurst=0
HideSSID=0
ShortSlot=0
AutoChannelSelect=0
BGProtection=0
TxRate=0
RTSThreshold=2347
FragThreshold=2346
NoForwarding=0
TxPreamble=0

-----------------------------------------------
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. WirelessMode=value
	value
		0: 11b/g mixed,
		1: 11b only,
		2: 11g only
		3: 11a only,        //Support in RfIcType=1(id=RFIC_5226) or RfIcType=3(id=RFIC_5225)
		4: 11a/b/g mixed,   //Support in RfIcType=1(id=RFIC_5226) or RfIcType=3(id=RFIC_5225)

4. SSID=value
	value
		0~z, 1~32 ascii characters.

5. Channel=value
	value
		depends on CountryRegion or CountryRegionABand

6. BasicRate=value
    value
        bit0:  1Mbps, bit1:  2Mbps,  bit2: 5.5Mbps, bit3: 11Mbps
        bit4:  6Mbps, bit5:  9Mbps,  bit6: 12Mbps,  bit7: 18Mbps
        bit8: 24Mbps, bit9: 36Mbps, bit10: 48Mbps, bit11: 54Mbps

    Notes:
        Set correct basic rates set before changing wireless mode.
        11B/G Mixed:
            iwpriv rausb0 set BasicRate=15 --->(0x0F: 1, 2, 5.5, 11 Mbps)
            iwpriv rausb0 set WirelessMode=0
        11B:
            iwpriv rausb0 set BasicRate=3 ---->(0x03: 1, 2 Mbps)
            iwpriv rausb0 set WirelessMode=1
        11G-Only:
            iwpriv rausb0 set BasicRate=351 ---> (0x15F : 1, 2, 5.5, 11, 6, 12, 24 Mbps)
            iwpriv rausb0 set WirelessMode=2

7. BeaconPeriod=value
    value
        20 ~ 999 (unit: ms)

8. DtimPeriod=value
    value
        1 ~ 255 (unit: BeaconPeriod)

9. TxPower=value
    value
        100 ~ 90 use value in E2PROM as default
        90 ~ 60 default value -2
        60 ~ 30 default value -6
        30 ~ 15 default value -12
        15 ~ 9 default value -18
        9 ~ 0 default value -24
    Note:
        1. Range: 1 ~ 100 (unit in percentage)
        2. This value restricted by HW characteristic.

10. 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
		WPA2PSK         For WPA2 pre-shared key
        WPAPSKWPA2PSK   For WPA/WPA2 mix mode
    Note:
        WPA and analogous only support TKIP and AES as encryption method.
        SHARED only supports Wep as encryption method.
        WEPAUTO means AP can accept STA connect to it using OPEN-WEP or SHARED-WEP

11. EncrypType=value
	value
		NONE        For AuthMode=OPEN
		WEP         For AuthMode=OPEN or SHARED
		TKIP        For AuthMode=WPAPSK or WPA2PSK
		AES         For AuthMode=WPAPSK or WPA2PSK
        TKIPAES     TKIP/AES mix mode

12. RekeyInterval=value
    value
        0 ~ 0x3fffff ;unit:1seconds/1000packets

13. RekeyMethod=value
    value
        TIME: Time rekey
        PKT: Packet rekey
        DISABLE: Disable rekey

14. DefaultKeyID=value
	value
		1~4

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

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

17. WPAPSK=value
    value
        8 ~ 63 ascii characters
        or
        64 hexadecimal characters

18. TxBurst=value
    value
		0: Disable
		1: Enable

19. HideSSID=value
    value
        0: Disable
        1: Enable

20. ShortSlot=value
    value
        0: Disable
        1: Enable

21. AutoChannelSelect=value
    value (auto channel select when driver is loaded, only support in B/G band)
        0: Disable
        1: Enable

22. BGProtection=value
	value
		0: Auto
		1: Always on
		2: Always off

23. TxRate=value
	value
		 0: Auto    	//WirelessMode=0~4
		 1: 1 Mbps	 	//WirelessMode=0 or 1 or 2
         2: 2 Mbps	 	//WirelessMode=0 or 1 or 2
         3: 5.5 Mbps 	//WirelessMode=0 or 1 or 2
         4: 11 Mbps 	//WirelessMode=0 or 1 or 2
         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

24. RTSThreshold=value
	value
		1~2347

25. FragThreshold=value
	value
		256~2346

26. NoForwarding=value
    value
        0: Disable
        1: Enable

27. TxPreamble=value
    value
		0: Preamble Long
		1: Preamble Short
		2: Auto


// //////////////////////
//  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) create(edit) 'ifcfg-rausb0' file in /etc/sysconfig/network-scripts/,
   edit( or add the line) in /etc/modules.conf:
       alias rausb0 rt73

C) edit(create) the file /etc/sysconfig/network-scripts/ifcfg-rausb0
   DEVICE='rausb0'
   ONBOOT='yes'

/* End of README */
