Blame view

Documentation/hwmon/sis5595 4.27 KB
7f15b6646   Rudolf Marek   [PATCH] I2C: docu...
1
2
3
4
5
6
7
8
9
10
  Kernel driver sis5595
  =====================
  
  Supported chips:
    * Silicon Integrated Systems Corp. SiS5595 Southbridge Hardware Monitor
      Prefix: 'sis5595'
      Addresses scanned: ISA in PCI-space encoded address
      Datasheet: Publicly available at the Silicon Integrated Systems Corp. site.
  
  Authors:
be2a608bd   John Anthony Kazos Jr   documentation: co...
11
          Kyösti Mälkki <kmalkki@cc.hut.fi>,
7f15b6646   Rudolf Marek   [PATCH] I2C: docu...
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
          Mark D. Studebaker <mdsxyz123@yahoo.com>,
          Aurelien Jarno <aurelien@aurel32.net> 2.6 port
  
     SiS southbridge has a LM78-like chip integrated on the same IC.
     This driver is a customized copy of lm78.c
  
     Supports following revisions:
         Version         PCI ID          PCI Revision
         1               1039/0008       AF or less
         2               1039/0008       B0 or greater
  
     Note: these chips contain a 0008 device which is incompatible with the
          5595. We recognize these by the presence of the listed
          "blacklist" PCI ID and refuse to load.
  
     NOT SUPPORTED       PCI ID          BLACKLIST PCI ID
          540            0008            0540
          550            0008            0550
         5513            0008            5511
         5581            0008            5597
         5582            0008            5597
         5597            0008            5597
          630            0008            0630
          645            0008            0645
          730            0008            0730
          735            0008            0735
  
  
  Module Parameters
  -----------------
  force_addr=0xaddr	Set the I/O base address. Useful for boards
  			that don't set the address in the BIOS. Does not do a
  			PCI force; the device must still be present in lspci.
  			Don't use this unless the driver complains that the
  			base address is not set.
  			Example: 'modprobe sis5595 force_addr=0x290'
  
  
  Description
  -----------
  
  The SiS5595 southbridge has integrated hardware monitor functions. It also
  has an I2C bus, but this driver only supports the hardware monitor. For the
  I2C bus driver see i2c-sis5595.
  
  The SiS5595 implements zero or one temperature sensor, two fan speed
  sensors, four or five voltage sensors, and alarms.
  
  On the first version of the chip, there are four voltage sensors and one
  temperature sensor.
  
  On the second version of the chip, the temperature sensor (temp) and the
  fifth voltage sensor (in4) share a pin which is configurable, but not
  through the driver. Sorry. The driver senses the configuration of the pin,
  which was hopefully set by the BIOS.
  
  Temperatures are measured in degrees Celsius. An alarm is triggered once
  when the max is crossed; it is also triggered when it drops below the min
  value. Measurements are guaranteed between -55 and +125 degrees, with a
  resolution of 1 degree.
  
  Fan rotation speeds are reported in RPM (rotations per minute). An alarm is
  triggered if the rotation speed has dropped below a programmable limit. Fan
  readings can be divided by a programmable divider (1, 2, 4 or 8) to give
  the readings more range or accuracy. Not all RPM values can accurately be
  represented, so some rounding is done. With a divider of 2, the lowest
  representable value is around 2600 RPM.
  
  Voltage sensors (also known as IN sensors) report their values in volts. An
  alarm is triggered if the voltage has crossed a programmable minimum or
  maximum limit. Note that minimum in this case always means 'closest to
  zero'; this is important for negative voltage measurements. All voltage
  inputs can measure voltages between 0 and 4.08 volts, with a resolution of
  0.016 volt.
  
  In addition to the alarms described above, there is a BTI alarm, which gets
  triggered when an external chip has crossed its limits. Usually, this is
  connected to some LM75-like chip; if at least one crosses its limits, this
  bit gets set.
  
  If an alarm triggers, it will remain triggered until the hardware register
  is read at least once. This means that the cause for the alarm may already
  have disappeared! Note that in the current implementation, all hardware
  registers are read whenever any data is read (unless it is less than 1.5
  seconds since the last update). This means that you can easily miss
  once-only alarms.
  
  The SiS5595 only updates its values each 1.5 seconds; reading it more often
  will do no harm, but will return 'old' values.
  
  Problems
  --------
  Some chips refuse to be enabled. We don't know why.
  The driver will recognize this and print a message in dmesg.