drm/amdkfd: fix the build when CIK support is disabled
[linux-2.6-block.git] / Documentation / hwmon / ltc2978.rst
CommitLineData
c3ff9a67
GR
1Kernel driver ltc2978
2=====================
3
4Supported chips:
1f234ff1 5
fd9175d2 6 * Linear Technology LTC2974
1f234ff1 7
fd9175d2 8 Prefix: 'ltc2974'
1f234ff1 9
fd9175d2 10 Addresses scanned: -
1f234ff1 11
fd9175d2 12 Datasheet: http://www.linear.com/product/ltc2974
1f234ff1 13
649ca820 14 * Linear Technology LTC2975
1f234ff1 15
649ca820 16 Prefix: 'ltc2975'
1f234ff1 17
649ca820 18 Addresses scanned: -
1f234ff1 19
649ca820 20 Datasheet: http://www.linear.com/product/ltc2975
1f234ff1 21
c24c407e 22 * Linear Technology LTC2977
1f234ff1 23
c24c407e 24 Prefix: 'ltc2977'
1f234ff1 25
c24c407e 26 Addresses scanned: -
1f234ff1 27
c24c407e 28 Datasheet: http://www.linear.com/product/ltc2977
1f234ff1 29
3f08d7f4 30 * Linear Technology LTC2978, LTC2978A
1f234ff1 31
c3ff9a67 32 Prefix: 'ltc2978'
1f234ff1 33
c3ff9a67 34 Addresses scanned: -
1f234ff1 35
6d21a416 36 Datasheet: http://www.linear.com/product/ltc2978
1f234ff1
MCC
37
38 http://www.linear.com/product/ltc2978a
39
52aae6af 40 * Linear Technology LTC2980
1f234ff1 41
52aae6af 42 Prefix: 'ltc2980'
1f234ff1 43
52aae6af 44 Addresses scanned: -
1f234ff1 45
52aae6af 46 Datasheet: http://www.linear.com/product/ltc2980
1f234ff1 47
ddfb41ca 48 * Linear Technology LTC3880
1f234ff1 49
ddfb41ca 50 Prefix: 'ltc3880'
1f234ff1 51
ddfb41ca 52 Addresses scanned: -
1f234ff1 53
6d21a416 54 Datasheet: http://www.linear.com/product/ltc3880
1f234ff1 55
bf89386f 56 * Linear Technology LTC3882
1f234ff1 57
bf89386f 58 Prefix: 'ltc3882'
1f234ff1 59
bf89386f 60 Addresses scanned: -
1f234ff1 61
bf89386f 62 Datasheet: http://www.linear.com/product/ltc3882
1f234ff1 63
fd9175d2 64 * Linear Technology LTC3883
1f234ff1 65
fd9175d2 66 Prefix: 'ltc3883'
1f234ff1 67
fd9175d2 68 Addresses scanned: -
1f234ff1 69
fd9175d2 70 Datasheet: http://www.linear.com/product/ltc3883
1f234ff1 71
228b687d 72 * Linear Technology LTC3886
1f234ff1 73
228b687d 74 Prefix: 'ltc3886'
1f234ff1 75
228b687d 76 Addresses scanned: -
1f234ff1 77
228b687d 78 Datasheet: http://www.linear.com/product/ltc3886
1f234ff1 79
15398566 80 * Linear Technology LTC3887
1f234ff1 81
15398566 82 Prefix: 'ltc3887'
1f234ff1 83
15398566 84 Addresses scanned: -
1f234ff1 85
15398566 86 Datasheet: http://www.linear.com/product/ltc3887
1f234ff1 87
52aae6af 88 * Linear Technology LTM2987
1f234ff1 89
52aae6af 90 Prefix: 'ltm2987'
1f234ff1 91
52aae6af 92 Addresses scanned: -
1f234ff1 93
52aae6af 94 Datasheet: http://www.linear.com/product/ltm2987
1f234ff1 95
ccf2dc51 96 * Linear Technology LTM4675
1f234ff1 97
ccf2dc51 98 Prefix: 'ltm4675'
1f234ff1 99
ccf2dc51 100 Addresses scanned: -
1f234ff1 101
ccf2dc51 102 Datasheet: http://www.linear.com/product/ltm4675
1f234ff1 103
f76992b0 104 * Linear Technology LTM4676
1f234ff1 105
f76992b0 106 Prefix: 'ltm4676'
1f234ff1 107
f76992b0 108 Addresses scanned: -
1f234ff1 109
f76992b0 110 Datasheet: http://www.linear.com/product/ltm4676
1f234ff1 111
4e15d05d 112 * Analog Devices LTM4686
1f234ff1 113
4e15d05d 114 Prefix: 'ltm4686'
1f234ff1 115
4e15d05d 116 Addresses scanned: -
1f234ff1 117
4e15d05d 118 Datasheet: http://www.analog.com/ltm4686
c3ff9a67 119
1f234ff1 120
e3333e57 121Author: Guenter Roeck <linux@roeck-us.net>
c3ff9a67
GR
122
123
124Description
125-----------
126
1f234ff1
MCC
127- LTC2974 and LTC2975 are quad digital power supply managers.
128- LTC2978 is an octal power supply monitor.
129- LTC2977 is a pin compatible replacement for LTC2978.
130- LTC2980 is a 16-channel Power System Manager, consisting of two LTC2977
131- in a single die. The chip is instantiated and reported as two separate chips
132- on two different I2C bus addresses.
133- LTC3880, LTC3882, LTC3886, and LTC3887 are dual output poly-phase step-down
134- DC/DC controllers.
135- LTC3883 is a single phase step-down DC/DC controller.
136- LTM2987 is a 16-channel Power System Manager with two LTC2977 plus
137- additional components on a single die. The chip is instantiated and reported
138- as two separate chips on two different I2C bus addresses.
139- LTM4675 is a dual 9A or single 18A μModule regulator
140- LTM4676 is a dual 13A or single 26A uModule regulator.
141- LTM4686 is a dual 10A or single 20A uModule regulator.
c3ff9a67
GR
142
143
144Usage Notes
145-----------
146
147This driver does not probe for PMBus devices. You will have to instantiate
148devices explicitly.
149
150Example: the following commands will load the driver for an LTC2978 at address
1f234ff1 1510x60 on I2C bus #1::
c3ff9a67 152
1f234ff1
MCC
153 # modprobe ltc2978
154 # echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
c3ff9a67
GR
155
156
157Sysfs attributes
158----------------
159
1f234ff1 160======================= ========================================================
c3ff9a67 161in1_label "vin"
1f234ff1 162
c3ff9a67 163in1_input Measured input voltage.
1f234ff1 164
c3ff9a67 165in1_min Minimum input voltage.
1f234ff1 166
c24c407e 167in1_max Maximum input voltage.
1f234ff1 168
52aae6af
GR
169 LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
170 LTM2987 only.
1f234ff1 171
c24c407e 172in1_lcrit Critical minimum input voltage.
1f234ff1 173
52aae6af
GR
174 LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
175 LTM2987 only.
1f234ff1 176
c3ff9a67 177in1_crit Critical maximum input voltage.
1f234ff1 178
c3ff9a67 179in1_min_alarm Input voltage low alarm.
1f234ff1 180
c24c407e 181in1_max_alarm Input voltage high alarm.
1f234ff1 182
52aae6af
GR
183 LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
184 LTM2987 only.
c24c407e 185in1_lcrit_alarm Input voltage critical low alarm.
1f234ff1 186
52aae6af
GR
187 LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
188 LTM2987 only.
c3ff9a67 189in1_crit_alarm Input voltage critical high alarm.
1f234ff1 190
c24c407e 191in1_lowest Lowest input voltage.
1f234ff1 192
52aae6af
GR
193 LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
194 LTM2987 only.
c3ff9a67 195in1_highest Highest input voltage.
1f234ff1 196
8c770f3a 197in1_reset_history Reset input voltage history.
c3ff9a67 198
fd9175d2 199in[N]_label "vout[1-8]".
1f234ff1
MCC
200
201 - LTC2974, LTC2975: N=2-5
202 - LTC2977, LTC2980, LTM2987: N=2-9
203 - LTC2978: N=2-9
204 - LTC3880, LTC3882, LTC23886 LTC3887, LTM4675, LTM4676:
205 N=2-3
206 - LTC3883: N=2
207
fd9175d2 208in[N]_input Measured output voltage.
1f234ff1 209
fd9175d2 210in[N]_min Minimum output voltage.
1f234ff1 211
fd9175d2 212in[N]_max Maximum output voltage.
1f234ff1 213
fd9175d2 214in[N]_lcrit Critical minimum output voltage.
1f234ff1 215
fd9175d2 216in[N]_crit Critical maximum output voltage.
1f234ff1 217
fd9175d2 218in[N]_min_alarm Output voltage low alarm.
1f234ff1 219
fd9175d2 220in[N]_max_alarm Output voltage high alarm.
1f234ff1 221
fd9175d2 222in[N]_lcrit_alarm Output voltage critical low alarm.
1f234ff1 223
fd9175d2 224in[N]_crit_alarm Output voltage critical high alarm.
1f234ff1
MCC
225
226in[N]_lowest Lowest output voltage.
227
228
229 LTC2974, LTC2975,and LTC2978 only.
230
fd9175d2 231in[N]_highest Highest output voltage.
1f234ff1 232
fd9175d2
GR
233in[N]_reset_history Reset output voltage history.
234
235temp[N]_input Measured temperature.
1f234ff1
MCC
236
237 - On LTC2974 and LTC2975, temp[1-4] report external
238 temperatures, and temp5 reports the chip temperature.
239 - On LTC2977, LTC2980, LTC2978, and LTM2987, only one
240 temperature measurement is supported and reports
241 the chip temperature.
242 - On LTC3880, LTC3882, LTC3887, LTM4675, and LTM4676,
243 temp1 and temp2 report external temperatures, and
244 temp3 reports the chip temperature.
245 - On LTC3883, temp1 reports an external temperature,
246 and temp2 reports the chip temperature.
247
248temp[N]_min Mimimum temperature.
249
250 LTC2974, LCT2977, LTM2980, LTC2978, and LTM2987 only.
251
fd9175d2 252temp[N]_max Maximum temperature.
1f234ff1 253
fd9175d2 254temp[N]_lcrit Critical low temperature.
1f234ff1 255
fd9175d2 256temp[N]_crit Critical high temperature.
1f234ff1 257
c24c407e 258temp[N]_min_alarm Temperature low alarm.
1f234ff1 259
52aae6af
GR
260 LTC2974, LTC2975, LTC2977, LTM2980, LTC2978, and
261 LTM2987 only.
1f234ff1 262
fd9175d2 263temp[N]_max_alarm Temperature high alarm.
1f234ff1
MCC
264
265
fd9175d2 266temp[N]_lcrit_alarm Temperature critical low alarm.
1f234ff1 267
fd9175d2 268temp[N]_crit_alarm Temperature critical high alarm.
1f234ff1 269
c24c407e 270temp[N]_lowest Lowest measured temperature.
1f234ff1
MCC
271
272 - LTC2974, LTC2975, LTC2977, LTM2980, LTC2978, and
273 LTM2987 only.
274 - Not supported for chip temperature sensor on LTC2974
275 and LTC2975.
276
277temp[N]_highest Highest measured temperature.
278
279 Not supported for chip temperature sensor on
280 LTC2974 and LTC2975.
281
282temp[N]_reset_history Reset temperature history.
283
284 Not supported for chip temperature sensor on
285 LTC2974 and LTC2975.
fd9175d2 286
228b687d 287power1_label "pin". LTC3883 and LTC3886 only.
1f234ff1 288
fd9175d2
GR
289power1_input Measured input power.
290
291power[N]_label "pout[1-4]".
1f234ff1
MCC
292
293 - LTC2974, LTC2975: N=1-4
294 - LTC2977, LTC2980, LTM2987: Not supported
295 - LTC2978: Not supported
296 - LTC3880, LTC3882, LTC3886, LTC3887, LTM4675, LTM4676:
297 N=1-2
298 - LTC3883: N=2
299
fd9175d2
GR
300power[N]_input Measured output power.
301
1f234ff1
MCC
302curr1_label "iin".
303
304 LTC3880, LTC3883, LTC3886, LTC3887, LTM4675,
ccf2dc51 305 and LTM4676 only.
1f234ff1 306
ddfb41ca 307curr1_input Measured input current.
1f234ff1 308
ddfb41ca 309curr1_max Maximum input current.
1f234ff1 310
ddfb41ca 311curr1_max_alarm Input current high alarm.
1f234ff1
MCC
312
313curr1_highest Highest input current.
314
315 LTC3883 and LTC3886 only.
316
317curr1_reset_history Reset input current history.
318
319 LTC3883 and LTC3886 only.
fd9175d2
GR
320
321curr[N]_label "iout[1-4]".
1f234ff1
MCC
322
323 - LTC2974, LTC2975: N=1-4
324 - LTC2977, LTC2980, LTM2987: not supported
325 - LTC2978: not supported
326 - LTC3880, LTC3882, LTC3886, LTC3887, LTM4675, LTM4676:
327 N=2-3
328 - LTC3883: N=2
329
fd9175d2 330curr[N]_input Measured output current.
1f234ff1 331
fd9175d2 332curr[N]_max Maximum output current.
1f234ff1 333
fd9175d2 334curr[N]_crit Critical high output current.
1f234ff1
MCC
335
336curr[N]_lcrit Critical low output current.
337
338 LTC2974 and LTC2975 only.
339
fd9175d2 340curr[N]_max_alarm Output current high alarm.
1f234ff1 341
fd9175d2 342curr[N]_crit_alarm Output current critical high alarm.
1f234ff1 343
649ca820 344curr[N]_lcrit_alarm Output current critical low alarm.
1f234ff1
MCC
345
346 LTC2974 and LTC2975 only.
347
348curr[N]_lowest Lowest output current.
349
649ca820 350 LTC2974 and LTC2975 only.
1f234ff1 351
fd9175d2 352curr[N]_highest Highest output current.
1f234ff1 353
fd9175d2 354curr[N]_reset_history Reset output current history.
1f234ff1 355======================= ========================================================