Difference between revisions of "ThinkPad Button"

From ThinkWiki
Jump to: navigation, search
(added category)
 
(73 intermediate revisions by 34 users not shown)
Line 1: Line 1:
 
{| width="100%"
 
{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;" | [[Image:Accessibm.png]]
+
|style="vertical-align:top;padding-right:20px;width:10px;" | [[Image:ThinkPadButton.png|96px]] [[Image:AccessIBMButton.png|96px]] [[Image:ThinkVantageButton.png|96px]] [[Image:BlackButton.png|96px]] [[Image:LenovoCareButton.png|96px]]
 
|style="vertical-align:top" |
 
|style="vertical-align:top" |
 
<div style="margin: 0; margin-right:10px; border: 1px solid #dfdfdf; padding: 0em 1em 1em 1em; background-color:#F8F8FF; align:right;">
 
<div style="margin: 0; margin-right:10px; border: 1px solid #dfdfdf; padding: 0em 1em 1em 1em; background-color:#F8F8FF; align:right;">
The Access IBM 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.
+
===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.
  
On earlier models this button is labelled "ThinkPad".
+
While it was originally grey and labelled {{ibmkey|ThinkPad|#494949}}, IBM later made it blue and called it the {{ibmkey|Access IBM|#495988}} Button. After Lenovo took over the ThinkPad line from IBM, they re-labelled it as {{ibmkey|ThinkVantage|#495988}}. 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.
 
</div>
 
</div>
 
|}
 
|}
 
__NOTOC__
 
__NOTOC__
 +
== System Boot ==
 +
Pressing {{ibmkey|Access IBM|#495988}} or {{ibmkey|ThinkVantage|#495988}} at system boot can launch the [[Predesktop Area| Predesktop Area]]. This depends on a specific setting of the BIOS Setup Utility and on the availability of either a [[Hidden Protected Area|Hidden Protected Area]] or a [[Rescue and Recovery|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 ==
 
== 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 {{path|/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 {{path|/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]].
 
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:  
+
I.e., to make pressing the Access IBM Button launch ntpctl, add the following line {{path|/etc/tpbrc}} file:  
 
  THINKPAD    /usr/bin/X11/xterm -T ntpctl -e ntpctl
 
  THINKPAD    /usr/bin/X11/xterm -T ntpctl -e ntpctl
  
To make pressing the Access IBM Button launch the ThinkWiki homepage, add the following line:  
+
To make pressing the Access IBM Button launch the ThinkWiki homepage in Firefox, add the following line:  
 
  <nowiki>THINKPAD    /usr/bin/firefox http://www.thinkwiki.org</nowiki>
 
  <nowiki>THINKPAD    /usr/bin/firefox http://www.thinkwiki.org</nowiki>
  
 
See the [[tpb]] page and the [[How to get special keys to work | ThinkPad special keys HOWTO]] for more information.
 
See the [[tpb]] page and the [[How to get special keys to work | 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 (<tt>kcontrol</tt>), under <tt>System Administration --> IBM Thinkpad Laptop</tt>.
 +
 +
===Using xbindkeys on Ubuntu===
 +
 +
On Ubuntu (at least 7.04/Feisty) <code>tpb</code> is not really an option, because it conflicts with <code>hotkey-setup</code>, which is responsible for much things working out of the box.
 +
 +
An alternative is to use <code>xbindkeys</code>, which can easily be installed with <code>aptitude install xbindkeys</code> 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 <code>xbindkeys --key</code> 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 <code>~/.xbindkeysrc</code>:
 +
"gnome-terminal"
 +
m:0x0 + c:159
 +
After starting <code>xbindkeys</code> without further options the ThinkPad Button should launch a new terminal.
  
== Windows support (2000 or XP) ==
+
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 <code>~/.xinitrc</code>, <code>~/.xsession</code> or whatever is responsible for startup items in your setting).
If you want to customize the program that is launched when the Access IBM 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
+
===Using Gnome===
  
Here are the default values:
+
A simpler but less flexible possibility than <code>xbindkeys</code> 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 [http://www.codejacked.com/create-custom-keyboard-shortcuts-in-linux/ 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 {{ibmkey|ThinkPad|#494949}}, {{ibmkey|Access IBM|#495988}} or {{ibmkey|ThinkVantage|#495988}} button is pressed while the machine is running {{Windows}} (2000/XP/Vista/7) you can change the following registry entry:
 +
 
 +
<code>HKEY_LOCAL_MACHINE\SOFTWARE\IBM\TPHOTKEY\8001</code>
 +
 
 +
Here are the default values for the original IBM version:
  
 
  [HKEY_LOCAL_MACHINE\SOFTWARE\IBM\TPHOTKEY\8001]
 
  [HKEY_LOCAL_MACHINE\SOFTWARE\IBM\TPHOTKEY\8001]
  "File"="C:\\Program Files\\IBM\\Access IBM\\\\aibm.exe"
+
  "File"="C:\\Program Files\\IBM\\Access IBM\\aibm.exe"
 
  "DispName"="Access IBM"
 
  "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 ==
 +
* [[How to get special keys to work]]
  
 
== Related Links ==
 
== Related Links ==
*[http://www.pc.ibm.com/us/think/thinkvantagetech/accessibm.html IBMs Access IBM ThinkVantage Technology page]
+
*[[Python script for Windows to control ThinkPad features]] that also allows querying of the ThinkPad button
 +
*[http://www.pc.ibm.com/us/think/thinkvantagetech/accessibm.html IBM's Access IBM ThinkVantage Technology page]
 
*[http://www-3.ibm.com/pc/support/site.wss/AIBM-TOOLS.html Access IBM - Customization Guide]
 
*[http://www-3.ibm.com/pc/support/site.wss/AIBM-TOOLS.html Access IBM - Customization Guide]
  
 +
==Models featuring this technology==
 +
'''"ThinkPad" button'''
 +
*{{I1210}}, {{I1230}}, {{I1250}}, {{I1260}}, {{I1300}}, {{I1330}}, {{I1370}}, {{i1620}}, {{i1800}}
 +
*{{130}}
 +
*{{A20m}}, {{A20p}}, {{A21e}}, {{A21m}}, {{A21p}}, {{A22e}}, {{A22m}}, {{A22p}}, {{A30}}, {{A30p}}, {{A31}}, {{A31p}}
 +
*{{T20}}, {{T21}}, {{T22}}, {{T23}}, {{T30}}
 +
*{{X20}}, {{X21}}, {{X22}}, {{X23}}, {{X24}}, {{X30}}
 +
*{{R30}}, {{R31}}, {{R32}}
 +
*{{S30}}, {{S31}}
 +
*{{TransNote}}
 +
 +
'''"Access IBM" button'''
 +
*{{T40}}, {{T40p}}, {{T41}}, {{T41p}}, {{T42}}, {{T42p}}, {{T43}}, {{T43p}}
 +
*{{X31}}, {{X32}}, {{X40}}, {{X41}}, {{X41T}}
 +
*{{R40}}, {{R40e}}, {{R50}}, {{R50e}}, {{R50p}}, {{R51}}, {{R51e}}, {{R52}}
 +
*{{G Series}}
 +
 +
'''"ThinkVantage" button'''
 +
*{{W500}}, {{W510}}, {{W520}}, {{W530}}, {{W700}}, {{W700ds}}, {{W701}}, {{W701ds}}
 +
*{{T60}}, {{T60p}}, {{T61}}, {{T61p}}, {{T400}}, {{T400s}}, {{T410}}, {{T410i}}, {{T410s}}, {{T410si}}, {{T420}}, {{T420i}}, {{T420s}}, {{T420si}}, {{T430}}, {{T430i}}, {{T430s}}, {{T430si}}, {{T500}}, {{T510}}, {{T510i}}, {{T520}}, {{T520i}}, {{T530}}, {{T530i}}
 +
*{{X1}}, {{X60}}, {{X60s}}, {{X60t}}, {{X61}}, {{X61s}}, {{X61_Tablet}}, {{X200}}, {{X200s}}, {{X200_Tablet}}, {{X201}}, {{X201i}}, {{X201s}}, {{X201 Tablet}}, {{X220}}, {{X220i}}, {{X220 Tablet}}, {{X300}}, {{X301}}
 +
*{{R60}}, {{R60i}}, {{R60e}}, {{R61}}, {{R61i}}, {{R61e}}, {{R400}}, {{R500}}
 +
*{{SL410}}, {{SL510}}
 +
*{{L410}}, {{L412}}, {{L420}}, {{L421}}, {{L510}}, {{L512}}, {{L520}}
 +
*{{G50}}
 +
*{{Z Series}}
  
==Models featuring this Technology==
+
'''"Black" button'''
*ThinkPad {{A Series}}
+
*{{W530}}
*ThinkPad {{G Series}}
+
*{{T430}}, {{T430i}}, {{T430s}}, {{T430si}}, {{T530}}, {{T530i}}
*ThinkPad {{R Series}}
+
*{{X1 Carbon}}, {{X230}}, {{X230i}}, {{X230 Tablet}}, {{X230i Tablet}}
*ThinkPad {{T Series}}
+
*{{L430}}, {{L530}}
*ThinkPad {{X Series}}
 
  
 +
'''"Lenovo Care" button'''
 +
*{{SL300}}, {{SL400}}, {{SL400c}}, {{SL500}}, {{SL500c}}
  
[[Category:Glossary]] [[Category:Windows]]
+
[[Category:Glossary]] [[Category:ThinkPad Technologies]]

Latest revision as of 16:05, 22 January 2021

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