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