drivers/net/wireless/rtlink.org/README

   1 * README\r
   2 *\r
   3 * Ralink Tech Inc.\r
   4 * \r
   5 * http://www.ralinktech.com\r
   6 *\r
   7 \r
   8 =======================================================================\r
   9 ModelName:\r
  10 ===========\r
  11 RT2500 b/g \r
  12 \r
  13 \r
  14 =======================================================================\r
  15 Description:\r
  16 =============\r
  17 This is a linux device driver for Ralink RT2500 b/g WLAN Card.\r
  18 \r
  19 \r
  20 =======================================================================\r
  21 Supporting Kernel:\r
  22 ===================\r
  23 linux kernel 2.4 and 2.6 series. \r
  24 Tested in Redhat 7.3 or later, Fedora Core 1, Suse 8.0,8.1,9.0, \r
  25 Mandrake 9.0->10.0, Slackware 9.0,9.1, LinEX-r1, gnuLinEX2004\r
  26 \r
  27 \r
  28 =======================================================================\r
  29 Contents:\r
  30 =============\r
  31 ./2.4.x  : Makefile for kernel 2.4 series\r
  32 ./2.6.x  : Makefile for kernel 2.6 series\r
  33 ./suse   : boot script for suse\r
  34 *.c     : c files\r
  35 *.h     : header files\r
  36 \r
  37 \r
  38 =======================================================================\r
  39 Build Instructions:  \r
  40 ====================\r
  41 For 2.4 series kernel:\r
  42 1) $tar -xvzf RT2500-Linux-STA-x.x.x.x.tar.gz\r
  43     go to "./RT2500-Linux-STA-x.x.x.x/Module" directory.  \r
  44 2) cp ./2.4.x/Makefile .  \r
  45 3) Use 'chmod' command to change access right of following script files :\r
  46    'load', 'unload', 'Configure' \r
  47 4) $make config         # config build linux os version\r
  48 5) $make all            # compile driver source code\r
  49 6) $load                # load/insmod module(rt2500.o)\r
  50 7) make install         #\r
  51 Note: Script functionality:\r
  52 load            load module to kernel\r
  53 unload          unload module from kernel\r
  54 Configure       retrive linux version \r
  55 \r
  56 \r
  57 For 2.6 series kernel:\r
  58 1) cp ./2.6.x/Makefile \r
  59 2)  $make -C /path/to/source SUBDIRS=$PWD modules\r
  60     Where /path/to/source is the path to the source directory for the (configured and built) target kernel.\r
  61 3)  run '/sbin/insmod rt2500.ko'  (as root)\r
  62         '/sbin/ifconfig ra0 inet YOUR_IP up' \r
  63 4) uncomment the line include ./config.mk in Makefile\r
  64 5) make install\r
  65 \r
  66 =======================================================================\r
  67 Features:\r
  68 ==========\r
  69    This driver implements basic IEEE802.11. Infrastructure and adhoc mode with open or shared or WPA\r
  70    authentication method. WEP-40 and WEP-104, TKIP and AES encryption, \r
  71    \r
  72    \r
  73 =======================================================================\r
  74 To BUILD UTILITY\r
  75 ====================\r
  76 \r
  77 1)  go to the "./Utility" directory\r
  78 2)  run 'qmake -o Makefile raconfig2500.pro'\r
  79     If qmake command is not found in your system, you can download the QT tool \r
  80     'qt-x11-free-3.2.1' or later at \r
  81     http://www.trolltech.com/\r
  82     \r
  83     (qmake comes with RedHat 7.3 or later QT Package)    \r
  84 \r
  85 3)  run 'make" to compile the utility source code.   \r
  86 4)  After all, an execution file would be generated "RaConfig2500"\r
  87     run "RaConfig2500" to config the driver as you want\r
  88 \r
  89 \r
  90 =======================================================================\r
  91 CONFIGURATION:  \r
  92 ====================\r
  93 RT2500 driver can be configured via following interfaces, \r
  94 i.e. 1)partial wireless extension command, 2)"iwpriv" command, 3) RaConfig2500\r
  95 \r
  96 1)  iwconfig, and iwlist scanning.  \r
  97 2) iwpriv usage, please refer to file "iwpriv_usage.txt" for details.\r
  98 3) RT2500 provides API : RaConfig2500, please go to directory ./Utility and refer to how-to-compile.txt\r
  99 \r
 100            \r
 101 =======================================================================\r
 102 MORE INFORMATION:  \r
 103 ====================\r
 104 1) Though we allow a configuratino file for ra0 when initializing our modules,\r
 105 reading a file when installing a modules in linux is not recommended. \r
 106 If you want to enable this function, umcomment the line " RTMPReadParametersFromFile(pAd);" \r
 107 in rtmp_main.c\r
 108 \r
 109 NOTE:\r
 110    if you use dhcp, add this line in boot script according to your linux distribution.\r
 111     BOOTPROTO='dhcp'\r
 112     To ease the Default Gateway setting, add the line\r
 113     GATEWAY=x.x.x.x   \r
 114     \r
 115    \r
 116      \r