summaryrefslogtreecommitdiff
path: root/Documentation/hwmon/ltc2978.rst
blob: edf24e5e1e118cad15264e391f7928b85f7914ce (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
Kernel driver ltc2978
=====================

Supported chips:

  * Linear Technology LTC2972

    Prefix: 'ltc2972'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc2972.html

  * Linear Technology LTC2974

    Prefix: 'ltc2974'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc2974

  * Linear Technology LTC2975

    Prefix: 'ltc2975'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc2975

  * Linear Technology LTC2977

    Prefix: 'ltc2977'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc2977

  * Linear Technology LTC2978, LTC2978A

    Prefix: 'ltc2978'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc2978

	       https://www.analog.com/en/products/ltc2978a

  * Linear Technology LTC2979

    Prefix: 'ltc2979'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc2979

  * Linear Technology LTC2980

    Prefix: 'ltc2980'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc2980

  * Linear Technology LTC3880

    Prefix: 'ltc3880'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc3880

  * Linear Technology LTC3882

    Prefix: 'ltc3882'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc3882

  * Linear Technology LTC3883

    Prefix: 'ltc3883'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc3883

  * Linear Technology LTC3884

    Prefix: 'ltc3884'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc3884

  * Linear Technology LTC3886

    Prefix: 'ltc3886'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc3886

  * Linear Technology LTC3887

    Prefix: 'ltc3887'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc3887

  * Linear Technology LTC3889

    Prefix: 'ltc3889'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc3889

  * Linear Technology LTC7880

    Prefix: 'ltc7880'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc7880

  * Linear Technology LTM2987

    Prefix: 'ltm2987'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltm2987

  * Linear Technology LTM4644

    Prefix: 'ltm4644'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltm4644

   * Linear Technology LTM4675

    Prefix: 'ltm4675'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltm4675

  * Linear Technology LTM4676

    Prefix: 'ltm4676'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltm4676

  * Linear Technology LTM4677

    Prefix: 'ltm4677'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltm4677

  * Linear Technology LTM4678

    Prefix: 'ltm4678'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltm4678

  * Analog Devices LTM4680

    Prefix: 'ltm4680'

    Addresses scanned: -

    Datasheet: https://www.analog.com/ltm4680

  * Analog Devices LTM4686

    Prefix: 'ltm4686'

    Addresses scanned: -

    Datasheet: https://www.analog.com/ltm4686

  * Analog Devices LTM4700

    Prefix: 'ltm4700'

    Addresses scanned: -

    Datasheet: https://www.analog.com/ltm4700



Author: Guenter Roeck <linux@roeck-us.net>


Description
-----------

- LTC2974 and LTC2975 are quad digital power supply managers.
- LTC2978 is an octal power supply monitor.
- LTC2977 is a pin compatible replacement for LTC2978.
- LTC2980 is a 16-channel Power System Manager, consisting of two LTC2977
- in a single die. The chip is instantiated and reported as two separate chips
- on two different I2C bus addresses.
- LTC3880, LTC3882, LTC3886, and LTC3887 are dual output poly-phase step-down
- DC/DC controllers.
- LTC3883 is a single phase step-down DC/DC controller.
- LTM2987 is a 16-channel Power System Manager with two LTC2977 plus
- additional components on a single die. The chip is instantiated and reported
- as two separate chips on two different I2C bus addresses.
- LTM4675 is a dual 9A or single 18A μModule regulator
- LTM4676 is a dual 13A or single 26A uModule regulator.
- LTM4686 is a dual 10A or single 20A uModule regulator.


Usage Notes
-----------

This driver does not probe for PMBus devices. You will have to instantiate
devices explicitly.

Example: the following commands will load the driver for an LTC2978 at address
0x60 on I2C bus #1::

	# modprobe ltc2978
	# echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device


Sysfs attributes
----------------

======================= ========================================================
in1_label		"vin"

in1_input		Measured input voltage.

in1_min			Minimum input voltage.

in1_max			Maximum input voltage.

			LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
			LTC2979 and LTM2987 only.

in1_lcrit		Critical minimum input voltage.

			LTC2972, LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
			LTC2979 and LTM2987 only.

in1_crit		Critical maximum input voltage.

in1_min_alarm		Input voltage low alarm.

in1_max_alarm		Input voltage high alarm.

			LTC2972, LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
			LTC2979 and LTM2987 only.

in1_lcrit_alarm		Input voltage critical low alarm.

			LTC2972, LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
			LTC2979 and LTM2987 only.

in1_crit_alarm		Input voltage critical high alarm.

in1_lowest		Lowest input voltage.

			LTC2972, LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
			and LTM2987 only.

in1_highest		Highest input voltage.

in1_reset_history	Reset input voltage history.

in[N]_label		"vout[1-8]".

			- LTC2972: N=2-3
			- LTC2974, LTC2975: N=2-5
			- LTC2977, LTC2979, LTC2980, LTM2987: N=2-9
			- LTC2978: N=2-9
			- LTC3880, LTC3882, LTC3884, LTC23886 LTC3887, LTC3889,
			  LTC7880, LTM4644, LTM4675, LTM4676, LTM4677, LTM4678,
			  LTM4680, LTM4700: N=2-3
			- LTC3883: N=2

in[N]_input		Measured output voltage.

in[N]_min		Minimum output voltage.

in[N]_max		Maximum output voltage.

in[N]_lcrit		Critical minimum output voltage.

in[N]_crit		Critical maximum output voltage.

in[N]_min_alarm		Output voltage low alarm.

in[N]_max_alarm		Output voltage high alarm.

in[N]_lcrit_alarm	Output voltage critical low alarm.

in[N]_crit_alarm	Output voltage critical high alarm.

in[N]_lowest		Lowest output voltage.

			LTC2972, LTC2974, LTC2975,and LTC2978 only.

in[N]_highest		Highest output voltage.

in[N]_reset_history	Reset output voltage history.

temp[N]_input		Measured temperature.

			- On LTC2972, temp[1-2] report external temperatures,
			  and temp 3 reports the chip temperature.
			- On LTC2974 and LTC2975, temp[1-4] report external
			  temperatures, and temp5 reports the chip temperature.
			- On LTC2977, LTC2979, LTC2980, LTC2978, and LTM2987,
			  only one temperature measurement is supported and
			  reports the chip temperature.
			- On LTC3880, LTC3882, LTC3886, LTC3887, LTC3889,
			  LTM4664, LTM4675, LTM4676, LTM4677, LTM4678, LTM4680,
			  and LTM4700, temp1 and temp2 report external
			  temperatures, and temp3 reports the chip temperature.
			- On LTC3883, temp1 reports an external temperature,
			  and temp2 reports the chip temperature.

temp[N]_min		Minimum temperature.

			LTC2972, LTC2974, LCT2977, LTM2980, LTC2978,
			LTC2979, and LTM2987 only.

temp[N]_max		Maximum temperature.

temp[N]_lcrit		Critical low temperature.

temp[N]_crit		Critical high temperature.

temp[N]_min_alarm	Temperature low alarm.

			LTC2972, LTC2974, LTC2975, LTC2977, LTM2980, LTC2978,
			LTC2979, and LTM2987 only.

temp[N]_max_alarm	Temperature high alarm.


temp[N]_lcrit_alarm	Temperature critical low alarm.

temp[N]_crit_alarm	Temperature critical high alarm.

temp[N]_lowest		Lowest measured temperature.

			- LTC2972, LTC2974, LTC2975, LTC2977, LTM2980, LTC2978,
			  LTC2979, and LTM2987 only.
			- Not supported for chip temperature sensor on LTC2974
			  and LTC2975.

temp[N]_highest		Highest measured temperature.

			Not supported for chip temperature sensor on
			LTC2974 and LTC2975.

temp[N]_reset_history	Reset temperature history.

			Not supported for chip temperature sensor on
			LTC2974 and LTC2975.

power1_label		"pin". LTC3883 and LTC3886 only.

power1_input		Measured input power.

power[N]_label		"pout[1-4]".

			- LTC2972: N=1-2
			- LTC2974, LTC2975: N=1-4
			- LTC2977, LTC2979, LTC2980, LTM2987: Not supported
			- LTC2978: Not supported
			- LTC3880, LTC3882, LTC3884, LTC3886, LTC3887, LTC3889,
			  LTM4664, LTM4675, LTM4676, LTM4677, LTM4678, LTM4680,
			  LTM4700: N=1-2
			- LTC3883: N=2

power[N]_input		Measured output power.

curr1_label		"iin".

			LTC3880, LTC3883, LTC3884, LTC3886, LTC3887, LTC3889,
			LTM4644, LTM4675, LTM4676, LTM4677, LTM4678, LTM4680,
			and LTM4700 only.

curr1_input		Measured input current.

curr1_max		Maximum input current.

curr1_max_alarm		Input current high alarm.

curr1_highest		Highest input current.

			LTC3883 and LTC3886 only.

curr1_reset_history	Reset input current history.

			LTC3883 and LTC3886 only.

curr[N]_label		"iout[1-4]".

			- LTC2972: N-1-2
			- LTC2974, LTC2975: N=1-4
			- LTC2977, LTC2979, LTC2980, LTM2987: not supported
			- LTC2978: not supported
			- LTC3880, LTC3882, LTC3884, LTC3886, LTC3887, LTC3889,
			  LTM4664, LTM4675, LTM4676, LTM4677, LTM4678, LTM4680,
			  LTM4700: N=2-3
			- LTC3883: N=2

curr[N]_input		Measured output current.

curr[N]_max		Maximum output current.

curr[N]_crit		Critical high output current.

curr[N]_lcrit		Critical low output current.

			LTC2972, LTC2974 and LTC2975 only.

curr[N]_max_alarm	Output current high alarm.

curr[N]_crit_alarm	Output current critical high alarm.

curr[N]_lcrit_alarm	Output current critical low alarm.

			LTC2972, LTC2974 and LTC2975 only.

curr[N]_lowest		Lowest output current.

			LTC2972, LTC2974 and LTC2975 only.

curr[N]_highest		Highest output current.

curr[N]_reset_history	Reset output current history.
======================= ========================================================