gt/shaders/README

   1 ASM sources for auto generated shaders
   2 ======================================
   3
   4 The i915/gt/hsw_clear_kernel.c and i915/gt/ivb_clear_kernel.c files contain
   5 pre-compiled batch chunks that will clear any residual render cache during
   6 context switch.
   7
   8 They are generated from their respective platform ASM files present on
   9 i915/gt/shaders/clear_kernel directory.
  10
  11 The generated .c files should never be modified directly. Instead, any modification
  12 needs to be done on the on their respective ASM files and build instructions below
  13 needes to be followed.
  14
  15 Building
  16 ========
  17
  18 Environment
  19 -----------
  20
  21 IGT GPU tool scripts and the Mesa's i965 instruction assembler tool are used
  22 on building.
  23
  24 Please 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
  27 The 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
  33 Instructions
  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
  39 igt $ ./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
  45 igt $ ./scripts/generate_clear_kernel.sh -g hsw \
  46       -m ~/mesa/build/src/intel/tools/i965_asm