adm1021 4.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113
  1. Kernel driver adm1021
  2. =====================
  3. Supported chips:
  4. * Analog Devices ADM1021
  5. Prefix: 'adm1021'
  6. Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
  7. Datasheet: Publicly available at the Analog Devices website
  8. * Analog Devices ADM1021A/ADM1023
  9. Prefix: 'adm1023'
  10. Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
  11. Datasheet: Publicly available at the Analog Devices website
  12. * Genesys Logic GL523SM
  13. Prefix: 'gl523sm'
  14. Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
  15. Datasheet:
  16. * Maxim MAX1617
  17. Prefix: 'max1617'
  18. Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
  19. Datasheet: Publicly available at the Maxim website
  20. * Maxim MAX1617A
  21. Prefix: 'max1617a'
  22. Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
  23. Datasheet: Publicly available at the Maxim website
  24. * National Semiconductor LM84
  25. Prefix: 'lm84'
  26. Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
  27. Datasheet: Publicly available at the National Semiconductor website
  28. * Philips NE1617
  29. Prefix: 'max1617' (probably detected as a max1617)
  30. Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
  31. Datasheet: Publicly available at the Philips website
  32. * Philips NE1617A
  33. Prefix: 'max1617' (probably detected as a max1617)
  34. Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
  35. Datasheet: Publicly available at the Philips website
  36. * TI THMC10
  37. Prefix: 'thmc10'
  38. Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
  39. Datasheet: Publicly available at the TI website
  40. * Onsemi MC1066
  41. Prefix: 'mc1066'
  42. Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
  43. Datasheet: Publicly available at the Onsemi website
  44. Authors:
  45. Frodo Looijaard <frodol@dds.nl>,
  46. Philip Edelbrock <phil@netroedge.com>
  47. Module Parameters
  48. -----------------
  49. * read_only: int
  50. Don't set any values, read only mode
  51. Description
  52. -----------
  53. The chips supported by this driver are very similar. The Maxim MAX1617 is
  54. the oldest; it has the problem that it is not very well detectable. The
  55. MAX1617A solves that. The ADM1021 is a straight clone of the MAX1617A.
  56. Ditto for the THMC10. From here on, we will refer to all these chips as
  57. ADM1021-clones.
  58. The ADM1021 and MAX1617A reports a die code, which is a sort of revision
  59. code. This can help us pinpoint problems; it is not very useful
  60. otherwise.
  61. ADM1021-clones implement two temperature sensors. One of them is internal,
  62. and measures the temperature of the chip itself; the other is external and
  63. is realised in the form of a transistor-like device. A special alarm
  64. indicates whether the remote sensor is connected.
  65. Each sensor has its own low and high limits. When they are crossed, the
  66. corresponding alarm is set and remains on as long as the temperature stays
  67. out of range. Temperatures are measured in degrees Celsius. Measurements
  68. are possible between -65 and +127 degrees, with a resolution of one degree.
  69. If an alarm triggers, it will remain triggered until the hardware register
  70. is read at least once. This means that the cause for the alarm may already
  71. have disappeared!
  72. This driver only updates its values each 1.5 seconds; reading it more often
  73. will do no harm, but will return 'old' values. It is possible to make
  74. ADM1021-clones do faster measurements, but there is really no good reason
  75. for that.
  76. Netburst-based Xeon support
  77. ---------------------------
  78. Some Xeon processors based on the Netburst (early Pentium 4, from 2001 to
  79. 2003) microarchitecture had real MAX1617, ADM1021, or compatible chips
  80. within them, with two temperature sensors. Other Xeon processors of this
  81. era (with 400 MHz FSB) had chips with only one temperature sensor.
  82. If you have such an old Xeon, and you get two valid temperatures when
  83. loading the adm1021 module, then things are good.
  84. If nothing happens when loading the adm1021 module, and you are certain
  85. that your specific Xeon processor model includes compatible sensors, you
  86. will have to explicitly instantiate the sensor chips from user-space. See
  87. method 4 in Documentation/i2c/instantiating-devices. Possible slave
  88. addresses are 0x18, 0x1a, 0x29, 0x2b, 0x4c, or 0x4e. It is likely that
  89. only temp2 will be correct and temp1 will have to be ignored.
  90. Previous generations of the Xeon processor (based on Pentium II/III)
  91. didn't have these sensors. Next generations of Xeon processors (533 MHz
  92. FSB and faster) lost them, until the Core-based generation which
  93. introduced integrated digital thermal sensors. These are supported by
  94. the coretemp driver.