Installation instructions for the rt2500 Module

=======================================================================
Build Instructions:  
====================
For 2.4 or 2.6 series kernel:
a. $tar -xvzf rt2500-x.x.x.tar.gz
    go to "./rt2500-x.x.x/Module" directory.

b. $make                # compile driver source code

c. $make install	# installs kernel module driver 

(read end of file for FedoraCore3 specific information) 
 
=======================================================================
To BUILD UTILITY
====================

a.  go to the "./Utility" directory

b.  run 'qmake -o Makefile raconfig2500.pro'
    If qmake command is not found in your system, you can download the QT tool 
    'qt-x11-free-3.2.1' or later at 
    http://www.trolltech.com/
    
    (qmake comes with RedHat 7.3 or later QT Package)    

c.  run 'make" to compile the utility source code.
   
d.  After all, an execution file would be generated "RaConfig2500"
    run "RaConfig2500" to config the driver as you want



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

i)  iwconfig comes with kernel.  
ii) iwpriv usage, please refer to file "iwpriv_usage.txt" for details.
iii)copy configuration file "RT2500STA.dat" to /etc/Wireless/RT2500STA/RT2500STA.dat.
    Please refer to 3.1) for details.
iv) RT2500 provides API : RaConfig2500, please go to directory ./Utility and refer to how-to-compile.txt

           
Configuration File : RT2500STA.dat

# Copy this file to /etc/Wireless/RT2500STA/RT2500STA.dat
# This file is a binary file and will be read on loading rt2500.o module.
#
# Use "vi -b RT2500STA.dat" to modify settings according to your need.
# 
# 1.) set NetworkType to "Adhoc" for using Adhoc-mode, otherwise using as Infrastructure-mode
# 2.) set Channel to "0" for auto-select on Infrastructure mode
# 3.) set SSID for connecting to your Accss-point.
# 4.) AuthMode can be "OPEN", "SHARED", "AUTO", "WPAPSK", "WPANONE"
# 5.) EncrypType can be "NONE", "WEP", "TKIP", "AES"
# for more information refer to the Readme file.
#
# When editing the file, make sure the filesize does not exceed 1024 Bytes (1kb).
# Anything stored beyond the 1024 bte limit will be ignored by the driver.
#
[Default]
CountryRegion=0
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
TurboRate=0
BGProtection=0
ShortSlot=0
TxRate=0
RTSThreshold=2312
FragThreshold=2312
PSMode=CAM
-----------------------------------------------
syntax is 'Param'='Value' and describes below. 

1. CountryRegion=value
   value
        0:      for use channel 1-11
        1:      for use channel 1-11
        2:      for use channel 1-13
        3:      for use channel 10-11
        4:      for use channel 10-13
        5:      for use channel 14
        6:      for use channel 1-14
        7:      for use channel 3-9
2. WirelessMode=value
   value
        0:      802.11 B/G mixed
        1:      802.11 B only
3. SSID=value
   value
         1~32 ascii characters.
4. NetworkType=Infra
   value
       Infra : infrastructure mode
       Adhoc : adhoc mode
5. Channel=value
    value
        1~14 depends on  CountryRegion
6. AuthMode=value
    value
        OPEN      For Open System
        SHARED    For Shared key system
        AUTO
        WPAPSK    
7. EncrypType=value
    value
        NONE      :For AuthMode=OPEN
        WEP       :For AuthMode=OPEN or AuthMode=SHARED
        TKIP      :For AuthMode=WPAPSK
        AES       :For AuthMode=WPAPSK
8. DefaultKeyID=value
    value
        1 ~ 4
9. Key1Type=value
    value
        0:        Hexadecimal
        1:        Ascii
10. Key1Str=value
    value
        10 or 26 hexadecimal characters eg: 012345678
        5 or 13 ascii characters eg: passd
11. Key2Type=value
    value
        0:        Hexadecimal
        1:        Ascii
12. Key2Str=value
    value
        10 or 26 hexadecimal characters eg: 012345678
        5 or 13 ascii characters eg: passd
