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