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