tjh.dev / kernel
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

Documentation/gpu: Document amdgpu_dm_visual_confirm debugfs entry

Display core provides a feature that makes it easy for users to debug
Multiple planes by enabling a visual notification at the bottom of each
plane. This commit introduces how to use such a feature.

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 7971fb35 e91f8401

+33 -1
+33 -1
Documentation/gpu/amdgpu/display/dc-debug.rst
··· 1 + ======================== 1 2 Display Core Debug tools 2 3 ======================== 3 4 4 - TODO 5 + DC Debugfs 6 + ========== 7 + 8 + Multiple Planes Debug 9 + --------------------- 10 + 11 + If you want to enable or debug multiple planes in a specific user-space 12 + application, you can leverage a debug feature named visual confirm. For 13 + enabling it, you will need:: 14 + 15 + echo 1 > /sys/kernel/debug/dri/0/amdgpu_dm_visual_confirm 16 + 17 + You need to reload your GUI to see the visual confirmation. When the plane 18 + configuration changes or a full update occurs there will be a colored bar at 19 + the bottom of each hardware plane being drawn on the screen. 20 + 21 + * The color indicates the format - For example, red is AR24 and green is NV12 22 + * The height of the bar indicates the index of the plane 23 + * Pipe split can be observed if there are two bars with a difference in height 24 + covering the same plane 25 + 26 + Consider the video playback case in which a video is played in a specific 27 + plane, and the desktop is drawn in another plane. The video plane should 28 + feature one or two green bars at the bottom of the video depending on pipe 29 + split configuration. 30 + 31 + * There should **not** be any visual corruption 32 + * There should **not** be any underflow or screen flashes 33 + * There should **not** be any black screens 34 + * There should **not** be any cursor corruption 35 + * Multiple plane **may** be briefly disabled during window transitions or 36 + resizing but should come back after the action has finished