1 .. _display_todos:
2
3 ==============================
4 AMDGPU - Display Contributions
5 ==============================
6
7 First of all, if you are here, you probably wa
8 contribution to the display code, and for that
9
10 This page summarizes some of the issues you ca
11 this is a static page, and it is always a good
12 in the amdgfx or some of the maintainers. Fina
13 way of creating a TODO list; for more informat
14 'Documentation/gpu/todo.rst'.
15
16 Gitlab issues
17 =============
18
19 Users can report issues associated with AMD GP
20
21 - https://gitlab.freedesktop.org/drm/amd
22
23 Usually, we try to add a proper label to all n
24 filter issues. If you can reproduce any proble
25 information or fixing the issue.
26
27 Level: diverse
28
29 IGT
30 ===
31
32 `IGT`_ provides many integration tests that ca
33 want to pass a large set of tests to increase
34 you wish to contribute to the display code but
35 is, we recommend you run all IGT tests and try
36 your hardware. Keep in mind that this failure
37 issue; it is necessary to analyze case-by-case
38
39 Level: diverse
40
41 .. _IGT: https://gitlab.freedesktop.org/drm/ig
42
43 Compilation
44 ===========
45
46 Fix compilation warnings
47 ------------------------
48
49 Enable the W1 or W2 warning level in the kerne
50 issues on the display side.
51
52 Level: Starter
53
54 Fix compilation issues when using um architect
55 ----------------------------------------------
56
57 Linux has a User-mode Linux (UML) feature, and
58 the **um** architecture. Compiling for **um**
59 from the test perspective. We currently have s
60 area that we need to fix.
61
62 Level: Intermediate
63
64 Code Refactor
65 =============
66
67 Add prefix to DC functions to improve the debu
68 ----------------------------------------------
69
70 The Ftrace debug feature (check 'Documentation
71 fantastic way to check the code path when deve
72 bug. Ftrace provides a filter mechanism that c
73 has some hunch of which part of the code can c
74 if a set of functions has a proper prefix, it
75 filter. Additionally, prefixes can improve sta
76
77 The DC code does not follow some prefix rules,
78 more complicated and reduces the readability o
79 something simple to start contributing to the
80 adding prefixes to DC functions. To create tho
81 name as a prefix for all functions in the targ
82 'amdgpu_dm_crtc.c` and `amdgpu_dm_plane.c` for
83 strongly advise not to send huge patches chang
84 will be hard to review and test, which can gen
85 maintainers. Try small steps; in case of doubl
86 effort. We recommend first looking at folders
87 bios, core, clk_mgr, hwss, resource, and irq.
88
89 Level: Starter
90
91 Reduce code duplication
92 -----------------------
93
94 AMD has an extensive portfolio with various dG
95 supports. To maintain the new hardware release
96 a modular design, making the bring-up for new
97 amdgpu accumulated some technical debt in the
98 task, it would be a good idea to find a tool t
99 (including patterns) and use it as guidance to
100
101 Level: Intermediate
102
103 Make atomic_commit_[check|tail] more readable
104 ---------------------------------------------
105
106 The functions responsible for atomic commit an
107 extensive. In particular `amdgpu_dm_atomic_com
108 could benefit from being split into smaller he
109 are more than welcome, but keep in mind that c
110 all ASICs, meaning that refactoring requires a
111 other words, this effort can take some time fo
112
113 Level: Advanced
114
115 Documentation
116 =============
117
118 Expand kernel-doc
119 -----------------
120
121 Many DC functions do not have a proper kernel-
122 adding documentation is a great way to learn m
123 also leave an outstanding contribution to the
124
125 Level: Starter
126
127 Beyond AMDGPU
128 =============
129
130 AMDGPU provides features that are not yet enab
131 section highlights some of the coolest display
132 with the userspace developer helper.
133
134 Enable underlay
135 ---------------
136
137 AMD display has this feature called underlay (
138 'Documentation/gpu/amdgpu/display/mpo-overview
139 save power when playing a video. The basic ide
140 underlay plane at the bottom and the desktop i
141 in the video area. This feature is enabled in
142 measurement, it can save power.
143
144 Level: Unknown
145
146 Adaptive Backlight Modulation (ABM)
147 -----------------------------------
148
149 ABM is a feature that adjusts the display pane
150 values depending on the displayed image. This
151 useful when the system starts to run off batte
152 display output fidelity, it would be good if t
153 users could turn on or off.
154
155 Level: Unknown
156
157
158 HDR & Color management & VRR
159 ----------------------------
160
161 HDR, Color Management, and VRR are huge topics
162 concise ToDos. If you are interested in this t
163 blog posts from the community developers to be
164 specific challenges and people working on the
165 on some particular part, we can try to help wi
166 keep in mind that we already have some kernel-
167
168 Level: Unknown
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.