AMDGPU Glossary

AMDGPU 용어집의 범위와 활성 CU 수

이 문서는 `amdgpu` driver 전반에서 사용하는 일반 약어를 설명합니다. Display Core 전용 용어는 별도 문서 `Documentation/gpu/amdgpu/display/dc-glossary.rst`에 있으므로, 여기서는 graphics, compute, memory, queue, power, security, video 영역의 공통 용어에 집중합니다.

표제어는 source code, trace, register 문서와 대조할 수 있도록 번역하지 않고 원문 그대로 둡니다. 정의에서는 약어의 전체 이름을 보존한 뒤 AMDGPU에서 가리키는 하드웨어·소프트웨어 역할을 한국어로 설명합니다.

===============
AMDGPU Glossary
===============

Here you can find some generic acronyms used in the amdgpu driver. Notice that
we have a dedicated glossary for Display Core at
'Documentation/gpu/amdgpu/display/dc-glossary.rst'.

.. glossary::

    active_cu_number
      The number of CUs that are active on the system.  The number of active
      CUs may be less than SE * SH * CU depending on the board configuration.

전원 상태, 명령 처리, 버퍼와 기본 블록

이 구간은 BACO·BOCO 전원 상태, command submission과 processor, color/depth buffer, 콘텐츠 보호, pipeline 완료, function reset 같은 기본 약어를 정의합니다. `CIK`는 약어 확장이라기보다 Sea Islands 세대를 나타내는 코드명입니다.

    BACO
      Bus Alive, Chip Off

    BOCO
      Bus Off, Chip Off

    CE
      Constant Engine

    CIK
      Sea Islands

    CB
      Color Buffer

    CP
      Command Processor

    CPLIB
      Content Protection Library

    CS
      Command Submission

    CSB
      Clear State Indirect Buffer

    CU
      Compute Unit

    DB
      Depth Buffer

    DFS
      Digital Frequency Synthesizer

    ECP
      Enhanced Content Protection

    EOP
      End Of Pipe/Pipeline

    FLR
      Function Level Reset

주소 변환과 메모리 계층

`GART`, `GPUVM`, `GTT`는 서로 연관되지만 같은 개념이 아닙니다. GPUVM은 GPU의 virtual-memory/MMU 체계이고, GART는 커널 드라이버가 사용하는 GPUVM page table을 역사적으로 부르는 이름이며, GTT는 TTM이 관리하는 system-resource memory pool입니다.

AGP 시절에는 플랫폼 MMU가 흩어진 DMA page를 연속 주소처럼 보이게 했습니다. 이후 주소 변환 장치가 GPU로 이동했어도 `GART`라는 이름은 남았고, 현재는 system memory와 MMIO 자원을 GPU address space에 매핑하는 page table 문맥에서 사용됩니다.

    GART
      Graphics Address Remapping Table.  This is the name we use for the GPUVM
      page table used by the GPU kernel driver.  It remaps system resources
      (memory or MMIO space) into the GPU's address space so the GPU can access
      them.  The name GART harkens back to the days of AGP when the platform
      provided an MMU that the GPU could use to get a contiguous view of
      scattered pages for DMA.  The MMU has since moved on to the GPU, but the
      name stuck.

    GC
      Graphics and Compute

    GDS
      Global Data Share

    GE
      Geometry Engine

    GMC
      Graphic Memory Controller

    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
      allow the GPU to remap VRAM and system resources into GPU virtual address
      spaces for use by the GPU kernel driver and applications using the GPU.
      These provide memory protection for different applications using the GPU.

    GTT
      Graphics Translation Tables.  This is a memory pool managed through TTM
      which provides access to system resources (memory or MMIO space) for
      use by the GPU. These addresses can be mapped into the "GART" GPUVM page
      table for use by the kernel driver or into per process GPUVM page tables
      for application usage.

Interrupt, queue와 microengine

이 구간은 interrupt 처리, indirect command buffer, kernel queue, HSA compute용 KFD, memory/queue descriptor, graphics·compute microengine과 scheduler를 설명합니다. `HQD`는 하드웨어 queue를, `MQD`는 메모리에 저장된 queue 상태를 기술한다는 차이가 있습니다.

