1 What: /sys/class/hwmon/hwmonX/name
4 This should be a short, lowercase string, not containing
5 whitespace, dashes, or the wildcard character '*'.
6 This attribute represents the chip name. It is the only
8 I2C devices get this attribute created automatically.
12 What: /sys/class/hwmon/hwmonX/label
14 A descriptive label that allows to uniquely identify a
15 device within the system.
16 The contents of the label are free-form.
20 What: /sys/class/hwmon/hwmonX/update_interval
22 The interval at which the chip will update readings.
27 Some devices have a variable update rate or interval.
28 This attribute can be used to change it to the desired value.
30 What: /sys/class/hwmon/hwmonX/inY_min
38 What: /sys/class/hwmon/hwmonX/inY_lcrit
40 Voltage critical min value.
46 If voltage drops to or below this limit, the system may
47 take drastic action such as power down or reset. At the very
48 least, it should report a fault.
50 What: /sys/class/hwmon/hwmonX/inY_max
58 What: /sys/class/hwmon/hwmonX/inY_crit
60 Voltage critical max value.
66 If voltage reaches or exceeds this limit, the system may
67 take drastic action such as power down or reset. At the very
68 least, it should report a fault.
70 What: /sys/class/hwmon/hwmonX/inY_input
78 Voltage measured on the chip pin.
80 Actual voltage depends on the scaling resistors on the
81 motherboard, as recommended in the chip datasheet.
83 This varies by chip and by motherboard.
84 Because of this variation, values are generally NOT scaled
85 by the chip driver, and must be done by the application.
86 However, some drivers (notably lm87 and via686a)
87 do scale, because of internal resistors built into a chip.
88 These drivers will output the actual voltage. Rule of
89 thumb: drivers should report the voltage values at the
92 What: /sys/class/hwmon/hwmonX/inY_average
100 What: /sys/class/hwmon/hwmonX/inY_lowest
102 Historical minimum voltage
108 What: /sys/class/hwmon/hwmonX/inY_highest
110 Historical maximum voltage
116 What: /sys/class/hwmon/hwmonX/inY_reset_history
118 Reset inX_lowest and inX_highest
122 What: /sys/class/hwmon/hwmonX/in_reset_history
124 Reset inX_lowest and inX_highest for all sensors
128 What: /sys/class/hwmon/hwmonX/inY_label
130 Suggested voltage channel label.
134 Should only be created if the driver has hints about what
135 this voltage channel is being used for, and user-space
136 doesn't. In all other cases, the label is provided by
141 What: /sys/class/hwmon/hwmonX/inY_enable
143 Enable or disable the sensors.
145 When disabled the sensor read will return -ENODATA.
152 What: /sys/class/hwmon/hwmonX/inY_fault
154 Reports a voltage hard failure (eg: shorted component)
161 What: /sys/class/hwmon/hwmonX/cpuY_vid
163 CPU core reference voltage.
171 What: /sys/class/hwmon/hwmonX/vrm
173 Voltage Regulator Module version number.
175 RW (but changing it should no more be necessary)
177 Originally the VRM standard version multiplied by 10, but now
178 an arbitrary number, as not all standards have a version
181 Affects the way the driver calculates the CPU core reference
182 voltage from the vid pins.
184 What: /sys/class/hwmon/hwmonX/inY_rated_min
186 Minimum rated voltage.
192 What: /sys/class/hwmon/hwmonX/inY_rated_max
194 Maximum rated voltage.
200 What: /sys/class/hwmon/hwmonX/fanY_min
204 Unit: revolution/min (RPM)
208 What: /sys/class/hwmon/hwmonX/fanY_max
212 Unit: revolution/min (RPM)
214 Only rarely supported by the hardware.
217 What: /sys/class/hwmon/hwmonX/fanY_input
221 Unit: revolution/min (RPM)
225 What: /sys/class/hwmon/hwmonX/fanY_div
229 Integer value in powers of two (1, 2, 4, 8, 16, 32, 64, 128).
233 Some chips only support values 1, 2, 4 and 8.
234 Note that this is actually an internal clock divisor, which
235 affects the measurable speed range, not the read value.
237 What: /sys/class/hwmon/hwmonX/fanY_pulses
239 Number of tachometer pulses per fan revolution.
241 Integer value, typically between 1 and 4.
245 This value is a characteristic of the fan connected to the
246 device's input, so it has to be set in accordance with the fan
249 Should only be created if the chip has a register to configure
250 the number of pulses. In the absence of such a register (and
251 thus attribute) the value assumed by all devices is 2 pulses
254 What: /sys/class/hwmon/hwmonX/fanY_target
258 Unit: revolution/min (RPM)
262 Only makes sense if the chip supports closed-loop fan speed
263 control based on the measured fan speed.
265 What: /sys/class/hwmon/hwmonX/fanY_label
267 Suggested fan channel label.
271 Should only be created if the driver has hints about what
272 this fan channel is being used for, and user-space doesn't.
273 In all other cases, the label is provided by user-space.
277 What: /sys/class/hwmon/hwmonX/fanY_enable
279 Enable or disable the sensors.
281 When disabled the sensor read will return -ENODATA.
288 What: /sys/class/hwmon/hwmonX/fanY_fault
290 Reports if a fan has reported failure.
297 What: /sys/class/hwmon/hwmonX/pwmY
299 Pulse width modulation fan control.
301 Integer value in the range 0 to 255
307 What: /sys/class/hwmon/hwmonX/pwmY_enable
309 Fan speed control method:
311 - 0: no fan speed control (i.e. fan at full speed)
312 - 1: manual fan speed control enabled (using `pwmY`)
313 - 2+: automatic fan speed control enabled
315 Check individual chip documentation files for automatic mode
320 What: /sys/class/hwmon/hwmonX/pwmY_mode
322 - 0: DC mode (direct current)
323 - 1: PWM mode (pulse-width modulation)
327 What: /sys/class/hwmon/hwmonX/pwmY_freq
329 Base PWM frequency in Hz.
331 Only possibly available when pwmN_mode is PWM, but not always
336 What: /sys/class/hwmon/hwmonX/pwmY_auto_channels_temp
338 Select which temperature channels affect this PWM output in
341 Bitfield, 1 is temp1, 2 is temp2, 4 is temp3 etc...
342 Which values are possible depend on the chip used.
346 What: /sys/class/hwmon/hwmonX/pwmY_auto_pointZ_pwm
347 What: /sys/class/hwmon/hwmonX/pwmY_auto_pointZ_temp
348 What: /sys/class/hwmon/hwmonX/pwmY_auto_pointZ_temp_hyst
350 Define the PWM vs temperature curve.
352 Number of trip points is chip-dependent. Use this for chips
353 which associate trip points to PWM output channels.
357 What: /sys/class/hwmon/hwmonX/tempY_auto_pointZ_pwm
358 What: /sys/class/hwmon/hwmonX/tempY_auto_pointZ_temp
359 What: /sys/class/hwmon/hwmonX/tempY_auto_pointZ_temp_hyst
361 Define the PWM vs temperature curve.
363 Number of trip points is chip-dependent. Use this for chips
364 which associate trip points to temperature channels.
368 What: /sys/class/hwmon/hwmonX/tempY_type
370 Sensor type selection.
376 - 1: CPU embedded diode
383 Not all types are supported by all chips
385 What: /sys/class/hwmon/hwmonX/tempY_max
387 Temperature max value.
389 Unit: millidegree Celsius (or millivolt, see below)
393 What: /sys/class/hwmon/hwmonX/tempY_max_alarm
395 Maximum temperature alarm flag.
398 - 1: temperature has reached tempY_max
402 What: /sys/class/hwmon/hwmonX/tempY_min
404 Temperature min value.
406 Unit: millidegree Celsius
410 What: /sys/class/hwmon/hwmonX/tempY_min_alarm
412 Minimum temperature alarm flag.
415 - 1: temperature has reached tempY_min
419 What: /sys/class/hwmon/hwmonX/tempY_max_hyst
421 Temperature hysteresis value for max limit.
423 Unit: millidegree Celsius
425 Must be reported as an absolute temperature, NOT a delta
430 What: /sys/class/hwmon/hwmonX/tempY_min_hyst
432 Temperature hysteresis value for min limit.
433 Unit: millidegree Celsius
435 Must be reported as an absolute temperature, NOT a delta
440 What: /sys/class/hwmon/hwmonX/tempY_input
442 Temperature input value.
444 Unit: millidegree Celsius
448 What: /sys/class/hwmon/hwmonX/tempY_crit
450 Temperature critical max value, typically greater than
451 corresponding temp_max values.
453 Unit: millidegree Celsius
457 What: /sys/class/hwmon/hwmonX/tempY_crit_alarm
459 Critical high temperature alarm flag.
462 - 1: temperature has reached tempY_crit
466 What: /sys/class/hwmon/hwmonX/tempY_crit_hyst
468 Temperature hysteresis value for critical limit.
470 Unit: millidegree Celsius
472 Must be reported as an absolute temperature, NOT a delta
473 from the critical value.
477 What: /sys/class/hwmon/hwmonX/tempY_emergency
479 Temperature emergency max value, for chips supporting more than
480 two upper temperature limits. Must be equal or greater than
481 corresponding temp_crit values.
483 Unit: millidegree Celsius
487 What: /sys/class/hwmon/hwmonX/tempY_emergency_alarm
489 Emergency high temperature alarm flag.
492 - 1: temperature has reached tempY_emergency
496 What: /sys/class/hwmon/hwmonX/tempY_emergency_hyst
498 Temperature hysteresis value for emergency limit.
500 Unit: millidegree Celsius
502 Must be reported as an absolute temperature, NOT a delta
503 from the emergency value.
507 What: /sys/class/hwmon/hwmonX/tempY_lcrit
509 Temperature critical min value, typically lower than
510 corresponding temp_min values.
512 Unit: millidegree Celsius
516 What: /sys/class/hwmon/hwmonX/tempY_lcrit_hyst
518 Temperature hysteresis value for critical min limit.
520 Unit: millidegree Celsius
522 Must be reported as an absolute temperature, NOT a delta
523 from the critical min value.
527 What: /sys/class/hwmon/hwmonX/tempY_offset
529 Temperature offset which is added to the temperature reading
532 Unit: millidegree Celsius
536 What: /sys/class/hwmon/hwmonX/tempY_label
538 Suggested temperature channel label.
542 Should only be created if the driver has hints about what
543 this temperature channel is being used for, and user-space
544 doesn't. In all other cases, the label is provided by
549 What: /sys/class/hwmon/hwmonX/tempY_lowest
551 Historical minimum temperature
553 Unit: millidegree Celsius
557 What: /sys/class/hwmon/hwmonX/tempY_highest
559 Historical maximum temperature
561 Unit: millidegree Celsius
565 What: /sys/class/hwmon/hwmonX/tempY_reset_history
567 Reset temp_lowest and temp_highest
571 What: /sys/class/hwmon/hwmonX/temp_reset_history
573 Reset temp_lowest and temp_highest for all sensors
577 What: /sys/class/hwmon/hwmonX/tempY_enable
579 Enable or disable the sensors.
581 When disabled the sensor read will return -ENODATA.
588 What: /sys/class/hwmon/hwmonX/tempY_rated_min
590 Minimum rated temperature.
592 Unit: millidegree Celsius
596 What: /sys/class/hwmon/hwmonX/tempY_rated_max
598 Maximum rated temperature.
600 Unit: millidegree Celsius
604 What: /sys/class/hwmon/hwmonX/currY_max
612 What: /sys/class/hwmon/hwmonX/currY_min
620 What: /sys/class/hwmon/hwmonX/currY_lcrit
622 Current critical low value
628 What: /sys/class/hwmon/hwmonX/currY_crit
630 Current critical high value.
636 What: /sys/class/hwmon/hwmonX/currY_input
644 What: /sys/class/hwmon/hwmonX/currY_average
652 What: /sys/class/hwmon/hwmonX/currY_lowest
654 Historical minimum current
660 What: /sys/class/hwmon/hwmonX/currY_highest
662 Historical maximum current
666 What: /sys/class/hwmon/hwmonX/currY_reset_history
668 Reset currX_lowest and currX_highest
672 What: /sys/class/hwmon/hwmonX/curr_reset_history
674 Reset currX_lowest and currX_highest for all sensors
678 What: /sys/class/hwmon/hwmonX/currY_enable
680 Enable or disable the sensors.
682 When disabled the sensor read will return -ENODATA.
689 What: /sys/class/hwmon/hwmonX/currY_rated_min
691 Minimum rated current.
697 What: /sys/class/hwmon/hwmonX/currY_rated_max
699 Maximum rated current.
705 What: /sys/class/hwmon/hwmonX/powerY_average
713 What: /sys/class/hwmon/hwmonX/powerY_average_interval
715 Power use averaging interval. A poll
716 notification is sent to this file if the
717 hardware changes the averaging interval.
723 What: /sys/class/hwmon/hwmonX/powerY_average_interval_max
725 Maximum power use averaging interval
731 What: /sys/class/hwmon/hwmonX/powerY_average_interval_min
733 Minimum power use averaging interval
739 What: /sys/class/hwmon/hwmonX/powerY_average_highest
741 Historical average maximum power use
747 What: /sys/class/hwmon/hwmonX/powerY_average_lowest
749 Historical average minimum power use
755 What: /sys/class/hwmon/hwmonX/powerY_average_max
757 A poll notification is sent to
758 `powerY_average` when power use
759 rises above this value.
765 What: /sys/class/hwmon/hwmonX/powerY_average_min
767 A poll notification is sent to
768 `powerY_average` when power use
769 sinks below this value.
775 What: /sys/class/hwmon/hwmonX/powerY_input
777 Instantaneous power use
783 What: /sys/class/hwmon/hwmonX/powerY_input_highest
785 Historical maximum power use
791 What: /sys/class/hwmon/hwmonX/powerY_input_lowest
793 Historical minimum power use
799 What: /sys/class/hwmon/hwmonX/powerY_reset_history
801 Reset input_highest, input_lowest,
802 average_highest and average_lowest.
806 What: /sys/class/hwmon/hwmonX/powerY_accuracy
808 Accuracy of the power meter.
814 What: /sys/class/hwmon/hwmonX/powerY_cap
816 If power use rises above this limit, the
817 system should take action to reduce power use.
818 A poll notification is sent to this file if the
819 cap is changed by the hardware. The `*_cap`
820 files only appear if the cap is known to be
821 enforced by hardware.
827 What: /sys/class/hwmon/hwmonX/powerY_cap_hyst
829 Margin of hysteresis built around capping and
836 What: /sys/class/hwmon/hwmonX/powerY_cap_max
838 Maximum cap that can be set.
844 What: /sys/class/hwmon/hwmonX/powerY_cap_min
846 Minimum cap that can be set.
852 What: /sys/class/hwmon/hwmonX/powerY_max
860 What: /sys/class/hwmon/hwmonX/powerY_crit
862 Critical maximum power.
864 If power rises to or above this limit, the
865 system is expected take drastic action to reduce
866 power consumption, such as a system shutdown or
867 a forced powerdown of some devices.
873 What: /sys/class/hwmon/hwmonX/powerY_enable
875 Enable or disable the sensors.
877 When disabled the sensor read will return
885 What: /sys/class/hwmon/hwmonX/powerY_rated_min
893 What: /sys/class/hwmon/hwmonX/powerY_rated_max
901 What: /sys/class/hwmon/hwmonX/energyY_input
903 Cumulative energy use
909 What: /sys/class/hwmon/hwmonX/energyY_enable
911 Enable or disable the sensors.
913 When disabled the sensor read will return
921 What: /sys/class/hwmon/hwmonX/humidityY_alarm
923 Humidity limit detection
926 - 1: Humidity limit has been reached
930 What: /sys/class/hwmon/hwmonX/humidityY_enable
932 Enable or disable the sensors
934 When disabled the sensor read will return
942 What: /sys/class/hwmon/hwmonX/humidityY_fault
944 Reports a humidity sensor failure.
951 What: /sys/class/hwmon/hwmonX/humidityY_input
955 Unit: milli-percent (per cent mille, pcm)
959 What: /sys/class/hwmon/hwmonX/humidityY_label
961 Suggested humidity channel label.
965 Should only be created if the driver has hints about what
966 this humidity channel is being used for, and user-space
967 doesn't. In all other cases, the label is provided by
972 What: /sys/class/hwmon/hwmonX/humidityY_max
976 Unit: milli-percent (per cent mille, pcm)
980 What: /sys/class/hwmon/hwmonX/humidityY_max_alarm
982 Maximum humidity detection
985 - 1: Maximum humidity detected
989 What: /sys/class/hwmon/hwmonX/humidityY_max_hyst
991 Humidity hysteresis value for max limit.
993 Unit: milli-percent (per cent mille, pcm)
995 Must be reported as an absolute humidity, NOT a delta
1000 What: /sys/class/hwmon/hwmonX/humidityY_min
1004 Unit: milli-percent (per cent mille, pcm)
1008 What: /sys/class/hwmon/hwmonX/humidityY_min_alarm
1010 Minimum humidity detection
1013 - 1: Minimum humidity detected
1017 What: /sys/class/hwmon/hwmonX/humidityY_min_hyst
1019 Humidity hysteresis value for min limit.
1021 Unit: milli-percent (per cent mille, pcm)
1023 Must be reported as an absolute humidity, NOT a delta
1028 What: /sys/class/hwmon/hwmonX/humidityY_rated_min
1030 Minimum rated humidity.
1032 Unit: milli-percent (per cent mille, pcm)
1036 What: /sys/class/hwmon/hwmonX/humidityY_rated_max
1038 Maximum rated humidity.
1040 Unit: milli-percent (per cent mille, pcm)
1045 What: /sys/class/hwmon/hwmonX/intrusionY_alarm
1047 Chassis intrusion detection
1050 - 1: intrusion detected
1054 Contrary to regular alarm flags which clear themselves
1055 automatically when read, this one sticks until cleared by
1056 the user. This is done by writing 0 to the file. Writing
1057 other values is unsupported.
1059 What: /sys/class/hwmon/hwmonX/intrusionY_beep
1061 Chassis intrusion beep
1068 What: /sys/class/hwmon/hwmonX/device/pec
1070 PEC support on I2C devices
1072 - 0, off, n: disable