1 What: /sys/class/hwmon/hwmonX/name 1 What: /sys/class/hwmon/hwmonX/name
2 Description: 2 Description:
3 The chip name. 3 The chip name.
4 This should be a short, lowerc 4 This should be a short, lowercase string, not containing
5 whitespace, dashes, or the wil 5 whitespace, dashes, or the wildcard character '*'.
6 This attribute represents the 6 This attribute represents the chip name. It is the only
7 mandatory attribute. 7 mandatory attribute.
8 I2C devices get this attribute 8 I2C devices get this attribute created automatically.
9 9
10 RO 10 RO
11 11
12 What: /sys/class/hwmon/hwmonX/label 12 What: /sys/class/hwmon/hwmonX/label
13 Description: 13 Description:
14 A descriptive label that allow 14 A descriptive label that allows to uniquely identify a
15 device within the system. 15 device within the system.
16 The contents of the label are 16 The contents of the label are free-form.
17 17
18 RO 18 RO
19 19
20 What: /sys/class/hwmon/hwmonX/update 20 What: /sys/class/hwmon/hwmonX/update_interval
21 Description: 21 Description:
22 The interval at which the chip 22 The interval at which the chip will update readings.
23 Unit: millisecond 23 Unit: millisecond
24 24
25 RW 25 RW
26 26
27 Some devices have a variable u 27 Some devices have a variable update rate or interval.
28 This attribute can be used to 28 This attribute can be used to change it to the desired value.
29 29
30 What: /sys/class/hwmon/hwmonX/inY_mi 30 What: /sys/class/hwmon/hwmonX/inY_min
31 Description: 31 Description:
32 Voltage min value. 32 Voltage min value.
33 33
34 Unit: millivolt 34 Unit: millivolt
35 35
36 RW 36 RW
37 37
38 What: /sys/class/hwmon/hwmonX/inY_lc 38 What: /sys/class/hwmon/hwmonX/inY_lcrit
39 Description: 39 Description:
40 Voltage critical min value. 40 Voltage critical min value.
41 41
42 Unit: millivolt 42 Unit: millivolt
43 43
44 RW 44 RW
45 45
46 If voltage drops to or below t 46 If voltage drops to or below this limit, the system may
47 take drastic action such as po 47 take drastic action such as power down or reset. At the very
48 least, it should report a faul 48 least, it should report a fault.
49 49
50 What: /sys/class/hwmon/hwmonX/inY_ma 50 What: /sys/class/hwmon/hwmonX/inY_max
51 Description: 51 Description:
52 Voltage max value. 52 Voltage max value.
53 53
54 Unit: millivolt 54 Unit: millivolt
55 55
56 RW 56 RW
57 57
58 What: /sys/class/hwmon/hwmonX/inY_cr 58 What: /sys/class/hwmon/hwmonX/inY_crit
59 Description: 59 Description:
60 Voltage critical max value. 60 Voltage critical max value.
61 61
62 Unit: millivolt 62 Unit: millivolt
63 63
64 RW 64 RW
65 65
66 If voltage reaches or exceeds 66 If voltage reaches or exceeds this limit, the system may
67 take drastic action such as po 67 take drastic action such as power down or reset. At the very
68 least, it should report a faul 68 least, it should report a fault.
69 69
70 What: /sys/class/hwmon/hwmonX/inY_in 70 What: /sys/class/hwmon/hwmonX/inY_input
71 Description: 71 Description:
72 Voltage input value. 72 Voltage input value.
73 73
74 Unit: millivolt 74 Unit: millivolt
75 75
76 RO 76 RO
77 77
78 Voltage measured on the chip p 78 Voltage measured on the chip pin.
79 79
80 Actual voltage depends on the 80 Actual voltage depends on the scaling resistors on the
81 motherboard, as recommended in 81 motherboard, as recommended in the chip datasheet.
82 82
83 This varies by chip and by mot 83 This varies by chip and by motherboard.
84 Because of this variation, val 84 Because of this variation, values are generally NOT scaled
85 by the chip driver, and must b 85 by the chip driver, and must be done by the application.
86 However, some drivers (notably 86 However, some drivers (notably lm87 and via686a)
87 do scale, because of internal 87 do scale, because of internal resistors built into a chip.
88 These drivers will output the 88 These drivers will output the actual voltage. Rule of
89 thumb: drivers should report t 89 thumb: drivers should report the voltage values at the
90 "pins" of the chip. 90 "pins" of the chip.
91 91
92 What: /sys/class/hwmon/hwmonX/inY_av 92 What: /sys/class/hwmon/hwmonX/inY_average
93 Description: 93 Description:
94 Average voltage 94 Average voltage
95 95
96 Unit: millivolt 96 Unit: millivolt
97 97
98 RO 98 RO
99 99
100 What: /sys/class/hwmon/hwmonX/inY_lo 100 What: /sys/class/hwmon/hwmonX/inY_lowest
101 Description: 101 Description:
102 Historical minimum voltage 102 Historical minimum voltage
103 103
104 Unit: millivolt 104 Unit: millivolt
105 105
106 RO 106 RO
107 107
108 What: /sys/class/hwmon/hwmonX/inY_hi 108 What: /sys/class/hwmon/hwmonX/inY_highest
109 Description: 109 Description:
110 Historical maximum voltage 110 Historical maximum voltage
111 111
112 Unit: millivolt 112 Unit: millivolt
113 113
114 RO 114 RO
115 115
116 What: /sys/class/hwmon/hwmonX/inY_re 116 What: /sys/class/hwmon/hwmonX/inY_reset_history
117 Description: 117 Description:
118 Reset inX_lowest and inX_highe 118 Reset inX_lowest and inX_highest
119 119
120 WO 120 WO
121 121
122 What: /sys/class/hwmon/hwmonX/in_res 122 What: /sys/class/hwmon/hwmonX/in_reset_history
123 Description: 123 Description:
124 Reset inX_lowest and inX_highe 124 Reset inX_lowest and inX_highest for all sensors
125 125
126 WO 126 WO
127 127
128 What: /sys/class/hwmon/hwmonX/inY_la 128 What: /sys/class/hwmon/hwmonX/inY_label
129 Description: 129 Description:
130 Suggested voltage channel labe 130 Suggested voltage channel label.
131 131
132 Text string 132 Text string
133 133
134 Should only be created if the 134 Should only be created if the driver has hints about what
135 this voltage channel is being 135 this voltage channel is being used for, and user-space
136 doesn't. In all other cases, t 136 doesn't. In all other cases, the label is provided by
137 user-space. 137 user-space.
138 138
139 RO 139 RO
140 140
141 What: /sys/class/hwmon/hwmonX/inY_en 141 What: /sys/class/hwmon/hwmonX/inY_enable
142 Description: 142 Description:
143 Enable or disable the sensors. 143 Enable or disable the sensors.
144 144
145 When disabled the sensor read 145 When disabled the sensor read will return -ENODATA.
146 146
147 - 1: Enable 147 - 1: Enable
148 - 0: Disable 148 - 0: Disable
149 149
150 RW 150 RW
151 151
152 What: /sys/class/hwmon/hwmonX/inY_fa 152 What: /sys/class/hwmon/hwmonX/inY_fault
153 Description: 153 Description:
154 Reports a voltage hard failure 154 Reports a voltage hard failure (eg: shorted component)
155 155
156 - 1: Failed 156 - 1: Failed
157 - 0: Ok 157 - 0: Ok
158 158
159 RO 159 RO
160 160
161 What: /sys/class/hwmon/hwmonX/cpuY_v 161 What: /sys/class/hwmon/hwmonX/cpuY_vid
162 Description: 162 Description:
163 CPU core reference voltage. 163 CPU core reference voltage.
164 164
165 Unit: millivolt 165 Unit: millivolt
166 166
167 RO 167 RO
168 168
169 Not always correct. 169 Not always correct.
170 170
171 What: /sys/class/hwmon/hwmonX/vrm 171 What: /sys/class/hwmon/hwmonX/vrm
172 Description: 172 Description:
173 Voltage Regulator Module versi 173 Voltage Regulator Module version number.
174 174
175 RW (but changing it should no 175 RW (but changing it should no more be necessary)
176 176
177 Originally the VRM standard ve 177 Originally the VRM standard version multiplied by 10, but now
178 an arbitrary number, as not al 178 an arbitrary number, as not all standards have a version
179 number. 179 number.
180 180
181 Affects the way the driver cal 181 Affects the way the driver calculates the CPU core reference
182 voltage from the vid pins. 182 voltage from the vid pins.
183 183
184 What: /sys/class/hwmon/hwmonX/inY_ra 184 What: /sys/class/hwmon/hwmonX/inY_rated_min
185 Description: 185 Description:
186 Minimum rated voltage. 186 Minimum rated voltage.
187 187
188 Unit: millivolt 188 Unit: millivolt
189 189
190 RO 190 RO
191 191
192 What: /sys/class/hwmon/hwmonX/inY_ra 192 What: /sys/class/hwmon/hwmonX/inY_rated_max
193 Description: 193 Description:
194 Maximum rated voltage. 194 Maximum rated voltage.
195 195
196 Unit: millivolt 196 Unit: millivolt
197 197
198 RO 198 RO
199 199
200 What: /sys/class/hwmon/hwmonX/fanY_m 200 What: /sys/class/hwmon/hwmonX/fanY_min
201 Description: 201 Description:
202 Fan minimum value 202 Fan minimum value
203 203
204 Unit: revolution/min (RPM) 204 Unit: revolution/min (RPM)
205 205
206 RW 206 RW
207 207
208 What: /sys/class/hwmon/hwmonX/fanY_m 208 What: /sys/class/hwmon/hwmonX/fanY_max
209 Description: 209 Description:
210 Fan maximum value 210 Fan maximum value
211 211
212 Unit: revolution/min (RPM) 212 Unit: revolution/min (RPM)
213 213
214 Only rarely supported by the h 214 Only rarely supported by the hardware.
215 RW 215 RW
216 216
217 What: /sys/class/hwmon/hwmonX/fanY_i 217 What: /sys/class/hwmon/hwmonX/fanY_input
218 Description: 218 Description:
219 Fan input value. 219 Fan input value.
220 220
221 Unit: revolution/min (RPM) 221 Unit: revolution/min (RPM)
222 222
223 RO 223 RO
224 224
225 What: /sys/class/hwmon/hwmonX/fanY_d 225 What: /sys/class/hwmon/hwmonX/fanY_div
226 Description: 226 Description:
227 Fan divisor. 227 Fan divisor.
228 228
229 Integer value in powers of two 229 Integer value in powers of two (1, 2, 4, 8, 16, 32, 64, 128).
230 230
231 RW 231 RW
232 232
233 Some chips only support values 233 Some chips only support values 1, 2, 4 and 8.
234 Note that this is actually an 234 Note that this is actually an internal clock divisor, which
235 affects the measurable speed r 235 affects the measurable speed range, not the read value.
236 236
237 What: /sys/class/hwmon/hwmonX/fanY_p 237 What: /sys/class/hwmon/hwmonX/fanY_pulses
238 Description: 238 Description:
239 Number of tachometer pulses pe 239 Number of tachometer pulses per fan revolution.
240 240
241 Integer value, typically betwe 241 Integer value, typically between 1 and 4.
242 242
243 RW 243 RW
244 244
245 This value is a characteristic 245 This value is a characteristic of the fan connected to the
246 device's input, so it has to b 246 device's input, so it has to be set in accordance with the fan
247 model. 247 model.
248 248
249 Should only be created if the 249 Should only be created if the chip has a register to configure
250 the number of pulses. In the a 250 the number of pulses. In the absence of such a register (and
251 thus attribute) the value assu 251 thus attribute) the value assumed by all devices is 2 pulses
252 per fan revolution. 252 per fan revolution.
253 253
254 What: /sys/class/hwmon/hwmonX/fanY_t 254 What: /sys/class/hwmon/hwmonX/fanY_target
255 Description: 255 Description:
256 Desired fan speed 256 Desired fan speed
257 257
258 Unit: revolution/min (RPM) 258 Unit: revolution/min (RPM)
259 259
260 RW 260 RW
261 261
262 Only makes sense if the chip s 262 Only makes sense if the chip supports closed-loop fan speed
263 control based on the measured 263 control based on the measured fan speed.
264 264
265 What: /sys/class/hwmon/hwmonX/fanY_l 265 What: /sys/class/hwmon/hwmonX/fanY_label
266 Description: 266 Description:
267 Suggested fan channel label. 267 Suggested fan channel label.
268 268
269 Text string 269 Text string
270 270
271 Should only be created if the 271 Should only be created if the driver has hints about what
272 this fan channel is being used 272 this fan channel is being used for, and user-space doesn't.
273 In all other cases, the label 273 In all other cases, the label is provided by user-space.
274 274
275 RO 275 RO
276 276
277 What: /sys/class/hwmon/hwmonX/fanY_e 277 What: /sys/class/hwmon/hwmonX/fanY_enable
278 Description: 278 Description:
279 Enable or disable the sensors. 279 Enable or disable the sensors.
280 280
281 When disabled the sensor read 281 When disabled the sensor read will return -ENODATA.
282 282
283 - 1: Enable 283 - 1: Enable
284 - 0: Disable 284 - 0: Disable
285 285
286 RW 286 RW
287 287
288 What: /sys/class/hwmon/hwmonX/fanY_f 288 What: /sys/class/hwmon/hwmonX/fanY_fault
289 Description: 289 Description:
290 Reports if a fan has reported 290 Reports if a fan has reported failure.
291 291
292 - 1: Failed 292 - 1: Failed
293 - 0: Ok 293 - 0: Ok
294 294
295 RO 295 RO
296 296
297 What: /sys/class/hwmon/hwmonX/pwmY 297 What: /sys/class/hwmon/hwmonX/pwmY
298 Description: 298 Description:
299 Pulse width modulation fan con 299 Pulse width modulation fan control.
300 300
301 Integer value in the range 0 t 301 Integer value in the range 0 to 255
302 302
303 RW 303 RW
304 304
305 255 is max or 100%. 305 255 is max or 100%.
306 306
307 What: /sys/class/hwmon/hwmonX/pwmY_e 307 What: /sys/class/hwmon/hwmonX/pwmY_enable
308 Description: 308 Description:
309 Fan speed control method: 309 Fan speed control method:
310 310
311 - 0: no fan speed control (i.e 311 - 0: no fan speed control (i.e. fan at full speed)
312 - 1: manual fan speed control 312 - 1: manual fan speed control enabled (using `pwmY`)
313 - 2+: automatic fan speed cont 313 - 2+: automatic fan speed control enabled
314 314
315 Check individual chip document 315 Check individual chip documentation files for automatic mode
316 details. 316 details.
317 317
318 RW 318 RW
319 319
320 What: /sys/class/hwmon/hwmonX/pwmY_m 320 What: /sys/class/hwmon/hwmonX/pwmY_mode
321 Description: 321 Description:
322 - 0: DC mode (direct current) 322 - 0: DC mode (direct current)
323 - 1: PWM mode (pulse-width mod 323 - 1: PWM mode (pulse-width modulation)
324 324
325 RW 325 RW
326 326
327 What: /sys/class/hwmon/hwmonX/pwmY_f 327 What: /sys/class/hwmon/hwmonX/pwmY_freq
328 Description: 328 Description:
329 Base PWM frequency in Hz. 329 Base PWM frequency in Hz.
330 330
331 Only possibly available when p 331 Only possibly available when pwmN_mode is PWM, but not always
332 present even then. 332 present even then.
333 333
334 RW 334 RW
335 335
336 What: /sys/class/hwmon/hwmonX/pwmY_a 336 What: /sys/class/hwmon/hwmonX/pwmY_auto_channels_temp
337 Description: 337 Description:
338 Select which temperature chann 338 Select which temperature channels affect this PWM output in
339 auto mode. 339 auto mode.
340 340
341 Bitfield, 1 is temp1, 2 is tem 341 Bitfield, 1 is temp1, 2 is temp2, 4 is temp3 etc...
342 Which values are possible depe 342 Which values are possible depend on the chip used.
343 343
344 RW 344 RW
345 345
346 What: /sys/class/hwmon/hwmonX/pwmY_a 346 What: /sys/class/hwmon/hwmonX/pwmY_auto_pointZ_pwm
347 What: /sys/class/hwmon/hwmonX/pwmY_a 347 What: /sys/class/hwmon/hwmonX/pwmY_auto_pointZ_temp
348 What: /sys/class/hwmon/hwmonX/pwmY_a 348 What: /sys/class/hwmon/hwmonX/pwmY_auto_pointZ_temp_hyst
349 Description: 349 Description:
350 Define the PWM vs temperature 350 Define the PWM vs temperature curve.
351 351
352 Number of trip points is chip- 352 Number of trip points is chip-dependent. Use this for chips
353 which associate trip points to 353 which associate trip points to PWM output channels.
354 354
355 RW 355 RW
356 356
357 What: /sys/class/hwmon/hwmonX/tempY_ 357 What: /sys/class/hwmon/hwmonX/tempY_auto_pointZ_pwm
358 What: /sys/class/hwmon/hwmonX/tempY_ 358 What: /sys/class/hwmon/hwmonX/tempY_auto_pointZ_temp
359 What: /sys/class/hwmon/hwmonX/tempY_ 359 What: /sys/class/hwmon/hwmonX/tempY_auto_pointZ_temp_hyst
360 Description: 360 Description:
361 Define the PWM vs temperature 361 Define the PWM vs temperature curve.
362 362
363 Number of trip points is chip- 363 Number of trip points is chip-dependent. Use this for chips
364 which associate trip points to 364 which associate trip points to temperature channels.
365 365
366 RW 366 RW
367 367
368 What: /sys/class/hwmon/hwmonX/tempY_ 368 What: /sys/class/hwmon/hwmonX/tempY_type
369 Description: 369 Description:
370 Sensor type selection. 370 Sensor type selection.
371 371
372 Integers 1 to 6 372 Integers 1 to 6
373 373
374 RW 374 RW
375 375
376 - 1: CPU embedded diode 376 - 1: CPU embedded diode
377 - 2: 3904 transistor 377 - 2: 3904 transistor
378 - 3: thermal diode 378 - 3: thermal diode
379 - 4: thermistor 379 - 4: thermistor
380 - 5: AMD AMDSI 380 - 5: AMD AMDSI
381 - 6: Intel PECI 381 - 6: Intel PECI
382 382
383 Not all types are supported by 383 Not all types are supported by all chips
384 384
385 What: /sys/class/hwmon/hwmonX/tempY_ 385 What: /sys/class/hwmon/hwmonX/tempY_max
386 Description: 386 Description:
387 Temperature max value. 387 Temperature max value.
388 388
389 Unit: millidegree Celsius (or 389 Unit: millidegree Celsius (or millivolt, see below)
390 390
391 RW 391 RW
392 392
393 What: /sys/class/hwmon/hwmonX/tempY_ 393 What: /sys/class/hwmon/hwmonX/tempY_max_alarm
394 Description: 394 Description:
395 Maximum temperature alarm flag 395 Maximum temperature alarm flag.
396 396
397 - 0: OK 397 - 0: OK
398 - 1: temperature has reached t 398 - 1: temperature has reached tempY_max
399 399
400 RO 400 RO
401 401
402 What: /sys/class/hwmon/hwmonX/tempY_ 402 What: /sys/class/hwmon/hwmonX/tempY_min
403 Description: 403 Description:
404 Temperature min value. 404 Temperature min value.
405 405
406 Unit: millidegree Celsius 406 Unit: millidegree Celsius
407 407
408 RW 408 RW
409 409
410 What: /sys/class/hwmon/hwmonX/tempY_ 410 What: /sys/class/hwmon/hwmonX/tempY_min_alarm
411 Description: 411 Description:
412 Minimum temperature alarm flag 412 Minimum temperature alarm flag.
413 413
414 - 0: OK 414 - 0: OK
415 - 1: temperature has reached t 415 - 1: temperature has reached tempY_min
416 416
417 RO 417 RO
418 418
419 What: /sys/class/hwmon/hwmonX/tempY_ 419 What: /sys/class/hwmon/hwmonX/tempY_max_hyst
420 Description: 420 Description:
421 Temperature hysteresis value f 421 Temperature hysteresis value for max limit.
422 422
423 Unit: millidegree Celsius 423 Unit: millidegree Celsius
424 424
425 Must be reported as an absolut 425 Must be reported as an absolute temperature, NOT a delta
426 from the max value. 426 from the max value.
427 427
428 RW 428 RW
429 429
430 What: /sys/class/hwmon/hwmonX/tempY_ 430 What: /sys/class/hwmon/hwmonX/tempY_min_hyst
431 Description: 431 Description:
432 Temperature hysteresis value f 432 Temperature hysteresis value for min limit.
433 Unit: millidegree Celsius 433 Unit: millidegree Celsius
434 434
435 Must be reported as an absolut 435 Must be reported as an absolute temperature, NOT a delta
436 from the min value. 436 from the min value.
437 437
438 RW 438 RW
439 439
440 What: /sys/class/hwmon/hwmonX/tempY_ 440 What: /sys/class/hwmon/hwmonX/tempY_input
441 Description: 441 Description:
442 Temperature input value. 442 Temperature input value.
443 443
444 Unit: millidegree Celsius 444 Unit: millidegree Celsius
445 445
446 RO 446 RO
447 447
448 What: /sys/class/hwmon/hwmonX/tempY_ 448 What: /sys/class/hwmon/hwmonX/tempY_crit
449 Description: 449 Description:
450 Temperature critical max value 450 Temperature critical max value, typically greater than
451 corresponding temp_max values. 451 corresponding temp_max values.
452 452
453 Unit: millidegree Celsius 453 Unit: millidegree Celsius
454 454
455 RW 455 RW
456 456
457 What: /sys/class/hwmon/hwmonX/tempY_ 457 What: /sys/class/hwmon/hwmonX/tempY_crit_alarm
458 Description: 458 Description:
459 Critical high temperature alar 459 Critical high temperature alarm flag.
460 460
461 - 0: OK 461 - 0: OK
462 - 1: temperature has reached t 462 - 1: temperature has reached tempY_crit
463 463
464 RO 464 RO
465 465
466 What: /sys/class/hwmon/hwmonX/tempY_ 466 What: /sys/class/hwmon/hwmonX/tempY_crit_hyst
467 Description: 467 Description:
468 Temperature hysteresis value f 468 Temperature hysteresis value for critical limit.
469 469
470 Unit: millidegree Celsius 470 Unit: millidegree Celsius
471 471
472 Must be reported as an absolut 472 Must be reported as an absolute temperature, NOT a delta
473 from the critical value. 473 from the critical value.
474 474
475 RW 475 RW
476 476
477 What: /sys/class/hwmon/hwmonX/tempY_ 477 What: /sys/class/hwmon/hwmonX/tempY_emergency
478 Description: 478 Description:
479 Temperature emergency max valu 479 Temperature emergency max value, for chips supporting more than
480 two upper temperature limits. 480 two upper temperature limits. Must be equal or greater than
481 corresponding temp_crit values 481 corresponding temp_crit values.
482 482
483 Unit: millidegree Celsius 483 Unit: millidegree Celsius
484 484
485 RW 485 RW
486 486
487 What: /sys/class/hwmon/hwmonX/tempY_ 487 What: /sys/class/hwmon/hwmonX/tempY_emergency_alarm
488 Description: 488 Description:
489 Emergency high temperature ala 489 Emergency high temperature alarm flag.
490 490
491 - 0: OK 491 - 0: OK
492 - 1: temperature has reached t 492 - 1: temperature has reached tempY_emergency
493 493
494 RO 494 RO
495 495
496 What: /sys/class/hwmon/hwmonX/tempY_ 496 What: /sys/class/hwmon/hwmonX/tempY_emergency_hyst
497 Description: 497 Description:
498 Temperature hysteresis value f 498 Temperature hysteresis value for emergency limit.
499 499
500 Unit: millidegree Celsius 500 Unit: millidegree Celsius
501 501
502 Must be reported as an absolut 502 Must be reported as an absolute temperature, NOT a delta
503 from the emergency value. 503 from the emergency value.
504 504
505 RW 505 RW
506 506
507 What: /sys/class/hwmon/hwmonX/tempY_ 507 What: /sys/class/hwmon/hwmonX/tempY_lcrit
508 Description: 508 Description:
509 Temperature critical min value 509 Temperature critical min value, typically lower than
510 corresponding temp_min values. 510 corresponding temp_min values.
511 511
512 Unit: millidegree Celsius 512 Unit: millidegree Celsius
513 513
514 RW 514 RW
515 515
516 What: /sys/class/hwmon/hwmonX/tempY_ 516 What: /sys/class/hwmon/hwmonX/tempY_lcrit_hyst
517 Description: 517 Description:
518 Temperature hysteresis value f 518 Temperature hysteresis value for critical min limit.
519 519
520 Unit: millidegree Celsius 520 Unit: millidegree Celsius
521 521
522 Must be reported as an absolut 522 Must be reported as an absolute temperature, NOT a delta
523 from the critical min value. 523 from the critical min value.
524 524
525 RW 525 RW
526 526
527 What: /sys/class/hwmon/hwmonX/tempY_ 527 What: /sys/class/hwmon/hwmonX/tempY_offset
528 Description: 528 Description:
529 Temperature offset which is ad 529 Temperature offset which is added to the temperature reading
530 by the chip. 530 by the chip.
531 531
532 Unit: millidegree Celsius 532 Unit: millidegree Celsius
533 533
534 Read/Write value. 534 Read/Write value.
535 535
536 What: /sys/class/hwmon/hwmonX/tempY_ 536 What: /sys/class/hwmon/hwmonX/tempY_label
537 Description: 537 Description:
538 Suggested temperature channel 538 Suggested temperature channel label.
539 539
540 Text string 540 Text string
541 541
542 Should only be created if the 542 Should only be created if the driver has hints about what
543 this temperature channel is be 543 this temperature channel is being used for, and user-space
544 doesn't. In all other cases, t 544 doesn't. In all other cases, the label is provided by
545 user-space. 545 user-space.
546 546
547 RO 547 RO
548 548
549 What: /sys/class/hwmon/hwmonX/tempY_ 549 What: /sys/class/hwmon/hwmonX/tempY_lowest
550 Description: 550 Description:
551 Historical minimum temperature 551 Historical minimum temperature
552 552
553 Unit: millidegree Celsius 553 Unit: millidegree Celsius
554 554
555 RO 555 RO
556 556
557 What: /sys/class/hwmon/hwmonX/tempY_ 557 What: /sys/class/hwmon/hwmonX/tempY_highest
558 Description: 558 Description:
559 Historical maximum temperature 559 Historical maximum temperature
560 560
561 Unit: millidegree Celsius 561 Unit: millidegree Celsius
562 562
563 RO 563 RO
564 564
565 What: /sys/class/hwmon/hwmonX/tempY_ 565 What: /sys/class/hwmon/hwmonX/tempY_reset_history
566 Description: 566 Description:
567 Reset temp_lowest and temp_hig 567 Reset temp_lowest and temp_highest
568 568
569 WO 569 WO
570 570
571 What: /sys/class/hwmon/hwmonX/temp_r 571 What: /sys/class/hwmon/hwmonX/temp_reset_history
572 Description: 572 Description:
573 Reset temp_lowest and temp_hig 573 Reset temp_lowest and temp_highest for all sensors
574 574
575 WO 575 WO
576 576
577 What: /sys/class/hwmon/hwmonX/tempY_ 577 What: /sys/class/hwmon/hwmonX/tempY_enable
578 Description: 578 Description:
579 Enable or disable the sensors. 579 Enable or disable the sensors.
580 580
581 When disabled the sensor read 581 When disabled the sensor read will return -ENODATA.
582 582
583 - 1: Enable 583 - 1: Enable
584 - 0: Disable 584 - 0: Disable
585 585
586 RW 586 RW
587 587
588 What: /sys/class/hwmon/hwmonX/tempY_ 588 What: /sys/class/hwmon/hwmonX/tempY_rated_min
589 Description: 589 Description:
590 Minimum rated temperature. 590 Minimum rated temperature.
591 591
592 Unit: millidegree Celsius 592 Unit: millidegree Celsius
593 593
594 RO 594 RO
595 595
596 What: /sys/class/hwmon/hwmonX/tempY_ 596 What: /sys/class/hwmon/hwmonX/tempY_rated_max
597 Description: 597 Description:
598 Maximum rated temperature. 598 Maximum rated temperature.
599 599
600 Unit: millidegree Celsius 600 Unit: millidegree Celsius
601 601
602 RO 602 RO
603 603
604 What: /sys/class/hwmon/hwmonX/currY_ 604 What: /sys/class/hwmon/hwmonX/currY_max
605 Description: 605 Description:
606 Current max value 606 Current max value
607 607
608 Unit: milliampere 608 Unit: milliampere
609 609
610 RW 610 RW
611 611
612 What: /sys/class/hwmon/hwmonX/currY_ 612 What: /sys/class/hwmon/hwmonX/currY_min
613 Description: 613 Description:
614 Current min value. 614 Current min value.
615 615
616 Unit: milliampere 616 Unit: milliampere
617 617
618 RW 618 RW
619 619
620 What: /sys/class/hwmon/hwmonX/currY_ 620 What: /sys/class/hwmon/hwmonX/currY_lcrit
621 Description: 621 Description:
622 Current critical low value 622 Current critical low value
623 623
624 Unit: milliampere 624 Unit: milliampere
625 625
626 RW 626 RW
627 627
628 What: /sys/class/hwmon/hwmonX/currY_ 628 What: /sys/class/hwmon/hwmonX/currY_crit
629 Description: 629 Description:
630 Current critical high value. 630 Current critical high value.
631 631
632 Unit: milliampere 632 Unit: milliampere
633 633
634 RW 634 RW
635 635
636 What: /sys/class/hwmon/hwmonX/currY_ 636 What: /sys/class/hwmon/hwmonX/currY_input
637 Description: 637 Description:
638 Current input value 638 Current input value
639 639
640 Unit: milliampere 640 Unit: milliampere
641 641
642 RO 642 RO
643 643
644 What: /sys/class/hwmon/hwmonX/currY_ 644 What: /sys/class/hwmon/hwmonX/currY_average
645 Description: 645 Description:
646 Average current use 646 Average current use
647 647
648 Unit: milliampere 648 Unit: milliampere
649 649
650 RO 650 RO
651 651
652 What: /sys/class/hwmon/hwmonX/currY_ 652 What: /sys/class/hwmon/hwmonX/currY_lowest
653 Description: 653 Description:
654 Historical minimum current 654 Historical minimum current
655 655
656 Unit: milliampere 656 Unit: milliampere
657 657
658 RO 658 RO
659 659
660 What: /sys/class/hwmon/hwmonX/currY_ 660 What: /sys/class/hwmon/hwmonX/currY_highest
661 Description: 661 Description:
662 Historical maximum current 662 Historical maximum current
663 Unit: milliampere 663 Unit: milliampere
664 RO 664 RO
665 665
666 What: /sys/class/hwmon/hwmonX/currY_ 666 What: /sys/class/hwmon/hwmonX/currY_reset_history
667 Description: 667 Description:
668 Reset currX_lowest and currX_h 668 Reset currX_lowest and currX_highest
669 669
670 WO 670 WO
671 671
672 What: /sys/class/hwmon/hwmonX/curr_r 672 What: /sys/class/hwmon/hwmonX/curr_reset_history
673 Description: 673 Description:
674 Reset currX_lowest and currX_h 674 Reset currX_lowest and currX_highest for all sensors
675 675
676 WO 676 WO
677 677
678 What: /sys/class/hwmon/hwmonX/currY_ 678 What: /sys/class/hwmon/hwmonX/currY_enable
679 Description: 679 Description:
680 Enable or disable the sensors. 680 Enable or disable the sensors.
681 681
682 When disabled the sensor read 682 When disabled the sensor read will return -ENODATA.
683 683
684 - 1: Enable 684 - 1: Enable
685 - 0: Disable 685 - 0: Disable
686 686
687 RW 687 RW
688 688
689 What: /sys/class/hwmon/hwmonX/currY_ 689 What: /sys/class/hwmon/hwmonX/currY_rated_min
690 Description: 690 Description:
691 Minimum rated current. 691 Minimum rated current.
692 692
693 Unit: milliampere 693 Unit: milliampere
694 694
695 RO 695 RO
696 696
697 What: /sys/class/hwmon/hwmonX/currY_ 697 What: /sys/class/hwmon/hwmonX/currY_rated_max
698 Description: 698 Description:
699 Maximum rated current. 699 Maximum rated current.
700 700
701 Unit: milliampere 701 Unit: milliampere
702 702
703 RO 703 RO
704 704
705 What: /sys/class/hwmon/hwmonX/powerY 705 What: /sys/class/hwmon/hwmonX/powerY_average
706 Description: 706 Description:
707 Average power use 707 Average power use
708 708
709 Unit: microWatt 709 Unit: microWatt
710 710
711 RO 711 RO
712 712
713 What: /sys/class/hwmon/hwmonX/powerY 713 What: /sys/class/hwmon/hwmonX/powerY_average_interval
714 Description: 714 Description:
715 Power use averaging interval. 715 Power use averaging interval. A poll
716 notification is sent to this f 716 notification is sent to this file if the
717 hardware changes the averaging 717 hardware changes the averaging interval.
718 718
719 Unit: milliseconds 719 Unit: milliseconds
720 720
721 RW 721 RW
722 722
723 What: /sys/class/hwmon/hwmonX/powerY 723 What: /sys/class/hwmon/hwmonX/powerY_average_interval_max
724 Description: 724 Description:
725 Maximum power use averaging in 725 Maximum power use averaging interval
726 726
727 Unit: milliseconds 727 Unit: milliseconds
728 728
729 RO 729 RO
730 730
731 What: /sys/class/hwmon/hwmonX/powerY 731 What: /sys/class/hwmon/hwmonX/powerY_average_interval_min
732 Description: 732 Description:
733 Minimum power use averaging in 733 Minimum power use averaging interval
734 734
735 Unit: milliseconds 735 Unit: milliseconds
736 736
737 RO 737 RO
738 738
739 What: /sys/class/hwmon/hwmonX/powerY 739 What: /sys/class/hwmon/hwmonX/powerY_average_highest
740 Description: 740 Description:
741 Historical average maximum pow 741 Historical average maximum power use
742 742
743 Unit: microWatt 743 Unit: microWatt
744 744
745 RO 745 RO
746 746
747 What: /sys/class/hwmon/hwmonX/powerY 747 What: /sys/class/hwmon/hwmonX/powerY_average_lowest
748 Description: 748 Description:
749 Historical average minimum pow 749 Historical average minimum power use
750 750
751 Unit: microWatt 751 Unit: microWatt
752 752
753 RO 753 RO
754 754
755 What: /sys/class/hwmon/hwmonX/powerY 755 What: /sys/class/hwmon/hwmonX/powerY_average_max
756 Description: 756 Description:
757 A poll notification is sent to 757 A poll notification is sent to
758 `powerY_average` when power us 758 `powerY_average` when power use
759 rises above this value. 759 rises above this value.
760 760
761 Unit: microWatt 761 Unit: microWatt
762 762
763 RW 763 RW
764 764
765 What: /sys/class/hwmon/hwmonX/powerY 765 What: /sys/class/hwmon/hwmonX/powerY_average_min
766 Description: 766 Description:
767 A poll notification is sent to 767 A poll notification is sent to
768 `powerY_average` when power us 768 `powerY_average` when power use
769 sinks below this value. 769 sinks below this value.
770 770
771 Unit: microWatt 771 Unit: microWatt
772 772
773 RW 773 RW
774 774
775 What: /sys/class/hwmon/hwmonX/powerY 775 What: /sys/class/hwmon/hwmonX/powerY_input
776 Description: 776 Description:
777 Instantaneous power use 777 Instantaneous power use
778 778
779 Unit: microWatt 779 Unit: microWatt
780 780
781 RO 781 RO
782 782
783 What: /sys/class/hwmon/hwmonX/powerY 783 What: /sys/class/hwmon/hwmonX/powerY_input_highest
784 Description: 784 Description:
785 Historical maximum power use 785 Historical maximum power use
786 786
787 Unit: microWatt 787 Unit: microWatt
788 788
789 RO 789 RO
790 790
791 What: /sys/class/hwmon/hwmonX/powerY 791 What: /sys/class/hwmon/hwmonX/powerY_input_lowest
792 Description: 792 Description:
793 Historical minimum power use 793 Historical minimum power use
794 794
795 Unit: microWatt 795 Unit: microWatt
796 796
797 RO 797 RO
798 798
799 What: /sys/class/hwmon/hwmonX/powerY 799 What: /sys/class/hwmon/hwmonX/powerY_reset_history
800 Description: 800 Description:
801 Reset input_highest, input_low 801 Reset input_highest, input_lowest,
802 average_highest and average_lo 802 average_highest and average_lowest.
803 803
804 WO 804 WO
805 805
806 What: /sys/class/hwmon/hwmonX/powerY 806 What: /sys/class/hwmon/hwmonX/powerY_accuracy
807 Description: 807 Description:
808 Accuracy of the power meter. 808 Accuracy of the power meter.
809 809
810 Unit: Percent 810 Unit: Percent
811 811
812 RO 812 RO
813 813
814 What: /sys/class/hwmon/hwmonX/powerY 814 What: /sys/class/hwmon/hwmonX/powerY_cap
815 Description: 815 Description:
816 If power use rises above this 816 If power use rises above this limit, the
817 system should take action to r 817 system should take action to reduce power use.
818 A poll notification is sent to 818 A poll notification is sent to this file if the
819 cap is changed by the hardware 819 cap is changed by the hardware. The `*_cap`
820 files only appear if the cap i 820 files only appear if the cap is known to be
821 enforced by hardware. 821 enforced by hardware.
822 822
823 Unit: microWatt 823 Unit: microWatt
824 824
825 RW 825 RW
826 826
827 What: /sys/class/hwmon/hwmonX/powerY 827 What: /sys/class/hwmon/hwmonX/powerY_cap_hyst
828 Description: 828 Description:
829 Margin of hysteresis built aro 829 Margin of hysteresis built around capping and
830 notification. 830 notification.
831 831
832 Unit: microWatt 832 Unit: microWatt
833 833
834 RW 834 RW
835 835
836 What: /sys/class/hwmon/hwmonX/powerY 836 What: /sys/class/hwmon/hwmonX/powerY_cap_max
837 Description: 837 Description:
838 Maximum cap that can be set. 838 Maximum cap that can be set.
839 839
840 Unit: microWatt 840 Unit: microWatt
841 841
842 RO 842 RO
843 843
844 What: /sys/class/hwmon/hwmonX/powerY 844 What: /sys/class/hwmon/hwmonX/powerY_cap_min
845 Description: 845 Description:
846 Minimum cap that can be set. 846 Minimum cap that can be set.
847 847
848 Unit: microWatt 848 Unit: microWatt
849 849
850 RO 850 RO
851 851
852 What: /sys/class/hwmon/hwmonX/powerY 852 What: /sys/class/hwmon/hwmonX/powerY_max
853 Description: 853 Description:
854 Maximum power. 854 Maximum power.
855 855
856 Unit: microWatt 856 Unit: microWatt
857 857
858 RW 858 RW
859 859
860 What: /sys/class/hwmon/hwmonX/powerY 860 What: /sys/class/hwmon/hwmonX/powerY_crit
861 Description: 861 Description:
862 Critical maximum power. 862 Critical maximum power.
863 863
864 If power rises to or above thi 864 If power rises to or above this limit, the
865 system is expected take drasti 865 system is expected take drastic action to reduce
866 power consumption, such as a s 866 power consumption, such as a system shutdown or
867 a forced powerdown of some dev 867 a forced powerdown of some devices.
868 868
869 Unit: microWatt 869 Unit: microWatt
870 870
871 RW 871 RW
872 872
873 What: /sys/class/hwmon/hwmonX/powerY 873 What: /sys/class/hwmon/hwmonX/powerY_enable
874 Description: 874 Description:
875 Enable or disable the sensors. 875 Enable or disable the sensors.
876 876
877 When disabled the sensor read 877 When disabled the sensor read will return
878 -ENODATA. 878 -ENODATA.
879 879
880 - 1: Enable 880 - 1: Enable
881 - 0: Disable 881 - 0: Disable
882 882
883 RW 883 RW
884 884
885 What: /sys/class/hwmon/hwmonX/powerY 885 What: /sys/class/hwmon/hwmonX/powerY_rated_min
886 Description: 886 Description:
887 Minimum rated power. 887 Minimum rated power.
888 888
889 Unit: microWatt 889 Unit: microWatt
890 890
891 RO 891 RO
892 892
893 What: /sys/class/hwmon/hwmonX/powerY 893 What: /sys/class/hwmon/hwmonX/powerY_rated_max
894 Description: 894 Description:
895 Maximum rated power. 895 Maximum rated power.
896 896
897 Unit: microWatt 897 Unit: microWatt
898 898
899 RO 899 RO
900 900
901 What: /sys/class/hwmon/hwmonX/energy 901 What: /sys/class/hwmon/hwmonX/energyY_input
902 Description: 902 Description:
903 Cumulative energy use 903 Cumulative energy use
904 904
905 Unit: microJoule 905 Unit: microJoule
906 906
907 RO 907 RO
908 908
909 What: /sys/class/hwmon/hwmonX/energy 909 What: /sys/class/hwmon/hwmonX/energyY_enable
910 Description: 910 Description:
911 Enable or disable the sensors. 911 Enable or disable the sensors.
912 912
913 When disabled the sensor read 913 When disabled the sensor read will return
914 -ENODATA. 914 -ENODATA.
915 915
916 - 1: Enable 916 - 1: Enable
917 - 0: Disable 917 - 0: Disable
918 918
919 RW 919 RW
920 920
921 What: /sys/class/hwmon/hwmonX/humidi 921 What: /sys/class/hwmon/hwmonX/humidityY_alarm
922 Description: 922 Description:
923 Humidity limit detection 923 Humidity limit detection
924 924
925 - 0: OK 925 - 0: OK
926 - 1: Humidity limit has been r 926 - 1: Humidity limit has been reached
927 927
928 RO 928 RO
929 929
930 What: /sys/class/hwmon/hwmonX/humidi 930 What: /sys/class/hwmon/hwmonX/humidityY_enable
931 Description: 931 Description:
932 Enable or disable the sensors 932 Enable or disable the sensors
933 933
934 When disabled the sensor read 934 When disabled the sensor read will return
935 -ENODATA. 935 -ENODATA.
936 936
937 - 1: Enable 937 - 1: Enable
938 - 0: Disable 938 - 0: Disable
939 939
940 RW 940 RW
941 941
942 What: /sys/class/hwmon/hwmonX/humidi 942 What: /sys/class/hwmon/hwmonX/humidityY_fault
943 Description: 943 Description:
944 Reports a humidity sensor fail 944 Reports a humidity sensor failure.
945 945
946 - 1: Failed 946 - 1: Failed
947 - 0: Ok 947 - 0: Ok
948 948
949 RO 949 RO
950 950
951 What: /sys/class/hwmon/hwmonX/humidi 951 What: /sys/class/hwmon/hwmonX/humidityY_input
952 Description: 952 Description:
953 Humidity 953 Humidity
954 954
955 Unit: milli-percent (per cent 955 Unit: milli-percent (per cent mille, pcm)
956 956
957 RO 957 RO
958 958
959 What: /sys/class/hwmon/hwmonX/humidi 959 What: /sys/class/hwmon/hwmonX/humidityY_label
960 Description: 960 Description:
961 Suggested humidity channel lab 961 Suggested humidity channel label.
962 962
963 Text string 963 Text string
964 964
965 Should only be created if the 965 Should only be created if the driver has hints about what
966 this humidity channel is being 966 this humidity channel is being used for, and user-space
967 doesn't. In all other cases, t 967 doesn't. In all other cases, the label is provided by
968 user-space. 968 user-space.
969 969
970 RO 970 RO
971 971
972 What: /sys/class/hwmon/hwmonX/humidi 972 What: /sys/class/hwmon/hwmonX/humidityY_max
973 Description: 973 Description:
974 Humidity max value. 974 Humidity max value.
975 975
976 Unit: milli-percent (per cent 976 Unit: milli-percent (per cent mille, pcm)
977 977
978 RW 978 RW
979 979
980 What: /sys/class/hwmon/hwmonX/humidi 980 What: /sys/class/hwmon/hwmonX/humidityY_max_alarm
981 Description: 981 Description:
982 Maximum humidity detection 982 Maximum humidity detection
983 983
984 - 0: OK 984 - 0: OK
985 - 1: Maximum humidity detected 985 - 1: Maximum humidity detected
986 986
987 RO 987 RO
988 988
989 What: /sys/class/hwmon/hwmonX/humidi 989 What: /sys/class/hwmon/hwmonX/humidityY_max_hyst
990 Description: 990 Description:
991 Humidity hysteresis value for 991 Humidity hysteresis value for max limit.
992 992
993 Unit: milli-percent (per cent 993 Unit: milli-percent (per cent mille, pcm)
994 994
995 Must be reported as an absolut 995 Must be reported as an absolute humidity, NOT a delta
996 from the max value. 996 from the max value.
997 997
998 RW 998 RW
999 999
1000 What: /sys/class/hwmon/hwmonX/humid 1000 What: /sys/class/hwmon/hwmonX/humidityY_min
1001 Description: 1001 Description:
1002 Humidity min value. 1002 Humidity min value.
1003 1003
1004 Unit: milli-percent (per cent 1004 Unit: milli-percent (per cent mille, pcm)
1005 1005
1006 RW 1006 RW
1007 1007
1008 What: /sys/class/hwmon/hwmonX/humid 1008 What: /sys/class/hwmon/hwmonX/humidityY_min_alarm
1009 Description: 1009 Description:
1010 Minimum humidity detection 1010 Minimum humidity detection
1011 1011
1012 - 0: OK 1012 - 0: OK
1013 - 1: Minimum humidity detecte 1013 - 1: Minimum humidity detected
1014 1014
1015 RO 1015 RO
1016 1016
1017 What: /sys/class/hwmon/hwmonX/humid 1017 What: /sys/class/hwmon/hwmonX/humidityY_min_hyst
1018 Description: 1018 Description:
1019 Humidity hysteresis value for 1019 Humidity hysteresis value for min limit.
1020 1020
1021 Unit: milli-percent (per cent 1021 Unit: milli-percent (per cent mille, pcm)
1022 1022
1023 Must be reported as an absolu 1023 Must be reported as an absolute humidity, NOT a delta
1024 from the min value. 1024 from the min value.
1025 1025
1026 RW 1026 RW
1027 1027
1028 What: /sys/class/hwmon/hwmonX/humid 1028 What: /sys/class/hwmon/hwmonX/humidityY_rated_min
1029 Description: 1029 Description:
1030 Minimum rated humidity. 1030 Minimum rated humidity.
1031 1031
1032 Unit: milli-percent (per cent 1032 Unit: milli-percent (per cent mille, pcm)
1033 1033
1034 RO 1034 RO
1035 1035
1036 What: /sys/class/hwmon/hwmonX/humid 1036 What: /sys/class/hwmon/hwmonX/humidityY_rated_max
1037 Description: 1037 Description:
1038 Maximum rated humidity. 1038 Maximum rated humidity.
1039 1039
1040 Unit: milli-percent (per cent 1040 Unit: milli-percent (per cent mille, pcm)
1041 1041
1042 RO 1042 RO
1043 1043
1044 1044
1045 What: /sys/class/hwmon/hwmonX/intru 1045 What: /sys/class/hwmon/hwmonX/intrusionY_alarm
1046 Description: 1046 Description:
1047 Chassis intrusion detection 1047 Chassis intrusion detection
1048 1048
1049 - 0: OK 1049 - 0: OK
1050 - 1: intrusion detected 1050 - 1: intrusion detected
1051 1051
1052 RW 1052 RW
1053 1053
1054 Contrary to regular alarm fla 1054 Contrary to regular alarm flags which clear themselves
1055 automatically when read, this 1055 automatically when read, this one sticks until cleared by
1056 the user. This is done by wri 1056 the user. This is done by writing 0 to the file. Writing
1057 other values is unsupported. 1057 other values is unsupported.
1058 1058
1059 What: /sys/class/hwmon/hwmonX/intru 1059 What: /sys/class/hwmon/hwmonX/intrusionY_beep
1060 Description: 1060 Description:
1061 Chassis intrusion beep 1061 Chassis intrusion beep
1062 1062
1063 - 0: disable 1063 - 0: disable
1064 - 1: enable 1064 - 1: enable
1065 1065
1066 RW 1066 RW
1067 1067
1068 What: /sys/class/hwmon/hwmonX/devic 1068 What: /sys/class/hwmon/hwmonX/device/pec
1069 Description: 1069 Description:
1070 PEC support on I2C devices 1070 PEC support on I2C devices
1071 1071
1072 - 0, off, n: disable 1072 - 0, off, n: disable
1073 - 1, on, y: enable 1073 - 1, on, y: enable
1074 1074
1075 RW 1075 RW
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.