| 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 <marius.reiner@hdev.de>, |
|---|
| 55 | Jean Delvare <khali@linux-fr.org> |
|---|
