Debian Codegraph @

prog/pwm/vt1211_pwm.8

raw
1 .TH VT1211_PWM 8 "July 2008" "lm-sensors 3"
2 .SH NAME
3 vt1211_pwm \- manual control of VIA vt1211 PWM outputs
4
5 .SH SYNOPSIS
6 .B vt1211_pwm
7 .B -d | -i <pwm> | -r <pwm> | -s <pwm>,<val>
8
9 .SH DESCRIPTION
10 \fBvt1211_pwm\fP is a shell script that provides manual control of the two PWM
11 outputs of the VIA vt1211 Super-I/O device.
12
13 .SH OPTIONS
14 .TP
15 .B -d
16 Display the current settings of the two PWM outputs.
17 .TP
18 .B -i <pwm>
19 Initialize PWM \fB<pwm>\fP for manual control. Valid numbers for \fB<pwm>\fP
20 are 1 or 2. This option also writes the original vt1211 register values to
21 ~/.vt1211_pwm\fB<pwm>\fP which is used for restoring the original settings.
22 .TP
23 .B -r <pwm>
24 Restore PWM \fB<pwm>\fP to the original settings. Valid numbers for \fB<pwm>\fP
25 are 1 or 2. This options reads the original settings from
26 ~/.vt1211_pwm\fB<pwm>\fP and writes them to the vt1211.
27 .TP
28 .B -s <pwm>,<val>
29 Set PMW \fB<pwm>\fP output to \fB<val>\fP. Valid numbers for \fB<pwm>\fP are 1
30 or 2 and valid numbers for \fB<val>\fP are 0 to 255. The \fB<val>\fP range of
31 0-255 maps to an output duty-cycle of 0%-100%, i.e., output duty-cycle =
32 \fB<val>\fP * 100 / 255.
33
34 .SH REQUIREMENTS
35 You need root privileges to execute the vt1211_pwm script and the vt1211 kernel
36 module needs to be loaded and you obviously need to have fans connected to the
37 PWM outputs of the vt1211 :-)
38
39 .SH WARNING
40 This script puts the PWM controller of the vt1211 into automatic mode and
41 toggles the thermal thresholds between extreme values to fool the chip into
42 believing that there is a temperature change and thus forcing the PWM outputs
43 to change to the specified values. Since there is only a single PWM controller
44 that controls both PWM outputs, setting the duty-cycle of one PWM output could
45 affect the duty-cycle of the other PWM output. Use at you own risk!
46
47 .SH SEE ALSO
48 sensors(1)
49
50 .SH AUTHOR
51 .PP
52 Juerg Haefliger <juergh at gmail.com>