요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. _display_todos:
3
==============================
4
AMDGPU - Display Contributions
5
==============================
7
First of all, if you are here, you probably want to give some technical
8
contribution to the display code, and for that, we say thank you :)
10
This page summarizes some of the issues you can help with; keep in mind that
11
this is a static page, and it is always a good idea to try to reach developers
12
on the amd-gfx mailing list or some of the maintainers. Finally, this page
13
follows the DRM way of creating a TODO list; for more information, check
14
'Documentation/gpu/todo.rst'.
16
Gitlab issues
17
=============
19
Users can report issues associated with AMD GPUs at:
21
- https://gitlab.freedesktop.org/drm/amd
23
Usually, we try to add a proper label to all new tickets to make it easy to
24
filter issues. If you can reproduce any problem, you could help by adding more
25
information or fixing the issue.
27
Level: diverse
29
IGT
30
===
32
`IGT`_ provides many integration tests that can be run on your GPU. We always
33
want to pass a large set of tests to increase the test coverage in our CI. If
34
you wish to contribute to the display code but are unsure where a good place
35
is, we recommend you run all IGT tests and try to fix any failure you see in
36
your hardware. Keep in mind that this failure can be an IGT problem or a kernel
37
issue; it is necessary to analyze case-by-case.
39
Level: diverse
41
.. _IGT: https://gitlab.freedesktop.org/drm/igt-gpu-tools
43
Compilation
44
===========
46
Fix compilation warnings
47
------------------------
49
Enable the W1 or W2 warning level in the kernel compilation and try to fix the
50
issues on the display side.
52
Level: Starter
54
Fix compilation issues when using um architecture
55
-------------------------------------------------
57
Linux has a User-mode Linux (UML) feature, and the kernel can be compiled to
58
the **um** architecture. Compiling for **um** can bring multiple advantages
59
from the test perspective. We currently have some compilation issues in this
60
area that we need to fix.
62
Level: Intermediate
64
Code Refactor
65
=============
67
Add prefix to DC functions to improve the debug with ftrace
68
-----------------------------------------------------------
70
The Ftrace debug feature (check 'Documentation/trace/ftrace.rst') is a
71
fantastic way to check the code path when developers try to make sense of a
72
bug. Ftrace provides a filter mechanism that can be useful when the developer
73
has some hunch of which part of the code can cause the issue; for this reason,
74
if a set of functions has a proper prefix, it becomes easy to create a good
75
filter. Additionally, prefixes can improve stack trace readability.
77
The DC code does not follow some prefix rules, which makes the Ftrace filter
78
more complicated and reduces the readability of the stack trace. If you want
79
something simple to start contributing to the display, you can make patches for
80
adding prefixes to DC functions. To create those prefixes, use part of the file
81
name as a prefix for all functions in the target file. Check the
82
'amdgpu_dm_crtc.c` and `amdgpu_dm_plane.c` for some references. However, we
83
strongly advise not to send huge patches changing these prefixes; otherwise, it
84
will be hard to review and test, which can generate second thoughts from
85
maintainers. Try small steps; in case of double, you can ask before you put in
86
effort. We recommend first looking at folders like dceXYZ, dcnXYZ, basics,
87
bios, core, clk_mgr, hwss, resource, and irq.
89
Level: Starter
91
Reduce code duplication
92
-----------------------
94
AMD has an extensive portfolio with various dGPUs and APUs that amdgpu
95
supports. To maintain the new hardware release cadence, DCE/DCN was designed in
96
a modular design, making the bring-up for new hardware fast. Over the years,
97
amdgpu accumulated some technical debt in the code duplication area. For this
98
task, it would be a good idea to find a tool that can discover code duplication
99
(including patterns) and use it as guidance to reduce duplications.
101
Level: Intermediate
103
Make atomic_commit_[check|tail] more readable
104
---------------------------------------------
106
The functions responsible for atomic commit and tail are intricate and
107
extensive. In particular `amdgpu_dm_atomic_commit_tail` is a long function and
108
could benefit from being split into smaller helpers. Improvements in this area
109
are more than welcome, but keep in mind that changes in this area will affect
110
all ASICs, meaning that refactoring requires a comprehensive verification; in
111
other words, this effort can take some time for validation.
113
Level: Advanced
115
Documentation
116
=============
118
Expand kernel-doc
119
-----------------
121
Many DC functions do not have a proper kernel-doc; understanding a function and
122
adding documentation is a great way to learn more about the amdgpu driver and
123
also leave an outstanding contribution to the entire community.
125
Level: Starter
127
Beyond AMDGPU
128
=============
130
AMDGPU provides features that are not yet enabled in the userspace. This
131
section highlights some of the coolest display features, which could be enabled
132
with the userspace developer helper.
134
Enable underlay
135
---------------
137
AMD display has this feature called underlay (which you can read more about at
138
'Documentation/gpu/amdgpu/display/mpo-overview.rst') which is intended to
139
save power when playing a video. The basic idea is to put a video in the
140
underlay plane at the bottom and the desktop in the plane above it with a hole
141
in the video area. This feature is enabled in ChromeOS, and from our data
142
measurement, it can save power.
144
Level: Unknown
146
Adaptive Backlight Modulation (ABM)
147
-----------------------------------
149
ABM is a feature that adjusts the display panel's backlight level and pixel
150
values depending on the displayed image. This power-saving feature can be very
151
useful when the system starts to run off battery; since this will impact the
152
display output fidelity, it would be good if this option was something that
153
users could turn on or off.
155
Level: Unknown
158
HDR & Color management & VRR
159
----------------------------
161
HDR, Color Management, and VRR are huge topics and it's hard to put these into
162
concise ToDos. If you are interested in this topic, we recommend checking some
163
blog posts from the community developers to better understand some of the
164
specific challenges and people working on the subject. If anyone wants to work
165
on some particular part, we can try to help with some basic guidance. Finally,
166
keep in mind that we already have some kernel-doc in place for those areas.
168
Level: Unknown
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
기여 시작점: issue와 IGT
1-42이 페이지는 AMDGPU display code에 기술적으로 기여하려는 사람을 위한 정적 TODO 목록입니다. 목록은 시간이 지나면 실제 우선순위와 달라질 수 있으므로 작업을 시작하기 전에 amd-gfx mailing list 또는 maintainer에게 문의하는 것이 좋습니다. 구성 방식은 DRM TODO 문서인 `Documentation/gpu/todo.rst`를 따릅니다.
관심 있는 issue 또는 기능 영역 선택→GitLab ticket, amd-gfx mailing list와 maintainer 논의 확인→대상 hardware에서 문제를 재현하고 baseline 수집→IGT failure인지 kernel issue인지 원인 범위 분리→검토 가능한 작은 patch와 재현·검증 결과 준비
정적 TODO를 바로 구현 목록으로 간주하지 않고 현재 상태를 먼저 확인합니다.
AMD GPU 관련 issue는 `https://gitlab.freedesktop.org/drm/amd`에서 보고할 수 있습니다. 새 ticket에는 적절한 label을 붙여 filtering을 돕습니다. 이미 재현 가능한 문제라면 추가 hardware·log·재현 정보를 보태거나 직접 수정하는 것도 중요한 기여입니다. 이 항목의 Level은 `diverse`로, issue마다 난이도가 다릅니다.
`IGT`는 GPU에서 실행하는 다양한 integration test를 제공합니다. CI test coverage를 넓히려면 큰 test set의 통과율을 높여야 합니다. 어디서 시작할지 모른다면 자신의 hardware에서 전체 IGT suite를 실행하고 failure 하나를 분석하는 방법이 권장됩니다. 다만 failure는 IGT test 자체의 문제일 수도, kernel의 문제일 수도 있으므로 case-by-case 분석이 필요합니다.
항목기여 내용Level참조
GitLab issuesTicket label, 재현 정보, 추가 log 또는 fixdiversehttps://gitlab.freedesktop.org/drm/amd
IGTHardware에서 test suite 실행, failure 분석과 수정diversehttps://gitlab.freedesktop.org/drm/igt-gpu-tools
두 시작점 모두 재현과 원인 분리가 핵심입니다.
후보확인할 내용
IGT problemTest assumption, test code, expected result와 hardware 지원 조건
Kernel issueDRM/AMDGPU behavior, dmesg, regression 범위와 hardware-specific 경로
통과하지 못했다는 사실만으로 kernel regression이라고 단정하지 않습니다.
.. _display_todos:
==============================
AMDGPU - Display Contributions
==============================
First of all, if you are here, you probably want to give some technical
contribution to the display code, and for that, we say thank you :)
This page summarizes some of the issues you can help with; keep in mind that
this is a static page, and it is always a good idea to try to reach developers
on the amd-gfx mailing list or some of the maintainers. Finally, this page
follows the DRM way of creating a TODO list; for more information, check
'Documentation/gpu/todo.rst'.
Gitlab issues
=============
Users can report issues associated with AMD GPUs at:
- https://gitlab.freedesktop.org/drm/amd
Usually, we try to add a proper label to all new tickets to make it easy to
filter issues. If you can reproduce any problem, you could help by adding more
information or fixing the issue.
Level: diverse
IGT
===
`IGT`_ provides many integration tests that can be run on your GPU. We always
want to pass a large set of tests to increase the test coverage in our CI. If
you wish to contribute to the display code but are unsure where a good place
is, we recommend you run all IGT tests and try to fix any failure you see in
your hardware. Keep in mind that this failure can be an IGT problem or a kernel
issue; it is necessary to analyze case-by-case.
Level: diverse
.. _IGT: https://gitlab.freedesktop.org/drm/igt-gpu-tools
Compilation warning과 UML
43-63첫 compilation 과제는 kernel build에서 W1 또는 W2 warning level을 enable하고 display 쪽 warning을 수정하는 것입니다. 기능 동작을 바꾸지 않고 compiler가 지적하는 type, declaration, format 문제를 정리할 수 있어 Level은 `Starter`입니다.
두 번째 과제는 User-mode Linux(UML)의 `um` architecture로 kernel을 compile할 때 발생하는 display 관련 build issue를 고치는 것입니다. UML build는 실제 GPU 없이도 여러 test 관점의 이점을 주지만 architecture assumption과 stub dependency를 이해해야 하므로 Level은 `Intermediate`입니다.
과제목표Level주의점
W1/W2 warningDisplay-side compiler warning 제거StarterWarning을 숨기기보다 실제 type와 API contract 확인
um architectureUser-mode Linux target의 compilation issue 수정IntermediateHardware-specific dependency와 UML 지원 경계 확인
원문은 특정 build command를 제시하지 않으므로 사용하는 tree의 build guide와 configuration을 함께 확인합니다.
같은 source revision과 config에서 failure 또는 warning 재현→W1/W2 또는 um build가 지적한 최초 원인 확인→가장 작은 source change로 수정→대상 build configuration 재검증→일반 AMDGPU build와 관련 architecture에 부작용이 없는지 확인
단일 warning 제거가 다른 configuration을 깨지 않는지 확인합니다.
Compilation
===========
Fix compilation warnings
------------------------
Enable the W1 or W2 warning level in the kernel compilation and try to fix the
issues on the display side.
Level: Starter
Fix compilation issues when using um architecture
-------------------------------------------------
Linux has a User-mode Linux (UML) feature, and the kernel can be compiled to
the **um** architecture. Compiling for **um** can bring multiple advantages
from the test perspective. We currently have some compilation issues in this
area that we need to fix.
Level: Intermediate
DC code refactor 과제와 검증 범위
64-114Ftrace는 `Documentation/trace/ftrace.rst`에 설명된 code-path 조사 도구입니다. Function prefix가 일관되면 filter를 쉽게 만들고 stack trace도 읽기 좋아집니다. DC code에는 prefix rule을 따르지 않는 함수가 있어 filtering과 trace 해석을 어렵게 합니다.
Starter 기여로 target file 이름 일부를 prefix로 사용해 그 파일의 함수 이름을 정리할 수 있습니다. 참고 file은 `amdgpu_dm_crtc.c`와 `amdgpu_dm_plane.c`입니다. 하지만 prefix를 한 번에 대규모로 바꾸면 review와 test가 어려워지고 maintainer가 patch 자체를 꺼릴 수 있으므로 작은 단위로 나누고, 확신이 없으면 작업 전에 질문해야 합니다.
범주후보
Generation-specificdceXYZ, dcnXYZ
Core supportbasics, bios, core
Clock and sequencingclk_mgr, hwss
Resource and interruptresource, irq
원문이 먼저 살펴보도록 권장한 directory 이름을 그대로 보존했습니다.
Target file 하나와 현재 함수 naming pattern 선택→File 이름 일부에서 일관된 prefix 결정→Reference file amdgpu_dm_crtc.c와 amdgpu_dm_plane.c 비교→Call site와 trace-visible symbol을 함께 갱신→작은 patch로 build, trace filter와 stack readability 검증→다음 file은 별도 patch 또는 series 단계로 진행
Rename 범위를 좁혀 review 가능성과 bisect 가능성을 높입니다.
AMDGPU는 다양한 dGPU와 APU를 지원합니다. 빠른 hardware bring-up을 위해 DCE/DCN은 modular design으로 만들어졌지만, 세대가 늘면서 유사 code와 pattern이 중복되는 technical debt가 축적되었습니다. Code duplication과 유사 pattern을 찾는 tool을 조사 지침으로 사용해 공통화 후보를 찾는 과제의 Level은 `Intermediate`입니다.
`atomic_commit_[check|tail]` 경로는 복잡하고 길며, 특히 `amdgpu_dm_atomic_commit_tail`은 작은 helper로 나눌 여지가 있습니다. 그러나 이 경로는 모든 ASIC에 영향을 주므로 단순 readability patch처럼 보여도 comprehensive verification이 필요합니다. Validation 시간이 길 수 있는 `Advanced` 과제입니다.
과제Level주요 위험필요한 검증
DC function prefixStarterRename 누락, trace/filter 변화Build, symbol reference, ftrace와 stack trace
Code duplication 축소Intermediate세대별 미세한 동작 차이 손실여러 DCE/DCN generation의 callback과 feature 비교
atomic_commit_[check|tail] 분할Advanced모든 ASIC의 atomic commit ordering 변화Comprehensive multi-ASIC display regression 검증
변경 줄 수보다 hardware와 call-path 영향 범위가 검증 난이도를 결정합니다.
Code Refactor
=============
Add prefix to DC functions to improve the debug with ftrace
-----------------------------------------------------------
The Ftrace debug feature (check 'Documentation/trace/ftrace.rst') is a
fantastic way to check the code path when developers try to make sense of a
bug. Ftrace provides a filter mechanism that can be useful when the developer
has some hunch of which part of the code can cause the issue; for this reason,
if a set of functions has a proper prefix, it becomes easy to create a good
filter. Additionally, prefixes can improve stack trace readability.
The DC code does not follow some prefix rules, which makes the Ftrace filter
more complicated and reduces the readability of the stack trace. If you want
something simple to start contributing to the display, you can make patches for
adding prefixes to DC functions. To create those prefixes, use part of the file
name as a prefix for all functions in the target file. Check the
'amdgpu_dm_crtc.c` and `amdgpu_dm_plane.c` for some references. However, we
strongly advise not to send huge patches changing these prefixes; otherwise, it
will be hard to review and test, which can generate second thoughts from
maintainers. Try small steps; in case of double, you can ask before you put in
effort. We recommend first looking at folders like dceXYZ, dcnXYZ, basics,
bios, core, clk_mgr, hwss, resource, and irq.
Level: Starter
Reduce code duplication
-----------------------
AMD has an extensive portfolio with various dGPUs and APUs that amdgpu
supports. To maintain the new hardware release cadence, DCE/DCN was designed in
a modular design, making the bring-up for new hardware fast. Over the years,
amdgpu accumulated some technical debt in the code duplication area. For this
task, it would be a good idea to find a tool that can discover code duplication
(including patterns) and use it as guidance to reduce duplications.
Level: Intermediate
Make atomic_commit_[check|tail] more readable
---------------------------------------------
The functions responsible for atomic commit and tail are intricate and
extensive. In particular `amdgpu_dm_atomic_commit_tail` is a long function and
could benefit from being split into smaller helpers. Improvements in this area
are more than welcome, but keep in mind that changes in this area will affect
all ASICs, meaning that refactoring requires a comprehensive verification; in
other words, this effort can take some time for validation.
Level: Advanced
Kernel-doc 확장
115-126많은 DC 함수에는 적절한 kernel-doc가 없습니다. 함수의 caller, parameter, return value, state transition을 이해한 뒤 문서를 추가하는 작업은 AMDGPU driver를 학습하면서 community 전체에 오래 남는 설명을 제공하는 좋은 Starter 기여입니다.
문서가 없거나 부족한 DC function 하나 선택→Declaration, implementation, caller와 callback 연결 추적→Parameter, return value, side effect와 locking/state 전제 정리→Kernel-doc 형식으로 source 가까이에 작성→Documentation build와 warning 확인→Reviewer가 확인할 수 있도록 조사한 behavior 근거 제시
주석 형식만 채우는 것이 아니라 실제 contract를 source에서 확인합니다.
Documentation
=============
Expand kernel-doc
-----------------
Many DC functions do not have a proper kernel-doc; understanding a function and
adding documentation is a great way to learn more about the amdgpu driver and
also leave an outstanding contribution to the entire community.
Level: Starter
Userspace가 활성화할 Underlay와 ABM
127-156AMDGPU에는 kernel 또는 hardware 쪽 기능은 존재하지만 일반 userspace에서 아직 활성화되지 않은 display feature가 있습니다. 이 영역은 kernel change만으로 끝나지 않고 compositor, browser, desktop policy 같은 userspace 개발자의 협력이 필요합니다.
Underlay는 `Documentation/gpu/amdgpu/display/mpo-overview.rst`에 설명된 power-saving 기능입니다. Video를 아래 underlay plane에 놓고, 그 위 desktop plane은 video 영역에 구멍을 둡니다. ChromeOS에서는 활성화되어 있으며 원문이 언급한 측정에서는 video playback 전력을 줄일 수 있습니다. 일반 userspace 활성화 과제의 Level은 `Unknown`입니다.
Bottom plane: video surface를 underlay로 배치→Top plane: desktop surface를 배치→Desktop의 video rectangle 영역은 transparent hole로 구성→Display hardware가 두 plane을 scanout에서 합성→Video playback의 memory와 power 비용 절감 가능성 측정
Video를 desktop 아래에 배치해 효율적인 scanout을 노립니다.
Adaptive Backlight Modulation(ABM)은 표시 image에 따라 panel backlight level과 pixel value를 함께 조정하는 power-saving 기능입니다. Battery 동작 시 유용하지만 display output fidelity에 영향을 주므로 userspace가 user에게 on/off 선택을 제공하는 것이 바람직합니다. 이 과제도 Level은 `Unknown`입니다.
Displayed image의 luminance와 content 특성 분석→Panel backlight level 조정으로 power 절감→Pixel value를 함께 보정해 보이는 밝기 유지 시도→Output fidelity 변화와 battery benefit 측정→Userspace가 명시적인 enable/disable control 제공
자동 절전 효과와 사용자의 화질 선택권을 함께 다뤄야 합니다.
기능목적핵심 userspace 역할Level
UnderlayVideo playback power 절감Plane composition과 hole 영역 구성Unknown
ABMBacklight 기반 battery power 절감화질 영향 고지와 user toggle 제공Unknown
두 기능 모두 userspace integration과 정책 결정이 남아 있습니다.
Beyond AMDGPU
=============
AMDGPU provides features that are not yet enabled in the userspace. This
section highlights some of the coolest display features, which could be enabled
with the userspace developer helper.
Enable underlay
---------------
AMD display has this feature called underlay (which you can read more about at
'Documentation/gpu/amdgpu/display/mpo-overview.rst') which is intended to
save power when playing a video. The basic idea is to put a video in the
underlay plane at the bottom and the desktop in the plane above it with a hole
in the video area. This feature is enabled in ChromeOS, and from our data
measurement, it can save power.
Level: Unknown
Adaptive Backlight Modulation (ABM)
-----------------------------------
ABM is a feature that adjusts the display panel's backlight level and pixel
values depending on the displayed image. This power-saving feature can be very
useful when the system starts to run off battery; since this will impact the
display output fidelity, it would be good if this option was something that
users could turn on or off.
Level: Unknown
HDR, Color Management와 VRR
157-168HDR, Color Management, VRR은 각각 큰 기술 영역이라 간단한 TODO 몇 개로 축약하기 어렵습니다. 관심 있는 contributor는 community developer의 blog post를 통해 구체적인 challenge와 현재 작업자를 먼저 파악하는 것이 권장됩니다.
특정 하위 영역을 정하면 AMD display developer가 기본 방향을 안내할 수 있으며, 이미 이 영역에 kernel-doc도 일부 존재합니다. 과제 범위가 정해져 있지 않아 Level은 `Unknown`입니다.
주제먼저 좁힐 질문
HDRMetadata, transfer function, output capability 중 어느 경계를 다룰 것인가
Color ManagementLUT, color space, compositor policy 중 어느 stage를 개선할 것인가
VRRTiming range, content pacing, connector와 userspace control 중 무엇을 검증할 것인가
모두 kernel capability, userspace policy와 hardware 검증이 만나는 영역입니다.
Community blog와 existing kernel-doc로 현재 architecture 학습→Hardware, kernel, compositor 중 문제 경계 선택→하나의 measurable behavior 또는 missing integration 정의→amd-gfx developer에게 기본 방향과 중복 작업 여부 문의→작은 testable milestone로 patch 또는 userspace change 제안
구체적인 하위 문제로 좁힌 뒤 현재 담당자와 맞춥니다.
HDR & Color management & VRR
----------------------------
HDR, Color Management, and VRR are huge topics and it's hard to put these into
concise ToDos. If you are interested in this topic, we recommend checking some
blog posts from the community developers to better understand some of the
specific challenges and people working on the subject. If anyone wants to work
on some particular part, we can try to help with some basic guidance. Finally,
keep in mind that we already have some kernel-doc in place for those areas.
Level: Unknown
요약·해설
display-contributing.rst:1-168AMDGPU display에 기여할 수 있는 issue triage, IGT, compilation, refactor, kernel-doc와 userspace feature 과제를 난이도와 검증 범위별로 정리한 전문 번역입니다. 정적 목록이므로 실제 착수 전 amd-gfx와 maintainer 확인이 필요합니다.
원문 11개 Level 항목을 빠르게 비교합니다.