0001 Kernel driver isl68137
0002 ======================
0003
0004 Supported chips:
0005
0006 * Renesas ISL68137
0007
0008 Prefix: 'isl68137'
0009
0010 Addresses scanned: -
0011
0012 Datasheet:
0013
0014 Publicly available at the Renesas website
0015 https://www.renesas.com/us/en/www/doc/datasheet/isl68137.pdf
0016
0017 * Renesas ISL68220
0018
0019 Prefix: 'isl68220'
0020
0021 Addresses scanned: -
0022
0023 Datasheet:
0024
0025 Publicly available (after August 2020 launch) at the Renesas website
0026
0027 * Renesas ISL68221
0028
0029 Prefix: 'isl68221'
0030
0031 Addresses scanned: -
0032
0033 Datasheet:
0034
0035 Publicly available (after August 2020 launch) at the Renesas website
0036
0037 * Renesas ISL68222
0038
0039 Prefix: 'isl68222'
0040
0041 Addresses scanned: -
0042
0043 Datasheet:
0044
0045 Publicly available (after August 2020 launch) at the Renesas website
0046
0047 * Renesas ISL68223
0048
0049 Prefix: 'isl68223'
0050
0051 Addresses scanned: -
0052
0053 Datasheet:
0054
0055 Publicly available (after August 2020 launch) at the Renesas website
0056
0057 * Renesas ISL68224
0058
0059 Prefix: 'isl68224'
0060
0061 Addresses scanned: -
0062
0063 Datasheet:
0064
0065 Publicly available (after August 2020 launch) at the Renesas website
0066
0067 * Renesas ISL68225
0068
0069 Prefix: 'isl68225'
0070
0071 Addresses scanned: -
0072
0073 Datasheet:
0074
0075 Publicly available (after August 2020 launch) at the Renesas website
0076
0077 * Renesas ISL68226
0078
0079 Prefix: 'isl68226'
0080
0081 Addresses scanned: -
0082
0083 Datasheet:
0084
0085 Publicly available (after August 2020 launch) at the Renesas website
0086
0087 * Renesas ISL68227
0088
0089 Prefix: 'isl68227'
0090
0091 Addresses scanned: -
0092
0093 Datasheet:
0094
0095 Publicly available (after August 2020 launch) at the Renesas website
0096
0097 * Renesas ISL68229
0098
0099 Prefix: 'isl68229'
0100
0101 Addresses scanned: -
0102
0103 Datasheet:
0104
0105 Publicly available (after August 2020 launch) at the Renesas website
0106
0107 * Renesas ISL68233
0108
0109 Prefix: 'isl68233'
0110
0111 Addresses scanned: -
0112
0113 Datasheet:
0114
0115 Publicly available (after August 2020 launch) at the Renesas website
0116
0117 * Renesas ISL68239
0118
0119 Prefix: 'isl68239'
0120
0121 Addresses scanned: -
0122
0123 Datasheet:
0124
0125 Publicly available (after August 2020 launch) at the Renesas website
0126
0127 * Renesas ISL69222
0128
0129 Prefix: 'isl69222'
0130
0131 Addresses scanned: -
0132
0133 Datasheet:
0134
0135 Publicly available (after August 2020 launch) at the Renesas website
0136
0137 * Renesas ISL69223
0138
0139 Prefix: 'isl69223'
0140
0141 Addresses scanned: -
0142
0143 Datasheet:
0144
0145 Publicly available (after August 2020 launch) at the Renesas website
0146
0147 * Renesas ISL69224
0148
0149 Prefix: 'isl69224'
0150
0151 Addresses scanned: -
0152
0153 Datasheet:
0154
0155 Publicly available (after August 2020 launch) at the Renesas website
0156
0157 * Renesas ISL69225
0158
0159 Prefix: 'isl69225'
0160
0161 Addresses scanned: -
0162
0163 Datasheet:
0164
0165 Publicly available (after August 2020 launch) at the Renesas website
0166
0167 * Renesas ISL69227
0168
0169 Prefix: 'isl69227'
0170
0171 Addresses scanned: -
0172
0173 Datasheet:
0174
0175 Publicly available (after August 2020 launch) at the Renesas website
0176
0177 * Renesas ISL69228
0178
0179 Prefix: 'isl69228'
0180
0181 Addresses scanned: -
0182
0183 Datasheet:
0184
0185 Publicly available (after August 2020 launch) at the Renesas website
0186
0187 * Renesas ISL69234
0188
0189 Prefix: 'isl69234'
0190
0191 Addresses scanned: -
0192
0193 Datasheet:
0194
0195 Publicly available (after August 2020 launch) at the Renesas website
0196
0197 * Renesas ISL69236
0198
0199 Prefix: 'isl69236'
0200
0201 Addresses scanned: -
0202
0203 Datasheet:
0204
0205 Publicly available (after August 2020 launch) at the Renesas website
0206
0207 * Renesas ISL69239
0208
0209 Prefix: 'isl69239'
0210
0211 Addresses scanned: -
0212
0213 Datasheet:
0214
0215 Publicly available (after August 2020 launch) at the Renesas website
0216
0217 * Renesas ISL69242
0218
0219 Prefix: 'isl69242'
0220
0221 Addresses scanned: -
0222
0223 Datasheet:
0224
0225 Publicly available (after August 2020 launch) at the Renesas website
0226
0227 * Renesas ISL69243
0228
0229 Prefix: 'isl69243'
0230
0231 Addresses scanned: -
0232
0233 Datasheet:
0234
0235 Publicly available (after August 2020 launch) at the Renesas website
0236
0237 * Renesas ISL69247
0238
0239 Prefix: 'isl69247'
0240
0241 Addresses scanned: -
0242
0243 Datasheet:
0244
0245 Publicly available (after August 2020 launch) at the Renesas website
0246
0247 * Renesas ISL69248
0248
0249 Prefix: 'isl69248'
0250
0251 Addresses scanned: -
0252
0253 Datasheet:
0254
0255 Publicly available (after August 2020 launch) at the Renesas website
0256
0257 * Renesas ISL69254
0258
0259 Prefix: 'isl69254'
0260
0261 Addresses scanned: -
0262
0263 Datasheet:
0264
0265 Publicly available (after August 2020 launch) at the Renesas website
0266
0267 * Renesas ISL69255
0268
0269 Prefix: 'isl69255'
0270
0271 Addresses scanned: -
0272
0273 Datasheet:
0274
0275 Publicly available (after August 2020 launch) at the Renesas website
0276
0277 * Renesas ISL69256
0278
0279 Prefix: 'isl69256'
0280
0281 Addresses scanned: -
0282
0283 Datasheet:
0284
0285 Publicly available (after August 2020 launch) at the Renesas website
0286
0287 * Renesas ISL69259
0288
0289 Prefix: 'isl69259'
0290
0291 Addresses scanned: -
0292
0293 Datasheet:
0294
0295 Publicly available (after August 2020 launch) at the Renesas website
0296
0297 * Renesas ISL69260
0298
0299 Prefix: 'isl69260'
0300
0301 Addresses scanned: -
0302
0303 Datasheet:
0304
0305 Publicly available (after August 2020 launch) at the Renesas website
0306
0307 * Renesas ISL69268
0308
0309 Prefix: 'isl69268'
0310
0311 Addresses scanned: -
0312
0313 Datasheet:
0314
0315 Publicly available (after August 2020 launch) at the Renesas website
0316
0317 * Renesas ISL69269
0318
0319 Prefix: 'isl69269'
0320
0321 Addresses scanned: -
0322
0323 Datasheet:
0324
0325 Publicly available (after August 2020 launch) at the Renesas website
0326
0327 * Renesas ISL69298
0328
0329 Prefix: 'isl69298'
0330
0331 Addresses scanned: -
0332
0333 Datasheet:
0334
0335 Publicly available (after August 2020 launch) at the Renesas website
0336
0337 * Renesas RAA228000
0338
0339 Prefix: 'raa228000'
0340
0341 Addresses scanned: -
0342
0343 Datasheet:
0344
0345 Publicly available (after August 2020 launch) at the Renesas website
0346
0347 * Renesas RAA228004
0348
0349 Prefix: 'raa228004'
0350
0351 Addresses scanned: -
0352
0353 Datasheet:
0354
0355 Publicly available (after August 2020 launch) at the Renesas website
0356
0357 * Renesas RAA228006
0358
0359 Prefix: 'raa228006'
0360
0361 Addresses scanned: -
0362
0363 Datasheet:
0364
0365 Publicly available (after August 2020 launch) at the Renesas website
0366
0367 * Renesas RAA228228
0368
0369 Prefix: 'raa228228'
0370
0371 Addresses scanned: -
0372
0373 Datasheet:
0374
0375 Publicly available (after August 2020 launch) at the Renesas website
0376
0377 * Renesas RAA229001
0378
0379 Prefix: 'raa229001'
0380
0381 Addresses scanned: -
0382
0383 Datasheet:
0384
0385 Publicly available (after August 2020 launch) at the Renesas website
0386
0387 * Renesas RAA229004
0388
0389 Prefix: 'raa229004'
0390
0391 Addresses scanned: -
0392
0393 Datasheet:
0394
0395 Publicly available (after August 2020 launch) at the Renesas website
0396
0397 Authors:
0398 - Maxim Sloyko <maxims@google.com>
0399 - Robert Lippert <rlippert@google.com>
0400 - Patrick Venture <venture@google.com>
0401 - Grant Peltier <grant.peltier.jg@renesas.com>
0402
0403 Description
0404 -----------
0405
0406 This driver supports the Renesas ISL68137 and all 2nd generation Renesas
0407 digital multiphase voltage regulators (raa_dmpvr2). The ISL68137 is a digital
0408 output 7-phase configurable PWM controller with an AVSBus interface. 2nd
0409 generation devices are grouped into 4 distinct configurations: '1rail' for
0410 single-rail devices, '2rail' for dual-rail devices, '3rail' for 3-rail devices,
0411 and 'hv' for high voltage single-rail devices. Consult the individual datasheets
0412 for more information.
0413
0414 Usage Notes
0415 -----------
0416
0417 This driver does not probe for PMBus devices. You will have to instantiate
0418 devices explicitly.
0419
0420 The ISL68137 AVS operation mode must be enabled/disabled at runtime.
0421
0422 Beyond the normal sysfs pmbus attributes, the driver exposes a control attribute
0423 for the ISL68137.
0424
0425 For 2nd generation Renesas digital multiphase voltage regulators, only the
0426 normal sysfs pmbus attributes are supported.
0427
0428 ISL68137 sysfs attributes
0429 -------------------------
0430
0431 ======================= ====================================
0432 avs(0|1)_enable Controls the AVS state of each rail.
0433
0434 curr1_label "iin"
0435 curr1_input Measured input current
0436 curr1_crit Critical maximum current
0437 curr1_crit_alarm Current critical high alarm
0438
0439 curr[2-3]_label "iout[1-2]"
0440 curr[2-3]_input Measured output current
0441 curr[2-3]_crit Critical maximum current
0442 curr[2-3]_crit_alarm Current critical high alarm
0443
0444 in1_label "vin"
0445 in1_input Measured input voltage
0446 in1_lcrit Critical minimum input voltage
0447 in1_lcrit_alarm Input voltage critical low alarm
0448 in1_crit Critical maximum input voltage
0449 in1_crit_alarm Input voltage critical high alarm
0450
0451 in[2-3]_label "vout[1-2]"
0452 in[2-3]_input Measured output voltage
0453 in[2-3]_lcrit Critical minimum output voltage
0454 in[2-3]_lcrit_alarm Output voltage critical low alarm
0455 in[2-3]_crit Critical maximum output voltage
0456 in[2-3]_crit_alarm Output voltage critical high alarm
0457
0458 power1_label "pin"
0459 power1_input Measured input power
0460 power1_alarm Input power high alarm
0461
0462 power[2-3]_label "pout[1-2]"
0463 power[2-3]_input Measured output power
0464
0465 temp[1-3]_input Measured temperature
0466 temp[1-3]_crit Critical high temperature
0467 temp[1-3]_crit_alarm Chip temperature critical high alarm
0468 temp[1-3]_max Maximum temperature
0469 temp[1-3]_max_alarm Chip temperature high alarm
0470 ======================= ====================================
0471
0472 raa_dmpvr2_1rail/hv sysfs attributes
0473 ------------------------------------
0474
0475 ======================= ==========================================
0476 curr1_label "iin"
0477 curr1_input Measured input current
0478 curr1_crit Critical maximum current
0479 curr1_crit_alarm Current critical high alarm
0480
0481 curr2_label "iout"
0482 curr2_input Measured output current
0483 curr2_crit Critical maximum current
0484 curr2_crit_alarm Current critical high alarm
0485
0486 in1_label "vin"
0487 in1_input Measured input voltage
0488 in1_lcrit Critical minimum input voltage
0489 in1_lcrit_alarm Input voltage critical low alarm
0490 in1_crit Critical maximum input voltage
0491 in1_crit_alarm Input voltage critical high alarm
0492
0493 in2_label "vmon"
0494 in2_input Scaled VMON voltage read from the VMON pin
0495
0496 in3_label "vout"
0497 in3_input Measured output voltage
0498 in3_lcrit Critical minimum output voltage
0499 in3_lcrit_alarm Output voltage critical low alarm
0500 in3_crit Critical maximum output voltage
0501 in3_crit_alarm Output voltage critical high alarm
0502
0503 power1_label "pin"
0504 power1_input Measured input power
0505 power1_alarm Input power high alarm
0506
0507 power2_label "pout"
0508 power2_input Measured output power
0509
0510 temp[1-3]_input Measured temperature
0511 temp[1-3]_crit Critical high temperature
0512 temp[1-3]_crit_alarm Chip temperature critical high alarm
0513 temp[1-3]_max Maximum temperature
0514 temp[1-3]_max_alarm Chip temperature high alarm
0515 ======================= ==========================================
0516
0517 raa_dmpvr2_2rail sysfs attributes
0518 ---------------------------------
0519
0520 ======================= ==========================================
0521 curr[1-2]_label "iin[1-2]"
0522 curr[1-2]_input Measured input current
0523 curr[1-2]_crit Critical maximum current
0524 curr[1-2]_crit_alarm Current critical high alarm
0525
0526 curr[3-4]_label "iout[1-2]"
0527 curr[3-4]_input Measured output current
0528 curr[3-4]_crit Critical maximum current
0529 curr[3-4]_crit_alarm Current critical high alarm
0530
0531 in1_label "vin"
0532 in1_input Measured input voltage
0533 in1_lcrit Critical minimum input voltage
0534 in1_lcrit_alarm Input voltage critical low alarm
0535 in1_crit Critical maximum input voltage
0536 in1_crit_alarm Input voltage critical high alarm
0537
0538 in2_label "vmon"
0539 in2_input Scaled VMON voltage read from the VMON pin
0540
0541 in[3-4]_label "vout[1-2]"
0542 in[3-4]_input Measured output voltage
0543 in[3-4]_lcrit Critical minimum output voltage
0544 in[3-4]_lcrit_alarm Output voltage critical low alarm
0545 in[3-4]_crit Critical maximum output voltage
0546 in[3-4]_crit_alarm Output voltage critical high alarm
0547
0548 power[1-2]_label "pin[1-2]"
0549 power[1-2]_input Measured input power
0550 power[1-2]_alarm Input power high alarm
0551
0552 power[3-4]_label "pout[1-2]"
0553 power[3-4]_input Measured output power
0554
0555 temp[1-5]_input Measured temperature
0556 temp[1-5]_crit Critical high temperature
0557 temp[1-5]_crit_alarm Chip temperature critical high alarm
0558 temp[1-5]_max Maximum temperature
0559 temp[1-5]_max_alarm Chip temperature high alarm
0560 ======================= ==========================================
0561
0562 raa_dmpvr2_3rail sysfs attributes
0563 ---------------------------------
0564
0565 ======================= ==========================================
0566 curr[1-3]_label "iin[1-3]"
0567 curr[1-3]_input Measured input current
0568 curr[1-3]_crit Critical maximum current
0569 curr[1-3]_crit_alarm Current critical high alarm
0570
0571 curr[4-6]_label "iout[1-3]"
0572 curr[4-6]_input Measured output current
0573 curr[4-6]_crit Critical maximum current
0574 curr[4-6]_crit_alarm Current critical high alarm
0575
0576 in1_label "vin"
0577 in1_input Measured input voltage
0578 in1_lcrit Critical minimum input voltage
0579 in1_lcrit_alarm Input voltage critical low alarm
0580 in1_crit Critical maximum input voltage
0581 in1_crit_alarm Input voltage critical high alarm
0582
0583 in2_label "vmon"
0584 in2_input Scaled VMON voltage read from the VMON pin
0585
0586 in[3-5]_label "vout[1-3]"
0587 in[3-5]_input Measured output voltage
0588 in[3-5]_lcrit Critical minimum output voltage
0589 in[3-5]_lcrit_alarm Output voltage critical low alarm
0590 in[3-5]_crit Critical maximum output voltage
0591 in[3-5]_crit_alarm Output voltage critical high alarm
0592
0593 power[1-3]_label "pin[1-3]"
0594 power[1-3]_input Measured input power
0595 power[1-3]_alarm Input power high alarm
0596
0597 power[4-6]_label "pout[1-3]"
0598 power[4-6]_input Measured output power
0599
0600 temp[1-7]_input Measured temperature
0601 temp[1-7]_crit Critical high temperature
0602 temp[1-7]_crit_alarm Chip temperature critical high alarm
0603 temp[1-7]_max Maximum temperature
0604 temp[1-7]_max_alarm Chip temperature high alarm
0605 ======================= ==========================================
