1 ===========================================
2 GPU Power/Thermal Controls and Monitoring
3 ===========================================
4
5 HWMON Interfaces
6 ================
7
8 .. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_
9 :doc: hwmon
10
11 GPU sysfs Power State Interfaces
12 ================================
13
14 GPU power controls are exposed via sysfs files
15
16 power_dpm_state
17 ---------------
18
19 .. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_
20 :doc: power_dpm_state
21
22 power_dpm_force_performance_level
23 ---------------------------------
24
25 .. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_
26 :doc: power_dpm_force_performance_level
27
28 pp_table
29 --------
30
31 .. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_
32 :doc: pp_table
33
34 pp_od_clk_voltage
35 -----------------
36
37 .. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_
38 :doc: pp_od_clk_voltage
39
40 pp_dpm_*
41 --------
42
43 .. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_
44 :doc: pp_dpm_sclk pp_dpm_mclk pp_dpm_socclk
45
46 pp_power_profile_mode
47 ---------------------
48
49 .. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_
50 :doc: pp_power_profile_mode
51
52 pm_policy
53 ---------------------
54
55 .. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_
56 :doc: pm_policy
57
58 \*_busy_percent
59 ---------------
60
61 .. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_
62 :doc: gpu_busy_percent
63
64 .. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_
65 :doc: mem_busy_percent
66
67 gpu_metrics
68 -----------
69
70 .. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_
71 :doc: gpu_metrics
72
73 fan_curve
74 ---------
75
76 .. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_
77 :doc: fan_curve
78
79 acoustic_limit_rpm_threshold
80 ----------------------------
81
82 .. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_
83 :doc: acoustic_limit_rpm_threshold
84
85 acoustic_target_rpm_threshold
86 -----------------------------
87
88 .. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_
89 :doc: acoustic_target_rpm_threshold
90
91 fan_target_temperature
92 ----------------------
93
94 .. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_
95 :doc: fan_target_temperature
96
97 fan_minimum_pwm
98 ---------------
99
100 .. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_
101 :doc: fan_minimum_pwm
102
103 GFXOFF
104 ======
105
106 GFXOFF is a feature found in most recent GPUs
107 card's RLC (RunList Controller) firmware power
108 dynamically when there is no workload on gfx o
109 default on supported GPUs.
110
111 Userspace can interact with GFXOFF through a d
112 `uint32_t`, unless otherwise noted):
113
114 ``amdgpu_gfxoff``
115 -----------------
116
117 Use it to enable/disable GFXOFF, and to check
118
119 $ xxd -l1 -p /sys/kernel/debug/dri/0/amdgpu_
120 01
121
122 - Write 0 to disable it, and 1 to enable it.
123 - Read 0 means it's disabled, 1 it's enabled.
124
125 If it's enabled, that means that the GPU is fr
126 needed. Disabled means that it will never ente
127
128 ``amdgpu_gfxoff_status``
129 ------------------------
130
131 Read it to check current GFXOFF's status of a
132
133 $ xxd -l1 -p /sys/kernel/debug/dri/0/amdgpu_
134 02
135
136 - 0: GPU is in GFXOFF state, the gfx engine is
137 - 1: Transition out of GFXOFF state
138 - 2: Not in GFXOFF state
139 - 3: Transition into GFXOFF state
140
141 If GFXOFF is enabled, the value will be transi
142 getting into 0 when possible. When it's disabl
143 ``-EINVAL`` if it's not supported.
144
145 ``amdgpu_gfxoff_count``
146 -----------------------
147
148 Read it to get the total GFXOFF entry count at
149 power-up. The value is an `uint64_t` type, how
150 it can currently overflow as an `uint32_t`. *O
151
152 ``amdgpu_gfxoff_residency``
153 ---------------------------
154
155 Write 1 to amdgpu_gfxoff_residency to start lo
156 get average GFXOFF residency % multiplied by 1
157 interval. E.g. a value of 7854 means 78.54% of
158 interval the GPU was in GFXOFF mode. *Only sup
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.