tps53679.rst 3.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178
  1. Kernel driver tps53679
  2. ======================
  3. Supported chips:
  4. * Texas Instruments TPS53647
  5. Prefix: 'tps53647'
  6. Addresses scanned: -
  7. Datasheet: https://www.ti.com/lit/gpn/tps53647
  8. * Texas Instruments TPS53667
  9. Prefix: 'tps53667'
  10. Addresses scanned: -
  11. Datasheet: https://www.ti.com/lit/gpn/TPS53667
  12. * Texas Instruments TPS53679
  13. Prefix: 'tps53679'
  14. Addresses scanned: -
  15. Datasheet: https://www.ti.com/lit/gpn/TPS53679 (short version)
  16. * Texas Instruments TPS53681
  17. Prefix: 'tps53681'
  18. Addresses scanned: -
  19. Datasheet: https://www.ti.com/lit/gpn/TPS53681
  20. * Texas Instruments TPS53688
  21. Prefix: 'tps53688'
  22. Addresses scanned: -
  23. Datasheet: Available under NDA
  24. Authors:
  25. Vadim Pasternak <vadimp@mellanox.com>
  26. Guenter Roeck <linux@roeck-us.net>
  27. Description
  28. -----------
  29. Chips in this series are multi-phase step-down converters with one or two
  30. output channels and up to 8 phases per channel.
  31. Usage Notes
  32. -----------
  33. This driver does not probe for PMBus devices. You will have to instantiate
  34. devices explicitly.
  35. Example: the following commands will load the driver for an TPS53681 at address
  36. 0x60 on I2C bus #1::
  37. # modprobe tps53679
  38. # echo tps53681 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
  39. Sysfs attributes
  40. ----------------
  41. ======================= ========================================================
  42. in1_label "vin"
  43. in1_input Measured input voltage.
  44. in1_lcrit Critical minimum input voltage
  45. TPS53679, TPS53681, TPS53688 only.
  46. in1_lcrit_alarm Input voltage critical low alarm.
  47. TPS53679, TPS53681, TPS53688 only.
  48. in1_crit Critical maximum input voltage.
  49. in1_crit_alarm Input voltage critical high alarm.
  50. in[N]_label "vout[1-2]"
  51. - TPS53647, TPS53667: N=2
  52. - TPS53679, TPS53588: N=2,3
  53. in[N]_input Measured output voltage.
  54. in[N]_lcrit Critical minimum input voltage.
  55. TPS53679, TPS53681, TPS53688 only.
  56. in[N]_lcrit_alarm Critical minimum voltage alarm.
  57. TPS53679, TPS53681, TPS53688 only.
  58. in[N]_alarm Output voltage alarm.
  59. TPS53647, TPS53667 only.
  60. in[N]_crit Critical maximum output voltage.
  61. TPS53679, TPS53681, TPS53688 only.
  62. in[N]_crit_alarm Output voltage critical high alarm.
  63. TPS53679, TPS53681, TPS53688 only.
  64. temp[N]_input Measured temperature.
  65. - TPS53647, TPS53667: N=1
  66. - TPS53679, TPS53681, TPS53588: N=1,2
  67. temp[N]_max Maximum temperature.
  68. temp[N]_crit Critical high temperature.
  69. temp[N]_max_alarm Temperature high alarm.
  70. temp[N]_crit_alarm Temperature critical high alarm.
  71. power1_label "pin".
  72. power1_input Measured input power.
  73. power[N]_label "pout[1-2]".
  74. - TPS53647, TPS53667: N=2
  75. - TPS53679, TPS53681, TPS53588: N=2,3
  76. power[N]_input Measured output power.
  77. curr1_label "iin".
  78. curr1_input Measured input current.
  79. curr1_max Maximum input current.
  80. curr1_max_alarm Input current high alarm.
  81. curr1_crit Critical input current.
  82. curr1_crit_alarm Input current critical alarm.
  83. curr[N]_label "iout[1-2]" or "iout1.[0-5]".
  84. The first digit is the output channel, the second
  85. digit is the phase within the channel. Per-phase
  86. telemetry supported on TPS53681 only.
  87. - TPS53647, TPS53667: N=2
  88. - TPS53679, TPS53588: N=2,3
  89. - TPS53681: N=2-9
  90. curr[N]_input Measured output current.
  91. curr[N]_max Maximum output current.
  92. curr[N]_crit Critical high output current.
  93. curr[N]_max_alarm Output current high alarm.
  94. curr[N]_crit_alarm Output current critical high alarm.
  95. Limit and alarm attributes are only available for
  96. non-phase telemetry (iout1, iout2).
  97. ======================= ========================================================