Commit | Line | Data |
---|---|---|
041d6246 MP |
1 | Kernel driver nouveau |
2 | =================== | |
3 | ||
4 | Supported chips: | |
5 | * NV43+ | |
6 | ||
0946807a | 7 | Authors: Martin Peres (mupuf) <martin.peres@free.fr> |
041d6246 MP |
8 | |
9 | Description | |
10 | --------- | |
11 | ||
12 | This driver allows to read the GPU core temperature, drive the GPU fan and | |
13 | set temperature alarms. | |
14 | ||
15 | Currently, due to the absence of in-kernel API to access HWMON drivers, Nouveau | |
16 | cannot access any of the i2c external monitoring chips it may find. If you | |
17 | have one of those, temperature and/or fan management through Nouveau's HWMON | |
18 | interface is likely not to work. This document may then not cover your situation | |
19 | entirely. | |
20 | ||
21 | Temperature management | |
22 | -------------------- | |
23 | ||
24 | Temperature is exposed under as a read-only HWMON attribute temp1_input. | |
25 | ||
26 | In order to protect the GPU from overheating, Nouveau supports 4 configurable | |
27 | temperature thresholds: | |
28 | ||
29 | * Fan_boost: Fan speed is set to 100% when reaching this temperature; | |
30 | * Downclock: The GPU will be downclocked to reduce its power dissipation; | |
31 | * Critical: The GPU is put on hold to further lower power dissipation; | |
32 | * Shutdown: Shut the computer down to protect your GPU. | |
33 | ||
34 | WARNING: Some of these thresholds may not be used by Nouveau depending | |
35 | on your chipset. | |
36 | ||
37 | The default value for these thresholds comes from the GPU's vbios. These | |
38 | thresholds can be configured thanks to the following HWMON attributes: | |
39 | ||
40 | * Fan_boost: temp1_auto_point1_temp and temp1_auto_point1_temp_hyst; | |
41 | * Downclock: temp1_max and temp1_max_hyst; | |
42 | * Critical: temp1_crit and temp1_crit_hyst; | |
43 | * Shutdown: temp1_emergency and temp1_emergency_hyst. | |
44 | ||
45 | NOTE: Remember that the values are stored as milli degrees Celcius. Don't forget | |
46 | to multiply! | |
47 | ||
48 | Fan management | |
49 | ------------ | |
50 | ||
51 | Not all cards have a drivable fan. If you do, then the following HWMON | |
52 | attributes should be available: | |
53 | ||
54 | * pwm1_enable: Current fan management mode (NONE, MANUAL or AUTO); | |
55 | * pwm1: Current PWM value (power percentage); | |
56 | * pwm1_min: The minimum PWM speed allowed; | |
57 | * pwm1_max: The maximum PWM speed allowed (bypassed when hitting Fan_boost); | |
58 | ||
59 | You may also have the following attribute: | |
60 | ||
b2c36312 | 61 | * fan1_input: Speed in RPM of your fan. |
041d6246 MP |
62 | |
63 | Your fan can be driven in different modes: | |
64 | ||
65 | * 0: The fan is left untouched; | |
66 | * 1: The fan can be driven in manual (use pwm1 to change the speed); | |
67 | * 2; The fan is driven automatically depending on the temperature. | |
68 | ||
69 | NOTE: Be sure to use the manual mode if you want to drive the fan speed manually | |
70 | ||
0946807a MP |
71 | NOTE2: When operating in manual mode outside the vbios-defined |
72 | [PWM_min, PWM_max] range, the reported fan speed (RPM) may not be accurate | |
73 | depending on your hardware. | |
041d6246 MP |
74 | |
75 | Bug reports | |
76 | --------- | |
77 | ||
78 | Thermal management on Nouveau is new and may not work on all cards. If you have | |
79 | inquiries, please ping mupuf on IRC (#nouveau, freenode). | |
80 | ||
81 | Bug reports should be filled on Freedesktop's bug tracker. Please follow | |
82 | http://nouveau.freedesktop.org/wiki/Bugs |