ucd9200.rst 4.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124
  1. Kernel driver ucd9200
  2. =====================
  3. Supported chips:
  4. * TI UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, and UCD9248
  5. Prefixes: 'ucd9220', 'ucd9222', 'ucd9224', 'ucd9240', 'ucd9244', 'ucd9246',
  6. 'ucd9248'
  7. Addresses scanned: -
  8. Datasheets:
  9. - http://focus.ti.com/lit/ds/symlink/ucd9220.pdf
  10. - http://focus.ti.com/lit/ds/symlink/ucd9222.pdf
  11. - http://focus.ti.com/lit/ds/symlink/ucd9224.pdf
  12. - http://focus.ti.com/lit/ds/symlink/ucd9240.pdf
  13. - http://focus.ti.com/lit/ds/symlink/ucd9244.pdf
  14. - http://focus.ti.com/lit/ds/symlink/ucd9246.pdf
  15. - http://focus.ti.com/lit/ds/symlink/ucd9248.pdf
  16. Author: Guenter Roeck <linux@roeck-us.net>
  17. Description
  18. -----------
  19. [From datasheets] UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, and
  20. UCD9248 are multi-rail, multi-phase synchronous buck digital PWM controllers
  21. designed for non-isolated DC/DC power applications. The devices integrate
  22. dedicated circuitry for DC/DC loop management with flash memory and a serial
  23. interface to support configuration, monitoring and management.
  24. This driver is a client driver to the core PMBus driver. Please see
  25. Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
  26. Usage Notes
  27. -----------
  28. This driver does not auto-detect devices. You will have to instantiate the
  29. devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
  30. details.
  31. Platform data support
  32. ---------------------
  33. The driver supports standard PMBus driver platform data. Please see
  34. Documentation/hwmon/pmbus.rst for details.
  35. Sysfs entries
  36. -------------
  37. The following attributes are supported. Limits are read-write; all other
  38. attributes are read-only.
  39. ======================= ========================================================
  40. in1_label "vin".
  41. in1_input Measured voltage. From READ_VIN register.
  42. in1_min Minimum Voltage. From VIN_UV_WARN_LIMIT register.
  43. in1_max Maximum voltage. From VIN_OV_WARN_LIMIT register.
  44. in1_lcrit Critical minimum Voltage. VIN_UV_FAULT_LIMIT register.
  45. in1_crit Critical maximum voltage. From VIN_OV_FAULT_LIMIT
  46. register.
  47. in1_min_alarm Voltage low alarm. From VIN_UV_WARNING status.
  48. in1_max_alarm Voltage high alarm. From VIN_OV_WARNING status.
  49. in1_lcrit_alarm Voltage critical low alarm. From VIN_UV_FAULT status.
  50. in1_crit_alarm Voltage critical high alarm. From VIN_OV_FAULT status.
  51. in[2-5]_label "vout[1-4]".
  52. in[2-5]_input Measured voltage. From READ_VOUT register.
  53. in[2-5]_min Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
  54. in[2-5]_max Maximum voltage. From VOUT_OV_WARN_LIMIT register.
  55. in[2-5]_lcrit Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
  56. in[2-5]_crit Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
  57. register.
  58. in[2-5]_min_alarm Voltage low alarm. From VOLTAGE_UV_WARNING status.
  59. in[2-5]_max_alarm Voltage high alarm. From VOLTAGE_OV_WARNING status.
  60. in[2-5]_lcrit_alarm Voltage critical low alarm. From VOLTAGE_UV_FAULT
  61. status.
  62. in[2-5]_crit_alarm Voltage critical high alarm. From VOLTAGE_OV_FAULT
  63. status.
  64. curr1_label "iin".
  65. curr1_input Measured current. From READ_IIN register.
  66. curr[2-5]_label "iout[1-4]".
  67. curr[2-5]_input Measured current. From READ_IOUT register.
  68. curr[2-5]_max Maximum current. From IOUT_OC_WARN_LIMIT register.
  69. curr[2-5]_lcrit Critical minimum output current. From
  70. IOUT_UC_FAULT_LIMIT register.
  71. curr[2-5]_crit Critical maximum current. From IOUT_OC_FAULT_LIMIT
  72. register.
  73. curr[2-5]_max_alarm Current high alarm. From IOUT_OC_WARNING status.
  74. curr[2-5]_crit_alarm Current critical high alarm. From IOUT_OC_FAULT status.
  75. power1_input Measured input power. From READ_PIN register.
  76. power1_label "pin"
  77. power[2-5]_input Measured output power. From READ_POUT register.
  78. power[2-5]_label "pout[1-4]"
  79. The number of output voltage, current, and power
  80. attribute sets is determined by the number of enabled
  81. rails. See chip datasheets for details.
  82. temp[1-5]_input Measured temperatures. From READ_TEMPERATURE_1 and
  83. READ_TEMPERATURE_2 registers.
  84. temp1 is the chip internal temperature. temp[2-5] are
  85. rail temperatures. temp[2-5] attributes are only
  86. created for enabled rails. See chip datasheets for
  87. details.
  88. temp[1-5]_max Maximum temperature. From OT_WARN_LIMIT register.
  89. temp[1-5]_crit Critical high temperature. From OT_FAULT_LIMIT register.
  90. temp[1-5]_max_alarm Temperature high alarm.
  91. temp[1-5]_crit_alarm Temperature critical high alarm.
  92. fan1_input Fan RPM. ucd9240 only.
  93. fan1_alarm Fan alarm. ucd9240 only.
  94. fan1_fault Fan fault. ucd9240 only.
  95. ======================= ========================================================