Ibm-acpi

ibm-acpi - IBM ThinkPad ACPI Extras Driver This is a Linux ACPI driver for the IBM ThinkPad laptops written by Borislav Deianov, and currently maintained by Henrique de Moraes Holschuh. It aims to support various features of these laptops which are accessible through the ACPI framework but not otherwise supported by the generic Linux ACPI drivers. As a kernel module, ibm-acpi works as a bridge to deliver information about certain hardware events like key presses or control the state of certain hardware features by software. NOTE! The ibm-acpi driver was renamed to thinkpad-acpi on Linux kernel 2.6.22

Deprecation warning

ATTENTION!

The "ibm-acpi" driver name will stop working on new kernels soon, switch all of your configurations to use the new module name!

The thinkpad-acpi driver has been keeping an alias to "ibm-acpi" for two years, which allowed utilities like modprobe to find the thinkpad-acpi driver using the old "ibm-acpi" name.

This alias will be removed soon (probably on Linux Kernel 2.6.31), and the "ibm-acpi" module name will not work anymore.

All configurations must switch to the new driver name.

Features

• triggers ACPI Events for
  • Fn key combinations (FnF1, FnF2, FnF3, FnF4, FnF5, FnF6, FnF7, FnF8, FnF9, FnF10, FnF11, FnF12)
  • UltraBay device eject (see also How to hotswap UltraBay devices)
  • Display lid, Power button, Undock button
• enables control via /proc files of
  • Bluetooth
  • Video output switching, video expansion control
  • Docking and undocking (limited)
  • Fan (on most models, only enable/disable; speed control used to need a further patch)
  • Volume
  • LCD Brightness
  • ThinkLight
  • LEDs
  • Beep codes
  • Several CMOS states
• can show values of
  • Sixteen temperature sensors
  • Embedded Controler registers
  • Fan status and speed

Some of these features are available only when the module is loaded with the experimental=1 option. To enable it, add the following to /etc/modprobe.conf (or your distribution's equivalent):

options ibm_acpi experimental=1

for kernels 2.6.22 and above fan control is enabled with the following in /etc/modprobe.conf:

options thinkpad_acpi fan_control=1

Project Homepage / Availability

• Homepage: http://ibm-acpi.sourceforge.net/
• Public releases: http://sourceforge.net/project/showfiles.php?group_id=117042
• ibm-acpi is included with the Linux kernel since 2.6.10.
• Mailing list: ibm-acpi-devel
• Git repository: git://repo.or.cz/linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git (browse)

Status

In development, usable, actively maintained. Patches should go to the ibm-acpi-devel mailing list.

On older versions of the driver, even if you have disabled the BIOS setting for automatically dimming at battery power, after using the brightness switch of ibm-acpi, the auto-dimming behavior is enabled. This has been fixed in the latest thinkpad-acpi devel/backport versions and also kernel 2.6.26.

Application support

• GKrellM supports fan and thermal information
• Conky Displays the same information as GKrellM but displays it differently
• gaim-thinklight is a gaim plugin which makes the ThinkLight blink when a message arrives.
• pidgin-thinklight same as above but for pidgin
• gaim-lightthink is an alternative to gaim-thinklight.
• rocklight is a xmms visualization plugin that makes the ThinkLight flash to the beat of your music. The package also includes a standalone stroboscope mode program.
• GNOME Sensors Applet is a small gnome panel applet which shows the fan speed and thermal information. In Debian it's the sensors-applet package.
• ACPI fan control scripts can be used to control the system fan according to system temperatures (overriding the firmware)

Interesting links related to this project

• ibm-acpi Sourceforge project summary
• ibm-acpi-devel Mailinglist (List archive on gmane.org)
• Linux-Thinkpad Mailinglist
• acpi.sourceforge.net
• www.kernel.org

TODO	needs editing

: consider merging with Thinkpad-acpi