WARNING!

In Ubuntu 7.10 (Gutsy Gibbon) everything should work out of the box, using newer built-in driver, so the information posted below are not relevant to this version. There are many reports about WPA connections not working, though. This post describes how to make them work by going back to the legacy serialmonkey driver. The issue was reported in the bug #134962.

1. About the guide

This guide explains how to set up and configure a wireless network card based on the RT2500 chipset, which is manufactured by Ralink and incorporated in many wireless network cards.

You will need for this guide; your access point's ESSID (case-sensitive); the key (case-sensitive) used to access the access-point; the encryption used for the key.

2. Driver Information

If you are unsure whether your wireless card is based on the RT2500 chipset, visit this page for a list of cards based on the chipset.

Since Ubuntu 5.10 (Breezy Badger) the rt2500 driver is installed out of the box, so your wireless card should be visible as "ra0" if you open the Networking utility mode 2010 found under the System->Administration->Networking menu. If your wireless network uses no encryption, just click "Properties", enter your wireless access point's ESSID, and click OK. Once you click the "Activate" button, you should be connected to your wireless network service essays and Mobile Website Design Services. If your network requires WEP or WPA encryption, continue to the appropriate section. If you would like to have Ubuntu automatically connect to your wireless network when your computer starts up, follow these steps.

If you run an older version of Ubuntu, or the instruction on this page for setting up WPA or WEP encryptions don't work for you, then you may have to compile the driver and/or one of the RaConfig or RutilT utilities as described here. Have a look at Android Apps Design.

  • Driver Name: rt2500
  • Module Name: rt2500.ko

3. Support Channels

3.1. WEP info

