From: Nareshkumar Gollakoti <naresh.kumar.g@intel.com>
To: intel-xe@lists.freedesktop.org
Cc: himal.prasad.ghimiray@intel.com,
Nareshkumar Gollakoti <naresh.kumar.g@intel.com>
Subject: [PATCH 2/6] drm/xe/devcoredump: Add GuC register snapshot to devcoredump
Date: Thu, 13 Aug 2026 19:00:33 +0530 [thread overview]
Message-ID: <20260813133037.2912699-3-naresh.kumar.g@intel.com> (raw)
In-Reply-To: <20260813133037.2912699-1-naresh.kumar.g@intel.com>
Add support for capturing GuC register state as part of the xe
devcoredump snapshot.
Define a dedicated GuC register snapshot structure, record selected
GT and media GuC status/error registers during devcoredump capture,
and free the snapshot during teardown.
Keeping these register values in the devcoredump helps with
post-mortem analysis of GuC-related failures.
Signed-off-by: Nareshkumar Gollakoti <naresh.kumar.g@intel.com>
---
drivers/gpu/drm/xe/regs/xe_guc_regs.h | 13 +++++
drivers/gpu/drm/xe/xe_devcoredump.c | 60 +++++++++++++++++++++++
drivers/gpu/drm/xe/xe_devcoredump_types.h | 5 ++
3 files changed, 78 insertions(+)
diff --git a/drivers/gpu/drm/xe/regs/xe_guc_regs.h b/drivers/gpu/drm/xe/regs/xe_guc_regs.h
index 5faac8316b66..99487abbbc62 100644
--- a/drivers/gpu/drm/xe/regs/xe_guc_regs.h
+++ b/drivers/gpu/drm/xe/regs/xe_guc_regs.h
@@ -150,6 +150,19 @@
#define GUC_INTR_SW_INT_1 REG_BIT(1)
#define GUC_INTR_SW_INT_0 REG_BIT(0)
+#define GUC_DEVICEID XE_REG(0xc008)
+#define GUC_SHIM_ERR_TRAP XE_REG(0xc070)
+#define GUC_HW_FATL_ERR XE_REG(0xc598)
+#define GUC_HW_NOTIFY_ERR XE_REG(0xc59c)
+
+#define GUC_STATUS_M XE_REG(0x38c000)
+#define GUC_WOPCM_SIZE_M XE_REG(0x38c050)
+#define GUC_DEVICEID_M XE_REG(0x38c008)
+#define DMA_CTRL_M XE_REG(0x38c314)
+#define GUC_HW_FATL_ERR_M XE_REG(0x38c598)
+#define GUC_HW_NOTIFY_ERR_M XE_REG(0x38c59c)
+#define GUC_SHIM_ERR_TRAP_M XE_REG(0x38c070)
+
#define GUC_NUM_DOORBELLS 256
/* format of the HW-monitored doorbell cacheline */
diff --git a/drivers/gpu/drm/xe/xe_devcoredump.c b/drivers/gpu/drm/xe/xe_devcoredump.c
index 35d8101f2a19..b339d4035628 100644
--- a/drivers/gpu/drm/xe/xe_devcoredump.c
+++ b/drivers/gpu/drm/xe/xe_devcoredump.c
@@ -27,6 +27,7 @@
#include "xe_vm.h"
#include "xe_mmio.h"
#include "regs/xe_gt_regs.h"
+#include "regs/xe_guc_regs.h"
/**
* DOC: Xe device coredump
@@ -84,6 +85,26 @@ struct xe_reg_desc {
const char *name;
};
+static const struct xe_reg_desc xe_gt_guc_reg_list[] = {
+ {GUC_STATUS, "GUC_STATUS"},
+ {GUC_WOPCM_SIZE, "GUC_WOPCM_SIZE"},
+ {GUC_DEVICEID, "GUC_DEVICEID"},
+ {DMA_CTRL, "DMA_CTRL"},
+ {GUC_HW_FATL_ERR, "GUC_HW_FATL_ERR"},
+ {GUC_HW_NOTIFY_ERR, "GUC_HW_NOTIFY_ERR"},
+ {GUC_SHIM_ERR_TRAP, "GUC_SHIM_ERR_TRAP"},
+};
+
+static const struct xe_reg_desc xe_media_gt_guc_reg_list[] = {
+ {GUC_STATUS_M, "GUC_STATUS_M"},
+ {GUC_WOPCM_SIZE_M, "GUC_WOPCM_SIZE_M"},
+ {GUC_DEVICEID_M, "GUC_DEVICEID_M"},
+ {DMA_CTRL_M, "DMA_CTRL_M"},
+ {GUC_HW_FATL_ERR_M, "GUC_HW_FATL_ERR_M"},
+ {GUC_HW_NOTIFY_ERR_M, "GUC_HW_NOTIFY_ERR_M"},
+ {GUC_SHIM_ERR_TRAP_M, "GUC_SHIM_ERR_TRAP_M"}
+};
+
static const struct xe_reg_desc xe3p_gt_fuse_reglist[] = {
{ XELP_GT_GEOMETRY_DSS_ENABLE, "GT_GEOMETRY_DSS_ENABLE" },
{ XEHP_GT_COMPUTE_DSS_ENABLE, "GT_COMPUTE_DSS_ENABLE" },
@@ -201,6 +222,32 @@ static struct xe_dbg_reg_snapshot *xe_media_gt_fuse_snapshot_capture(struct xe_g
return xe_dbg_reg_snapshot_capture(gt, ®_list);
}
+static struct xe_dbg_reg_snapshot *xe_gt_guc_reg_snapshot_capture(struct xe_gt *gt)
+{
+ struct xe_reg_desc_list reg_list;
+
+ if (!xe_dbg_reg_snapshot_is_supported(gt_to_xe(gt)))
+ return NULL;
+
+ reg_list.regs = xe_gt_guc_reg_list;
+ reg_list.num_regs = ARRAY_SIZE(xe_gt_guc_reg_list);
+
+ return xe_dbg_reg_snapshot_capture(gt, ®_list);
+}
+
+static struct xe_dbg_reg_snapshot *xe_media_gt_guc_reg_snapshot_capture(struct xe_gt *gt)
+{
+ struct xe_reg_desc_list reg_list;
+
+ if (!xe_dbg_reg_snapshot_is_supported(gt_to_xe(gt)))
+ return NULL;
+
+ reg_list.regs = xe_media_gt_guc_reg_list;
+ reg_list.num_regs = ARRAY_SIZE(xe_media_gt_guc_reg_list);
+
+ return xe_dbg_reg_snapshot_capture(gt, ®_list);
+}
+
static struct xe_device *coredump_to_xe(const struct xe_devcoredump *coredump)
{
return container_of(coredump, struct xe_device, devcoredump);
@@ -251,6 +298,11 @@ static ssize_t __xe_devcoredump_read(char *buffer, ssize_t count,
drm_printf(&p, "\n**** Media GT Fuse Register Dump ****\n");
xe_dbg_reg_snapshot_print(&p, ss->media_fuse);
+ drm_printf(&p, "\n**** GT GuC Register Dump ****\n");
+ xe_dbg_reg_snapshot_print(&p, ss->gt_guc_reg);
+ drm_printf(&p, "\n**** Media GT GuC Register Dump ****\n");
+ xe_dbg_reg_snapshot_print(&p, ss->media_gt_guc_reg);
+
drm_puts(&p, "\n**** GuC Log ****\n");
xe_guc_log_snapshot_print(ss->guc.log, &p);
drm_puts(&p, "\n**** GuC CT ****\n");
@@ -292,6 +344,12 @@ static void xe_devcoredump_snapshot_free(struct xe_devcoredump_snapshot *ss)
xe_dbg_reg_snapshot_free(ss->media_fuse);
ss->media_fuse = NULL;
+ xe_dbg_reg_snapshot_free(ss->gt_guc_reg);
+ ss->gt_guc_reg = NULL;
+
+ xe_dbg_reg_snapshot_free(ss->media_gt_guc_reg);
+ ss->media_gt_guc_reg = NULL;
+
if (!IS_ERR_OR_NULL(ss->gt))
xe_guc_capture_put_matched_nodes(&ss->gt->uc.guc);
ss->matched_node = NULL;
@@ -495,6 +553,8 @@ static void devcoredump_snapshot(struct xe_devcoredump *coredump,
ss->gt_fuse = xe_gt_fuse_snapshot_capture(q->gt);
ss->media_fuse = xe_media_gt_fuse_snapshot_capture(q->gt);
+ ss->gt_guc_reg = xe_gt_guc_reg_snapshot_capture(q->gt);
+ ss->media_gt_guc_reg = xe_media_gt_guc_reg_snapshot_capture(q->gt);
ss->guc.log = xe_guc_log_snapshot_capture(&guc->log, true);
ss->guc.ct = xe_guc_ct_snapshot_capture(&guc->ct);
ss->ge = xe_guc_exec_queue_snapshot_capture(q);
diff --git a/drivers/gpu/drm/xe/xe_devcoredump_types.h b/drivers/gpu/drm/xe/xe_devcoredump_types.h
index 14490b61a56f..28b505176657 100644
--- a/drivers/gpu/drm/xe/xe_devcoredump_types.h
+++ b/drivers/gpu/drm/xe/xe_devcoredump_types.h
@@ -70,6 +70,11 @@ struct xe_devcoredump_snapshot {
/** @media_fuse: Media Fuse snapshot */
struct xe_dbg_reg_snapshot *media_fuse;
+ /** @gt_guc_reg: gt guc reg snapshot */
+ struct xe_dbg_reg_snapshot *gt_guc_reg;
+ /** @media_gt_guc_reg: media gt guc reg snapshot */
+ struct xe_dbg_reg_snapshot *media_gt_guc_reg;
+
/** @work: Workqueue for deferred capture outside of signaling context */
struct work_struct work;
--
2.43.0
next prev parent reply other threads:[~2026-08-13 13:31 UTC|newest]
Thread overview: 15+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-08-13 13:30 [PATCH 0/6] drm/xe: Capture additional HW register state in devcoredump Nareshkumar Gollakoti
2026-08-13 13:30 ` [PATCH 1/6] drm/xe/devcoredump: Capture GT fuse registers " Nareshkumar Gollakoti
2026-08-13 13:52 ` sashiko-bot
2026-08-13 13:30 ` Nareshkumar Gollakoti [this message]
2026-08-13 14:04 ` [PATCH 2/6] drm/xe/devcoredump: Add GuC register snapshot to devcoredump sashiko-bot
2026-08-13 13:30 ` [PATCH 3/6] drm/xe/guc: Print register addresses in capture snapshot output Nareshkumar Gollakoti
2026-08-13 14:11 ` sashiko-bot
2026-08-13 13:30 ` [PATCH 4/6] drm/xe: dump GAM page fault report registers in devcoredump Nareshkumar Gollakoti
2026-08-13 13:30 ` [PATCH 5/6] drm/xe/guc: add TDL gfx registers to capture list Nareshkumar Gollakoti
2026-08-13 14:25 ` sashiko-bot
2026-08-13 13:30 ` [PATCH 6/6] drm/xe: capture L3 node status registers in devcoredump Nareshkumar Gollakoti
2026-08-13 14:37 ` sashiko-bot
2026-08-13 13:39 ` ✓ CI.KUnit: success for drm/xe: Capture additional HW register state " Patchwork
2026-08-13 14:27 ` ✓ Xe.CI.BAT: " Patchwork
2026-08-13 15:58 ` ✗ Xe.CI.FULL: failure " Patchwork
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260813133037.2912699-3-naresh.kumar.g@intel.com \
--to=naresh.kumar.g@intel.com \
--cc=himal.prasad.ghimiray@intel.com \
--cc=intel-xe@lists.freedesktop.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.