Commit dd08ebf6 authored by Matthew Brost's avatar Matthew Brost Committed by Rodrigo Vivi
Browse files

drm/xe: Introduce a new DRM driver for Intel GPUs 



Xe, is a new driver for Intel GPUs that supports both integrated and
discrete platforms starting with Tiger Lake (first Intel Xe Architecture).

The code is at a stage where it is already functional and has experimental
support for multiple platforms starting from Tiger Lake, with initial
support implemented in Mesa (for Iris and Anv, our OpenGL and Vulkan
drivers), as well as in NEO (for OpenCL and Level0).

The new Xe driver leverages a lot from i915.

As for display, the intent is to share the display code with the i915
driver so that there is maximum reuse there. But it is not added
in this patch.

This initial work is a collaboration of many people and unfortunately
the big squashed patch won't fully honor the proper credits. But let's
get some git quick stats so we can at least try to preserve some of the
credits:

Co-developed-by: default avatarMatthew Brost <matthew.brost@intel.com>
Co-developed-by: default avatarMatthew Auld <matthew.auld@intel.com>
Co-developed-by: default avatarMatt Roper <matthew.d.roper@intel.com>
Co-developed-by: default avatarThomas Hellström <thomas.hellstrom@linux.intel.com>
Co-developed-by: default avatarFrancois Dugast <francois.dugast@intel.com>
Co-developed-by: default avatarLucas De Marchi <lucas.demarchi@intel.com>
Co-developed-by: default avatarMaarten Lankhorst <maarten.lankhorst@linux.intel.com>
Co-developed-by: default avatarPhilippe Lecluse <philippe.lecluse@intel.com>
Co-developed-by: default avatarNirmoy Das <nirmoy.das@intel.com>
Co-developed-by: default avatarJani Nikula <jani.nikula@intel.com>
Co-developed-by: default avatarJosé Roberto de Souza <jose.souza@intel.com>
Co-developed-by: default avatarRodrigo Vivi <rodrigo.vivi@intel.com>
Co-developed-by: default avatarDave Airlie <airlied@redhat.com>
Co-developed-by: default avatarFaith Ekstrand <faith.ekstrand@collabora.com>
Co-developed-by: default avatarDaniel Vetter <daniel.vetter@ffwll.ch>
Co-developed-by: default avatarMauro Carvalho Chehab <mchehab@kernel.org>
Signed-off-by: default avatarRodrigo Vivi <rodrigo.vivi@intel.com>
Signed-off-by: default avatarMatthew Brost <matthew.brost@intel.com>
parent a60501d7

Documentation/gpu/drivers.rst

+1 −0
Original line number Diff line number Diff line
@@ -18,6 +18,7 @@ GPU Driver Documentation 
   vkms

   bridge/dw-hdmi

   xen-front

   xe/index

   afbc

   komeda-kms

   panfrost

Documentation/gpu/xe/index.rst

0 → 100644
+23 −0
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: (GPL-2.0+ OR MIT)



=======================

drm/xe Intel GFX Driver

=======================



The drm/xe driver supports some future GFX cards with rendering, display,

compute and media. Support for currently available platforms like TGL, ADL,

DG2, etc is provided to prototype the driver.



.. toctree::

   :titlesonly:



   xe_mm

   xe_map

   xe_migrate

   xe_cs

   xe_pm

   xe_pcode

   xe_gt_mcr

   xe_wa

   xe_rtp

   xe_firmware

Documentation/gpu/xe/xe_cs.rst

0 → 100644
+8 −0
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: (GPL-2.0+ OR MIT)



==================

Command submission

==================



.. kernel-doc:: drivers/gpu/drm/xe/xe_exec.c

   :doc: Execbuf (User GPU command submission)

Documentation/gpu/xe/xe_firmware.rst

0 → 100644
+34 −0
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: (GPL-2.0+ OR MIT)



========

Firmware

========



Firmware Layout

===============



.. kernel-doc:: drivers/gpu/drm/xe/xe_uc_fw_abi.h

   :doc: Firmware Layout



Write Once Protected Content Memory (WOPCM) Layout

==================================================



.. kernel-doc:: drivers/gpu/drm/xe/xe_wopcm.c

   :doc: Write Once Protected Content Memory (WOPCM) Layout



GuC CTB Blob

============



.. kernel-doc:: drivers/gpu/drm/xe/xe_guc_ct.c

   :doc: GuC CTB Blob



GuC Power Conservation (PC)

===========================



.. kernel-doc:: drivers/gpu/drm/xe/xe_guc_pc.c

   :doc: GuC Power Conservation (PC)



Internal API

============



TODO

Documentation/gpu/xe/xe_gt_mcr.rst

0 → 100644
+13 −0
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: (GPL-2.0+ OR MIT)



==============================================

GT Multicast/Replicated (MCR) Register Support

==============================================



.. kernel-doc:: drivers/gpu/drm/xe/xe_gt_mcr.c

   :doc: GT Multicast/Replicated (MCR) Register Support



Internal API

============



TODO