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