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