606 lines · plain
1Kernel driver isl681372======================3 4Supported chips:5 6 * Renesas ISL681377 8 Prefix: 'isl68137'9 10 Addresses scanned: -11 12 Datasheet:13 14 Publicly available at the Renesas website15 https://www.renesas.com/us/en/www/doc/datasheet/isl68137.pdf16 17 * Renesas ISL6822018 19 Prefix: 'isl68220'20 21 Addresses scanned: -22 23 Datasheet:24 25 Publicly available (after August 2020 launch) at the Renesas website26 27 * Renesas ISL6822128 29 Prefix: 'isl68221'30 31 Addresses scanned: -32 33 Datasheet:34 35 Publicly available (after August 2020 launch) at the Renesas website36 37 * Renesas ISL6822238 39 Prefix: 'isl68222'40 41 Addresses scanned: -42 43 Datasheet:44 45 Publicly available (after August 2020 launch) at the Renesas website46 47 * Renesas ISL6822348 49 Prefix: 'isl68223'50 51 Addresses scanned: -52 53 Datasheet:54 55 Publicly available (after August 2020 launch) at the Renesas website56 57 * Renesas ISL6822458 59 Prefix: 'isl68224'60 61 Addresses scanned: -62 63 Datasheet:64 65 Publicly available (after August 2020 launch) at the Renesas website66 67 * Renesas ISL6822568 69 Prefix: 'isl68225'70 71 Addresses scanned: -72 73 Datasheet:74 75 Publicly available (after August 2020 launch) at the Renesas website76 77 * Renesas ISL6822678 79 Prefix: 'isl68226'80 81 Addresses scanned: -82 83 Datasheet:84 85 Publicly available (after August 2020 launch) at the Renesas website86 87 * Renesas ISL6822788 89 Prefix: 'isl68227'90 91 Addresses scanned: -92 93 Datasheet:94 95 Publicly available (after August 2020 launch) at the Renesas website96 97 * Renesas ISL6822998 99 Prefix: 'isl68229'100 101 Addresses scanned: -102 103 Datasheet:104 105 Publicly available (after August 2020 launch) at the Renesas website106 107 * Renesas ISL68233108 109 Prefix: 'isl68233'110 111 Addresses scanned: -112 113 Datasheet:114 115 Publicly available (after August 2020 launch) at the Renesas website116 117 * Renesas ISL68239118 119 Prefix: 'isl68239'120 121 Addresses scanned: -122 123 Datasheet:124 125 Publicly available (after August 2020 launch) at the Renesas website126 127 * Renesas ISL69222128 129 Prefix: 'isl69222'130 131 Addresses scanned: -132 133 Datasheet:134 135 Publicly available (after August 2020 launch) at the Renesas website136 137 * Renesas ISL69223138 139 Prefix: 'isl69223'140 141 Addresses scanned: -142 143 Datasheet:144 145 Publicly available (after August 2020 launch) at the Renesas website146 147 * Renesas ISL69224148 149 Prefix: 'isl69224'150 151 Addresses scanned: -152 153 Datasheet:154 155 Publicly available (after August 2020 launch) at the Renesas website156 157 * Renesas ISL69225158 159 Prefix: 'isl69225'160 161 Addresses scanned: -162 163 Datasheet:164 165 Publicly available (after August 2020 launch) at the Renesas website166 167 * Renesas ISL69227168 169 Prefix: 'isl69227'170 171 Addresses scanned: -172 173 Datasheet:174 175 Publicly available (after August 2020 launch) at the Renesas website176 177 * Renesas ISL69228178 179 Prefix: 'isl69228'180 181 Addresses scanned: -182 183 Datasheet:184 185 Publicly available (after August 2020 launch) at the Renesas website186 187 * Renesas ISL69234188 189 Prefix: 'isl69234'190 191 Addresses scanned: -192 193 Datasheet:194 195 Publicly available (after August 2020 launch) at the Renesas website196 197 * Renesas ISL69236198 199 Prefix: 'isl69236'200 201 Addresses scanned: -202 203 Datasheet:204 205 Publicly available (after August 2020 launch) at the Renesas website206 207 * Renesas ISL69239208 209 Prefix: 'isl69239'210 211 Addresses scanned: -212 213 Datasheet:214 215 Publicly available (after August 2020 launch) at the Renesas website216 217 * Renesas ISL69242218 219 Prefix: 'isl69242'220 221 Addresses scanned: -222 223 Datasheet:224 225 Publicly available (after August 2020 launch) at the Renesas website226 227 * Renesas ISL69243228 229 Prefix: 'isl69243'230 231 Addresses scanned: -232 233 Datasheet:234 235 Publicly available (after August 2020 launch) at the Renesas website236 237 * Renesas ISL69247238 239 Prefix: 'isl69247'240 241 Addresses scanned: -242 243 Datasheet:244 245 Publicly available (after August 2020 launch) at the Renesas website246 247 * Renesas ISL69248248 249 Prefix: 'isl69248'250 251 Addresses scanned: -252 253 Datasheet:254 255 Publicly available (after August 2020 launch) at the Renesas website256 257 * Renesas ISL69254258 259 Prefix: 'isl69254'260 261 Addresses scanned: -262 263 Datasheet:264 265 Publicly available (after August 2020 launch) at the Renesas website266 267 * Renesas ISL69255268 269 Prefix: 'isl69255'270 271 Addresses scanned: -272 273 Datasheet:274 275 Publicly available (after August 2020 launch) at the Renesas website276 277 * Renesas ISL69256278 279 Prefix: 'isl69256'280 281 Addresses scanned: -282 283 Datasheet:284 285 Publicly available (after August 2020 launch) at the Renesas website286 287 * Renesas ISL69259288 289 Prefix: 'isl69259'290 291 Addresses scanned: -292 293 Datasheet:294 295 Publicly available (after August 2020 launch) at the Renesas website296 297 * Renesas ISL69260298 299 Prefix: 'isl69260'300 301 Addresses scanned: -302 303 Datasheet:304 305 Publicly available (after August 2020 launch) at the Renesas website306 307 * Renesas ISL69268308 309 Prefix: 'isl69268'310 311 Addresses scanned: -312 313 Datasheet:314 315 Publicly available (after August 2020 launch) at the Renesas website316 317 * Renesas ISL69269318 319 Prefix: 'isl69269'320 321 Addresses scanned: -322 323 Datasheet:324 325 Publicly available (after August 2020 launch) at the Renesas website326 327 * Renesas ISL69298328 329 Prefix: 'isl69298'330 331 Addresses scanned: -332 333 Datasheet:334 335 Publicly available (after August 2020 launch) at the Renesas website336 337 * Renesas RAA228000338 339 Prefix: 'raa228000'340 341 Addresses scanned: -342 343 Datasheet:344 345 Publicly available (after August 2020 launch) at the Renesas website346 347 * Renesas RAA228004348 349 Prefix: 'raa228004'350 351 Addresses scanned: -352 353 Datasheet:354 355 Publicly available (after August 2020 launch) at the Renesas website356 357 * Renesas RAA228006358 359 Prefix: 'raa228006'360 361 Addresses scanned: -362 363 Datasheet:364 365 Publicly available (after August 2020 launch) at the Renesas website366 367 * Renesas RAA228228368 369 Prefix: 'raa228228'370 371 Addresses scanned: -372 373 Datasheet:374 375 Publicly available (after August 2020 launch) at the Renesas website376 377 * Renesas RAA229001378 379 Prefix: 'raa229001'380 381 Addresses scanned: -382 383 Datasheet:384 385 Publicly available (after August 2020 launch) at the Renesas website386 387 * Renesas RAA229004388 389 Prefix: 'raa229004'390 391 Addresses scanned: -392 393 Datasheet:394 395 Publicly available (after August 2020 launch) at the Renesas website396 397Authors:398 - Maxim Sloyko <maxims@google.com>399 - Robert Lippert <rlippert@google.com>400 - Patrick Venture <venture@google.com>401 - Grant Peltier <grant.peltier.jg@renesas.com>402 403Description404-----------405 406This driver supports the Renesas ISL68137 and all 2nd generation Renesas407digital multiphase voltage regulators (raa_dmpvr2). The ISL68137 is a digital408output 7-phase configurable PWM controller with an AVSBus interface. 2nd409generation devices are grouped into 4 distinct configurations: '1rail' for410single-rail devices, '2rail' for dual-rail devices, '3rail' for 3-rail devices,411and 'hv' for high voltage single-rail devices. Consult the individual datasheets412for more information.413 414Usage Notes415-----------416 417This driver does not probe for PMBus devices. You will have to instantiate418devices explicitly.419 420The ISL68137 AVS operation mode must be enabled/disabled at runtime.421 422Beyond the normal sysfs pmbus attributes, the driver exposes a control attribute423for the ISL68137.424 425For 2nd generation Renesas digital multiphase voltage regulators, only the426normal sysfs pmbus attributes are supported.427 428ISL68137 sysfs attributes429-------------------------430 431======================= ====================================432avs(0|1)_enable Controls the AVS state of each rail.433 434curr1_label "iin"435curr1_input Measured input current436curr1_crit Critical maximum current437curr1_crit_alarm Current critical high alarm438 439curr[2-3]_label "iout[1-2]"440curr[2-3]_input Measured output current441curr[2-3]_crit Critical maximum current442curr[2-3]_crit_alarm Current critical high alarm443 444in1_label "vin"445in1_input Measured input voltage446in1_lcrit Critical minimum input voltage447in1_lcrit_alarm Input voltage critical low alarm448in1_crit Critical maximum input voltage449in1_crit_alarm Input voltage critical high alarm450 451in[2-3]_label "vout[1-2]"452in[2-3]_input Measured output voltage453in[2-3]_lcrit Critical minimum output voltage454in[2-3]_lcrit_alarm Output voltage critical low alarm455in[2-3]_crit Critical maximum output voltage456in[2-3]_crit_alarm Output voltage critical high alarm457 458power1_label "pin"459power1_input Measured input power460power1_alarm Input power high alarm461 462power[2-3]_label "pout[1-2]"463power[2-3]_input Measured output power464 465temp[1-3]_input Measured temperature466temp[1-3]_crit Critical high temperature467temp[1-3]_crit_alarm Chip temperature critical high alarm468temp[1-3]_max Maximum temperature469temp[1-3]_max_alarm Chip temperature high alarm470======================= ====================================471 472raa_dmpvr2_1rail/hv sysfs attributes473------------------------------------474 475======================= ==========================================476curr1_label "iin"477curr1_input Measured input current478curr1_crit Critical maximum current479curr1_crit_alarm Current critical high alarm480 481curr2_label "iout"482curr2_input Measured output current483curr2_crit Critical maximum current484curr2_crit_alarm Current critical high alarm485 486in1_label "vin"487in1_input Measured input voltage488in1_lcrit Critical minimum input voltage489in1_lcrit_alarm Input voltage critical low alarm490in1_crit Critical maximum input voltage491in1_crit_alarm Input voltage critical high alarm492 493in2_label "vmon"494in2_input Scaled VMON voltage read from the VMON pin495 496in3_label "vout"497in3_input Measured output voltage498in3_lcrit Critical minimum output voltage499in3_lcrit_alarm Output voltage critical low alarm500in3_crit Critical maximum output voltage501in3_crit_alarm Output voltage critical high alarm502 503power1_label "pin"504power1_input Measured input power505power1_alarm Input power high alarm506 507power2_label "pout"508power2_input Measured output power509 510temp[1-3]_input Measured temperature511temp[1-3]_crit Critical high temperature512temp[1-3]_crit_alarm Chip temperature critical high alarm513temp[1-3]_max Maximum temperature514temp[1-3]_max_alarm Chip temperature high alarm515======================= ==========================================516 517raa_dmpvr2_2rail sysfs attributes518---------------------------------519 520======================= ==========================================521curr[1-2]_label "iin[1-2]"522curr[1-2]_input Measured input current523curr[1-2]_crit Critical maximum current524curr[1-2]_crit_alarm Current critical high alarm525 526curr[3-4]_label "iout[1-2]"527curr[3-4]_input Measured output current528curr[3-4]_crit Critical maximum current529curr[3-4]_crit_alarm Current critical high alarm530 531in1_label "vin"532in1_input Measured input voltage533in1_lcrit Critical minimum input voltage534in1_lcrit_alarm Input voltage critical low alarm535in1_crit Critical maximum input voltage536in1_crit_alarm Input voltage critical high alarm537 538in2_label "vmon"539in2_input Scaled VMON voltage read from the VMON pin540 541in[3-4]_label "vout[1-2]"542in[3-4]_input Measured output voltage543in[3-4]_lcrit Critical minimum output voltage544in[3-4]_lcrit_alarm Output voltage critical low alarm545in[3-4]_crit Critical maximum output voltage546in[3-4]_crit_alarm Output voltage critical high alarm547 548power[1-2]_label "pin[1-2]"549power[1-2]_input Measured input power550power[1-2]_alarm Input power high alarm551 552power[3-4]_label "pout[1-2]"553power[3-4]_input Measured output power554 555temp[1-5]_input Measured temperature556temp[1-5]_crit Critical high temperature557temp[1-5]_crit_alarm Chip temperature critical high alarm558temp[1-5]_max Maximum temperature559temp[1-5]_max_alarm Chip temperature high alarm560======================= ==========================================561 562raa_dmpvr2_3rail sysfs attributes563---------------------------------564 565======================= ==========================================566curr[1-3]_label "iin[1-3]"567curr[1-3]_input Measured input current568curr[1-3]_crit Critical maximum current569curr[1-3]_crit_alarm Current critical high alarm570 571curr[4-6]_label "iout[1-3]"572curr[4-6]_input Measured output current573curr[4-6]_crit Critical maximum current574curr[4-6]_crit_alarm Current critical high alarm575 576in1_label "vin"577in1_input Measured input voltage578in1_lcrit Critical minimum input voltage579in1_lcrit_alarm Input voltage critical low alarm580in1_crit Critical maximum input voltage581in1_crit_alarm Input voltage critical high alarm582 583in2_label "vmon"584in2_input Scaled VMON voltage read from the VMON pin585 586in[3-5]_label "vout[1-3]"587in[3-5]_input Measured output voltage588in[3-5]_lcrit Critical minimum output voltage589in[3-5]_lcrit_alarm Output voltage critical low alarm590in[3-5]_crit Critical maximum output voltage591in[3-5]_crit_alarm Output voltage critical high alarm592 593power[1-3]_label "pin[1-3]"594power[1-3]_input Measured input power595power[1-3]_alarm Input power high alarm596 597power[4-6]_label "pout[1-3]"598power[4-6]_input Measured output power599 600temp[1-7]_input Measured temperature601temp[1-7]_crit Critical high temperature602temp[1-7]_crit_alarm Chip temperature critical high alarm603temp[1-7]_max Maximum temperature604temp[1-7]_max_alarm Chip temperature high alarm605======================= ==========================================606