root/lm-sensors/branches/lm-sensors-2.10/doc/chips/vt8231

Revision 3194, 10.2 KB (checked in by khali, 6 years ago)

vt8231 cleanups, to get the 2.4 driver, libsensors and sensors
in line with the new 2.6 driver. The most important changes are temp
inputs renumbering, and conversion formulas changes, because part of the
conversions are now done by the driver as required by the interface
standard.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1Kernel driver `vt8231.o'
2========================
3
4Status: Beta
5
6Supported chips:
7  * VIA VT8231 South Bridge
8    Prefix: 'vt8231'
9        Addresses scanned: none, address read from PCI space
10
11Author: Mark D. Studebaker <mdsxyz123@yahoo.com>
12
13License: GPL
14
15
16Module Parameters
17-----------------
18
19* force_addr: int
20  Initialize the base address of the sensors
21* force: short array (min = 1, max = 48)
22  List of adapter,address pairs to boldly assume to be present
23* force_vt8231: short array (min = 1, max = 48)
24  List of adapter,address pairs which are unquestionably assumed to contain
25  a `vt8231' chip
26* probe: short array (min = 1, max = 48)
27  List of adapter,address pairs to scan additionally
28* probe_range: short array (min = 1, max = 48)
29  List of adapter,start-addr,end-addr triples to scan additionally
30* ignore: short array (min = 1, max = 48)
31  List of adapter,address pairs not to scan
32* ignore_range: short array (min = 1, max = 48)
33  List of adapter,start-addr,end-addr triples not to scan
34
35
36Description
37-----------
38
39The VIA VT8231 South Bridge contains voltage/temperature monitoring and
40PWM control circuitry for two fans.
41
42We define the sensors as follows.
43
44    Sensor          Voltage Mode    Temp Mode       uch_config bit
45    ------          ------------    ---------       --------------   
46    Reading 1                       temp1
47    UCH1            in0             temp2           0x04 (4)
48    UCH2            in1             temp3           0x08 (8)
49    UCH3            in2             temp4           0x10 (16)
50    UCH4            in3             temp5           0x20 (32)
51    UCH5            in4             temp6           0x40 (64)
52    3.3V            in5
53
54As noted above, 5 of the sensors are "universal channels" and can
55be set for either voltage or temperature.
56Set the uch_config bit (in /proc) to 0 for voltage and 1 for temperature.
57Voltages will read 0 if set for temperature.
58Temperatures will read a really low number if set for voltage.
59
60Fan rotation speeds are reported in RPM (rotations per minute). An alarm is
61triggered if the rotation speed has dropped below a programmable limit. Fan
62readings can be divided by a programmable divider (1, 2, 4 or 8) to give
63the readings more range or accuracy. Not all RPM values can accurately be
64represented, so some rounding is done. With a divider of 2, the lowest
65representable value is around 2600 RPM.
66
67PWM values are from 0 to 255. The first value in the /proc entry is
68the pwm value; the second is the enable (0 or 1).
69
70If an alarm triggers, it will remain triggered until the hardware register
71is read at least once. This means that the cause for the alarm may
72already have disappeared!  Note that in the current implementation, all
73hardware registers are read whenever any data is read (unless it is less
74than 1.5 seconds since the last update). This means that you can easily
75miss once-only alarms.
76
77
78Chip Features
79-------------
80
81Chip 'vt8231'
82
83LABEL                 LABEL CLASS           COMPUTE CLASS          MODE  MAGN
84in0                   -                     -                       R-     2
85in1                   -                     -                       R-     2
86in2                   -                     -                       R-     2
87in3                   -                     -                       R-     2
88in4                   -                     -                       R-     2
89in5                   -                     -                       R-     2
90in0_min               in0                   in0                     RW     2
91in1_min               in1                   in1                     RW     2
92in2_min               in2                   in2                     RW     2
93in3_min               in3                   in3                     RW     2
94in4_min               in4                   in4                     RW     2
95in5_min               in5                   in5                     RW     2
96in0_max               in0                   in0                     RW     2
97in1_max               in1                   in1                     RW     2
98in2_max               in2                   in2                     RW     2
99in3_max               in3                   in3                     RW     2
100in4_max               in4                   in4                     RW     2
101in5_max               in5                   in5                     RW     2
102fan1                  -                     -                       R-     0
103fan2                  -                     -                       R-     0
104fan1_min              fan1                  fan1                    RW     0
105fan2_min              fan2                  fan2                    RW     0
106temp1                 -                     -                       R-     1
107temp1_hyst            temp1                 temp1                   RW     1
108temp1_over            temp1                 temp1                   RW     1
109temp2                 -                     -                       R-     2
110temp2_hyst            temp2                 temp2                   RW     2
111temp2_over            temp2                 temp2                   RW     2
112temp3                 -                     -                       R-     2
113temp3_hyst            temp3                 temp3                   RW     2
114temp3_over            temp3                 temp3                   RW     2
115temp4                 -                     -                       R-     2
116temp4_hyst            temp4                 temp4                   RW     2
117temp4_over            temp4                 temp4                   RW     2
118temp5                 -                     -                       R-     2
119temp5_hyst            temp5                 temp5                   RW     2
120temp5_over            temp5                 temp5                   RW     2
121temp6                 -                     -                       R-     2
122temp6_hyst            temp6                 temp6                   RW     2
123temp6_over            temp6                 temp6                   RW     2
124fan1_div              fan1                  -                       RW     0
125fan2_div              fan2                  -                       RW     0
126alarms                -                     -                       R-     0
127vid                   -                     -                       R-     3
128vrm                   -                     -                       RW     1
129config                -                     -                       R-     0
130
131LABEL                 FEATURE SYMBOL                              SYSCTL FILE:N
132in0                   SENSORS_VT8231_IN0                                  in0:3
133in1                   SENSORS_VT8231_IN1                                  in1:3
134in2                   SENSORS_VT8231_IN2                                  in2:3
135in3                   SENSORS_VT8231_IN3                                  in3:3
136in4                   SENSORS_VT8231_IN4                                  in4:3
137in5                   SENSORS_VT8231_IN5                                  in5:3
138in0_min               SENSORS_VT8231_IN0_MIN                              in0:1
139in1_min               SENSORS_VT8231_IN1_MIN                              in1:1
140in2_min               SENSORS_VT8231_IN2_MIN                              in2:1
141in3_min               SENSORS_VT8231_IN3_MIN                              in3:1
142in4_min               SENSORS_VT8231_IN4_MIN                              in4:1
143in5_min               SENSORS_VT8231_IN5_MIN                              in5:1
144in0_max               SENSORS_VT8231_IN0_MAX                              in0:2
145in1_max               SENSORS_VT8231_IN1_MAX                              in1:2
146in2_max               SENSORS_VT8231_IN2_MAX                              in2:2
147in3_max               SENSORS_VT8231_IN3_MAX                              in3:2
148in4_max               SENSORS_VT8231_IN4_MAX                              in4:2
149in5_max               SENSORS_VT8231_IN5_MAX                              in5:2
150fan1                  SENSORS_VT8231_FAN1                                fan1:2
151fan2                  SENSORS_VT8231_FAN2                                fan2:2
152fan1_min              SENSORS_VT8231_FAN1_MIN                            fan1:1
153fan2_min              SENSORS_VT8231_FAN2_MIN                            fan2:1
154temp1                 SENSORS_VT8231_TEMP                               temp1:3
155temp1_hyst            SENSORS_VT8231_TEMP_HYST                          temp1:2
156temp1_over            SENSORS_VT8231_TEMP_OVER                          temp1:1
157temp2                 SENSORS_VT8231_TEMP2                              temp2:3
158temp2_hyst            SENSORS_VT8231_TEMP2_HYST                         temp2:2
159temp2_over            SENSORS_VT8231_TEMP2_OVER                         temp2:1
160temp3                 SENSORS_VT8231_TEMP3                              temp3:3
161temp3_hyst            SENSORS_VT8231_TEMP3_HYST                         temp3:2
162temp3_over            SENSORS_VT8231_TEMP3_OVER                         temp3:1
163temp4                 SENSORS_VT8231_TEMP4                              temp4:3
164temp4_hyst            SENSORS_VT8231_TEMP4_HYST                         temp4:2
165temp4_over            SENSORS_VT8231_TEMP4_OVER                         temp4:1
166temp5                 SENSORS_VT8231_TEMP5                              temp5:3
167temp5_hyst            SENSORS_VT8231_TEMP5_HYST                         temp5:2
168temp5_over            SENSORS_VT8231_TEMP5_OVER                         temp5:1
169temp6                 SENSORS_VT8231_TEMP6                              temp6:3
170temp6_hyst            SENSORS_VT8231_TEMP6_HYST                         temp6:2
171temp6_over            SENSORS_VT8231_TEMP6_OVER                         temp6:1
172fan1_div              SENSORS_VT8231_FAN1_DIV                         fan_div:1
173fan2_div              SENSORS_VT8231_FAN2_DIV                         fan_div:2
174alarms                SENSORS_VT8231_ALARMS                            alarms:1
175vid                   SENSORS_VT8231_VID                                  vid:1
176vrm                   SENSORS_VT8231_VRM                                  vrm:1
177config                SENSORS_VT8231_UCH                           uch_config:1
178
179
180Notes
181-----
182
183The lm_sensors project gratefully acknowledges the support of VIA in the
184development of this driver.
Note: See TracBrowser for help on using the browser.