ThinkWiki - User contributions [en]

Talk:Code/tp-fancontrol-fc.init

2007-02-13T14:06:53Z

Fikin:

{{CodeHeader|
|filename=tp-fancontrol
|context=[[ACPI fan control script#Init script example for rh/fedora]]
|author=Nikolay Fiykov
|license=GPL v2
}}

Code/tp-fancontrol-fc.init

2007-02-13T14:04:56Z

Fikin:

#!/bin/bash
#
# tp-fancontrol
#
# nikolay fiykov (fikin@sf.net)
#
# chkconfig: 2345 45 57
# description: Thinkpad fan controll utility
### BEGIN INIT INFO
# Provides: $fan-control
### END INIT INFO

# Source function library.
. /etc/init.d/functions

NAME=tp-fancontrold
APP=/sbin/${NAME}

[ -f ${APP} ] || exit 0

# Source config
# source config file; edit that file to configure this script
TEMP_SHIFT=0
LOG_SYSLOG=1
QUIET=1
if [ -e /etc/tp-fancontrol.conf ]; then
. /etc/tp-fancontrol.conf
fi

RETVAL=0

umask 077

start() {
echo -n $"Starting Thinkpad CPU fan control ... "

PARAMS="-d "
if [ "${TEMP_SHIFT}" != "0" ]
then
PARAMS=${PARAMS}" -s ${TEMP_SHIFT}"
fi
if [ "${LOG_SYSLOG}" = "1" ]
then
PARAMS=${PARAMS}" -l"
else
if [ "${QUIET}" = "1" ]
then
PARAMS=${PARAMS}" -q"
fi
fi
PARAMS=${PARAMS}

# load ibm acpi module (requires acpi daemon first)
modprobe ibm_acpi experimental=1 hotkey=enable,0xffef

daemon ${APP} ${PARAMS}
RETVAL=$?
echo
[ $RETVAL -eq 0 ] && touch /var/lock/subsys/${NAME}
return $RETVAL
}

stop() {
echo -n $"Shutting down Thinkpad CPU fan control: "
killproc ${APP}
RETVAL=$?
echo
[ $RETVAL -eq 0 ] && rm -f /var/lock/subsys/${NAME}
return $RETVAL
}
rhstatus() {
status ${APP}
}
restart() {
stop
start
}

case "$1" in
start)
start
;;
stop)
stop
;;
status)
rhstatus
;;
restart|reload)
restart
;;
condrestart)
[ -f /var/lock/subsys/${NAME} ] && restart || :
;;
*)
echo $"Usage: $0 {start|stop|status|restart|condrestart}"
exit 1
esac

exit $?

Talk:Code/tp-fancontrol-fc.init

2007-02-13T14:04:11Z

Fikin:

