1This directory contains a copy of the installed kernel headers 2required by the iHD driver to communicate with the kernel. 3Whenever driver needs new definitions for new kernel 4APIs, these files should be updated. 5 6These files in master should only be updated once the changes have landed 7in the drm-next tree (see https://cgit.freedesktop.org/drm/drm/). 8 9You can copy files installed after running this from the kernel 10repository, at version the driver require: 11 12$ make headers_install INSTALL_HDR_PATH=/path/to/install 13 14The last update was done at the following kernel commit: 15 16commit 81b1b599dfd71c958418dad586fa72c8d30d1065 17Author: Fei Yang <fei.yang@intel.com> 18Date: Tue Jun 6 12:00:42 2023 +0200 19 20 drm/i915: Allow user to set cache at BO creation 21 22 To comply with the design that buffer objects shall have immutable 23 cache setting through out their life cycle, {set, get}_caching ioctl's 24 are no longer supported from MTL onward. With that change caching 25 policy can only be set at object creation time. The current code 26 applies a default (platform dependent) cache setting for all objects. 27 However this is not optimal for performance tuning. The patch extends 28 the existing gem_create uAPI to let user set PAT index for the object 29 at creation time. 30 The new extension is platform independent, so UMD's can switch to using 31 this extension for older platforms as well, while {set, get}_caching are 32 still supported on these legacy paltforms for compatibility reason. 33 However, since PAT index was not clearly defined for platforms prior to 34 GEN12 (TGL), so we are limiting this externsion to GEN12+ platforms 35 only. See ext_set_pat() in for the implementation details. 36 37 The documentation related to the PAT/MOCS tables is currently available 38 for Tiger Lake here: 39 https://www.intel.com/content/www/us/en/docs/graphics-for-linux/developer-reference/1-0/tiger-lake.html 40 41 The documentation for other platforms is currently being updated. 42 43 BSpec: 45101 44 45 Mesa support has been submitted in this merge request: 46 https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/22878 47 48 The media driver supprt has bin submitted in this merge request: 49 https://github.com/intel/media-driver/pull/1680 50 51 The IGT test related to this change is 52 igt@gem_create@create-ext-set-pat 53 54 Signed-off-by: Fei Yang <fei.yang@intel.com> 55 Cc: Chris Wilson <chris.p.wilson@linux.intel.com> 56 Cc: Matt Roper <matthew.d.roper@intel.com> 57 Cc: Andi Shyti <andi.shyti@linux.intel.com> 58 Reviewed-by: Andi Shyti <andi.shyti@linux.intel.com> 59 Acked-by: Jordan Justen <jordan.l.justen@intel.com> 60 Tested-by: Jordan Justen <jordan.l.justen@intel.com> 61 Acked-by: Carl Zhang <carl.zhang@intel.com> 62 Tested-by: Lihao Gu <lihao.gu@intel.com> 63 Signed-off-by: Andi Shyti <andi.shyti@linux.intel.com> 64 Acked-by: Tvrtko Ursulin <tvrtko.ursulin@intel.com> 65 Acked-by: Slawomir Milczarek <slawomir.milczarek@intel.com> 66 Link: https://patchwork.freedesktop.org/patch/msgid/20230606100042.482345-2-andi.shyti@linux.intel.com 67 68