Gitiles
Code Review Sign In
gerrit-public.fairphone.software / kernel / msm-4.9 / refs/tags/rel/11/fp3/8901.4.A.0016.6 / . / Documentation / hwmon / adm1275
blob: 791bc0bd91e6b25d59d526742ef2b12c07a3a794 [file] [log] [blame]
Guenter Roeck83f76492011-03-17 13:16:01 -0700[diff] [blame]1Kernel driver adm1275
2=====================
3
4Supported chips:
Guenter Roeck92711262012-02-24 03:40:53 -0800[diff] [blame]5 * Analog Devices ADM1075
6 Prefix: 'adm1075'
7 Addresses scanned: -
8 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1075.pdf
Guenter Roeck83f76492011-03-17 13:16:01 -0700[diff] [blame]9 * Analog Devices ADM1275
10 Prefix: 'adm1275'
11 Addresses scanned: -
12 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1275.pdf
Guenter Roeck5cf231a2011-07-14 11:55:35 -0700[diff] [blame]13 * Analog Devices ADM1276
14 Prefix: 'adm1276'
15 Addresses scanned: -
16 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1276.pdf
Guenter Roeck709066ac2015-07-05 11:04:56 -0700[diff] [blame]17 * Analog Devices ADM1278
18 Prefix: 'adm1278'
19 Addresses scanned: -
20 Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1278.pdf
Guenter Roeck68a40382015-03-17 13:19:51 -0700[diff] [blame]21 * Analog Devices ADM1293/ADM1294
22 Prefix: 'adm1293', 'adm1294'
23 Addresses scanned: -
24 Datasheet: http://www.analog.com/media/en/technical-documentation/data-sheets/ADM1293_1294.pdf
Guenter Roeck83f76492011-03-17 13:16:01 -0700[diff] [blame]25
Guenter Roecke3333e52013-02-20 20:58:42 -0800[diff] [blame]26Author: Guenter Roeck <linux@roeck-us.net>
Guenter Roeck83f76492011-03-17 13:16:01 -0700[diff] [blame]27
28
29Description
30-----------
31
Masanari Iida92417da2016-02-28 12:57:57 +0900[diff] [blame]32This driver supports hardware monitoring for Analog Devices ADM1075, ADM1275,
Guenter Roeck709066ac2015-07-05 11:04:56 -0700[diff] [blame]33ADM1276, ADM1278, ADM1293, and ADM1294 Hot-Swap Controller and Digital
34Power Monitors.
Guenter Roeck83f76492011-03-17 13:16:01 -0700[diff] [blame]35
Guenter Roeck709066ac2015-07-05 11:04:56 -0700[diff] [blame]36ADM1075, ADM1275, ADM1276, ADM1278, ADM1293, and ADM1294 are hot-swap
37controllers that allow a circuit board to be removed from or inserted into
38a live backplane. They also feature current and voltage readback via an
39integrated 12 bit analog-to-digital converter (ADC), accessed using a
40PMBus interface.
Guenter Roeck83f76492011-03-17 13:16:01 -0700[diff] [blame]41
42The driver is a client driver to the core PMBus driver. Please see
43Documentation/hwmon/pmbus for details on PMBus client drivers.
44
45
46Usage Notes
47-----------
48
49This driver does not auto-detect devices. You will have to instantiate the
50devices explicitly. Please see Documentation/i2c/instantiating-devices for
51details.
52
Guenter Roeck92711262012-02-24 03:40:53 -0800[diff] [blame]53The ADM1075, unlike many other PMBus devices, does not support internal voltage
54or current scaling. Reported voltages, currents, and power are raw measurements,
55and will typically have to be scaled.
56
Guenter Roeck83f76492011-03-17 13:16:01 -0700[diff] [blame]57
58Platform data support
59---------------------
60
61The driver supports standard PMBus driver platform data. Please see
62Documentation/hwmon/pmbus for details.
63
64
65Sysfs entries
66-------------
67
Guenter Roeckc576e302011-07-09 11:17:33 -0700[diff] [blame]68The following attributes are supported. Limits are read-write, history reset
69attributes are write-only, all other attributes are read-only.
Guenter Roeck83f76492011-03-17 13:16:01 -0700[diff] [blame]70
Guenter Roeck68a40382015-03-17 13:19:51 -0700[diff] [blame]71inX_label "vin1" or "vout1" depending on chip variant and
72 configuration. On ADM1075, ADM1293, and ADM1294,
73 vout1 reports the voltage on the VAUX pin.
74inX_input Measured voltage.
75inX_min Minimum Voltage.
76inX_max Maximum voltage.
77inX_min_alarm Voltage low alarm.
78inX_max_alarm Voltage high alarm.
79inX_highest Historical maximum voltage.
80inX_reset_history Write any value to reset history.
Guenter Roeck83f76492011-03-17 13:16:01 -0700[diff] [blame]81
82curr1_label "iout1"
Guenter Roeck5cf231a2011-07-14 11:55:35 -0700[diff] [blame]83curr1_input Measured current.
84curr1_max Maximum current.
85curr1_max_alarm Current high alarm.
Guenter Roeckc5e67632011-08-02 11:08:57 -0700[diff] [blame]86curr1_lcrit Critical minimum current. Depending on the chip
87 configuration, either curr1_lcrit or curr1_crit is
88 supported, but not both.
89curr1_lcrit_alarm Critical current low alarm.
90curr1_crit Critical maximum current. Depending on the chip
91 configuration, either curr1_lcrit or curr1_crit is
92 supported, but not both.
93curr1_crit_alarm Critical current high alarm.
Guenter Roeckc576e302011-07-09 11:17:33 -0700[diff] [blame]94curr1_highest Historical maximum current.
95curr1_reset_history Write any value to reset history.
Guenter Roeck92711262012-02-24 03:40:53 -0800[diff] [blame]96
97power1_label "pin1"
98power1_input Input power.
Guenter Roeck68a40382015-03-17 13:19:51 -0700[diff] [blame]99power1_input_lowest Lowest observed input power. ADM1293 and ADM1294 only.
100power1_input_highest Highest observed input power.
Guenter Roeck92711262012-02-24 03:40:53 -0800[diff] [blame]101power1_reset_history Write any value to reset history.
102
Guenter Roeck68a40382015-03-17 13:19:51 -0700[diff] [blame]103 Power attributes are supported on ADM1075, ADM1276,
104 ADM1293, and ADM1294.
Guenter Roeck709066ac2015-07-05 11:04:56 -0700[diff] [blame]105
106temp1_input Chip temperature.
107 Temperature attributes are only available on ADM1278.
108temp1_max Maximum chip temperature.
109temp1_max_alarm Temperature alarm.
110temp1_crit Critical chip temperature.
111temp1_crit_alarm Critical temperature high alarm.
112temp1_highest Highest observed temperature.
113temp1_reset_history Write any value to reset history.
114
115 Temperature attributes are supported on ADM1278.