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