ThinkWiki - User contributions [en]

Installing Gentoo on a ThinkPad T410

2010-11-22T13:20:07Z

Fuchs: /* Network: Intel E1000 NIC, WiFi Link 6000 Series WNIC, Bluetooth */

== Model ==
Lenovo Thinkpad {{T410}}

== General ==
This installation instruction describes the steps after a Gentoo base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Webcam
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection
* Card reader: SD Card

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* E-Sata (should work, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)
* Card Reader: Memory Stick

== Graphics: NVIDIA Quadro NVS 3100M (GT218) ==

To install and configure the nVidia driver, just emerge nvidia-drivers. You might be interested in the ~arch masked drivers.

Framebuffer works fine with vga=0x361. hwinfo --framebuffer displays all supported resolutions.

The brightness control needs a workaround. Add

Option "RegistryDwords" "EnableBrightnessControl=1"

to your xorg.conf

Performance of the card depends heavy on powermizer
and some nvidia settings.

In recent nvidia drivers, powermizer can be configured via `nvidia-settings`

<bash>
#!/bin/sh
if [ -z "$1" ]
then
echo "Powermizer control script."
echo "2010 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: powermizer on | off"

else
if [ $1 = "on" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=0
fi
if [ $1 = "off" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=1
fi
fi
exit 0
</bash>

This script turns powermizer on or off. You can use it together with acpi events or your power management to turn powermizer off as soon as your notebook is powered via AC.

== Sound: AD1984 ==
Works out of the box. The microphone might has to be unmuted via alsamixer. If you are using pulse audio, check pavucontrol as well.

The mute button and the volume up and volume down buttons work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the hdmi output) as the default, so you have to change the default / primary mixer.

== Network: Intel E1000 NIC, WiFi Link 6000 Series WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to emerge the net-wireless/iwl6000-ucode package.
You have to enable iwlwifi / iwlagn in your kernel configuration.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to a key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

In recent versions of the driver, several 5 GHz networks create a lot of disconnects. You can try to set

options iwlagn 11n_disable=1

in /etc/modprobe.d/iwlagn.conf as a temporary solution while Intel is working on a fix.

== Ports: USB, HDMI, IEEE 1394 Firewire ==

USB works out of the box.

Firewire is untested but should work, as the port is
recognized and the module loaded.

HDMI is untested, but as it is recognized (including the alsa audio device) it should work.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you might want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

=== Hard Drive Active Protection ===

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd and app-laptop/tp_smapi with the hdaps USE-Flag enabled, which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

On newer versions of xorg it might be possible that the accelerometer is seen as a mouse, which makes your pointer hop to the middle of the screen all the time. In order to solve this, you can create a udev rule:

/etc/udev/rules.d/99-hdaps.rules
<pre>
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS accelerometer data", ENV{x11_driver}=""
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS joystick emulation", ENV{x11_driver}=""
</pre>

which solves this problem.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.

TouchPads are, as all the other input devices, not configured via xorg.conf anymore in xorg >= 1.6.
You can either use the xorg.conf.d directory, udev rules or synclient on a per user base.

I use

<pre>
synclient HorizEdgeScroll=1 VertEdgeScroll=1 MinSpeed=0.25 MaxSpeed=0.42 AccelFactor=0.0010 VertTwoFingerScroll=1 HorizTwoFingerScroll=1 TapButton2=2 TapButton3=3 PalmDetect=1 PalmMinWidth=5 RTCornerButton=2 RBCornerButton=3
</pre>

in my autostart, which activates two finger scrolling, multifinger tab and edge buttons.

The touchpad can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state. You can remove the "echo" line if you don't want the status being displayed or if you don't have xosd.
You can make the script executable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk works out of the box as well.

== Integrated Fingerprint Reader ==

Not tested yet

== Integrated Webcam ==

The Camera seems to be a Chicony Electronics Co., Ltd. device, with

Vendor ID: 0x17ef
Product ID: 0x480f

You have to enable: Video capture adapters ---> V4L USB devices ---> USB Video Class (UVC) in the kernel, then the camera will work out of the box (tested with Kopete)

== Integrated Card reader ==

The card reader is a

SD Host controller: Ricoh Co Ltd Device e822 (rev 01)

You can enable the sd/sdhci drivers in the Kernel in order to get it to work.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

You can achieve about 4 - 6 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
EndSection

##
## Server Flags
##
Section "ServerFlags"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "/usr/share/fonts/local"
FontPath "/usr/share/fonts/misc"
FontPath "/usr/share/fonts/Type1"
FontPath "/usr/share/fonts/TTF"
FontPath "/usr/share/fonts/75dpi"
FontPath "/usr/share/fonts/100dpi"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Built in Monitor
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
## Read the Appendix B of the nvidia README for explanations
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 3100M"

# power savings
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# backlight fix
Option "RegistryDwords" "EnableBrightnessControl=1"

EndSection

##
## Screen Section
##
Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load compisite for compiz
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

!arrow keys
keycode 167 = XF86Forward
keycode 166 = XF86Back

!Fn+Fx
keycode 160 = F22
keycode 244 = F23
keycode 150 = F24
keycode 235 = F27
keycode 200 = F28
keycode 213 = F29

!Brightnes
keycode 101 = SunVideoRaiseBrightness
keycode 212 = SunVideoLowerBrightness

!Media
keycode 173 = XF86AudioPrev
keycode 172 = XF86AudioPlay
keycode 171 = XF86AudioNext
keycode 174 = XF86AudioStop

!Volume
keycode 121 = XF86AudioMute
keycode 122 = XF86AudioLowerVolume
keycode 123 = XF86AudioRaiseVolume

</pre>

=== Kernel configuration ===

== Kernel 2.6.36 ==

[http://www.fuchsnet.ch/files/tp/config-2.6.36]

== Links ==
* [http://www.neoberserker.de/phpBB3/viewtopic.php?f=13&t=2132 HowTo -- Install Gentoo on Thinkpad T410 using Intel GMA HD and NVIDIA NVS 3100M (german)]

User:Fuchs

2010-10-25T20:00:53Z

Fuchs:

__NOTOC__

=== Hello! ===
My name is Christian, I was born in Biel/Bienne, Switzerland.

I am a student at the TI.BFH in Biel/Bienne, studying computer science.

=== Contact: ===
You can contact me via the discussion section of my profile.

I speak (swiss)german, french, english and a little bit spanish.

I might understand italian, but I will answer in english.

My username is usually Fuchs as well, but as there is no nick registration on the IRCNet ...

=== My Thinkpad: ===
I own a Thinkpad R61 which runs a Gentoo Linux Stage 1 installation
and a Thinpad T410 which runs as well Gentoo Linux.

Installing Gentoo on a ThinkPad T410

2010-10-25T19:52:15Z

Fuchs: /* Graphics: NVIDIA Quadro NVS 3100M (GT218) */ typo in package name

== Model ==
Lenovo Thinkpad {{T410}}

== General ==
This installation instruction describes the steps after a Gentoo base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Webcam
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection
* Card reader: SD Card

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* E-Sata (should work, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)
* Card Reader: Memory Stick

== Graphics: NVIDIA Quadro NVS 3100M (GT218) ==

To install and configure the nVidia driver, just emerge nvidia-drivers. You might be interested in the ~arch masked drivers.

Framebuffer works fine with vga=0x361. hwinfo --framebuffer displays all supported resolutions.

The brightness control needs a workaround. Add

Option "RegistryDwords" "EnableBrightnessControl=1"

to your xorg.conf

Performance of the card depends heavy on powermizer
and some nvidia settings.

In recent nvidia drivers, powermizer can be configured via `nvidia-settings`

<bash>
#!/bin/sh
if [ -z "$1" ]
then
echo "Powermizer control script."
echo "2010 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: powermizer on | off"

else
if [ $1 = "on" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=0
fi
if [ $1 = "off" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=1
fi
fi
exit 0
</bash>

This script turns powermizer on or off. You can use it together with acpi events or your power management to turn powermizer off as soon as your notebook is powered via AC.

== Sound: AD1984 ==
Works out of the box. The microphone might has to be unmuted via alsamixer. If you are using pulse audio, check pavucontrol as well.

The mute button and the volume up and volume down buttons work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the hdmi output) as the default, so you have to change the default / primary mixer.

== Network: Intel E1000 NIC, WiFi Link 6000 Series WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to emerge the net-wireless/iwl6000-ucode package.
You have to enable iwlwifi / iwlagn in your kernel configuration.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to a key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

== Ports: USB, HDMI, IEEE 1394 Firewire ==

USB works out of the box.

Firewire is untested but should work, as the port is
recognized and the module loaded.

HDMI is untested, but as it is recognized (including the alsa audio device) it should work.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you might want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

=== Hard Drive Active Protection ===

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd and app-laptop/tp_smapi with the hdaps USE-Flag enabled, which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

On newer versions of xorg it might be possible that the accelerometer is seen as a mouse, which makes your pointer hop to the middle of the screen all the time. In order to solve this, you can create a udev rule:

/etc/udev/rules.d/99-hdaps.rules
<pre>
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS accelerometer data", ENV{x11_driver}=""
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS joystick emulation", ENV{x11_driver}=""
</pre>

which solves this problem.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.

TouchPads are, as all the other input devices, not configured via xorg.conf anymore in xorg >= 1.6.
You can either use the xorg.conf.d directory, udev rules or synclient on a per user base.

I use

<pre>
synclient HorizEdgeScroll=1 VertEdgeScroll=1 MinSpeed=0.25 MaxSpeed=0.42 AccelFactor=0.0010 VertTwoFingerScroll=1 HorizTwoFingerScroll=1 TapButton2=2 TapButton3=3 PalmDetect=1 PalmMinWidth=5 RTCornerButton=2 RBCornerButton=3
</pre>

in my autostart, which activates two finger scrolling, multifinger tab and edge buttons.

The touchpad can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state. You can remove the "echo" line if you don't want the status being displayed or if you don't have xosd.
You can make the script executable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk works out of the box as well.

== Integrated Fingerprint Reader ==

Not tested yet

== Integrated Webcam ==

The Camera seems to be a Chicony Electronics Co., Ltd. device, with

Vendor ID: 0x17ef
Product ID: 0x480f

You have to enable: Video capture adapters ---> V4L USB devices ---> USB Video Class (UVC) in the kernel, then the camera will work out of the box (tested with Kopete)

== Integrated Card reader ==

The card reader is a

SD Host controller: Ricoh Co Ltd Device e822 (rev 01)

You can enable the sd/sdhci drivers in the Kernel in order to get it to work.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

You can achieve about 4 - 6 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
EndSection

##
## Server Flags
##
Section "ServerFlags"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "/usr/share/fonts/local"
FontPath "/usr/share/fonts/misc"
FontPath "/usr/share/fonts/Type1"
FontPath "/usr/share/fonts/TTF"
FontPath "/usr/share/fonts/75dpi"
FontPath "/usr/share/fonts/100dpi"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Built in Monitor
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
## Read the Appendix B of the nvidia README for explanations
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 3100M"

# power savings
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# backlight fix
Option "RegistryDwords" "EnableBrightnessControl=1"

EndSection

##
## Screen Section
##
Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load compisite for compiz
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

!arrow keys
keycode 167 = XF86Forward
keycode 166 = XF86Back

!Fn+Fx
keycode 160 = F22
keycode 244 = F23
keycode 150 = F24
keycode 235 = F27
keycode 200 = F28
keycode 213 = F29

!Brightnes
keycode 101 = SunVideoRaiseBrightness
keycode 212 = SunVideoLowerBrightness

!Media
keycode 173 = XF86AudioPrev
keycode 172 = XF86AudioPlay
keycode 171 = XF86AudioNext
keycode 174 = XF86AudioStop

!Volume
keycode 121 = XF86AudioMute
keycode 122 = XF86AudioLowerVolume
keycode 123 = XF86AudioRaiseVolume

</pre>

=== Kernel configuration ===

== Kernel 2.6.36 ==

[http://www.fuchsnet.ch/files/tp/config-2.6.36]

Installing Gentoo on a ThinkPad T410

2010-10-25T18:46:55Z

Fuchs: Kernel configuration

== Model ==
Lenovo Thinkpad {{T410}}

== General ==
This installation instruction describes the steps after a Gentoo base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Webcam
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection
* Card reader: SD Card

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* E-Sata (should work, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)
* Card Reader: Memory Stick

== Graphics: NVIDIA Quadro NVS 3100M (GT218) ==

To install and configure the nVidia driver, just emerge nvidia-driver.

Framebuffer works fine with vga=0x361.
hwinfo --framebuffer displays all supported resolutions.

The brightness control needs a workaround.
Add

Option "RegistryDwords" "EnableBrightnessControl=1"

to your xorg.conf

Performance of the card depends heavy on powermizer
and some nvidia settings.

In recent nvidia drivers, powermizer can be configured via `nvidia-settings`

<bash>
#!/bin/sh
if [ -z "$1" ]
then
echo "Powermizer control script."
echo "2010 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: powermizer on | off"

else
if [ $1 = "on" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=0
fi
if [ $1 = "off" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=1
fi
fi
exit 0
</bash>

This script turns powermizer on or off. You can use it together with acpi events or your power management to turn powermizer off as soon as your notebook is powered via AC.

== Sound: AD1984 ==
Works out of the box. The microphone might has to be unmuted via alsamixer. If you are using pulse audio, check pavucontrol as well.

The mute button and the volume up and volume down buttons work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the hdmi output) as the default, so you have to change the default / primary mixer.

== Network: Intel E1000 NIC, WiFi Link 6000 Series WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to emerge the net-wireless/iwl6000-ucode package.
You have to enable iwlwifi / iwlagn in your kernel configuration.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to a key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

== Ports: USB, HDMI, IEEE 1394 Firewire ==

USB works out of the box.

Firewire is untested but should work, as the port is
recognized and the module loaded.

HDMI is untested, but as it is recognized (including the alsa audio device) it should work.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you might want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

=== Hard Drive Active Protection ===

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd and app-laptop/tp_smapi with the hdaps USE-Flag enabled, which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

On newer versions of xorg it might be possible that the accelerometer is seen as a mouse, which makes your pointer hop to the middle of the screen all the time. In order to solve this, you can create a udev rule:

/etc/udev/rules.d/99-hdaps.rules
<pre>
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS accelerometer data", ENV{x11_driver}=""
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS joystick emulation", ENV{x11_driver}=""
</pre>

which solves this problem.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.

TouchPads are, as all the other input devices, not configured via xorg.conf anymore in xorg >= 1.6.
You can either use the xorg.conf.d directory, udev rules or synclient on a per user base.

I use

<pre>
synclient HorizEdgeScroll=1 VertEdgeScroll=1 MinSpeed=0.25 MaxSpeed=0.42 AccelFactor=0.0010 VertTwoFingerScroll=1 HorizTwoFingerScroll=1 TapButton2=2 TapButton3=3 PalmDetect=1 PalmMinWidth=5 RTCornerButton=2 RBCornerButton=3
</pre>

in my autostart, which activates two finger scrolling, multifinger tab and edge buttons.

The touchpad can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state. You can remove the "echo" line if you don't want the status being displayed or if you don't have xosd.
You can make the script executable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk works out of the box as well.

== Integrated Fingerprint Reader ==

Not tested yet

== Integrated Webcam ==

The Camera seems to be a Chicony Electronics Co., Ltd. device, with

Vendor ID: 0x17ef
Product ID: 0x480f

You have to enable: Video capture adapters ---> V4L USB devices ---> USB Video Class (UVC) in the kernel, then the camera will work out of the box (tested with Kopete)

== Integrated Card reader ==

The card reader is a

SD Host controller: Ricoh Co Ltd Device e822 (rev 01)

You can enable the sd/sdhci drivers in the Kernel in order to get it to work.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

You can achieve about 4 - 6 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
EndSection

##
## Server Flags
##
Section "ServerFlags"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "/usr/share/fonts/local"
FontPath "/usr/share/fonts/misc"
FontPath "/usr/share/fonts/Type1"
FontPath "/usr/share/fonts/TTF"
FontPath "/usr/share/fonts/75dpi"
FontPath "/usr/share/fonts/100dpi"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Built in Monitor
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
## Read the Appendix B of the nvidia README for explanations
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 3100M"

# power savings
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# backlight fix
Option "RegistryDwords" "EnableBrightnessControl=1"

EndSection

##
## Screen Section
##
Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load compisite for compiz
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

!arrow keys
keycode 167 = XF86Forward
keycode 166 = XF86Back

!Fn+Fx
keycode 160 = F22
keycode 244 = F23
keycode 150 = F24
keycode 235 = F27
keycode 200 = F28
keycode 213 = F29

!Brightnes
keycode 101 = SunVideoRaiseBrightness
keycode 212 = SunVideoLowerBrightness

!Media
keycode 173 = XF86AudioPrev
keycode 172 = XF86AudioPlay
keycode 171 = XF86AudioNext
keycode 174 = XF86AudioStop

!Volume
keycode 121 = XF86AudioMute
keycode 122 = XF86AudioLowerVolume
keycode 123 = XF86AudioRaiseVolume

</pre>

=== Kernel configuration ===

== Kernel 2.6.36 ==

[http://www.fuchsnet.ch/files/tp/config-2.6.36]

Installing Gentoo on a ThinkPad T410

2010-10-25T14:47:01Z

Fuchs: /* Graphics: NVIDIA Quadro NVS 3100M (GT218) */ bash syntax

== Model ==
Lenovo Thinkpad {{T410}}

== General ==
This installation instruction describes the steps after a Gentoo base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Webcam
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection
* Card reader: SD Card

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* E-Sata (should work, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)
* Card Reader: Memory Stick

== Graphics: NVIDIA Quadro NVS 3100M (GT218) ==

To install and configure the nVidia driver, just emerge nvidia-driver.

Framebuffer works fine with vga=0x361.
hwinfo --framebuffer displays all supported resolutions.

The brightness control needs a workaround.
Add

Option "RegistryDwords" "EnableBrightnessControl=1"

to your xorg.conf

Performance of the card depends heavy on powermizer
and some nvidia settings.

In recent nvidia drivers, powermizer can be configured via `nvidia-settings`

<bash>
#!/bin/sh
if [ -z "$1" ]
then
echo "Powermizer control script."
echo "2010 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: powermizer on | off"

else
if [ $1 = "on" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=0
fi
if [ $1 = "off" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=1
fi
fi
exit 0
</bash>

This script turns powermizer on or off. You can use it together with acpi events or your power management to turn powermizer off as soon as your notebook is powered via AC.

== Sound: AD1984 ==
Works out of the box. The microphone might has to be unmuted via alsamixer. If you are using pulse audio, check pavucontrol as well.

The mute button and the volume up and volume down buttons work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the hdmi output) as the default, so you have to change the default / primary mixer.

== Network: Intel E1000 NIC, WiFi Link 6000 Series WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to emerge the net-wireless/iwl6000-ucode package.
You have to enable iwlwifi / iwlagn in your kernel configuration.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to a key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

== Ports: USB, HDMI, IEEE 1394 Firewire ==

USB works out of the box.

Firewire is untested but should work, as the port is
recognized and the module loaded.

HDMI is untested, but as it is recognized (including the alsa audio device) it should work.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.

TouchPads are, as all the other input devices, not configured via xorg.conf anymore in xorg >= 1.6.
You can either use the xorg.conf.d directory, udev rules or synclient on a per user base.

I use

<pre>
synclient HorizEdgeScroll=1 VertEdgeScroll=1 MinSpeed=0.25 MaxSpeed=0.42 AccelFactor=0.0010 VertTwoFingerScroll=1 HorizTwoFingerScroll=1 TapButton2=2 TapButton3=3 PalmDetect=1 PalmMinWidth=5 RTCornerButton=2 RBCornerButton=3
</pre>

in my autostart, which activates two finger scrolling, multifinger tab and edge buttons.

The touchpad can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state. You can remove the "echo" line if you don't want the status being displayed or if you don't have xosd.
You can make the script executable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk works out of the box as well.

== Integrated Fingerprint Reader ==

Not tested yet

== Integrated Webcam ==

The Camera seems to be a Chicony Electronics Co., Ltd. device, with

Vendor ID: 0x17ef
Product ID: 0x480f

You have to enable: Video capture adapters ---> V4L USB devices ---> USB Video Class (UVC) in the kernel, then the camera will work out of the box (tested with Kopete)

== Integrated Card reader ==

The card reader is a

SD Host controller: Ricoh Co Ltd Device e822 (rev 01)

You can enable the sd/sdhci drivers in the Kernel in order to get it to work.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd and app-laptop/tp_smapi with the hdaps USE-Flag enabled, which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

On newer versions of xorg it might be possible that the accelerometer is seen as a mouse, which makes your pointer hop to the middle of the screen all the time. In order to solve this, you can create a udev rule:

/etc/udev/rules.d/99-hdaps.rules
<pre>
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS accelerometer data", ENV{x11_driver}=""
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS joystick emulation", ENV{x11_driver}=""
</pre>

which solves this problem.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

You can achieve about 4 - 6 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
EndSection

##
## Server Flags
##
Section "ServerFlags"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "/usr/share/fonts/local"
FontPath "/usr/share/fonts/misc"
FontPath "/usr/share/fonts/Type1"
FontPath "/usr/share/fonts/TTF"
FontPath "/usr/share/fonts/75dpi"
FontPath "/usr/share/fonts/100dpi"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Built in Monitor
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
## Read the Appendix B of the nvidia README for explanations
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 3100M"

# power savings
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# backlight fix
Option "RegistryDwords" "EnableBrightnessControl=1"

EndSection

##
## Screen Section
##
Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load compisite for compiz
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

!arrow keys
keycode 167 = XF86Forward
keycode 166 = XF86Back

!Fn+Fx
keycode 160 = F22
keycode 244 = F23
keycode 150 = F24
keycode 235 = F27
keycode 200 = F28
keycode 213 = F29

!Brightnes
keycode 101 = SunVideoRaiseBrightness
keycode 212 = SunVideoLowerBrightness

!Media
keycode 173 = XF86AudioPrev
keycode 172 = XF86AudioPlay
keycode 171 = XF86AudioNext
keycode 174 = XF86AudioStop

!Volume
keycode 121 = XF86AudioMute
keycode 122 = XF86AudioLowerVolume
keycode 123 = XF86AudioRaiseVolume

</pre>

=== Kernel configuration ===

Follows soon

Installing Gentoo on a ThinkPad T410

2010-10-25T14:45:22Z

Fuchs: /* xmodmap */

== Model ==
Lenovo Thinkpad {{T410}}

== General ==
This installation instruction describes the steps after a Gentoo base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Webcam
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection
* Card reader: SD Card

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* E-Sata (should work, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)
* Card Reader: Memory Stick

== Graphics: NVIDIA Quadro NVS 3100M (GT218) ==

To install and configure the nVidia driver, just emerge nvidia-driver.

Framebuffer works fine with vga=0x361.
hwinfo --framebuffer displays all supported resolutions.

The brightness control needs a workaround.
Add

Option "RegistryDwords" "EnableBrightnessControl=1"

to your xorg.conf

Performance of the card depends heavy on powermizer
and some nvidia settings.

In recent nvidia drivers, powermizer can be configured via `nvidia-settings`

<pre>
#!/bin/sh
if [ -z "$1" ]
then
echo "Powermizer control script."
echo "2010 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: powermizer on | off"

else
if [ $1 = "on" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=0
fi
if [ $1 = "off" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=1
fi
fi
exit 0
</pre>

This script turns powermizer on or off. You can use it together with acpi events or your power management to turn powermizer off as soon as your notebook is powered via AC.

== Sound: AD1984 ==
Works out of the box. The microphone might has to be unmuted via alsamixer. If you are using pulse audio, check pavucontrol as well.

The mute button and the volume up and volume down buttons work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the hdmi output) as the default, so you have to change the default / primary mixer.

== Network: Intel E1000 NIC, WiFi Link 6000 Series WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to emerge the net-wireless/iwl6000-ucode package.
You have to enable iwlwifi / iwlagn in your kernel configuration.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to a key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

== Ports: USB, HDMI, IEEE 1394 Firewire ==

USB works out of the box.

Firewire is untested but should work, as the port is
recognized and the module loaded.

HDMI is untested, but as it is recognized (including the alsa audio device) it should work.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.

TouchPads are, as all the other input devices, not configured via xorg.conf anymore in xorg >= 1.6.
You can either use the xorg.conf.d directory, udev rules or synclient on a per user base.

I use

<pre>
synclient HorizEdgeScroll=1 VertEdgeScroll=1 MinSpeed=0.25 MaxSpeed=0.42 AccelFactor=0.0010 VertTwoFingerScroll=1 HorizTwoFingerScroll=1 TapButton2=2 TapButton3=3 PalmDetect=1 PalmMinWidth=5 RTCornerButton=2 RBCornerButton=3
</pre>

in my autostart, which activates two finger scrolling, multifinger tab and edge buttons.

The touchpad can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state. You can remove the "echo" line if you don't want the status being displayed or if you don't have xosd.
You can make the script executable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk works out of the box as well.

== Integrated Fingerprint Reader ==

Not tested yet

== Integrated Webcam ==

The Camera seems to be a Chicony Electronics Co., Ltd. device, with

Vendor ID: 0x17ef
Product ID: 0x480f

You have to enable: Video capture adapters ---> V4L USB devices ---> USB Video Class (UVC) in the kernel, then the camera will work out of the box (tested with Kopete)

== Integrated Card reader ==

The card reader is a

SD Host controller: Ricoh Co Ltd Device e822 (rev 01)

You can enable the sd/sdhci drivers in the Kernel in order to get it to work.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd and app-laptop/tp_smapi with the hdaps USE-Flag enabled, which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

On newer versions of xorg it might be possible that the accelerometer is seen as a mouse, which makes your pointer hop to the middle of the screen all the time. In order to solve this, you can create a udev rule:

/etc/udev/rules.d/99-hdaps.rules
<pre>
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS accelerometer data", ENV{x11_driver}=""
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS joystick emulation", ENV{x11_driver}=""
</pre>

which solves this problem.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

You can achieve about 4 - 6 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
EndSection

##
## Server Flags
##
Section "ServerFlags"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "/usr/share/fonts/local"
FontPath "/usr/share/fonts/misc"
FontPath "/usr/share/fonts/Type1"
FontPath "/usr/share/fonts/TTF"
FontPath "/usr/share/fonts/75dpi"
FontPath "/usr/share/fonts/100dpi"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Built in Monitor
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
## Read the Appendix B of the nvidia README for explanations
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 3100M"

# power savings
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# backlight fix
Option "RegistryDwords" "EnableBrightnessControl=1"

EndSection

##
## Screen Section
##
Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load compisite for compiz
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

!arrow keys
keycode 167 = XF86Forward
keycode 166 = XF86Back

!Fn+Fx
keycode 160 = F22
keycode 244 = F23
keycode 150 = F24
keycode 235 = F27
keycode 200 = F28
keycode 213 = F29

!Brightnes
keycode 101 = SunVideoRaiseBrightness
keycode 212 = SunVideoLowerBrightness

!Media
keycode 173 = XF86AudioPrev
keycode 172 = XF86AudioPlay
keycode 171 = XF86AudioNext
keycode 174 = XF86AudioStop

!Volume
keycode 121 = XF86AudioMute
keycode 122 = XF86AudioLowerVolume
keycode 123 = XF86AudioRaiseVolume

</pre>

=== Kernel configuration ===

Follows soon

Installing Gentoo on a ThinkPad T410

2010-10-25T14:36:21Z

Fuchs: /* xmodmap */

== Model ==
Lenovo Thinkpad {{T410}}

== General ==
This installation instruction describes the steps after a Gentoo base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Webcam
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection
* Card reader: SD Card

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* E-Sata (should work, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)
* Card Reader: Memory Stick

== Graphics: NVIDIA Quadro NVS 3100M (GT218) ==

To install and configure the nVidia driver, just emerge nvidia-driver.

Framebuffer works fine with vga=0x361.
hwinfo --framebuffer displays all supported resolutions.

The brightness control needs a workaround.
Add

Option "RegistryDwords" "EnableBrightnessControl=1"

to your xorg.conf

Performance of the card depends heavy on powermizer
and some nvidia settings.

In recent nvidia drivers, powermizer can be configured via `nvidia-settings`

<pre>
#!/bin/sh
if [ -z "$1" ]
then
echo "Powermizer control script."
echo "2010 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: powermizer on | off"

else
if [ $1 = "on" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=0
fi
if [ $1 = "off" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=1
fi
fi
exit 0
</pre>

This script turns powermizer on or off. You can use it together with acpi events or your power management to turn powermizer off as soon as your notebook is powered via AC.

== Sound: AD1984 ==
Works out of the box. The microphone might has to be unmuted via alsamixer. If you are using pulse audio, check pavucontrol as well.

The mute button and the volume up and volume down buttons work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the hdmi output) as the default, so you have to change the default / primary mixer.

== Network: Intel E1000 NIC, WiFi Link 6000 Series WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to emerge the net-wireless/iwl6000-ucode package.
You have to enable iwlwifi / iwlagn in your kernel configuration.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to a key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

== Ports: USB, HDMI, IEEE 1394 Firewire ==

USB works out of the box.

Firewire is untested but should work, as the port is
recognized and the module loaded.

HDMI is untested, but as it is recognized (including the alsa audio device) it should work.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.

TouchPads are, as all the other input devices, not configured via xorg.conf anymore in xorg >= 1.6.
You can either use the xorg.conf.d directory, udev rules or synclient on a per user base.

I use

<pre>
synclient HorizEdgeScroll=1 VertEdgeScroll=1 MinSpeed=0.25 MaxSpeed=0.42 AccelFactor=0.0010 VertTwoFingerScroll=1 HorizTwoFingerScroll=1 TapButton2=2 TapButton3=3 PalmDetect=1 PalmMinWidth=5 RTCornerButton=2 RBCornerButton=3
</pre>

in my autostart, which activates two finger scrolling, multifinger tab and edge buttons.

The touchpad can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state. You can remove the "echo" line if you don't want the status being displayed or if you don't have xosd.
You can make the script executable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk works out of the box as well.

== Integrated Fingerprint Reader ==

Not tested yet

== Integrated Webcam ==

The Camera seems to be a Chicony Electronics Co., Ltd. device, with

Vendor ID: 0x17ef
Product ID: 0x480f

You have to enable: Video capture adapters ---> V4L USB devices ---> USB Video Class (UVC) in the kernel, then the camera will work out of the box (tested with Kopete)

== Integrated Card reader ==

The card reader is a

SD Host controller: Ricoh Co Ltd Device e822 (rev 01)

You can enable the sd/sdhci drivers in the Kernel in order to get it to work.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd and app-laptop/tp_smapi with the hdaps USE-Flag enabled, which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

On newer versions of xorg it might be possible that the accelerometer is seen as a mouse, which makes your pointer hop to the middle of the screen all the time. In order to solve this, you can create a udev rule:

/etc/udev/rules.d/99-hdaps.rules
<pre>
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS accelerometer data", ENV{x11_driver}=""
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS joystick emulation", ENV{x11_driver}=""
</pre>

which solves this problem.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

You can achieve about 4 - 6 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
EndSection

##
## Server Flags
##
Section "ServerFlags"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "/usr/share/fonts/local"
FontPath "/usr/share/fonts/misc"
FontPath "/usr/share/fonts/Type1"
FontPath "/usr/share/fonts/TTF"
FontPath "/usr/share/fonts/75dpi"
FontPath "/usr/share/fonts/100dpi"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Built in Monitor
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
## Read the Appendix B of the nvidia README for explanations
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 3100M"

# power savings
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# backlight fix
Option "RegistryDwords" "EnableBrightnessControl=1"

EndSection

##
## Screen Section
##
Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load compisite for compiz
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional arrow keys

keycode 167 = XF86Forward
keycode 166 = XF86Back

! Fn+Fx Keys: F2,F3,F4,F5,F7,F8,F9

keycode 160 = F22
keycode 244 = F13
keycode 150 = F24
keycode 200 = F25
keycode 235 = F27
keycode 156 = F28
keycode 213 = F29

! Brightness (Fn+Pg* keys)

keycode 101 = SunVideoRaiseBrightness
keycode 212 = SunVideoLowerBrightness

! Fn+Arrow keys (Multimedia keys)

keycode 173 = XF86AudioPrev
keycode 172 = XF86AudioPlay
keycode 171 = XF86AudioNext
keycode 174 = XF86AudioStop

! Volume control

keycode 121 = XF86AudioMute
keycode 122 = XF86AudioLowerVolume
keycode 123 = XF86AudioRaiseVolume

</pre>

=== Kernel configuration ===

Follows soon

Installing Gentoo on a ThinkPad T410

2010-10-25T14:30:07Z

Fuchs: camera / sd reader

== Model ==
Lenovo Thinkpad {{T410}}

== General ==
This installation instruction describes the steps after a Gentoo base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Webcam
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection
* Card reader: SD Card

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* E-Sata (should work, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)
* Card Reader: Memory Stick

== Graphics: NVIDIA Quadro NVS 3100M (GT218) ==

To install and configure the nVidia driver, just emerge nvidia-driver.

Framebuffer works fine with vga=0x361.
hwinfo --framebuffer displays all supported resolutions.

The brightness control needs a workaround.
Add

Option "RegistryDwords" "EnableBrightnessControl=1"

to your xorg.conf

Performance of the card depends heavy on powermizer
and some nvidia settings.

In recent nvidia drivers, powermizer can be configured via `nvidia-settings`

<pre>
#!/bin/sh
if [ -z "$1" ]
then
echo "Powermizer control script."
echo "2010 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: powermizer on | off"

else
if [ $1 = "on" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=0
fi
if [ $1 = "off" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=1
fi
fi
exit 0
</pre>

This script turns powermizer on or off. You can use it together with acpi events or your power management to turn powermizer off as soon as your notebook is powered via AC.

== Sound: AD1984 ==
Works out of the box. The microphone might has to be unmuted via alsamixer. If you are using pulse audio, check pavucontrol as well.

The mute button and the volume up and volume down buttons work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the hdmi output) as the default, so you have to change the default / primary mixer.

== Network: Intel E1000 NIC, WiFi Link 6000 Series WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to emerge the net-wireless/iwl6000-ucode package.
You have to enable iwlwifi / iwlagn in your kernel configuration.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to a key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

== Ports: USB, HDMI, IEEE 1394 Firewire ==

USB works out of the box.

Firewire is untested but should work, as the port is
recognized and the module loaded.

HDMI is untested, but as it is recognized (including the alsa audio device) it should work.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.

TouchPads are, as all the other input devices, not configured via xorg.conf anymore in xorg >= 1.6.
You can either use the xorg.conf.d directory, udev rules or synclient on a per user base.

I use

<pre>
synclient HorizEdgeScroll=1 VertEdgeScroll=1 MinSpeed=0.25 MaxSpeed=0.42 AccelFactor=0.0010 VertTwoFingerScroll=1 HorizTwoFingerScroll=1 TapButton2=2 TapButton3=3 PalmDetect=1 PalmMinWidth=5 RTCornerButton=2 RBCornerButton=3
</pre>

in my autostart, which activates two finger scrolling, multifinger tab and edge buttons.

The touchpad can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state. You can remove the "echo" line if you don't want the status being displayed or if you don't have xosd.
You can make the script executable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk works out of the box as well.

== Integrated Fingerprint Reader ==

Not tested yet

== Integrated Webcam ==

The Camera seems to be a Chicony Electronics Co., Ltd. device, with

Vendor ID: 0x17ef
Product ID: 0x480f

You have to enable: Video capture adapters ---> V4L USB devices ---> USB Video Class (UVC) in the kernel, then the camera will work out of the box (tested with Kopete)

== Integrated Card reader ==

The card reader is a

SD Host controller: Ricoh Co Ltd Device e822 (rev 01)

You can enable the sd/sdhci drivers in the Kernel in order to get it to work.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd and app-laptop/tp_smapi with the hdaps USE-Flag enabled, which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

On newer versions of xorg it might be possible that the accelerometer is seen as a mouse, which makes your pointer hop to the middle of the screen all the time. In order to solve this, you can create a udev rule:

/etc/udev/rules.d/99-hdaps.rules
<pre>
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS accelerometer data", ENV{x11_driver}=""
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS joystick emulation", ENV{x11_driver}=""
</pre>

which solves this problem.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

You can achieve about 4 - 6 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
EndSection

##
## Server Flags
##
Section "ServerFlags"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "/usr/share/fonts/local"
FontPath "/usr/share/fonts/misc"
FontPath "/usr/share/fonts/Type1"
FontPath "/usr/share/fonts/TTF"
FontPath "/usr/share/fonts/75dpi"
FontPath "/usr/share/fonts/100dpi"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Built in Monitor
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
## Read the Appendix B of the nvidia README for explanations
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 3100M"

# power savings
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# backlight fix
Option "RegistryDwords" "EnableBrightnessControl=1"

EndSection

##
## Screen Section
##
Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load compisite for compiz
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== Kernel configuration ===

Follows soon

Installing Gentoo on a ThinkPad T410

2010-10-25T11:55:24Z

Fuchs: initial commit

== Model ==
Lenovo Thinkpad {{T410}}

== General ==
This installation instruction describes the steps after a Gentoo base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Webcam
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection
* Card reader: SD Card

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* E-Sata (should work, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)
* Card Reader: Memory Stick

== Graphics: NVIDIA Quadro NVS 3100M (GT218) ==

To install and configure the nVidia driver, just emerge nvidia-driver.

Framebuffer works fine with vga=0x361.
hwinfo --framebuffer displays all supported resolutions.

The brightness control needs a workaround.
Add

Option "RegistryDwords" "EnableBrightnessControl=1"

to your xorg.conf

Performance of the card depends heavy on powermizer
and some nvidia settings.

In recent nvidia drivers, powermizer can be configured via `nvidia-settings`

<pre>
#!/bin/sh
if [ -z "$1" ]
then
echo "Powermizer control script."
echo "2010 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: powermizer on | off"

else
if [ $1 = "on" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=0
fi
if [ $1 = "off" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=1
fi
fi
exit 0
</pre>

This script turns powermizer on or off. You can use it together with acpi events or your power management to turn powermizer off as soon as your notebook is powered via AC.

== Sound: AD1984 ==
Works out of the box. The microphone might has to be unmuted via alsamixer. If you are using pulse audio, check pavucontrol as well.

The mute button and the volume up and volume down buttons work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the hdmi output) as the default, so you have to change the default / primary mixer.

== Network: Intel E1000 NIC, WiFi Link 6000 Series WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to emerge the net-wireless/iwl6000-ucode package.
You have to enable iwlwifi / iwlagn in your kernel configuration.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to a key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

== Ports: USB, HDMI, IEEE 1394 Firewire ==

USB works out of the box.

Firewire is untested but should work, as the port is
recognized and the module loaded.

HDMI is untested, but as it is recognized (including the alsa audio device) it should work.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.

TouchPads are, as all the other input devices, not configured via xorg.conf anymore in xorg >= 1.6.
You can either use the xorg.conf.d directory, udev rules or synclient on a per user base.

I use

<pre>
synclient HorizEdgeScroll=1 VertEdgeScroll=1 MinSpeed=0.25 MaxSpeed=0.42 AccelFactor=0.0010 VertTwoFingerScroll=1 HorizTwoFingerScroll=1 TapButton2=2 TapButton3=3 PalmDetect=1 PalmMinWidth=5 RTCornerButton=2 RBCornerButton=3
</pre>

in my autostart, which activates two finger scrolling, multifinger tab and edge buttons.

The touchpad can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state. You can remove the "echo" line if you don't want the status being displayed or if you don't have xosd.
You can make the script executable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk works out of the box as well.

== Integrated Fingerprint Reader ==

Not tested yet

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd and app-laptop/tp_smapi with the hdaps USE-Flag enabled, which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

On newer versions of xorg it might be possible that the accelerometer is seen as a mouse, which makes your pointer hop to the middle of the screen all the time. In order to solve this, you can create a udev rule:

/etc/udev/rules.d/99-hdaps.rules
<pre>
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS accelerometer data", ENV{x11_driver}=""
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS joystick emulation", ENV{x11_driver}=""
</pre>

which solves this problem.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

You can achieve about 4 - 6 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
EndSection

##
## Server Flags
##
Section "ServerFlags"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "/usr/share/fonts/local"
FontPath "/usr/share/fonts/misc"
FontPath "/usr/share/fonts/Type1"
FontPath "/usr/share/fonts/TTF"
FontPath "/usr/share/fonts/75dpi"
FontPath "/usr/share/fonts/100dpi"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Built in Monitor
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
## Read the Appendix B of the nvidia README for explanations
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 3100M"

# power savings
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# backlight fix
Option "RegistryDwords" "EnableBrightnessControl=1"

EndSection

##
## Screen Section
##
Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load compisite for compiz
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== Kernel configuration ===

Follows soon

Installing Gentoo 2007.0 on a ThinkPad R61

2010-02-20T12:32:11Z

Fuchs: lots of updates: X11, nvidia driver, synaptics, ...

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebuffer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Performance of the card depends heavy on powermizer
and some nvidia settings.

In recent nvidia drivers, powermizer can be configured via `nvidia-settings`

<pre>
#!/bin/sh
if [ -z "$1" ]
then
echo "Powermizer control script."
echo "2010 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: powermizer on | off"

else
if [ $1 = "on" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=0
fi
if [ $1 = "off" ]
then
nvidia-settings -a [gpu:0]/GPUPowerMizerMode=1
fi
fi
exit 0
</pre>

This script turns powermizer on or off. You can use it together with acpi events or your power management to turn powermizer off as soon as your notebook is powered via AC.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.

TouchPads are, as all the other input devices, not configured via xorg.conf anymore in xorg >= 1.6.
You can either use hal policy files (deprecated as well), udev rules or synclient on a per user base.

I use

<pre>
synclient HorizEdgeScroll=1 VertEdgeScroll=1 MinSpeed=0.25 MaxSpeed=0.42 AccelFactor=0.0010 VertTwoFingerScroll=1 HorizTwoFingerScroll=1 TapButton2=2 TapButton3=3 PalmDetect=1 PalmMinWidth=5 RTCornerButton=2 RBCornerButton=3
</pre>

in my autostart, which activates two finger scrolling, multifinger tab and edge buttons.

The touchpad can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state. You can remove the "echo" line if you don't want the status being displayed or if you don't have xosd.
You can make the script executable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

On newer versions of xorg it might be possible that the accelerometer is seen as a mouse, which makes your pointer hop to the middle of the screen all the time. In order to solve this, you can create a udev rule:

/etc/udev/rules.d/99-hdaps.rules
<pre>
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS accelerometer data", ENV{x11_driver}=""
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="ThinkPad HDAPS joystick emulation", ENV{x11_driver}=""
</pre>

which solves this problem.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 [[dynticks]] are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

You also might want to change the keyboard layout.

'
Note: in this configuration here nvidia wont read out
sane refresh and sync values out of your flat panel.

In this configuration the modes given don't affect
the modes available and you will have all screen resolutions available,
but it might fail on other display devices.

If you get a blank screen or strange refresh values, add # in front of the marked line to disable
this behaviour, so the nvidia driver will still read out sane resolutions.

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
EndSection

##
## Server Flags (Don't zap false allows you to re-active CTRL+ALT+Backspace via xset)
##
Section "ServerFlags"
Option "DontZap" "false"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "/usr/share/fonts/local"
FontPath "/usr/share/fonts/misc"
FontPath "/usr/share/fonts/Type1"
FontPath "/usr/share/fonts/TTF"
FontPath "/usr/share/fonts/75dpi"
FontPath "/usr/share/fonts/100dpi"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Built in Monitor with power saving features enabled
## and manually specified frequencies as the EDID is a bit broken
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
Option "DPMS"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
## Read the Appendix B of the nvidia README for explanations
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 140M"

# bus options (disable agp and specify the bus ID (pci-e)
Option "NvAGP" "0"
BusID "PCI:1:0:0"

# do not use the frequencies provided by the monitor edid
Option "UseEdidFreqs" "false"

# Allows the driver to enable VBlank interrupt generation only when it is required
# Saves power, as there are less wakeups
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# speed up 2d by actiavting the RENDER extension (default by now) and using
# DAMAGE to only update regions of the screen which actually changed.
# Also activating BackingStore which keeps pixel data for occluded window regions
# and activating TripleBuffer. ARGBGLXVisuals are now enabled by default
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "AllowIndirectPixmaps" "true"
Option "AddARGBGLXVisuals" "True"

# If some applications (e.g. xchat) need SHM Pixmaps then remove this line
Option "AllowSHMPixmaps" "False"
EndSection

##
## Screen Section
##
Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load composite for compiz (should be default by now)
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

== Unstable Kernels and updates ==

=== 2.6.27 ===

Recently, 2.6.27 gentoo hit portage.
There are several imporant changes.

My kernel config is [http://www.fuchsnet.ch/files/tp/config-2.6.27-gentoo here], the hdaps patch is [http://www.fuchsnet.ch/files/tp/hdaps-2.6.27.patch here]. Please note that you need a recent hdpasd to work with this new version.

Intels Wifi module is now split up and named iwlagn and iwlcore.

Suspend and Hibernate work without Tux on Ice kernels. (Just be patient with hibernate, you'll get a black screen for a while before it comes back up)

You also need a recent nvidia driver to work with the new kernel.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-10-13T21:45:04Z

Fuchs: /* Unstable Kernels and updates */ 2.6.27

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebuffer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Performance of the card depends heavy on powermizer
and some nvidia settings.

I recommend you read my [[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#xorg.conf|Xorg.conf]],
put the following settings in an autostart

nvidia-settings -a InitialPixmapPlacement=2 -a GlyphCache=1 &

and use this script:

<pre>
while true; do

powerstate=`cat /proc/acpi/ac_adapter/AC/state | awk '{print $2}'`

if [ $powerstate = "on-line" ]; then
nvidia-settings -q all > /dev/null
fi
sleep 25;
done
</pre>

which forces powermizer to stay on level 2 while your thinkpad is on AC power, not battery.
(You can remove the if to keep it on level 2 even on battery, but this consume more power)

I recommend to get the nvidia driver 177.68 or newer, as some major RENDER improvements increased the speed, especially with Qt4 and KDE4, dramatically.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 [[dynticks]] are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

You also might want to change the keyboard layout.

'
Note: in this configuration here nvidia wont read out
sane refresh and sync values out of your flat panel.

In this configuration the modes given don't affect
the modes available and you will have all screen resolutions available,
but it might fail on other display devices.

If you get a blank screen or strange refresh values, add # in front of the marked line to disable
this behaviour, so the nvidia driver will still read out sane resolutions.

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Touchpad" "CorePointer"
InputDevice "LX8" "SendCoreEvents"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "unix/:-1"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Keyboard section, layout is swissgerman
##
Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc105"
Option "XkbLayout" "ch"
EndSection

##
## Touchpad section, values can be changed with synclient on the fly,
## as SHMConfig and UseSHM allow this
##
Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

##
## External Logitech LX8 Mouse
##
Section "InputDevice"
Identifier "LX8"
Driver "evdev"
Option "CorePointer"
Option "Name" "Logitech USB Receiver"
Option "Buttons" "9"
Option "ZAxisMapping" "4 5 6 7"
Option "HWHEELRelativeAxisButtons" "7 6"
Option "Resolution" "1600"
EndSection

##
## Built in Monitor with power saving features enabled
## and manually specified frequencies as the EDID is a bit broken
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
Option "DPMS"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
## Read the Appendix B of the nvidia README for explanations
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 140M"

# bus options (disable agp and specify the bus ID (pci-e)
Option "NvAGP" "0"
BusID "PCI:1:0:0"

# do not use the frequencies provided by the monitor edid
Option "UseEdidFreqs" "false"

# Allows the driver to enable VBlank interrupt generation only when it is required
# Saves power, as there are less wakeups
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# speed up 2d by actiavting the RENDER extension (default by now) and using
# DAMAGE to only update regions of the screen which actually changed.
# Also activating BackingStore which keeps pixel data for occluded window regions
# and activating TripleBuffer. ARGBGLXVisuals are now enabled by default
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "AllowIndirectPixmaps" "true"
Option "AddARGBGLXVisuals" "True"

# pixmap speedups since 177.* driver version
# this will reserve about 5 MB of video memory for pixmaps
# If some applications (e.g. xchat) need SHM Pixmaps then remove the second line
# Set InitialPixmapPlacement to 2 and GlyphCache to 1 for massive performance gains
Option "PixmapCacheSize" "1000000"
Option "AllowSHMPixmaps" "False"
EndSection

##
## Screen Section
##
Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load composite for compiz (should be default by now)
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

##
## DRI Section, deprecated
##
Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

== Unstable Kernels and updates ==

=== 2.6.27 ===

Recently, 2.6.27 gentoo hit portage.
There are several imporant changes.

My kernel config is [http://www.fuchsnet.ch/files/tp/config-2.6.27-gentoo here], the hdaps patch is [http://www.fuchsnet.ch/files/tp/hdaps-2.6.27.patch here]. Please note that you need a recent hdpasd to work with this new version.

Intels Wifi module is now split up and named iwlagn and iwlcore.

Suspend and Hibernate work without Tux on Ice kernels. (Just be patient with hibernate, you'll get a black screen for a while before it comes back up)

You also need a recent nvidia driver to work with the new kernel.

=== 2.6.25 ===

Recently, 2.6.25-tuxonice hit portage, ~masked.
If you'd like to to update there are several important changes.

1) you'll need two new hdaps patches, [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-1.diff here] and [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-2.diff here].

2) you might want to patch iwlwifi to the newest version, with working LEDs.
A patch can be found [http://www.fuchsnet.ch/files/tp/linux-2.6.25-iwl-merge.patch.bz2 here], original from [http://www.intellinuxwireless.org/bugzilla/show_bug.cgi?id=1209 here]

Please note: I can't guarantee that the patches above will work,
nor I can guarantee that they don't screw your system.
They work fine here, but might not on your computer.
I am not responsible for whatever happens when you use them.

Those patches can be applied with patch -p1 < $patchname in your linux directory.
Please note that in kernel ALSA should be used, as 1.0.16 (which is in kernel)
fails to compile.

3) The nvidia drivers in portage do _not_ work with 2.6.25.
You either have to install 173.08 (beta at the moment)
or patch the older ones, as described [http://www.nvnews.net/vbulletin/showthread.php?t=110088 here]

There will be a NVRAM warning in dmesg on x86_64, which, according to nvidia, can safely be ignored
or removed by using [http://www.nvnews.net/vbulletin/showpost.php?p=1639413&postcount=11 this patch]

My 2.6.25 kernel config is
[http://www.fuchsnet.ch/files/tp/config-2.6.25-ice-wl here] (for tuxonice and wireless patched)

Use at own risk, and note that I use ext3 as filesystem and ahci for the hdd.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-09-29T17:37:55Z

Fuchs: /* xorg.conf */

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebuffer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Performance of the card depends heavy on powermizer
and some nvidia settings.

I recommend you read my [[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#xorg.conf|Xorg.conf]],
put the following settings in an autostart

nvidia-settings -a InitialPixmapPlacement=2 -a GlyphCache=1 &

and use this script:

<pre>
while true; do

powerstate=`cat /proc/acpi/ac_adapter/AC/state | awk '{print $2}'`

if [ $powerstate = "on-line" ]; then
nvidia-settings -q all > /dev/null
fi
sleep 25;
done
</pre>

which forces powermizer to stay on level 2 while your thinkpad is on AC power, not battery.
(You can remove the if to keep it on level 2 even on battery, but this consume more power)

I recommend to get the nvidia driver 177.68 or newer, as some major RENDER improvements increased the speed, especially with Qt4 and KDE4, dramatically.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 [[dynticks]] are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

You also might want to change the keyboard layout.

'
Note: in this configuration here nvidia wont read out
sane refresh and sync values out of your flat panel.

In this configuration the modes given don't affect
the modes available and you will have all screen resolutions available,
but it might fail on other display devices.

If you get a blank screen or strange refresh values, add # in front of the marked line to disable
this behaviour, so the nvidia driver will still read out sane resolutions.

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Touchpad" "CorePointer"
InputDevice "LX8" "SendCoreEvents"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "unix/:-1"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Keyboard section, layout is swissgerman
##
Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc105"
Option "XkbLayout" "ch"
EndSection

##
## Touchpad section, values can be changed with synclient on the fly,
## as SHMConfig and UseSHM allow this
##
Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

##
## External Logitech LX8 Mouse
##
Section "InputDevice"
Identifier "LX8"
Driver "evdev"
Option "CorePointer"
Option "Name" "Logitech USB Receiver"
Option "Buttons" "9"
Option "ZAxisMapping" "4 5 6 7"
Option "HWHEELRelativeAxisButtons" "7 6"
Option "Resolution" "1600"
EndSection

##
## Built in Monitor with power saving features enabled
## and manually specified frequencies as the EDID is a bit broken
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
Option "DPMS"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
## Read the Appendix B of the nvidia README for explanations
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 140M"

# bus options (disable agp and specify the bus ID (pci-e)
Option "NvAGP" "0"
BusID "PCI:1:0:0"

# do not use the frequencies provided by the monitor edid
Option "UseEdidFreqs" "false"

# Allows the driver to enable VBlank interrupt generation only when it is required
# Saves power, as there are less wakeups
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# speed up 2d by actiavting the RENDER extension (default by now) and using
# DAMAGE to only update regions of the screen which actually changed.
# Also activating BackingStore which keeps pixel data for occluded window regions
# and activating TripleBuffer. ARGBGLXVisuals are now enabled by default
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "AllowIndirectPixmaps" "true"
Option "AddARGBGLXVisuals" "True"

# pixmap speedups since 177.* driver version
# this will reserve about 5 MB of video memory for pixmaps
# If some applications (e.g. xchat) need SHM Pixmaps then remove the second line
# Set InitialPixmapPlacement to 2 and GlyphCache to 1 for massive performance gains
Option "PixmapCacheSize" "1000000"
Option "AllowSHMPixmaps" "False"
EndSection

##
## Screen Section
##
Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load composite for compiz (should be default by now)
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

##
## DRI Section, deprecated
##
Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

== Unstable Kernels and updates ==

Recently, 2.6.25-tuxonice hit portage, ~masked.
If you'd like to to update there are several important changes.

1) you'll need two new hdaps patches, [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-1.diff here] and [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-2.diff here].

2) you might want to patch iwlwifi to the newest version, with working LEDs.
A patch can be found [http://www.fuchsnet.ch/files/tp/linux-2.6.25-iwl-merge.patch.bz2 here], original from [http://www.intellinuxwireless.org/bugzilla/show_bug.cgi?id=1209 here]

Please note: I can't guarantee that the patches above will work,
nor I can guarantee that they don't screw your system.
They work fine here, but might not on your computer.
I am not responsible for whatever happens when you use them.

Those patches can be applied with patch -p1 < $patchname in your linux directory.
Please note that in kernel ALSA should be used, as 1.0.16 (which is in kernel)
fails to compile.

3) The nvidia drivers in portage do _not_ work with 2.6.25.
You either have to install 173.08 (beta at the moment)
or patch the older ones, as described [http://www.nvnews.net/vbulletin/showthread.php?t=110088 here]

There will be a NVRAM warning in dmesg on x86_64, which, according to nvidia, can safely be ignored
or removed by using [http://www.nvnews.net/vbulletin/showpost.php?p=1639413&postcount=11 this patch]

My 2.6.25 kernel config is
[http://www.fuchsnet.ch/files/tp/config-2.6.25-ice-wl here] (for tuxonice and wireless patched)

Use at own risk, and note that I use ext3 as filesystem and ahci for the hdd.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-09-29T17:35:29Z

Fuchs: /* xorg.conf */

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebuffer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Performance of the card depends heavy on powermizer
and some nvidia settings.

I recommend you read my [[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#xorg.conf|Xorg.conf]],
put the following settings in an autostart

nvidia-settings -a InitialPixmapPlacement=2 -a GlyphCache=1 &

and use this script:

<pre>
while true; do

powerstate=`cat /proc/acpi/ac_adapter/AC/state | awk '{print $2}'`

if [ $powerstate = "on-line" ]; then
nvidia-settings -q all > /dev/null
fi
sleep 25;
done
</pre>

which forces powermizer to stay on level 2 while your thinkpad is on AC power, not battery.
(You can remove the if to keep it on level 2 even on battery, but this consume more power)

I recommend to get the nvidia driver 177.68 or newer, as some major RENDER improvements increased the speed, especially with Qt4 and KDE4, dramatically.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 [[dynticks]] are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

You also might want to change the keyboard layout.

'
Note: in this configuration here nvidia wont read out
sane refresh and sync values out of your flat panel.

In this configuration the modes given don't affect
the modes available and you will have all screen resolutions available,
but it might fail on other display devices.

If you get a blank screen or strange refresh values, add # in front of the marked line to disable
this behaviour, so the nvidia driver will still read out sane resolutions.

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Touchpad" "CorePointer"
InputDevice "LX8" "SendCoreEvents"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "unix/:-1"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Keyboard section, layout is swissgerman
##
Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc105"
Option "XkbLayout" "ch"
EndSection

##
## Touchpad section, values can be changed with synclient on the fly,
## as SHMConfig and UseSHM allow this
##
Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

##
## External Logitech LX8 Mouse
##
Section "InputDevice"
Identifier "LX8"
Driver "evdev"
Option "CorePointer"
Option "Name" "Logitech USB Receiver"
Option "Buttons" "9"
Option "ZAxisMapping" "4 5 6 7"
Option "HWHEELRelativeAxisButtons" "7 6"
Option "Resolution" "1600"
EndSection

##
## Built in Monitor with power saving features enabled
## and manually specified frequencies as the EDID is a bit broken
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
Option "DPMS"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
## Read the Appendix B of the nvidia README for explanations
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 140M"

# bus options (disable agp and specify the bus ID (pci-e)
Option "NvAGP" "0"
BusID "PCI:1:0:0"

# do not use the frequencies provided by the monitor edid
Option "UseEdidFreqs" "false"

# Allows the driver to enable VBlank interrupt generation only when it is required
# Saves power, as there are less wakeups
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# speed up 2d by actiavting the RENDER extension and using
# DAMAGE to only update regions of the screen which actually changed.
# Also activating BackingStore which keeps pixel data for occluded window regions
# and activating TripleBuffer. ARGBGLXVisuals are now enabled by default
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "AllowIndirectPixmaps" "true"
Option "AddARGBGLXVisuals" "True"

# pixmap speedups since 177.* driver version
# this will reserve about 5 MB of video memory for pixmaps
# If some applications (e.g. xchat) need SHM Pixmaps then remove the second line
# Set InitialPixmapPlacement to 2 and GlyphCache to 1 for massive performance gains
Option "PixmapCacheSize" "1000000"
Option "AllowSHMPixmaps" "False"
EndSection

##
## Screen Section
##
Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load composite for compiz (should be default by now)
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

##
## DRI Section, deprecated
##
Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

== Unstable Kernels and updates ==

Recently, 2.6.25-tuxonice hit portage, ~masked.
If you'd like to to update there are several important changes.

1) you'll need two new hdaps patches, [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-1.diff here] and [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-2.diff here].

2) you might want to patch iwlwifi to the newest version, with working LEDs.
A patch can be found [http://www.fuchsnet.ch/files/tp/linux-2.6.25-iwl-merge.patch.bz2 here], original from [http://www.intellinuxwireless.org/bugzilla/show_bug.cgi?id=1209 here]

Please note: I can't guarantee that the patches above will work,
nor I can guarantee that they don't screw your system.
They work fine here, but might not on your computer.
I am not responsible for whatever happens when you use them.

Those patches can be applied with patch -p1 < $patchname in your linux directory.
Please note that in kernel ALSA should be used, as 1.0.16 (which is in kernel)
fails to compile.

3) The nvidia drivers in portage do _not_ work with 2.6.25.
You either have to install 173.08 (beta at the moment)
or patch the older ones, as described [http://www.nvnews.net/vbulletin/showthread.php?t=110088 here]

There will be a NVRAM warning in dmesg on x86_64, which, according to nvidia, can safely be ignored
or removed by using [http://www.nvnews.net/vbulletin/showpost.php?p=1639413&postcount=11 this patch]

My 2.6.25 kernel config is
[http://www.fuchsnet.ch/files/tp/config-2.6.25-ice-wl here] (for tuxonice and wireless patched)

Use at own risk, and note that I use ext3 as filesystem and ahci for the hdd.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-08-22T18:47:45Z

Fuchs: /* xorg.conf */ more minor fixes

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebuffer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Performance of the card depends heavy on powermizer
and some nvidia settings.

I recommend you read my [[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#xorg.conf|Xorg.conf]],
put the following settings in an autostart

nvidia-settings -a InitialPixmapPlacement=2 -a GlyphCache=1 &

and use this script:

<pre>
while true; do

powerstate=`cat /proc/acpi/ac_adapter/AC/state | awk '{print $2}'`

if [ $powerstate = "on-line" ]; then
nvidia-settings -q all > /dev/null
fi
sleep 25;
done
</pre>

which forces powermizer to stay on level 2 while your thinkpad is on AC power, not battery.
(You can remove the if to keep it on level 2 even on battery, but this consume more power)

I recommend to get the nvidia driver 177.68 or newer, as some major RENDER improvements increased the speed, especially with Qt4 and KDE4, dramatically.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 [[dynticks]] are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

You also might want to change the keyboard layout.

'
Note: in this configuration here nvidia wont read out
sane refresh and sync values out of your flat panel.

In this configuration the modes given don't affect
the modes available and you will have all screen resolutions available,
but it might fail on other display devices.

If you get a blank screen or strange refresh values, add # in front of the marked line to disable
this behaviour, so the nvidia driver will still read out sane resolutions.

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Touchpad" "CorePointer"
InputDevice "LX8" "SendCoreEvents"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "unix/:-1"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Keyboard section, layout is swissgerman
##
Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc105"
Option "XkbLayout" "ch"
EndSection

##
## Touchpad section, values can be changed with synclient on the fly,
## as SHMConfig and UseSHM allow this
##
Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

##
## External Logitech LX8 Mouse
##
Section "InputDevice"
Identifier "LX8"
Driver "evdev"
Option "CorePointer"
Option "Name" "Logitech USB Receiver"
Option "Buttons" "9"
Option "ZAxisMapping" "4 5 6 7"
Option "HWHEELRelativeAxisButtons" "7 6"
Option "Resolution" "1600"
EndSection

##
## Built in Monitor with power saving features enabled
## and manually specified frequencies as the EDID is a bit broken
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
Option "DPMS"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
## Read the Appendix B of the nvidia README for explanations
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 140M"

# bus options (disable agp and specify the bus ID (pci-e)
Option "NvAGP" "0"
BusID "PCI:1:0:0"

# do not use the frequencies provided by the monitor edid
Option "UseEdidFreqs" "false"

# power savings
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# speed up 2d by actiavting the RENDER extension and using
# DAMAGE to only update regions of the screen which actually changed.
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "AllowIndirectPixmaps" "true"
Option "AddARGBGLXVisuals" "True"

# pixmap speedups since 177.* driver version
# this will reserve about 5 MB of video memory for pixmaps
# If some applications (e.g. xchat) need SHM Pixmaps then remove the second line
# Set InitialPixmapPlacement to 2 and GlyphCache to 1 for massive performance gains
Option "PixmapCacheSize" "1000000"
Option "AllowSHMPixmaps" "False"
EndSection

##
## Screen Section
##
Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load composite for compiz (should be default by now)
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

##
## DRI Section, deprecated
##
Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

== Unstable Kernels and updates ==

Recently, 2.6.25-tuxonice hit portage, ~masked.
If you'd like to to update there are several important changes.

1) you'll need two new hdaps patches, [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-1.diff here] and [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-2.diff here].

2) you might want to patch iwlwifi to the newest version, with working LEDs.
A patch can be found [http://www.fuchsnet.ch/files/tp/linux-2.6.25-iwl-merge.patch.bz2 here], original from [http://www.intellinuxwireless.org/bugzilla/show_bug.cgi?id=1209 here]

Please note: I can't guarantee that the patches above will work,
nor I can guarantee that they don't screw your system.
They work fine here, but might not on your computer.
I am not responsible for whatever happens when you use them.

Those patches can be applied with patch -p1 < $patchname in your linux directory.
Please note that in kernel ALSA should be used, as 1.0.16 (which is in kernel)
fails to compile.

3) The nvidia drivers in portage do _not_ work with 2.6.25.
You either have to install 173.08 (beta at the moment)
or patch the older ones, as described [http://www.nvnews.net/vbulletin/showthread.php?t=110088 here]

There will be a NVRAM warning in dmesg on x86_64, which, according to nvidia, can safely be ignored
or removed by using [http://www.nvnews.net/vbulletin/showpost.php?p=1639413&postcount=11 this patch]

My 2.6.25 kernel config is
[http://www.fuchsnet.ch/files/tp/config-2.6.25-ice-wl here] (for tuxonice and wireless patched)

Use at own risk, and note that I use ext3 as filesystem and ahci for the hdd.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-08-22T18:46:01Z

Fuchs: /* xorg.conf */ fixed copy & paste error

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebuffer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Performance of the card depends heavy on powermizer
and some nvidia settings.

I recommend you read my [[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#xorg.conf|Xorg.conf]],
put the following settings in an autostart

nvidia-settings -a InitialPixmapPlacement=2 -a GlyphCache=1 &

and use this script:

<pre>
while true; do

powerstate=`cat /proc/acpi/ac_adapter/AC/state | awk '{print $2}'`

if [ $powerstate = "on-line" ]; then
nvidia-settings -q all > /dev/null
fi
sleep 25;
done
</pre>

which forces powermizer to stay on level 2 while your thinkpad is on AC power, not battery.
(You can remove the if to keep it on level 2 even on battery, but this consume more power)

I recommend to get the nvidia driver 177.68 or newer, as some major RENDER improvements increased the speed, especially with Qt4 and KDE4, dramatically.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 [[dynticks]] are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

You also might want to change the keyboard layout.

'
Note: in this configuration here nvidia wont read out
sane refresh and sync values out of your flat panel.

In this configuration the modes given don't affect
the modes available and you will have all screen resolutions available,
but it might fail on other display devices.

If you get a blank screen or strange refresh values, add # in front of the marked line to disable
this behaviour, so the nvidia driver will still read out sane resolutions.

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Touchpad" "CorePointer"
InputDevice "LX8" "SendCoreEvents"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "unix/:-1"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Keyboard section, layout is swissgerman
##
Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc105"
Option "XkbLayout" "ch"
EndSection

##
## Touchpad section, values can be changed with synclient on the fly,
## as SHMConfig and UseSHM allow this
##
Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

##
## External Logitech LX8 Mouse
##
Section "InputDevice"
Identifier "LX8"
Driver "evdev"
Option "CorePointer"
Option "Name" "Logitech USB Receiver"
Option "Buttons" "9"
Option "ZAxisMapping" "4 5 6 7"
Option "HWHEELRelativeAxisButtons" "7 6"
Option "Resolution" "1600"
EndSection

##
## Built in Monitor with power saving features enabled
## and manually specified frequencies as the EDID is a bit broken
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
Option "DPMS"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
## Read the Appendix B of the nvidia README for explanations
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 140M"

# bus options (disable agp and specify the bus ID (pci-e)
Option "NvAGP" "0"
BusID "PCI:1:0:0"

# do not use the frequencies provided by the monitor edid
Option "UseEdidFreqs" "false"

# power savings
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# speed up 2d by actiavting the RENDER extension and using
# DAMAGE to only update regions of the screen which actually changed.
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "AllowIndirectPixmaps" "true"
Option "AddARGBGLXVisuals" "True"

# pixmap speedups since 177.* driver version
# this will reserve about 5 MB of video memory for pixmaps
# If some applications (e.g. xchat) need SHM Pixmaps then remove the second line
# Set InitialPixmapPlacement to 2 and GlyphCache to 1 for massive performance gains
Option "PixmapCacheSize" "1000000"
Option "AllowSHMPixmaps" "False"
EndSection

##
## Screen Section
##
Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load compisite for compiz
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

##
## DRI Section, deprecated
##
Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

== Unstable Kernels and updates ==

Recently, 2.6.25-tuxonice hit portage, ~masked.
If you'd like to to update there are several important changes.

1) you'll need two new hdaps patches, [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-1.diff here] and [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-2.diff here].

2) you might want to patch iwlwifi to the newest version, with working LEDs.
A patch can be found [http://www.fuchsnet.ch/files/tp/linux-2.6.25-iwl-merge.patch.bz2 here], original from [http://www.intellinuxwireless.org/bugzilla/show_bug.cgi?id=1209 here]

Please note: I can't guarantee that the patches above will work,
nor I can guarantee that they don't screw your system.
They work fine here, but might not on your computer.
I am not responsible for whatever happens when you use them.

Those patches can be applied with patch -p1 < $patchname in your linux directory.
Please note that in kernel ALSA should be used, as 1.0.16 (which is in kernel)
fails to compile.

3) The nvidia drivers in portage do _not_ work with 2.6.25.
You either have to install 173.08 (beta at the moment)
or patch the older ones, as described [http://www.nvnews.net/vbulletin/showthread.php?t=110088 here]

There will be a NVRAM warning in dmesg on x86_64, which, according to nvidia, can safely be ignored
or removed by using [http://www.nvnews.net/vbulletin/showpost.php?p=1639413&postcount=11 this patch]

My 2.6.25 kernel config is
[http://www.fuchsnet.ch/files/tp/config-2.6.25-ice-wl here] (for tuxonice and wireless patched)

Use at own risk, and note that I use ext3 as filesystem and ahci for the hdd.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-08-22T18:13:54Z

Fuchs: /* xorg.conf */ update

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebuffer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Performance of the card depends heavy on powermizer
and some nvidia settings.

I recommend you read my [[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#xorg.conf|Xorg.conf]],
put the following settings in an autostart

nvidia-settings -a InitialPixmapPlacement=2 -a GlyphCache=1 &

and use this script:

<pre>
while true; do

powerstate=`cat /proc/acpi/ac_adapter/AC/state | awk '{print $2}'`

if [ $powerstate = "on-line" ]; then
nvidia-settings -q all > /dev/null
fi
sleep 25;
done
</pre>

which forces powermizer to stay on level 2 while your thinkpad is on AC power, not battery.
(You can remove the if to keep it on level 2 even on battery, but this consume more power)

I recommend to get the nvidia driver 177.68 or newer, as some major RENDER improvements increased the speed, especially with Qt4 and KDE4, dramatically.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 [[dynticks]] are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

You also might want to change the keyboard layout.

'
Note: in this configuration here nvidia wont read out
sane refresh and sync values out of your flat panel.

In this configuration the modes given don't affect
the modes available and you will have all screen resolutions available,
but it might fail on other display devices.

If you get a blank screen or strange refresh values, add # in front of the marked line to disable
this behaviour, so the nvidia driver will still read out sane resolutions.

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Touchpad" "CorePointer"
InputDevice "LX8" "SendCoreEvents"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "unix/:-1"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Keyboard section, layout is swissgerman
##
Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc105"
Option "XkbLayout" "ch"
EndSection

##
## Touchpad section, values can be changed with synclient on the fly,
## as SHMConfig and UseSHM allow this
##
Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

##
## External Logitech LX8 Mouse
##
Section "InputDevice"
Identifier "LX8"
Driver "evdev"
Option "CorePointer"
Option "Name" "Logitech USB Receiver"
Option "Buttons" "9"
Option "ZAxisMapping" "4 5 6 7"
Option "HWHEELRelativeAxisButtons" "7 6"
Option "Resolution" "1600"
EndSection

##
## Built in Monitor with power saving features enabled
## and manually specified frequencies as the EDID is a bit broken
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
Option "DPMS"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
## Read the Appendix B of the nvidia README for explanations
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 140M"

# bus options (disable agp and specify the bus ID (pci-e)
Option "NvAGP" "0"
BusID "PCI:1:0:0"

# do not use the frequencies provided by the monitor edid
Option "UseEdidFreqs" "false"

# power savings
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# speed up 2d by actiavting the RENDER extension and using
# DAMAGE to only update regions of the screen which actually changed.
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "AllowIndirectPixmaps" "true"
Option "AddARGBGLXVisuals" "True"

# pixmap speedups since 177.* driver version
# this will reserve about 5 MB of video memory for pixmaps
# If some applications (e.g. xchat) need SHM Pixmaps then remove the second line
# Set InitialPixmapPlacement to 2 and GlyphCache to 1 for massive performance gains
Option "PixmapCacheSize" "1000000"
Option "AllowSHMPixmaps" "False"
EndSection

##
## Screen Section
##
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load compisite for compiz
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

##
## DRI Section, deprecated
##
Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

== Unstable Kernels and updates ==

Recently, 2.6.25-tuxonice hit portage, ~masked.
If you'd like to to update there are several important changes.

1) you'll need two new hdaps patches, [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-1.diff here] and [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-2.diff here].

2) you might want to patch iwlwifi to the newest version, with working LEDs.
A patch can be found [http://www.fuchsnet.ch/files/tp/linux-2.6.25-iwl-merge.patch.bz2 here], original from [http://www.intellinuxwireless.org/bugzilla/show_bug.cgi?id=1209 here]

Please note: I can't guarantee that the patches above will work,
nor I can guarantee that they don't screw your system.
They work fine here, but might not on your computer.
I am not responsible for whatever happens when you use them.

Those patches can be applied with patch -p1 < $patchname in your linux directory.
Please note that in kernel ALSA should be used, as 1.0.16 (which is in kernel)
fails to compile.

3) The nvidia drivers in portage do _not_ work with 2.6.25.
You either have to install 173.08 (beta at the moment)
or patch the older ones, as described [http://www.nvnews.net/vbulletin/showthread.php?t=110088 here]

There will be a NVRAM warning in dmesg on x86_64, which, according to nvidia, can safely be ignored
or removed by using [http://www.nvnews.net/vbulletin/showpost.php?p=1639413&postcount=11 this patch]

My 2.6.25 kernel config is
[http://www.fuchsnet.ch/files/tp/config-2.6.25-ice-wl here] (for tuxonice and wireless patched)

Use at own risk, and note that I use ext3 as filesystem and ahci for the hdd.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-08-22T18:12:22Z

Fuchs: /* Graphics: NVIDIA Quadro NVS 140M */ update

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebuffer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Performance of the card depends heavy on powermizer
and some nvidia settings.

I recommend you read my [[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#xorg.conf|Xorg.conf]],
put the following settings in an autostart

nvidia-settings -a InitialPixmapPlacement=2 -a GlyphCache=1 &

and use this script:

<pre>
while true; do

powerstate=`cat /proc/acpi/ac_adapter/AC/state | awk '{print $2}'`

if [ $powerstate = "on-line" ]; then
nvidia-settings -q all > /dev/null
fi
sleep 25;
done
</pre>

which forces powermizer to stay on level 2 while your thinkpad is on AC power, not battery.
(You can remove the if to keep it on level 2 even on battery, but this consume more power)

I recommend to get the nvidia driver 177.68 or newer, as some major RENDER improvements increased the speed, especially with Qt4 and KDE4, dramatically.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 [[dynticks]] are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

You also might want to change the keyboard layout.

'
Note: in this configuration here nvidia wont read out
sane refresh and sync values out of your flat panel.

In this configuration the modes given don't affect
the modes available and you will have all screen resolutions available,
but it might fail on other display devices.

If you get a blank screen or strange refresh values, add # in front of the marked line to disable
this behaviour, so the nvidia driver will still read out sane resolutions.

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Touchpad" "CorePointer"
InputDevice "LX8" "SendCoreEvents"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "unix/:-1"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Keyboard section, layout is swissgerman
##
Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc105"
Option "XkbLayout" "ch"
EndSection

##
## Touchpad section, values can be changed with synclient on the fly,
## as SHMConfig and UseSHM allow this
##
Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

##
## External Logitech LX8 Mouse
##
Section "InputDevice"
Identifier "LX8"
Driver "evdev"
Option "CorePointer"
Option "Name" "Logitech USB Receiver"
Option "Buttons" "9"
Option "ZAxisMapping" "4 5 6 7"
Option "HWHEELRelativeAxisButtons" "7 6"
Option "Resolution" "1600"
EndSection

##
## Built in Monitor with power saving features enabled
## and manually specified frequencies as the EDID is a bit broken
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
Option "DPMS"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 140M"

# bus options (disable agp and specify the bus ID (pci-e)
Option "NvAGP" "0"
BusID "PCI:1:0:0"

# do not use the frequencies provided by the monitor edid
Option "UseEdidFreqs" "false"

# power savings
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# speed up 2d by actiavting the RENDER extension and using
# DAMAGE to only update regions of the screen which actually changed.
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "AllowIndirectPixmaps" "true"
Option "AddARGBGLXVisuals" "True"

# pixmap speedups since 177.* driver version
# this will reserve about 5 MB of video memory for pixmaps
# If some applications (e.g. xchat) need SHM Pixmaps then remove the second line
Option "PixmapCacheSize" "1000000"
Option "AllowSHMPixmaps" "False"
EndSection

##
## Screen Section
##
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load compisite for compiz
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

##
## DRI Section, deprecated
##
Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

== Unstable Kernels and updates ==

Recently, 2.6.25-tuxonice hit portage, ~masked.
If you'd like to to update there are several important changes.

1) you'll need two new hdaps patches, [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-1.diff here] and [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-2.diff here].

2) you might want to patch iwlwifi to the newest version, with working LEDs.
A patch can be found [http://www.fuchsnet.ch/files/tp/linux-2.6.25-iwl-merge.patch.bz2 here], original from [http://www.intellinuxwireless.org/bugzilla/show_bug.cgi?id=1209 here]

Please note: I can't guarantee that the patches above will work,
nor I can guarantee that they don't screw your system.
They work fine here, but might not on your computer.
I am not responsible for whatever happens when you use them.

Those patches can be applied with patch -p1 < $patchname in your linux directory.
Please note that in kernel ALSA should be used, as 1.0.16 (which is in kernel)
fails to compile.

3) The nvidia drivers in portage do _not_ work with 2.6.25.
You either have to install 173.08 (beta at the moment)
or patch the older ones, as described [http://www.nvnews.net/vbulletin/showthread.php?t=110088 here]

There will be a NVRAM warning in dmesg on x86_64, which, according to nvidia, can safely be ignored
or removed by using [http://www.nvnews.net/vbulletin/showpost.php?p=1639413&postcount=11 this patch]

My 2.6.25 kernel config is
[http://www.fuchsnet.ch/files/tp/config-2.6.25-ice-wl here] (for tuxonice and wireless patched)

Use at own risk, and note that I use ext3 as filesystem and ahci for the hdd.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-08-22T18:10:05Z

Fuchs: /* xorg.conf */ update

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebuffer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

Performance of the card depends heavy on powermizer
and some nvidia settings.

I recommend you read my [[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#xorg.conf|Xorg.conf]],
put the following settings in an autostart

nvidia-settings -a InitialPixmapPlacement=1 -a GlyphCache=1 &

and use this script:

<pre>
while true; do

powerstate=`cat /proc/acpi/ac_adapter/AC/state | awk '{print $2}'`

if [ $powerstate = "on-line" ]; then
nvidia-settings -q all > /dev/null
fi
sleep 25;
done
</pre>

which forces powermizer to stay on level 2 while your thinkpad is on AC power, not battery.
(You can remove the if to keep it on level 2 even on battery, but this consume more power)

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 [[dynticks]] are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

You also might want to change the keyboard layout.

'
Note: in this configuration here nvidia wont read out
sane refresh and sync values out of your flat panel.

In this configuration the modes given don't affect
the modes available and you will have all screen resolutions available,
but it might fail on other display devices.

If you get a blank screen or strange refresh values, add # in front of the marked line to disable
this behaviour, so the nvidia driver will still read out sane resolutions.

<pre>

##
## Server layout for the built in monitor, an external mouse and the touchpad
##
Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Touchpad" "CorePointer"
InputDevice "LX8" "SendCoreEvents"
EndSection

##
## FontPath for the x font server xfs
##
Section "Files"
FontPath "unix/:-1"
EndSection

##
## Module Section, load default modues
##
Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

##
## Keyboard section, layout is swissgerman
##
Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc105"
Option "XkbLayout" "ch"
EndSection

##
## Touchpad section, values can be changed with synclient on the fly,
## as SHMConfig and UseSHM allow this
##
Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

##
## External Logitech LX8 Mouse
##
Section "InputDevice"
Identifier "LX8"
Driver "evdev"
Option "CorePointer"
Option "Name" "Logitech USB Receiver"
Option "Buttons" "9"
Option "ZAxisMapping" "4 5 6 7"
Option "HWHEELRelativeAxisButtons" "7 6"
Option "Resolution" "1600"
EndSection

##
## Built in Monitor with power saving features enabled
## and manually specified frequencies as the EDID is a bit broken
##
Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "LEN"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
Option "DPMS"
EndSection

##
## Videocard section. Some of the following options are now default
## and only kept for compatibility reasons with older drivers
##
Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro NVS 140M"

# bus options (disable agp and specify the bus ID (pci-e)
Option "NvAGP" "0"
BusID "PCI:1:0:0"

# do not use the frequencies provided by the monitor edid
Option "UseEdidFreqs" "false"

# power savings
Option "OnDemandVBlankInterrupts" "true"

# allow underclocking
Option "Coolbits" "1"

# enable the X Resize and Rotation extension
Option "RandRRotation" "true"

# speed up 2d by actiavting the RENDER extension and using
# DAMAGE to only update regions of the screen which actually changed.
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "AllowIndirectPixmaps" "true"
Option "AddARGBGLXVisuals" "True"

# pixmap speedups since 177.* driver version
# this will reserve about 5 MB of video memory for pixmaps
# If some applications (e.g. xchat) need SHM Pixmaps then remove the second line
Option "PixmapCacheSize" "1000000"
Option "AllowSHMPixmaps" "False"
EndSection

##
## Screen Section
##
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

##
## Extensions, load compisite for compiz
##
Section "Extensions"
Option "Composite" "Enable"
EndSection

##
## DRI Section, deprecated
##
Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

== Unstable Kernels and updates ==

Recently, 2.6.25-tuxonice hit portage, ~masked.
If you'd like to to update there are several important changes.

1) you'll need two new hdaps patches, [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-1.diff here] and [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-2.diff here].

2) you might want to patch iwlwifi to the newest version, with working LEDs.
A patch can be found [http://www.fuchsnet.ch/files/tp/linux-2.6.25-iwl-merge.patch.bz2 here], original from [http://www.intellinuxwireless.org/bugzilla/show_bug.cgi?id=1209 here]

Please note: I can't guarantee that the patches above will work,
nor I can guarantee that they don't screw your system.
They work fine here, but might not on your computer.
I am not responsible for whatever happens when you use them.

Those patches can be applied with patch -p1 < $patchname in your linux directory.
Please note that in kernel ALSA should be used, as 1.0.16 (which is in kernel)
fails to compile.

3) The nvidia drivers in portage do _not_ work with 2.6.25.
You either have to install 173.08 (beta at the moment)
or patch the older ones, as described [http://www.nvnews.net/vbulletin/showthread.php?t=110088 here]

There will be a NVRAM warning in dmesg on x86_64, which, according to nvidia, can safely be ignored
or removed by using [http://www.nvnews.net/vbulletin/showpost.php?p=1639413&postcount=11 this patch]

My 2.6.25 kernel config is
[http://www.fuchsnet.ch/files/tp/config-2.6.25-ice-wl here] (for tuxonice and wireless patched)

Use at own risk, and note that I use ext3 as filesystem and ahci for the hdd.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-04-28T12:20:27Z

Fuchs: /* Unstable Kernels and updates */

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

Performance of the card depends heavy on powermizer
and some nvidia settings.

I recommend you read my [[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#xorg.conf|Xorg.conf]],
put the following settings in an autostart

nvidia-settings -a InitialPixmapPlacement=1 -a GlyphCache=1 &

and use this script:

<pre>
while true; do

powerstate=`cat /proc/acpi/ac_adapter/AC/state | awk '{print $2}'`

if [ $powerstate = "on-line" ]; then
nvidia-settings -q all > /dev/null
fi
sleep 25;
done
</pre>

which forces powermizer to stay on level 2 while your thinkpad is on AC power, not battery.
(You can remove the if to keep it on level 2 even on battery, but this consume more power)

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 [[dynticks]] are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

You also might want to change the keyboard layout.

'
Note: in this configuration here nvidia wont read out
sane refresh and sync values out of your flat panel.

In this configuration the modes given don't affect
the modes available and you will have all screen resolutions available,
but it might fail on other display devices.

If you get a blank screen or strange refresh values, add # in front of the marked line to disable
this behaviour, so the nvidia driver will still read out sane resolutions.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

## The following settings can be changed on the fly
## by using synclient. Note that shm has to be enabled for this.
## All options are documented in the synaptics driver documentation.

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "Lenovo R61 Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

## Some of the following options are set by default in newer nvidia drivers
## are are kept for compatibility reasons. Please read the Appendix in the
## README of your current nvidia driver for further information

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA Quadro NVS 140M"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"
Option "NvAGP" "1"

## The following option enables using frequencies not specified in the EDID.
## In this case several additional screen resolutions will be possible.
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

== Unstable Kernels and updates ==

Recently, 2.6.25-tuxonice hit portage, ~masked.
If you'd like to to update there are several important changes.

1) you'll need two new hdaps patches, [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-1.diff here] and [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-2.diff here].

2) you might want to patch iwlwifi to the newest version, with working LEDs.
A patch can be found [http://www.fuchsnet.ch/files/tp/linux-2.6.25-iwl-merge.patch.bz2 here], original from [http://www.intellinuxwireless.org/bugzilla/show_bug.cgi?id=1209 here]

Please note: I can't guarantee that the patches above will work,
nor I can guarantee that they don't screw your system.
They work fine here, but might not on your computer.
I am not responsible for whatever happens when you use them.

Those patches can be applied with patch -p1 < $patchname in your linux directory.
Please note that in kernel ALSA should be used, as 1.0.16 (which is in kernel)
fails to compile.

3) The nvidia drivers in portage do _not_ work with 2.6.25.
You either have to install 173.08 (beta at the moment)
or patch the older ones, as described [http://www.nvnews.net/vbulletin/showthread.php?t=110088 here]

There will be a NVRAM warning in dmesg on x86_64, which, according to nvidia, can safely be ignored
or removed by using [http://www.nvnews.net/vbulletin/showpost.php?p=1639413&postcount=11 this patch]

My 2.6.25 kernel config is
[http://www.fuchsnet.ch/files/tp/config-2.6.25-ice-wl here] (for tuxonice and wireless patched)

Use at own risk, and note that I use ext3 as filesystem and ahci for the hdd.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-04-24T13:21:36Z

Fuchs: /* Unstable Kernels and updates */ nvidia driver

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

Performance of the card depends heavy on powermizer
and some nvidia settings.

I recommend you read my [[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#xorg.conf|Xorg.conf]],
put the following settings in an autostart

nvidia-settings -a InitialPixmapPlacement=1 -a GlyphCache=1 &

and use this script:

<pre>
while true; do

powerstate=`cat /proc/acpi/ac_adapter/AC/state | awk '{print $2}'`

if [ $powerstate = "on-line" ]; then
nvidia-settings -q all > /dev/null
fi
sleep 25;
done
</pre>

which forces powermizer to stay on level 2 while your thinkpad is on AC power, not battery.
(You can remove the if to keep it on level 2 even on battery, but this consume more power)

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 [[dynticks]] are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

You also might want to change the keyboard layout.

'
Note: in this configuration here nvidia wont read out
sane refresh and sync values out of your flat panel.

In this configuration the modes given don't affect
the modes available and you will have all screen resolutions available,
but it might fail on other display devices.

If you get a blank screen or strange refresh values, add # in front of the marked line to disable
this behaviour, so the nvidia driver will still read out sane resolutions.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

## The following settings can be changed on the fly
## by using synclient. Note that shm has to be enabled for this.
## All options are documented in the synaptics driver documentation.

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "Lenovo R61 Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

## Some of the following options are set by default in newer nvidia drivers
## are are kept for compatibility reasons. Please read the Appendix in the
## README of your current nvidia driver for further information

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA Quadro NVS 140M"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"
Option "NvAGP" "1"

## The following option enables using frequencies not specified in the EDID.
## In this case several additional screen resolutions will be possible.
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

== Unstable Kernels and updates ==

Recently, 2.6.25-tuxonice hit portage, ~masked.
If you'd like to to update there are several important changes.

1) you'll need two new hdaps patches, [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-1.diff here] and [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-2.diff here].

2) you might want to patch iwlwifi to the newest version, with working LEDs.
A patch can be found [http://www.fuchsnet.ch/files/tp/linux-2.6.25-iwl-merge.patch.bz2 here], original from [http://www.intellinuxwireless.org/bugzilla/show_bug.cgi?id=1209 here]

Please note: I can't guarantee that the patches above will work,
nor I can guarantee that they don't screw your system.
They work fine here, but might not on your computer.
I am not responsible for whatever happens when you use them.

Those patches can be applied with patch -p1 < $patchname in your linux directory.
Please note that in kernel ALSA should be used, as 1.0.16 (which is in kernel)
fails to compile.

3) The nvidia drivers in portage do _not_ work with 2.6.25.
You either have to install 173.08 (beta at the moment)
or patch the older ones, as described [http://www.nvnews.net/vbulletin/showthread.php?t=110088 here]

There will be a NVRAM warning in dmesg on x86_64, which, according to nvidia, can safely be ignored.

My 2.6.25 kernel config is
[http://www.fuchsnet.ch/files/tp/config-2.6.25-ice-wl here] (for tuxonice and wireless patched)

Use at own risk, and note that I use ext3 as filesystem and ahci for the hdd.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-04-24T13:17:55Z

Fuchs: 2.6.25

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

Performance of the card depends heavy on powermizer
and some nvidia settings.

I recommend you read my [[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#xorg.conf|Xorg.conf]],
put the following settings in an autostart

nvidia-settings -a InitialPixmapPlacement=1 -a GlyphCache=1 &

and use this script:

<pre>
while true; do

powerstate=`cat /proc/acpi/ac_adapter/AC/state | awk '{print $2}'`

if [ $powerstate = "on-line" ]; then
nvidia-settings -q all > /dev/null
fi
sleep 25;
done
</pre>

which forces powermizer to stay on level 2 while your thinkpad is on AC power, not battery.
(You can remove the if to keep it on level 2 even on battery, but this consume more power)

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 [[dynticks]] are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

You also might want to change the keyboard layout.

'
Note: in this configuration here nvidia wont read out
sane refresh and sync values out of your flat panel.

In this configuration the modes given don't affect
the modes available and you will have all screen resolutions available,
but it might fail on other display devices.

If you get a blank screen or strange refresh values, add # in front of the marked line to disable
this behaviour, so the nvidia driver will still read out sane resolutions.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

## The following settings can be changed on the fly
## by using synclient. Note that shm has to be enabled for this.
## All options are documented in the synaptics driver documentation.

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "Lenovo R61 Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

## Some of the following options are set by default in newer nvidia drivers
## are are kept for compatibility reasons. Please read the Appendix in the
## README of your current nvidia driver for further information

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA Quadro NVS 140M"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"
Option "NvAGP" "1"

## The following option enables using frequencies not specified in the EDID.
## In this case several additional screen resolutions will be possible.
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

== Unstable Kernels and updates ==

Recently, 2.6.25-tuxonice hit portage, ~masked.
If you'd like to to update there are several important changes.

1) you'll need two new hdaps patches, [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-1.diff here] and [http://www.fuchsnet.ch/files/tp/hdaps-2.6.25-patch-2.diff here].

2) you might want to patch iwlwifi to the newest version, with working LEDs.
A patch can be found [http://www.fuchsnet.ch/files/tp/linux-2.6.25-iwl-merge.patch.bz2 here], original from [http://www.intellinuxwireless.org/bugzilla/show_bug.cgi?id=1209 here]

Please note: I can't guarantee that the patches above will work,
nor I can guarantee that they don't screw your system.
They work fine here, but might not on your computer.
I am not responsible for whatever happens when you use them.

Those patches can be applied with patch -p1 < $patchname in your linux directory.
Please note that in kernel ALSA should be used, as 1.0.16 (which is in kernel)
fails to compile.

My 2.6.25 kernel config is
[http://www.fuchsnet.ch/files/tp/config-2.6.25-ice-wl here]

Use at own risk, and note that I use ext3 as filesystem and ahci for the hdd.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-04-20T13:04:12Z

Fuchs: /* Graphics: NVIDIA Quadro NVS 140M */ performance

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

Performance of the card depends heavy on powermizer
and some nvidia settings.

I recommend you read my [[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#xorg.conf|Xorg.conf]],
put the following settings in an autostart

nvidia-settings -a InitialPixmapPlacement=1 -a GlyphCache=1 &

and use this script:

<pre>
while true; do

powerstate=`cat /proc/acpi/ac_adapter/AC/state | awk '{print $2}'`

if [ $powerstate = "on-line" ]; then
nvidia-settings -q all > /dev/null
fi
sleep 25;
done
</pre>

which forces powermizer to stay on level 2 while your thinkpad is on AC power, not battery.
(You can remove the if to keep it on level 2 even on battery, but this consume more power)

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 [[dynticks]] are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

You also might want to change the keyboard layout.

'
Note: in this configuration here nvidia wont read out
sane refresh and sync values out of your flat panel.

In this configuration the modes given don't affect
the modes available and you will have all screen resolutions available,
but it might fail on other display devices.

If you get a blank screen or strange refresh values, add # in front of the marked line to disable
this behaviour, so the nvidia driver will still read out sane resolutions.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

## The following settings can be changed on the fly
## by using synclient. Note that shm has to be enabled for this.
## All options are documented in the synaptics driver documentation.

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "Lenovo R61 Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

## Some of the following options are set by default in newer nvidia drivers
## are are kept for compatibility reasons. Please read the Appendix in the
## README of your current nvidia driver for further information

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA Quadro NVS 140M"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"
Option "NvAGP" "1"

## The following option enables using frequencies not specified in the EDID.
## In this case several additional screen resolutions will be possible.
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-28T11:49:26Z

Fuchs: /* xorg.conf */

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

You also might want to change the keyboard layout.

'
Note: in this configuration here nvidia wont read out
sane refresh and sync values out of your flat panel.

In this configuration the modes given don't affect
the modes available and you will have all screen resolutions available,
but it might fail on other display devices.

If you get a blank screen or strange refresh values, add # in front of the marked line to disable
this behaviour, so the nvidia driver will still read out sane resolutions.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

## The following settings can be changed on the fly
## by using synclient. Note that shm has to be enabled for this.
## All options are documented in the synaptics driver documentation.

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Lenovo"
ModelName "Lenovo R61 Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

## Some of the following options are set by default in newer nvidia drivers
## are are kept for compatibility reasons. Please read the Appendix in the
## README of your current nvidia driver for further information

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA Quadro NVS 140M"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"
Option "NvAGP" "1"

## The following option enables using frequencies not specified in the EDID.
## In this case several additional screen resolutions will be possible.
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-26T19:32:13Z

Fuchs: revert, bad idea, even with my modified script which takes a keycode as argument

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

## Some of the following options are set by default in newer nvidia drivers
## are are kept for compatibility reasons. Please read the Appendix in the
## README of your current nvidia driver for further information

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"
Option "NvAGP" "1"

## The following option enables using frequencies not specified in the EDID.
## In this case several additional screen resolutions will be possible.
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-26T19:28:08Z

Fuchs: /* default.sh (acpid) */ adapted on fake keystrokes

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

## Some of the following options are set by default in newer nvidia drivers
## are are kept for compatibility reasons. Please read the Appendix in the
## README of your current nvidia driver for further information

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"
Option "NvAGP" "1"

## The following option enables using frequencies not specified in the EDID.
## In this case several additional screen resolutions will be possible.
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/local/bin/injectkey 220
;;
"HKEY 00000080 00001009")
/usr/local/bin/injectkey 221
;;
"HKEY 00000080 00001014")
/usr/local/bin/injectkey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== Fake keystrokes ===

To create fake keystrokes on ACPI events you can have a look at this article:

[[How to inject fake keystrokes]]

You can use the keystrokes on ACPI events for key combinations
without a X event but an acpi event.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-26T19:26:52Z

Fuchs: /* ACPI Fakekey */ renamed, using thinkwiki fake keystroke app

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

## Some of the following options are set by default in newer nvidia drivers
## are are kept for compatibility reasons. Please read the Appendix in the
## README of your current nvidia driver for further information

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"
Option "NvAGP" "1"

## The following option enables using frequencies not specified in the EDID.
## In this case several additional screen resolutions will be possible.
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== Fake keystrokes ===

To create fake keystrokes on ACPI events you can have a look at this article:

[[How to inject fake keystrokes]]

You can use the keystrokes on ACPI events for key combinations
without a X event but an acpi event.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-24T15:17:30Z

Fuchs: /* xorg.conf */

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

## Some of the following options are set by default in newer nvidia drivers
## are are kept for compatibility reasons. Please read the Appendix in the
## README of your current nvidia driver for further information

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"
Option "NvAGP" "1"

## The following option enables using frequencies not specified in the EDID.
## In this case several additional screen resolutions will be possible.
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-23T16:52:15Z

Fuchs: /* Sound: AD1984 */ version update

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"
Option "NvAGP" "1"

## Comment this out for more resolutions
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-22T20:10:33Z

Fuchs: /* xorg.conf */ nvagp

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16_r2, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"
Option "NvAGP" "1"

## Comment this out for more resolutions
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-22T19:11:24Z

Fuchs: /* Power Management */ renamed to suspend

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16_r2, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Suspend ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"

## Comment this out for more resolutions
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-22T19:10:54Z

Fuchs: /* Power Management */ extra_pages_allowance

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16_r2, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Power Management ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

Note that the extra_pages_allowance might be too low.
In current TuxOnIce versions the option to raise this value
did not work anymore, that's why I put

echo 1000 > /sys/power/tuxonice/extra_pages_allowance

in my local.startup.

You can get the correct value by trying to suspend
without it and reading /var/log/hibernate.log afterwards.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"

## Comment this out for more resolutions
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-22T18:32:17Z

Fuchs: works without acpi-support

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16_r2, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Power Management ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.

This is my /etc/hibernate/common.conf file.
Note that all options not mentioned here are commented (#)

<pre>

Verbosity 0
LogFile /var/log/hibernate.log
LogVerbosity 3
HibernateVT 11
Distribution gentoo
# XDisplay :0

### clock
SaveClock restore-only

### hardware_tweaks
IbmAcpi yes
FullSpeedCPU yes

### modules
# UnloadBlacklistedModules yes
LoadModules auto

### xhacks
SwitchToTextMode yes
UseDummyXServer yes
# DummyXServerConfig xorg-dummy.conf

</pre>

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"

## Comment this out for more resolutions
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-22T17:48:11Z

Fuchs: suspend to disk works

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* Suspend to Disk (Hibernate)
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16_r2, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Power Management ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

Suspend to Disk is more complicated.
Emerge a tux on ice kernel and try the configuration file
linked at the end of this page. Disable intel-agp in the kernel.
Make sure to load the nvidia module with NVreg_NvAGP=1 option.
Emerge acpi-support and disable hibernate-script.
Make sure that in /etc/hibernate/common.conf loading blacklisted
modules is disabled and don't use anything like vbetool.

The machine can now be suspended to disk with the hibernate command.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"

## Comment this out for more resolutions
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 TOI Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-09T18:24:58Z

Fuchs: /* ibm-acpi */ sudo changes

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Suspend to disk (not working out of the box because of nvidia, will test with tux on ice)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16_r2, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Power Management ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

The default file permissions in /proc/acpi/ibm/* do not grant write access for users. I created the group "ibm", added my users to it and now I chown root:ibm and chmod 0774 the files in /proc/acpi/ibm/ on startup. If you don't want to do this you might use sudo sh -c "echo "foo" > /proc/acpi/ibm/whatever", but you need to install sudo and modify your sudoers file.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"

## Comment this out for more resolutions
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-09T18:22:22Z

Fuchs: /* Thinklight */ remove sudo

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Suspend to disk (not working out of the box because of nvidia, will test with tux on ice)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16_r2, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Power Management ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
echo on > /proc/acpi/ibm/light
fi
if [ $1 = "off" ]
then
echo off > /proc/acpi/ibm/light
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
echo off > /proc/acpi/ibm/light
else
echo on > /proc/acpi/ibm/light
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

In the scripts on this page I use sudo to write to /proc/acpi/ibm/*. I prefer another way, I just created a group called ibm and I chown the files in /proc/acpi/ibm/ to root:ibm and chmod to 0774 on startup.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"

## Comment this out for more resolutions
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-09T18:21:48Z

Fuchs: /* Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth */ remove sudo

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Suspend to disk (not working out of the box because of nvidia, will test with tux on ice)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16_r2, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
echo "enable" > /proc/acpi/ibm/bluetooth
;;
enabled)
echo "disable" > /proc/acpi/ibm/bluetooth
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Power Management ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
sudo sh -c "echo on > /proc/acpi/ibm/light"
fi
if [ $1 = "off" ]
then
sudo sh -c "echo off > /proc/acpi/ibm/light"
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
sudo sh -c "echo off > /proc/acpi/ibm/light"
else
sudo sh -c "echo on > /proc/acpi/ibm/light"
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

In the scripts on this page I use sudo to write to /proc/acpi/ibm/*. I prefer another way, I just created a group called ibm and I chown the files in /proc/acpi/ibm/ to root:ibm and chmod to 0774 on startup.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"

## Comment this out for more resolutions
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-09T18:12:38Z

Fuchs: ibm-acpi and minor changes

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Suspend to disk (not working out of the box because of nvidia, will test with tux on ice)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16_r2, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
sudo sh -c "echo "enable" > /proc/acpi/ibm/bluetooth"
;;
enabled)
sudo sh -c "echo "disable" > /proc/acpi/ibm/bluetooth"
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.
Take a look at the ibm-acpi section as well to do this on module load.

== Power Management ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
sudo sh -c "echo on > /proc/acpi/ibm/light"
fi
if [ $1 = "off" ]
then
sudo sh -c "echo off > /proc/acpi/ibm/light"
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
sudo sh -c "echo off > /proc/acpi/ibm/light"
else
sudo sh -c "echo on > /proc/acpi/ibm/light"
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== ibm-acpi ==

I have ibm-acpi configured as a module in my kernel, as I load it with

options thinkpad_acpi hotkey=enable,0xffffffff brightness_enable=1 fan_control=1

to enable brightness controll via /proc/acpi/ibm on newer kernels and fan control.
The hotkey=enable,<mask> option is used instead of writing to /proc/acpi/ibm/hotkey.

In the scripts on this page I use sudo to write to /proc/acpi/ibm/*. I prefer another way, I just created a group called ibm and I chown the files in /proc/acpi/ibm/ to root:ibm and chmod to 0774 on startup.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"

## Comment this out for more resolutions
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-04T11:26:54Z

Fuchs: /* Graphics: NVIDIA Quadro NVS 140M */ update to recent drivers

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Suspend to disk (should work)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19 up to 169.12, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with newer nvidia drivers (>=169.04)
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

Using 169.12 or newer is recommended, as brightness control works there and some powermizer issues, which caused bad perfomance in applications like compiz-fusion, had been fixed.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16_r2, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
sudo sh -c "echo "enable" > /proc/acpi/ibm/bluetooth"
;;
enabled)
sudo sh -c "echo "disable" > /proc/acpi/ibm/bluetooth"
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.

== Power Management ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
sudo sh -c "echo on > /proc/acpi/ibm/light"
fi
if [ $1 = "off" ]
then
sudo sh -c "echo off > /proc/acpi/ibm/light"
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
sudo sh -c "echo off > /proc/acpi/ibm/light"
else
sudo sh -c "echo on > /proc/acpi/ibm/light"
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"

## Comment this out for more resolutions
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

# Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-03-03T22:46:03Z

Fuchs: /* xorg.conf */ missing quotation mark in xorg.conf

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Suspend to disk (should work)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with the new nvidia driver
(169.04) which is a beta driver at the moment.
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16_r2, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
sudo sh -c "echo "enable" > /proc/acpi/ibm/bluetooth"
;;
enabled)
sudo sh -c "echo "disable" > /proc/acpi/ibm/bluetooth"
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.

== Power Management ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
sudo sh -c "echo on > /proc/acpi/ibm/light"
fi
if [ $1 = "off" ]
then
sudo sh -c "echo off > /proc/acpi/ibm/light"
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
sudo sh -c "echo off > /proc/acpi/ibm/light"
else
sudo sh -c "echo on > /proc/acpi/ibm/light"
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true"

## Comment this out for more resolutions
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

# Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-02-28T13:16:53Z

Fuchs: /* Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth */ LED Patch

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Suspend to disk (should work)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with the new nvidia driver
(169.04) which is a beta driver at the moment.
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16_r2, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
sudo sh -c "echo "enable" > /proc/acpi/ibm/bluetooth"
;;
enabled)
sudo sh -c "echo "disable" > /proc/acpi/ibm/bluetooth"
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

If you desperately want the wireless LED to work you can use
[http://bughost.org/bugzilla/attachment.cgi?id=1263 this] patch for a 2.6.24 kernel.
Make sure to enable LED Triggers and LED groups in your kernel configuration,
then there is a new option in the iwlwifi submenu. Works here, however,
it doesn't blink on activity as it would with windows.

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.

== Power Management ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
sudo sh -c "echo on > /proc/acpi/ibm/light"
fi
if [ $1 = "off" ]
then
sudo sh -c "echo off > /proc/acpi/ibm/light"
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
sudo sh -c "echo off > /proc/acpi/ibm/light"
else
sudo sh -c "echo on > /proc/acpi/ibm/light"
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true

## Comment this out for more resolutions
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

# Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-02-28T13:12:23Z

Fuchs: added more harddisk protection information

== Model ==
Lenovo Thinkpad {{R61}} 7743-Y1B

== General ==
This installation instruction describes the steps after a Gentoo 2007.0 base installation.
Please read the gentoo handbook for installation instructions

====Working:====

* Keyboard, UltraNav input (Touchpad and NavPoint)
* Drives
* X11 with nVidia including acceleration
* Network, wireless network and bluetooth
* Sound
* Suspend to RAM
* ThinkLight
* PCMCIA
* ACPI (Battery, CPU Frequency, Fan, Temperature, ...)
* Fingerprint scanner (includes login and screen lock)
* Fn Key combinations
* Hot swapping of optical drive (UltraBay)
* HDD Acceleration Meter (can be used as an input device)
* Harddisk protection (kernel patched with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this])

====Not tested:====

* Firewire (should work as it is recognized, no devices for testing)
* Suspend to disk (should work)
* Express Card Slot (should work, no devices for testing)
* Docking Station (should work according to several sources, no devices for testing)

== Graphics: NVIDIA Quadro NVS 140M ==

To install and configure the nVidia driver, just emerge nvidia-driver.
Tested with nvidia-driver-100.14.19, everything works fine, games run smooth.

Framebuffer works fine with vga=869 which will set the resolution to 1440x900.
hwinfo --framebufer displays all supported resolutions.

The brightness can be changed with the new nvidia driver
(169.04) which is a beta driver at the moment.
Does not work with older drivers, only known workaround
is to either use vesa / nv driver or to change the
brightness on a vt.

== Sound: AD1984 ==
Did not work with older Versions of ALSA driver, works fine with ALSA 1.0.15 and should work
with ALSA 1.0.14 as well. The in-kernel ALSA works since 2.6.23.

The mute button is hardwired and works, the volume up and volume down buttons
work as well but you need to configure them first. You can use xmodmap to bind a key to them and then either bind a amixer command to them, or set them as hotkeys in your mixer application (kmix, gnome-mixer, ...)
Please note that some mixer applications take the wrong mixer (the microphone) as the default, so you have to change the default / primary mixer in order to use things like kmilo.

Note: After muting you have to press a volume up or down button to unmute,
and the mute status is not displayed in any mixer application.

'''Note for Kernel 2.6.24:'''
Due to changes in thinkpad acpi the mute button does not longer work out of the box,
but it does generate a key event. So you have to bind it to a script which mutes
the headphone and speaker via amixer toggle <mixer>.
This is a known problem to the thinkpad-acpi developers and probably will
be resolved in the near future.

I recommend using alsa-drivers 1.0.16_r2, as there is a new master mixer,
which has mute capabilities to mute headphones and speaker.
So you can either bind the key in a mixer application or you only have
to use one amixer command.

== Network: Intel E1000 NIC, IPW4965abgn WNIC, Bluetooth==

The integrated e1000 LAN NIC works out of the box.

For wireless you have to unmask and emerge the iwlwifi package
with the ipw4965 USEFlag enabled.

Don't forget that the interface (wlan0) has to be set as up
(ifconfig wlan0 up) before scanning and associating works.

Bluetooth works out of the box with blueZ.
You can disable / enable bluetooth via proc,
with a script similar to this one:

<bash>
#!/bin/sh
bluetooth=`head -n 1 /proc/acpi/ibm/bluetooth | awk '{print $2}'`
case "$bluetooth" in
disabled)
sudo sh -c "echo "enable" > /proc/acpi/ibm/bluetooth"
;;
enabled)
sudo sh -c "echo "disable" > /proc/acpi/ibm/bluetooth"
;;
esac
exit 0
</bash>

or directly with the proc interface. This script helps you
to bind it to the Fn+F5 key combination.

Note that the hardware killswitch on the front works as well,
but disables both bluetooth and WLAN

== Ports: PCMCIA, USB, IEEE 1394 Firewire ==

PCMCIA port works out of the box, tested with an audigy pcmcia.
I have no express slot cards available for testing.

The left hand usb ports generate an IRQ nobody cared error from time to time,
Try to boot with irqpoll in your kernel line as suggested.

A BIOS Update might help as well, it is recommended to use the
ThinkVantage Software Updater for windows for a BIOS Update.
The error disappeared here and USB works fine.

Firewire is untested but should work, as the port is
recognized and the module loaded.

== Drives ==

The optical drive and hard drive work out of the box,
with AHCI disabled or enabled in the BIOS.

If you run a dualboot system with windows <= 5.1 (XP) you probably want to disable AHCI anyway,
at least until you have installed the ahci driver for Windows.

== Input ==

=== TouchPad ===
Works out of the box here, with scrolling.
Have a look at my Xorg.conf section at the end

Can be disabled via synclient when using the synaptics driver,
a possible solution is this script:

<bash>
#!/bin/sh
touchpad=`synclient -l | grep TouchpadOff | awk '{print $3}'`
case "$touchpad" in
1)
synclient TouchpadOff=0;
echo "Touchpad Enabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
0)
synclient TouchpadOff=1;
echo "Touchpad Disabled" | osd_cat -d 1 -c cyan --font="-*-times-bold-r-*--34-240-*-*-p-*-*-*" -A center -p bottom
;;
esac
exit 0
</bash>

which needs xosd to display the current state.
You can make it excecutable and map it to the fn+f8 button.

=== Trackpoint ===
Works out of the box as well, with no scrolling however.
Can be configured via xorg.conf, I prefer using the middle button as mouse3.

=== Keyboard ===
Works out of the box, most of the Fn Keys work.

Hardwired: Mute, Thinklight, Brightness

Generates a keycode and can be configured: Volume Down, Volume Up, Fn+F2, Fn+F3, Fn+F4, Fn+F5, Fn+F7, Fn+F8, Fn+Arrows

Does not generate a key event: Fn+F9, Fn+F12, Fn+Space
Those keys do produce an acpi event, so you can modifiy your
acpi configuration to bind them to commands.

It is also possible to translate the acpi events to keyevents, have a look at the following configuration file:

[[Installing_Gentoo_2007.0_on_a_ThinkPad_R61#default.sh_.28acpid.29|My example default.sh file for the missing keys is here]]
and there is a good, more complete howto
here: [http://gentoo-wiki.com/HARDWARE_Lenovo_Thinkpad_T61#Usage_of_acpid Gentoo Wiki]

Try whether echo "0xffffffff" > /proc/acpi/ibm/hotkey
enables additional fn+fx keys to produce a key event
instead of only an acpi event.

== Power Management ==
Suspend to RAM worked out of the box here, echo 3 > /proc/acpi/sleep
puts the machine in suspend mode, opening it or pressing the power button wakes it up.
Worked with nvidia driver and in X11. All devices came back without problems,
wlan might have disconnected, but by using networkmanager, wicd or a good configuration
it should reconnect after waking up. Works here with wicd.

== Integrated Fingerprint Reader ==
Emerge the thinkfinger package, add a user with the tf-tool.
Then you have to edit the /etc/pam.d/system-auth file by adding

auth sufficient pam_thinkfinger.so

between pam.unix and pam.env.

Read the Gentoo-Wiki to use it with xscreensaver,
there is a good solution over [http://gentoo-wiki.com/HOWTO_Thinkfinger there]

Note: kdm has problems with thinkfinger auth and might crash.
There are patches, but I didn't test them yet. gdm works fine here.

== Hard Drive Active Protection ==

The integrated harddrive active protection
acceleration meter can be used as a joystick or
to get information about movements of your thinkpad.

Emerge the hdapsd (which includes a kernel module
you have to load) which will generate a joystick
and an event device.

It can be used for protecting your harddisk as well.
You first need to patch your kernel with [http://www.fuchsnet.ch/files/hdaps-2.6.24.patch this patch] and then rebuild it. Make sure to diable the kernel internal hdaps module, emerge hdapsd and tp_smapi with the hdaps flag enabled, rc-update add hdapsd boot and then reboot.

When shaking your notebook you should receive a message via dmesg that the hdd head has been parked.
You can also use a frontend like khdaps.

Heads will only be parked with this method. However, in some situations and with some disk there will be a full spindown, which should be avoided as this might damage your harddisk when used too much.

== Thinklight ==

The thinklight works out of the box with the
Fn+PgUp key, but it can be controlled as well via the proc interface.

So you can write a nice script, which you can bind to events,
such as incoming emails, to let the light flash.

A possible solution is this small script:

<bash>
#!/bin/sh

if [ -z "$1" ]
then
echo "IBM ThinkLight Control script."
echo "2007 by Christian \"Fuchs\" Loosli."
echo ""
echo "usage: lightctl on | off | toggle | blink"
echo "blink takes two arguments: times and time"
echo "defaults (5 times, 0.5 seconds) are used if not specified"

else
if [ $1 = "on" ]
then
sudo sh -c "echo on > /proc/acpi/ibm/light"
fi
if [ $1 = "off" ]
then
sudo sh -c "echo off > /proc/acpi/ibm/light"
fi

if [ $1 = "toggle" ]
then
status=`cat /proc/acpi/ibm/light | grep status | awk '{print $2}'`

if [ $status = "on" ]
then
sudo sh -c "echo off > /proc/acpi/ibm/light"
else
sudo sh -c "echo on > /proc/acpi/ibm/light"
fi
fi

if [ $1 = "blink" ]
then

times=$2
time=$3

if [ -z "$2" ]
then
times=4
fi

if [ -z "$3" ]
then
time=0.5
fi

for i in `seq 1 $times`;
do
$0 toggle;
sleep $time;
$0 toggle;
sleep $time
done
fi
fi
exit 0

</bash>
which can be called to let the light blink or switch it off or on.
The blink part is nice for setting to events such as incoming
messages or emails.

There is a version slightly modified by a friend of mine
[http://www.fuchsnet.ch/files/thinklight.sh here] which has a lockfile and is slightly optimized.

(note: the thinklight is a LED, so it should not care on
how fast and often you let it blink. But I am not responsible
if this script damages your thinklight. Use at own risk.

== Power saving ==

First of all, turn off all things you are not using,
most of all bluetooth and W-LAN.
You can use the killswitch on the front, it works out of the box.

You can use the application [http://www.lesswatts.org/projects/powertop/ powertop]
by Intel to look for processes which prevent the CPU from longer sleep states.

It also gives you some recommendations on services to turn off. Do _not_ turn off the optical drive polling by HAL.

Dimming the display also saves lots of power.

Since 2.6.24 dynticks are available for x86_64.

I managed to get powerconsumption down to:

* 20W running normal with compiz, wlan & bluetooth enabled

* 16.7W running a normal windowmanager

* 14.5W with bluetooth and wlan disabled (killswitch)

I had between 195 and 600 wakeups per second.

Also hda-intel and s-ata power consumption was reduced in 2.6.24

You can achieve about 2 - 3 hours of working time
(no compiling or other heavy CPU / GPU usage applications)
with the standard battery like this.

== Configuration Files ==

=== xorg.conf ===
Note that I use the XFont Server, you might have
to change the font path.

Note: in this configuration here nvidia will read out
sane values out of your flat panel.

In this configuration the modes and frequencies given don't affect
the modes available and you will only have 3 resolutions,
but it saves lots of time spent on configuring frequencies otherwhise.

Remove the # in front of the marked line to disable parts of this behaviour (nvidia will still read out sane resolutions, read the nvidia documents to disable this behaviour as well),
which gives me 5 additional screen resolutions here.

<pre>

Section "ServerLayout"
Identifier "single head configuration"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
inputDevice "Touchpad" "SendCoreEvents"
EndSection

Section "Files"
FontPath "unix/:-1"
EndSection

Section "Module"
Load "dbe"
Load "extmod"
Load "glx"
Load "freetype"
Load "type1"
EndSection

Section "InputDevice"
Identifier "Keyboard0"
Driver "kbd"
Option "XkbModel" "pc102"
Option "XkbLayout" "ch"
EndSection

Section "InputDevice"
Identifier "Touchpad"
Driver "synaptics"
Option "Protocol" "auto-dev"
Option "Device" "/dev/input/mouse0"
Option "Emulate3Buttons" "no"
Option "ZAxisMapping" "4 5"
Option "LeftEdge" "1700"
Option "RightEdge" "5300"
Option "TopEdge" "1700"
Option "BottomEdge" "4200"
Option "FingerLow" "25"
Option "FingerHigh" "30"
Option "MaxTapTime" "180"
Option "MaxTapMove" "220"
Option "VertScrollDelta" "100"
Option "MinSpeed" "0.02"
Option "MaxSpeed" "0.28"
Option "AccelFactor" "0.0010"
Option "SHMConfig" "on"
Option "UseSHM" "true"
EndSection

Section "InputDevice"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "ExplorerPS/2"
Option "Device" "/dev/input/mice"
Option "ZAxisMapping" "6 7"
Option "buttons" "7"
Option "Emulate3Buttons" "yes"
EndSection

Section "Monitor"
Identifier "Monitor0"
VendorName "Monitor Vendor"
ModelName "Flat Panel 1400x950"
Option "DPMS"
HorizSync 28.0 - 61.0
VertRefresh 43.0 - 62.0
EndSection

Section "Device"
Identifier "Videocard0"
Driver "nvidia"
VendorName "NVIDIA"
BoardName "NVIDIA GeForce FX (generic)"
Option "Coolbits" "1"
Option "AllowGLXWithComposite" "true"
Option "RenderAccel" "true"
Option "UseEvents" "false"
Option "TripleBuffer" "1"
Option "DamageEvents" "1"
Option "BackingStore" "1"
Option "RandRRotation" "true

## Comment this out for more resolutions
## Make sure that HorizSync and VertRefresh fit to your monitor,
## As nvidia wont read out allowed values anymore

# Option "UseEdidFreqs" "false"

EndSection

Section "Screen"
Identifier "Screen0"
Device "Videocard0"
Monitor "Monitor0"
DefaultDepth 24
Option "AddARGBGLXVisuals" "true"
Option "UseCompositeWrapper" "true"
SubSection "Display"
Viewport 0 0
Depth 24
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 16
Modes "1440x900" "1024x768" "800x600"
EndSubSection
SubSection "Display"
Viewport 0 0
Depth 8
Modes "1440x900" "1024x768" "800x600"
EndSubSection
EndSection

Section "Extensions"
Option "Composite" "Enable"
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

</pre>

=== xmodmap ===

Note: you have to xmodmap /path/to/file
this file in your autostart. You might have different keycodes, use the application xev to display them.
It is highly recommended to use the XF86foobar buttons, as some applications will be preconfigured to them.
If you want to map them by yourself use Fxx, while xx > 12.

<pre>

! additional Arrow keys

keycode 233 = XF86Forward
keycode 234 = XF86Back

! Fn+arrow keys

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext
keycode 164 = XF86AudioStop

! Fn+Fx keys F2, F3, F4, F5, F7, F8, F9, F12 in this order

keycode 146 = XF86ScreenSaver
keycode 241 = XF86Display
keycode 223 = XF86Sleep
keycode 243 = XF86Send
keycode 214 = XF86Video
keycode 196 = XF86iTouch
keycode 197 = XF86Eject
keycode 165 = XF86Standby

! Space bar

keycode 148 = XF86ZoomIn

! volume control (mute is hardwired)

keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume

</pre>

=== default.sh (acpid) ===

This is my slightly modified default.sh file to handle ibm hotbutton events.
Of course you can add the other buttons as well, however, as they produce key events there are easier ways for configuring the actions. However, an acpi solution is window manager / X independent.

You can read out the key events, as they might differ on your model,
with the acpi_listen application.

<bash>
#!/bin/sh
# /etc/acpi/default.sh

set $*

group=${1%%/*}
action=${1#*/}
device=$2
id=$3
value=$4

if [ "$group" = "ibm" ]; then
key="$2"\ "$3"\ "$4"
fi

log_unhandled() {
logger "ACPI event unhandled: $*"
}

case "$group" in
button)
case "$action" in
power)
/sbin/init 0
;;

*) log_unhandled $*
;;
esac
;;

ibm)
case "$action" in
hotkey)
case "$key" in
"HKEY 00000080 00001008")
/usr/bin/acpi_fakekey 220
;;
"HKEY 00000080 00001009")
/usr/bin/acpi_fakekey 221
;;
"HKEY 00000080 00001014")
/usr/bin/acpi_fakekey 222
;;
*)
logger "acpid: $group/$action $key is not defined"
;;

esac
;;
*)
;;
esac
;;

*) log_unhandled $*
;;
esac
</bash>

Note that I use acpi_fakekey to translate acpi to key events.

=== ACPI Fakekey ===

With this nice app you can translate acpi events into key codes.

I borrowed it from gentoos acpi-support, which borrowed it from Ubuntu people.

You can it out of the sunrise overlay, I recommend only getting the
acpi-fakekey.c file and compile it.

For the lazy guys:

There is an explanation and the source code,
which I wont copy and paste here, on this page:

[http://gentoo-wiki.com/HARDWARE_Asus_F3SV#ACPI_.26_Hotkeys Gentoo Wiki on Hotkeys]

I use this in the file above to generate keycodes for Fn+F8, Fn+F9 and Fn+Space.

=== Kernel configuration ===

[http://www.fuchsnet.ch/files/config 2.6.24 Kernel config]

Please note: this configuration works for my setup,
it might not for yours.

I use ext3 as my file system, make sure to compile in the support for the file system you are using, at least for the root partition.

I also use external ALSA drivers.
But I use lots of stuff you probably will never use, such as several gamepads,
acl support for ext3, some ipv4 / ipv6 filters ...
You might want to remove those.

This is the configuration for a 2.6.24 Kernel, it differs a little bit from the configuration of earlier kernels.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-02-27T22:50:34Z

Fuchs: /* General */ sucessfully tested harddrive protection, so added as working

Installing Gentoo 2007.0 on a ThinkPad R61

2008-02-24T12:59:03Z

Fuchs: /* xorg.conf */ added some resolutions

Installing Gentoo 2007.0 on a ThinkPad R61

2008-02-17T21:24:53Z

Fuchs: /* Thinklight */ typo in the external url, which is bad.

Installing Gentoo 2007.0 on a ThinkPad R61

2008-02-15T20:59:55Z

Fuchs: /* Thinklight */

Talk:Installing Gentoo 2007.0 on a ThinkPad R61

2008-02-15T14:36:35Z

Fuchs: /* Fingerprint reader */

On my thinkpad R61, AHCI controller works on gentoo kernel 2.6.22r9 (i think i had to change /etc/fstab after installing in compatibility mode) and additionally you can install the AHCI driver on Windows 2000/XP (http://www-307.ibm.com/pc/support/site.wss/document.do?lndocid=migr-62909) and reactivate the controller in the bios. i don't really know if this always works, but with kernel 2.6.22r9 it did. Anybody else who has the same luck? then you/I may add this to the wiki. it is better you add it, because i'm german and my english is not so well. thank you.

--

I never said it would not work,
however, in my opinion there is no good reason for using it,
and as it leads to BSODs on Window Systems which do not
have the AHCI driver it is more safe to disable it.

As for the english: I am swiss, so my (swiss)german
and french are better than my english... you can add it
if you'd like to, but I'd rather hear some more
comments on this of other users.

Fuchs

--

== Fingerprint reader ==

Could you please show the output of lsusb?
I've read that fingerprint scanner from R61 is not supported by thinkfinger.
<pre># lsusb
Bus 007 Device 001: ID 0000:0000
Bus 006 Device 001: ID 0000:0000
Bus 005 Device 001: ID 0000:0000
Bus 004 Device 002: ID 067b:3507 Prolific Technology, Inc. PL3507 ATAPI6 Bridge
Bus 004 Device 001: ID 0000:0000
Bus 003 Device 001: ID 0000:0000
Bus 002 Device 002: ID 046d:c50e Logitech, Inc. MX-1000 Cordless Mouse Receiver
Bus 002 Device 001: ID 0000:0000
Bus 001 Device 003: ID 147e:2016 <- this is probably the reader (?)
Bus 001 Device 002: ID 0a5c:2110 Broadcom Corp.
Bus 001 Device 001: ID 0000:0000
</pre>

---

<pre>
Bus 003 Device 002: ID 0483:2016 SGS Thomson Microelectronics Fingerprint Reader
</pre>

It might be that newer / older models have a new fingerprint reader,
either provide the thinkfinger people with any information you got
or try whether fprint works for this device.

However, I am no big fan of fprint because of it's strange behaviour
when you like to use either a password or your finger.

Fuchs

Installing Gentoo 2007.0 on a ThinkPad R61

2008-02-12T18:50:31Z

Fuchs: /* Sound: AD1984 */ 2.6.24 changes

Installing Gentoo 2007.0 on a ThinkPad R61

2008-02-12T16:10:17Z

Fuchs: /* Drives */

Installing Gentoo 2007.0 on a ThinkPad R61

2008-02-12T15:55:49Z

Fuchs: /* Sound: AD1984 */

Installing Gentoo 2007.0 on a ThinkPad R61

2008-02-12T15:54:12Z

Fuchs: /* Configuration Files */ kernel config