blob: 60bc29357ac3537e507a38a1decc92da20b27d2b [file] [log] [blame]
Martin Peres041d6242012-11-20 02:29:22 +01001Kernel driver nouveau
2===================
3
4Supported chips:
5* NV43+
6
Martin Peres09468072014-06-09 20:38:36 +02007Authors: Martin Peres (mupuf) <martin.peres@free.fr>
Martin Peres041d6242012-11-20 02:29:22 +01008
9Description
10---------
11
12This driver allows to read the GPU core temperature, drive the GPU fan and
13set temperature alarms.
14
15Currently, due to the absence of in-kernel API to access HWMON drivers, Nouveau
16cannot access any of the i2c external monitoring chips it may find. If you
17have one of those, temperature and/or fan management through Nouveau's HWMON
18interface is likely not to work. This document may then not cover your situation
19entirely.
20
21Temperature management
22--------------------
23
24Temperature is exposed under as a read-only HWMON attribute temp1_input.
25
26In order to protect the GPU from overheating, Nouveau supports 4 configurable
27temperature 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
34WARNING: Some of these thresholds may not be used by Nouveau depending
35on your chipset.
36
37The default value for these thresholds comes from the GPU's vbios. These
38thresholds 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
45NOTE: Remember that the values are stored as milli degrees Celcius. Don't forget
46to multiply!
47
48Fan management
49------------
50
51Not all cards have a drivable fan. If you do, then the following HWMON
52attributes 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
59You may also have the following attribute:
60
Ben Skeggsb2c36312012-12-06 15:13:06 +100061 * fan1_input: Speed in RPM of your fan.
Martin Peres041d6242012-11-20 02:29:22 +010062
63Your 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
69NOTE: Be sure to use the manual mode if you want to drive the fan speed manually
70
Martin Peres09468072014-06-09 20:38:36 +020071NOTE2: When operating in manual mode outside the vbios-defined
72[PWM_min, PWM_max] range, the reported fan speed (RPM) may not be accurate
73depending on your hardware.
Martin Peres041d6242012-11-20 02:29:22 +010074
75Bug reports
76---------
77
78Thermal management on Nouveau is new and may not work on all cards. If you have
79inquiries, please ping mupuf on IRC (#nouveau, freenode).
80
81Bug reports should be filled on Freedesktop's bug tracker. Please follow
82http://nouveau.freedesktop.org/wiki/Bugs