* [PATCH v4] drm: add overview diagram for drm stack @ 2025-06-01 22:18 Abdulrasaq Lawani 2025-06-02 1:28 ` Bagas Sanjaya 0 siblings, 1 reply; 5+ messages in thread From: Abdulrasaq Lawani @ 2025-06-01 22:18 UTC (permalink / raw) To: Maarten Lankhorst, Maxime Ripard, Thomas Zimmermann, David Airlie, Simona Vetter, Jonathan Corbet Cc: dri-devel, linux-doc, linux-kernel, Abdulrasaq Lawani Add an overview diagram of Linux DRM architecture for graphics and compute to introduction.rst Signed-off-by: Abdulrasaq Lawani <abdulrasaqolawani@gmail.com> --- Changes in v4: - Ensure patch description describe diff adding overview diagram. - Link to v3: https://lore.kernel.org/r/20250527-drm-doc-updates-v3-1-58e97a831d03@gmail.com Changes in v3: - revert the promotion of the overview diagram header - Link to v2: https://lore.kernel.org/r/20250523-drm-doc-updates-v2-0-e517df152cf6@gmail.com Changes in v2: - Update the overview diagram to display correctly by putting in a literal block. - Also update the overview section diagram to a higher order. - Ensured docs are successfully rendering by building for htmldocs and pdfdocs. - Rendered pages are okay on html and pdf. - Link to v1: https://lore.kernel.org/r/20250522-drm-doc-updates-v1-1-d1efd54740bd@gmail.com --- Documentation/gpu/introduction.rst | 40 +++++++++++++++++++++++++++++++++++++- 1 file changed, 39 insertions(+), 1 deletion(-) diff --git a/Documentation/gpu/introduction.rst b/Documentation/gpu/introduction.rst index 3cd0c8860b949408ed570d3f9384edd5f03df002..a8d3f953a470180b395ec52a45d0f3f4561424e0 100644 --- a/Documentation/gpu/introduction.rst +++ b/Documentation/gpu/introduction.rst @@ -14,7 +14,45 @@ including the TTM memory manager, output configuration and mode setting, and the new vblank internals, in addition to all the regular features found in current kernels. -[Insert diagram of typical DRM stack here] +Overview of the Linux DRM Architecture +-------------------------------------- +:: + + +-----------------------------+ + | User-space Apps | + | (Games, Browsers, ML, etc.) | + +-----------------------------+ + | + v + +---------------------------------------+ + | Graphics APIs | Compute APIs | + | (OpenGL, Vulkan) | (OpenCL, CUDA) | + +---------------------------------------+ + | | + v v + +---------------------+ +-----------------------+ + | User-space Driver | | Compute Runtime | + | (Mesa, AMD/NVIDIA) | | (OpenCL, CUDA, ROCm) | + +---------------------+ +-----------------------+ + | | + +--------+----------+ + | + v + +-----------------------+ + | libdrm (DRM API) | + +-----------------------+ + | + v + +-------------------------------------------+ + | Kernel DRM/KMS Driver (i915, amdgpu, | + | nouveau, etc.) | + +-------------------------------------------+ + | | + v v + +----------------+ +-------------------+ + | GPU Display HW | | GPU Compute Units | + +----------------+ +-------------------+ + Style Guidelines ================ --- base-commit: 4d07f5440d7afee27dada528aaf5230e760531cb change-id: 20250522-drm-doc-updates-3686f6d48122 Best regards, -- Abdulrasaq Lawani <abdulrasaqolawani@gmail.com> ^ permalink raw reply related [flat|nested] 5+ messages in thread
* Re: [PATCH v4] drm: add overview diagram for drm stack 2025-06-01 22:18 [PATCH v4] drm: add overview diagram for drm stack Abdulrasaq Lawani @ 2025-06-02 1:28 ` Bagas Sanjaya 2025-06-04 14:37 ` Simona Vetter 0 siblings, 1 reply; 5+ messages in thread From: Bagas Sanjaya @ 2025-06-02 1:28 UTC (permalink / raw) To: Abdulrasaq Lawani, Maarten Lankhorst, Maxime Ripard, Thomas Zimmermann, David Airlie, Simona Vetter, Jonathan Corbet Cc: dri-devel, linux-doc, linux-kernel [-- Attachment #1: Type: text/plain, Size: 2711 bytes --] On Sun, Jun 01, 2025 at 06:18:47PM -0400, Abdulrasaq Lawani wrote: > Add an overview diagram of Linux DRM architecture for > graphics and compute to introduction.rst > > Signed-off-by: Abdulrasaq Lawani <abdulrasaqolawani@gmail.com> > --- > <snipped>... > diff --git a/Documentation/gpu/introduction.rst b/Documentation/gpu/introduction.rst > index 3cd0c8860b949408ed570d3f9384edd5f03df002..a8d3f953a470180b395ec52a45d0f3f4561424e0 100644 > --- a/Documentation/gpu/introduction.rst > +++ b/Documentation/gpu/introduction.rst > @@ -14,7 +14,45 @@ including the TTM memory manager, output configuration and mode setting, > and the new vblank internals, in addition to all the regular features > found in current kernels. > > -[Insert diagram of typical DRM stack here] > +Overview of the Linux DRM Architecture > +-------------------------------------- > +:: > + > + +-----------------------------+ > + | User-space Apps | > + | (Games, Browsers, ML, etc.) | > + +-----------------------------+ > + | > + v > + +---------------------------------------+ > + | Graphics APIs | Compute APIs | > + | (OpenGL, Vulkan) | (OpenCL, CUDA) | > + +---------------------------------------+ > + | | > + v v > + +---------------------+ +-----------------------+ > + | User-space Driver | | Compute Runtime | > + | (Mesa, AMD/NVIDIA) | | (OpenCL, CUDA, ROCm) | > + +---------------------+ +-----------------------+ > + | | > + +--------+----------+ > + | > + v > + +-----------------------+ > + | libdrm (DRM API) | > + +-----------------------+ > + | > + v > + +-------------------------------------------+ > + | Kernel DRM/KMS Driver (i915, amdgpu, | > + | nouveau, etc.) | > + +-------------------------------------------+ > + | | > + v v > + +----------------+ +-------------------+ > + | GPU Display HW | | GPU Compute Units | > + +----------------+ +-------------------+ > + > > Style Guidelines > ================ > The patch LGTM, thanks! Reviewed-by: Bagas Sanjaya <bagasdotme@gmail.com> -- An old man doll... just what I always wanted! - Clara [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 228 bytes --] ^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH v4] drm: add overview diagram for drm stack 2025-06-02 1:28 ` Bagas Sanjaya @ 2025-06-04 14:37 ` Simona Vetter 2025-06-05 2:01 ` Bagas Sanjaya 2025-06-09 18:23 ` Abdulrasaq Lawani 0 siblings, 2 replies; 5+ messages in thread From: Simona Vetter @ 2025-06-04 14:37 UTC (permalink / raw) To: Bagas Sanjaya Cc: Abdulrasaq Lawani, Maarten Lankhorst, Maxime Ripard, Thomas Zimmermann, David Airlie, Simona Vetter, Jonathan Corbet, dri-devel, linux-doc, linux-kernel On Mon, Jun 02, 2025 at 08:28:30AM +0700, Bagas Sanjaya wrote: > On Sun, Jun 01, 2025 at 06:18:47PM -0400, Abdulrasaq Lawani wrote: > > Add an overview diagram of Linux DRM architecture for > > graphics and compute to introduction.rst > > > > Signed-off-by: Abdulrasaq Lawani <abdulrasaqolawani@gmail.com> > > --- > > <snipped>... > > diff --git a/Documentation/gpu/introduction.rst b/Documentation/gpu/introduction.rst > > index 3cd0c8860b949408ed570d3f9384edd5f03df002..a8d3f953a470180b395ec52a45d0f3f4561424e0 100644 > > --- a/Documentation/gpu/introduction.rst > > +++ b/Documentation/gpu/introduction.rst > > @@ -14,7 +14,45 @@ including the TTM memory manager, output configuration and mode setting, > > and the new vblank internals, in addition to all the regular features > > found in current kernels. > > > > -[Insert diagram of typical DRM stack here] > > +Overview of the Linux DRM Architecture > > +-------------------------------------- > > +:: > > + > > + +-----------------------------+ > > + | User-space Apps | > > + | (Games, Browsers, ML, etc.) | > > + +-----------------------------+ > > + | > > + v > > + +---------------------------------------+ > > + | Graphics APIs | Compute APIs | > > + | (OpenGL, Vulkan) | (OpenCL, CUDA) | > > + +---------------------------------------+ > > + | | > > + v v > > + +---------------------+ +-----------------------+ > > + | User-space Driver | | Compute Runtime | > > + | (Mesa, AMD/NVIDIA) | | (OpenCL, CUDA, ROCm) | > > + +---------------------+ +-----------------------+ > > + | | > > + +--------+----------+ > > + | > > + v > > + +-----------------------+ > > + | libdrm (DRM API) | > > + +-----------------------+ > > + | > > + v > > + +-------------------------------------------+ > > + | Kernel DRM/KMS Driver (i915, amdgpu, | > > + | nouveau, etc.) | > > + +-------------------------------------------+ > > + | | > > + v v > > + +----------------+ +-------------------+ > > + | GPU Display HW | | GPU Compute Units | > > + +----------------+ +-------------------+ > > + I'm a bit late to the party, apologies. I'm not sure how much use there is in an extremely simplified diagram like this, least because it's really incomplete and leaves out the entire display and compositor side. My idea was that we'd instead link to the large pile of introductory and overview talks further down in this file, if people want to get an overview over what drm does. If you want I guess you could add some links to the relevant wikipedia pages, I think they also do a fairly decent job of explaining the big picture. Thanks, Sima > > > > Style Guidelines > > ================ > > > > The patch LGTM, thanks! > > Reviewed-by: Bagas Sanjaya <bagasdotme@gmail.com> > > -- > An old man doll... just what I always wanted! - Clara -- Simona Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch ^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH v4] drm: add overview diagram for drm stack 2025-06-04 14:37 ` Simona Vetter @ 2025-06-05 2:01 ` Bagas Sanjaya 2025-06-09 18:23 ` Abdulrasaq Lawani 1 sibling, 0 replies; 5+ messages in thread From: Bagas Sanjaya @ 2025-06-05 2:01 UTC (permalink / raw) To: Abdulrasaq Lawani, Maarten Lankhorst, Maxime Ripard, Thomas Zimmermann, David Airlie, Simona Vetter, Jonathan Corbet, dri-devel, linux-doc, linux-kernel [-- Attachment #1: Type: text/plain, Size: 3596 bytes --] On Wed, Jun 04, 2025 at 04:37:27PM +0200, Simona Vetter wrote: > On Mon, Jun 02, 2025 at 08:28:30AM +0700, Bagas Sanjaya wrote: > > On Sun, Jun 01, 2025 at 06:18:47PM -0400, Abdulrasaq Lawani wrote: > > > Add an overview diagram of Linux DRM architecture for > > > graphics and compute to introduction.rst > > > > > > Signed-off-by: Abdulrasaq Lawani <abdulrasaqolawani@gmail.com> > > > --- > > > <snipped>... > > > diff --git a/Documentation/gpu/introduction.rst b/Documentation/gpu/introduction.rst > > > index 3cd0c8860b949408ed570d3f9384edd5f03df002..a8d3f953a470180b395ec52a45d0f3f4561424e0 100644 > > > --- a/Documentation/gpu/introduction.rst > > > +++ b/Documentation/gpu/introduction.rst > > > @@ -14,7 +14,45 @@ including the TTM memory manager, output configuration and mode setting, > > > and the new vblank internals, in addition to all the regular features > > > found in current kernels. > > > > > > -[Insert diagram of typical DRM stack here] > > > +Overview of the Linux DRM Architecture > > > +-------------------------------------- > > > +:: > > > + > > > + +-----------------------------+ > > > + | User-space Apps | > > > + | (Games, Browsers, ML, etc.) | > > > + +-----------------------------+ > > > + | > > > + v > > > + +---------------------------------------+ > > > + | Graphics APIs | Compute APIs | > > > + | (OpenGL, Vulkan) | (OpenCL, CUDA) | > > > + +---------------------------------------+ > > > + | | > > > + v v > > > + +---------------------+ +-----------------------+ > > > + | User-space Driver | | Compute Runtime | > > > + | (Mesa, AMD/NVIDIA) | | (OpenCL, CUDA, ROCm) | > > > + +---------------------+ +-----------------------+ > > > + | | > > > + +--------+----------+ > > > + | > > > + v > > > + +-----------------------+ > > > + | libdrm (DRM API) | > > > + +-----------------------+ > > > + | > > > + v > > > + +-------------------------------------------+ > > > + | Kernel DRM/KMS Driver (i915, amdgpu, | > > > + | nouveau, etc.) | > > > + +-------------------------------------------+ > > > + | | > > > + v v > > > + +----------------+ +-------------------+ > > > + | GPU Display HW | | GPU Compute Units | > > > + +----------------+ +-------------------+ > > > + > > I'm a bit late to the party, apologies. I'm not sure how much use there is > in an extremely simplified diagram like this, least because it's really > incomplete and leaves out the entire display and compositor side. > > My idea was that we'd instead link to the large pile of introductory and > overview talks further down in this file, if people want to get an > overview over what drm does. So the stub that's being patched here can be removed, right? > > If you want I guess you could add some links to the relevant wikipedia > pages, I think they also do a fairly decent job of explaining the big > picture. What articles? Thanks. -- An old man doll... just what I always wanted! - Clara [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 228 bytes --] ^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH v4] drm: add overview diagram for drm stack 2025-06-04 14:37 ` Simona Vetter 2025-06-05 2:01 ` Bagas Sanjaya @ 2025-06-09 18:23 ` Abdulrasaq Lawani 1 sibling, 0 replies; 5+ messages in thread From: Abdulrasaq Lawani @ 2025-06-09 18:23 UTC (permalink / raw) To: Bagas Sanjaya, Abdulrasaq Lawani, Maarten Lankhorst, Maxime Ripard, Thomas Zimmermann, David Airlie, Simona Vetter, Jonathan Corbet, dri-devel, linux-doc, linux-kernel Hi, Should I go ahead make the diagram more detailed or just add the links in 'Slides and articles' & 'Conference talks' to the existing diagram? Best regards, On Wed, Jun 4, 2025 at 10:37 AM Simona Vetter <simona.vetter@ffwll.ch> wrote: > > On Mon, Jun 02, 2025 at 08:28:30AM +0700, Bagas Sanjaya wrote: > > On Sun, Jun 01, 2025 at 06:18:47PM -0400, Abdulrasaq Lawani wrote: > > > Add an overview diagram of Linux DRM architecture for > > > graphics and compute to introduction.rst > > > > > > Signed-off-by: Abdulrasaq Lawani <abdulrasaqolawani@gmail.com> > > > --- > > > <snipped>... > > > diff --git a/Documentation/gpu/introduction.rst b/Documentation/gpu/introduction.rst > > > index 3cd0c8860b949408ed570d3f9384edd5f03df002..a8d3f953a470180b395ec52a45d0f3f4561424e0 100644 > > > --- a/Documentation/gpu/introduction.rst > > > +++ b/Documentation/gpu/introduction.rst > > > @@ -14,7 +14,45 @@ including the TTM memory manager, output configuration and mode setting, > > > and the new vblank internals, in addition to all the regular features > > > found in current kernels. > > > > > > -[Insert diagram of typical DRM stack here] > > > +Overview of the Linux DRM Architecture > > > +-------------------------------------- > > > +:: > > > + > > > + +-----------------------------+ > > > + | User-space Apps | > > > + | (Games, Browsers, ML, etc.) | > > > + +-----------------------------+ > > > + | > > > + v > > > + +---------------------------------------+ > > > + | Graphics APIs | Compute APIs | > > > + | (OpenGL, Vulkan) | (OpenCL, CUDA) | > > > + +---------------------------------------+ > > > + | | > > > + v v > > > + +---------------------+ +-----------------------+ > > > + | User-space Driver | | Compute Runtime | > > > + | (Mesa, AMD/NVIDIA) | | (OpenCL, CUDA, ROCm) | > > > + +---------------------+ +-----------------------+ > > > + | | > > > + +--------+----------+ > > > + | > > > + v > > > + +-----------------------+ > > > + | libdrm (DRM API) | > > > + +-----------------------+ > > > + | > > > + v > > > + +-------------------------------------------+ > > > + | Kernel DRM/KMS Driver (i915, amdgpu, | > > > + | nouveau, etc.) | > > > + +-------------------------------------------+ > > > + | | > > > + v v > > > + +----------------+ +-------------------+ > > > + | GPU Display HW | | GPU Compute Units | > > > + +----------------+ +-------------------+ > > > + > > I'm a bit late to the party, apologies. I'm not sure how much use there is > in an extremely simplified diagram like this, least because it's really > incomplete and leaves out the entire display and compositor side. > > My idea was that we'd instead link to the large pile of introductory and > overview talks further down in this file, if people want to get an > overview over what drm does. > > If you want I guess you could add some links to the relevant wikipedia > pages, I think they also do a fairly decent job of explaining the big > picture. > > Thanks, Sima > > > > > > > > Style Guidelines > > > ================ > > > > > > > The patch LGTM, thanks! > > > > Reviewed-by: Bagas Sanjaya <bagasdotme@gmail.com> > > > > -- > > An old man doll... just what I always wanted! - Clara > > > > -- > Simona Vetter > Software Engineer, Intel Corporation > http://blog.ffwll.ch ^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2025-06-09 18:23 UTC | newest] Thread overview: 5+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2025-06-01 22:18 [PATCH v4] drm: add overview diagram for drm stack Abdulrasaq Lawani 2025-06-02 1:28 ` Bagas Sanjaya 2025-06-04 14:37 ` Simona Vetter 2025-06-05 2:01 ` Bagas Sanjaya 2025-06-09 18:23 ` Abdulrasaq Lawani
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).