linux.git/Documentation/gpu/amdgpu, branch v6.2

drm/amdgpu: add GART, GPUVM, and GTT to glossary

2022-12-02T15:05:33+00:00

Add definitions to clarify GPU virtual memory.

v2: clarify the terms a bit more

Reviewed-by: Christian König 
Reviewed-by: Luben Tuikov 
Suggested-by: Peter Maucher 
Signed-off-by: Alex Deucher 
Link: https://lore.kernel.org/r/20221201214153.8453-1-alexander.deucher@amd.com

drm/amdgpu: mention RDNA support in docu

2022-12-01T20:21:53+00:00

The amdgpu kernel module has supported RDNA for a while,
mention that in the module description.

v2: Add CDNA as well (Alex)

Signed-off-by: Peter Maucher 
Signed-off-by: Alex Deucher

drm/amdgpu: update docum. filename following rename

2022-11-29T16:03:39+00:00

Fix documentation build errors for amdgpu: correct the filename.

Error: Cannot open file ../drivers/gpu/drm/amd/amdgpu/amdgpu_mn.c
Error: Cannot open file ../drivers/gpu/drm/amd/amdgpu/amdgpu_mn.c
Error: Cannot open file ../drivers/gpu/drm/amd/amdgpu/amdgpu_mn.c

WARNING: kernel-doc '../scripts/kernel-doc -rst -enable-lineno -sphinx-version 5.3.0 -function MMU Notifier ../drivers/gpu/drm/amd/amdgpu/amdgpu_mn.c' failed with return code 1
WARNING: kernel-doc '../scripts/kernel-doc -rst -enable-lineno -sphinx-version 5.3.0 -internal ../drivers/gpu/drm/amd/amdgpu/amdgpu_mn.c' failed with return code 2

Fixes: d9483ecd327b ("drm/amdgpu: rename the files for HMM handling")
Signed-off-by: Randy Dunlap 
Cc: Christian König 
Cc: Alex Deucher 
Cc: Felix Kuehling 
Cc: David Airlie 
Cc: Daniel Vetter 
Cc: Jonathan Corbet 
Cc: amd-gfx@lists.freedesktop.org
Cc: dri-devel@lists.freedesktop.org
Signed-off-by: Alex Deucher

Documentation/gpu: Add Multiplane Overlay doc

2022-09-01T19:09:46+00:00

Multiple plane overlay is a feature supported by AMD hardware, but it
has specific details that deserve proper documentation. This commit
introduces a documentation that describes some of the features,
limitations, and use cases for this feature. Part of this documentation
came from some discussion in the public upstream [1][2].

[1]. https://lore.kernel.org/amd-gfx/3qY-QeukF_Q_MJeIXAuBjO4szbS4jRtqkTifXnbnN3bp88SxVodFQRpah3mIIVJq24DUkF6g0rOGdCmSqTvVxx9LCGEItmzLw8uWU44jtXE=@emersion.fr/
[2]. https://lore.kernel.org/amd-gfx/864e45d0-c14b-3b12-0f5b-9d26a9cb41bd@amd.com/

Cc: Harry Wentland 
Cc: Nicholas Kazlauskas 
Cc: Bhawanpreet Lakha 
Cc: Hersen Wu 
Cc: Alex Hung 
Cc: Pierre-Eric Pelloux-Prayer 
Cc: Simon Ser 
Cc: Pekka Paalanen 
Cc: Sean Paul 
Cc: Mark Yacoub 
Cc: Leo Li 
Cc: Pierre-Loup 
Cc: Michel Dänzer 
Reviewed-by: Harry Wentland 
Signed-off-by: Rodrigo Siqueira 
Signed-off-by: Alex Deucher

Documentation/gpu: Add an explanation about the DCN pipeline

2022-09-01T19:09:39+00:00

In the DCN code, we constantly talk about hardware pipeline, pipeline,
or even just pipes, which is a concept that is not obvious to everyone.
For this reason, this commit expands the DCN overview explanation by
adding a new section that describes what a pipeline is from the DCN
perspective.

Changes since V1:
- Rewrite the first paragraph that describes AMD hardware pipeline.

