ThinkPad Button

The ThinkPad Button is a button situated in the upper left corner of the keyboard on modern ThinkPads. It is intended to be a means of quick access to help and support. Technically it is nothing else than a button that can be configured to launch a certain piece of software. While originally it was grey and labelled ThinkPad, IBM later made it blue and called it the Access IBM Button. Lenovo relabelled it as ThinkVantage after it took over the ThinkPad line from IBM.

System Boot

Pressing Access IBM or ThinkVantage at system boot can launch the Predesktop Area. This depends on a specific setting of the BIOS Setup Utility and on the availability of either a Hidden Protected Area or a Rescue and Recovery partition. See the linked pages for details.

Linux support

Using HAL

Recent Linux distributions like Fedora 10 and Ubuntu 8.10 use HAL to manage input devices.

HAL will map the ThinkPad button to either 'vendor' or 'prog1', depending on the version of the hal-info config files.

Older versions mapped it to 'vendor' because that is the most logical choice. However the 'vendor' button keycode is out of range for Xorg, which made it impossible to have Xorg respond to the keypress (this limitation should be fixed with Xorg 1.6 planned for late 2009). As such the mapping was changed to 'prog1' instead in later versions of the config files.

The config file responsible for this is /usr/share/hal/fdi/information/10freedesktop/30-keymap-module-thinkpad-acpi.fdi and you can view the mapping with lshal.

If you wish to do your own mapping, you can override the system mapping files by creating your own in /etc/hal/fdi.

You can also run xev from Xorg to check if Xorg recognises the button when pressed. If Xorg recognises the button it can be configured in gnome with gnome-keybinding-properties.

Using tpb

Under Linux, the IBM ThinkPad(tm) special keys can be enabled using tpb.

I.e., to make pressing the Access IBM Button launch ntpctl, add the following line /etc/tpbrc file:

THINKPAD    /usr/bin/X11/xterm -T ntpctl -e ntpctl

To make pressing the Access IBM Button launch the ThinkWiki homepage in Firefox, add the following line:

THINKPAD    /usr/bin/firefox http://www.thinkwiki.org

See the tpb page and the ThinkPad special keys HOWTO for more information.

Using KDE

KDE supports assigning actions to (some) ThinkPad special keys, through the ThinkPad buttons KMilo plugin.

It can be activated and configured in the KDE Control Center (kcontrol), under System Administration --> IBM Thinkpad Laptop.

Using xbindkeys on Ubuntu

On Ubuntu (at least 7.04/Feisty) tpb is not really an option, because it conflicts with hotkey-setup, which is responsible for much things working out of the box.

An alternative is to use xbindkeys, which can easily be installed with aptitude install xbindkeys or via the Synaptic package manager. It can be used to assign arbitrary commands to certain keycodes. Therefore, we first have to find this keycode by running xbindkeys --key and pressing the ThinkPad Button. This should result in something like the following:

sean@amalthea ~ $ xbindkeys --key
Press combination of keys or/and click under the window.
You can use one of the two lines after "NoCommand"
in $HOME/.xbindkeysrc to bind a key.
"NoCommand"
    m:0x0 + c:159
    NoSymbol

Now we can construct a minimal configuration file in ~/.xbindkeysrc:

"gnome-terminal"
m:0x0 + c:159

After starting xbindkeys without further options the ThinkPad Button should launch a new terminal.

To start the program automatically at login add it under "System -> Preferences -> Sessions -> Startup Programs" (assuming the Gnome Desktop is used, otherwise add it to your ~/.xinitrc, ~/.xsession or whatever is responsible for startup items in your setting).

Using Gnome

A simpler but less flexible possibility than xbindkeys is "System -> Preferences -> Keyboard Shortcuts". Just go to (for example) "Run a terminal" and press the ThinkPad Button, when asked for a "New accelerator...". This will only work under the Gnome Desktop. Using custom commands for this is a little harder, see this tutorial.

TODO: add the name the key is mapped to (if it is always the same). For now you can use the above method (for a normal shortcut) first, then look what the name of the key is and then copy it to the special command keyboard shortcut.

Windows support (2000 or XP)

If you want to customize the program that is launched when the ThinkPad, Access IBM or ThinkVantage button is pressed while the machine is running Windows (2000 or XP) you can change the following registry entry:

HKEY_LOCAL_MACHINE\SOFTWARE\IBM\TPHOTKEY\8001

Here are the default values for the original IBM version:

[HKEY_LOCAL_MACHINE\SOFTWARE\IBM\TPHOTKEY\8001]
"File"="C:\\Program Files\\IBM\\Access IBM\\aibm.exe"
"DispName"="Access IBM"

And these are the default values for the Lenovo version:

[HKEY_LOCAL_MACHINE\SOFTWARE\IBM\TPHOTKEY\8001]
"File"="C:\\PROGRA~1\\THINKV~1\\PrdCtr\\LPL1.exe"

To avoid conflicts, be sure to enter the file paths as DOS truncated (first six characters, then "~1")

NOTE!

Works on Windows 7 too. In that case most probably also on Vista.

Related Links

• Python script for Windows to control ThinkPad features that also allows querying of the ThinkPad button
• IBMs Access IBM ThinkVantage Technology page
• Access IBM - Customization Guide

Models featuring this Technology

"ThinkPad" button

• ThinkPad A20m, A20p, A21e, A21m, A21p, A22e, A22m, A22p, A30, A30p, A31, A31p, A275, A285, A475, A485
• ThinkPad R30, R31, R32
• ThinkPad T20, T21, T22, T23, T30
• ThinkPad X20, X21, X22, X23, X24, X30
• ThinkPad TransNote
• ThinkPad S30, S31

"Access IBM" button

• ThinkPad G40, G41
• ThinkPad R40, R40e, R50, R50e, R50p, R51, R51e, R52
• ThinkPad T40, T40p, T41, T41p, T42, T42p, T43, T43p
• ThinkPad X31, X32, X40, X41, X41 Tablet

"ThinkVantage" button

• ThinkPad R60, R60e, R61, R400, R500
• ThinkPad T60, T60p, T61, T61p, T400, T400s, T410, T410i, T410s, T410si, T500, T510, T510i
• ThinkPad W500, W510, W520, W530, W540, W541, W550s, W700, W700ds, W701, W701ds
• ThinkPad X60, X60s, X60 Tablet, X61, X61s, X61 Tablet, X200, X200s, X200 Tablet, X300, X301
• ThinkPad Z60m, Z60t, Z61e, Z61m, Z61p, Z61t

"Lenovo Care" button

• ThinkPad SL300, SL400, SL500