Ipw2200

2007-01-28T23:04:34Z

ThinkPal: hints that would have helped myself

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
|style="vertical-align:top" |
=== Intel PRO/Wireless 2200/2915 Driver for WiFi ===
Linux driver for the 802.11bg and 802.11abg NICs - miniPCI cards - found in Centrino laptops. This driver only works on 2.6.x kernels (2.6.4 or newer).

Starting with kernels 2.6.14 the driver is included in kernel.

The following adapters sold by IBM use these chips:
* [[Intel PRO/Wireless 2200BG Mini-PCI Adapter]]
* [[Intel PRO/Wireless 2915ABG Mini-PCI Adapter]]
|}

{{NOTE|Make sure you have installed the firmware! The ipw2200 documentation will tell you where to find these firmware files and where to install those.}}

=== Project Homepage / Availability ===
http://ipw2200.sourceforge.net/

Included in mainline Linux kernels, tracking the SourceForge version with about 6 months delay.

=== Packages ===
*{{Fedora}} Packages(1): Fedora Core includes the ipw2200-drivers in FC3 (with updates) and FC4. You still need to grab the firmware from http://rpm.livna.org/
*{{Fedora}} Packages(2): http://www.atrpms.net/name/ipw2200/
*{{Mandriva}}: The ipw2200 driver modules are included in the stock kernel package; the firmware is included in the commercial distribution or available from http://plf.zarb.org/.
*{{Gentoo}}: The driver is in the portage tree: emerge net-wireless/ipw2200 and net-wireless/ipw2200-firmware
*{{Debian}} Packages: http://packages.debian.org/ipw2200-source

=== Status ===
In development, usable, WEP 128bit encryption works, WPA and WPA2 work with drivers >= 1.0.2 using [[wpa_supplicant]], monitor/rfmon is supported as with version >= 1.0.6. Generally works well, but some users experience problems (especially with firmware restarts and with WPA functionality using [[wpa_supplicant]]). Passing the <tt>hwcrypto=0</tt> module parameter improves reliability for many users.

The [[ipw2200]] driver up to version 1.0.6 (in combination with some newer kernels) had a problem getting DHCP leases (it turned out to be a bug in the broadcasting code). Version 1.0.7 seems to have fixed this.

Older [[ipw2200]] driver versions shipped by many distributions have been reported to freeze a T43 after several minutes of intensive communication. Installing version 1.1.2 of the driver solved the problem.

Latest stable versions:
* ipw2200 driver: 1.2.0
* firmware: 3.0
* ieee80211 stack: 1.2.15

Latest development versions:
* ipw2200 driver: 1.1.4
* firmware: 3.0
* ieee80211 stack: 1.2.15

