Skip to content
forked from cdown/zcfan

A zero-configuration fan daemon for ThinkPads.

License

Notifications You must be signed in to change notification settings

mr-wh1tehat/zcfan

 
 

Repository files navigation

zcfan | Tests

Zero-configuration fan control daemon for ThinkPads.

Features

  • Extremely small (~250 lines), simple, and easy to understand code
  • Sensible out of the box, configuration is optional (see "usage" below)
  • Strong focus on stopping the fan as soon as safe to do so, without inducing throttling
  • Automatic temperature- and time-based hysteresis: no bouncing between fan levels
  • Watchdog support
  • Minimal resource usage
  • No dependencies

Usage

zcfan has the following default fan states:

Config name thinkpad_acpi fan level Default trip temperature (C)
max_temp 7 90
med_temp 4 80
low_temp 1 70

If no trip temperature is reached, the fan will be turned off.

To override these defaults, you can place a file at /etc/zcfan.conf with updated trip temperatures in degrees celsius. As an example:

max_temp 85
med_temp 70
low_temp 55

Hysteresis

We will only reduce the fan level again once:

  1. The temperature is now at least 10C below the trip point, and
  2. At least 3 seconds have elapsed since the initial trip.

This avoids unnecessary fluctuations in fan speed.

Comparison with thinkfan

I write zcfan because I found thinkfan's configuration and code complexity too much for my tastes. Use whichever suits your needs.

Compilation

Run make.

Installation

  1. Compile zcfan or install from the AUR package
  2. Load your thinkpad_acpi module with fan_control=1
    • At runtime: rmmod thinkpad_acpi && modprobe thinkpad_acpi fan_control=1
    • By default: echo options thinkpad_acpi fan_control=1 > /etc/modprobe.d/99-fancontrol.conf
  3. Run zcfan as root (or use the zcfan systemd service provided) Ps: Or you can simply run 'install.sh' script in order to automate installation process. Warning: For the changes to take effect, please reboot your system once installed

Disclaimer

While the author uses this on their own machine, obviously there is no warranty whatsoever.

About

A zero-configuration fan daemon for ThinkPads.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 73.0%
  • Makefile 13.9%
  • Roff 10.6%
  • Shell 2.5%