0001 =====================
0002 Kernel driver nouveau
0003 =====================
0004
0005 Supported chips:
0006
0007 * NV43+
0008
0009 Authors: Martin Peres (mupuf) <martin.peres@free.fr>
0010
0011 Description
0012 -----------
0013
0014 This driver allows to read the GPU core temperature, drive the GPU fan and
0015 set temperature alarms.
0016
0017 Currently, due to the absence of in-kernel API to access HWMON drivers, Nouveau
0018 cannot access any of the i2c external monitoring chips it may find. If you
0019 have one of those, temperature and/or fan management through Nouveau's HWMON
0020 interface is likely not to work. This document may then not cover your situation
0021 entirely.
0022
0023 Temperature management
0024 ----------------------
0025
0026 Temperature is exposed under as a read-only HWMON attribute temp1_input.
0027
0028 In order to protect the GPU from overheating, Nouveau supports 4 configurable
0029 temperature thresholds:
0030
0031 * Fan_boost:
0032 Fan speed is set to 100% when reaching this temperature;
0033 * Downclock:
0034 The GPU will be downclocked to reduce its power dissipation;
0035 * Critical:
0036 The GPU is put on hold to further lower power dissipation;
0037 * Shutdown:
0038 Shut the computer down to protect your GPU.
0039
0040 WARNING:
0041 Some of these thresholds may not be used by Nouveau depending
0042 on your chipset.
0043
0044 The default value for these thresholds comes from the GPU's vbios. These
0045 thresholds can be configured thanks to the following HWMON attributes:
0046
0047 * Fan_boost: temp1_auto_point1_temp and temp1_auto_point1_temp_hyst;
0048 * Downclock: temp1_max and temp1_max_hyst;
0049 * Critical: temp1_crit and temp1_crit_hyst;
0050 * Shutdown: temp1_emergency and temp1_emergency_hyst.
0051
0052 NOTE: Remember that the values are stored as milli degrees Celsius. Don't forget
0053 to multiply!
0054
0055 Fan management
0056 --------------
0057
0058 Not all cards have a drivable fan. If you do, then the following HWMON
0059 attributes should be available:
0060
0061 * pwm1_enable:
0062 Current fan management mode (NONE, MANUAL or AUTO);
0063 * pwm1:
0064 Current PWM value (power percentage);
0065 * pwm1_min:
0066 The minimum PWM speed allowed;
0067 * pwm1_max:
0068 The maximum PWM speed allowed (bypassed when hitting Fan_boost);
0069
0070 You may also have the following attribute:
0071
0072 * fan1_input:
0073 Speed in RPM of your fan.
0074
0075 Your fan can be driven in different modes:
0076
0077 * 0: The fan is left untouched;
0078 * 1: The fan can be driven in manual (use pwm1 to change the speed);
0079 * 2; The fan is driven automatically depending on the temperature.
0080
0081 NOTE:
0082 Be sure to use the manual mode if you want to drive the fan speed manually
0083
0084 NOTE2:
0085 When operating in manual mode outside the vbios-defined
0086 [PWM_min, PWM_max] range, the reported fan speed (RPM) may not be accurate
0087 depending on your hardware.
0088
0089 Bug reports
0090 -----------
0091
0092 Thermal management on Nouveau is new and may not work on all cards. If you have
0093 inquiries, please ping mupuf on IRC (#nouveau, OFTC).
0094
0095 Bug reports should be filled on Freedesktop's bug tracker. Please follow
0096 https://nouveau.freedesktop.org/wiki/Bugs
