User:Hmh

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.

Kernel

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

NOTE!

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

Hint:

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.

• SATA power-management
• freeze-block-queue patch (for HDAPS)
• ACPI update patches
• ACPI shutdown on resume patch
• TP SMAPI support
• Software Suspend 2
• Linuxant Conexant HSF modem driver
• nsc-ircc ISA PNP patch

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. tg3
   3. 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
6. If you do not have a dock, you can and should get rid of the legacy floppy support in the kernel. Disable CONFIG_BLK_DEV_FD for a ~0.5s speedup on boot time.

Userland

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:

/etc/sysctl.conf

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

/etc/sysfs.conf

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

# ThinkPad battery charger defaults
devices/platform/smapi/BAT0/start_charge_tresh=40
devices/platform/smapi/BAT0/stop_charge_tresh=85
devices/platform/smapi/BAT1/start_charge_tresh=70
devices/platform/smapi/BAT1/stop_charge_tresh=90

# Default frequency scalling governor
devices/system/cpu/cpu0/cpufreq/scaling_governor=conservative

NOTE!

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

References:

• How to make use of IrDA

laptop-mode-tools

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.

Suspend2

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)

The action scripts for suspend-to-ram control: /etc/acpi/actions/lid-toggle.sh

#!/bin/sh

#
# Toggle sleep-on-lid-close functionality
#

LIDLCKFILE=/var/run/acpi-lid.lock
umask 022

if [ -r ${LIDLCKFILE} ] ; then
        rm -f ${LIDLCKFILE}
        echo 12 >/proc/acpi/ibm/beep || true
else
        touch ${LIDLCKFILE} && \
        echo 3 >/proc/acpi/ibm/beep || true
fi
:

/etc/acpi/actions/sleep.sh

#!/bin/sh

LIDLCKFILE=/var/run/acpi-lid.lock
 
# Check the reason we are running
case "$1" in
    button/lid)
        # do not run with the lid open
        grep -q open /proc/acpi/$1/$2/state && exit 0
        [ -r ${LIDLCKFILE} ] && exit 0
        ;;
esac

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

/etc/acpi/actions/sleep-ramanddisk.sh

#!/bin/sh

LIDLCKFILE=/var/run/acpi-lid.lock

# Check the reason we are running
case "$1" in
    button/lid)
        # do not run with the lid open
        grep -q open /proc/acpi/$1/$2/state && exit 0
        [ -r ${LIDLCKFILE} ] && exit 0
        ;;
esac

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

To use fn+f3 to control whether to sleep when lid is closed:

/etc/acpi/events/ibm_fn_f3

event=ibm/hotkey HKEY 0+80 0+1003
action=/etc/acpi/actions/lid-toggle.sh %e

To sleep when the lid is closed:

/etc/acpi/events/lid

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

To sleep when fn+f4 is pressed:

/etc/acpi/events/ibm_fn_sleep

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

/etc/acpi/events/ibm_fn_f4

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.

/etc/acpi/events/ibm-fn-suspend

event=ibm[ /]hotkey HKEY 0+80 0+100[cC]
action=/usr/sbin/hibernate

Radio software switch (rf_kill)

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

/etc/acpi/actions/toggle_radios.sh

#!/bin/sh

set -e

cd /sys/class/net
state=0

# 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")
               break
       fi
done

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

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

:

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):

/etc/acpi/events/ibm_fn_f5

event=ibm/hotkey HKEY 0+80 0+1005
action=/etc/acpi/actions/toggle_radios.sh

Software that needs packaging

NOTE!

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

• udev interface naming guide
• ck desktop-kernel patches