diff options
Diffstat (limited to 'Documentation/ibm-acpi.txt')
-rw-r--r-- | Documentation/ibm-acpi.txt | 85 |
1 files changed, 25 insertions, 60 deletions
diff --git a/Documentation/ibm-acpi.txt b/Documentation/ibm-acpi.txt index cdcef016907a..f409f4bbdc47 100644 --- a/Documentation/ibm-acpi.txt +++ b/Documentation/ibm-acpi.txt | |||
@@ -1,16 +1,17 @@ | |||
1 | IBM ThinkPad ACPI Extras Driver | 1 | IBM ThinkPad ACPI Extras Driver |
2 | 2 | ||
3 | Version 0.12 | 3 | Version 0.13 |
4 | 17 August 2005 | 4 | 31 December 2006 |
5 | 5 | ||
6 | Borislav Deianov <borislav@users.sf.net> | 6 | Borislav Deianov <borislav@users.sf.net> |
7 | Henrique de Moraes Holschuh <hmh@hmh.eng.br> | ||
7 | http://ibm-acpi.sf.net/ | 8 | http://ibm-acpi.sf.net/ |
8 | 9 | ||
9 | 10 | ||
10 | This is a Linux ACPI driver for the IBM ThinkPad laptops. It supports | 11 | This is a Linux ACPI driver for the IBM ThinkPad laptops. It supports |
11 | various features of these laptops which are accessible through the | 12 | various features of these laptops which are accessible through the |
12 | ACPI framework but not otherwise supported by the generic Linux ACPI | 13 | ACPI framework but not otherwise fully supported by the generic Linux |
13 | drivers. | 14 | ACPI drivers. |
14 | 15 | ||
15 | 16 | ||
16 | Status | 17 | Status |
@@ -638,6 +639,26 @@ The ThinkPad's ACPI DSDT code will reprogram the fan on its own when | |||
638 | certain conditions are met. It will override any fan programming done | 639 | certain conditions are met. It will override any fan programming done |
639 | through ibm-acpi. | 640 | through ibm-acpi. |
640 | 641 | ||
642 | The ibm-acpi kernel driver can be programmed to revert the fan level | ||
643 | to a safe setting if userspace does not issue one of the fan commands: | ||
644 | "enable", "disable", "level" or "watchdog" within a configurable | ||
645 | ammount of time. To do this, use the "watchdog" command. | ||
646 | |||
647 | echo 'watchdog <interval>' > /proc/acpi/ibm/fan | ||
648 | |||
649 | Interval is the ammount of time in seconds to wait for one of the | ||
650 | above mentioned fan commands before reseting the fan level to a safe | ||
651 | one. If set to zero, the watchdog is disabled (default). When the | ||
652 | watchdog timer runs out, it does the exact equivalent of the "enable" | ||
653 | fan command. | ||
654 | |||
655 | Note that the watchdog timer stops after it enables the fan. It will | ||
656 | be rearmed again automatically (using the same interval) when one of | ||
657 | the above mentioned fan commands is received. The fan watchdog is, | ||
658 | therefore, not suitable to protect against fan mode changes made | ||
659 | through means other than the "enable", "disable", and "level" fan | ||
660 | commands. | ||
661 | |||
641 | EXPERIMENTAL: WAN -- /proc/acpi/ibm/wan | 662 | EXPERIMENTAL: WAN -- /proc/acpi/ibm/wan |
642 | --------------------------------------- | 663 | --------------------------------------- |
643 | 664 | ||
@@ -670,59 +691,3 @@ example: | |||
670 | 691 | ||
671 | modprobe ibm_acpi hotkey=enable,0xffff video=auto_disable | 692 | modprobe ibm_acpi hotkey=enable,0xffff video=auto_disable |
672 | 693 | ||
673 | The ibm-acpi kernel driver can be programmed to revert the fan level | ||
674 | to a safe setting if userspace does not issue one of the fan commands: | ||
675 | "enable", "disable", "level" or "watchdog" within a configurable | ||
676 | ammount of time. To do this, use the "watchdog" command. | ||
677 | |||
678 | echo 'watchdog <interval>' > /proc/acpi/ibm/fan | ||
679 | |||
680 | Interval is the ammount of time in seconds to wait for one of the | ||
681 | above mentioned fan commands before reseting the fan level to a safe | ||
682 | one. If set to zero, the watchdog is disabled (default). When the | ||
683 | watchdog timer runs out, it does the exact equivalent of the "enable" | ||
684 | fan command. | ||
685 | |||
686 | Note that the watchdog timer stops after it enables the fan. It will | ||
687 | be rearmed again automatically (using the same interval) when one of | ||
688 | the above mentioned fan commands is received. The fan watchdog is, | ||
689 | therefore, not suitable to protect against fan mode changes made | ||
690 | through means other than the "enable", "disable", and "level" fan | ||
691 | commands. | ||
692 | |||
693 | |||
694 | Example Configuration | ||
695 | --------------------- | ||
696 | |||
697 | The ACPI support in the kernel is intended to be used in conjunction | ||
698 | with a user-space daemon, acpid. The configuration files for this | ||
699 | daemon control what actions are taken in response to various ACPI | ||
700 | events. An example set of configuration files are included in the | ||
701 | config/ directory of the tarball package available on the web | ||
702 | site. Note that these are provided for illustration purposes only and | ||
703 | may need to be adapted to your particular setup. | ||
704 | |||
705 | The following utility scripts are used by the example action | ||
706 | scripts (included with ibm-acpi for completeness): | ||
707 | |||
708 | /usr/local/sbin/idectl -- from the hdparm source distribution, | ||
709 | see http://www.ibiblio.org/pub/Linux/system/hardware | ||
710 | /usr/local/sbin/laptop_mode -- from the Linux kernel source | ||
711 | distribution, see Documentation/laptop-mode.txt | ||
712 | /sbin/service -- comes with Redhat/Fedora distributions | ||
713 | /usr/sbin/hibernate -- from the Software Suspend 2 distribution, | ||
714 | see http://softwaresuspend.berlios.de/ | ||
715 | |||
716 | Toan T Nguyen <ntt@physics.ucla.edu> notes that Suse uses the | ||
717 | powersave program to suspend ('powersave --suspend-to-ram') or | ||
718 | hibernate ('powersave --suspend-to-disk'). This means that the | ||
719 | hibernate script is not needed on that distribution. | ||
720 | |||
721 | Henrik Brix Andersen <brix@gentoo.org> has written a Gentoo ACPI event | ||
722 | handler script for the X31. You can get the latest version from | ||
723 | http://dev.gentoo.org/~brix/files/x31.sh | ||
724 | |||
725 | David Schweikert <dws@ee.eth.ch> has written an alternative blank.sh | ||
726 | script which works on Debian systems. This scripts has now been | ||
727 | extended to also work on Fedora systems and included as the default | ||
728 | blank.sh in the distribution. | ||