sis5595.rst 4.7 KB

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