Gitiles
Code Review Sign In
gerrit-public.fairphone.software / kernel / msm-4.19 / d1841d32835f4125ecb660c1ff6bb0dd059eadf8 / . / Documentation / hwmon / ltc2978
blob: 9a49d3c90cd1a7f2a28b19f0850cdc2bd00dbbae [file] [log] [blame]
Guenter Roeckc3ff9a62011-09-02 09:58:37 -0700[diff] [blame]1Kernel driver ltc2978
2=====================
3
4Supported chips:
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]5 * Linear Technology LTC2974
6 Prefix: 'ltc2974'
7 Addresses scanned: -
8 Datasheet: http://www.linear.com/product/ltc2974
Guenter Roeck649ca822015-06-08 09:56:20 -0700[diff] [blame]9 * Linear Technology LTC2975
10 Prefix: 'ltc2975'
11 Addresses scanned: -
12 Datasheet: http://www.linear.com/product/ltc2975
Guenter Roeckc24c407e2013-09-23 10:56:48 -0700[diff] [blame]13 * Linear Technology LTC2977
14 Prefix: 'ltc2977'
15 Addresses scanned: -
16 Datasheet: http://www.linear.com/product/ltc2977
Guenter Roeck3f08d7f2013-09-23 11:23:37 -0700[diff] [blame]17 * Linear Technology LTC2978, LTC2978A
Guenter Roeckc3ff9a62011-09-02 09:58:37 -0700[diff] [blame]18 Prefix: 'ltc2978'
19 Addresses scanned: -
Guenter Roeck6d21a412013-01-27 09:36:36 -0800[diff] [blame]20 Datasheet: http://www.linear.com/product/ltc2978
Guenter Roeck3f08d7f2013-09-23 11:23:37 -0700[diff] [blame]21 http://www.linear.com/product/ltc2978a
Guenter Roeck52aae6a2015-08-17 06:38:01 -0700[diff] [blame]22 * Linear Technology LTC2980
23 Prefix: 'ltc2980'
24 Addresses scanned: -
25 Datasheet: http://www.linear.com/product/ltc2980
Guenter Roeckddfb41c2011-09-11 20:31:09 -0700[diff] [blame]26 * Linear Technology LTC3880
27 Prefix: 'ltc3880'
28 Addresses scanned: -
Guenter Roeck6d21a412013-01-27 09:36:36 -0800[diff] [blame]29 Datasheet: http://www.linear.com/product/ltc3880
Guenter Roeckbf893862015-06-08 10:29:45 -0700[diff] [blame]30 * Linear Technology LTC3882
31 Prefix: 'ltc3882'
32 Addresses scanned: -
33 Datasheet: http://www.linear.com/product/ltc3882
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]34 * Linear Technology LTC3883
35 Prefix: 'ltc3883'
36 Addresses scanned: -
37 Datasheet: http://www.linear.com/product/ltc3883
Guenter Roeck228b6872015-08-17 07:21:43 -0700[diff] [blame]38 * Linear Technology LTC3886
39 Prefix: 'ltc3886'
40 Addresses scanned: -
41 Datasheet: http://www.linear.com/product/ltc3886
Guenter Roeck15398562015-08-07 09:06:37 -0700[diff] [blame]42 * Linear Technology LTC3887
43 Prefix: 'ltc3887'
44 Addresses scanned: -
45 Datasheet: http://www.linear.com/product/ltc3887
Guenter Roeck52aae6a2015-08-17 06:38:01 -0700[diff] [blame]46 * Linear Technology LTM2987
47 Prefix: 'ltm2987'
48 Addresses scanned: -
49 Datasheet: http://www.linear.com/product/ltm2987
Guenter Roeckccf2dc52015-08-17 20:08:09 -0700[diff] [blame]50 * Linear Technology LTM4675
51 Prefix: 'ltm4675'
52 Addresses scanned: -
53 Datasheet: http://www.linear.com/product/ltm4675
Guenter Roeckf76992b2014-03-05 21:23:01 -0800[diff] [blame]54 * Linear Technology LTM4676
55 Prefix: 'ltm4676'
56 Addresses scanned: -
57 Datasheet: http://www.linear.com/product/ltm4676
Guenter Roeckc3ff9a62011-09-02 09:58:37 -0700[diff] [blame]58
Guenter Roecke3333e52013-02-20 20:58:42 -0800[diff] [blame]59Author: Guenter Roeck <linux@roeck-us.net>
Guenter Roeckc3ff9a62011-09-02 09:58:37 -0700[diff] [blame]60
61
62Description
63-----------
64
Guenter Roeck649ca822015-06-08 09:56:20 -0700[diff] [blame]65LTC2974 and LTC2975 are quad digital power supply managers.
Guenter Roeckbf893862015-06-08 10:29:45 -0700[diff] [blame]66LTC2978 is an octal power supply monitor.
67LTC2977 is a pin compatible replacement for LTC2978.
Guenter Roeck52aae6a2015-08-17 06:38:01 -0700[diff] [blame]68LTC2980 is a 16-channel Power System Manager, consisting of two LTC2977
69in a single die. The chip is instantiated and reported as two separate chips
70on two different I2C bus addresses.
Guenter Roeck228b6872015-08-17 07:21:43 -0700[diff] [blame]71LTC3880, LTC3882, LTC3886, and LTC3887 are dual output poly-phase step-down
72DC/DC controllers.
Guenter Roeckbf893862015-06-08 10:29:45 -0700[diff] [blame]73LTC3883 is a single phase step-down DC/DC controller.
Guenter Roeck52aae6a2015-08-17 06:38:01 -0700[diff] [blame]74LTM2987 is a 16-channel Power System Manager with two LTC2977 plus
75additional components on a single die. The chip is instantiated and reported
76as two separate chips on two different I2C bus addresses.
Guenter Roeckccf2dc52015-08-17 20:08:09 -0700[diff] [blame]77LTM4675 is a dual 9A or single 18A μModule regulator
Guenter Roeckbf893862015-06-08 10:29:45 -0700[diff] [blame]78LTM4676 is a dual 13A or single 26A uModule regulator.
Guenter Roeckc3ff9a62011-09-02 09:58:37 -0700[diff] [blame]79
80
81Usage Notes
82-----------
83
84This driver does not probe for PMBus devices. You will have to instantiate
85devices explicitly.
86
87Example: the following commands will load the driver for an LTC2978 at address
880x60 on I2C bus #1:
89
90# modprobe ltc2978
91# echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
92
93
94Sysfs attributes
95----------------
96
97in1_label "vin"
98in1_input Measured input voltage.
99in1_min Minimum input voltage.
Guenter Roeckc24c407e2013-09-23 10:56:48 -0700[diff] [blame]100in1_max Maximum input voltage.
Guenter Roeck52aae6a2015-08-17 06:38:01 -0700[diff] [blame]101 LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
102 LTM2987 only.
Guenter Roeckc24c407e2013-09-23 10:56:48 -0700[diff] [blame]103in1_lcrit Critical minimum input voltage.
Guenter Roeck52aae6a2015-08-17 06:38:01 -0700[diff] [blame]104 LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
105 LTM2987 only.
Guenter Roeckc3ff9a62011-09-02 09:58:37 -0700[diff] [blame]106in1_crit Critical maximum input voltage.
107in1_min_alarm Input voltage low alarm.
Guenter Roeckc24c407e2013-09-23 10:56:48 -0700[diff] [blame]108in1_max_alarm Input voltage high alarm.
Guenter Roeck52aae6a2015-08-17 06:38:01 -0700[diff] [blame]109 LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
110 LTM2987 only.
Guenter Roeckc24c407e2013-09-23 10:56:48 -0700[diff] [blame]111in1_lcrit_alarm Input voltage critical low alarm.
Guenter Roeck52aae6a2015-08-17 06:38:01 -0700[diff] [blame]112 LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
113 LTM2987 only.
Guenter Roeckc3ff9a62011-09-02 09:58:37 -0700[diff] [blame]114in1_crit_alarm Input voltage critical high alarm.
Guenter Roeckc24c407e2013-09-23 10:56:48 -0700[diff] [blame]115in1_lowest Lowest input voltage.
Guenter Roeck52aae6a2015-08-17 06:38:01 -0700[diff] [blame]116 LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
117 LTM2987 only.
Guenter Roeckc3ff9a62011-09-02 09:58:37 -0700[diff] [blame]118in1_highest Highest input voltage.
Guenter Roeck8c770f32013-02-22 07:52:39 -0800[diff] [blame]119in1_reset_history Reset input voltage history.
Guenter Roeckc3ff9a62011-09-02 09:58:37 -0700[diff] [blame]120
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]121in[N]_label "vout[1-8]".
Guenter Roeck649ca822015-06-08 09:56:20 -0700[diff] [blame]122 LTC2974, LTC2975: N=2-5
Guenter Roeck52aae6a2015-08-17 06:38:01 -0700[diff] [blame]123 LTC2977, LTC2980, LTM2987: N=2-9
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]124 LTC2978: N=2-9
Guenter Roeckccf2dc52015-08-17 20:08:09 -0700[diff] [blame]125 LTC3880, LTC3882, LTC23886 LTC3887, LTM4675, LTM4676:
126 N=2-3
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]127 LTC3883: N=2
128in[N]_input Measured output voltage.
129in[N]_min Minimum output voltage.
130in[N]_max Maximum output voltage.
131in[N]_lcrit Critical minimum output voltage.
132in[N]_crit Critical maximum output voltage.
133in[N]_min_alarm Output voltage low alarm.
134in[N]_max_alarm Output voltage high alarm.
135in[N]_lcrit_alarm Output voltage critical low alarm.
136in[N]_crit_alarm Output voltage critical high alarm.
Guenter Roeck649ca822015-06-08 09:56:20 -0700[diff] [blame]137in[N]_lowest Lowest output voltage. LTC2974, LTC2975,
138 and LTC2978 only.
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]139in[N]_highest Highest output voltage.
140in[N]_reset_history Reset output voltage history.
Guenter Roeckc3ff9a62011-09-02 09:58:37 -0700[diff] [blame]141
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]142temp[N]_input Measured temperature.
Guenter Roeck649ca822015-06-08 09:56:20 -0700[diff] [blame]143 On LTC2974 and LTC2975, temp[1-4] report external
144 temperatures, and temp5 reports the chip temperature.
Guenter Roeck52aae6a2015-08-17 06:38:01 -0700[diff] [blame]145 On LTC2977, LTC2980, LTC2978, and LTM2987, only one
146 temperature measurement is supported and reports
147 the chip temperature.
Guenter Roeckccf2dc52015-08-17 20:08:09 -0700[diff] [blame]148 On LTC3880, LTC3882, LTC3887, LTM4675, and LTM4676,
149 temp1 and temp2 report external temperatures, and temp3
150 reports the chip temperature.
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]151 On LTC3883, temp1 reports an external temperature,
152 and temp2 reports the chip temperature.
Guenter Roeck52aae6a2015-08-17 06:38:01 -0700[diff] [blame]153temp[N]_min Mimimum temperature. LTC2974, LCT2977, LTM2980, LTC2978,
154 and LTM2987 only.
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]155temp[N]_max Maximum temperature.
156temp[N]_lcrit Critical low temperature.
157temp[N]_crit Critical high temperature.
Guenter Roeckc24c407e2013-09-23 10:56:48 -0700[diff] [blame]158temp[N]_min_alarm Temperature low alarm.
Guenter Roeck52aae6a2015-08-17 06:38:01 -0700[diff] [blame]159 LTC2974, LTC2975, LTC2977, LTM2980, LTC2978, and
160 LTM2987 only.
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]161temp[N]_max_alarm Temperature high alarm.
162temp[N]_lcrit_alarm Temperature critical low alarm.
163temp[N]_crit_alarm Temperature critical high alarm.
Guenter Roeckc24c407e2013-09-23 10:56:48 -0700[diff] [blame]164temp[N]_lowest Lowest measured temperature.
Guenter Roeck52aae6a2015-08-17 06:38:01 -0700[diff] [blame]165 LTC2974, LTC2975, LTC2977, LTM2980, LTC2978, and
166 LTM2987 only.
Guenter Roeck649ca822015-06-08 09:56:20 -0700[diff] [blame]167 Not supported for chip temperature sensor on LTC2974 and
168 LTC2975.
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]169temp[N]_highest Highest measured temperature. Not supported for chip
Guenter Roeck649ca822015-06-08 09:56:20 -0700[diff] [blame]170 temperature sensor on LTC2974 and LTC2975.
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]171temp[N]_reset_history Reset temperature history. Not supported for chip
Guenter Roeck649ca822015-06-08 09:56:20 -0700[diff] [blame]172 temperature sensor on LTC2974 and LTC2975.
Guenter Roeckddfb41c2011-09-11 20:31:09 -0700[diff] [blame]173
Guenter Roeck228b6872015-08-17 07:21:43 -0700[diff] [blame]174power1_label "pin". LTC3883 and LTC3886 only.
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]175power1_input Measured input power.
Guenter Roeckddfb41c2011-09-11 20:31:09 -0700[diff] [blame]176
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]177power[N]_label "pout[1-4]".
Guenter Roeck649ca822015-06-08 09:56:20 -0700[diff] [blame]178 LTC2974, LTC2975: N=1-4
Guenter Roeck52aae6a2015-08-17 06:38:01 -0700[diff] [blame]179 LTC2977, LTC2980, LTM2987: Not supported
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]180 LTC2978: Not supported
Guenter Roeckccf2dc52015-08-17 20:08:09 -0700[diff] [blame]181 LTC3880, LTC3882, LTC3886, LTC3887, LTM4675, LTM4676:
182 N=1-2
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]183 LTC3883: N=2
184power[N]_input Measured output power.
185
Guenter Roeckccf2dc52015-08-17 20:08:09 -0700[diff] [blame]186curr1_label "iin". LTC3880, LTC3883, LTC3886, LTC3887, LTM4675,
187 and LTM4676 only.
Guenter Roeckddfb41c2011-09-11 20:31:09 -0700[diff] [blame]188curr1_input Measured input current.
189curr1_max Maximum input current.
190curr1_max_alarm Input current high alarm.
Guenter Roeck228b6872015-08-17 07:21:43 -0700[diff] [blame]191curr1_highest Highest input current. LTC3883 and LTC3886 only.
192curr1_reset_history Reset input current history. LTC3883 and LTC3886 only.
Guenter Roeckddfb41c2011-09-11 20:31:09 -0700[diff] [blame]193
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]194curr[N]_label "iout[1-4]".
Guenter Roeck649ca822015-06-08 09:56:20 -0700[diff] [blame]195 LTC2974, LTC2975: N=1-4
Guenter Roeck52aae6a2015-08-17 06:38:01 -0700[diff] [blame]196 LTC2977, LTC2980, LTM2987: not supported
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]197 LTC2978: not supported
Guenter Roeckccf2dc52015-08-17 20:08:09 -0700[diff] [blame]198 LTC3880, LTC3882, LTC3886, LTC3887, LTM4675, LTM4676:
199 N=2-3
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]200 LTC3883: N=2
201curr[N]_input Measured output current.
202curr[N]_max Maximum output current.
203curr[N]_crit Critical high output current.
Guenter Roeck649ca822015-06-08 09:56:20 -0700[diff] [blame]204curr[N]_lcrit Critical low output current. LTC2974 and LTC2975 only.
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]205curr[N]_max_alarm Output current high alarm.
206curr[N]_crit_alarm Output current critical high alarm.
Guenter Roeck649ca822015-06-08 09:56:20 -0700[diff] [blame]207curr[N]_lcrit_alarm Output current critical low alarm.
208 LTC2974 and LTC2975 only.
209curr[N]_lowest Lowest output current. LTC2974 and LTC2975 only.
Guenter Roeckfd9175d2013-01-27 09:24:28 -0800[diff] [blame]210curr[N]_highest Highest output current.
211curr[N]_reset_history Reset output current history.