Merge branch 'for-linus' of git://opensource.wolfsonmicro.com/regulator
[pandora-kernel.git] / Documentation / hwmon / ltc2978
1 Kernel driver ltc2978
2 =====================
3
4 Supported chips:
5   * Linear Technology LTC2978
6     Prefix: 'ltc2978'
7     Addresses scanned: -
8     Datasheet: http://cds.linear.com/docs/Datasheet/2978fa.pdf
9   * Linear Technology LTC3880
10     Prefix: 'ltc3880'
11     Addresses scanned: -
12     Datasheet: http://cds.linear.com/docs/Datasheet/3880f.pdf
13
14 Author: Guenter Roeck <guenter.roeck@ericsson.com>
15
16
17 Description
18 -----------
19
20 The LTC2978 is an octal power supply monitor, supervisor, sequencer and
21 margin controller. The LTC3880 is a dual, PolyPhase DC/DC synchronous
22 step-down switching regulator controller.
23
24
25 Usage Notes
26 -----------
27
28 This driver does not probe for PMBus devices. You will have to instantiate
29 devices explicitly.
30
31 Example: the following commands will load the driver for an LTC2978 at address
32 0x60 on I2C bus #1:
33
34 # modprobe ltc2978
35 # echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
36
37
38 Sysfs attributes
39 ----------------
40
41 in1_label               "vin"
42 in1_input               Measured input voltage.
43 in1_min                 Minimum input voltage.
44 in1_max                 Maximum input voltage.
45 in1_lcrit               Critical minimum input voltage.
46 in1_crit                Critical maximum input voltage.
47 in1_min_alarm           Input voltage low alarm.
48 in1_max_alarm           Input voltage high alarm.
49 in1_lcrit_alarm         Input voltage critical low alarm.
50 in1_crit_alarm          Input voltage critical high alarm.
51 in1_lowest              Lowest input voltage. LTC2978 only.
52 in1_highest             Highest input voltage.
53 in1_reset_history       Reset history. Writing into this attribute will reset
54                         history for all attributes.
55
56 in[2-9]_label           "vout[1-8]". Channels 3 to 9 on LTC2978 only.
57 in[2-9]_input           Measured output voltage.
58 in[2-9]_min             Minimum output voltage.
59 in[2-9]_max             Maximum output voltage.
60 in[2-9]_lcrit           Critical minimum output voltage.
61 in[2-9]_crit            Critical maximum output voltage.
62 in[2-9]_min_alarm       Output voltage low alarm.
63 in[2-9]_max_alarm       Output voltage high alarm.
64 in[2-9]_lcrit_alarm     Output voltage critical low alarm.
65 in[2-9]_crit_alarm      Output voltage critical high alarm.
66 in[2-9]_lowest          Lowest output voltage. LTC2978 only.
67 in[2-9]_highest         Lowest output voltage.
68 in[2-9]_reset_history   Reset history. Writing into this attribute will reset
69                         history for all attributes.
70
71 temp[1-3]_input         Measured temperature.
72                         On LTC2978, only one temperature measurement is
73                         supported and reflects the internal temperature.
74                         On LTC3880, temp1 and temp2 report external
75                         temperatures, and temp3 reports the internal
76                         temperature.
77 temp[1-3]_min           Mimimum temperature.
78 temp[1-3]_max           Maximum temperature.
79 temp[1-3]_lcrit         Critical low temperature.
80 temp[1-3]_crit          Critical high temperature.
81 temp[1-3]_min_alarm     Chip temperature low alarm.
82 temp[1-3]_max_alarm     Chip temperature high alarm.
83 temp[1-3]_lcrit_alarm   Chip temperature critical low alarm.
84 temp[1-3]_crit_alarm    Chip temperature critical high alarm.
85 temp[1-3]_lowest        Lowest measured temperature. LTC2978 only.
86 temp[1-3]_highest       Highest measured temperature.
87 temp[1-3]_reset_history Reset history. Writing into this attribute will reset
88                         history for all attributes.
89
90 power[1-2]_label        "pout[1-2]". LTC3880 only.
91 power[1-2]_input        Measured power.
92
93 curr1_label             "iin". LTC3880 only.
94 curr1_input             Measured input current.
95 curr1_max               Maximum input current.
96 curr1_max_alarm         Input current high alarm.
97
98 curr[2-3]_label         "iout[1-2]". LTC3880 only.
99 curr[2-3]_input         Measured input current.
100 curr[2-3]_max           Maximum input current.
101 curr[2-3]_crit          Critical input current.
102 curr[2-3]_max_alarm     Input current high alarm.
103 curr[2-3]_crit_alarm    Input current critical high alarm.