{{CodeHeader|
|filename=tp-fancontrol-fc
|context=[[ACPI fan control script#Init script example for rh/fedora]]
|author=Nikolay Fiykov
|license=GPL v2
}}

Talk:Code/tp-fancontrol-fc.init

2007-02-13T13:41:53Z

Fikin:

Fan control scripts

2007-02-13T13:35:37Z

Fikin: /* Init script example for rh/fedora */

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
|style="vertical-align:top" |
This page provides several scripts for controlling the ThinkPad's system fan according the its [[thermal sensors]] (overriding the embedded controller), in order to reduce [[problem with fan noise|fan noise]] and decrease [[how to reduce power consumption|power consumption]].

{{WARN|These scripts rely on undocumented hardware features and override nominal hardware behavior. They may thus cause arbitrary damage to your laptop or data. Watch your temperatures!}}
|}

==Variable speed control scripts==
The following scripts sets the fan speed according to the system's [[thermal sensors]]. In addition, they include a hack for preventing the annoying fan pulsing that occurs on some systems. Note that the fan levels, thresholds and anti-pulsing hacks are system-specific, so you may need to adjust them.

===Comprehensive <tt>bash</tt> script with fine control over fan speed===
This script works with any recent Linux kernel (2.6.14 and higher). It requires the [[ibm-acpi]] module to be loaded with the <tt>experimental=1</tt> module parameter (e.g., {{cmdroot|1=modprobe ibm_acpi experimental=1}}).

The code lets you define a temperature range for each [[thermal sensors|thermal sensor]]. The script computes the fan level needed by each sensor based on the configured range, and then sets the the actual fan level to the slowest that will satisfy all sensors (plus some hysteresis to avoid fluctiations). It also includes a workaround for the [[Problem with fan noise|pulsing noise]] problem. The scipt provides an (optional) daemon mode and logging to syslog. The method of controlling fan speed is documented [[How to control fan speed|here]].

The system hard disk temperature is monitored as well, using the hard disk's internal sensor. This works only on certain Hitachi disks and requires kernel >= 2.6.19-rc1 or the ide driver, since it uses a [[Thermal Sensors#Hitachi_harddisks_SENSE_CONDITION_temperature_sensor|non-standard method]] for reading the temperature without causing a head unload or spinup.

The code:
* {{CodeRef|tp-fancontrol}}

Current options:

Usage: ./tp-fancontrol [OPTION]...

Available options:
-s N Shift up the min temperature thresholds by N degrees
(positive for quieter, negative for cooler).
Max temperature thresholds are not affected.
-S N Shift up the max temperature thresholds by N degrees
(positive for quieter, negative for cooler). DANGEROUS.
-t Test mode
-q Quiet mode
-d Daemon mode, go into background (implies -q)
-l Log to syslog
-k Kill already-running daemon
-u Tell already-running daemon that the system is being suspended
-p Pid file location for daemon mode
{{WARN|The list of temperature ranges used in this script is much more liberal than the rules used by the embedded controller firmware, and is derived mostly from anecdotal evidence, hunches and wishful thinking. It is also model-specific - see [[thermal sensors]].}}

====init script for the comprehensive script====

This is optional. It assumes that the above <tt>tp-fancontrol</tt> script is saved at {{path|/usr/bin/tp-fancontrol}}.
* Init script: {{CodeRef|tp-fancontrol.init}} (save as {{path|/etc/init.d/tp-fancontrol}})
* Configuration file for init script: {{CodeRef|tp-fancontrol.conf}} (save as {{path|/etc/tp-fancontrol.conf}})

===Simple <tt>bash</tt> script with fine control over fan speed (requires kernel patch)===
The following is a simpler patch (without extra features like daemon mode and logging). It requires the [[patch for controlling fan speed]].

{{CodeRef|tp-fancontrol-basic}}

==Fan enable/disable scripts==
The following scripts were written before it was known [[patch for controlling fan speed|how to control the fan speed]], so they only toggle between fan disabled and default (noisy) fan behavior. In some models, they also do not monitor all available [[thermal sensors]].

===<tt>sh</tt> script example===
{{CodeRef|fan-enable-basic}}

===<tt>sh</tt> script with more features===
{{CodeRef|fan-enable-extended}}

===<tt>sh</tt> script with extra safety functionality===
ibm_acpi usually works well. But to rely on it completely, this script provides some extra safety functionality:
# It catches various signals and turns the fan on before it quits.
# It turns off the fan under very strict conditions, leaving it on when unexpected errors occur.

{{CodeRef|fan-enable-safe}}

==Init scripts==

===Init script example===

{{CodeRef|fan-enable.init}}

===Init script example for gentoo===
Assume one of the above control scripts is {{path|/usr/sbin/ibm-fancontrold}}, for gentoo use the following init script in /etc/init.d/ibm-fancontrol.
Copy the script to {{path|/etc/init.d/ibm-fancontrol}}, then do

# rc-update add ibm-fancontrol default

This will add the init script to the default runlevel.

{{CodeRef|ibm-fancontrol.init}}

===Init script example for rh/fedora===
Assume one of the above control scripts is {{path|/sbin/tp-fancontrold}},
copy the script to {{path|/etc/init.d/tp-fancontrol}}, then do

# chkconfig --add tp-fancontrol

This will add the init script to the default runlevel.

{{CodeRef|tp-fancontrol-fc.init}}

You'd have to install also "kernel-module-ibm-acpi" package.

==Other==

===fanctrld===
[http://log.does-not-exist.org/archives/2005/08/13/2043_t_43_fan_control_daemon.html fanctrld] is a daemon (written in C) that controls the Thinkpad's fan. The basic approach is to monitor both temperature and fan speed. The fan is enabled when a certain temperature is exceeded, and disabled when the BIOS slows down the fan below a certain speed.

==Ideas for improvement==
* Use the [[HDAPS]] sensor to automatically lower the temperature thresholds when the laptop is moving. Prolonged movement usually happens when the laptop is on the user's lap (see [[Problem with hot surfaces]] for implications), or when in a moving vehicle where fan noise is typically overshadowed by vehicle noise.
* Use a [http://en.wikipedia.org/wiki/PID_controller PID controller] feedback loop instead of simple thresholds.
* Monitor the UltraBay disk temperature too.

==See also==
* [[How to control fan speed]]
* Shimodax's ThinkPad fan control tool for a Windows offers functionality similar to these scripts; see the [http://forum.thinkpads.com/viewtopic.php?t=17715 forum discussion] at thinkpads.com.
* Yury Polyanskiy has a [http://mailman.linux-thinkpad.org/pipermail/linux-thinkpad/2005-November/030697.html kernel patch] for automatic fan control in kernelspace (only enable/disable based on maximum temperature).

[[Category:Scripts]]

Fan control scripts

2007-02-13T13:35:02Z

Fikin: /* Init script example for rh/fedora */

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
|style="vertical-align:top" |
This page provides several scripts for controlling the ThinkPad's system fan according the its [[thermal sensors]] (overriding the embedded controller), in order to reduce [[problem with fan noise|fan noise]] and decrease [[how to reduce power consumption|power consumption]].

{{WARN|These scripts rely on undocumented hardware features and override nominal hardware behavior. They may thus cause arbitrary damage to your laptop or data. Watch your temperatures!}}
|}

==Variable speed control scripts==
The following scripts sets the fan speed according to the system's [[thermal sensors]]. In addition, they include a hack for preventing the annoying fan pulsing that occurs on some systems. Note that the fan levels, thresholds and anti-pulsing hacks are system-specific, so you may need to adjust them.

===Comprehensive <tt>bash</tt> script with fine control over fan speed===
This script works with any recent Linux kernel (2.6.14 and higher). It requires the [[ibm-acpi]] module to be loaded with the <tt>experimental=1</tt> module parameter (e.g., {{cmdroot|1=modprobe ibm_acpi experimental=1}}).

The code lets you define a temperature range for each [[thermal sensors|thermal sensor]]. The script computes the fan level needed by each sensor based on the configured range, and then sets the the actual fan level to the slowest that will satisfy all sensors (plus some hysteresis to avoid fluctiations). It also includes a workaround for the [[Problem with fan noise|pulsing noise]] problem. The scipt provides an (optional) daemon mode and logging to syslog. The method of controlling fan speed is documented [[How to control fan speed|here]].

The system hard disk temperature is monitored as well, using the hard disk's internal sensor. This works only on certain Hitachi disks and requires kernel >= 2.6.19-rc1 or the ide driver, since it uses a [[Thermal Sensors#Hitachi_harddisks_SENSE_CONDITION_temperature_sensor|non-standard method]] for reading the temperature without causing a head unload or spinup.

The code:
* {{CodeRef|tp-fancontrol}}

Current options:

Usage: ./tp-fancontrol [OPTION]...

Available options:
-s N Shift up the min temperature thresholds by N degrees
(positive for quieter, negative for cooler).
Max temperature thresholds are not affected.
-S N Shift up the max temperature thresholds by N degrees
(positive for quieter, negative for cooler). DANGEROUS.
-t Test mode
-q Quiet mode
-d Daemon mode, go into background (implies -q)
-l Log to syslog
-k Kill already-running daemon
-u Tell already-running daemon that the system is being suspended
-p Pid file location for daemon mode
{{WARN|The list of temperature ranges used in this script is much more liberal than the rules used by the embedded controller firmware, and is derived mostly from anecdotal evidence, hunches and wishful thinking. It is also model-specific - see [[thermal sensors]].}}

====init script for the comprehensive script====

This is optional. It assumes that the above <tt>tp-fancontrol</tt> script is saved at {{path|/usr/bin/tp-fancontrol}}.
* Init script: {{CodeRef|tp-fancontrol.init}} (save as {{path|/etc/init.d/tp-fancontrol}})
* Configuration file for init script: {{CodeRef|tp-fancontrol.conf}} (save as {{path|/etc/tp-fancontrol.conf}})

===Simple <tt>bash</tt> script with fine control over fan speed (requires kernel patch)===
The following is a simpler patch (without extra features like daemon mode and logging). It requires the [[patch for controlling fan speed]].

{{CodeRef|tp-fancontrol-basic}}

==Fan enable/disable scripts==
The following scripts were written before it was known [[patch for controlling fan speed|how to control the fan speed]], so they only toggle between fan disabled and default (noisy) fan behavior. In some models, they also do not monitor all available [[thermal sensors]].

===<tt>sh</tt> script example===
{{CodeRef|fan-enable-basic}}

===<tt>sh</tt> script with more features===
{{CodeRef|fan-enable-extended}}

===<tt>sh</tt> script with extra safety functionality===
ibm_acpi usually works well. But to rely on it completely, this script provides some extra safety functionality:
# It catches various signals and turns the fan on before it quits.
# It turns off the fan under very strict conditions, leaving it on when unexpected errors occur.

{{CodeRef|fan-enable-safe}}

==Init scripts==

===Init script example===

{{CodeRef|fan-enable.init}}

===Init script example for gentoo===
Assume one of the above control scripts is {{path|/usr/sbin/ibm-fancontrold}}, for gentoo use the following init script in /etc/init.d/ibm-fancontrol.
Copy the script to {{path|/etc/init.d/ibm-fancontrol}}, then do

# rc-update add ibm-fancontrol default

This will add the init script to the default runlevel.

{{CodeRef|ibm-fancontrol.init}}

===Init script example for rh/fedora===
Assume one of the above control scripts is {{path|/sbin/tp-fancontrold}},
copy the script to {{path|/etc/init.d/tp-fancontrol}}, then do

# chkconfig --add tp-fancontrol

This will add the init script to the default runlevel.

{{CodeRef|tp-fancontrol-fc.init}}

You'd have to install also "kernel-module-ibm-acpi" and "ibm-acpi" packages.

==Other==

===fanctrld===
[http://log.does-not-exist.org/archives/2005/08/13/2043_t_43_fan_control_daemon.html fanctrld] is a daemon (written in C) that controls the Thinkpad's fan. The basic approach is to monitor both temperature and fan speed. The fan is enabled when a certain temperature is exceeded, and disabled when the BIOS slows down the fan below a certain speed.

==Ideas for improvement==
* Use the [[HDAPS]] sensor to automatically lower the temperature thresholds when the laptop is moving. Prolonged movement usually happens when the laptop is on the user's lap (see [[Problem with hot surfaces]] for implications), or when in a moving vehicle where fan noise is typically overshadowed by vehicle noise.
* Use a [http://en.wikipedia.org/wiki/PID_controller PID controller] feedback loop instead of simple thresholds.
* Monitor the UltraBay disk temperature too.

==See also==
* [[How to control fan speed]]
* Shimodax's ThinkPad fan control tool for a Windows offers functionality similar to these scripts; see the [http://forum.thinkpads.com/viewtopic.php?t=17715 forum discussion] at thinkpads.com.
* Yury Polyanskiy has a [http://mailman.linux-thinkpad.org/pipermail/linux-thinkpad/2005-November/030697.html kernel patch] for automatic fan control in kernelspace (only enable/disable based on maximum temperature).

[[Category:Scripts]]

Talk:Code/tp-fancontrol-fc.init

2007-02-13T13:32:53Z

Fikin:

Fan control scripts

2007-02-13T13:32:20Z

Fikin: /* Init script example for rh/fedora */

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
|style="vertical-align:top" |
This page provides several scripts for controlling the ThinkPad's system fan according the its [[thermal sensors]] (overriding the embedded controller), in order to reduce [[problem with fan noise|fan noise]] and decrease [[how to reduce power consumption|power consumption]].

{{WARN|These scripts rely on undocumented hardware features and override nominal hardware behavior. They may thus cause arbitrary damage to your laptop or data. Watch your temperatures!}}
|}

==Variable speed control scripts==
The following scripts sets the fan speed according to the system's [[thermal sensors]]. In addition, they include a hack for preventing the annoying fan pulsing that occurs on some systems. Note that the fan levels, thresholds and anti-pulsing hacks are system-specific, so you may need to adjust them.

===Comprehensive <tt>bash</tt> script with fine control over fan speed===
This script works with any recent Linux kernel (2.6.14 and higher). It requires the [[ibm-acpi]] module to be loaded with the <tt>experimental=1</tt> module parameter (e.g., {{cmdroot|1=modprobe ibm_acpi experimental=1}}).

The code lets you define a temperature range for each [[thermal sensors|thermal sensor]]. The script computes the fan level needed by each sensor based on the configured range, and then sets the the actual fan level to the slowest that will satisfy all sensors (plus some hysteresis to avoid fluctiations). It also includes a workaround for the [[Problem with fan noise|pulsing noise]] problem. The scipt provides an (optional) daemon mode and logging to syslog. The method of controlling fan speed is documented [[How to control fan speed|here]].

The system hard disk temperature is monitored as well, using the hard disk's internal sensor. This works only on certain Hitachi disks and requires kernel >= 2.6.19-rc1 or the ide driver, since it uses a [[Thermal Sensors#Hitachi_harddisks_SENSE_CONDITION_temperature_sensor|non-standard method]] for reading the temperature without causing a head unload or spinup.

The code:
* {{CodeRef|tp-fancontrol}}

Current options:

Usage: ./tp-fancontrol [OPTION]...

Available options:
-s N Shift up the min temperature thresholds by N degrees
(positive for quieter, negative for cooler).
Max temperature thresholds are not affected.
-S N Shift up the max temperature thresholds by N degrees
(positive for quieter, negative for cooler). DANGEROUS.
-t Test mode
-q Quiet mode
-d Daemon mode, go into background (implies -q)
-l Log to syslog
-k Kill already-running daemon
-u Tell already-running daemon that the system is being suspended
-p Pid file location for daemon mode
{{WARN|The list of temperature ranges used in this script is much more liberal than the rules used by the embedded controller firmware, and is derived mostly from anecdotal evidence, hunches and wishful thinking. It is also model-specific - see [[thermal sensors]].}}

====init script for the comprehensive script====

This is optional. It assumes that the above <tt>tp-fancontrol</tt> script is saved at {{path|/usr/bin/tp-fancontrol}}.
* Init script: {{CodeRef|tp-fancontrol.init}} (save as {{path|/etc/init.d/tp-fancontrol}})
* Configuration file for init script: {{CodeRef|tp-fancontrol.conf}} (save as {{path|/etc/tp-fancontrol.conf}})

===Simple <tt>bash</tt> script with fine control over fan speed (requires kernel patch)===
The following is a simpler patch (without extra features like daemon mode and logging). It requires the [[patch for controlling fan speed]].

{{CodeRef|tp-fancontrol-basic}}

==Fan enable/disable scripts==
The following scripts were written before it was known [[patch for controlling fan speed|how to control the fan speed]], so they only toggle between fan disabled and default (noisy) fan behavior. In some models, they also do not monitor all available [[thermal sensors]].

===<tt>sh</tt> script example===
{{CodeRef|fan-enable-basic}}

===<tt>sh</tt> script with more features===
{{CodeRef|fan-enable-extended}}

===<tt>sh</tt> script with extra safety functionality===
ibm_acpi usually works well. But to rely on it completely, this script provides some extra safety functionality:
# It catches various signals and turns the fan on before it quits.
# It turns off the fan under very strict conditions, leaving it on when unexpected errors occur.

{{CodeRef|fan-enable-safe}}

==Init scripts==

===Init script example===

{{CodeRef|fan-enable.init}}

===Init script example for gentoo===
Assume one of the above control scripts is {{path|/usr/sbin/ibm-fancontrold}}, for gentoo use the following init script in /etc/init.d/ibm-fancontrol.
Copy the script to {{path|/etc/init.d/ibm-fancontrol}}, then do

# rc-update add ibm-fancontrol default

This will add the init script to the default runlevel.

{{CodeRef|ibm-fancontrol.init}}

===Init script example for rh/fedora===
Assume one of the above control scripts is {{path|/sbin/tp-fancontrold}},
copy the script to {{path|/etc/init.d/tp-fancontrol}}, then do

# chkconfig --add tp-fancontrol

This will add the init script to the default runlevel.

{{CodeRef|tp-fancontrol-fc.init}}

==Other==

===fanctrld===
[http://log.does-not-exist.org/archives/2005/08/13/2043_t_43_fan_control_daemon.html fanctrld] is a daemon (written in C) that controls the Thinkpad's fan. The basic approach is to monitor both temperature and fan speed. The fan is enabled when a certain temperature is exceeded, and disabled when the BIOS slows down the fan below a certain speed.

==Ideas for improvement==
* Use the [[HDAPS]] sensor to automatically lower the temperature thresholds when the laptop is moving. Prolonged movement usually happens when the laptop is on the user's lap (see [[Problem with hot surfaces]] for implications), or when in a moving vehicle where fan noise is typically overshadowed by vehicle noise.
* Use a [http://en.wikipedia.org/wiki/PID_controller PID controller] feedback loop instead of simple thresholds.
* Monitor the UltraBay disk temperature too.

==See also==
* [[How to control fan speed]]
* Shimodax's ThinkPad fan control tool for a Windows offers functionality similar to these scripts; see the [http://forum.thinkpads.com/viewtopic.php?t=17715 forum discussion] at thinkpads.com.
* Yury Polyanskiy has a [http://mailman.linux-thinkpad.org/pipermail/linux-thinkpad/2005-November/030697.html kernel patch] for automatic fan control in kernelspace (only enable/disable based on maximum temperature).

[[Category:Scripts]]

Fan control scripts

2007-02-13T13:31:18Z

Fikin: /* Init script example for rh/fedora */

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
|style="vertical-align:top" |
This page provides several scripts for controlling the ThinkPad's system fan according the its [[thermal sensors]] (overriding the embedded controller), in order to reduce [[problem with fan noise|fan noise]] and decrease [[how to reduce power consumption|power consumption]].

{{WARN|These scripts rely on undocumented hardware features and override nominal hardware behavior. They may thus cause arbitrary damage to your laptop or data. Watch your temperatures!}}
|}

==Variable speed control scripts==
The following scripts sets the fan speed according to the system's [[thermal sensors]]. In addition, they include a hack for preventing the annoying fan pulsing that occurs on some systems. Note that the fan levels, thresholds and anti-pulsing hacks are system-specific, so you may need to adjust them.

===Comprehensive <tt>bash</tt> script with fine control over fan speed===
This script works with any recent Linux kernel (2.6.14 and higher). It requires the [[ibm-acpi]] module to be loaded with the <tt>experimental=1</tt> module parameter (e.g., {{cmdroot|1=modprobe ibm_acpi experimental=1}}).

The code lets you define a temperature range for each [[thermal sensors|thermal sensor]]. The script computes the fan level needed by each sensor based on the configured range, and then sets the the actual fan level to the slowest that will satisfy all sensors (plus some hysteresis to avoid fluctiations). It also includes a workaround for the [[Problem with fan noise|pulsing noise]] problem. The scipt provides an (optional) daemon mode and logging to syslog. The method of controlling fan speed is documented [[How to control fan speed|here]].

The system hard disk temperature is monitored as well, using the hard disk's internal sensor. This works only on certain Hitachi disks and requires kernel >= 2.6.19-rc1 or the ide driver, since it uses a [[Thermal Sensors#Hitachi_harddisks_SENSE_CONDITION_temperature_sensor|non-standard method]] for reading the temperature without causing a head unload or spinup.

The code:
* {{CodeRef|tp-fancontrol}}

Current options:

Usage: ./tp-fancontrol [OPTION]...

Available options:
-s N Shift up the min temperature thresholds by N degrees
(positive for quieter, negative for cooler).
Max temperature thresholds are not affected.
-S N Shift up the max temperature thresholds by N degrees
(positive for quieter, negative for cooler). DANGEROUS.
-t Test mode
-q Quiet mode
-d Daemon mode, go into background (implies -q)
-l Log to syslog
-k Kill already-running daemon
-u Tell already-running daemon that the system is being suspended
-p Pid file location for daemon mode
{{WARN|The list of temperature ranges used in this script is much more liberal than the rules used by the embedded controller firmware, and is derived mostly from anecdotal evidence, hunches and wishful thinking. It is also model-specific - see [[thermal sensors]].}}

====init script for the comprehensive script====

This is optional. It assumes that the above <tt>tp-fancontrol</tt> script is saved at {{path|/usr/bin/tp-fancontrol}}.
* Init script: {{CodeRef|tp-fancontrol.init}} (save as {{path|/etc/init.d/tp-fancontrol}})
* Configuration file for init script: {{CodeRef|tp-fancontrol.conf}} (save as {{path|/etc/tp-fancontrol.conf}})

===Simple <tt>bash</tt> script with fine control over fan speed (requires kernel patch)===
The following is a simpler patch (without extra features like daemon mode and logging). It requires the [[patch for controlling fan speed]].

{{CodeRef|tp-fancontrol-basic}}

==Fan enable/disable scripts==
The following scripts were written before it was known [[patch for controlling fan speed|how to control the fan speed]], so they only toggle between fan disabled and default (noisy) fan behavior. In some models, they also do not monitor all available [[thermal sensors]].

===<tt>sh</tt> script example===
{{CodeRef|fan-enable-basic}}

===<tt>sh</tt> script with more features===
{{CodeRef|fan-enable-extended}}

===<tt>sh</tt> script with extra safety functionality===
ibm_acpi usually works well. But to rely on it completely, this script provides some extra safety functionality:
# It catches various signals and turns the fan on before it quits.
# It turns off the fan under very strict conditions, leaving it on when unexpected errors occur.

{{CodeRef|fan-enable-safe}}

==Init scripts==

===Init script example===

{{CodeRef|fan-enable.init}}

===Init script example for gentoo===
Assume one of the above control scripts is {{path|/usr/sbin/ibm-fancontrold}}, for gentoo use the following init script in /etc/init.d/ibm-fancontrol.
Copy the script to {{path|/etc/init.d/ibm-fancontrol}}, then do

# rc-update add ibm-fancontrol default

This will add the init script to the default runlevel.

{{CodeRef|ibm-fancontrol.init}}

===Init script example for rh/fedora===
Assume one of the above control scripts is {{path|/sbin/tp-fancontrold}},
copy the script to {{path|/etc/init.d/tp-fancontrol}}, then do

# chkconfig --add tp-fancontrol

This will add the init script to the default runlevel.

{{CodeRef|tp-fancontrol.init}}

==Other==

===fanctrld===
[http://log.does-not-exist.org/archives/2005/08/13/2043_t_43_fan_control_daemon.html fanctrld] is a daemon (written in C) that controls the Thinkpad's fan. The basic approach is to monitor both temperature and fan speed. The fan is enabled when a certain temperature is exceeded, and disabled when the BIOS slows down the fan below a certain speed.

==Ideas for improvement==
* Use the [[HDAPS]] sensor to automatically lower the temperature thresholds when the laptop is moving. Prolonged movement usually happens when the laptop is on the user's lap (see [[Problem with hot surfaces]] for implications), or when in a moving vehicle where fan noise is typically overshadowed by vehicle noise.
* Use a [http://en.wikipedia.org/wiki/PID_controller PID controller] feedback loop instead of simple thresholds.
* Monitor the UltraBay disk temperature too.

==See also==
* [[How to control fan speed]]
* Shimodax's ThinkPad fan control tool for a Windows offers functionality similar to these scripts; see the [http://forum.thinkpads.com/viewtopic.php?t=17715 forum discussion] at thinkpads.com.
* Yury Polyanskiy has a [http://mailman.linux-thinkpad.org/pipermail/linux-thinkpad/2005-November/030697.html kernel patch] for automatic fan control in kernelspace (only enable/disable based on maximum temperature).

[[Category:Scripts]]

Fan control scripts

2007-02-13T13:28:47Z

Fikin: /* Init scripts */

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
|style="vertical-align:top" |
This page provides several scripts for controlling the ThinkPad's system fan according the its [[thermal sensors]] (overriding the embedded controller), in order to reduce [[problem with fan noise|fan noise]] and decrease [[how to reduce power consumption|power consumption]].

{{WARN|These scripts rely on undocumented hardware features and override nominal hardware behavior. They may thus cause arbitrary damage to your laptop or data. Watch your temperatures!}}
|}

==Variable speed control scripts==
The following scripts sets the fan speed according to the system's [[thermal sensors]]. In addition, they include a hack for preventing the annoying fan pulsing that occurs on some systems. Note that the fan levels, thresholds and anti-pulsing hacks are system-specific, so you may need to adjust them.

===Comprehensive <tt>bash</tt> script with fine control over fan speed===
This script works with any recent Linux kernel (2.6.14 and higher). It requires the [[ibm-acpi]] module to be loaded with the <tt>experimental=1</tt> module parameter (e.g., {{cmdroot|1=modprobe ibm_acpi experimental=1}}).

The code lets you define a temperature range for each [[thermal sensors|thermal sensor]]. The script computes the fan level needed by each sensor based on the configured range, and then sets the the actual fan level to the slowest that will satisfy all sensors (plus some hysteresis to avoid fluctiations). It also includes a workaround for the [[Problem with fan noise|pulsing noise]] problem. The scipt provides an (optional) daemon mode and logging to syslog. The method of controlling fan speed is documented [[How to control fan speed|here]].

The system hard disk temperature is monitored as well, using the hard disk's internal sensor. This works only on certain Hitachi disks and requires kernel >= 2.6.19-rc1 or the ide driver, since it uses a [[Thermal Sensors#Hitachi_harddisks_SENSE_CONDITION_temperature_sensor|non-standard method]] for reading the temperature without causing a head unload or spinup.

The code:
* {{CodeRef|tp-fancontrol}}

Current options:

Usage: ./tp-fancontrol [OPTION]...

Available options:
-s N Shift up the min temperature thresholds by N degrees
(positive for quieter, negative for cooler).
Max temperature thresholds are not affected.
-S N Shift up the max temperature thresholds by N degrees
(positive for quieter, negative for cooler). DANGEROUS.
-t Test mode
-q Quiet mode
-d Daemon mode, go into background (implies -q)
-l Log to syslog
-k Kill already-running daemon
-u Tell already-running daemon that the system is being suspended
-p Pid file location for daemon mode
{{WARN|The list of temperature ranges used in this script is much more liberal than the rules used by the embedded controller firmware, and is derived mostly from anecdotal evidence, hunches and wishful thinking. It is also model-specific - see [[thermal sensors]].}}

====init script for the comprehensive script====

This is optional. It assumes that the above <tt>tp-fancontrol</tt> script is saved at {{path|/usr/bin/tp-fancontrol}}.
* Init script: {{CodeRef|tp-fancontrol.init}} (save as {{path|/etc/init.d/tp-fancontrol}})
* Configuration file for init script: {{CodeRef|tp-fancontrol.conf}} (save as {{path|/etc/tp-fancontrol.conf}})

===Simple <tt>bash</tt> script with fine control over fan speed (requires kernel patch)===
The following is a simpler patch (without extra features like daemon mode and logging). It requires the [[patch for controlling fan speed]].

{{CodeRef|tp-fancontrol-basic}}

==Fan enable/disable scripts==
The following scripts were written before it was known [[patch for controlling fan speed|how to control the fan speed]], so they only toggle between fan disabled and default (noisy) fan behavior. In some models, they also do not monitor all available [[thermal sensors]].

===<tt>sh</tt> script example===
{{CodeRef|fan-enable-basic}}

===<tt>sh</tt> script with more features===
{{CodeRef|fan-enable-extended}}

===<tt>sh</tt> script with extra safety functionality===
ibm_acpi usually works well. But to rely on it completely, this script provides some extra safety functionality:
# It catches various signals and turns the fan on before it quits.
# It turns off the fan under very strict conditions, leaving it on when unexpected errors occur.

{{CodeRef|fan-enable-safe}}

==Init scripts==

===Init script example===

{{CodeRef|fan-enable.init}}

===Init script example for gentoo===
Assume one of the above control scripts is {{path|/usr/sbin/ibm-fancontrold}}, for gentoo use the following init script in /etc/init.d/ibm-fancontrol.
Copy the script to {{path|/etc/init.d/ibm-fancontrol}}, then do

# rc-update add ibm-fancontrol default

This will add the init script to the default runlevel.

{{CodeRef|ibm-fancontrol.init}}

===Init script example for rh/fedora===
Assume one of the above control scripts is {{path|/usr/local/bin/tp-fancontrold}},
copy the script to {{path|/etc/init.d/tp-fancontrol}}, then do

# chkconfig --add tp-fancontrol

This will add the init script to the default runlevel.

{{CodeRef|tp-fancontrol.init}}

==Other==

===fanctrld===
[http://log.does-not-exist.org/archives/2005/08/13/2043_t_43_fan_control_daemon.html fanctrld] is a daemon (written in C) that controls the Thinkpad's fan. The basic approach is to monitor both temperature and fan speed. The fan is enabled when a certain temperature is exceeded, and disabled when the BIOS slows down the fan below a certain speed.

==Ideas for improvement==
* Use the [[HDAPS]] sensor to automatically lower the temperature thresholds when the laptop is moving. Prolonged movement usually happens when the laptop is on the user's lap (see [[Problem with hot surfaces]] for implications), or when in a moving vehicle where fan noise is typically overshadowed by vehicle noise.
* Use a [http://en.wikipedia.org/wiki/PID_controller PID controller] feedback loop instead of simple thresholds.
* Monitor the UltraBay disk temperature too.

==See also==
* [[How to control fan speed]]
* Shimodax's ThinkPad fan control tool for a Windows offers functionality similar to these scripts; see the [http://forum.thinkpads.com/viewtopic.php?t=17715 forum discussion] at thinkpads.com.
* Yury Polyanskiy has a [http://mailman.linux-thinkpad.org/pipermail/linux-thinkpad/2005-November/030697.html kernel patch] for automatic fan control in kernelspace (only enable/disable based on maximum temperature).

[[Category:Scripts]]