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