zl6100 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129
  1. Kernel driver zl6100
  2. ====================
  3. Supported chips:
  4. * Intersil / Zilker Labs ZL2004
  5. Prefix: 'zl2004'
  6. Addresses scanned: -
  7. Datasheet: http://www.intersil.com/data/fn/fn6847.pdf
  8. * Intersil / Zilker Labs ZL2005
  9. Prefix: 'zl2005'
  10. Addresses scanned: -
  11. Datasheet: http://www.intersil.com/data/fn/fn6848.pdf
  12. * Intersil / Zilker Labs ZL2006
  13. Prefix: 'zl2006'
  14. Addresses scanned: -
  15. Datasheet: http://www.intersil.com/data/fn/fn6850.pdf
  16. * Intersil / Zilker Labs ZL2008
  17. Prefix: 'zl2008'
  18. Addresses scanned: -
  19. Datasheet: http://www.intersil.com/data/fn/fn6859.pdf
  20. * Intersil / Zilker Labs ZL2105
  21. Prefix: 'zl2105'
  22. Addresses scanned: -
  23. Datasheet: http://www.intersil.com/data/fn/fn6851.pdf
  24. * Intersil / Zilker Labs ZL2106
  25. Prefix: 'zl2106'
  26. Addresses scanned: -
  27. Datasheet: http://www.intersil.com/data/fn/fn6852.pdf
  28. * Intersil / Zilker Labs ZL6100
  29. Prefix: 'zl6100'
  30. Addresses scanned: -
  31. Datasheet: http://www.intersil.com/data/fn/fn6876.pdf
  32. * Intersil / Zilker Labs ZL6105
  33. Prefix: 'zl6105'
  34. Addresses scanned: -
  35. Datasheet: http://www.intersil.com/data/fn/fn6906.pdf
  36. Author: Guenter Roeck <guenter.roeck@ericsson.com>
  37. Description
  38. -----------
  39. This driver supports hardware montoring for Intersil / Zilker Labs ZL6100 and
  40. compatible digital DC-DC controllers.
  41. The driver is a client driver to the core PMBus driver. Please see
  42. Documentation/hwmon/pmbus and Documentation.hwmon/pmbus-core for details
  43. on PMBus client drivers.
  44. Usage Notes
  45. -----------
  46. This driver does not auto-detect devices. You will have to instantiate the
  47. devices explicitly. Please see Documentation/i2c/instantiating-devices for
  48. details.
  49. WARNING: Do not access chip registers using the i2cdump command, and do not use
  50. any of the i2ctools commands on a command register used to save and restore
  51. configuration data (0x11, 0x12, 0x15, 0x16, and 0xf4). The chips supported by
  52. this driver interpret any access to those command registers (including read
  53. commands) as request to execute the command in question. Unless write accesses
  54. to those registers are protected, this may result in power loss, board resets,
  55. and/or Flash corruption. Worst case, your board may turn into a brick.
  56. Platform data support
  57. ---------------------
  58. The driver supports standard PMBus driver platform data.
  59. Module parameters
  60. -----------------
  61. delay
  62. -----
  63. Some Intersil/Zilker Labs DC-DC controllers require a minimum interval between
  64. I2C bus accesses. According to Intersil, the minimum interval is 2 ms, though
  65. 1 ms appears to be sufficient and has not caused any problems in testing.
  66. The problem is known to affect ZL6100, ZL2105, and ZL2008. It is known not to
  67. affect ZL2004 and ZL6105. The driver automatically sets the interval to 1 ms
  68. except for ZL2004 and ZL6105. To enable manual override, the driver provides a
  69. writeable module parameter, 'delay', which can be used to set the interval to
  70. a value between 0 and 65,535 microseconds.
  71. Sysfs entries
  72. -------------
  73. The following attributes are supported. Limits are read-write; all other
  74. attributes are read-only.
  75. in1_label "vin"
  76. in1_input Measured input voltage.
  77. in1_min Minimum input voltage.
  78. in1_max Maximum input voltage.
  79. in1_lcrit Critical minumum input voltage.
  80. in1_crit Critical maximum input voltage.
  81. in1_min_alarm Input voltage low alarm.
  82. in1_max_alarm Input voltage high alarm.
  83. in1_lcrit_alarm Input voltage critical low alarm.
  84. in1_crit_alarm Input voltage critical high alarm.
  85. in2_label "vout1"
  86. in2_input Measured output voltage.
  87. in2_lcrit Critical minumum output Voltage.
  88. in2_crit Critical maximum output voltage.
  89. in2_lcrit_alarm Critical output voltage critical low alarm.
  90. in2_crit_alarm Critical output voltage critical high alarm.
  91. curr1_label "iout1"
  92. curr1_input Measured output current.
  93. curr1_lcrit Critical minimum output current.
  94. curr1_crit Critical maximum output current.
  95. curr1_lcrit_alarm Output current critical low alarm.
  96. curr1_crit_alarm Output current critical high alarm.
  97. temp[12]_input Measured temperature.
  98. temp[12]_min Minimum temperature.
  99. temp[12]_max Maximum temperature.
  100. temp[12]_lcrit Critical low temperature.
  101. temp[12]_crit Critical high temperature.
  102. temp[12]_min_alarm Chip temperature low alarm.
  103. temp[12]_max_alarm Chip temperature high alarm.
  104. temp[12]_lcrit_alarm Chip temperature critical low alarm.
  105. temp[12]_crit_alarm Chip temperature critical high alarm.