Differences between revisions 9 and 10
⇤ ← Revision 9 as of 2009-01-10 08:02:00 →
Size: 2684
Editor: GeoffSimmons
Comment: Correct driver inaccuracy.
← Revision 10 as of 2009-01-13 06:56:57 → ⇥
Size: 5571
Editor: GeoffSimmons
Comment: Rewrite. Remove rt2500-specific iwpriv (WEP deprecated, WPA -> wpasupplicant).
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
||<tablewidth="100%"style="border: 0px hidden ;">~-Translations: [:WiFi/rt2500:English], [:DebFrWiFi/rt2500:Français]-~ ||<style="border: 0px hidden ; text-align: right;"> (!) ["/Discussion"] || ||<tablestyle="width: 100%;" style="border: 0px hidden">~-[:DebianWiki/EditorGuide#translation:Translation(s)]: [:WiFi/rt2500:English], [:DebFrWiFi/rt2500:Français]-~||<style="text-align: right;border: 0px hidden"> (!) [:/Discussion:Discussion]||
Line 4: Line 4:
 . The module "rt2500" is a driver for RaLink RT2500 wireless adapter, it is provided by the package DebPkg:rt2500-source (An alternate driver, rt2500pci, is available in the rt2x00-source package and in the Linux kernel from version DebPkg:linux-image-2.6.24).
= Installation =
You can build the module using DebPkg:module-assistant :		 = Ralink RT2500/RT2560 devices =
This page describes how to enable support for !WiFi devices based on the Ralink RT2500 (non-USB) chipset on Debian systems.
Line 8: Line 7:
 * Open a terminal as ''root''
 * Add the [:Synaptic#repository:non-free] component
 * Then run
 {{{
apt-get install module-assistant
module-assistant prepare
module-assistant update
module-assistant a-i rt2500		 [[TableOfContents(4)]]

== Drivers ==
The Ralink RT2500 802.11g wireless LAN chipset is supported by three native drivers:
 * [http://www.ralinktech.com/ralink/Home/Support/Linux.html rt2500] (Legacy driver)
  * Released by Ralink under the GPL.
  * Not generally recommended for use.
 * [#rt2500 rt2500] (Enhanced legacy driver)
  * Source provided by the DebPkg:rt2500-source package.
 * [#rt2500pci rt2500pci] (Next-generation driver)
  * The recommended driver to use.
  * Included in the mainline kernel starting from 2.6.24.
  * Source previously packaged in DebPkg:rt2x00-source, removed from Debian to resolve bug Bug:474189.

Both the enhanced legacy and next-generation drivers are maintained by the [http://rt2x00.serialmonkey.com/ rt2x00 project]. [#supported-devices Supported devices] are listed at the end of this page.

All drivers do not require firmware to be installed.

== Installation ==

[[Anchor(rt2500pci)]]
=== rt2500pci (next-generation driver) ===
The rt2500pci driver is included the mainline kernel since 2.6.24. It is included as a module in Debian kernel images.

==== Etch with 2.6.18 kernel ====
Using Lenny? [#rt2500pci-lenny Skip to the Lenny section].

<!> Although an DebPkg:etch/rt2x00-source package is available, this version is considered experimental and only supports a small number of devices. The devices which are supported are likely to encounter issues.

It is ''highly recommended'' to use an ["EtchAndAHalf"] kernel image, which will provide your system with an updated rt2500pci driver included as part of the kernel. You will not need to use DebPkg:etch/rt2x00-source.

Install an ["EtchAndAHalf"] kernel image ({{{apt-cache search linux-image-2.6.24-etchnhalf}}} and install a package appropriate for your system), restart your system to boot using this kernel, then follow the [#rt2500pci-etch2624 Etch with 2.6.24 kernel] procedure below.

[[Anchor(rt2500pci-etch2624)]]
==== Etch with 2.6.24 kernel ====
As drivers from the rt2x00 project are included in the mainline kernel, the rt2500pci driver is present on your system.

 . <!> The rt2500pci driver is not present in the stock 2.6.18 kernel.
 . Install an [:EtchAndAHalf:] kernel: {{{apt-cache search linux-image-2.6.24-etchnhalf}}} and install a package appropriate for your system.
 . Restart your system with this kernel before continuing.
##
 1. Install the DebPkg:etch/wireless-tools package: {{{
aptitude update
aptitude install wireless-tools
Line 17: Line 52:
= Test and Use =
Once the package is installed, you can check that the module loads properly

 . {{{
modprobe rt2500
lsmod | grep rt2500		  1. The necessary kernel module should be [:Modules:automatically loaded]. If necessary, it can be manually loaded via: {{{
modprobe rt2500pci
}}}
 1. Verify your device has an available interface: {{{
Line 25: Line 58:
 1. Raise the interface to activate the radio, for example: {{{
ifconfig wlan0 up
}}}
 1. [:WiFi/HowToUse:Configure] your wireless interface as appropriate.
Line 26: Line 63:
= Configuration =
The rt2500 driver includes private parameters that allows you to connect to an access point from the shell, without using a network manager. You need the DebPkg:wireless-tools package, and DebPkg:dhcp3-client if you need [:DHCP Client:DHCP]. You can check the full documentation in [file:///usr/share/doc/rt2500-source/README.gz]. Here are some examples, where <WlanX> is your card interface (you need to be ''root'' to use them) :		 [[Anchor(rt2500pci-lenny)]]
==== Lenny ====
As drivers from the rt2x00 project are included in the mainline kernel, the rt2500pci driver is present on your system.
Line 29: Line 67:
 . '''WEP with DHCP'''
 .{{{
iwpriv <wlanX> set AuthMode=AUTO
iwpriv <wlanX> set EncrypType=WEP
iwconfig <wlanX> essid <AP SSID> mode Managed key <WEPKEY>
dhclient <wlanX>}}}		  1. Install the DebPkg:wireless-tools package: {{{
aptitude update
aptitude install wireless-tools
}}}
 1. The necessary kernel module should be [:Modules:automatically loaded]. If necessary, it can be manually loaded via: {{{
modprobe rt2500pci
}}}
 1. Verify your device has an available interface: {{{
iwconfig
}}}
 1. Raise the interface to activate the radio, for example: {{{
ifconfig wlan0 up
}}}
 1. [:WiFi/HowToUse:Configure] your wireless interface as appropriate.
Line 36: Line 82:
 . '''WEP with a fixed IP address'''
 .{{{
iwpriv <wlanX> set AuthMode=AUTO
iwpriv <wlanX> set EncrypType=WEP
iwconfig <wlanX> essid <AP SSID> mode Managed key <WEPKEY>
ifconfig <wlanX> <YOUR IP> netmask <NETMASK>
route add -net default gw <GATEWAY> <wlanX>
echo "nameserver <DNS SERVER>" > /etc/resolv.conf		 [[Anchor(rt2500)]]
=== rt2500 (enhanced legacy driver) ===

While use of the [#rt2500pci next-generation driver] is preferred, the enhanced legacy driver can alternatively be used. This is required to be compiled and installed, which can be automated via [:ModuleAssistant:module-assistant].

 1. Install the DebPkg:module-assistant and DebPkg:wireless-tools packages: {{{
aptitude update
aptitude install module-assistant wireless-tools
Line 45: Line 91:
 1. Build and install an rt2500-modules-* package within your system: {{{
m-a prepare
m-a a-i rt2500
}}}
 1. Load the rt2500 module: {{{
modprobe rt2500
}}}
 This module will be automatically loaded when your system is restarted.
Line 46: Line 100:
 . '''WPA-PSK with a fixed IP address'''
 .{{{
iwconfig <wlanX> essid <AP SSID> mode Managed
iwpriv <wlanX> set AuthMode=WPAPSK
iwpriv <wlanX> set EncrypType=TKIP
iwpriv <wlanX> set WPAPSK=<WPA KEY>
ifconfig <wlanX> <YOUR IP> netmask <NETMASK>
route add -net default gw <GATEWAY> eth1
echo "nameserver <DNS SERVER>" > /etc/resolv.conf		  1. Verify your device has an available interface: {{{
iwconfig
Line 56: Line 103:
 1. Raise the interface to activate the radio, for example: {{{
ifconfig eth1 up
}}}
 1. [:WiFi/HowToUse:Configure] your wireless interface as appropriate.
Line 57: Line 108:
[[Anchor(supported-devices)]]
Line 61: Line 113:
The following list is based on the ''alias'' fields of  {{{ modinfo rt2500pci}}}. The following list is based on the ''alias'' fields of {{{ modinfo rt2500pci}}}.
Line 65: Line 117:
}}} }}} -~
Line 67: Line 119:
= Error message = == See Also ==
 * [:WiFi/HowToUse:How To use Wifi network adapter]

== External Links ==
 * [http://rt2x00.serialmonkey.com/] - enhanced legacy and next-generation driver homepage

----
CategoryHardware

[:DebianWiki/EditorGuide#translation:Translation(s)]: [:WiFi/rt2500:English], [:DebFrWiFi/rt2500:Français]

(!) [:/Discussion:Discussion]

Ralink RT2500/RT2560 devices

This page describes how to enable support for WiFi devices based on the Ralink RT2500 (non-USB) chipset on Debian systems.

?TableOfContents(4)

Drivers

The Ralink RT2500 802.11g wireless LAN chipset is supported by three native drivers:

  • [http://www.ralinktech.com/ralink/Home/Support/Linux.html rt2500] (Legacy driver)

    • Released by Ralink under the GPL.
    • Not generally recommended for use.
  • [#rt2500 rt2500] (Enhanced legacy driver)
  • [#rt2500pci rt2500pci] (Next-generation driver)
    • The recommended driver to use.
    • Included in the mainline kernel starting from 2.6.24.

    • Source previously packaged in rt2x00-source, removed from Debian to resolve bug 474189.

Both the enhanced legacy and next-generation drivers are maintained by the [http://rt2x00.serialmonkey.com/ rt2x00 project]. [#supported-devices Supported devices] are listed at the end of this page.

All drivers do not require firmware to be installed.

Installation

?Anchor(rt2500pci)

rt2500pci (next-generation driver)

The rt2500pci driver is included the mainline kernel since 2.6.24. It is included as a module in Debian kernel images.

Etch with 2.6.18 kernel

Using Lenny? [#rt2500pci-lenny Skip to the Lenny section].

<!> Although an etch/rt2x00-source package is available, this version is considered experimental and only supports a small number of devices. The devices which are supported are likely to encounter issues.

It is highly recommended to use an ["EtchAndAHalf"] kernel image, which will provide your system with an updated rt2500pci driver included as part of the kernel. You will not need to use etch/rt2x00-source.

Install an ["EtchAndAHalf"] kernel image (apt-cache search linux-image-2.6.24-etchnhalf and install a package appropriate for your system), restart your system to boot using this kernel, then follow the [#rt2500pci-etch2624 Etch with 2.6.24 kernel] procedure below.

?Anchor(rt2500pci-etch2624)

Etch with 2.6.24 kernel

As drivers from the rt2x00 project are included in the mainline kernel, the rt2500pci driver is present on your system.

  • <!> The rt2500pci driver is not present in the stock 2.6.18 kernel.

  • Install an [:EtchAndAHalf:] kernel: apt-cache search linux-image-2.6.24-etchnhalf and install a package appropriate for your system.

  • Restart your system with this kernel before continuing.

  1. Install the etch/wireless-tools package: 

    aptitude update
aptitude install wireless-tools

  2. The necessary kernel module should be [:Modules:automatically loaded]. If necessary, it can be manually loaded via: 

    modprobe rt2500pci

  3. Verify your device has an available interface: 

    iwconfig

  4. Raise the interface to activate the radio, for example: 

    ifconfig wlan0 up

  5. [:WiFi/HowToUse:Configure] your wireless interface as appropriate.

?Anchor(rt2500pci-lenny)

Lenny

As drivers from the rt2x00 project are included in the mainline kernel, the rt2500pci driver is present on your system.

  1. Install the wireless-tools package: 

    aptitude update
aptitude install wireless-tools

  2. The necessary kernel module should be [:Modules:automatically loaded]. If necessary, it can be manually loaded via: 

    modprobe rt2500pci

  3. Verify your device has an available interface: 

    iwconfig

  4. Raise the interface to activate the radio, for example: 

    ifconfig wlan0 up

  5. [:WiFi/HowToUse:Configure] your wireless interface as appropriate.

?Anchor(rt2500)

rt2500 (enhanced legacy driver)

While use of the [#rt2500pci next-generation driver] is preferred, the enhanced legacy driver can alternatively be used. This is required to be compiled and installed, which can be automated via [:ModuleAssistant:module-assistant].

  1. Install the module-assistant and wireless-tools packages: 

    aptitude update
aptitude install module-assistant wireless-tools

  2. Build and install an rt2500-modules-* package within your system: 

    m-a prepare
m-a a-i rt2500

  3. Load the rt2500 module: 

    modprobe rt2500
    This module will be automatically loaded when your system is restarted.

  4. Verify your device has an available interface: 

    iwconfig

  5. Raise the interface to activate the radio, for example: 

    ifconfig eth1 up

  6. [:WiFi/HowToUse:Configure] your wireless interface as appropriate.

?Anchor(supported-devices)

Supported Devices

The page ["HowToIdentifyADevice/PCI"] explains how to identify a PCI device.

The following list is based on the alias fields of  modinfo rt2500pci. 

  • PCI: 1814:0201 RaLink RT2500 802.11g Cardbus/mini-PCI

See Also

CategoryHardware