Intel-GFX Archive on lore.kernel.org
 help / color / mirror / Atom feed
* [Intel-gfx] [PATCH] drm/i915: Add missing CCS documentation.
@ 2023-08-23 21:39 Rodrigo Vivi
  2023-08-23 22:22 ` Matt Roper
                   ` (7 more replies)
  0 siblings, 8 replies; 14+ messages in thread
From: Rodrigo Vivi @ 2023-08-23 21:39 UTC (permalink / raw)
  To: intel-gfx; +Cc: Matt Roper, Sushma Venkatesh Reddy, Rodrigo Vivi

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.

Fixes: 944823c94639 ("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: Rodrigo Vivi <rodrigo.vivi@intel.com>
---
 Documentation/gpu/i915.rst | 24 +++++++++++-------------
 1 file changed, 11 insertions(+), 13 deletions(-)

diff --git a/Documentation/gpu/i915.rst b/Documentation/gpu/i915.rst
index 60ea21734902..87bdcd616944 100644
--- a/Documentation/gpu/i915.rst
+++ b/Documentation/gpu/i915.rst
@@ -267,19 +267,17 @@ i915 driver.
 Intel GPU Basics
 ----------------
 
-An Intel GPU has multiple engines. There are several engine types.
-
-- RCS engine is for rendering 3D and performing compute, this is named
-  `I915_EXEC_RENDER` in user space.
-- BCS is a blitting (copy) engine, this is named `I915_EXEC_BLT` in user
-  space.
-- VCS is a video encode and decode engine, this is named `I915_EXEC_BSD`
-  in user space
-- VECS is video enhancement engine, this is named `I915_EXEC_VEBOX` in user
-  space.
-- The enumeration `I915_EXEC_DEFAULT` does not refer to specific engine;
-  instead it is to be used by user space to specify a default rendering
-  engine (for 3D) that may or may not be the same as RCS.
+An Intel GPU has multiple engines. There are several engine types:
+
+- Render Command Streamer (RCS). An engine for rendering 3D and
+  performing compute on platforms without CCS.
+- Blitting Command Streamer (BCS). An engine for performing blitting and/or
+  copying operations.
+- Video Command Streamer. An engine used for video decoding. For historical
+  reasons this engine was alsso called 'BCS'.
+- Video Enhancement Command Streamer (VECS). The engine used only by media.
+- Compute Command Streamer (CCS). An engine that has access to the media and
+  GPGPU pipelines, but not the 3D pipeline.
 
 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
-- 
2.41.0


^ permalink raw reply related	[flat|nested] 14+ messages in thread

end of thread, other threads:[~2023-09-26 14:40 UTC | newest]

Thread overview: 14+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2023-08-23 21:39 [Intel-gfx] [PATCH] drm/i915: Add missing CCS documentation Rodrigo Vivi
2023-08-23 22:22 ` Matt Roper
2023-08-24 22:06   ` Rodrigo Vivi
2023-08-24 22:16     ` Matt Roper
2023-08-23 23:33 ` [Intel-gfx] ✗ Fi.CI.CHECKPATCH: warning for " Patchwork
2023-08-23 23:33 ` [Intel-gfx] ✗ Fi.CI.SPARSE: " Patchwork
2023-08-23 23:46 ` [Intel-gfx] ✓ Fi.CI.BAT: success " Patchwork
2023-08-24  6:51 ` [Intel-gfx] ✓ Fi.CI.IGT: " Patchwork
2023-09-21  8:29 ` [Intel-gfx] [PATCH] " Tvrtko Ursulin
2023-09-26  2:00   ` Rodrigo Vivi
2023-09-26  8:36     ` Tvrtko Ursulin
2023-09-26 14:40       ` Matt Roper
2023-09-26  5:16 ` [Intel-gfx] ✓ Fi.CI.BAT: success for drm/i915: Add missing CCS documentation. (rev2) Patchwork
2023-09-26 14:20 ` [Intel-gfx] ✓ Fi.CI.IGT: " Patchwork

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox