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