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 syntax descriptions below 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".
#
# 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
Key1=0123456789
Key2=
Key3=
Key4=
WPANONE=abcdefghijklmnopqrstuvwxyz
WPAPSK=abcdefghijklmnopqrstuvwxyz
TXBurst=0
TurboRate=0
BGProtection=0
ShortSlot=0
TxPreamble=2
TxRate=0
RTSThreshold=2312
FragThreshold=2312
PSMode=CAM
-----------------------------------------------
syntax is 'Param'='Value' and described 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.  Key1=value
    value
        10 or 26 hexadecimal characters eg: 012345678
        5 or 13 ascii characters eg: passd
10. Key2=value
    value
        10 or 26 hexadecimal characters eg: 012345678
        5 or 13 ascii characters eg: passd
11. Key3=value
    value
        10 or 26 hexadecimal characters eg: 012345678
        5 or 13 ascii characters eg: passd
12. Key4=value
    value
        10 or 26 hexadecimal characters eg: 012345678
        5 or 13 ascii characters eg: passd
13. WPANONE=value - use for adhoc mode
    value
        8 ~ 63 characters
          or
        64 hexadecimal characters
13. WPAPSK=value - use for infrastructure mode
    value
        8 ~ 63 characters
          or
        64 hexadecimal characters
14. TxBurst=value
    value
        0:        Disable
        1:        Enable
15. TurboRate=value
    value
        0:        Disable
        1:        Enable
16. BGProtection=value
   value
        0:        Auto
        1:        Always On
        2:        Always Off
17. ShortSlot=value
    value
        0:        Disable
        1:        Enable
18. TxPreamble=value
    value
         0:     Long
         1:     Short
         2:     Auto
19. 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
20. RTSThreshold=value
    value
        1 ~ 2312
21. FragThreshold=value
    value
        256 ~ 2312
22. PSMode=value
    value
    MAX_PSP   Power Saving Mode

23. AdhocOfdm=value
    value
    0:		Tx MAX rate will be 11Mbps in Adhoc mode.
    1:		Tx MAX rate will be 54Mbps in Adhoc mode.

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


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 modprobe.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 added to modprobe.conf (2.6 kernels) or modules.conf
(2.4 kernels).

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.