If your wireless network is not protected by the WPA encryption method (i.e. if it's open or protected by the WEP encryption method) follow these steps:

1. Plug in your card.

2. Open System->Administration->Networking in the menu.

3. Click "Properties"

4. Enter your wireless access point's ESSID and WEP Key (if appropriate), and click OK.

5. Click the "Activate" button. You should now be connected to your wireless network!

In the future, all you'll need to do is click the Activate button to connect to the wireless network. If you would like to have Ubuntu automatically connect to your wireless network when your computer starts up, follow these steps:

1. Open a "Terminal" window.

2. Type:

gksudo gedit /etc/network/interfaces

3. In the text editor window that opened search for a stanza beginning with "iface ra0".

4. Add the following line to the beginning of the stanza:

auto ra0

5. Save the file and close the editor.

3.2. WPA info

If your wireless network uses the WPA encryption method, follow these steps:

1. Open a "Terminal" window.

2. Type:

gksudo gedit /etc/network/interfaces

3. In the text editor window that opened add the following stanza:

iface ra0 inet dhcp
        pre-up ip link set ra0 up
        pre-up ip link set ra0 down
        pre-up ip link set ra0 up
        pre-up ip link set ra0 down
        pre-up iwconfig ra0 essid "myssid"
        pre-up iwconfig ra0 mode Managed
        pre-up iwpriv ra0 set AuthMode=WPAPSK
        pre-up iwpriv ra0 set EncrypType=TKIP
        pre-up iwpriv ra0 set WPAPSK="A shared key"
        pre-up ip link set ra0 up

You should replace "myssid" with the SSID of your network, and "A shared key" with your network's WPA pre-shared key (in hex format, not ASCII plain text; use wpa_passphrase to generate the key if your AP software allows you to specify only plain text). If your network uses the AES encryption type, replace "TKIP" with "AES". If your network operates a mode other than Managed, replace "Managed" with the appropriate mode - but notice that some modes are not supported by the driver, or may not be fully functional.

If you wish Ubuntu to connect to the network on startup, add the following line to the beginning of the stanza:

auto ra0

If you want to use a static IP address rather than DHCP, you should replace the first line of the stanza above with something like

iface ra0 inet static
        address 192.168.1.45
        netmask 255.255.255.0
        gateway 192.168.1.1

(Use the address, netmask and gateway appropriate for your network's settings)

5. In the terminal window, type:

sudo ifup ra0

You should now be connected to your wireless network!

(i) If the above did not work for you, try one of the following stanzas instead (the same notes apply to these stanzas as well):

iface ra0 inet dhcp
        pre-up iwpriv ra0 auth 3
        pre-up iwpriv ra0 enc 3
        pre-up iwconfig ra0 essid myssid
        pre-up iwpriv ra0 wpapsk A shared key
        pre-up iwconfig ra0 essid myssid 

auto ra0
iface ra0 inet dhcp
pre-up iwconfig ra0 essid " myssid "
pre-up iwconfig ra0 mode managed
pre-up iwpriv ra0 set Channel=11
pre-up iwpriv ra0 set AuthMode=WPAPSK
pre-up iwpriv ra0 set EncrypType=TKIP
pre-up iwpriv ra0 set WPAPSK="A shared key"
pre-up iwpriv ra0 set TxRate=0

(i) If you need WPA support and the native method described here doesn't work, you may have to download and compile RaConfig or RutilT as described here. It's not necessary to compile the driver if that's already working out of the box.

4. Ubuntu Release Specific Info

4.1. Hoary 5.04

Ubuntu Hoary users should follow the compiling insturctions

4.2. Breezy 5.10 and Dapper 6.06

Users of the Breezy release or any newer one have the driver installed out of the box. If the above instructions for the configuration of the driver do not work for you, follow to the configuration application installation insructions. Or, if for some reason you wish to install a newer version of the driver follow the 'Compile Newer Driver' section. In both cases please note all of these specific instructions in addition:

1. Apart from the packages listed on the third step of the driver compilation instructions, you will also need to install gcc-3.4 instead of (or along with) the default gcc-4 using the following command:

sudo apt-get install gcc-3.4

Note if this doesn't work because it's complaining about

E: Couldn't find package gcc-3.4

then you need to add the main repository to your apt sources. The easiest way of doing this is:

  • by launching the System -> Administration -> Synaptic Package Management program,

  • clicking the Settings -> Repositories menu,

  • clicking Add, selecting the "Ubuntu 5.10 Breezy Badger" repository,
  • checking the "Community Maintained (Universe)" box
  • clicking OK and OK again.

Then you should quit the Synaptic program and try the install command again.

2. To the packages installed on the the first step of the Raconfig installatio add libqt3-mt-dev by typing at the terminal:

sudo apt-get install libqt3-mt-dev

3. Before finalizing the installation as described here, type this at the terminal:

sudo rm -r /lib/modules/`uname -r`/kernel/drivers/net/wireless/rt2500

4.3. Feisty 7.04

You will need to blacklist the SerialMonkey driver, add ndiswrapper to /etc/modules, and get the correct ndiswrapper setup, then make sure wpa_supplicant is installed. Then add this to you /etc/interfaces

""iface ra0 inet dhcp

wpa-driver wext

wpa-ssid your-ssid

wpa-ap-scan 1

wpa-proto RSN WPA

wpa-pairwise CCMP TKIP

wpa-group CCMP TKIP

wpa-key-mgmt WPA-PSK

wpa-psk your-wpa-psk""

Then disable the wireless card in NetworkManager and do a sudo ifup ra0.

4.4. Compile Newer Driver

This section describes how to download, compile and install the open source wireless drivers for RaLink Rt2500-based wi-fi cards.

<!>Note: This is only needed for users of Ubuntu 5.04. Ubuntu 5.10 and 6.06 have these drivers already installed. If your use one of the latter and wish to compile the driver anyway, note these release specific instructions

Please note you will need to have an active internet connection for these instructions to work, so you may need to hook up via ethernet temporarily.

4.4.1. Get Driver and RaConfig

1. Download RT2500 Beta or RT2500 CVS (the Beta Release is considered more stable, but for packet injection mode, which tools like Aircrack require, the CVS Version is necessary).

You can find the Rt2500 download page on http://rt2x00.serialmonkey.com/wiki/index.php/Downloads

  • For downloading the Beta Release follow the "Latest BETA rt2500 driver" download link.
  • For downloading the CVS Release follow the "rt2500 nightly CVS tarball" download link.

2. Open a Terminal window (found under the "System Tools" group, in the "Applications" menu). Most of the work will be done through the Terminal. Now go into the directory where you downloaded the driver and type:

tar -xzf <driver name>

to unpack it.

3. At the Terminal Type:

sudo apt-get install build-essential linux-headers-$(uname -r)

This will install necessary packages for the compilation, after typing your password.

4.4.2. Installing the Driver

The first step is to compile and install the driver:

1. Now type:

cd ./rt2500*/Module

This will bring you into the driver folder. If you extracted it somewhere else, adjust the address accordingly.

2. Type:

make

3. The module is now built. Before we install it, let's test it. Type:

sudo insmod rt2500.ko

4. Now, you can set up your device as described in the WEP and WAP sections according to your encryption needs. After you complete your configuration, continue to finalize the installation. If the above instructions for the configuration of the driver do not work for you, continue to the next section that will install Raconfig or RutilT.

4.4.3. Installing RaConfig/RutilT, and using it

You can chose to install the GUI application provided with the driver, Raconfig, or another GUI application for the driver instead called RutilT. The developers of the driver intend to replace Raconfig with this tool, and discontinue the development of the former. At this point RutilT is still under heavy development (RutilT v0.14, latest update 17-04-2007) and in comparison to RaConfig it has the following advantages/disadvantages:

  • It supports several Ralink chipsets and not only Rt2500 (they're going to implement all RaLink chipsets).

  • It's based on GTK, so Ubuntu users don't have to install kdebase.
  • The new Rt2X00 Driver is supported, which is a complete new driver and supports all RaLink chipsets (this driver is still very unstable).

  • Users are going to be able to run this tool as non-root user (not implemented yet).
  • It doesn't support WPA yet.

So choose accordingly: Install Raconfig or Install RutilT

4.4.4. Installing RaConfig

1. To install the utility, you'll need to download and install the kdebase and qt3 development packages. Type:

sudo apt-get install kdebase

note that if you're using Kubuntu, you need not install this package.

Also type:

sudo apt-get install qt3-dev-tools

If qt3-dev-tools fails to install, you might try libqt3-mt-dev.

2. Go here: http://rt2x00.serialmonkey.com/wiki/index.php/Downloads and download the driver package for your chipset. RaConfig is contained in these packages so even if you don't need new drivers you still need to download them. Use some program to extract the files. You may need to type this is a terminal to get root access to extract the files:

gksudo file-roller

Remember where it is that you extracted the files because you will need that information later. See Web 2.0 Design and Drupal Experts

2. Now change to the Utilitys folder in the directory that you extracted the rt2500 drivers to. What you need to type here may be different depending on where you saved the drivers. If you extracted the driver package into your /etc directory it may look something like this:

cd /etc/rt2500-1.1.0-b4/Utilitys

3. Now type:

sudo qmake -o Makefile raconfig2500.pro

4. Then type:

make

After typing make it appears that nothing happens. Don't worry, everything is still going according to plan.

5. Activate your wireless card if you haven't already. Under System -> Administration you will find networking. Your Ralink card will be listed there. Activate it.

6. Now we need that directory where you saved the drivers. It may look like /etc/rt2500-1.1.0-b4/Utilitys/RaConfig. This may be different if you saved it somewhere else. In the Terminal, type:

sudo cp <path to RaConfig2500 executable> /usr/local/bin

7. Launch RaConfig by typing in console:

RaConfig2500

8. The present wireless networks will be listed. Pick the one you want to connect to, click "Add Profile." Fill in the correct details for wireless security (WPA, WEP, etc) if you need to. Save the profile, click connect. Voila! You should have RaConfig set up correctly using your connection with WPA security enabled.

4.4.5. Installing RutilT

NOTE: Starting from gutsy, rutilt is now in the official Ubuntu repositories.

1. First we're going to download the tool. Visit the tool's homepage at http://cbbk.free.fr/bonrom/ and download the newest version.

2. Now to solve the dependencies:

sudo apt-get install libgtk2.0-dev

and, if you haven't already done this before,

sudo apt-get install build-essential linux-headers-$(uname -r)

3. We need to unpack the archive you downloaded, so open a console and go into the directory where you downloaded the archive. Type

tar -xzf <archive name>

4. After unpacking the archive we will open the new folder:

cd <path to folder>

5. Now, we're going to compile the application:

./configure.sh
make

If you want to compile it with packet injection mode type:

make SUPPORT=RFMONTX

instead. (note: If you want to compile it with packet injection mode, you must use the CVS driver version, otherwise RuTilt won't work)

6. In order to install the executable in /usr/bin type:

sudo make install

7. Under System -> Administration you will find networking. Your Ralink card will be listed there. Activate it.

8. You can now run the RutilT by typing "rutilt" in console.

4.4.6. Finalizing the Install

1. First, disconnect - click Deactivate in the Networking window, or use the Terminal:

sudo ifdown ra0

3. Type:

sudo cp ~/rt2500-cvs-daily/Module/rt2500.ko /lib/modules/`uname -r`/kernel/drivers/net/wireless/

4. Type:

echo "alias ra0 rt2500" | sudo tee /etc/modprobe.d/rt2500

5. Type:

sudo depmod

6. That's it! The driver's installed! You can now erase the unpacked rt2500 folder and the archive itself.

4.5. Specific Release Notes


CategoryNetworking

WifiDocs/Driver/RalinkRT2500 (last edited 2011-06-22 13:11:09 by jengelh)