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