Re: [PATCH 6/6] Documentation/gpu: Add DC glossary

On Thu, Nov 25, 2021 at 10:40 AM Rodrigo Siqueira Rodrigo.Siqueira@amd.com wrote:

In the DC driver, we have multiple acronyms that are not obvious most of the time. This commit introduces a DC glossary in order to make it easier to navigate through our driver.

Signed-off-by: Rodrigo Siqueira Rodrigo.Siqueira@amd.com

Documentation/gpu/amdgpu-dc/amdgpu-dc.rst | 2 +- Documentation/gpu/amdgpu-dc/dc-glossary.rst | 257 ++++++++++++++++++++ 2 files changed, 258 insertions(+), 1 deletion(-) create mode 100644 Documentation/gpu/amdgpu-dc/dc-glossary.rst

diff --git a/Documentation/gpu/amdgpu-dc/amdgpu-dc.rst b/Documentation/gpu/amdgpu-dc/amdgpu-dc.rst index 2e45e83d9a2a..15405c43786a 100644 --- a/Documentation/gpu/amdgpu-dc/amdgpu-dc.rst +++ b/Documentation/gpu/amdgpu-dc/amdgpu-dc.rst @@ -26,4 +26,4 @@ table of content: amdgpu-dcn-overview.rst amdgpu-dm.rst amdgpu-dc-debug.rst

• dc-glossary.rst

diff --git a/Documentation/gpu/amdgpu-dc/dc-glossary.rst b/Documentation/gpu/amdgpu-dc/dc-glossary.rst new file mode 100644 index 000000000000..48698fc1799f --- /dev/null +++ b/Documentation/gpu/amdgpu-dc/dc-glossary.rst @@ -0,0 +1,257 @@ +=========== +DC Glossary +===========

+.. glossary::

• ABM

•  Adaptive Backlight Modulation
  

• APU

•  Accelerated Processing Unit
  

• ASIC

•  Application-Specific Integrated Circuit
  

• ASSR

•  Alternate Scrambler Seed Reset
  

• AZ

•  Azalia (HD audio DMA engine)
  

• BPC

•  Bits Per Colour/Component
  

• BPP

•  Bits Per Pixel
  

• Clocks

•  * PCLK: Pixel Clock
  

•  * SYMCLK: Symbol Clock
  

•  * SOCCLK: GPU Engine Clock
  

•  * DISPCLK: Display Clock
  

•  * DPPCLK: DPP Clock
  

•  * DCFCLK: Display Controller Fabric Clock
  

•  * REFCLK: Real Time Reference Clock
  

•  * PPLL: Pixel PLL
  

•  * FCLK: Fabric Clock
  

•  * MCLK: Memory Clock
  

•  * CPLIB: Content Protection Library
  

CPLIB is not a clock. It should be split out as its own item.

• CRC

•  Cyclic Redundancy Check
  

• CRTC

•  Cathode Ray Tube Controller - commonly called "Controller" - Generates
  

•  raw stream of pixels, clocked at pixel clock
  

• CVT

•  Coordinated Video Timings
  

• DAL

•  Display Abstraction layer
  

• DC (Software)

•  Display Core
  

• DC (Hardware)

•  Display Controller
  

• DCC

•  Delta Colour Compression
  

• DCE

•  Display Controller Engine
  

• DCHUB

•  Display Controller Hub
  

• ARB

•  Arbiter
  

• VTG

•  Vertical Timing Generator
  

• DCN

•  Display Core Next
  

• DCCG

•  Display Clock Generator block
  

• DDC

•  Display Data Channel
  

• DFS

•  Digital Frequency Synthesizer
  

• DIO

•  Display IO
  

• DPP

•  Display Pipes and Planes
  

• DSC

•  Display Stream Compression (Reduce the amount of bits to represent pixel
  

•  count while at the same pixel clock)
  

• dGPU

•  discrete GPU
  

• DMIF

•  Display Memory Interface
  

• DML

•  Display Mode Library
  

• DMCU

•  Display Micro Controller Unit
  

• DMCUB

•  Display Micro-Controller Unit, version B
  

Make Micro Controller vs. Micro-Controller consistent for these.

• DPCD

•  DisplayPort Configuration Data
  

• DPM(S)

•  Display Power Management (Signaling)
  

• DRR

•  Dynamic Refresh Rate
  

• DWB

•  Display writeback
  

• ECP

•  Enhanced Content Protection
  

• FB

•  Frame Buffer
  

• FBC

•  Frame Buffer Compression
  

• FEC

•  Forward Error Correction
  

• FRL

•  Fixed Rate Link
  

• GCO

•  Graphical Controller Object
  

• GMC

•  Graphic Memory Controller
  

• GSL

•  Global Swap Lock
  

• iGPU

•  integrated GPU
  

• IH

•  Interrupt Handler
  

• ISR

•  Interrupt Service Request
  

• ISV

•  Independent Software Vendor
  

• KMD

•  Kernel Mode Driver
  

• LB

•  Line Buffer
  

• LFC

•  Low Framerate Compensation
  

• LTTPR

•  Link Training Tunable Phy Repeater
  

• LUT

•  Lookup Table
  

• MALL

•  Memory Access at Last Level
  

• MC

•  Memory Controller
  

• MPC

•  Multiple pipes and plane combine
  

• MPO

•  Multi Plane Overlay
  

• MST

•  Multi Stream Transport
  

• NBP State

•  Northbridge Power State
  

• NBIO

•  North Bridge Input/Output
  

• ODM

•  Output Data Mapping
  

• OPM

•  Output Protection Manager
  

• OPP

•  Output Plane Processor
  

• OPTC

•  Output Pipe Timing Combiner
  

• OTG

•  Output Timing Generator
  

• PCON

•  Power Controller
  

• PGFSM

•  Power Gate Finite State Machine
  

• PPLib

•  PowerPlay Library
  

Maybe say that powerplay is the power management component.

• PSR

•  Panel Self Refresh
  

• SCL

•  Scaler
  

• SDP

•  Scalable Data Port
  

• SMU

•  System Management Unit
  

• SLS

•  Single Large Surface
  

• SST

•  Single Stream Transport
  

• TMDS

•  Transition-Minimized Differential Signaling
  

• TMZ

•  Trusted Memory Zone
  

• TTU

•  Time to Underflow
  

• VRR

•  Variable Refresh Rate
  

• UVD

•  Unified Video Decoder
  

• VCE

•  Video Compression Engine
  

• VCN

•  Video Codec Next
  

-- 2.25.1