1Kernel driver isl68137
2======================
3
4Supported chips:
5
6  * Renesas ISL68137
7
8    Prefix: 'isl68137'
9
10    Addresses scanned: -
11
12    Datasheet:
13
14      Publicly available at the Renesas website
15      https://www.renesas.com/us/en/www/doc/datasheet/isl68137.pdf
16
17  * Renesas ISL68220
18
19    Prefix: 'isl68220'
20
21    Addresses scanned: -
22
23    Datasheet:
24
25      Publicly available (after August 2020 launch) at the Renesas website
26
27  * Renesas ISL68221
28
29    Prefix: 'isl68221'
30
31    Addresses scanned: -
32
33    Datasheet:
34
35      Publicly available (after August 2020 launch) at the Renesas website
36
37  * Renesas ISL68222
38
39    Prefix: 'isl68222'
40
41    Addresses scanned: -
42
43    Datasheet:
44
45      Publicly available (after August 2020 launch) at the Renesas website
46
47  * Renesas ISL68223
48
49    Prefix: 'isl68223'
50
51    Addresses scanned: -
52
53    Datasheet:
54
55      Publicly available (after August 2020 launch) at the Renesas website
56
57  * Renesas ISL68224
58
59    Prefix: 'isl68224'
60
61    Addresses scanned: -
62
63    Datasheet:
64
65      Publicly available (after August 2020 launch) at the Renesas website
66
67  * Renesas ISL68225
68
69    Prefix: 'isl68225'
70
71    Addresses scanned: -
72
73    Datasheet:
74
75      Publicly available (after August 2020 launch) at the Renesas website
76
77  * Renesas ISL68226
78
79    Prefix: 'isl68226'
80
81    Addresses scanned: -
82
83    Datasheet:
84
85      Publicly available (after August 2020 launch) at the Renesas website
86
87  * Renesas ISL68227
88
89    Prefix: 'isl68227'
90
91    Addresses scanned: -
92
93    Datasheet:
94
95      Publicly available (after August 2020 launch) at the Renesas website
96
97  * Renesas ISL68229
98
99    Prefix: 'isl68229'
100
101    Addresses scanned: -
102
103    Datasheet:
104
105      Publicly available (after August 2020 launch) at the Renesas website
106
107  * Renesas ISL68233
108
109    Prefix: 'isl68233'
110
111    Addresses scanned: -
112
113    Datasheet:
114
115      Publicly available (after August 2020 launch) at the Renesas website
116
117  * Renesas ISL68239
118
119    Prefix: 'isl68239'
120
121    Addresses scanned: -
122
123    Datasheet:
124
125      Publicly available (after August 2020 launch) at the Renesas website
126
127  * Renesas ISL69222
128
129    Prefix: 'isl69222'
130
131    Addresses scanned: -
132
133    Datasheet:
134
135      Publicly available (after August 2020 launch) at the Renesas website
136
137  * Renesas ISL69223
138
139    Prefix: 'isl69223'
140
141    Addresses scanned: -
142
143    Datasheet:
144
145      Publicly available (after August 2020 launch) at the Renesas website
146
147  * Renesas ISL69224
148
149    Prefix: 'isl69224'
150
151    Addresses scanned: -
152
153    Datasheet:
154
155      Publicly available (after August 2020 launch) at the Renesas website
156
157  * Renesas ISL69225
158
159    Prefix: 'isl69225'
160
161    Addresses scanned: -
162
163    Datasheet:
164
165      Publicly available (after August 2020 launch) at the Renesas website
166
167  * Renesas ISL69227
168
169    Prefix: 'isl69227'
170
171    Addresses scanned: -
172
173    Datasheet:
174
175      Publicly available (after August 2020 launch) at the Renesas website
176
177  * Renesas ISL69228
178
179    Prefix: 'isl69228'
180
181    Addresses scanned: -
182
183    Datasheet:
184
185      Publicly available (after August 2020 launch) at the Renesas website
186
187  * Renesas ISL69234
188
189    Prefix: 'isl69234'
190
191    Addresses scanned: -
192
193    Datasheet:
194
195      Publicly available (after August 2020 launch) at the Renesas website
196
197  * Renesas ISL69236
198
199    Prefix: 'isl69236'
200
201    Addresses scanned: -
202
203    Datasheet:
204
205      Publicly available (after August 2020 launch) at the Renesas website
206
207  * Renesas ISL69239
208
209    Prefix: 'isl69239'
210
211    Addresses scanned: -
212
213    Datasheet:
214
215      Publicly available (after August 2020 launch) at the Renesas website
216
217  * Renesas ISL69242
218
219    Prefix: 'isl69242'
220
221    Addresses scanned: -
222
223    Datasheet:
224
225      Publicly available (after August 2020 launch) at the Renesas website
226
227  * Renesas ISL69243
228
229    Prefix: 'isl69243'
230
231    Addresses scanned: -
232
233    Datasheet:
234
235      Publicly available (after August 2020 launch) at the Renesas website
236
237  * Renesas ISL69247
238
239    Prefix: 'isl69247'
240
241    Addresses scanned: -
242
243    Datasheet:
244
245      Publicly available (after August 2020 launch) at the Renesas website
246
247  * Renesas ISL69248
248
249    Prefix: 'isl69248'
250
251    Addresses scanned: -
252
253    Datasheet:
254
255      Publicly available (after August 2020 launch) at the Renesas website
256
257  * Renesas ISL69254
258
259    Prefix: 'isl69254'
260
261    Addresses scanned: -
262
263    Datasheet:
264
265      Publicly available (after August 2020 launch) at the Renesas website
266
267  * Renesas ISL69255
268
269    Prefix: 'isl69255'
270
271    Addresses scanned: -
272
273    Datasheet:
274
275      Publicly available (after August 2020 launch) at the Renesas website
276
277  * Renesas ISL69256
278
279    Prefix: 'isl69256'
280
281    Addresses scanned: -
282
283    Datasheet:
284
285      Publicly available (after August 2020 launch) at the Renesas website
286
287  * Renesas ISL69259
288
289    Prefix: 'isl69259'
290
291    Addresses scanned: -
292
293    Datasheet:
294
295      Publicly available (after August 2020 launch) at the Renesas website
296
297  * Renesas ISL69260
298
299    Prefix: 'isl69260'
300
301    Addresses scanned: -
302
303    Datasheet:
304
305      Publicly available (after August 2020 launch) at the Renesas website
306
307  * Renesas ISL69268
308
309    Prefix: 'isl69268'
310
311    Addresses scanned: -
312
313    Datasheet:
314
315      Publicly available (after August 2020 launch) at the Renesas website
316
317  * Renesas ISL69269
318
319    Prefix: 'isl69269'
320
321    Addresses scanned: -
322
323    Datasheet:
324
325      Publicly available (after August 2020 launch) at the Renesas website
326
327  * Renesas ISL69298
328
329    Prefix: 'isl69298'
330
331    Addresses scanned: -
332
333    Datasheet:
334
335      Publicly available (after August 2020 launch) at the Renesas website
336
337  * Renesas RAA228000
338
339    Prefix: 'raa228000'
340
341    Addresses scanned: -
342
343    Datasheet:
344
345      Publicly available (after August 2020 launch) at the Renesas website
346
347  * Renesas RAA228004
348
349    Prefix: 'raa228004'
350
351    Addresses scanned: -
352
353    Datasheet:
354
355      Publicly available (after August 2020 launch) at the Renesas website
356
357  * Renesas RAA228006
358
359    Prefix: 'raa228006'
360
361    Addresses scanned: -
362
363    Datasheet:
364
365      Publicly available (after August 2020 launch) at the Renesas website
366
367  * Renesas RAA228228
368
369    Prefix: 'raa228228'
370
371    Addresses scanned: -
372
373    Datasheet:
374
375      Publicly available (after August 2020 launch) at the Renesas website
376
377  * Renesas RAA229001
378
379    Prefix: 'raa229001'
380
381    Addresses scanned: -
382
383    Datasheet:
384
385      Publicly available (after August 2020 launch) at the Renesas website
386
387  * Renesas RAA229004
388
389    Prefix: 'raa229004'
390
391    Addresses scanned: -
392
393    Datasheet:
394
395      Publicly available (after August 2020 launch) at the Renesas website
396
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
403Description
404-----------
405
406This driver supports the Renesas ISL68137 and all 2nd generation Renesas
407digital multiphase voltage regulators (raa_dmpvr2). The ISL68137 is a digital
408output 7-phase configurable PWM controller with an AVSBus interface. 2nd
409generation devices are grouped into 4 distinct configurations: '1rail' for
410single-rail devices, '2rail' for dual-rail devices, '3rail' for 3-rail devices,
411and 'hv' for high voltage single-rail devices. Consult the individual datasheets
412for more information.
413
414Usage Notes
415-----------
416
417This driver does not probe for PMBus devices. You will have to instantiate
418devices 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 attribute
423for the ISL68137.
424
425For 2nd generation Renesas digital multiphase voltage regulators, only the
426normal sysfs pmbus attributes are supported.
427
428ISL68137 sysfs attributes
429-------------------------
430
431======================= ====================================
432avs(0|1)_enable		Controls the AVS state of each rail.
433
434curr1_label		"iin"
435curr1_input		Measured input current
436curr1_crit		Critical maximum current
437curr1_crit_alarm	Current critical high alarm
438
439curr[2-3]_label		"iout[1-2]"
440curr[2-3]_input		Measured output current
441curr[2-3]_crit		Critical maximum current
442curr[2-3]_crit_alarm	Current critical high alarm
443
444in1_label		"vin"
445in1_input		Measured input voltage
446in1_lcrit		Critical minimum input voltage
447in1_lcrit_alarm		Input voltage critical low alarm
448in1_crit		Critical maximum input voltage
449in1_crit_alarm		Input voltage critical high alarm
450
451in[2-3]_label		"vout[1-2]"
452in[2-3]_input		Measured output voltage
453in[2-3]_lcrit		Critical minimum output voltage
454in[2-3]_lcrit_alarm	Output voltage critical low alarm
455in[2-3]_crit		Critical maximum output voltage
456in[2-3]_crit_alarm	Output voltage critical high alarm
457
458power1_label		"pin"
459power1_input		Measured input power
460power1_alarm		Input power high alarm
461
462power[2-3]_label	"pout[1-2]"
463power[2-3]_input	Measured output power
464
465temp[1-3]_input		Measured temperature
466temp[1-3]_crit		Critical high temperature
467temp[1-3]_crit_alarm	Chip temperature critical high alarm
468temp[1-3]_max		Maximum temperature
469temp[1-3]_max_alarm	Chip temperature high alarm
470======================= ====================================
471
472raa_dmpvr2_1rail/hv sysfs attributes
473------------------------------------
474
475======================= ==========================================
476curr1_label		"iin"
477curr1_input		Measured input current
478curr1_crit		Critical maximum current
479curr1_crit_alarm	Current critical high alarm
480
481curr2_label		"iout"
482curr2_input		Measured output current
483curr2_crit		Critical maximum current
484curr2_crit_alarm	Current critical high alarm
485
486in1_label		"vin"
487in1_input		Measured input voltage
488in1_lcrit		Critical minimum input voltage
489in1_lcrit_alarm		Input voltage critical low alarm
490in1_crit		Critical maximum input voltage
491in1_crit_alarm		Input voltage critical high alarm
492
493in2_label		"vmon"
494in2_input		Scaled VMON voltage read from the VMON pin
495
496in3_label		"vout"
497in3_input		Measured output voltage
498in3_lcrit		Critical minimum output voltage
499in3_lcrit_alarm         Output voltage critical low alarm
500in3_crit		Critical maximum output voltage
501in3_crit_alarm          Output voltage critical high alarm
502
503power1_label		"pin"
504power1_input		Measured input power
505power1_alarm		Input power high alarm
506
507power2_label	        "pout"
508power2_input	        Measured output power
509
510temp[1-3]_input		Measured temperature
511temp[1-3]_crit		Critical high temperature
512temp[1-3]_crit_alarm	Chip temperature critical high alarm
513temp[1-3]_max		Maximum temperature
514temp[1-3]_max_alarm	Chip temperature high alarm
515======================= ==========================================
516
517raa_dmpvr2_2rail sysfs attributes
518---------------------------------
519
520======================= ==========================================
521curr[1-2]_label		"iin[1-2]"
522curr[1-2]_input		Measured input current
523curr[1-2]_crit		Critical maximum current
524curr[1-2]_crit_alarm	Current critical high alarm
525
526curr[3-4]_label		"iout[1-2]"
527curr[3-4]_input		Measured output current
528curr[3-4]_crit		Critical maximum current
529curr[3-4]_crit_alarm	Current critical high alarm
530
531in1_label		"vin"
532in1_input		Measured input voltage
533in1_lcrit		Critical minimum input voltage
534in1_lcrit_alarm		Input voltage critical low alarm
535in1_crit		Critical maximum input voltage
536in1_crit_alarm		Input voltage critical high alarm
537
538in2_label		"vmon"
539in2_input		Scaled VMON voltage read from the VMON pin
540
541in[3-4]_label		"vout[1-2]"
542in[3-4]_input		Measured output voltage
543in[3-4]_lcrit		Critical minimum output voltage
544in[3-4]_lcrit_alarm	Output voltage critical low alarm
545in[3-4]_crit		Critical maximum output voltage
546in[3-4]_crit_alarm	Output voltage critical high alarm
547
548power[1-2]_label	"pin[1-2]"
549power[1-2]_input	Measured input power
550power[1-2]_alarm	Input power high alarm
551
552power[3-4]_label	"pout[1-2]"
553power[3-4]_input	Measured output power
554
555temp[1-5]_input		Measured temperature
556temp[1-5]_crit		Critical high temperature
557temp[1-5]_crit_alarm	Chip temperature critical high alarm
558temp[1-5]_max		Maximum temperature
559temp[1-5]_max_alarm	Chip temperature high alarm
560======================= ==========================================
561
562raa_dmpvr2_3rail sysfs attributes
563---------------------------------
564
565======================= ==========================================
566curr[1-3]_label		"iin[1-3]"
567curr[1-3]_input		Measured input current
568curr[1-3]_crit		Critical maximum current
569curr[1-3]_crit_alarm	Current critical high alarm
570
571curr[4-6]_label		"iout[1-3]"
572curr[4-6]_input		Measured output current
573curr[4-6]_crit		Critical maximum current
574curr[4-6]_crit_alarm	Current critical high alarm
575
576in1_label		"vin"
577in1_input		Measured input voltage
578in1_lcrit		Critical minimum input voltage
579in1_lcrit_alarm		Input voltage critical low alarm
580in1_crit		Critical maximum input voltage
581in1_crit_alarm		Input voltage critical high alarm
582
583in2_label		"vmon"
584in2_input		Scaled VMON voltage read from the VMON pin
585
586in[3-5]_label		"vout[1-3]"
587in[3-5]_input		Measured output voltage
588in[3-5]_lcrit		Critical minimum output voltage
589in[3-5]_lcrit_alarm	Output voltage critical low alarm
590in[3-5]_crit		Critical maximum output voltage
591in[3-5]_crit_alarm	Output voltage critical high alarm
592
593power[1-3]_label	"pin[1-3]"
594power[1-3]_input	Measured input power
595power[1-3]_alarm	Input power high alarm
596
597power[4-6]_label	"pout[1-3]"
598power[4-6]_input	Measured output power
599
600temp[1-7]_input		Measured temperature
601temp[1-7]_crit		Critical high temperature
602temp[1-7]_crit_alarm	Chip temperature critical high alarm
603temp[1-7]_max		Maximum temperature
604temp[1-7]_max_alarm	Chip temperature high alarm
605======================= ==========================================
606