| 1 |
.TH PWMCONFIG 8 "September 28, 2008" "lm-sensors 3" |
| 2 |
.SH NAME |
| 3 |
pwmconfig \- tests the PWM outputs of sensors and configures fancontrol |
| 4 |
|
| 5 |
.SH SYNOPSIS |
| 6 |
.B pwmconfig |
| 7 |
|
| 8 |
.SH WARNING |
| 9 |
\fBpwmconfig\fR will attempt to stop your fans, one at a time, for |
| 10 |
approximately 5 seconds each. This may cause your processor |
| 11 |
temperature to rise. Verify that all fans are running at normal speed |
| 12 |
after this program has exited. |
| 13 |
\fBpwmconfig\fR does its best to check that the fans are spinning when |
| 14 |
they are supposed to, but due to the diversity of available |
| 15 |
motherboards and fans, it shouldn't be blindly trusted. Always verify |
| 16 |
by yourself. |
| 17 |
|
| 18 |
It is strongly recommended to run \fBpwmconfig\fR at a time when there |
| 19 |
is no significant system load, to minimize the risk of overheating. |
| 20 |
|
| 21 |
.SH DESCRIPTION |
| 22 |
.B pwmconfig |
| 23 |
searches your sensors for pulse width modulation (PWM) |
| 24 |
controls, and tests each one to see if it controls a fan on |
| 25 |
your motherboard. Note that many motherboards do not have PWM |
| 26 |
circuitry installed, even if your sensor chip supports PWM. |
| 27 |
|
| 28 |
When a connection is established between a PWM control and a fan, |
| 29 |
\fBpwmconfig\fR can generate a detailed correlation, to show how a |
| 30 |
given fan is responding to various PWM duty cycles. |
| 31 |
|
| 32 |
Lastly, \fBpwmconfig\fR will enter in \fBfancontrol\fR configuration |
| 33 |
mode (unless you decide to skip that part.) In this mode, you are |
| 34 |
invited to enter several parameters which will determine how the |
| 35 |
\fBfancontrol\fR daemon regulates the speed of one or more fans in |
| 36 |
your system based on temperature measurements. In particular, you will |
| 37 |
have the opportunity to establish mappings between fans and |
| 38 |
temperature inputs, define the temperature range over which the speed |
| 39 |
of the fan should be adjusted dynamically, the minimum speed at which |
| 40 |
the fan should spin, etc. See fancontrol(8) for additional |
| 41 |
information. |
| 42 |
|
| 43 |
.SH BUGS |
| 44 |
The term "PWM" is used because most fan control systems in computers |
| 45 |
are based on pulse width modulation. Some motherboards however use DC |
| 46 |
variation instead. So, the term "PWM" should be seen as a generic term |
| 47 |
for "fan speed control", regardless of the actual method used. |
| 48 |
|
| 49 |
.SH SEE ALSO |
| 50 |
fancontrol(8), sensors(1). |
| 51 |
|
| 52 |
.SH AUTHORS |
| 53 |
.PP |
| 54 |
Marius Reiner <[email protected]>, |
| 55 |
Jean Delvare <[email protected]> |