Supported Devices

The following is a collection of information about supported devices.

liquidctl

Most of the liquidctl supported devices are listed on their project page: liquidctl
Note: Some devices are only partially supported or considered experimental

hwmon

By default, all detected and usable fan/pump controls are displayed by CoolerControl. To improve hardware coverage, the following steps are suggested:

How To

• Highly Recommended:
  • Install lm-sensors (lm_sensors) if not already installed. This is usually done through your distribution's package manager, i.e. apt, dnf, pacman.
  • run sudo sensors-detect at least once to make sure all available modules have been loaded.
    *In some rare cases your specified kernel module may need to be manually loaded
  • restart coolercontrold: sudo systemctl restart coolercontrold

More Info::

• HWMon wiki
• HWMon Kernel Drivers

To test hwmon sensors manually:

# determine the location for your particular device:
find /sys/class/hwmon/hwmon*/ -type f -name "name" -print -exec cat {} \;

# find the directory above that belongs to the device name you're looking for. 
# we'll use /sys/class/hwmon/hwmon4 in the rest of this example, but it can also change after a reboot.
# output the directory's contents to view available sysfs files:
ls -lh /sys/class/hwmon/hwmon4

Some examples for various tasks:

# read all pwm fan values:
find /sys/class/hwmon/hwmon4/ -type f -name "pwm?" -print -exec cat {} \;

# read all fan rpm values:
find /sys/class/hwmon/hwmon4/ -type f -name "fan?_input" -print -exec cat {} \;

# enable manual mode for fan1: (if present for your hardware)
echo 1 | sudo tee /sys/class/hwmon/hwmon4/pwm1_enable

# set a high pwm value (0-255):
echo 230 | sudo tee /sys/class/hwmon/hwmon4/pwm1

# when done, reset to automatic mode:
echo 2 | sudo tee /sys/class/hwmon/hwmon4/pwm1_enable

NVidia

Fan control has been tested working on most cards. CoolerControl automatically uses NVML and the CLI tools nvidia-settings and nvidia-smi as backup.

AMD GPU

• Older cards work out of the box. The 7000 series and above have different firmware controls and CoolerControl will work if you:
• enable the fan control feature by setting the kernel boot option: amdgpu.ppfeaturemask=0xffffffff.
• ⚠️ Be aware that regardless of the fan speed set, the fan will only turn on once a builtin (non-configurable) temperature threshold has been reached. In other words, the card needs to be under load for the fan settings to take effect. It has been reported that that the fans will generally start spining once the Junction Temperature reaches 60C and stop spinning at 50C.

ThinkPad Fans

There are two settings available in the UI to control ThinkPad fans, and they only show up when a ThinkPad device is found. The first setting is a convenience feature that enables fan control in the thinkpad_acpi kernel module, and the second is only for those people that want to have the highest fan speeds possible.
Both settings display a warning and require confirmation before being enabled as there is no warranty with CoolerControl.

New Devices

Your device isn't listed? See Adding Device Support