Difference between revisions of "User:Hmh"

From ThinkWiki
Jump to: navigation, search
(Add fn+f5 script to toggle radios on/off, and hotkey mask)
(udev rules: point to autogen interface rules; add fix WAIT_FOR_SYSFS="bus" running for the trackpoint which will always timeout anyway)
Line 76: Line 76:
==== udev rules ====
==== udev rules ====
# udev extended network interface naming needs to be configured, order of tg3/ipw2200 won't be respected if {{path|/etc/modules.conf}} is read after udev did the PCI coldplugging
# udev extended network interface naming needs to be configured, order of tg3/ipw2200 won't be respected if {{path|/etc/modules.conf}} is read after udev did the PCI coldplugging.  Debian does this automatically, if you are lucky... check {{path|/etc/udev/rules.d/*persistent-net.rules}}.
# The thinkpad driver takes a long time to load and times-out udev every time.  To shed off this timeout from startup time, edit {{path|/etc/udev/rules.d/020_permission.rules}} and change the line containing '''WAIT_FOR_SYSFS="bus"''' to also have the following conditions: '''BUS!="serio", SUBSYSTEM!="serio"''''
==== Kernel/module configuration ====
==== Kernel/module configuration ====

Revision as of 22:55, 30 May 2006

ThinkPad T43 2687-DDU setup for Debian Etch

This is an ongoing, spotty guide for an advanced Debian setup of a T43, focused on using absolutely all of its capabilities that can be used. It is not an installation guide, but rather a configuration guide. Refer to Debian for a list of pages with initial installation instructions.

When it is really usable, I will move it to some other far more public place in ThinkWiki.

Installing should be done using the latest Debian Etch debian-installer release. Anything else simply will not run on the ThinkPad.


Baseline kernel: Debian's latest 2.6.16 ( with stabilization patches)

Thinkpad support is an ongoing, bleeding edge effort. One ends up needing to apply a ton of patches and to use the latest available kernel, sometimes even kernels not yet released
The Con Kolivas (ck) desktop kernel patches might be very applicable to a ThinkPad Kernel

Patches employed

  • Latest ipw2200 driver and ieee80211 layer:
There are two ways to go about this: either disable IEEE 802.11 support (and thus ipw2200) in the kernel and build both modules out-of-tree (failure to do so will break the out-of-tree build), or update the kernel subsystems with more up-to-date files.
The advantage of updating the kernel drivers instead of doing an out-of-tree build is that should there be any configuration options that require ieee80211 support, those will be available. On the other hand, it is a bit more difficult, as you will have to mess with Kconfig.
  • copied files over the in-kernel files in include/net, drivers/net/wireless, Documentation/networking, net/ieee80211, thus replacing the old drivers with the new ones.
  • ipw2200 often have extra options you need to enable, look in the toplevel Makefile and add them to drivers/net/wireless/Kconfig. They are usually bool types, so it is trivial to copy, e.g. IPW_DEBUG and rename to the new required options.

Kernel setup tasks

  1. Make sure the following subsystems are modules (for suspend/resume)
    1. USB (especially EHCI_HCD and UHCI_HCD)
    2. HDAPS (may work compiled in, as well)
  2. Make sure the following subsystems are enabled and not modules (safety net)
    1. ThinkPad SMAPI
  3. Place the following modules on /etc/modules:
    1. hdaps
    2. nsc-ircc
    3. tg3
    4. ipw2200
  4. Configure IrDA module options
  5. ipw2200 firmware needs to go in /lib/firmware. The module should be given the led=1 module parameter option


Complex configuration issues

You want to install and configure to your liking:

  • smartmontools
  • kde/gnome power management thingies
  • X.org power management on the video driver

Simple configuration issues

These are fairly simple minor things you might want to do:


install the procps package. Add the following lines to /etc/sysctl.conf:



install the sysfsutils package. Add the following lines to /etc/sysfs.conf

# ThinkPad battery charger defaults

# Default frequency scalling governor
Using the ondemand governor can do a number on your CPU power regulator, the conservative governor is a much better choice overall, and in fact is good enough at what it does that no userspace power governor daemon is needed, or even desired

udev rules

  1. udev extended network interface naming needs to be configured, order of tg3/ipw2200 won't be respected if /etc/modules.conf is read after udev did the PCI coldplugging. Debian does this automatically, if you are lucky... check /etc/udev/rules.d/*persistent-net.rules.
  2. The thinkpad driver takes a long time to load and times-out udev every time. To shed off this timeout from startup time, edit /etc/udev/rules.d/020_permission.rules and change the line containing WAIT_FOR_SYSFS="bus" to also have the following conditions: BUS!="serio", SUBSYSTEM!="serio"'

