isl68137.rst 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605
  1. Kernel driver isl68137
  2. ======================
  3. Supported chips:
  4. * Renesas ISL68137
  5. Prefix: 'isl68137'
  6. Addresses scanned: -
  7. Datasheet:
  8. Publicly available at the Renesas website
  9. https://www.renesas.com/us/en/www/doc/datasheet/isl68137.pdf
  10. * Renesas ISL68220
  11. Prefix: 'isl68220'
  12. Addresses scanned: -
  13. Datasheet:
  14. Publicly available (after August 2020 launch) at the Renesas website
  15. * Renesas ISL68221
  16. Prefix: 'isl68221'
  17. Addresses scanned: -
  18. Datasheet:
  19. Publicly available (after August 2020 launch) at the Renesas website
  20. * Renesas ISL68222
  21. Prefix: 'isl68222'
  22. Addresses scanned: -
  23. Datasheet:
  24. Publicly available (after August 2020 launch) at the Renesas website
  25. * Renesas ISL68223
  26. Prefix: 'isl68223'
  27. Addresses scanned: -
  28. Datasheet:
  29. Publicly available (after August 2020 launch) at the Renesas website
  30. * Renesas ISL68224
  31. Prefix: 'isl68224'
  32. Addresses scanned: -
  33. Datasheet:
  34. Publicly available (after August 2020 launch) at the Renesas website
  35. * Renesas ISL68225
  36. Prefix: 'isl68225'
  37. Addresses scanned: -
  38. Datasheet:
  39. Publicly available (after August 2020 launch) at the Renesas website
  40. * Renesas ISL68226
  41. Prefix: 'isl68226'
  42. Addresses scanned: -
  43. Datasheet:
  44. Publicly available (after August 2020 launch) at the Renesas website
  45. * Renesas ISL68227
  46. Prefix: 'isl68227'
  47. Addresses scanned: -
  48. Datasheet:
  49. Publicly available (after August 2020 launch) at the Renesas website
  50. * Renesas ISL68229
  51. Prefix: 'isl68229'
  52. Addresses scanned: -
  53. Datasheet:
  54. Publicly available (after August 2020 launch) at the Renesas website
  55. * Renesas ISL68233
  56. Prefix: 'isl68233'
  57. Addresses scanned: -
  58. Datasheet:
  59. Publicly available (after August 2020 launch) at the Renesas website
  60. * Renesas ISL68239
  61. Prefix: 'isl68239'
  62. Addresses scanned: -
  63. Datasheet:
  64. Publicly available (after August 2020 launch) at the Renesas website
  65. * Renesas ISL69222
  66. Prefix: 'isl69222'
  67. Addresses scanned: -
  68. Datasheet:
  69. Publicly available (after August 2020 launch) at the Renesas website
  70. * Renesas ISL69223
  71. Prefix: 'isl69223'
  72. Addresses scanned: -
  73. Datasheet:
  74. Publicly available (after August 2020 launch) at the Renesas website
  75. * Renesas ISL69224
  76. Prefix: 'isl69224'
  77. Addresses scanned: -
  78. Datasheet:
  79. Publicly available (after August 2020 launch) at the Renesas website
  80. * Renesas ISL69225
  81. Prefix: 'isl69225'
  82. Addresses scanned: -
  83. Datasheet:
  84. Publicly available (after August 2020 launch) at the Renesas website
  85. * Renesas ISL69227
  86. Prefix: 'isl69227'
  87. Addresses scanned: -
  88. Datasheet:
  89. Publicly available (after August 2020 launch) at the Renesas website
  90. * Renesas ISL69228
  91. Prefix: 'isl69228'
  92. Addresses scanned: -
  93. Datasheet:
  94. Publicly available (after August 2020 launch) at the Renesas website
  95. * Renesas ISL69234
  96. Prefix: 'isl69234'
  97. Addresses scanned: -
  98. Datasheet:
  99. Publicly available (after August 2020 launch) at the Renesas website
  100. * Renesas ISL69236
  101. Prefix: 'isl69236'
  102. Addresses scanned: -
  103. Datasheet:
  104. Publicly available (after August 2020 launch) at the Renesas website
  105. * Renesas ISL69239
  106. Prefix: 'isl69239'
  107. Addresses scanned: -
  108. Datasheet:
  109. Publicly available (after August 2020 launch) at the Renesas website
  110. * Renesas ISL69242
  111. Prefix: 'isl69242'
  112. Addresses scanned: -
  113. Datasheet:
  114. Publicly available (after August 2020 launch) at the Renesas website
  115. * Renesas ISL69243
  116. Prefix: 'isl69243'
  117. Addresses scanned: -
  118. Datasheet:
  119. Publicly available (after August 2020 launch) at the Renesas website
  120. * Renesas ISL69247
  121. Prefix: 'isl69247'
  122. Addresses scanned: -
  123. Datasheet:
  124. Publicly available (after August 2020 launch) at the Renesas website
  125. * Renesas ISL69248
  126. Prefix: 'isl69248'
  127. Addresses scanned: -
  128. Datasheet:
  129. Publicly available (after August 2020 launch) at the Renesas website
  130. * Renesas ISL69254
  131. Prefix: 'isl69254'
  132. Addresses scanned: -
  133. Datasheet:
  134. Publicly available (after August 2020 launch) at the Renesas website
  135. * Renesas ISL69255
  136. Prefix: 'isl69255'
  137. Addresses scanned: -
  138. Datasheet:
  139. Publicly available (after August 2020 launch) at the Renesas website
  140. * Renesas ISL69256
  141. Prefix: 'isl69256'
  142. Addresses scanned: -
  143. Datasheet:
  144. Publicly available (after August 2020 launch) at the Renesas website
  145. * Renesas ISL69259
  146. Prefix: 'isl69259'
  147. Addresses scanned: -
  148. Datasheet:
  149. Publicly available (after August 2020 launch) at the Renesas website
  150. * Renesas ISL69260
  151. Prefix: 'isl69260'
  152. Addresses scanned: -
  153. Datasheet:
  154. Publicly available (after August 2020 launch) at the Renesas website
  155. * Renesas ISL69268
  156. Prefix: 'isl69268'
  157. Addresses scanned: -
  158. Datasheet:
  159. Publicly available (after August 2020 launch) at the Renesas website
  160. * Renesas ISL69269
  161. Prefix: 'isl69269'
  162. Addresses scanned: -
  163. Datasheet:
  164. Publicly available (after August 2020 launch) at the Renesas website
  165. * Renesas ISL69298
  166. Prefix: 'isl69298'
  167. Addresses scanned: -
  168. Datasheet:
  169. Publicly available (after August 2020 launch) at the Renesas website
  170. * Renesas RAA228000
  171. Prefix: 'raa228000'
  172. Addresses scanned: -
  173. Datasheet:
  174. Publicly available (after August 2020 launch) at the Renesas website
  175. * Renesas RAA228004
  176. Prefix: 'raa228004'
  177. Addresses scanned: -
  178. Datasheet:
  179. Publicly available (after August 2020 launch) at the Renesas website
  180. * Renesas RAA228006
  181. Prefix: 'raa228006'
  182. Addresses scanned: -
  183. Datasheet:
  184. Publicly available (after August 2020 launch) at the Renesas website
  185. * Renesas RAA228228
  186. Prefix: 'raa228228'
  187. Addresses scanned: -
  188. Datasheet:
  189. Publicly available (after August 2020 launch) at the Renesas website
  190. * Renesas RAA229001
  191. Prefix: 'raa229001'
  192. Addresses scanned: -
  193. Datasheet:
  194. Publicly available (after August 2020 launch) at the Renesas website
  195. * Renesas RAA229004
  196. Prefix: 'raa229004'
  197. Addresses scanned: -
  198. Datasheet:
  199. Publicly available (after August 2020 launch) at the Renesas website
  200. Authors:
  201. - Maxim Sloyko <maxims@google.com>
  202. - Robert Lippert <rlippert@google.com>
  203. - Patrick Venture <venture@google.com>
  204. - Grant Peltier <grant.peltier.jg@renesas.com>
  205. Description
  206. -----------
  207. This driver supports the Renesas ISL68137 and all 2nd generation Renesas
  208. digital multiphase voltage regulators (raa_dmpvr2). The ISL68137 is a digital
  209. output 7-phase configurable PWM controller with an AVSBus interface. 2nd
  210. generation devices are grouped into 4 distinct configurations: '1rail' for
  211. single-rail devices, '2rail' for dual-rail devices, '3rail' for 3-rail devices,
  212. and 'hv' for high voltage single-rail devices. Consult the individual datasheets
  213. for more information.
  214. Usage Notes
  215. -----------
  216. This driver does not probe for PMBus devices. You will have to instantiate
  217. devices explicitly.
  218. The ISL68137 AVS operation mode must be enabled/disabled at runtime.
  219. Beyond the normal sysfs pmbus attributes, the driver exposes a control attribute
  220. for the ISL68137.
  221. For 2nd generation Renesas digital multiphase voltage regulators, only the
  222. normal sysfs pmbus attributes are supported.
  223. ISL68137 sysfs attributes
  224. -------------------------
  225. ======================= ====================================
  226. avs(0|1)_enable Controls the AVS state of each rail.
  227. curr1_label "iin"
  228. curr1_input Measured input current
  229. curr1_crit Critical maximum current
  230. curr1_crit_alarm Current critical high alarm
  231. curr[2-3]_label "iout[1-2]"
  232. curr[2-3]_input Measured output current
  233. curr[2-3]_crit Critical maximum current
  234. curr[2-3]_crit_alarm Current critical high alarm
  235. in1_label "vin"
  236. in1_input Measured input voltage
  237. in1_lcrit Critical minimum input voltage
  238. in1_lcrit_alarm Input voltage critical low alarm
  239. in1_crit Critical maximum input voltage
  240. in1_crit_alarm Input voltage critical high alarm
  241. in[2-3]_label "vout[1-2]"
  242. in[2-3]_input Measured output voltage
  243. in[2-3]_lcrit Critical minimum output voltage
  244. in[2-3]_lcrit_alarm Output voltage critical low alarm
  245. in[2-3]_crit Critical maximum output voltage
  246. in[2-3]_crit_alarm Output voltage critical high alarm
  247. power1_label "pin"
  248. power1_input Measured input power
  249. power1_alarm Input power high alarm
  250. power[2-3]_label "pout[1-2]"
  251. power[2-3]_input Measured output power
  252. temp[1-3]_input Measured temperature
  253. temp[1-3]_crit Critical high temperature
  254. temp[1-3]_crit_alarm Chip temperature critical high alarm
  255. temp[1-3]_max Maximum temperature
  256. temp[1-3]_max_alarm Chip temperature high alarm
  257. ======================= ====================================
  258. raa_dmpvr2_1rail/hv sysfs attributes
  259. ------------------------------------
  260. ======================= ==========================================
  261. curr1_label "iin"
  262. curr1_input Measured input current
  263. curr1_crit Critical maximum current
  264. curr1_crit_alarm Current critical high alarm
  265. curr2_label "iout"
  266. curr2_input Measured output current
  267. curr2_crit Critical maximum current
  268. curr2_crit_alarm Current critical high alarm
  269. in1_label "vin"
  270. in1_input Measured input voltage
  271. in1_lcrit Critical minimum input voltage
  272. in1_lcrit_alarm Input voltage critical low alarm
  273. in1_crit Critical maximum input voltage
  274. in1_crit_alarm Input voltage critical high alarm
  275. in2_label "vmon"
  276. in2_input Scaled VMON voltage read from the VMON pin
  277. in3_label "vout"
  278. in3_input Measured output voltage
  279. in3_lcrit Critical minimum output voltage
  280. in3_lcrit_alarm Output voltage critical low alarm
  281. in3_crit Critical maximum output voltage
  282. in3_crit_alarm Output voltage critical high alarm
  283. power1_label "pin"
  284. power1_input Measured input power
  285. power1_alarm Input power high alarm
  286. power2_label "pout"
  287. power2_input Measured output power
  288. temp[1-3]_input Measured temperature
  289. temp[1-3]_crit Critical high temperature
  290. temp[1-3]_crit_alarm Chip temperature critical high alarm
  291. temp[1-3]_max Maximum temperature
  292. temp[1-3]_max_alarm Chip temperature high alarm
  293. ======================= ==========================================
  294. raa_dmpvr2_2rail sysfs attributes
  295. ---------------------------------
  296. ======================= ==========================================
  297. curr[1-2]_label "iin[1-2]"
  298. curr[1-2]_input Measured input current
  299. curr[1-2]_crit Critical maximum current
  300. curr[1-2]_crit_alarm Current critical high alarm
  301. curr[3-4]_label "iout[1-2]"
  302. curr[3-4]_input Measured output current
  303. curr[3-4]_crit Critical maximum current
  304. curr[3-4]_crit_alarm Current critical high alarm
  305. in1_label "vin"
  306. in1_input Measured input voltage
  307. in1_lcrit Critical minimum input voltage
  308. in1_lcrit_alarm Input voltage critical low alarm
  309. in1_crit Critical maximum input voltage
  310. in1_crit_alarm Input voltage critical high alarm
  311. in2_label "vmon"
  312. in2_input Scaled VMON voltage read from the VMON pin
  313. in[3-4]_label "vout[1-2]"
  314. in[3-4]_input Measured output voltage
  315. in[3-4]_lcrit Critical minimum output voltage
  316. in[3-4]_lcrit_alarm Output voltage critical low alarm
  317. in[3-4]_crit Critical maximum output voltage
  318. in[3-4]_crit_alarm Output voltage critical high alarm
  319. power[1-2]_label "pin[1-2]"
  320. power[1-2]_input Measured input power
  321. power[1-2]_alarm Input power high alarm
  322. power[3-4]_label "pout[1-2]"
  323. power[3-4]_input Measured output power
  324. temp[1-5]_input Measured temperature
  325. temp[1-5]_crit Critical high temperature
  326. temp[1-5]_crit_alarm Chip temperature critical high alarm
  327. temp[1-5]_max Maximum temperature
  328. temp[1-5]_max_alarm Chip temperature high alarm
  329. ======================= ==========================================
  330. raa_dmpvr2_3rail sysfs attributes
  331. ---------------------------------
  332. ======================= ==========================================
  333. curr[1-3]_label "iin[1-3]"
  334. curr[1-3]_input Measured input current
  335. curr[1-3]_crit Critical maximum current
  336. curr[1-3]_crit_alarm Current critical high alarm
  337. curr[4-6]_label "iout[1-3]"
  338. curr[4-6]_input Measured output current
  339. curr[4-6]_crit Critical maximum current
  340. curr[4-6]_crit_alarm Current critical high alarm
  341. in1_label "vin"
  342. in1_input Measured input voltage
  343. in1_lcrit Critical minimum input voltage
  344. in1_lcrit_alarm Input voltage critical low alarm
  345. in1_crit Critical maximum input voltage
  346. in1_crit_alarm Input voltage critical high alarm
  347. in2_label "vmon"
  348. in2_input Scaled VMON voltage read from the VMON pin
  349. in[3-5]_label "vout[1-3]"
  350. in[3-5]_input Measured output voltage
  351. in[3-5]_lcrit Critical minimum output voltage
  352. in[3-5]_lcrit_alarm Output voltage critical low alarm
  353. in[3-5]_crit Critical maximum output voltage
  354. in[3-5]_crit_alarm Output voltage critical high alarm
  355. power[1-3]_label "pin[1-3]"
  356. power[1-3]_input Measured input power
  357. power[1-3]_alarm Input power high alarm
  358. power[4-6]_label "pout[1-3]"
  359. power[4-6]_input Measured output power
  360. temp[1-7]_input Measured temperature
  361. temp[1-7]_crit Critical high temperature
  362. temp[1-7]_crit_alarm Chip temperature critical high alarm
  363. temp[1-7]_max Maximum temperature
  364. temp[1-7]_max_alarm Chip temperature high alarm
  365. ======================= ==========================================