[PATCH v2 4/5] Documentation/gpu: Add more information about GC

[Timur Kristóf]

On Mon, 2025-08-25 at 11:38 -0400, Alex Deucher wrote:
> On Sun, Aug 24, 2025 at 7:43 PM Rodrigo Siqueira
> <siqueira at igalia.com> wrote:
> 
> 
> > +
> > +First of all, note that the GC can have multiple SEs, depending on
> > the specific
> > +GPU/APU, and each SE has multiple Compute Units (CU). From the
> > diagram, you can
> > +see that CUs have a block named Schedulers. The reason the name is
> > in plural is
> > +because this hardware block is a combination of different micro-
> > schedules: CP,
> > +CPF, CPC, and CPG.
> 
> CP is not really in the same category as CPF, CPC, CPG.  CP is the
> front end to the GC block and contains a number of micro controllers
> which run firmware which software interacts with.  CPF, CPG, and CPC
> are just hardware implementation details.

Can you please suggest an edit that explains these better?

I'm sorry to say, I thought I understood it but after reading your
reply now I feel I don't.

> 
> > +
> >  The component that acts as the front end between the CPU and the
> > GPU is called
> > -the Command Processor (CP). This component is responsible for
> > providing greater
> > +CP (Command Processor). This component is responsible for
> > providing greater
> >  flexibility to the GC since CP makes it possible to program
> > various aspects of
> >  the GPU pipeline. CP also coordinates the communication between
> > the CPU and GPU
> >  via a mechanism named **Ring Buffers**, where the CPU appends
> > information to
> > -the buffer while the GPU removes operations. It is relevant to
> > highlight that a
> > -CPU can add a pointer to the Ring Buffer that points to another
> > region of
> > -memory outside the Ring Buffer, and CP can handle it; this
> > mechanism is called
> > -**Indirect Buffer (IB)**. CP receives and parses the Command
> > Streams (CS), and
> > -writes the operations to the correct hardware blocks.
> > +the buffer while the GPU removes operations. Finally, CP is also
> > responsible
> > +for handling Indirect Buffers (IB).
> > +
> > +After CP completes the first set of processing, which includes
> > separate command
> > +packets specific to GFX and Compute, other blocks step in. To
> > handle commands
> > +for the compute block, CPC (Command Processor Command) takes over,
> > and for
> > +handling Graphics operations, the CPG (Command Processor Graphics)
> > takes
> > +action. Another essential block to ensure the optimal utilization
> > of CPC and
> > +CPG is the CPF (Command Processor Fetcher), which helps these
> > blocks to be
> > +constantly fed. Note that CPG contains the PFP (Pre-Fetch Parser),
> > ME
> > +(MicroEngine), and CE (Constant Engine) in the case of chips that
> > support it.
> > +CPC contains MEC (MicroEngine Compute), and CPF is another
> > hardware block that
> > +provides services to CPG and CPC.
> 
> I'm not sure how much value this provides to the average developer.
> These are sort of implementation details of the hardware.  In general
> the driver doesn't really interact with the individual hardware
> blocks
> and they may not stay consistent over time.
> 
> Alex

Not sure what you mean by "the average developer", but I think this is
very useful knowledge to anyone who wants to contribute to amdgpu,
specifically to the parts that have anything to do with GFX or compute.

If you're worried that it may not stay consistent over time, I think
the glossary entries could be edited to mention which GPU generation(s)
they apply to.

As-is the code is full of 3-letter abbreviations that are never
expanded or explained anywhere, which represent various hardware units
(or microcontrollers, or blocks, or whatever they may be). Without
knowing what these are and how they interact, it's difficult to
understand what the code is doing any why, or even why some parts are
necessary.

To make matters worse, the latest public documentation that tries to
explain any of this is from 2012. So I think it's a good idea to
collect all of this information so that newcomers to the kernel driver
such as myself have a chance.

Thanks & best regards,
Timur