[PATCH v1 1/2] lib/xe/xe_device: Add helper for device healthcheck

Add helper for a basic Xe device health check. It performs a minimal
bind, exec, wait and unbind sequence on a BO to verify that the command
submission path works.

Co-developed-by: Marcin Bernatowicz <[email protected]>
Signed-off-by: Lukasz Laguna <[email protected]>
---
 lib/meson.build    |  1 +
 lib/xe/xe_device.c | 73 ++++++++++++++++++++++++++++++++++++++++++++++
 lib/xe/xe_device.h | 11 +++++++
 3 files changed, 85 insertions(+)
 create mode 100644 lib/xe/xe_device.c
 create mode 100644 lib/xe/xe_device.h

diff --git a/lib/meson.build b/lib/meson.build
index 3001b473e..7408da963 100644
--- a/lib/meson.build
+++ b/lib/meson.build
@@ -126,6 +126,7 @@ lib_sources = [
 	'igt_msm.c',
 	'igt_dsc.c',
 	'igt_hook.c',
+	'xe/xe_device.c',
 	'xe/xe_ggtt.c',
 	'xe/xe_gt.c',
 	'xe/xe_ioctl.c',
diff --git a/lib/xe/xe_device.c b/lib/xe/xe_device.c
new file mode 100644
index 000000000..74d85b097
--- /dev/null
+++ b/lib/xe/xe_device.c
@@ -0,0 +1,73 @@
+// SPDX-License-Identifier: MIT
+/*
+ * Copyright(c) 2026 Intel Corporation. All rights reserved.
+ */
+
+#include "igt.h"
+#include "igt_syncobj.h"
+#include "xe/xe_device.h"
+#include "xe/xe_ioctl.h"
+#include "xe/xe_query.h"
+
+/**
+ * xe_healthcheck:
+ * @fd: Xe DRM file descriptor
+ *
+ * Basic check for the Xe execution path.
+ * It binds a BO into VM address space, executes a minimal batch,
+ * waits for completion, and then unbinds the BO.
+ */
+void xe_healthcheck(int fd)
+{
+	struct drm_xe_engine_class_instance *hwe = NULL;
+	struct drm_xe_sync sync = {
+		.type = DRM_XE_SYNC_TYPE_SYNCOBJ,
+		.flags = DRM_XE_SYNC_FLAG_SIGNAL,
+	};
+	struct drm_xe_exec exec = {
+		.num_batch_buffer = 1,
+		.num_syncs = 1,
+		.syncs = to_user_pointer(&sync),
+	};
+	uint64_t addr = 0x1a0000;
+	uint32_t vm;
+	uint32_t exec_queue;
+	uint32_t bo;
+	uint32_t *batch;
+	size_t bo_size;
+
+	xe_for_each_engine(fd, hwe)
+		break;
+
+	igt_assert(hwe);
+
+	vm = xe_vm_create(fd, 0, 0);
+	bo_size = xe_bb_size(fd, sizeof(*batch));
+	bo = xe_bo_create(fd, vm, bo_size,
+			  vram_if_possible(fd, hwe->gt_id),
+			  DRM_XE_GEM_CREATE_FLAG_NEEDS_VISIBLE_VRAM);
+	batch = xe_bo_map(fd, bo, bo_size);
+	exec_queue = xe_exec_queue_create(fd, vm, hwe, 0);
+	sync.handle = syncobj_create(fd, 0);
+
+	xe_vm_bind_async(fd, vm, 0, bo, 0, addr, bo_size, &sync, 1);
+	igt_assert(syncobj_wait(fd, &sync.handle, 1, INT64_MAX, 0, NULL));
+
+	batch[0] = MI_BATCH_BUFFER_END;
+
+	syncobj_reset(fd, &sync.handle, 1);
+	exec.exec_queue_id = exec_queue;
+	exec.address = addr;
+	xe_exec(fd, &exec);
+	igt_assert(syncobj_wait(fd, &sync.handle, 1, INT64_MAX, 0, NULL));
+
+	syncobj_reset(fd, &sync.handle, 1);
+	xe_vm_unbind_async(fd, vm, 0, 0, addr, bo_size, &sync, 1);
+	igt_assert(syncobj_wait(fd, &sync.handle, 1, INT64_MAX, 0, NULL));
+
+	syncobj_destroy(fd, sync.handle);
+	xe_exec_queue_destroy(fd, exec_queue);
+	munmap(batch, bo_size);
+	gem_close(fd, bo);
+	xe_vm_destroy(fd, vm);
+}
diff --git a/lib/xe/xe_device.h b/lib/xe/xe_device.h
new file mode 100644
index 000000000..f1b6f887b
--- /dev/null
+++ b/lib/xe/xe_device.h
@@ -0,0 +1,11 @@
+/* SPDX-License-Identifier: MIT */
+/*
+ * Copyright(c) 2026 Intel Corporation. All rights reserved.
+ */
+
+#ifndef __XE_DEVICE_H__
+#define __XE_DEVICE_H__
+
+void xe_healthcheck(int fd);
+
+#endif /* __XE_DEVICE_H__ */
-- 
2.43.0