* [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).