Cc: Harry Wentland 
Cc: Nicholas Kazlauskas 
Cc: Bhawanpreet Lakha 
Cc: Hersen Wu 
Cc: Alex Hung 
Cc: Pierre-Eric Pelloux-Prayer 
Cc: Leo Li 
Cc: Simon Ser 
Cc: Pekka Paalanen 
Cc: Sean Paul 
Cc: Mark Yacoub 
Cc: Pierre-Loup 
Cc: Michel Dänzer 
Reviewed-by: Harry Wentland 
Signed-off-by: Rodrigo Siqueira 
Signed-off-by: Alex Deucher

Documentation/gpu: Add info table for ASICs

2022-09-01T19:09:31+00:00

Amdgpu driver is used in an extensive range of devices, and each ASIC
has some specific configuration. As a result of this variety, sometimes
it is hard to identify the correct block that might cause the issue.
This commit expands the amdgpu kernel-doc to alleviate this issue by
introducing one ASIC table that describes dGPU and another one that
shares the APU info.

Cc: Harry Wentland 
Cc: Nicholas Kazlauskas 
Cc: Bhawanpreet Lakha 
Cc: Hersen Wu 
Cc: Alex Hung 
Cc: Pierre-Eric Pelloux-Prayer 
Cc: Leo Li 
Cc: Simon Ser 
Cc: Pekka Paalanen 
Cc: Sean Paul 
Cc: Mark Yacoub 
Cc: Pierre-Loup 
Cc: Michel Dänzer 
Cc: Kent Russell 
Reviewed-by: Harry Wentland 
Signed-off-by: Rodrigo Siqueira 
Signed-off-by: Alex Deucher

Documentation/gpu: Document GFXOFF's count and residency

2022-08-16T22:17:32+00:00

Add documentation explaining those two new files.

While here, add a note about the value type.

Signed-off-by: André Almeida 
Signed-off-by: Alex Deucher

Documentation/gpu/amdgpu/amdgpu_dm: add DM docs for pixel blend mode

2022-08-16T22:14:32+00:00

AMD GPU display manager (DM) maps DRM pixel blend modes (None,
Pre-multiplied, Coverage) to MPC hw blocks through blend configuration
options. Describe relevant elements and how to set and test them to get
the expected DRM blend mode on DCN hw.

v2:
- add ref tag (Tales)

Signed-off-by: Melissa Wen 
Reviewed-by: Tales Aparecida 
Reviewed-by: Rodrigo Siqueira 
Signed-off-by: Alex Deucher

drm/amd/display: add doc entries for MPC blending configuration

2022-08-16T22:14:32+00:00

Describe structs and enums used to set blend mode properties to MPC
blocks. Some pieces of information are already available as code
comments, and were just formatted. Others were collected and summarised
from discussions on AMD issue tracker[1][2].

[1] https://gitlab.freedesktop.org/drm/amd/-/issues/1734
[2] https://gitlab.freedesktop.org/drm/amd/-/issues/1769

v2:
- fix typos (Tales)
- add MPCC to MPC entry in the glossary

Signed-off-by: Melissa Wen 
Reviewed-by: Tales Aparecida 
Reviewed-by: Rodrigo Siqueira 
Signed-off-by: Alex Deucher

Documentation/amdgpu/display: add DC color caps info

2022-08-16T22:14:32+00:00

Add details about color correction capabilities and explain a bit about
differences between DC hw generations and also how they are mapped
between DRM and DC interface. Two schemas for DCN 2.0 and 3.0 (converted
to svg from the original png) is included to illustrate it. They were
obtained from a discussion[1] in the amd-gfx mailing list.

[1] https://lore.kernel.org/amd-gfx/20220422142811.dm6vtk6v64jcwydk@mail.igalia.com/

v1:
- remove redundant comments (Harry)
- fix typos (Harry)

v2:
- reword introduction of color section
- add co-dev tag for Harry - who provided most of the info
- fix typos (Tales)
- describe missing struct parameters (Tales and Siqueira)

Co-developed-by: Harry Wentland 
Signed-off-by: Harry Wentland 
Signed-off-by: Melissa Wen 
Reviewed-by: Tales Aparecida 
Reviewed-by: Rodrigo Siqueira 
Signed-off-by: Alex Deucher