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

Revision 3146, 8.0 KB (checked in by khali, 6 years ago)

Backport updates from Linux 2.6.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1Kernel driver `via686a.o'
2=========================
3
4Status: Stable.
5
6Supported chips:
7  * Via VT82C686A, VT82C686B  Southbridge Integrated Hardware Monitor
8    Prefix: 'via686a'
9    Addresses scanned: ISA in PCI-space encoded address
10    Datasheet: On request through web form
11               (http://www.via.com.tw/en/support/datasheets/)
12
13Authors: Kyösti Mälkki <kmalkki@cc.hut.fi>,
14         Mark D. Studebaker <mdsxyz123@yahoo.com>
15         Bob Dougherty <bobd@stanford.edu>
16         (Some conversion-factor data were contributed by
17         Jonathan Teh Soon Yew <j.teh@iname.com>
18         and Alex van Kaam <darkside@chello.nl>.)
19
20Module Parameters
21-----------------
22
23force_addr=0xaddr       Set the I/O base address. Useful for boards that
24                        don't set the address in the BIOS. Look for a BIOS
25                        upgrade before resorting to this. Does not do a
26                        PCI force; the via686a must still be present in lspci.
27                        Don't use this unless the driver complains that the
28                        base address is not set.
29                        Example: 'modprobe via686a force_addr=0x6000'
30
31
32Description
33-----------
34
35The driver does not distinguish between the chips and reports
36all as a 686A.
37
38The Via 686a southbridge has integrated hardware monitor functionality.
39It also has an I2C bus, but this driver only supports the hardware monitor.
40For the I2C bus driver, see ../busses/i2c-viapro.
41
42The Via 686a implements three temperature sensors, two fan rotation speed
43sensors, five voltage sensors and alarms.
44
45Temperatures are measured in degrees Celsius. An alarm is triggered once
46when the Overtemperature Shutdown limit is crossed; it is triggered again
47as soon as it drops below the hysteresis value.
48
49Fan rotation speeds are reported in RPM (rotations per minute). An alarm is
50triggered if the rotation speed has dropped below a programmable limit. Fan
51readings can be divided by a programmable divider (1, 2, 4 or 8) to give
52the readings more range or accuracy. Not all RPM values can accurately be
53represented, so some rounding is done. With a divider of 2, the lowest
54representable value is around 2600 RPM.
55
56Voltage sensors (also known as IN sensors) report their values in volts.
57An alarm is triggered if the voltage has crossed a programmable minimum
58or maximum limit. Voltages are internally scalled, so each voltage channel
59has a different resolution and range.
60
61If an alarm triggers, it will remain triggered until the hardware register
62is read at least once. This means that the cause for the alarm may
63already have disappeared!  Note that in the current implementation, all
64hardware registers are read whenever any data is read (unless it is less
65than 1.5 seconds since the last update). This means that you can easily
66miss once-only alarms.
67
68The driver only updates its values each 1.5 seconds; reading it more often
69will do no harm, but will return 'old' values.
70
71
72Known Issues
73------------
74
75This driver handles sensors integrated in some VIA south bridges. It is
76possible that a motherboard maker used a VT82C686A/B chip as part of a
77product design but was not interested in its hardware monitoring features,
78in which case the sensor inputs will not be wired. This is the case of
79the Asus K7V, A7V and A7V133 motherboards, to name only a few of them.
80So, if you need the force_addr parameter, and end up with values which
81don't seem to make any sense, don't look any further: your chip is simply
82not wired for hardware monitoring.
83
84
85Chip Features
86-------------
87
88Chip `via686a'
89             LABEL        LABEL CLASS      COMPUTE CLASS ACCESS MAGNITUDE
90               in0               NONE               NONE     R     2
91               in1               NONE               NONE     R     2
92               in2               NONE               NONE     R     2
93               in3               NONE               NONE     R     2
94               in4               NONE               NONE     R     2
95           in0_min                in0                in0     RW    2
96           in1_min                in1                in1     RW    2
97           in2_min                in2                in2     RW    2
98           in3_min                in3                in3     RW    2
99           in4_min                in3                in3     RW    2
100           in0_max                in0                in0     RW    2
101           in1_max                in1                in1     RW    2
102           in2_max                in2                in2     RW    2
103           in3_max                in3                in3     RW    2
104           in4_max                in3                in3     RW    2
105              fan1               NONE               NONE     R     0
106              fan2               NONE               NONE     R     0
107          fan1_min               fan1               fan1     RW    0
108          fan2_min               fan2               fan2     RW    0
109              temp               NONE               NONE     R     1
110         temp_hyst               temp               temp     RW    1
111         temp_over               temp               temp     RW    1
112             temp2               NONE               NONE     R     1
113        temp2_hyst               temp               temp     RW    1
114        temp2_over               temp               temp     RW    1
115             temp3               NONE               NONE     R     1
116        temp3_hyst               temp               temp     RW    1
117        temp3_over               temp               temp     RW    1
118          fan1_div               fan1               NONE     RW    0
119          fan2_div               fan2               NONE     RW    0
120            alarms               NONE               NONE     R     0
121
122             LABEL                          FEATURE SYMBOL        SYSCTL FILE:NR
123               in0                     SENSORS_VIA686A_IN0                in0:3
124               in1                     SENSORS_VIA686A_IN1                in1:3
125               in2                     SENSORS_VIA686A_IN2                in2:3
126               in3                     SENSORS_VIA686A_IN3                in3:3
127               in4                     SENSORS_VIA686A_IN4                in4:3
128           in0_min                 SENSORS_VIA686A_IN0_MIN                in0:1
129           in1_min                 SENSORS_VIA686A_IN1_MIN                in1:1
130           in2_min                 SENSORS_VIA686A_IN2_MIN                in2:1
131           in3_min                 SENSORS_VIA686A_IN3_MIN                in3:1
132           in4_min                 SENSORS_VIA686A_IN4_MIN                in4:1
133           in0_max                 SENSORS_VIA686A_IN0_MAX                in0:2
134           in1_max                 SENSORS_VIA686A_IN1_MAX                in1:2
135           in2_max                 SENSORS_VIA686A_IN2_MAX                in2:2
136           in3_max                 SENSORS_VIA686A_IN3_MAX                in3:2
137           in4_max                 SENSORS_VIA686A_IN4_MAX                in4:2
138              fan1                    SENSORS_VIA686A_FAN1               fan1:2
139              fan2                    SENSORS_VIA686A_FAN2               fan2:2
140          fan1_min                SENSORS_VIA686A_FAN1_MIN               fan1:1
141          fan2_min                SENSORS_VIA686A_FAN2_MIN               fan2:1
142              temp                    SENSORS_VIA686A_TEMP               temp:3
143         temp_hyst               SENSORS_VIA686A_TEMP_HYST               temp:2
144         temp_over               SENSORS_VIA686A_TEMP_OVER               temp:1
145             temp2                   SENSORS_VIA686A_TEMP2              temp2:3
146        temp2_hyst              SENSORS_VIA686A_TEMP2_HYST              temp2:2
147        temp2_over              SENSORS_VIA686A_TEMP2_OVER              temp2:1
148             temp3                   SENSORS_VIA686A_TEMP3              temp3:3
149        temp3_hyst              SENSORS_VIA686A_TEMP3_HYST              temp3:2
150        temp3_over              SENSORS_VIA686A_TEMP3_OVER              temp3:1
151          fan1_div                SENSORS_VIA686A_FAN1_DIV            fan_div:1
152          fan2_div                SENSORS_VIA686A_FAN2_DIV            fan_div:2
153            alarms                  SENSORS_VIA686A_ALARMS             alarms:1
154
155
Note: See TracBrowser for help on using the browser.