drivers/gpu/drm/i915/gt/shaders/README

Source file repositories/reference/linux-study-clean/drivers/gpu/drm/i915/gt/shaders/README

File Facts

System
Linux kernel
Corpus path
drivers/gpu/drm/i915/gt/shaders/README
Extension
[no extension]
Size
1625 bytes
Lines
47
Domain
Driver Families
Bucket
drivers/gpu
Inferred role
Driver Families: drivers/gpu
Status
atlas-only

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

Dependency Surface

Detected Declarations

Annotated Snippet

ASM sources for auto generated shaders
======================================

The i915/gt/hsw_clear_kernel.c and i915/gt/ivb_clear_kernel.c files contain
pre-compiled batch chunks that will clear any residual render cache during
context switch.

They are generated from their respective platform ASM files present on
i915/gt/shaders/clear_kernel directory.

The generated .c files should never be modified directly. Instead, any modification
needs to be done on the on their respective ASM files and build instructions below
needs to be followed.

Building
========

Environment
-----------

IGT GPU tool scripts and the Mesa's i965 instruction assembler tool are used
on building.

Please make sure your Mesa tool is compiled with "-Dtools=intel" and
"-Ddri-drivers=i965", and run this script from IGT source root directory"

The instructions below assume:
    *  IGT gpu tools source code is located on your home directory (~) as ~/igt
    *  Mesa source code is located on your home directory (~) as ~/mesa
       and built under the ~/mesa/build directory
    *  Linux kernel source code is under your home directory (~) as ~/linux

Instructions
------------

~ $ cp ~/linux/drivers/gpu/drm/i915/gt/shaders/clear_kernel/ivb.asm \
       ~/igt/lib/i915/shaders/clear_kernel/ivb.asm
~ $ cd ~/igt
igt $ ./scripts/generate_clear_kernel.sh -g ivb \
      -m ~/mesa/build/src/intel/tools/i965_asm

~ $ cp ~/linux/drivers/gpu/drm/i915/gt/shaders/clear_kernel/hsw.asm \
    ~/igt/lib/i915/shaders/clear_kernel/hsw.asm
~ $ cd ~/igt
igt $ ./scripts/generate_clear_kernel.sh -g hsw \
      -m ~/mesa/build/src/intel/tools/i965_asm

Annotation

Implementation Notes