adm1021 4.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111
  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. * Intel Xeon Processor
  17. Prefix: - any other - may require 'force_adm1021' parameter
  18. Addresses scanned: none
  19. Datasheet: Publicly available at Intel website
  20. * Maxim MAX1617
  21. Prefix: 'max1617'
  22. Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
  23. Datasheet: Publicly available at the Maxim website
  24. * Maxim MAX1617A
  25. Prefix: 'max1617a'
  26. Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
  27. Datasheet: Publicly available at the Maxim website
  28. * National Semiconductor LM84
  29. Prefix: 'lm84'
  30. Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
  31. Datasheet: Publicly available at the National Semiconductor website
  32. * Philips NE1617
  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. * Philips NE1617A
  37. Prefix: 'max1617' (probably detected as a max1617)
  38. Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
  39. Datasheet: Publicly available at the Philips website
  40. * TI THMC10
  41. Prefix: 'thmc10'
  42. Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
  43. Datasheet: Publicly available at the TI website
  44. * Onsemi MC1066
  45. Prefix: 'mc1066'
  46. Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
  47. Datasheet: Publicly available at the Onsemi website
  48. Authors:
  49. Frodo Looijaard <frodol@dds.nl>,
  50. Philip Edelbrock <phil@netroedge.com>
  51. Module Parameters
  52. -----------------
  53. * read_only: int
  54. Don't set any values, read only mode
  55. Description
  56. -----------
  57. The chips supported by this driver are very similar. The Maxim MAX1617 is
  58. the oldest; it has the problem that it is not very well detectable. The
  59. MAX1617A solves that. The ADM1021 is a straight clone of the MAX1617A.
  60. Ditto for the THMC10. From here on, we will refer to all these chips as
  61. ADM1021-clones.
  62. The ADM1021 and MAX1617A reports a die code, which is a sort of revision
  63. code. This can help us pinpoint problems; it is not very useful
  64. otherwise.
  65. ADM1021-clones implement two temperature sensors. One of them is internal,
  66. and measures the temperature of the chip itself; the other is external and
  67. is realised in the form of a transistor-like device. A special alarm
  68. indicates whether the remote sensor is connected.
  69. Each sensor has its own low and high limits. When they are crossed, the
  70. corresponding alarm is set and remains on as long as the temperature stays
  71. out of range. Temperatures are measured in degrees Celsius. Measurements
  72. are possible between -65 and +127 degrees, with a resolution of one degree.
  73. If an alarm triggers, it will remain triggered until the hardware register
  74. is read at least once. This means that the cause for the alarm may already
  75. have disappeared!
  76. This driver only updates its values each 1.5 seconds; reading it more often
  77. will do no harm, but will return 'old' values. It is possible to make
  78. ADM1021-clones do faster measurements, but there is really no good reason
  79. for that.
  80. Xeon support
  81. ------------
  82. Some Xeon processors have real max1617, adm1021, or compatible chips
  83. within them, with two temperature sensors.
  84. Other Xeons have chips with only one sensor.
  85. If you have a Xeon, and the adm1021 module loads, and both temperatures
  86. appear valid, then things are good.
  87. If the adm1021 module doesn't load, you should try this:
  88. modprobe adm1021 force_adm1021=BUS,ADDRESS
  89. ADDRESS can only be 0x18, 0x1a, 0x29, 0x2b, 0x4c, or 0x4e.
  90. If you have dual Xeons you may have appear to have two separate
  91. adm1021-compatible chips, or two single-temperature sensors, at distinct
  92. addresses.