1.. SPDX-License-Identifier: GPL-2.0
2
3Kernel driver ltc2978
4=====================
5
6Supported chips:
7
8  * Analog Devices LT7170
9
10    Prefix: 'lt7170'
11
12    Addresses scanned: -
13
14    Datasheet: https://www.analog.com/en/products/lt7170.html
15
16  * Analog Devices LT7171
17
18    Prefix: 'lt7171'
19
20    Addresses scanned: -
21
22    Datasheet: https://www.analog.com/en/products/lt7171.html
23
24  * Linear Technology LTC2972
25
26    Prefix: 'ltc2972'
27
28    Addresses scanned: -
29
30    Datasheet: https://www.analog.com/en/products/ltc2972.html
31
32  * Linear Technology LTC2974
33
34    Prefix: 'ltc2974'
35
36    Addresses scanned: -
37
38    Datasheet: https://www.analog.com/en/products/ltc2974
39
40  * Linear Technology LTC2975
41
42    Prefix: 'ltc2975'
43
44    Addresses scanned: -
45
46    Datasheet: https://www.analog.com/en/products/ltc2975
47
48  * Linear Technology LTC2977
49
50    Prefix: 'ltc2977'
51
52    Addresses scanned: -
53
54    Datasheet: https://www.analog.com/en/products/ltc2977
55
56  * Linear Technology LTC2978, LTC2978A
57
58    Prefix: 'ltc2978'
59
60    Addresses scanned: -
61
62    Datasheet: https://www.analog.com/en/products/ltc2978
63
64	       https://www.analog.com/en/products/ltc2978a
65
66  * Linear Technology LTC2979
67
68    Prefix: 'ltc2979'
69
70    Addresses scanned: -
71
72    Datasheet: https://www.analog.com/en/products/ltc2979
73
74  * Linear Technology LTC2980
75
76    Prefix: 'ltc2980'
77
78    Addresses scanned: -
79
80    Datasheet: https://www.analog.com/en/products/ltc2980
81
82  * Linear Technology LTC3880
83
84    Prefix: 'ltc3880'
85
86    Addresses scanned: -
87
88    Datasheet: https://www.analog.com/en/products/ltc3880
89
90  * Linear Technology LTC3882
91
92    Prefix: 'ltc3882'
93
94    Addresses scanned: -
95
96    Datasheet: https://www.analog.com/en/products/ltc3882
97
98  * Linear Technology LTC3883
99
100    Prefix: 'ltc3883'
101
102    Addresses scanned: -
103
104    Datasheet: https://www.analog.com/en/products/ltc3883
105
106  * Linear Technology LTC3884
107
108    Prefix: 'ltc3884'
109
110    Addresses scanned: -
111
112    Datasheet: https://www.analog.com/en/products/ltc3884
113
114  * Linear Technology LTC3886
115
116    Prefix: 'ltc3886'
117
118    Addresses scanned: -
119
120    Datasheet: https://www.analog.com/en/products/ltc3886
121
122  * Linear Technology LTC3887
123
124    Prefix: 'ltc3887'
125
126    Addresses scanned: -
127
128    Datasheet: https://www.analog.com/en/products/ltc3887
129
130  * Linear Technology LTC3889
131
132    Prefix: 'ltc3889'
133
134    Addresses scanned: -
135
136    Datasheet: https://www.analog.com/en/products/ltc3889
137
138  * Linear Technology LTC7841
139
140    Prefix: 'ltc7841'
141
142    Addresses scanned: -
143
144    Datasheet: https://www.analog.com/en/products/ltc7841
145
146  * Linear Technology LTC7880
147
148    Prefix: 'ltc7880'
149
150    Addresses scanned: -
151
152    Datasheet: https://www.analog.com/en/products/ltc7880
153
154  * Linear Technology LTM2987
155
156    Prefix: 'ltm2987'
157
158    Addresses scanned: -
159
160    Datasheet: https://www.analog.com/en/products/ltm2987
161
162  * Linear Technology LTM4644
163
164    Prefix: 'ltm4644'
165
166    Addresses scanned: -
167
168    Datasheet: https://www.analog.com/en/products/ltm4644
169
170   * Linear Technology LTM4673
171
172    Prefix: 'ltm4673'
173
174    Addresses scanned: -
175
176    Datasheet: https://www.analog.com/en/products/ltm4673
177
178   * Linear Technology LTM4675
179
180    Prefix: 'ltm4675'
181
182    Addresses scanned: -
183
184    Datasheet: https://www.analog.com/en/products/ltm4675
185
186  * Linear Technology LTM4676
187
188    Prefix: 'ltm4676'
189
190    Addresses scanned: -
191
192    Datasheet: https://www.analog.com/en/products/ltm4676
193
194  * Linear Technology LTM4677
195
196    Prefix: 'ltm4677'
197
198    Addresses scanned: -
199
200    Datasheet: https://www.analog.com/en/products/ltm4677
201
202  * Linear Technology LTM4678
203
204    Prefix: 'ltm4678'
205
206    Addresses scanned: -
207
208    Datasheet: https://www.analog.com/en/products/ltm4678
209
210  * Analog Devices LTM4680
211
212    Prefix: 'ltm4680'
213
214    Addresses scanned: -
215
216    Datasheet: https://www.analog.com/ltm4680
217
218  * Analog Devices LTM4686
219
220    Prefix: 'ltm4686'
221
222    Addresses scanned: -
223
224    Datasheet: https://www.analog.com/ltm4686
225
226  * Analog Devices LTM4700
227
228    Prefix: 'ltm4700'
229
230    Addresses scanned: -
231
232    Datasheet: https://www.analog.com/ltm4700
233
234
235
236Author: Guenter Roeck <linux@roeck-us.net>
237
238
239Description
240-----------
241
242- LT7170 and LT7171 are 20 A, 16 V, single- or dual-phase Silent Switcher
243- step-down regulators with Digital Power System Management.
244- LTC2974 and LTC2975 are quad digital power supply managers.
245- LTC2978 is an octal power supply monitor.
246- LTC2977 is a pin compatible replacement for LTC2978.
247- LTC2980 is a 16-channel Power System Manager, consisting of two LTC2977
248- in a single die. The chip is instantiated and reported as two separate chips
249- on two different I2C bus addresses.
250- LTC3880, LTC3882, LTC3886, and LTC3887 are dual output poly-phase step-down
251- DC/DC controllers.
252- LTC3883 is a single phase step-down DC/DC controller.
253- LTM2987 is a 16-channel Power System Manager with two LTC2977 plus
254- additional components on a single die. The chip is instantiated and reported
255- as two separate chips on two different I2C bus addresses.
256- LTM4675 is a dual 9A or single 18A μModule regulator
257- LTM4676 is a dual 13A or single 26A uModule regulator.
258- LTM4686 is a dual 10A or single 20A uModule regulator.
259
260
261Usage Notes
262-----------
263
264This driver does not probe for PMBus devices. You will have to instantiate
265devices explicitly.
266
267Example: the following commands will load the driver for an LTC2978 at address
2680x60 on I2C bus #1::
269
270	# modprobe ltc2978
271	# echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
272
273
274Sysfs attributes
275----------------
276
277======================= ========================================================
278in1_label		"vin"
279
280in1_input		Measured input voltage.
281
282in1_min			Minimum input voltage.
283
284in1_max			Maximum input voltage.
285
286			LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
287			LTC2979 and LTM2987 only.
288
289in1_lcrit		Critical minimum input voltage.
290
291			LTC2972, LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
292			LTC2979 and LTM2987 only.
293
294in1_crit		Critical maximum input voltage.
295
296in1_min_alarm		Input voltage low alarm.
297
298in1_max_alarm		Input voltage high alarm.
299
300			LTC2972, LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
301			LTC2979 and LTM2987 only.
302
303in1_lcrit_alarm		Input voltage critical low alarm.
304
305			LTC2972, LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
306			LTC2979 and LTM2987 only.
307
308in1_crit_alarm		Input voltage critical high alarm.
309
310in1_lowest		Lowest input voltage.
311
312			LTC2972, LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
313			and LTM2987 only.
314
315in1_highest		Highest input voltage.
316
317in1_reset_history	Reset input voltage history.
318
319in[N]_label		"vout[1-8]".
320
321			- LT7170, LT7171: N=2
322			- LTC2972: N=2-3
323			- LTC2974, LTC2975: N=2-5
324			- LTC2977, LTC2979, LTC2980, LTM2987: N=2-9
325			- LTC2978: N=2-9
326			- LTC3880, LTC3882, LTC3884, LTC23886 LTC3887, LTC3889,
327			  LTC7880, LTM4644, LTM4675, LTM4676, LTM4677, LTM4678,
328			  LTM4680, LTM4700: N=2-3
329			- LTC3883: N=2
330			- LTC7841: N=2
331
332in[N]_input		Measured output voltage.
333
334in[N]_min		Minimum output voltage.
335
336in[N]_max		Maximum output voltage.
337
338in[N]_lcrit		Critical minimum output voltage.
339
340in[N]_crit		Critical maximum output voltage.
341
342in[N]_min_alarm		Output voltage low alarm.
343
344in[N]_max_alarm		Output voltage high alarm.
345
346in[N]_lcrit_alarm	Output voltage critical low alarm.
347
348in[N]_crit_alarm	Output voltage critical high alarm.
349
350in[N]_lowest		Lowest output voltage.
351
352			LTC2972, LTC2974, LTC2975,and LTC2978 only.
353
354in[N]_highest		Highest output voltage.
355
356in[N]_reset_history	Reset output voltage history.
357
358temp[N]_input		Measured temperature.
359
360			- On LT7170 and LT7171, temp1 reports the chip
361			  temperature.
362			- On LTC2972, temp[1-2] report external temperatures,
363			  and temp 3 reports the chip temperature.
364			- On LTC2974 and LTC2975, temp[1-4] report external
365			  temperatures, and temp5 reports the chip temperature.
366			- On LTC2977, LTC2979, LTC2980, LTC2978, and LTM2987,
367			  only one temperature measurement is supported and
368			  reports the chip temperature.
369			- On LTC3880, LTC3882, LTC3886, LTC3887, LTC3889,
370			  LTM4664, LTM4675, LTM4676, LTM4677, LTM4678, LTM4680,
371			  and LTM4700, temp1 and temp2 report external
372			  temperatures, and temp3 reports the chip temperature.
373			- On LTC3883, temp1 reports an external temperature,
374			  and temp2 reports the chip temperature.
375
376temp[N]_min		Minimum temperature.
377
378			LTC2972, LTC2974, LCT2977, LTM2980, LTC2978,
379			LTC2979, and LTM2987 only.
380
381temp[N]_max		Maximum temperature.
382
383temp[N]_lcrit		Critical low temperature.
384
385temp[N]_crit		Critical high temperature.
386
387temp[N]_min_alarm	Temperature low alarm.
388
389			LTC2972, LTC2974, LTC2975, LTC2977, LTM2980, LTC2978,
390			LTC2979, and LTM2987 only.
391
392temp[N]_max_alarm	Temperature high alarm.
393
394
395temp[N]_lcrit_alarm	Temperature critical low alarm.
396
397temp[N]_crit_alarm	Temperature critical high alarm.
398
399temp[N]_lowest		Lowest measured temperature.
400
401			- LTC2972, LTC2974, LTC2975, LTC2977, LTM2980, LTC2978,
402			  LTC2979, and LTM2987 only.
403			- Not supported for chip temperature sensor on LTC2974
404			  and LTC2975.
405
406temp[N]_highest		Highest measured temperature.
407
408			Not supported for chip temperature sensor on
409			LTC2974 and LTC2975.
410
411temp[N]_reset_history	Reset temperature history.
412
413			Not supported for chip temperature sensor on
414			LTC2974 and LTC2975.
415
416power1_label		"pin". LTC3883 and LTC3886 only.
417
418power1_input		Measured input power.
419
420power[N]_label		"pout[1-4]".
421
422			- LTC2972: N=1-2
423			- LTC2974, LTC2975: N=1-4
424			- LTC2977, LTC2979, LTC2980, LTM2987: Not supported
425			- LTC2978: Not supported
426			- LTC3880, LTC3882, LTC3884, LTC3886, LTC3887, LTC3889,
427			  LTM4664, LTM4675, LTM4676, LTM4677, LTM4678, LTM4680,
428			  LTM4700: N=1-2
429			- LTC3883: N=2
430
431power[N]_input		Measured output power.
432
433curr1_label		"iin".
434
435			LT7170, LT7171, LTC3880, LTC3883, LTC3884, LTC3886,
436			LTC3887, LTC3889, LTM4644, LTM4675, LTM4676, LTM4677,
437			LTM4678, LTM4680, and LTM4700 only.
438
439curr1_input		Measured input current.
440
441curr1_max		Maximum input current.
442
443curr1_max_alarm		Input current high alarm.
444
445curr1_highest		Highest input current.
446
447			LTC3883 and LTC3886 only.
448
449curr1_reset_history	Reset input current history.
450
451			LTC3883 and LTC3886 only.
452
453curr[N]_label		"iout[1-4]".
454
455			- LT7170, LT7171: N=1
456			- LTC2972: N-1-2
457			- LTC2974, LTC2975: N=1-4
458			- LTC2977, LTC2979, LTC2980, LTM2987: not supported
459			- LTC2978: not supported
460			- LTC3880, LTC3882, LTC3884, LTC3886, LTC3887, LTC3889,
461			  LTM4664, LTM4675, LTM4676, LTM4677, LTM4678, LTM4680,
462			  LTM4700: N=2-3
463			- LTC3883: N=2
464			- LTC7841: N=2
465
466curr[N]_input		Measured output current.
467
468curr[N]_max		Maximum output current.
469
470curr[N]_crit		Critical high output current.
471
472curr[N]_lcrit		Critical low output current.
473
474			LTC2972, LTC2974 and LTC2975 only.
475
476curr[N]_max_alarm	Output current high alarm.
477
478curr[N]_crit_alarm	Output current critical high alarm.
479
480curr[N]_lcrit_alarm	Output current critical low alarm.
481
482			LTC2972, LTC2974 and LTC2975 only.
483
484curr[N]_lowest		Lowest output current.
485
486			LTC2972, LTC2974 and LTC2975 only.
487
488curr[N]_highest		Highest output current.
489
490curr[N]_reset_history	Reset output current history.
491======================= ========================================================
492