1 Kernel driver max34440 1 Kernel driver max34440
2 ====================== 2 ======================
3 3
4 Supported chips: 4 Supported chips:
5 5
6 * Maxim MAX34440 6 * Maxim MAX34440
7 7
8 Prefixes: 'max34440' 8 Prefixes: 'max34440'
9 9
10 Addresses scanned: - 10 Addresses scanned: -
11 11
12 Datasheet: https://datasheets.maximintegra 12 Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34440.pdf
13 13
14 * Maxim MAX34441 14 * Maxim MAX34441
15 15
16 PMBus 5-Channel Power-Supply Manager and I 16 PMBus 5-Channel Power-Supply Manager and Intelligent Fan Controller
17 17
18 Prefixes: 'max34441' 18 Prefixes: 'max34441'
19 19
20 Addresses scanned: - 20 Addresses scanned: -
21 21
22 Datasheet: https://datasheets.maximintegra 22 Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34441.pdf
23 23
24 * Maxim MAX34446 24 * Maxim MAX34446
25 25
26 PMBus Power-Supply Data Logger 26 PMBus Power-Supply Data Logger
27 27
28 Prefixes: 'max34446' 28 Prefixes: 'max34446'
29 29
30 Addresses scanned: - 30 Addresses scanned: -
31 31
32 Datasheet: https://datasheets.maximintegra 32 Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34446.pdf
33 33
34 * Maxim MAX34451 34 * Maxim MAX34451
35 35
36 PMBus 16-Channel V/I Monitor and 12-Channe 36 PMBus 16-Channel V/I Monitor and 12-Channel Sequencer/Marginer
37 37
38 Prefixes: 'max34451' 38 Prefixes: 'max34451'
39 39
40 Addresses scanned: - 40 Addresses scanned: -
41 41
42 Datasheet: https://datasheets.maximintegra 42 Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34451.pdf
43 43
44 * Maxim MAX34460 44 * Maxim MAX34460
45 45
46 PMBus 12-Channel Voltage Monitor & Sequenc 46 PMBus 12-Channel Voltage Monitor & Sequencer
47 47
48 Prefix: 'max34460' 48 Prefix: 'max34460'
49 49
50 Addresses scanned: - 50 Addresses scanned: -
51 51
52 Datasheet: https://datasheets.maximintegra 52 Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34460.pdf
53 53
54 * Maxim MAX34461 54 * Maxim MAX34461
55 55
56 PMBus 16-Channel Voltage Monitor & Sequenc 56 PMBus 16-Channel Voltage Monitor & Sequencer
57 57
58 Prefix: 'max34461' 58 Prefix: 'max34461'
59 59
60 Addresses scanned: - 60 Addresses scanned: -
61 61
62 Datasheet: https://datasheets.maximintegra 62 Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34461.pdf
63 63
64 Author: Guenter Roeck <linux@roeck-us.net> 64 Author: Guenter Roeck <linux@roeck-us.net>
65 65
66 66
67 Description 67 Description
68 ----------- 68 -----------
69 69
70 This driver supports hardware monitoring for M 70 This driver supports hardware monitoring for Maxim MAX34440 PMBus 6-Channel
71 Power-Supply Manager, MAX34441 PMBus 5-Channel 71 Power-Supply Manager, MAX34441 PMBus 5-Channel Power-Supply Manager
72 and Intelligent Fan Controller, and MAX34446 P 72 and Intelligent Fan Controller, and MAX34446 PMBus Power-Supply Data Logger.
73 It also supports the MAX34451, MAX34460, and M 73 It also supports the MAX34451, MAX34460, and MAX34461 PMBus Voltage Monitor &
74 Sequencers. The MAX34451 supports monitoring v 74 Sequencers. The MAX34451 supports monitoring voltage or current of 12 channels
75 based on GIN pins. The MAX34460 supports 12 vo 75 based on GIN pins. The MAX34460 supports 12 voltage channels, and the MAX34461
76 supports 16 voltage channels. 76 supports 16 voltage channels.
77 77
78 The driver is a client driver to the core PMBu 78 The driver is a client driver to the core PMBus driver. Please see
79 Documentation/hwmon/pmbus.rst for details on P 79 Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
80 80
81 81
82 Usage Notes 82 Usage Notes
83 ----------- 83 -----------
84 84
85 This driver does not auto-detect devices. You 85 This driver does not auto-detect devices. You will have to instantiate the
86 devices explicitly. Please see Documentation/i 86 devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
87 details. 87 details.
88 88
89 For MAX34446, the value of the currX_crit attr 89 For MAX34446, the value of the currX_crit attribute determines if current or
90 voltage measurement is enabled for a given cha 90 voltage measurement is enabled for a given channel. Voltage measurement is
91 enabled if currX_crit is set to 0; current mea 91 enabled if currX_crit is set to 0; current measurement is enabled if the
92 attribute is set to a positive value. Power me 92 attribute is set to a positive value. Power measurement is only enabled if
93 channel 1 (3) is configured for voltage measur 93 channel 1 (3) is configured for voltage measurement, and channel 2 (4) is
94 configured for current measurement. 94 configured for current measurement.
95 95
96 96
97 Platform data support 97 Platform data support
98 --------------------- 98 ---------------------
99 99
100 The driver supports standard PMBus driver plat 100 The driver supports standard PMBus driver platform data.
101 101
102 102
103 Sysfs entries 103 Sysfs entries
104 ------------- 104 -------------
105 105
106 The following attributes are supported. Limits 106 The following attributes are supported. Limits are read-write; all other
107 attributes are read-only. 107 attributes are read-only.
108 108
109 In 109 In
110 ~~ 110 ~~
111 111
112 ======================= ====================== 112 ======================= =======================================================
113 in[1-6]_label "vout[1-6]". 113 in[1-6]_label "vout[1-6]".
114 in[1-6]_input Measured voltage. From 114 in[1-6]_input Measured voltage. From READ_VOUT register.
115 in[1-6]_min Minimum Voltage. From 115 in[1-6]_min Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
116 in[1-6]_max Maximum voltage. From 116 in[1-6]_max Maximum voltage. From VOUT_OV_WARN_LIMIT register.
117 in[1-6]_lcrit Critical minimum Volta 117 in[1-6]_lcrit Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
118 in[1-6]_crit Critical maximum volta 118 in[1-6]_crit Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
119 register. 119 register.
120 in[1-6]_min_alarm Voltage low alarm. Fro 120 in[1-6]_min_alarm Voltage low alarm. From VOLTAGE_UV_WARNING status.
121 in[1-6]_max_alarm Voltage high alarm. Fr 121 in[1-6]_max_alarm Voltage high alarm. From VOLTAGE_OV_WARNING status.
122 in[1-6]_lcrit_alarm Voltage critical low a 122 in[1-6]_lcrit_alarm Voltage critical low alarm. From VOLTAGE_UV_FAULT
123 status. 123 status.
124 in[1-6]_crit_alarm Voltage critical high 124 in[1-6]_crit_alarm Voltage critical high alarm. From VOLTAGE_OV_FAULT
125 status. 125 status.
126 in[1-6]_lowest Historical minimum vol 126 in[1-6]_lowest Historical minimum voltage.
127 in[1-6]_highest Historical maximum vol 127 in[1-6]_highest Historical maximum voltage.
128 in[1-6]_reset_history Write any value to res 128 in[1-6]_reset_history Write any value to reset history.
129 ======================= ====================== 129 ======================= =======================================================
130 130
131 .. note:: MAX34446 only supports in[1-4]. 131 .. note:: MAX34446 only supports in[1-4].
132 132
133 Curr 133 Curr
134 ~~~~ 134 ~~~~
135 135
136 ======================= ====================== 136 ======================= ========================================================
137 curr[1-6]_label "iout[1-6]". 137 curr[1-6]_label "iout[1-6]".
138 curr[1-6]_input Measured current. From 138 curr[1-6]_input Measured current. From READ_IOUT register.
139 curr[1-6]_max Maximum current. From 139 curr[1-6]_max Maximum current. From IOUT_OC_WARN_LIMIT register.
140 curr[1-6]_crit Critical maximum curre 140 curr[1-6]_crit Critical maximum current. From IOUT_OC_FAULT_LIMIT
141 register. 141 register.
142 curr[1-6]_max_alarm Current high alarm. Fr 142 curr[1-6]_max_alarm Current high alarm. From IOUT_OC_WARNING status.
143 curr[1-6]_crit_alarm Current critical high 143 curr[1-6]_crit_alarm Current critical high alarm. From IOUT_OC_FAULT status.
144 curr[1-4]_average Historical average cur 144 curr[1-4]_average Historical average current (MAX34446/34451 only).
145 curr[1-6]_highest Historical maximum cur 145 curr[1-6]_highest Historical maximum current.
146 curr[1-6]_reset_history Write any value to res 146 curr[1-6]_reset_history Write any value to reset history.
147 ======================= ====================== 147 ======================= ========================================================
148 148
149 .. note:: 149 .. note::
150 150
151 - in6 and curr6 attributes only exist for 151 - in6 and curr6 attributes only exist for MAX34440.
152 - MAX34446 only supports curr[1-4]. 152 - MAX34446 only supports curr[1-4].
153 153
154 Power 154 Power
155 ~~~~~ 155 ~~~~~
156 156
157 ======================= ====================== 157 ======================= ========================================================
158 power[1,3]_label "pout[1,3]" 158 power[1,3]_label "pout[1,3]"
159 power[1,3]_input Measured power. 159 power[1,3]_input Measured power.
160 power[1,3]_average Historical average pow 160 power[1,3]_average Historical average power.
161 power[1,3]_highest Historical maximum pow 161 power[1,3]_highest Historical maximum power.
162 ======================= ====================== 162 ======================= ========================================================
163 163
164 .. note:: Power attributes only exist for MAX3 164 .. note:: Power attributes only exist for MAX34446.
165 165
166 Temp 166 Temp
167 ~~~~ 167 ~~~~
168 168
169 ======================= ====================== 169 ======================= ========================================================
170 temp[1-8]_input Measured temperatures. 170 temp[1-8]_input Measured temperatures. From READ_TEMPERATURE_1 register.
171 temp1 is the chip's in 171 temp1 is the chip's internal temperature. temp2..temp5
172 are remote I2C tempera 172 are remote I2C temperature sensors. For MAX34441, temp6
173 is a remote thermal-di 173 is a remote thermal-diode sensor. For MAX34440, temp6..8
174 are remote I2C tempera 174 are remote I2C temperature sensors.
175 temp[1-8]_max Maximum temperature. F 175 temp[1-8]_max Maximum temperature. From OT_WARN_LIMIT register.
176 temp[1-8]_crit Critical high temperat 176 temp[1-8]_crit Critical high temperature. From OT_FAULT_LIMIT register.
177 temp[1-8]_max_alarm Temperature high alarm 177 temp[1-8]_max_alarm Temperature high alarm.
178 temp[1-8]_crit_alarm Temperature critical h 178 temp[1-8]_crit_alarm Temperature critical high alarm.
179 temp[1-8]_average Historical average tem 179 temp[1-8]_average Historical average temperature (MAX34446 only).
180 temp[1-8]_highest Historical maximum tem 180 temp[1-8]_highest Historical maximum temperature.
181 temp[1-8]_reset_history Write any value to res 181 temp[1-8]_reset_history Write any value to reset history.
182 ======================= ====================== 182 ======================= ========================================================
183 183
184 184
185 .. note:: 185 .. note::
186 - temp7 and temp8 attributes only exist for 186 - temp7 and temp8 attributes only exist for MAX34440.
187 - MAX34446 only supports temp[1-3]. 187 - MAX34446 only supports temp[1-3].
188 188
189 189
190 .. note:: 190 .. note::
191 191
192 - MAX34451 supports attribute groups in[1-1 192 - MAX34451 supports attribute groups in[1-16] (or curr[1-16] based on
193 input pins) and temp[1-5]. 193 input pins) and temp[1-5].
194 - MAX34460 supports attribute groups in[1-1 194 - MAX34460 supports attribute groups in[1-12] and temp[1-5].
195 - MAX34461 supports attribute groups in[1-1 195 - MAX34461 supports attribute groups in[1-16] and temp[1-5].
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.