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