13. Key3Type=value
    value
        0:        Hexadecimal
        1:        Ascii
14. Key3Str=value
    value
        10 or 26 hexadecimal characters eg: 012345678
        5 or 13 ascii characters eg: passd
15. Key4Type=value
    value
        0:        Hexadecimal
        1:        Ascii
16. Key4Str=value
    value
        10 or 26 hexadecimal characters eg: 012345678
        5 or 13 ascii characters eg: passd
17. WPAPSK=value
    value
        8 ~ 63 characters
          or
        64 hexadecimal characters
18. TxBurst=value
    value
        0:        Disable
        1:        Enable
19. TurboRate=value
    value
        0:        Disable
        1:        Enable
20. BGProtection=value
   value
        0:        Auto
        1:        Always On
        2:        Always Off
21. ShortSlot=value
    value
        0:        Disable
        1:        Enable
22. TxRate=value
   value
         0:     Auto
         1:     1 Mbps
         2:     2 Mbps
         3:     5.5 Mbps
         4:     11 Mbps 
         5:     6  Mbps  //WirelessMode must be 0
         6:     9  Mbps  //WirelessMode must be 0
         7:     12 Mbps  //WirelessMode must be 0
         8:     18 Mbps  //WirelessMode must be 0
         9:     24 Mbps  //WirelessMode must be 0
        10:     36 Mbps  //WirelessMode must be 0
        11:     48 Mbps  //WirelessMode must be 0
        12:     54 Mbps  //WirelessMode must be 0
23. RTSThreshold=value
    value
        1 ~ 2312
24. FragThreshold=value
    value
        256 ~ 2312
25. PSMode=value
    value
    MAX_PSP   Power Saving Mode

26. AdhocOfdm=value
    value
    0:		Adhere WIFI spec, the Tx MAX rate will be 11Mbps in Adhoc mode
    1:		Violate WIFI spec, the Tx MAX rate will be 54Mbps in Adhoc mode

27. StaWithEtherBridge=value
    value
    0:		Disable sta with ethernet to wireless bridge
    1:		Enable sta with ethernet to wireless bridge

27. ApClient=value
    value
    0:		Disable ApClient mode
    1:		Enable ApClient mode


MORE INFORMATION
=================================================================================
If you want for rt2500 driver to auto-load at boot time:
A) choose ra0 for first RT2500 WLAN card, ra1 for second RT2500 WLAN card, etc.
   
B) create(edit) 'ifcfg-ra0' file in /etc/sysconfig/network-scripts/,      
   edit( or add the line) in /etc/modules.conf:
       alias ra0 rt2500        
   
C) edit(create) the file /etc/sysconfig/network-scripts/ifcfg-ra0  
   DEVICE='ra0'
   ONBOOT='yes'     


NOTE:
   if you use dhcp, add this line too .
    BOOTPROTO='dhcp'

*D) To ease the Default Gateway setting, 
    add the line
    GATEWAY=x.x.x.x   
    in /etc/sysconfig/network
   
INFORMATION FOR FEDORA CORE 3 USERS (USE AT YOUR OWN RISK !!!)
=================================================================================
While this information is directed to Fedora Core 3 users, there is no harm in
trying some hints and clues in other distros.

Before starting, make sure you don't have any ifcfg-ra* or ifcfg-eth* that has
information about Ralink wireless cards. Check also /etc/modprobe.conf for
additional 'alias' definitions.

If you have any of the files above and/or entries in modprob.conf, please delete
them now.

Compile the module as you would do normally with:

a) $make

and as root do:

b) $make install-fedora

the module should be installed to the correct location and the rt2500 alias as
been added to modprobe.conf .

Start 'system-config-network', 
New->Wireless connection, 
select 'RaLink Ralink RT2500 802.11 Cardbus Reference Card (wlan0)'
If it does not appear, well then it didn't work for you :)

But if it did appear then configure the rest of the parameters and activate
the card in the end.

Save configuration and enjoy your new wireless device.

Note : the device is now called wlanX instead raX. (X stands for autonumber)

     
