~mmach/netext73/lm-sensors

« back to all changes in this revision

Viewing changes to prog/pwm/pwmconfig.8

  • Committer: mmach
  • Date: 2020-02-05 20:28:34 UTC
  • Revision ID: netbit73@gmail.com-20200205202834-zc3sla47j9e700w5
3.6

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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 <jdelvare@suse.de>