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		RW
438
439		Contrary to regular alarm flags which clear themselves
440		automatically when read, this one sticks until cleared by
441		the user. This is done by writing 0 to the file. Writing
442		other values is unsupported.
443
444What:		/sys/class/hwmon/hwmonX/tempY_crit_hyst
445Description:
446		Temperature hysteresis value for critical limit.
447
448		Unit: millidegree Celsius
449
450		Must be reported as an absolute temperature, NOT a delta
451		from the critical value.
452
453		RW
454
455What:		/sys/class/hwmon/hwmonX/tempY_emergency
456Description:
457		Temperature emergency max value, for chips supporting more than
458		two upper temperature limits. Must be equal or greater than
459		corresponding temp_crit values.
460
461		Unit: millidegree Celsius
462
463		RW
464
465What:		/sys/class/hwmon/hwmonX/tempY_emergency_hyst
466Description:
467		Temperature hysteresis value for emergency limit.
468
469		Unit: millidegree Celsius
470
471		Must be reported as an absolute temperature, NOT a delta
472		from the emergency value.
473
474		RW
475
476What:		/sys/class/hwmon/hwmonX/tempY_lcrit
477Description:
478		Temperature critical min value, typically lower than
479		corresponding temp_min values.
480
481		Unit: millidegree Celsius
482
483		RW
484
485What:		/sys/class/hwmon/hwmonX/tempY_lcrit_hyst
486Description:
487		Temperature hysteresis value for critical min limit.
488
489		Unit: millidegree Celsius
490
491		Must be reported as an absolute temperature, NOT a delta
492		from the critical min value.
493
494		RW
495
496What:		/sys/class/hwmon/hwmonX/tempY_offset
497Description:
498		Temperature offset which is added to the temperature reading
499		by the chip.
500
501		Unit: millidegree Celsius
502
503		Read/Write value.
504
505What:		/sys/class/hwmon/hwmonX/tempY_label
506Description:
507		Suggested temperature channel label.
508
509		Text string
510
511		Should only be created if the driver has hints about what
512		this temperature channel is being used for, and user-space
513		doesn't. In all other cases, the label is provided by
514		user-space.
515
516		RO
517
518What:		/sys/class/hwmon/hwmonX/tempY_lowest
519Description:
520		Historical minimum temperature
521
522		Unit: millidegree Celsius
523
524		RO
525
526What:		/sys/class/hwmon/hwmonX/tempY_highest
527Description:
528		Historical maximum temperature
529
530		Unit: millidegree Celsius
531
532		RO
533
534What:		/sys/class/hwmon/hwmonX/tempY_reset_history
535Description:
536		Reset temp_lowest and temp_highest
537
538		WO
539
540What:		/sys/class/hwmon/hwmonX/temp_reset_history
541Description:
542		Reset temp_lowest and temp_highest for all sensors
543
544		WO
545
546What:		/sys/class/hwmon/hwmonX/tempY_enable
547Description:
548		Enable or disable the sensors.
549
550		When disabled the sensor read will return -ENODATA.
551
552		- 1: Enable
553		- 0: Disable
554
555		RW
556
557What:		/sys/class/hwmon/hwmonX/tempY_rated_min
558Description:
559		Minimum rated temperature.
560
561		Unit: millidegree Celsius
562
563		RO
564
565What:		/sys/class/hwmon/hwmonX/tempY_rated_max
566Description:
567		Maximum rated temperature.
568
569		Unit: millidegree Celsius
570
571		RO
572
573What:		/sys/class/hwmon/hwmonX/currY_max
574Description:
575		Current max value
576
577		Unit: milliampere
578
579		RW
580
581What:		/sys/class/hwmon/hwmonX/currY_min
582Description:
583		Current min value.
584
585		Unit: milliampere
586
587		RW
588
589What:		/sys/class/hwmon/hwmonX/currY_lcrit
590Description:
591		Current critical low value
592
593		Unit: milliampere
594
595		RW
596
597What:		/sys/class/hwmon/hwmonX/currY_crit
598Description:
599		Current critical high value.
600
601		Unit: milliampere
602
603		RW
604
605What:		/sys/class/hwmon/hwmonX/currY_input
606Description:
607		Current input value
608
609		Unit: milliampere
610
611		RO
612
613What:		/sys/class/hwmon/hwmonX/currY_average
614Description:
615		Average current use
616
617		Unit: milliampere
618
619		RO
620
621What:		/sys/class/hwmon/hwmonX/currY_lowest
622Description:
623		Historical minimum current
624
625		Unit: milliampere
626
627		RO
628
629What:		/sys/class/hwmon/hwmonX/currY_highest
630Description:
631		Historical maximum current
632		Unit: milliampere
633		RO
634
635What:		/sys/class/hwmon/hwmonX/currY_reset_history
636Description:
637		Reset currX_lowest and currX_highest
638
639		WO
640
641What:		/sys/class/hwmon/hwmonX/curr_reset_history
642Description:
643		Reset currX_lowest and currX_highest for all sensors
644
645		WO
646
647What:		/sys/class/hwmon/hwmonX/currY_enable
648Description:
649		Enable or disable the sensors.
650
651		When disabled the sensor read will return -ENODATA.
652
653		- 1: Enable
654		- 0: Disable
655
656		RW
657
658What:		/sys/class/hwmon/hwmonX/currY_rated_min
659Description:
660		Minimum rated current.
661
662		Unit: milliampere
663
664		RO
665
666What:		/sys/class/hwmon/hwmonX/currY_rated_max
667Description:
668		Maximum rated current.
669
670		Unit: milliampere
671
672		RO
673
674What:		/sys/class/hwmon/hwmonX/powerY_average
675Description:
676		Average power use
677
678		Unit: microWatt
679
680		RO
681
682What:		/sys/class/hwmon/hwmonX/powerY_average_interval
683Description:
684		Power use averaging interval.  A poll
685		notification is sent to this file if the
686		hardware changes the averaging interval.
687
688		Unit: milliseconds
689
690		RW
691
692What:		/sys/class/hwmon/hwmonX/powerY_average_interval_max
693Description:
694		Maximum power use averaging interval
695
696		Unit: milliseconds
697
698		RO
699
700What:		/sys/class/hwmon/hwmonX/powerY_average_interval_min
701Description:
702		Minimum power use averaging interval
703
704		Unit: milliseconds
705
706		RO
707
708What:		/sys/class/hwmon/hwmonX/powerY_average_highest
709Description:
710		Historical average maximum power use
711
712		Unit: microWatt
713
714		RO
715
716What:		/sys/class/hwmon/hwmonX/powerY_average_lowest
717Description:
718		Historical average minimum power use
719
720		Unit: microWatt
721
722		RO
723
724What:		/sys/class/hwmon/hwmonX/powerY_average_max
725Description:
726		A poll notification is sent to
727		`powerY_average` when power use
728		rises above this value.
729
730		Unit: microWatt
731
732		RW
733
734What:		/sys/class/hwmon/hwmonX/powerY_average_min
735Description:
736		A poll notification is sent to
737		`powerY_average` when power use
738		sinks below this value.
739
740		Unit: microWatt
741
742		RW
743
744What:		/sys/class/hwmon/hwmonX/powerY_input
745Description:
746		Instantaneous power use
747
748		Unit: microWatt
749
750		RO
751
752What:		/sys/class/hwmon/hwmonX/powerY_input_highest
753Description:
754		Historical maximum power use
755
756		Unit: microWatt
757
758		RO
759
760What:		/sys/class/hwmon/hwmonX/powerY_input_lowest
761Description:
762		Historical minimum power use
763
764		Unit: microWatt
765
766		RO
767
768What:		/sys/class/hwmon/hwmonX/powerY_reset_history
769Description:
770		Reset input_highest, input_lowest,
771		average_highest and average_lowest.
772
773		WO
774
775What:		/sys/class/hwmon/hwmonX/powerY_accuracy
776Description:
777		Accuracy of the power meter.
778
779		Unit: Percent
780
781		RO
782
783What:		/sys/class/hwmon/hwmonX/powerY_cap
784Description:
785		If power use rises above this limit, the
786		system should take action to reduce power use.
787		A poll notification is sent to this file if the
788		cap is changed by the hardware.  The `*_cap`
789		files only appear if the cap is known to be
790		enforced by hardware.
791
792		Unit: microWatt
793
794		RW
795
796What:		/sys/class/hwmon/hwmonX/powerY_cap_hyst
797Description:
798		Margin of hysteresis built around capping and
799		notification.
800
801		Unit: microWatt
802
803		RW
804
805What:		/sys/class/hwmon/hwmonX/powerY_cap_max
806Description:
807		Maximum cap that can be set.
808
809		Unit: microWatt
810
811		RO
812
813What:		/sys/class/hwmon/hwmonX/powerY_cap_min
814Description:
815		Minimum cap that can be set.
816
817		Unit: microWatt
818
819		RO
820
821What:		/sys/class/hwmon/hwmonX/powerY_max
822Description:
823		Maximum power.
824
825		Unit: microWatt
826
827		RW
828
829What:		/sys/class/hwmon/hwmonX/powerY_crit
830Description:
831		Critical maximum power.
832
833		If power rises to or above this limit, the
834		system is expected take drastic action to reduce
835		power consumption, such as a system shutdown or
836		a forced powerdown of some devices.
837
838		Unit: microWatt
839
840		RW
841
842What:		/sys/class/hwmon/hwmonX/powerY_enable
843Description:
844		Enable or disable the sensors.
845
846		When disabled the sensor read will return
847		-ENODATA.
848
849		- 1: Enable
850		- 0: Disable
851
852		RW
853
854What:		/sys/class/hwmon/hwmonX/powerY_rated_min
855Description:
856		Minimum rated power.
857
858		Unit: microWatt
859
860		RO
861
862What:		/sys/class/hwmon/hwmonX/powerY_rated_max
863Description:
864		Maximum rated power.
865
866		Unit: microWatt
867
868		RO
869
870What:		/sys/class/hwmon/hwmonX/energyY_input
871Description:
872		Cumulative energy use
873
874		Unit: microJoule
875
876		RO
877
878What:		/sys/class/hwmon/hwmonX/energyY_enable
879Description:
880		Enable or disable the sensors.
881
882		When disabled the sensor read will return
883		-ENODATA.
884
885		- 1: Enable
886		- 0: Disable
887
888		RW
889
890What:		/sys/class/hwmon/hwmonX/humidityY_input
891Description:
892		Humidity
893
894		Unit: milli-percent (per cent mille, pcm)
895
896		RO
897
898
899What:		/sys/class/hwmon/hwmonX/humidityY_enable
900Description:
901		Enable or disable the sensors
902
903		When disabled the sensor read will return
904		-ENODATA.
905
906		- 1: Enable
907		- 0: Disable
908
909		RW
910
911What:		/sys/class/hwmon/hwmonX/humidityY_rated_min
912Description:
913		Minimum rated humidity.
914
915		Unit: milli-percent (per cent mille, pcm)
916
917		RO
918
919What:		/sys/class/hwmon/hwmonX/humidityY_rated_max
920Description:
921		Maximum rated humidity.
922
923		Unit: milli-percent (per cent mille, pcm)
924
925		RO
926
927
928What:		/sys/class/hwmon/hwmonX/intrusionY_alarm
929Description:
930		Chassis intrusion detection
931
932		- 0: OK
933		- 1: intrusion detected
934
935		RW
936
937		Contrary to regular alarm flags which clear themselves
938		automatically when read, this one sticks until cleared by
939		the user. This is done by writing 0 to the file. Writing
940		other values is unsupported.
941
942What:		/sys/class/hwmon/hwmonX/intrusionY_beep
943Description:
944		Chassis intrusion beep
945
946		- 0: disable
947		- 1: enable
948
949		RW
950
951What:		/sys/class/hwmon/hwmonX/device/pec
952Description:
953		PEC support on I2C devices
954
955		- 0, off, n: disable
956		- 1, on, y: enable
957
958		RW
959