TrustedFirmware Git Browser
Code Review Sign In
review.trustedfirmware.org / hafnium / third_party / linux.git / b4b6d4a02fa8aa8187d426b508fb7f3b69df0dcc / . / Documentation / hwmon / ltc2978
blob: 9a49d3c90cd1a7f2a28b19f0850cdc2bd00dbbae [file] [log] [blame]
Andrew Scullb4b6d4a2019-01-02 15:54:55 +0000[diff] [blame^]1Kernel driver ltc2978
2=====================
3
4Supported chips:
5 * Linear Technology LTC2974
6 Prefix: 'ltc2974'
7 Addresses scanned: -
8 Datasheet: http://www.linear.com/product/ltc2974
9 * Linear Technology LTC2975
10 Prefix: 'ltc2975'
11 Addresses scanned: -
12 Datasheet: http://www.linear.com/product/ltc2975
13 * Linear Technology LTC2977
14 Prefix: 'ltc2977'
15 Addresses scanned: -
16 Datasheet: http://www.linear.com/product/ltc2977
17 * Linear Technology LTC2978, LTC2978A
18 Prefix: 'ltc2978'
19 Addresses scanned: -
20 Datasheet: http://www.linear.com/product/ltc2978
21 http://www.linear.com/product/ltc2978a
22 * Linear Technology LTC2980
23 Prefix: 'ltc2980'
24 Addresses scanned: -
25 Datasheet: http://www.linear.com/product/ltc2980
26 * Linear Technology LTC3880
27 Prefix: 'ltc3880'
28 Addresses scanned: -
29 Datasheet: http://www.linear.com/product/ltc3880
30 * Linear Technology LTC3882
31 Prefix: 'ltc3882'
32 Addresses scanned: -
33 Datasheet: http://www.linear.com/product/ltc3882
34 * Linear Technology LTC3883
35 Prefix: 'ltc3883'
36 Addresses scanned: -
37 Datasheet: http://www.linear.com/product/ltc3883
38 * Linear Technology LTC3886
39 Prefix: 'ltc3886'
40 Addresses scanned: -
41 Datasheet: http://www.linear.com/product/ltc3886
42 * Linear Technology LTC3887
43 Prefix: 'ltc3887'
44 Addresses scanned: -
45 Datasheet: http://www.linear.com/product/ltc3887
46 * Linear Technology LTM2987
47 Prefix: 'ltm2987'
48 Addresses scanned: -
49 Datasheet: http://www.linear.com/product/ltm2987
50 * Linear Technology LTM4675
51 Prefix: 'ltm4675'
52 Addresses scanned: -
53 Datasheet: http://www.linear.com/product/ltm4675
54 * Linear Technology LTM4676
55 Prefix: 'ltm4676'
56 Addresses scanned: -
57 Datasheet: http://www.linear.com/product/ltm4676
58
59Author: Guenter Roeck <linux@roeck-us.net>
60
61
62Description
63-----------
64
65LTC2974 and LTC2975 are quad digital power supply managers.
66LTC2978 is an octal power supply monitor.
67LTC2977 is a pin compatible replacement for LTC2978.
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.
71LTC3880, LTC3882, LTC3886, and LTC3887 are dual output poly-phase step-down
72DC/DC controllers.
73LTC3883 is a single phase step-down DC/DC controller.
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.
77LTM4675 is a dual 9A or single 18A μModule regulator
78LTM4676 is a dual 13A or single 26A uModule regulator.
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.
100in1_max Maximum input voltage.
101 LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
102 LTM2987 only.
103in1_lcrit Critical minimum input voltage.
104 LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
105 LTM2987 only.
106in1_crit Critical maximum input voltage.
107in1_min_alarm Input voltage low alarm.
108in1_max_alarm Input voltage high alarm.
109 LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
110 LTM2987 only.
111in1_lcrit_alarm Input voltage critical low alarm.
112 LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
113 LTM2987 only.
114in1_crit_alarm Input voltage critical high alarm.
115in1_lowest Lowest input voltage.
116 LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
117 LTM2987 only.
118in1_highest Highest input voltage.
119in1_reset_history Reset input voltage history.
120
121in[N]_label "vout[1-8]".
122 LTC2974, LTC2975: N=2-5
123 LTC2977, LTC2980, LTM2987: N=2-9
124 LTC2978: N=2-9
125 LTC3880, LTC3882, LTC23886 LTC3887, LTM4675, LTM4676:
126 N=2-3
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.
137in[N]_lowest Lowest output voltage. LTC2974, LTC2975,
138 and LTC2978 only.
139in[N]_highest Highest output voltage.
140in[N]_reset_history Reset output voltage history.
141
142temp[N]_input Measured temperature.
143 On LTC2974 and LTC2975, temp[1-4] report external
144 temperatures, and temp5 reports the chip temperature.
145 On LTC2977, LTC2980, LTC2978, and LTM2987, only one
146 temperature measurement is supported and reports
147 the chip temperature.
148 On LTC3880, LTC3882, LTC3887, LTM4675, and LTM4676,
149 temp1 and temp2 report external temperatures, and temp3
150 reports the chip temperature.
151 On LTC3883, temp1 reports an external temperature,
152 and temp2 reports the chip temperature.
153temp[N]_min Mimimum temperature. LTC2974, LCT2977, LTM2980, LTC2978,
154 and LTM2987 only.
155temp[N]_max Maximum temperature.
156temp[N]_lcrit Critical low temperature.
157temp[N]_crit Critical high temperature.
158temp[N]_min_alarm Temperature low alarm.
159 LTC2974, LTC2975, LTC2977, LTM2980, LTC2978, and
160 LTM2987 only.
161temp[N]_max_alarm Temperature high alarm.
162temp[N]_lcrit_alarm Temperature critical low alarm.
163temp[N]_crit_alarm Temperature critical high alarm.
164temp[N]_lowest Lowest measured temperature.
165 LTC2974, LTC2975, LTC2977, LTM2980, LTC2978, and
166 LTM2987 only.
167 Not supported for chip temperature sensor on LTC2974 and
168 LTC2975.
169temp[N]_highest Highest measured temperature. Not supported for chip
170 temperature sensor on LTC2974 and LTC2975.
171temp[N]_reset_history Reset temperature history. Not supported for chip
172 temperature sensor on LTC2974 and LTC2975.
173
174power1_label "pin". LTC3883 and LTC3886 only.
175power1_input Measured input power.
176
177power[N]_label "pout[1-4]".
178 LTC2974, LTC2975: N=1-4
179 LTC2977, LTC2980, LTM2987: Not supported
180 LTC2978: Not supported
181 LTC3880, LTC3882, LTC3886, LTC3887, LTM4675, LTM4676:
182 N=1-2
183 LTC3883: N=2
184power[N]_input Measured output power.
185
186curr1_label "iin". LTC3880, LTC3883, LTC3886, LTC3887, LTM4675,
187 and LTM4676 only.
188curr1_input Measured input current.
189curr1_max Maximum input current.
190curr1_max_alarm Input current high alarm.
191curr1_highest Highest input current. LTC3883 and LTC3886 only.
192curr1_reset_history Reset input current history. LTC3883 and LTC3886 only.
193
194curr[N]_label "iout[1-4]".
195 LTC2974, LTC2975: N=1-4
196 LTC2977, LTC2980, LTM2987: not supported
197 LTC2978: not supported
198 LTC3880, LTC3882, LTC3886, LTC3887, LTM4675, LTM4676:
199 N=2-3
200 LTC3883: N=2
201curr[N]_input Measured output current.
202curr[N]_max Maximum output current.
203curr[N]_crit Critical high output current.
204curr[N]_lcrit Critical low output current. LTC2974 and LTC2975 only.
205curr[N]_max_alarm Output current high alarm.
206curr[N]_crit_alarm Output current critical high alarm.
207curr[N]_lcrit_alarm Output current critical low alarm.
208 LTC2974 and LTC2975 only.
209curr[N]_lowest Lowest output current. LTC2974 and LTC2975 only.
210curr[N]_highest Highest output current.
211curr[N]_reset_history Reset output current history.