Mainline kernels contain older (but mostly functional) versions of ipw2200 and ieee80211, and still require the addition of the [http://ipw2200.sourceforge.net/firmware.php firmware] files. To get the latest versions you need to separately install the [http://ipw2200.sourceforge.net/downloads.php ipw2200] module and [http://ieee80211.sourceforge.net/downloads.php ieee80211] stack.

==Installation==
=== Installation from sourcecode ===
Download the latest [http://ieee80211.sourceforge.net/downloads.php ieee80211] stack and install it:
:{{cmdroot|tar xzvf ieee80211-1.2.15.tgz}}
:{{cmdroot|cd ieee80211-1.2.15}}
:{{cmdroot|make}}
:{{cmdroot|make install}}

Download the latest [http://ipw2200.sourceforge.net/downloads.php ipw2200] module and install it:
:{{cmdroot|tar xzvf ipw2200-1.2.0.tgz}}
:{{cmdroot|cd ipw2200-1.2.0}}
:{{cmdroot|make}}
:{{cmdroot|make install}}

Download the matching [http://ipw2200.sourceforge.net/firmware.php firmware] and install it:
:{{cmdroot|tar xzvf ipw2200-fw-3.0.tgz -C /lib/firmware}}

=== Installation on Debian ===
Install ieee80211-source:
:{{cmdroot|apt-get install ieee80211-source}}
:{{cmdroot|module-assistant -t build ieee80211-source}}

Install ipw2200-source:
:{{cmdroot|apt-get install ipw2200-source}}
:{{cmdroot|module-assistant -t build ipw2200-source}}

There is a bug in the {{Debian}} package (last checked: Dec 30th 2005) that prevents from linking to <tt>ieee80211</tt> modules using module-assistant. In case it is not fixed in your version, fall back to the regular source installation procedure described above.

The firmware is not distributed with debian due to licensing reasons, download the matching [http://ipw2200.sourceforge.net/firmware.php firmware] and install it:

:{{cmdroot|tar xzvf ipw2200-fw-2.4.tgz -C /usr/lib/hotplug/firmware}}

see /etc/hotplug/firmware.agent for details on configured firmware locations

In etch the firmware can also be placed in /lib/firmware. Make sure that your firmware files are not in a subdirectory (dmesg will give you warnings after any modprobe when firmware can't be loaded)

=== Installation on Fedora Core ===
Installation on Fedora Core 5 works out of the box provided you install the ipw2200-firmware package. However, certain parts of the install process may not set up the wireless networking in a friendly manner using GNOME system tray icons and other tools. Bill Moss has written some excellent HowTo articles, including using VPNC to connect to a remote Cisco IPSec network.

* [http://www.ces.clemson.edu/linux/fc2-ipw2200.shtml Fedora Core 5 and the IPW2200 Wireless Driver]
* [http://www.ces.clemson.edu/linux/nm.shtml Fedora Core 5 NetworkManager, NetworkManager-vpnc and Wireless Driver IPW2200]

===Testing the driver ===
:{{cmdroot|modprobe ipw2200}}
:{{cmdroot|iwconfig}}

{{cmdroot|dmesg}} output might look similar to this:
ieee80211: 802.11 data/management/control stack, 1.1.6
ieee80211: Copyright (C) 2004-2005 Intel Corporation <jketreno@linux.intel.com>
ipw2200: Intel(R) PRO/Wireless 2200/2915 Network Driver, 1.0.8
ipw2200: Copyright(c) 2003-2005 Intel Corporation
ipw2200: Detected Intel PRO/Wireless 2915ABG Network Connection

NB: To make the wifi LED work on the thinkpad, pass the option {{bootparm|led|1}} to the kernel while loading the module. eg. {{cmdroot|1=modprobe ipw2200 led=1}}. This can also be accomplished by adding that option to the file where your distribution looks for modprobe options so that it becomes automatic.

In debian this can be done by putting a file named after the module in /etc/modutils with the options in it

here we might run a cmd like this

:{{cmdroot|1=echo options ipw2200 led=1 > /etc/modutils/ipw2200 }}

then we must run update-modules to remake /etc/module.conf

:{{cmdroot|update-modules}}

== WPA support ==

Use [[wpa_supplicant]] with the <tt>-Dwext</tt> argument (not <tt>-Dipw</tt>), and pass the <tt>hwcrypto=0</tt> argument to the <tt>ipw2200</tt> module.

There are some very detailed instructions with working sample configurations on the following link:
[http://www.bughost.org/ipw/wpa_howto.txt ipw2200 WPA instruction]

== Power Management ==
To enable power management, issue:
:{{cmdroot|iwpriv wlan0 set_power 7}}
where <tt>wlan0</tt> is the name of your interface. This will reduce idle power consumption by several Watts compared to no power management.

*To disable the radio (and further reduce power consumption) when the card is not in use, issue:
:{{cmdroot|echo 1 > /sys/bus/pci/drivers/ipw2200/*/rf_kill}}
*To enable the radio, issue:
:{{cmdroot|echo 0 > /sys/bus/pci/drivers/ipw2200/*/rf_kill}}
*To make the radio off by default after boot, add
options ipw2200 disable=1
to your {{path|/etc/modprobe.conf}} or equivalent (on kubuntu 6.10 {{path|/etc/modprobe.d/options}}).

See {{path|README.ipw2200}} in the <tt>ipw2200</tt> package for details and other options.

== Changing the enabled channels ==
Permitted WiFi channels vary with geography due to regulation. The EEPROM in this chip contains a country code (programmed by the hardware manufacturer), and the driver converts this to a channel list and enforces it.

If you carry your laptop to a different regulatory region, you may need to change the list of permitted channels according to local regulations. There are two ways to accomplish this:

===Patching the ipw2200 driver===
You can alter the ipw2200 driver sourcecode to hard-code the country code instead of reading it from EEPROM. For example, this will allow all 14 channels (perfect for those special occasions in international water):
<pre>
--- ipw2200.c.orig
+++ ipw2200.c
@@ -11344,7 +11344,7 @@ static int ipw_up(struct ipw_priv *priv)
memcpy(priv->net_dev->dev_addr, priv->mac_addr, ETH_ALEN);

for (j = 0; j < ARRAY_SIZE(ipw_geos); j++) {
- if (!memcmp(&priv->eeprom[EEPROM_COUNTRY_CODE],
+ if (!memcmp("ZZR",
ipw_geos[j].name, 3))
break;
}
</pre>

For the list of codes and their meaning, see the "<tt>ipw_geos</tt>" table in the [http://lxr.free-electrons.com/source/drivers/net/wireless/ipw2200.c#10382 ipw2200.c sourcecode].

===Patching the EEPROM===

Alternatively, you can change the country code in the EEPROM once and for all, and then use the standard ipw2200 driver.

See this guide:
* [http://saftware.de/#ipw2200 Patching the EEPROM].

Instead of the <tt>hd</tt> program mentioned there, you can use the more common <tt>od</tt> program:
echo -n ZZD | od -t x1
0000000 5a 5a 44
0000003

{{WARN|If this procedure goes wrong, you may ruin your wireless card.}}

== Additional Comments ==
Your kernel may include an old version of the ipw2200 driver. It is recommended to use the latest version.

Make sure you also install the firmware version needed by the driver version you use. You can find the firmware [http://ipw2200.sourceforge.net/firmware.php here]. To install it, decompress the <tt>.tgz</tt> file into {{path|/lib/firmware}}.

The driver doesn't appear to support the MII interface, so any tools like automatic network configuration managers (i.e. whereami) that rely on mii-tool do not work.

[[Category:Drivers]]

ThinkWiki - User contributions [en]

Ipw2200