Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
Documentation/gpu: Document pipe split visual confirmation
Display core provides a feature that makes it easy for users to debug
Pipe Split. This commit introduces how to use such a debug option.
Reviewed-by: Yann Dirson <ydirson@free.fr>
Reviewed-by: Harry Wentland <harry.wentland@amd.com>
Signed-off-by: Rodrigo Siqueira <Rodrigo.Siqueira@amd.com>
Signed-off-by: Alex Deucher <alexander.deucher@amd.com>
authored by
Rodrigo Siqueira
and committed by
Alex Deucher
b2568d68
7971fb35
+26
-2
+26
-2
Documentation/gpu/amdgpu/display/dc-debug.rst
+26
-2
Documentation/gpu/amdgpu/display/dc-debug.rst
···
2
2
Display Core Debug tools
3
3
========================
4
4
5
-
DC Debugfs
6
-
==========
5
+
DC Visual Confirmation
6
+
======================
7
+
8
+
Display core provides a feature named visual confirmation, which is a set of
9
+
bars added at the scanout time by the driver to convey some specific
10
+
information. In general, you can enable this debug option by using::
11
+
12
+
echo <N> > /sys/kernel/debug/dri/0/amdgpu_dm_visual_confirm
13
+
14
+
Where `N` is an integer number for some specific scenarios that the developer
15
+
wants to enable, you will see some of these debug cases in the following
16
+
subsection.
7
17
8
18
Multiple Planes Debug
9
19
---------------------
···
44
34
* There should **not** be any cursor corruption
45
35
* Multiple plane **may** be briefly disabled during window transitions or
46
36
resizing but should come back after the action has finished
37
+
38
+
Pipe Split Debug
39
+
----------------
40
+
41
+
Sometimes we need to debug if DCN is splitting pipes correctly, and visual
42
+
confirmation is also handy for this case. Similar to the MPO case, you can use
43
+
the below command to enable visual confirmation::
44
+
45
+
echo 1 > /sys/kernel/debug/dri/0/amdgpu_dm_visual_confirm
46
+
47
+
In this case, if you have a pipe split, you will see one small red bar at the
48
+
bottom of the display covering the entire display width and another bar
49
+
covering the second pipe. In other words, you will see a bit high bar in the
50
+
second pipe.