NAME

       pwmconfig - tests the PWM outputs of sensors and configures fancontrol

SYNOPSIS

       pwmconfig

WARNING

       pwmconfig will attempt to stop your fans, one at a time, for approximately 5 seconds each. This may cause
       your processor temperature to rise. Verify that all fans are running at normal speed after  this  program
       has  exited.   pwmconfig does its best to check that the fans are spinning when they are supposed to, but
       due to the diversity of available motherboards and fans, it shouldn't be blindly trusted.  Always  verify
       by yourself.

       It  is  strongly  recommended  to  run  pwmconfig  at a time when there is no significant system load, to
       minimize the risk of overheating.

DESCRIPTION

       pwmconfig searches your sensors for pulse width modulation (PWM) controls, and tests each one to  see  if
       it  controls  a fan on your motherboard. Note that many motherboards do not have PWM circuitry installed,
       even if your sensor chip supports PWM.

       When a connection is established between a PWM control and a  fan,  pwmconfig  can  generate  a  detailed
       correlation, to show how a given fan is responding to various PWM duty cycles.

       Lastly,  pwmconfig  will enter in fancontrol configuration mode (unless you decide to skip that part.) In
       this mode, you are invited to enter several parameters which will determine  how  the  fancontrol  daemon
       regulates  the speed of one or more fans in your system based on temperature measurements. In particular,
       you will have the opportunity to establish mappings between  fans  and  temperature  inputs,  define  the
       temperature  range  over  which the speed of the fan should be adjusted dynamically, the minimum speed at
       which the fan should spin, etc. See fancontrol(8) for additional information.

BUGS

       The term "PWM" is used because most fan control systems in computers are based on pulse width modulation.
       Some  motherboards  however use DC variation instead. So, the term "PWM" should be seen as a generic term
       for "fan speed control", regardless of the actual method used.

SEE ALSO

       fancontrol(8), sensors(1).

AUTHORS

       Marius Reiner <marius.reiner@hdev.de>, Jean Delvare <jdelvare@suse.de>