`ME`, `MEC`, `MES`는 이름이 비슷하지만 각각 graphics microengine, compute microengine, microengine scheduler를 뜻합니다. `KCQ`, `KGQ`, `KIQ`도 compute, graphics, kernel interface라는 queue 목적을 표제어에서 구분합니다.

    IH
      Interrupt Handler

    HQD
      Hardware Queue Descriptor

    IB
      Indirect Buffer

    IMU
      Integrated Management Unit (Power Management support)

    IP
        Intellectual Property blocks

    KCQ
      Kernel Compute Queue

    KFD
      Kernel Fusion Driver

    KGQ
      Kernel Graphics Queue

    KIQ
      Kernel Interface Queue

    MC
      Memory Controller

    MCBP
      Mid Command Buffer Preemption

    ME
      MicroEngine (Graphics)

    MEC
      MicroEngine Compute

    MES
      MicroEngine Scheduler

    MMHUB
      Multi-Media HUB

    MQD
      Memory Queue Descriptor

Graphics pipeline, 전력과 보안

`PA`는 문맥에 따라 Primitive Assembler 또는 Physical Address라는 두 의미를 갖습니다. `RB`는 Render Backend이며 ROPs라고 부르는 경우도 있습니다. `RLC`는 역사적 명칭이 남은 helper-engine 그룹이므로 현대 하드웨어에서 이름을 문자 그대로 해석하면 안 됩니다.

`PPLib`, `PSP`, `SMU/SMC`는 각각 PowerPlay 전력 관리 library, platform security processor, system-management unit/controller를 뜻합니다. pipeline 약어와 관리 약어를 구분하면 register name과 firmware log를 해석하기 쉽습니다.

    PA
      Primitive Assembler / Physical Address

    PFP
      Pre-Fetch Parser (Graphics)

    PPLib
      PowerPlay Library - PowerPlay is the power management component.

    PSP
        Platform Security Processor

    RB
      Render Backends. Some people called it ROPs.

    RLC
      RunList Controller. This name is a remnant of past ages and doesn't have
      much meaning today. It's a group of general-purpose helper engines for
      the GFX block. It's involved in GFX power management and SR-IOV, among
      other things.

    SC
      Scan Converter

    SDMA
      System DMA

    SE
      Shader Engine

    SGPR
      Scalar General-Purpose Registers

    SH
      SHader array

    SI
      Southern Islands

    SMU/SMC
      System Management Unit / System Management Controller

상태 저장, video engine과 accelerator partition

마지막 구간은 shader input/export와 register, 상태 save/restore list, trusted application, user-mode scheduler, video engine, virtual-memory ID, accelerator partition 용어를 다룹니다. `SPI (AMDGPU)`는 다른 분야의 SPI와 혼동하지 않도록 문서가 명시한 괄호 표기를 유지합니다.

Video 세대 용어는 `UVD`(decode), `VCE`(encode/compression), `VCN`(통합 codec), `VPE`(video processing)로 역할이 다릅니다. `XCC`는 accelerator core complex이고 `XCP`는 accelerator core partition이므로 물리 자원 묶음과 그 논리적 분할을 구별해야 합니다.

    SPI (AMDGPU)
      Shader Processor Input

    SRLC
      Save/Restore List Control

    SRLG
      Save/Restore List GPM_MEM

    SRLS
      Save/Restore List SRM_MEM

    SS
      Spread Spectrum

    SX
      Shader Export

    TA
      Trusted Application

    TC
      Texture Cache

    TOC
      Table of Contents

    UMSCH
      User Mode Scheduler

    UVD
      Unified Video Decoder

    VCE
      Video Compression Engine

    VCN
      Video Codec Next

    VGPR
      Vector General-Purpose Registers

    VMID
      Virtual Memory ID

    VPE
      Video Processing Engine

    XCC
      Accelerator Core Complex

    XCP
      Accelerator Core Partition