ThinkPad Button

From ThinkWiki
Jump to: navigation, search
ThinkPadButton.png AccessIBMButton.png ThinkVantageButton.png BlackButton.png LenovoCareButton.png

ThinkPad Button

The ThinkPad Button is a programmable button situated in the upper left corner of the keyboard on most ThinkPads. It is intended to be a means of quick access to help and support. Technically, it is nothing more than a button that can be configured to launch a certain piece of software.

While it was originally grey and labelled ThinkPad, IBM later made it blue and called it the Access IBM Button. After Lenovo took over the ThinkPad line from IBM, they re-labelled it as ThinkVantage. Some later models no longer had it labelled, which turned it into a simple black button with no fixed purpose.

This button was also called the Lenovo Care Button for the SLx00 ThinkPads, although it did not have the usual text label and was just simply accompanied by a toolbox icon above itself.

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.

Access IBM Utility Application

After booting to Windows in an IBM ThinkPad, the button typically launches the Access IBM application. The later IBM ThinkPad models rely upon Access IBM utility software instead of providing a hard copy user manual. As quoted from IBM: "Access IBM is the comprehensive, on-board help and information center for your computer. It travels with you, eliminating the need to carry reference manuals. It is your guide to a host of information and tools."

Later releases of Access IBM require Adobe Flash player. Unfortunately, Flash v.10 incorporates security enhancements which are incompatible with Access IBM. Flash player v.9.0.280 is the last version which supports the Access IBM application. It may be obtained by performing a general web search for the phrase "archived flash player." For variants of Windows NT 5.x (including 2000, XP, and Server 2003) install flashplayer9r280_winax.exe, which is the Internet Explorer plugin. Following that, the latest version of Flash player may be installed as a Firefox plugin, and both versions will coexist without interfering with eachother.

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). As such the mapping was changed to 'prog1' (XF86Launch1 under X) 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

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/XP/Vista/7) 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")

See Also

Related Links

Models featuring this technology

"ThinkPad" button

"Access IBM" button

"ThinkVantage" button

"Black" button

"Lenovo Care" button