drm/xe/uapi: Add IP version and stepping to GT list query
authorMatt Roper <matthew.d.roper@intel.com>
Tue, 12 Mar 2024 21:12:25 +0000 (14:12 -0700)
committerMatt Roper <matthew.d.roper@intel.com>
Tue, 12 Mar 2024 21:53:49 +0000 (14:53 -0700)
commit8e61e3192a77e1006c1c54c022173026f7afae2c
treec5a9634c9bfdd604db17c815a136714e2811cb1a
parent89d030804831c4075496629343ae3bb3ae8ff58f
drm/xe/uapi: Add IP version and stepping to GT list query

For modern platforms (MTL and later), both kernel and userspace drivers
are expected to apply GT programming and workarounds based on the IP
version and stepping self-reported by the GT hardware via the GMD_ID
registers.  Since userspace drivers can't access these registers
directly, pass along the version and stepping information via the GT
list query.  Note that the new query fields will remain 0's when running
on pre-GMD_ID platforms.  Userspace is expected to continue using PCI
devid / revid on those older platforms.

Although the hardware also has a GMD_ID register for display
version/stepping, that value is intentionally *not* included anywhere in
the Xe uapi.  Display userspace should be using platform-agnostic APIs
and auto-detecting platform capabilities rather than matching specific
IP versions.

v2:
 - s/revid/rev/  (Lucas)
 - Fix kerneldoc copy/paste mistakes

Signed-off-by: Matt Roper <matthew.d.roper@intel.com>
Reviewed-by: Lucas De Marchi <lucas.demarchi@intel.com>
Link: https://patchwork.freedesktop.org/patch/msgid/20240312211229.2871288-4-matthew.d.roper@intel.com
drivers/gpu/drm/xe/xe_query.c
include/uapi/drm/xe_drm.h