Commit d38d753d authored by Rodrigo Vivi's avatar Rodrigo Vivi

drm/i915: Add missing CCS documentation

Let's introduce the basic documentation about CCS.
While doing that, also removed the legacy execution flag name. That flag
simply doesn't exist for CCS and it is not needed on current context
submission. Those flag names are only needed on legacy context,
while on new ones we only need to pass the engine ID.

It is worth mention that this documentation should probably live with
the engine definitions rather than in the i915.rst file directly and
that more updates are likely need in this section. But this should
come later.

v2: Overall improvements from Matt and Tvrtko.

Fixes: 944823c9 ("drm/i915/xehp: Define compute class and engine")
Cc: Matt Roper <matthew.d.roper@intel.com>
Cc: Sushma Venkatesh Reddy <sushma.venkatesh.reddy@intel.com>
Cc: Joonas Lahtinen <joonas.lahtinen@linux.intel.com>
Cc: Tvrtko Ursulin <tvrtko.ursulin@intel.com>
Signed-off-by: default avatarRodrigo Vivi <rodrigo.vivi@intel.com>
Acked-by: default avatarTvrtko Ursulin <tvrtko.ursulin@intel.com>
Reviewed-by: default avatarMatt Roper <matthew.d.roper@intel.com>
Link: https://patchwork.freedesktop.org/patch/msgid/20230926165107.23440-1-rodrigo.vivi@intel.com
parent 4c769061
...@@ -267,19 +267,18 @@ i915 driver. ...@@ -267,19 +267,18 @@ i915 driver.
Intel GPU Basics Intel GPU Basics
---------------- ----------------
An Intel GPU has multiple engines. There are several engine types. An Intel GPU has multiple engines. There are several engine types:
- RCS engine is for rendering 3D and performing compute, this is named - Render Command Streamer (RCS). An engine for rendering 3D and
`I915_EXEC_RENDER` in user space. performing compute.
- BCS is a blitting (copy) engine, this is named `I915_EXEC_BLT` in user - Blitting Command Streamer (BCS). An engine for performing blitting and/or
space. copying operations.
- VCS is a video encode and decode engine, this is named `I915_EXEC_BSD` - Video Command Streamer. An engine used for video encoding and decoding. Also
in user space sometimes called 'BSD' in hardware documentation.
- VECS is video enhancement engine, this is named `I915_EXEC_VEBOX` in user - Video Enhancement Command Streamer (VECS). An engine for video enhancement.
space. Also sometimes called 'VEBOX' in hardware documentation.
- The enumeration `I915_EXEC_DEFAULT` does not refer to specific engine; - Compute Command Streamer (CCS). An engine that has access to the media and
instead it is to be used by user space to specify a default rendering GPGPU pipelines, but not the 3D pipeline.
engine (for 3D) that may or may not be the same as RCS.
The Intel GPU family is a family of integrated GPU's using Unified The Intel GPU family is a family of integrated GPU's using Unified
Memory Access. For having the GPU "do work", user space will feed the Memory Access. For having the GPU "do work", user space will feed the
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment