ucd9000.rst 5.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137
  1. Kernel driver ucd9000
  2. =====================
  3. Supported chips:
  4. * TI UCD90120, UCD90124, UCD90160, UCD90320, UCD9090, and UCD90910
  5. Prefixes: 'ucd90120', 'ucd90124', 'ucd90160', 'ucd90320', 'ucd9090',
  6. 'ucd90910'
  7. Addresses scanned: -
  8. Datasheets:
  9. - http://focus.ti.com/lit/ds/symlink/ucd90120.pdf
  10. - http://focus.ti.com/lit/ds/symlink/ucd90124.pdf
  11. - http://focus.ti.com/lit/ds/symlink/ucd90160.pdf
  12. - http://focus.ti.com/lit/ds/symlink/ucd90320.pdf
  13. - http://focus.ti.com/lit/ds/symlink/ucd9090.pdf
  14. - http://focus.ti.com/lit/ds/symlink/ucd90910.pdf
  15. Author: Guenter Roeck <linux@roeck-us.net>
  16. Description
  17. -----------
  18. From datasheets:
  19. The UCD90120 Power Supply Sequencer and System Health Monitor monitors and
  20. sequences up to 12 independent voltage rails. The device integrates a 12-bit
  21. ADC with a 2.5V internal reference for monitoring up to 13 power supply voltage,
  22. current, or temperature inputs.
  23. The UCD90124 is a 12-rail PMBus/I2C addressable power-supply sequencer and
  24. system-health monitor. The device integrates a 12-bit ADC for monitoring up to
  25. 13 power-supply voltage, current, or temperature inputs. Twenty-six GPIO pins
  26. can be used for power supply enables, power-on reset signals, external
  27. interrupts, cascading, or other system functions. Twelve of these pins offer PWM
  28. functionality. Using these pins, the UCD90124 offers support for fan control,
  29. margining, and general-purpose PWM functions.
  30. The UCD90160 is a 16-rail PMBus/I2C addressable power-supply sequencer and
  31. monitor. The device integrates a 12-bit ADC for monitoring up to 16 power-supply
  32. voltage inputs. Twenty-six GPIO pins can be used for power supply enables,
  33. power-on reset signals, external interrupts, cascading, or other system
  34. functions. Twelve of these pins offer PWM functionality. Using these pins, the
  35. UCD90160 offers support for margining, and general-purpose PWM functions.
  36. The UCD90320 is a 32-rail PMBus/I2C addressable power-supply sequencer and
  37. monitor. The 24 integrated ADC channels (AMONx) monitor the power supply
  38. voltage, current, and temperature. Of the 84 GPIO pins, 8 can be used as
  39. digital monitors (DMONx), 32 to enable the power supply (ENx), 24 for margining
  40. (MARx), 16 for logical GPO, and 32 GPIs for cascading, and system function.
  41. The UCD9090 is a 10-rail PMBus/I2C addressable power-supply sequencer and
  42. monitor. The device integrates a 12-bit ADC for monitoring up to 10 power-supply
  43. voltage inputs. Twenty-three GPIO pins can be used for power supply enables,
  44. power-on reset signals, external interrupts, cascading, or other system
  45. functions. Ten of these pins offer PWM functionality. Using these pins, the
  46. UCD9090 offers support for margining, and general-purpose PWM functions.
  47. The UCD90910 is a ten-rail I2C / PMBus addressable power-supply sequencer and
  48. system-health monitor. The device integrates a 12-bit ADC for monitoring up to
  49. 13 power-supply voltage, current, or temperature inputs.
  50. This driver is a client driver to the core PMBus driver. Please see
  51. Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
  52. Usage Notes
  53. -----------
  54. This driver does not auto-detect devices. You will have to instantiate the
  55. devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
  56. details.
  57. Platform data support
  58. ---------------------
  59. The driver supports standard PMBus driver platform data. Please see
  60. Documentation/hwmon/pmbus.rst for details.
  61. Sysfs entries
  62. -------------
  63. The following attributes are supported. Limits are read-write; all other
  64. attributes are read-only.
  65. ======================= ========================================================
  66. in[1-12]_label "vout[1-12]".
  67. in[1-12]_input Measured voltage. From READ_VOUT register.
  68. in[1-12]_min Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
  69. in[1-12]_max Maximum voltage. From VOUT_OV_WARN_LIMIT register.
  70. in[1-12]_lcrit Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
  71. in[1-12]_crit Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
  72. register.
  73. in[1-12]_min_alarm Voltage low alarm. From VOLTAGE_UV_WARNING status.
  74. in[1-12]_max_alarm Voltage high alarm. From VOLTAGE_OV_WARNING status.
  75. in[1-12]_lcrit_alarm Voltage critical low alarm. From VOLTAGE_UV_FAULT
  76. status.
  77. in[1-12]_crit_alarm Voltage critical high alarm. From VOLTAGE_OV_FAULT
  78. status.
  79. curr[1-12]_label "iout[1-12]".
  80. curr[1-12]_input Measured current. From READ_IOUT register.
  81. curr[1-12]_max Maximum current. From IOUT_OC_WARN_LIMIT register.
  82. curr[1-12]_lcrit Critical minimum output current. From
  83. IOUT_UC_FAULT_LIMIT register.
  84. curr[1-12]_crit Critical maximum current. From IOUT_OC_FAULT_LIMIT
  85. register.
  86. curr[1-12]_max_alarm Current high alarm. From IOUT_OC_WARNING status.
  87. curr[1-12]_crit_alarm Current critical high alarm. From IOUT_OC_FAULT status.
  88. For each attribute index, either voltage or current is
  89. reported, but not both. If voltage or current is
  90. reported depends on the chip configuration.
  91. temp[1-2]_input Measured temperatures. From READ_TEMPERATURE_1 and
  92. READ_TEMPERATURE_2 registers.
  93. temp[1-2]_max Maximum temperature. From OT_WARN_LIMIT register.
  94. temp[1-2]_crit Critical high temperature. From OT_FAULT_LIMIT register.
  95. temp[1-2]_max_alarm Temperature high alarm.
  96. temp[1-2]_crit_alarm Temperature critical high alarm.
  97. fan[1-4]_input Fan RPM.
  98. fan[1-4]_alarm Fan alarm.
  99. fan[1-4]_fault Fan fault.
  100. Fan attributes are only available on chips supporting
  101. fan control (UCD90124, UCD90910). Attribute files are
  102. created only for enabled fans.
  103. Note that even though UCD90910 supports up to 10 fans,
  104. only up to four fans are currently supported.
  105. ======================= ========================================================