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 ADM1275
10    Prefix: 'adm1275'
11    Addresses scanned: -
12    Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1275.pdf
13  * Analog Devices ADM1276
14    Prefix: 'adm1276'
15    Addresses scanned: -
16    Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1276.pdf
17
18Author: Guenter Roeck <guenter.roeck@ericsson.com>
19
20
21Description
22-----------
23
24This driver supports hardware montoring for Analog Devices ADM1075, ADM1275,
25and ADM1276 Hot-Swap Controller and Digital Power Monitor.
26
27ADM1075, ADM1275, and ADM1276 are hot-swap controllers that allow a circuit
28board to be removed from or inserted into a live backplane. They also feature
29current and voltage readback via an integrated 12-bit analog-to-digital
30converter (ADC), accessed using a PMBus interface.
31
32The driver is a client driver to the core PMBus driver. Please see
33Documentation/hwmon/pmbus for details on PMBus client drivers.
34
35
36Usage Notes
37-----------
38
39This driver does not auto-detect devices. You will have to instantiate the
40devices explicitly. Please see Documentation/i2c/instantiating-devices for
41details.
42
43The ADM1075, unlike many other PMBus devices, does not support internal voltage
44or current scaling. Reported voltages, currents, and power are raw measurements,
45and will typically have to be scaled.
46
47
48Platform data support
49---------------------
50
51The driver supports standard PMBus driver platform data. Please see
52Documentation/hwmon/pmbus for details.
53
54
55Sysfs entries
56-------------
57
58The following attributes are supported. Limits are read-write, history reset
59attributes are write-only, all other attributes are read-only.
60
61in1_label		"vin1" or "vout1" depending on chip variant and
62			configuration. On ADM1075, vout1 reports the voltage on
63			the VAUX pin.
64in1_input		Measured voltage.
65in1_min			Minimum Voltage.
66in1_max			Maximum voltage.
67in1_min_alarm		Voltage low alarm.
68in1_max_alarm		Voltage high alarm.
69in1_highest		Historical maximum voltage.
70in1_reset_history	Write any value to reset history.
71
72curr1_label		"iout1"
73curr1_input		Measured current.
74curr1_max		Maximum current.
75curr1_max_alarm		Current high alarm.
76curr1_lcrit		Critical minimum current. Depending on the chip
77			configuration, either curr1_lcrit or curr1_crit is
78			supported, but not both.
79curr1_lcrit_alarm	Critical current low alarm.
80curr1_crit		Critical maximum current. Depending on the chip
81			configuration, either curr1_lcrit or curr1_crit is
82			supported, but not both.
83curr1_crit_alarm	Critical current high alarm.
84curr1_highest		Historical maximum current.
85curr1_reset_history	Write any value to reset history.
86
87power1_label		"pin1"
88power1_input		Input power.
89power1_reset_history	Write any value to reset history.
90
91			Power attributes are supported on ADM1075 and ADM1276
92			only.
93