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

===============================================================================================
ModelName:
===========
RT2500USB

===============================================================================================
Driver lName:
===========
rt2570.ko

===============================================================================================
Ralink Hardware:
===========
Ralink 802.11b/g wireless network card.

===============================================================================================
Description:
=============
This is a linux device driver for Ralink RT2500USB b/g WLAN Card.
This driver implements basic 802.11 function. 
Infrastructure and Ad-hoc mode with open or shared or wpapsk or wpa2psk authentication method.
WEP-40 and WEP-104 or tkip or aes encryption. 


===============================================================================================
Compatibility:
===================
Testing has been done with LinEX kernel 2.6.9, Fedora Core 3.
You may encounter some rough edges when working with recent other Linux kernels branch.


===============================================================================================
FILE LAYOUT:
=============
*.c		    : c files
*.h		    : header files                   
Makefile.6		:Makefile for kernel 2.6
Makefile.4		:Makefile for kernel 2.4
./LINUX_RACONFIG_Vx.x.x.x  : source code for utility RaConfig2500 version x.x.x.x
./LINUX_RACONFIG_Vx.x.x.x/bin/LINUX/RaConfig2500  : utility RaConfig2500

===============================================================================================
Build Instructions:  
====================
0) $dos2unix *
      $chmod 644 *
      $chmod 755 Configure

1) cp Makefile.x Makefile               // x is your kernel

2) $make
3) $insmod rt2570.ko     # Insert driver module
4) $ifconfig rausb0 up  # Bring up device 
5) $dhclient rausb0  # Get network IP address

  Note: Script functionality:
  Configure       retrive linux version 
6) ./LINUX_RACONFIG_Vx.x.x.x/bin/"Linux"/RaConfig2500

if lack of libstdc++.so.6, cp ./LINUX_RACONFIG_Vx.x.x.x/libstdc++.so.6 /usr/lib

7)Edit(or add the line) in /etc/modules.conf
   alias rausb0 rt2570

8) Create and edit 'ifcfg-rausb0' file in /etc/sysconfig/network-script/
   DEVICE='rausb0'
   ONBOOT='yes'
   BOOTPROTO='dhcp' 

===============================================================================================
CONFIGURATION:  
====================
RT2500 driver can be configured via following interfaces, 
i.e. i)RaConfig2500, ii)wireless extension,
i) RaConfig2500 is utility for rt25usb.

ii)  Wireless extension usage please refer to man page of 'iwconfig', 'iwlist' and 'iwpriv'. 
     Here is definition for private command 'iwpriv'
-------------------------------------------------------------------------------------------------------
NAME
       iwpriv - configure optionals (private) parameters of a wireless network
       interface
	
SYNOPSIS
       iwpriv [interface]
       iwpriv [interface] [parameters] [val]


DESCRIPTION 
[interface]      [parameters]             [val]                    explaination
-----------    -----------------     ----------------         --------------------------------
rausb0		    auth		  1~5			 1:Open
								 2:Shared
								 3:WPAPSK
								 4:WPA2PSK
								 5:WPANONE
								
rausb0		    psm		  	  0~1			 0:Continuous wake up
								 1:power safe mode

rausb0		    enc			  1~4			 1:none
								 2:wep
								 3:tkip
								 4:aes
								
rausb0		    wpapsk		  8~64 chars		 WPAPSK password


===============================================================================================
EXAMPLE:  
====================
Example I: Config STA to link with AP and OPEN/NONE(Authentication/Encryption)
	1. iwconfig rausb0 mode Managed
	2. iwconfig rausb0 key off
	3. iwconfig rausb0 essid "AP's SSID"

Example II: Config STA to link as Ad-hoc mode and OPEN/NONE(Authentication/Encryption)
	1. iwconfig rausb0 mode ad-hoc
	2. iwconfig rausb0 key off
	3. iwconfig rausb0 essid "Desired SSID"
	
Example III: Config STA to link with AP and OPEN/WEP(Authentication/Encryption). 
            Default Key ID = 3
	1. iwconfig rausb0 key [3]
	2. iwconfig rausb0 key s:abcde
	3. iwconfig rausb0 essid "AP's SSID"
	
Example IV: Config STA to link with ad-hoc mode and WPAPSK/TKIP(Authentication/Encryption)
            WPA PreShared-Key is 12345678
        1. iwconfig rausb0 mode ad-hoc
        2. iwpriv rausb0 auth 4
	3. iwpriv rausb0 enc 3
	4. iwconfig rausb0 essid "Desired SSID"
	5. iwpriv rausb0 wpapsk 12345678
	6. iwconfig rausb0 essid "Desired SSID"
	
Example V: Config STA to link with AP and WPAPSK/AES(Authentication/Encryption)
            WPA PreShared-Key is 12345678
	1. iwpriv rausb0 enc 4
	2. iwpriv rausb0 auth 3
	3. iwconfig rausb0 essid "AP's SSID"
	4. iwpriv rausb0 wpapsk 12345678
	5. iwconfig rausb0 essid "AP's SSID"
	
Example VI: Config STA to link with AP and WPA2PSK/TKIP(Authentication/Encryption)
            WPA PreShared-Key is 12345678
	1. iwpriv rausb0 enc 3
	2. iwpriv rausb0 auth 4
	3. iwconfig rausb0 essid "AP's SSID"
	4. iwpriv rausb0 wpapsk 12345678
	5. iwconfig rausb0 essid "AP's SSID"
	
p.s Step 2 is part of generating wpapsk password and is necessary.




           

