xref: /openbmc/linux/drivers/gpu/drm/i915/gt/shaders/README (revision 08f3e087)
1ASM sources for auto generated shaders
2======================================
3
4The i915/gt/hsw_clear_kernel.c and i915/gt/ivb_clear_kernel.c files contain
5pre-compiled batch chunks that will clear any residual render cache during
6context switch.
7
8They are generated from their respective platform ASM files present on
9i915/gt/shaders/clear_kernel directory.
10
11The generated .c files should never be modified directly. Instead, any modification
12needs to be done on the on their respective ASM files and build instructions below
13needes to be followed.
14
15Building
16========
17
18Environment
19-----------
20
21IGT GPU tool scripts and the Mesa's i965 instruction assembler tool are used
22on building.
23
24Please make sure your Mesa tool is compiled with "-Dtools=intel" and
25"-Ddri-drivers=i965", and run this script from IGT source root directory"
26
27The instructions bellow assume:
28    *  IGT gpu tools source code is located on your home directory (~) as ~/igt
29    *  Mesa source code is located on your home directory (~) as ~/mesa
30       and built under the ~/mesa/build directory
31    *  Linux kernel source code is under your home directory (~) as ~/linux
32
33Instructions
34------------
35
36~ $ cp ~/linux/drivers/gpu/drm/i915/gt/shaders/clear_kernel/ivb.asm \
37       ~/igt/lib/i915/shaders/clear_kernel/ivb.asm
38~ $ cd ~/igt
39igt $ ./scripts/generate_clear_kernel.sh -g ivb \
40      -m ~/mesa/build/src/intel/tools/i965_asm
41
42~ $ cp ~/linux/drivers/gpu/drm/i915/gt/shaders/clear_kernel/hsw.asm \
43    ~/igt/lib/i915/shaders/clear_kernel/hsw.asm
44~ $ cd ~/igt
45igt $ ./scripts/generate_clear_kernel.sh -g hsw \
46      -m ~/mesa/build/src/intel/tools/i965_asm