ltc2978.rst 9.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449
  1. Kernel driver ltc2978
  2. =====================
  3. Supported chips:
  4. * Linear Technology LTC2972
  5. Prefix: 'ltc2972'
  6. Addresses scanned: -
  7. Datasheet: https://www.analog.com/en/products/ltc2972.html
  8. * Linear Technology LTC2974
  9. Prefix: 'ltc2974'
  10. Addresses scanned: -
  11. Datasheet: https://www.analog.com/en/products/ltc2974
  12. * Linear Technology LTC2975
  13. Prefix: 'ltc2975'
  14. Addresses scanned: -
  15. Datasheet: https://www.analog.com/en/products/ltc2975
  16. * Linear Technology LTC2977
  17. Prefix: 'ltc2977'
  18. Addresses scanned: -
  19. Datasheet: https://www.analog.com/en/products/ltc2977
  20. * Linear Technology LTC2978, LTC2978A
  21. Prefix: 'ltc2978'
  22. Addresses scanned: -
  23. Datasheet: https://www.analog.com/en/products/ltc2978
  24. https://www.analog.com/en/products/ltc2978a
  25. * Linear Technology LTC2979
  26. Prefix: 'ltc2979'
  27. Addresses scanned: -
  28. Datasheet: https://www.analog.com/en/products/ltc2979
  29. * Linear Technology LTC2980
  30. Prefix: 'ltc2980'
  31. Addresses scanned: -
  32. Datasheet: https://www.analog.com/en/products/ltc2980
  33. * Linear Technology LTC3880
  34. Prefix: 'ltc3880'
  35. Addresses scanned: -
  36. Datasheet: https://www.analog.com/en/products/ltc3880
  37. * Linear Technology LTC3882
  38. Prefix: 'ltc3882'
  39. Addresses scanned: -
  40. Datasheet: https://www.analog.com/en/products/ltc3882
  41. * Linear Technology LTC3883
  42. Prefix: 'ltc3883'
  43. Addresses scanned: -
  44. Datasheet: https://www.analog.com/en/products/ltc3883
  45. * Linear Technology LTC3884
  46. Prefix: 'ltc3884'
  47. Addresses scanned: -
  48. Datasheet: https://www.analog.com/en/products/ltc3884
  49. * Linear Technology LTC3886
  50. Prefix: 'ltc3886'
  51. Addresses scanned: -
  52. Datasheet: https://www.analog.com/en/products/ltc3886
  53. * Linear Technology LTC3887
  54. Prefix: 'ltc3887'
  55. Addresses scanned: -
  56. Datasheet: https://www.analog.com/en/products/ltc3887
  57. * Linear Technology LTC3889
  58. Prefix: 'ltc3889'
  59. Addresses scanned: -
  60. Datasheet: https://www.analog.com/en/products/ltc3889
  61. * Linear Technology LTC7880
  62. Prefix: 'ltc7880'
  63. Addresses scanned: -
  64. Datasheet: https://www.analog.com/en/products/ltc7880
  65. * Linear Technology LTM2987
  66. Prefix: 'ltm2987'
  67. Addresses scanned: -
  68. Datasheet: https://www.analog.com/en/products/ltm2987
  69. * Linear Technology LTM4644
  70. Prefix: 'ltm4644'
  71. Addresses scanned: -
  72. Datasheet: https://www.analog.com/en/products/ltm4644
  73. * Linear Technology LTM4675
  74. Prefix: 'ltm4675'
  75. Addresses scanned: -
  76. Datasheet: https://www.analog.com/en/products/ltm4675
  77. * Linear Technology LTM4676
  78. Prefix: 'ltm4676'
  79. Addresses scanned: -
  80. Datasheet: https://www.analog.com/en/products/ltm4676
  81. * Linear Technology LTM4677
  82. Prefix: 'ltm4677'
  83. Addresses scanned: -
  84. Datasheet: https://www.analog.com/en/products/ltm4677
  85. * Linear Technology LTM4678
  86. Prefix: 'ltm4678'
  87. Addresses scanned: -
  88. Datasheet: https://www.analog.com/en/products/ltm4678
  89. * Analog Devices LTM4680
  90. Prefix: 'ltm4680'
  91. Addresses scanned: -
  92. Datasheet: https://www.analog.com/ltm4680
  93. * Analog Devices LTM4686
  94. Prefix: 'ltm4686'
  95. Addresses scanned: -
  96. Datasheet: https://www.analog.com/ltm4686
  97. * Analog Devices LTM4700
  98. Prefix: 'ltm4700'
  99. Addresses scanned: -
  100. Datasheet: https://www.analog.com/ltm4700
  101. Author: Guenter Roeck <linux@roeck-us.net>
  102. Description
  103. -----------
  104. - LTC2974 and LTC2975 are quad digital power supply managers.
  105. - LTC2978 is an octal power supply monitor.
  106. - LTC2977 is a pin compatible replacement for LTC2978.
  107. - LTC2980 is a 16-channel Power System Manager, consisting of two LTC2977
  108. - in a single die. The chip is instantiated and reported as two separate chips
  109. - on two different I2C bus addresses.
  110. - LTC3880, LTC3882, LTC3886, and LTC3887 are dual output poly-phase step-down
  111. - DC/DC controllers.
  112. - LTC3883 is a single phase step-down DC/DC controller.
  113. - LTM2987 is a 16-channel Power System Manager with two LTC2977 plus
  114. - additional components on a single die. The chip is instantiated and reported
  115. - as two separate chips on two different I2C bus addresses.
  116. - LTM4675 is a dual 9A or single 18A μModule regulator
  117. - LTM4676 is a dual 13A or single 26A uModule regulator.
  118. - LTM4686 is a dual 10A or single 20A uModule regulator.
  119. Usage Notes
  120. -----------
  121. This driver does not probe for PMBus devices. You will have to instantiate
  122. devices explicitly.
  123. Example: the following commands will load the driver for an LTC2978 at address
  124. 0x60 on I2C bus #1::
  125. # modprobe ltc2978
  126. # echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
  127. Sysfs attributes
  128. ----------------
  129. ======================= ========================================================
  130. in1_label "vin"
  131. in1_input Measured input voltage.
  132. in1_min Minimum input voltage.
  133. in1_max Maximum input voltage.
  134. LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
  135. LTC2979 and LTM2987 only.
  136. in1_lcrit Critical minimum input voltage.
  137. LTC2972, LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
  138. LTC2979 and LTM2987 only.
  139. in1_crit Critical maximum input voltage.
  140. in1_min_alarm Input voltage low alarm.
  141. in1_max_alarm Input voltage high alarm.
  142. LTC2972, LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
  143. LTC2979 and LTM2987 only.
  144. in1_lcrit_alarm Input voltage critical low alarm.
  145. LTC2972, LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
  146. LTC2979 and LTM2987 only.
  147. in1_crit_alarm Input voltage critical high alarm.
  148. in1_lowest Lowest input voltage.
  149. LTC2972, LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
  150. and LTM2987 only.
  151. in1_highest Highest input voltage.
  152. in1_reset_history Reset input voltage history.
  153. in[N]_label "vout[1-8]".
  154. - LTC2972: N=2-3
  155. - LTC2974, LTC2975: N=2-5
  156. - LTC2977, LTC2979, LTC2980, LTM2987: N=2-9
  157. - LTC2978: N=2-9
  158. - LTC3880, LTC3882, LTC3884, LTC23886 LTC3887, LTC3889,
  159. LTC7880, LTM4644, LTM4675, LTM4676, LTM4677, LTM4678,
  160. LTM4680, LTM4700: N=2-3
  161. - LTC3883: N=2
  162. in[N]_input Measured output voltage.
  163. in[N]_min Minimum output voltage.
  164. in[N]_max Maximum output voltage.
  165. in[N]_lcrit Critical minimum output voltage.
  166. in[N]_crit Critical maximum output voltage.
  167. in[N]_min_alarm Output voltage low alarm.
  168. in[N]_max_alarm Output voltage high alarm.
  169. in[N]_lcrit_alarm Output voltage critical low alarm.
  170. in[N]_crit_alarm Output voltage critical high alarm.
  171. in[N]_lowest Lowest output voltage.
  172. LTC2972, LTC2974, LTC2975,and LTC2978 only.
  173. in[N]_highest Highest output voltage.
  174. in[N]_reset_history Reset output voltage history.
  175. temp[N]_input Measured temperature.
  176. - On LTC2972, temp[1-2] report external temperatures,
  177. and temp 3 reports the chip temperature.
  178. - On LTC2974 and LTC2975, temp[1-4] report external
  179. temperatures, and temp5 reports the chip temperature.
  180. - On LTC2977, LTC2979, LTC2980, LTC2978, and LTM2987,
  181. only one temperature measurement is supported and
  182. reports the chip temperature.
  183. - On LTC3880, LTC3882, LTC3886, LTC3887, LTC3889,
  184. LTM4664, LTM4675, LTM4676, LTM4677, LTM4678, LTM4680,
  185. and LTM4700, temp1 and temp2 report external
  186. temperatures, and temp3 reports the chip temperature.
  187. - On LTC3883, temp1 reports an external temperature,
  188. and temp2 reports the chip temperature.
  189. temp[N]_min Mimimum temperature.
  190. LTC2972, LTC2974, LCT2977, LTM2980, LTC2978,
  191. LTC2979, and LTM2987 only.
  192. temp[N]_max Maximum temperature.
  193. temp[N]_lcrit Critical low temperature.
  194. temp[N]_crit Critical high temperature.
  195. temp[N]_min_alarm Temperature low alarm.
  196. LTC2972, LTC2974, LTC2975, LTC2977, LTM2980, LTC2978,
  197. LTC2979, and LTM2987 only.
  198. temp[N]_max_alarm Temperature high alarm.
  199. temp[N]_lcrit_alarm Temperature critical low alarm.
  200. temp[N]_crit_alarm Temperature critical high alarm.
  201. temp[N]_lowest Lowest measured temperature.
  202. - LTC2972, LTC2974, LTC2975, LTC2977, LTM2980, LTC2978,
  203. LTC2979, and LTM2987 only.
  204. - Not supported for chip temperature sensor on LTC2974
  205. and LTC2975.
  206. temp[N]_highest Highest measured temperature.
  207. Not supported for chip temperature sensor on
  208. LTC2974 and LTC2975.
  209. temp[N]_reset_history Reset temperature history.
  210. Not supported for chip temperature sensor on
  211. LTC2974 and LTC2975.
  212. power1_label "pin". LTC3883 and LTC3886 only.
  213. power1_input Measured input power.
  214. power[N]_label "pout[1-4]".
  215. - LTC2972: N=1-2
  216. - LTC2974, LTC2975: N=1-4
  217. - LTC2977, LTC2979, LTC2980, LTM2987: Not supported
  218. - LTC2978: Not supported
  219. - LTC3880, LTC3882, LTC3884, LTC3886, LTC3887, LTC3889,
  220. LTM4664, LTM4675, LTM4676, LTM4677, LTM4678, LTM4680,
  221. LTM4700: N=1-2
  222. - LTC3883: N=2
  223. power[N]_input Measured output power.
  224. curr1_label "iin".
  225. LTC3880, LTC3883, LTC3884, LTC3886, LTC3887, LTC3889,
  226. LTM4644, LTM4675, LTM4676, LTM4677, LTM4678, LTM4680,
  227. and LTM4700 only.
  228. curr1_input Measured input current.
  229. curr1_max Maximum input current.
  230. curr1_max_alarm Input current high alarm.
  231. curr1_highest Highest input current.
  232. LTC3883 and LTC3886 only.
  233. curr1_reset_history Reset input current history.
  234. LTC3883 and LTC3886 only.
  235. curr[N]_label "iout[1-4]".
  236. - LTC2972: N-1-2
  237. - LTC2974, LTC2975: N=1-4
  238. - LTC2977, LTC2979, LTC2980, LTM2987: not supported
  239. - LTC2978: not supported
  240. - LTC3880, LTC3882, LTC3884, LTC3886, LTC3887, LTC3889,
  241. LTM4664, LTM4675, LTM4676, LTM4677, LTM4678, LTM4680,
  242. LTM4700: N=2-3
  243. - LTC3883: N=2
  244. curr[N]_input Measured output current.
  245. curr[N]_max Maximum output current.
  246. curr[N]_crit Critical high output current.
  247. curr[N]_lcrit Critical low output current.
  248. LTC2972, LTC2974 and LTC2975 only.
  249. curr[N]_max_alarm Output current high alarm.
  250. curr[N]_crit_alarm Output current critical high alarm.
  251. curr[N]_lcrit_alarm Output current critical low alarm.
  252. LTC2972, LTC2974 and LTC2975 only.
  253. curr[N]_lowest Lowest output current.
  254. LTC2972, LTC2974 and LTC2975 only.
  255. curr[N]_highest Highest output current.
  256. curr[N]_reset_history Reset output current history.
  257. ======================= ========================================================