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