Difference between revisions of "Thinkpad-acpi"

From ThinkWiki
Jump to: navigation, search
m (added acpi_listen info)
(Hotkeys: How about using the documented best-practice configs from the thinkpad-acpi maintainer instead? :-))
Line 3: Line 3:
  
 
=Hotkeys=
 
=Hotkeys=
To view which hotkeys are active you can use
+
To view which hotkeys are active you can use "acpi_listen", but that is deprecated.  A better way is to use "lsinput" and "input-events" commands to look at the output of the thinkpad-acpi input device(s).
<pre>
+
 
acpi_listen
+
One important difference from ibm-acpi for those who wish to enable all possible hot keys, is that thinkpad-acpi automatically enables them.  One should not need to do anything to get the best possible thinkpad-acpi configuration for his ThinkPad (as long as he is using the latest thinkpad-acpi).
</pre>
+
 
One important difference from ibm-acpi for those who wish to enable all possible hotkeys is that there are more possible bits to be set in the mask. Thus, to enable all possible hotkeys, do a
+
In particular, old documentation that tells you to "echo enable,0xffffffff >/proc/acpi/ibm/hotkey", or to give thinkpad-acpi any hotkey= module parameters to enable hot keys by default, is likely incorrect.
<pre>
+
 
echo enable,0xffffffff >/proc/acpi/ibm/hotkey
+
The thinkpad-acpi driver has detailed documentation, which is shipped inside the Linux kernel sources, as "Documentation/thinkpad-acpi.txt" or as "Documentation/laptops/thinkpad-acpi.txt".  If you feel a need to change the hot key mask manually, it is probably best to look at that documentation first to understand the full side effects of any changes.
</pre>
 
To make this permanent, add the following line to <tt>/etc/modprobe.d/thinkpad_acpi</tt>:
 
<pre>
 
options thinkpad_acpi hotkey=enable,0xffffffff experimental=1
 
</pre>
 
  
 
=Further documentation=
 
=Further documentation=

Revision as of 19:14, 26 February 2008

Thinkpad-specific ACPI driver

This is a Linux ACPI driver for the IBM ThinkPad laptops written by Borislav Deianov and Henrique de Moraes Holschuh. The driver replaces ibm-acpi in Linux mainline as of 2.6.22 (March 2007). To confuse matters further, it appears that there was also an older (now abandoned) driver of the same name written by Erik Rigtorp which never made it into the mainline kernel. The current thinkpad-acpi contains essentially the same functionality as ibm-acpi with some added features. Among which are registering of acpi events to the "thinkvantage" and volume/mute buttons which could previously only be accessed through the use of the tpb utility.

Hotkeys

To view which hotkeys are active you can use "acpi_listen", but that is deprecated. A better way is to use "lsinput" and "input-events" commands to look at the output of the thinkpad-acpi input device(s).

One important difference from ibm-acpi for those who wish to enable all possible hot keys, is that thinkpad-acpi automatically enables them. One should not need to do anything to get the best possible thinkpad-acpi configuration for his ThinkPad (as long as he is using the latest thinkpad-acpi).

In particular, old documentation that tells you to "echo enable,0xffffffff >/proc/acpi/ibm/hotkey", or to give thinkpad-acpi any hotkey= module parameters to enable hot keys by default, is likely incorrect.

The thinkpad-acpi driver has detailed documentation, which is shipped inside the Linux kernel sources, as "Documentation/thinkpad-acpi.txt" or as "Documentation/laptops/thinkpad-acpi.txt". If you feel a need to change the hot key mask manually, it is probably best to look at that documentation first to understand the full side effects of any changes.

Further documentation

More comprehensive documentation can be found in the kernel source tree (>=2.6.22) under Documentation/thinkpad_acpi.txt.

For now, please refer to the ibm-acpi page for any other information on the new thinkpad-acpi driver.

There have been no releases of the driver under the thinkpad-acpi name yet. It is available with the new name in the acpi-test git tree, and ibm-acpi development git tree.

External links related to thinkpad-acpi