aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/hwmon/sysfs-interface
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/hwmon/sysfs-interface')
-rw-r--r--Documentation/hwmon/sysfs-interface77
1 files changed, 69 insertions, 8 deletions
diff --git a/Documentation/hwmon/sysfs-interface b/Documentation/hwmon/sysfs-interface
index 48ceabedf55d..8f63c244f1aa 100644
--- a/Documentation/hwmon/sysfs-interface
+++ b/Documentation/hwmon/sysfs-interface
@@ -187,6 +187,17 @@ fan[1-*]_div Fan divisor.
187 Note that this is actually an internal clock divisor, which 187 Note that this is actually an internal clock divisor, which
188 affects the measurable speed range, not the read value. 188 affects the measurable speed range, not the read value.
189 189
190fan[1-*]_pulses Number of tachometer pulses per fan revolution.
191 Integer value, typically between 1 and 4.
192 RW
193 This value is a characteristic of the fan connected to the
194 device's input, so it has to be set in accordance with the fan
195 model.
196 Should only be created if the chip has a register to configure
197 the number of pulses. In the absence of such a register (and
198 thus attribute) the value assumed by all devices is 2 pulses
199 per fan revolution.
200
190fan[1-*]_target 201fan[1-*]_target
191 Desired fan speed 202 Desired fan speed
192 Unit: revolution/min (RPM) 203 Unit: revolution/min (RPM)
@@ -309,6 +320,20 @@ temp[1-*]_crit_hyst
309 from the critical value. 320 from the critical value.
310 RW 321 RW
311 322
323temp[1-*]_emergency
324 Temperature emergency max value, for chips supporting more than
325 two upper temperature limits. Must be equal or greater than
326 corresponding temp_crit values.
327 Unit: millidegree Celsius
328 RW
329
330temp[1-*]_emergency_hyst
331 Temperature hysteresis value for emergency limit.
332 Unit: millidegree Celsius
333 Must be reported as an absolute temperature, NOT a delta
334 from the emergency value.
335 RW
336
312temp[1-*]_lcrit Temperature critical min value, typically lower than 337temp[1-*]_lcrit Temperature critical min value, typically lower than
313 corresponding temp_min values. 338 corresponding temp_min values.
314 Unit: millidegree Celsius 339 Unit: millidegree Celsius
@@ -370,10 +395,20 @@ curr[1-*]_min Current min value.
370 Unit: milliampere 395 Unit: milliampere
371 RW 396 RW
372 397
398curr[1-*]_lcrit Current critical low value
399 Unit: milliampere
400 RW
401
402curr[1-*]_crit Current critical high value.
403 Unit: milliampere
404 RW
405
373curr[1-*]_input Current input value 406curr[1-*]_input Current input value
374 Unit: milliampere 407 Unit: milliampere
375 RO 408 RO
376 409
410Also see the Alarms section for status flags associated with currents.
411
377********* 412*********
378* Power * 413* Power *
379********* 414*********
@@ -436,13 +471,6 @@ power[1-*]_accuracy Accuracy of the power meter.
436 Unit: Percent 471 Unit: Percent
437 RO 472 RO
438 473
439power[1-*]_alarm 1 if the system is drawing more power than the
440 cap allows; 0 otherwise. A poll notification is
441 sent to this file when the power use exceeds the
442 cap. This file only appears if the cap is known
443 to be enforced by hardware.
444 RO
445
446power[1-*]_cap If power use rises above this limit, the 474power[1-*]_cap If power use rises above this limit, the
447 system should take action to reduce power use. 475 system should take action to reduce power use.
448 A poll notification is sent to this file if the 476 A poll notification is sent to this file if the
@@ -465,6 +493,20 @@ power[1-*]_cap_min Minimum cap that can be set.
465 Unit: microWatt 493 Unit: microWatt
466 RO 494 RO
467 495
496power[1-*]_max Maximum power.
497 Unit: microWatt
498 RW
499
500power[1-*]_crit Critical maximum power.
501 If power rises to or above this limit, the
502 system is expected take drastic action to reduce
503 power consumption, such as a system shutdown or
504 a forced powerdown of some devices.
505 Unit: microWatt
506 RW
507
508Also see the Alarms section for status flags associated with power readings.
509
468********** 510**********
469* Energy * 511* Energy *
470********** 512**********
@@ -474,6 +516,15 @@ energy[1-*]_input Cumulative energy use
474 RO 516 RO
475 517
476 518
519************
520* Humidity *
521************
522
523humidity[1-*]_input Humidity
524 Unit: milli-percent (per cent mille, pcm)
525 RO
526
527
477********** 528**********
478* Alarms * 529* Alarms *
479********** 530**********
@@ -487,6 +538,7 @@ implementation.
487 538
488in[0-*]_alarm 539in[0-*]_alarm
489curr[1-*]_alarm 540curr[1-*]_alarm
541power[1-*]_alarm
490fan[1-*]_alarm 542fan[1-*]_alarm
491temp[1-*]_alarm 543temp[1-*]_alarm
492 Channel alarm 544 Channel alarm
@@ -498,13 +550,22 @@ OR
498 550
499in[0-*]_min_alarm 551in[0-*]_min_alarm
500in[0-*]_max_alarm 552in[0-*]_max_alarm
553in[0-*]_lcrit_alarm
554in[0-*]_crit_alarm
501curr[1-*]_min_alarm 555curr[1-*]_min_alarm
502curr[1-*]_max_alarm 556curr[1-*]_max_alarm
557curr[1-*]_lcrit_alarm
558curr[1-*]_crit_alarm
559power[1-*]_cap_alarm
560power[1-*]_max_alarm
561power[1-*]_crit_alarm
503fan[1-*]_min_alarm 562fan[1-*]_min_alarm
504fan[1-*]_max_alarm 563fan[1-*]_max_alarm
505temp[1-*]_min_alarm 564temp[1-*]_min_alarm
506temp[1-*]_max_alarm 565temp[1-*]_max_alarm
566temp[1-*]_lcrit_alarm
507temp[1-*]_crit_alarm 567temp[1-*]_crit_alarm
568temp[1-*]_emergency_alarm
508 Limit alarm 569 Limit alarm
509 0: no alarm 570 0: no alarm
510 1: alarm 571 1: alarm
@@ -518,7 +579,7 @@ channel should not be trusted.
518fan[1-*]_fault 579fan[1-*]_fault
519temp[1-*]_fault 580temp[1-*]_fault
520 Input fault condition 581 Input fault condition
521 0: no fault occured 582 0: no fault occurred
522 1: fault condition 583 1: fault condition
523 RO 584 RO
524 585