|
Size: 10546
Comment: rt2x00-source was removed to resolve Debian bug #474189; spaces are important
|
Size: 8957
Comment: Major rewrite.
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 2: | Line 2: |
| = RT73 / RT2x00 Driver = The rt2x00 drivers is maintained by http://rt2x00.serialmonkey.com/. An incomplete list of [#supported-devices Supported Devices] is listed at the bottom of this page. '''Note: If you are using Debian testing (Lenny), follow the [#procedure procedure] at the bottom of this page to set up your rt73 wireless device.''' == Installation (using module-assistant) == We will use DebPkg:module-assistant to build the package DebPkg:etch/rt2x00-source (or DebPkg:rt73-source). ||'''The package description is :''' RT2x00 wireless network drivers source [[BR]] This package provides the source code of the Linux drivers for wireless network cards using the Ralink RT2x00 chips. It is a complete rewrite of the RT2400/RT2500/RT2570 drivers, it uses the standard iw* configuration tools, and it aims to be integrated in the kernel tree.[[BR]]In order to compile the kernel modules you need the kernel sources (or the kernel-headers for the kernel-image packages from Debian). For compile instructions look into [http://sysinf0.klabs.be/usr/share/doc/rt2x00-source/README.Debian?f=view;dist=etch;component=main;arch=i386;pkg=rt2x00-source;ver=0cvs20060928-1 /usr/share/doc/rt2x00-source/README.Debian] or simply use the module-assistant utility. [[BR]] WARNING: This driver is still experimental, it only works for a few cards. You will need a 2.6.17 or later kernel to use it. || * Open a terminal as ''root'' * Add the {{{contrib}}} and [:Synaptic#repository:non-free] component * Then run {{{ apt-get install module-assistant module-assistant prepare module-assistant update module-assistant build rt2x00 }}} You can the copy the package you just build, named /usr/src/rt2x00-modules-2.6.18****.deb, to the target computer, then install it with : . {{{ dpkg -i /tmp/path/to/rt2x00-modules-2.6.18*deb }}} == Manual compilation from CVS == . <!> This procedure is not recommended ## WE SHOULD DELETE THIS SECTION ! IMHO, FrnaklinPiat === Setting up for off-line install === If you have a current internet access skip to the internet install section. First thing you are going to need to do is download the RT73 driver on another computer and put it on a flash drive (or some other medium) to transfer it to your Debian machine. You can download the cvs at {{{ http://rt2x00.serialmonkey.com/rt73-cvs-daily.tar.gz}}} After you get into Debian you need to copy it to /lib/firmware then unzip it. *Make sure you have root access {{{ cp /path/to/rt73-cvs-daily.tar.gz /lib/firmware cd /lib/firmware tar -xvzf rt73-cvs-daily.tar.gz }}} If you don't have gcc installed you need to make sure you have the cdrom in your sources and do {{{ aptitude install gcc }}} You can now skip past the internet part === If you have internet access === If you have internet access you can download it directly from Debian using wget {{{ wget http://rt2x00.serialmonkey.com/rt73-cvs-daily.tar.gz -O /usr/src/rt73-cvs-daily.tar.gz cd /lib/firmware tar -xvzf rt73-cvs-daily.tar.gz }}} Check if you have gcc installed {{{ gcc --version }}} If you don't get a version you need to install it {{{ aptitude install gcc }}} === Install needed dependencies === You need to install needed dependencies before you can build the driver {{{ aptitude install build-essential linux-headers-`uname -r` }}} === Build === Next you need to cd to the Module directory in the files you extracted {{{ cd /usr/src/rt73-cvs-yyyymmddhh/Module }}} If you are unsure what the yyymmddhh is then use {{{ ls -d rt73* }}} This should tell you the correct directory. After you are in the Module directory you need to us {{{ make }}} In some kernels you may get the following warning {{{ !!! WARNING: Module file much too big (>1MB) !!! Check your kernel settings or use 'strip' }}} In that case run the command {{{ strip -S rt73.ko }}} Finally you can install the driver {{{ make install }}} === configuring the driver === You will need to make sure that you have any network manager disabled. You will then need to manually configure your internet {{{ #Load Driver ifconfig wlan0 down modprobe -v rt73 #Configure internet ifconfig wlan0 up iwconfig wlan0 essid YOUR_NETWORK_NAME_HERE iwconfig wlan0 key YOUR_WEP_KEY_HERE_OR_"off"_FOR_NO_KEY dhclient wlan0 }}} You should now be able to connect to the internet. If you are unable to connect to the internet please go back and make sure you followed all the steps correctly. === Setting up auto connect during boot === You need to edit the network/interfaces file to connect to the internet on boot. {{{ gksu gedit /etc/network/interfaces (if you are using Ubuntu) kdesu kate /etc/network/interfaces (if you are using Kubuntu) }}} Inside you need to add the following {{{ auto wlan0 iface wlan0 inet dhcp pre-up ifconfig wlan0 up pre-up iwconfig wlan0 essid YOUR_ESSID pre-up iwconfig wlan0 key WEP_KEY_OR_"OFF"_IF_YOU_HAVE_NONE }}} If you have WPA you need to use the following instead {{{ auto wlan0 iface wlan0 inet dhcp pre-up ifconfig wlan0 up pre-up iwpriv wlan0 set AuthMode=WPAPSK pre-up iwpriv wlan0 set EncrypType=TKIP pre-up iwpriv wlan0 set WPAPSK="YOUR_WPA_PSK_KEY" pre-up iwpriv wlan0 set SSID="YOUR_SSID" pre-up iwpriv wlan0 set NetworkType=Infra }}} If you have WPA2 you need to use the following instead {{{ auto wlan0 iface wlan0 inet dhcp pre-up ifconfig wlan0 up pre-up iwpriv wlan0 set AuthMode=WPA2PSK pre-up iwpriv wlan0 set EncrypType=TKIP pre-up iwpriv wlan0 set WPAPSK="YOUR_WPA2_PSK_KEY" pre-up iwpriv wlan0 set SSID="YOUR_SSID" pre-up iwpriv wlan0 set NetworkType=Infra}}} If you have a static ip address, then you should try the following {{{ auto wlan0 iface wlan0 inet static address STATIC_IP_ADDRESS netmask 255.255.255.0 network ROUTER_IP gateway ROUTER_IP pre-up ifconfig wlan0 up pre-up iwconfig wlan0 essid YOUR_ESSID pre-up iwconfig wlan0 mode Managed ## add any additional WPA information, etc if needed }}} === Rebuilding for new kernel === If you upgrade kernels you will need to re-build the driver. To do so you can do the following below {{{ cd /usr/src/rt73-cvs-yyyymmddhh/Module make clean make ifdown wlan0 modprobe -rv rt73 make install modprobe -v rt73 ifup wlan0 }}} |
= RT73 wireless devices = This page describes how to enable support for WiFi devices based on the Ralink RT73 chipset on Debian systems. [[TableOfContents(4)]] == Drivers == The Ralink RT73 (RT2571W) USB wireless LAN chipset is supported by three native drivers: * [http://www.ralinktech.com/ralink/Home/Support/Linux.html rt73] (Legacy driver) * Released by Ralink under the GPL. * Not generally recommended for use. * [#rt73 rt73] (Enhanced legacy driver) * Source provided by the DebPkg:rt73-source package. * [#rt73usb rt73usb] (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]. An incomplete list of [#supported-devices supported devices] is listed at the end of this page. All drivers '''require non-free firmware''' for their operation. This can be provided by the DebPkg:firmware-ralink package. == Installation == [[Anchor(rt73usb)]] === rt73usb (next-generation driver) === [[Anchor(rt73usb-etch2.6.18)]] ==== Etch with 2.6.18 kernel ==== <!> 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 rt73usb 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 [#rt73usb-etch2.6.24 Etch with 2.6.24 kernel] procedure below. [[Anchor(rt73usb-etch2.6.24)]] ==== Etch with 2.6.24 kernel ==== As the drivers from the rt2x00 project are included in the mainline kernel, the rt73usb driver is present on your system. Firmware is required to be installed prior to driver operation: 1. Install the DebPkg:etch/wireless-tools package: {{{ aptitude update aptitude install wireless-tools }}} 2. Add a section for [:Backports:Debian Backports] to {{{/etc/apt/sources.list}}}, which must also include "non-free". For example: {{{ # Backported packages for Debian Etch deb http://www.backports.org/debian etch-backports main contrib non-free }}} 3. Install the DebPkg:etch-backports/debian-backports-keyring package: {{{ aptitude update aptitude -t etch-backports install debian-backports-keyring }}} As your system does not yet have the GnuPG archive key of the backports.org repository installed, you will be asked to confirm installation of a package from an untrusted repository. Enter {{{Yes}}} when prompted. 4. Install the DebPkg:etch-backports/firmware-ralink package: {{{ aptitude -t etch-backports install firmware-ralink }}} 5. The necessary kernel module should be [:Modules:automatically loaded]. If necessary, it can be manually loaded via: {{{ modprobe rt73usb }}} If not already performed, connect the device to your system. 6. Verify your device has an available interface: {{{ iwconfig }}} 7. Raise the interface to activate the radio, for example: {{{ ifconfig wlan0 up }}} 8. [:WiFi/HowToUse:Configure] your wireless interface as appropriate. [[Anchor(rt73usb-lenny)]] ==== Lenny ==== As the drivers from the rt2x00 project are included in the mainline kernel, the rt73usb driver is present on your system. Firmware is required to be installed prior to driver operation: 1. Add a "non-free" section to {{{/etc/apt/sources.list}}}, for example: {{{ # Debian Lenny deb http://ftp.us.debian.org/debian lenny main contrib non-free }}} 2. Install the DebPkg:firmware-ralink and DebPkg:wireless-tools packages: {{{ aptitude install firmware-ralink wireless-tools }}} 3. The necessary kernel module should be [:Modules:automatically loaded]. If necessary, it can be manually loaded via: {{{ modprobe rt73usb }}} If not already performed, connect the device to your system. 4. Verify your device has an available interface: {{{ iwconfig }}} 5. Raise the interface to activate the radio, for example: {{{ ifconfig wlan0 up }}} 6. [:WiFi/HowToUse:Configure] your wireless interface as appropriate. [[Anchor(rt73)]] === rt73 (enhanced legacy driver) === ==== Etch ==== You are required to acquire and compile the rt2x00 sources, as these are not packaged. This procedure is documented at the rt2x00 project's website: http://rt2x00.serialmonkey.com/wiki/index.php?title=Rt2x00_GIT_instructions ==== Lenny ==== While use of the [#rt73usb-lenny next-generation driver] is preferred, the enhanced legacy driver can alternatively be used. This is available as a pre-built module package made against a Debian stock kernel, but can also be generated on your system via [:ModuleAssistant: module-assistant]. ===== Pre-Built Module ===== 1. Add "contrib" and "non-free" sections to {{{/etc/apt/sources.list}}}. For example: {{{ # Debian Lenny deb http://ftp.us.debian.org/debian lenny main contrib non-free }}} 2. Install the DebPkg:firmware-ralink, DebPkg:rt73-common, the relevant enhanced legacy module and DebPkg:wireless-tools packages: {{{ aptitude install firmware-ralink rt73-common rt73-modules-$(uname -r) wireless-tools }}} 3. Load the enhanced legacy driver: {{{ modprobe rt73 }}} This module will be automatically loaded when your system is restarted and the device is inserted. If not already performed, connect the device to your system. 4. Verify your device has an available interface: {{{ iwconfig }}} 5. Raise the interface to activate the radio, for example: {{{ ifconfig wlan0 up }}} 6. [:WiFi/HowToUse:Configure] your wireless interface as appropriate. ===== Module Assistant ===== 1. Add "contrib" and "non-free" sections to {{{/etc/apt/sources.list}}}. For example: {{{ # Debian Lenny deb http://ftp.us.debian.org/debian lenny main contrib non-free }}} 2. Install the DebPkg:firmware-ralink, DebPkg:module-assistant, DebPkg:rt73-common and DebPkg:wireless-tools packages: {{{ aptitude install firmware-ralink module-assistant rt73-common wireless-tools }}} 3. Build and install a rt73-modules-* package within your system: {{{ m-a prepare m-a a-i rt73 }}} 4. Load the enhanced legacy driver: {{{ modprobe rt73 }}} This module will be automatically loaded when your system is restarted and the device is inserted. If not already performed, connect the device to your system. 5. Verify your device has an available interface: {{{ iwconfig }}} 6. Raise the interface to activate the radio, for example: {{{ ifconfig wlan0 up }}} 7. [:WiFi/HowToUse:Configure] your wireless interface as appropriate. |
| Line 190: | Line 176: |
=== Supported devices === If you are using the kernel 2.6.x or later, chances are that the following hardware (but not limited to) will work using the open source RT73 driver. * Asus WL-167g * Sitecom WL113 v1-002 * GW-US54HP |
== Supported devices == <!> The following list is incomplete. * Asus WL-167g v2 * Belkin F5D7050 Ver 3 |
| Line 199: | Line 182: |
| * Belkin F5D7050 Ver 3 | |
| Line 201: | Line 183: |
| * GW-US54HP | |
| Line 203: | Line 186: |
| Again the driver is not limited to just these NICs. | * Sitecom WL113 v1-002 |
| Line 254: | Line 237: |
| [[Anchor(procedure)]] == Setting up rt73 on Debian testing == If you are using Debian testing (lenny), you may have encountered the following error when booting the machine after initial installation of the OS: "rt2x00...Failed to Request Firmware" To correctly install and configure your rt73 device, you may follow the procedure below: First make sure you have the "contrib" component in your /etc/apt/sources.list. If not, add it and run "aptitude update". In a root terminal: {{{ aptitude install rt73-common rt73-modules-2.6.24-1-amd64 rt73-modules-2.6-amd64 }}} Note that I am running the kernel version 2.6.24 on amd64. Replace the kernel versions above with what you are currently running. And then: {{{ update-rt73-firmware }}} This will download the rt73 firmware automatically from the Realtek website. Reboot your machine. After rebooting, the "rt2x00...Failed to Request Firmware" error should disappear. Then: {{{ aptitude install wireless-tools rutilt }}} Note: Rutilt is a program designed to manage rt2x00 and other wireless devices. At this point, if you try to bring up the interface (wlan0), {{{ ifconfig wlan0 up }}} you may encounter an error about "invalid arguments". This is due to a bug. A workaround is to use the following command (needed every time after you reboot your machine): Manually set the MAC address of wlan0: {{{ ifconfig wlan0 hw ether 01:02:03:04:05:06 }}} Here you may use the MAC address of your wireless card, or whatever MAC address you like. Now you can bring up the interface: {{{ ifconfig wlan0 up }}} After this, find RutilT WLAN Manager in the Gnome/KDE menu, or type: {{{ rutilt }}} in a terminal window. This will launch the RutilT WLAN Manager. In it, you can scan for wireless networks, configure profiles and join networks. Encryptions available include WEP, WPA-PSK and WPA2-PSK. Note: 1. If you upgrade your kernel later, you may need to repeat the procedures above to install the rt73 modules for your new kernel. 1. If you encounter any problems, try purging(removing) the packages network-manager and network-manager-gnome, and then follow the procedures above. |
== See also == * [:WiFi/HowToUse: How To use Wifi network adapter] * [http://rt2x00.serialmonkey.com/] - enhanced legacy and next-generation driver homepage. ---- CategoryHardware |
RT73 wireless devices
This page describes how to enable support for WiFi devices based on the Ralink RT73 chipset on Debian systems. ?TableOfContents(4)
Drivers
The Ralink RT73 (RT2571W) USB wireless LAN chipset is supported by three native drivers:
[http://www.ralinktech.com/ralink/Home/Support/Linux.html rt73] (Legacy driver)
- Released by Ralink under the GPL.
- Not generally recommended for use.
- [#rt73 rt73] (Enhanced legacy driver)
Source provided by the rt73-source package.
- [#rt73usb rt73usb] (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]. An incomplete list of [#supported-devices supported devices] is listed at the end of this page.
All drivers require non-free firmware for their operation. This can be provided by the firmware-ralink package.
Installation
?Anchor(rt73usb)
rt73usb (next-generation driver)
?Anchor(rt73usb-etch2.6.18)
Etch with 2.6.18 kernel
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 rt73usb 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 [#rt73usb-etch2.6.24 Etch with 2.6.24 kernel] procedure below.
?Anchor(rt73usb-etch2.6.24)
Etch with 2.6.24 kernel
As the drivers from the rt2x00 project are included in the mainline kernel, the rt73usb driver is present on your system. Firmware is required to be installed prior to driver operation:
1. Install the etch/wireless-tools package:
aptitude update aptitude install wireless-tools
2. Add a section for [:Backports:Debian Backports] to /etc/apt/sources.list, which must also include "non-free". For example:
# Backported packages for Debian Etch deb http://www.backports.org/debian etch-backports main contrib non-free
3. Install the etch-backports/debian-backports-keyring package:
aptitude update aptitude -t etch-backports install debian-backports-keyring
As your system does not yet have the GnuPG archive key of the backports.org repository installed, you will be asked to confirm installation of a package from an untrusted repository. Enter Yes when prompted.
4. Install the etch-backports/firmware-ralink package:
aptitude -t etch-backports install firmware-ralink
5. The necessary kernel module should be [:Modules:automatically loaded]. If necessary, it can be manually loaded via:
modprobe rt73usb
If not already performed, connect the device to your system.
6. Verify your device has an available interface:
iwconfig
7. Raise the interface to activate the radio, for example:
ifconfig wlan0 up
8. [:WiFi/HowToUse:Configure] your wireless interface as appropriate.
?Anchor(rt73usb-lenny)
Lenny
As the drivers from the rt2x00 project are included in the mainline kernel, the rt73usb driver is present on your system. Firmware is required to be installed prior to driver operation:
1. Add a "non-free" section to /etc/apt/sources.list, for example:
# Debian Lenny deb http://ftp.us.debian.org/debian lenny main contrib non-free
2. Install the firmware-ralink and wireless-tools packages:
aptitude install firmware-ralink wireless-tools
3. The necessary kernel module should be [:Modules:automatically loaded]. If necessary, it can be manually loaded via:
modprobe rt73usb
If not already performed, connect the device to your system.
4. Verify your device has an available interface:
iwconfig
5. Raise the interface to activate the radio, for example:
ifconfig wlan0 up
6. [:WiFi/HowToUse:Configure] your wireless interface as appropriate.
?Anchor(rt73)
rt73 (enhanced legacy driver)
Etch
You are required to acquire and compile the rt2x00 sources, as these are not packaged. This procedure is documented at the rt2x00 project's website: http://rt2x00.serialmonkey.com/wiki/index.php?title=Rt2x00_GIT_instructions
Lenny
While use of the [#rt73usb-lenny next-generation driver] is preferred, the enhanced legacy driver can alternatively be used. This is available as a pre-built module package made against a Debian stock kernel, but can also be generated on your system via [:ModuleAssistant: module-assistant].
Pre-Built Module
1. Add "contrib" and "non-free" sections to /etc/apt/sources.list. For example:
# Debian Lenny deb http://ftp.us.debian.org/debian lenny main contrib non-free
2. Install the firmware-ralink, rt73-common, the relevant enhanced legacy module and wireless-tools packages:
aptitude install firmware-ralink rt73-common rt73-modules-$(uname -r) wireless-tools
3. Load the enhanced legacy driver:
modprobe rt73
This module will be automatically loaded when your system is restarted and the device is inserted. If not already performed, connect the device to your system.
4. Verify your device has an available interface:
iwconfig
5. Raise the interface to activate the radio, for example:
ifconfig wlan0 up
6. [:WiFi/HowToUse:Configure] your wireless interface as appropriate.
Module Assistant
1. Add "contrib" and "non-free" sections to /etc/apt/sources.list. For example:
# Debian Lenny deb http://ftp.us.debian.org/debian lenny main contrib non-free
2. Install the firmware-ralink, module-assistant, rt73-common and wireless-tools packages:
aptitude install firmware-ralink module-assistant rt73-common wireless-tools
3. Build and install a rt73-modules-* package within your system:
m-a prepare m-a a-i rt73
4. Load the enhanced legacy driver:
modprobe rt73
This module will be automatically loaded when your system is restarted and the device is inserted. If not already performed, connect the device to your system.
5. Verify your device has an available interface:
iwconfig
6. Raise the interface to activate the radio, for example:
ifconfig wlan0 up
7. [:WiFi/HowToUse:Configure] your wireless interface as appropriate.
?Anchor(supported-devices)
Supported devices
The following list is incomplete.
- Asus WL-167g v2
Belkin ?F5D7050 Ver 3
- D-Link DWL-G122 (new rev)
- Digitus DN-7003GR (VPR 1.0)
- Edimax EW-7318USg
- GW-US54HP
- Hawking HWUG1
- Linksys WUSB54 x
- Sitecom WL113 v1-002
Device Identification (["HowToIdentifyADevice/PCI"], ["HowToIdentifyADevice/USB"]). |
|
under DebianEtch , kernel2.6.18 + rt2x00 0cvs20060928-1 |
|
pci |
1814:0101 |
pci |
1814:0201 |
pci |
1814:0301 |
pci |
1814:0302 |
pci |
1814:0401 |
usb |
0411:0066 |
usb |
0411:0067 |
usb |
0411:008B |
usb |
050D:7050 |
usb |
050D:7050 |
usb |
050D:7051 |
usb |
050D:705A |
usb |
050D:705A |
usb |
06F8:E000 |
usb |
06F8:E010 |
usb |
0707:EE13 |
usb |
07D1:3C03 |
usb |
07D1:3C04 |
usb |
0B05:1706 |
usb |
0B05:1707 |
usb |
0DB0:6861 |
usb |
0DB0:6865 |
usb |
0DB0:6869 |
usb |
0DB0:6877 |
usb |
0DB0:A874 |
usb |
0DF6:9712 |
usb |
0EB0:9020 |
usb |
1044:8001 |
usb |
1044:8007 |
usb |
1044:8008 |
usb |
114B:0110 |
usb |
13B1:000D |
usb |
13B1:0011 |
usb |
13B1:001A |
usb |
13B1:0020 |
usb |
148F:1706 |
usb |
148F:2570 |
usb |
148F:2573 |
usb |
148F:2573 |
usb |
148F:2671 |
usb |
148F:9020 |
usb |
14B2:3C02 |
usb |
14B2:3C22 |
usb |
18E8:6196 |
usb |
2001:3C00 |
usb |
5A57:0260 |
See also
[:WiFi/HowToUse: How To use Wifi network adapter]
[http://rt2x00.serialmonkey.com/] - enhanced legacy and next-generation driver homepage.