Commit d2197029 authored by Dave Airlie's avatar Dave Airlie
Browse files

Merge tag 'drm-xe-next-2023-12-21-pr1-1' of... 

Merge tag 'drm-xe-next-2023-12-21-pr1-1' of https://gitlab.freedesktop.org/drm/xe/kernel

 into drm-next

Introduce a new DRM driver for Intel GPUs

Xe, is a new driver for Intel GPUs that supports both integrated and
discrete platforms. The experimental support starts with Tiger Lake.
i915 will continue be the main production driver for the platforms
up to Meteor Lake and Alchemist. Then the goal is to make this Intel
Xe driver the primary driver for Lunar Lake and newer platforms.

It uses most, if not all, of the key drm concepts, in special: TTM,
drm-scheduler, drm-exec, drm-gpuvm/gpuva and others.

Signed-off-by: default avatarDave Airlie <airlied@redhat.com>

[airlied: add an extra X86 check, fix a typo, fix drm_exec_init interface
change].

From: Rodrigo Vivi <rodrigo.vivi@intel.com>
Link: https://patchwork.freedesktop.org/patch/msgid/ZYSwLgXZUZ57qGPQ@intel.com
parents 6aaff215 b6e1b708

Documentation/ABI/testing/sysfs-driver-intel-xe-hwmon

0 → 100644
+70 −0
Original line number Diff line number Diff line 
What:		/sys/devices/.../hwmon/hwmon<i>/power1_max

Date:		September 2023

KernelVersion:	6.5

Contact:	intel-xe@lists.freedesktop.org

Description:	RW. Card reactive sustained  (PL1) power limit in microwatts.



		The power controller will throttle the operating frequency

		if the power averaged over a window (typically seconds)

		exceeds this limit. A read value of 0 means that the PL1

		power limit is disabled, writing 0 disables the

		limit. Writing values > 0 and <= TDP will enable the power limit.



		Only supported for particular Intel xe graphics platforms.



What:		/sys/devices/.../hwmon/hwmon<i>/power1_rated_max

Date:		September 2023

KernelVersion:	6.5

Contact:	intel-xe@lists.freedesktop.org

Description:	RO. Card default power limit (default TDP setting).



		Only supported for particular Intel xe graphics platforms.



What:		/sys/devices/.../hwmon/hwmon<i>/power1_crit

Date:		September 2023

KernelVersion:	6.5

Contact:	intel-xe@lists.freedesktop.org

Description:	RW. Card reactive critical (I1) power limit in microwatts.



		Card reactive critical (I1) power limit in microwatts is exposed

		for client products. The power controller will throttle the

		operating frequency if the power averaged over a window exceeds

		this limit.



		Only supported for particular Intel xe graphics platforms.



What:		/sys/devices/.../hwmon/hwmon<i>/curr1_crit

Date:		September 2023

KernelVersion:	6.5

Contact:	intel-xe@lists.freedesktop.org

Description:	RW. Card reactive critical (I1) power limit in milliamperes.



		Card reactive critical (I1) power limit in milliamperes is

		exposed for server products. The power controller will throttle

		the operating frequency if the power averaged over a window

		exceeds this limit.



What:		/sys/devices/.../hwmon/hwmon<i>/in0_input

Date:		September 2023

KernelVersion:	6.5

Contact:	intel-xe@lists.freedesktop.org

Description:	RO. Current Voltage in millivolt.



		Only supported for particular Intel xe graphics platforms.



What:		/sys/devices/.../hwmon/hwmon<i>/energy1_input

Date:		September 2023

KernelVersion:	6.5

Contact:	intel-xe@lists.freedesktop.org

Description:	RO. Energy input of device in microjoules.



		Only supported for particular Intel xe graphics platforms.



What:		/sys/devices/.../hwmon/hwmon<i>/power1_max_interval

Date:		October 2023

KernelVersion:	6.6

Contact:	intel-xe@lists.freedesktop.org

Description:	RW. Sustained power limit interval (Tau in PL1/Tau) in

		milliseconds over which sustained power is averaged.



		Only supported for particular Intel xe graphics platforms.

Documentation/gpu/driver-uapi.rst

+5 −0
Original line number Diff line number Diff line
@@ -17,3 +17,8 @@ VM_BIND / EXEC uAPI 
    :doc: Overview



.. kernel-doc:: include/uapi/drm/nouveau_drm.h



drm/xe uAPI

===========



.. kernel-doc:: include/uapi/drm/xe_drm.h

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
+25 −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

   xe_tile

   xe_debugging

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)