Kernel/module configuration

This is done in /etc/modprobe.d/ files. Install the setserial package.

Add a /etc/modprobe.d/thinkpad-t43 file there with this content:

# Intel Wireless, default to radio offline for safety and security
options ipw2200 disable=1 led=1 hwcrypto=1

# IrDA
alias irda0 nsc-ircc
options nsc-ircc dongle_id=0x09 io=0x2f8 irq=3 dma=3
install nsc-ircc /bin/setserial /dev/ttyS1 uart none port 0 irq 0; /sbin/modprobe --ignore-install nsc-ircc



Install and configure laptop-mode-tools to your liking. If you really want to protect your HD when moving the ThinkPad around, laptop-mode-tools can help that dramatically by leaving the drive spun-down and parked most of the time.


On top of what is usually done for ThinkPads, remember to set the acpi_sleep=s3_bios kernel option if you have an ATI GPU. Suspend to RAM should be done using the default mode in ram.conf (RediSafe-like suspend-to-ram-with-backup-on-disk is possible, using Suspend2... but it takes 10 times more to suspend).

If you can do the suspend to ram without unloading any modules, it is much much faster. This heavily depends on the kernel, as a lot of drivers are still quite buggy.

# Suspend to RAM mode reminders
UseSysfsPowerState mem
SaveClock restore-only
Unmount /media/*
IbmAcpi yes
# Suspend to disk mode reminders
UseSuspend2 yes
Unmount /media/*
UnmountFSTypes vfat msdos cifs smbfs ntfs nfs
IbmAcpi yes

acpi events

To setup the hotkey mask, /etc/default/acpi can be abused (it is a shell script fragment). Just append this fragment to that file:

# ThinkPad ACPI setup
[ -w /proc/acpi/ibm/hotkey ] && echo enable,0x81c >/proc/acpi/ibm/hotkey
For suspend-to-ram (sleep)



# Check the reason we are running
case "$1" in
        # do not run with the lid open
        grep -q open /proc/acpi/$1/$2/state && exit 0

exec /usr/sbin/hibernate -F /etc/hibernate/ram.conf

To sleep when the lid is closed:


event=button[ /]lid
action=/etc/acpi/actions/sleep.sh %e

To sleep when fn+f4 is pressed:


event=button[ /]sleep
action=/etc/acpi/actions/sleep.sh %e


event=ibm[ /]hotkey HKEY 0+80 0+1004
action=/etc/acpi/actions/sleep.sh %e
For hibernation (suspend-to-disk)

Requires that ibm-acpi has hotkeys enabled, mask 0x0800.


event=ibm[ /]hotkey HKEY 0+80 0+100[cC]
Radio software switch (rf_kill)

If your radios have rf_kill support, the following script can be used to toggle them on or off:



set -e

cd /sys/class/net

# Find all radios, set state to the first one we find
for i in * ; do
       if [ -r "$i/device/rf_kill" ] ; then
               state=$(cat "$i/device/rf_kill")

if [ $state != "0" ] ; then
       txtstate="Enabling radio"
       echo 3 >/proc/acpi/ibm/beep || true
       txtstate="Disabling radio"
       echo 12 >/proc/acpi/ibm/beep || true

for i in * ; do
       if [ -w "$i/device/rf_kill" ] ; then
               echo $state > "$i/device/rf_kill"
               echo $txtstate $i


You could also improve the script to manipulate the bluetooth RF switch, see ibm-acpi for more information.

To bind that script to fn+f5 (requires ibm-acpi hotkeys enabled, and mask 0x0010):


event=ibm/hotkey HKEY 0+80 0+1005

Software that needs packaging

If nobody beats me to it, I will probably package them for official upload to Debian, and official Debian Sarge backports. This requires that the software be properly licensed first, of course
  • hdapsd (a bit crude, needs a lot of work still)
  • ipw2200/ieee80211 need adopting, and since they clash terribly with in-kernel support, they will only work right if we either convert them to be patch-based, or to detect that the user built with in-kernel ieee80211/ipw2200 enabled and abort the out-of-tree compilation.

Software that could benefit from re-packaging

  • hsfmodem: should be easy to build out-of-tree in another machine other than the one it will be installed at

External Links