[PATCH 2/5] Documentation/gpu: Add new glossary entries from UMR

[Rodrigo Siqueira]

On 08/20, Timur Kristóf wrote:
> On Tue, 2025-08-19 at 16:14 -0400, Alex Deucher wrote:
> > On Tue, Aug 19, 2025 at 3:28 PM Timur Kristóf
> > <timur.kristof at gmail.com> wrote:
> > > 
> > > Hi,
> > > 
> > > On Sat, 2025-08-16 at 09:31 -0600, Rodrigo Siqueira wrote:
> > > > When using UMR, a dashboard is available that displays the CPC,
> > > > CPF,
> > > > CPG, TCP, and UTCL utilization. This commit introduces the
> > > > meanings
> > > > of
> > > > those acronyms (and others) to the glossary to improve the
> > > > comprehension
> > > > of the UMR dashboard.
> > > > 
> > > > Cc: Alex Deucher <alexander.deucher at amd.com>
> > > > Cc: Christian König <christian.koenig at amd.com>
> > > > Cc: Timur Kristóf <timur.kristof at gmail.com>
> > > > Signed-off-by: Rodrigo Siqueira <siqueira at igalia.com>
> > > > ---
> > > >  Documentation/gpu/amdgpu/amdgpu-glossary.rst | 21
> > > > ++++++++++++++++++++
> > > >  1 file changed, 21 insertions(+)
> > > > 
> > > > diff --git a/Documentation/gpu/amdgpu/amdgpu-glossary.rst
> > > > b/Documentation/gpu/amdgpu/amdgpu-glossary.rst
> > > > index 30812d9d53c6..eb72e6f6d4f1 100644
> > > > --- a/Documentation/gpu/amdgpu/amdgpu-glossary.rst
> > > > +++ b/Documentation/gpu/amdgpu/amdgpu-glossary.rst
> > > > @@ -30,6 +30,15 @@ we have a dedicated glossary for Display Core
> > > > at
> > > >      CP
> > > >        Command Processor
> > > > 
> > > > +    CPC
> > > > +      Command Processor Compute
> > > > +
> > > > +    CPF
> > > > +      Command Processor Fetch
> > > > +
> > > > +    CPG
> > > > +      Command Processor Graphics
> > > > +
> > > 
> > > I would apprectiate a few more details here to connect these to
> > > other
> > > glossary items. Here are a few questions:
> > > 
> > > - Is CPC the same as MEC?
> > > - Is CPF the same as PFP?
> > > - Is CPG the same as ME?
> > 
> > CPC, CPF, and CPG are hardware blocks, MEC/PFP/ME are
> > microcontrollers.  CPG contains the PFP and ME (and CE on chips which
> > support it).  CPC contains MEC.  CPF is another hardware block which
> > provides services to CPG and CPC.
> 
> Thanks for the clarification.
> 
> Siquiera - could we add that also to the glossary?

Hi Timur,

All of the acronyms mentioned are already part of the glossary, and this
commit introduces the missing ones. For more details about the
relationship between the different hardware blocks, patch number 4
provides additional information. I can add Alex's comments to patch 4 in
V2. I'll wait a little bit to see if anyone else has any comments on
patches 3, 4 and 5, before I send a V2.

Thanks

> 
> Thanks,
> Timur
> 
> > 
> > 
> > > 
> > > >      CPLIB
> > > >        Content Protection Library
> > > > 
> > > > @@ -78,6 +87,9 @@ we have a dedicated glossary for Display Core
> > > > at
> > > >      GMC
> > > >        Graphic Memory Controller
> > > > 
> > > > +    GPR
> > > > +      General Purpose Register
> > > > +
> > > 
> > > Does this refer to registers in shaders or registers in the various
> > > IP
> > > blocks? If this is about shaders, it would be useful to mention
> > > that in
> > > the context of shaders, a GPR is either SGPR or VGPR. (Those two
> > > are
> > > already in the glossary.)
> > > 
> > > >      GPUVM
> > > >        GPU Virtual Memory.  This is the GPU's MMU.  The GPU
> > > > supports
> > > > multiple
> > > >        virtual address spaces that can be in flight at any given
> > > > time.  These
> > > > @@ -92,6 +104,9 @@ we have a dedicated glossary for Display Core
> > > > at
> > > >        table for use by the kernel driver or into per process
> > > > GPUVM
> > > > page tables
> > > >        for application usage.
> > > > 
> > > > +    GWS
> > > > +      Global Wave Syncs
> > > > +
> > > >      IH
> > > >        Interrupt Handler
> > > > 
> > > > @@ -206,12 +221,18 @@ we have a dedicated glossary for Display
> > > > Core
> > > > at
> > > >      TC
> > > >        Texture Cache
> > > > 
> > > > +    TCP (AMDGPU)
> > > > +      Texture Cache Processing
> > > > +
> > > >      TOC
> > > >        Table of Contents
> > > > 
> > > >      UMSCH
> > > >        User Mode Scheduler
> > > > 
> > > > +    UTCL
> > > > +      Universal Texture Cache Line
> > > > +
> > > >      UVD
> > > >        Unified Video Decoder
> > > > 

-- 
Rodrigo Siqueira