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