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