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