[PATCH i-g-t v3 1/1] tests/intel/xe_exec_capture: Add xe_exec_capture test

Zhanjun Dong zhanjun.dong at intel.com
Tue Oct 15 15:31:01 UTC 2024


Test with GuC reset, check if devcoredump register dump is within the
range.

Signed-off-by: Zhanjun Dong <zhanjun.dong at intel.com>
---
 tests/intel/xe_exec_capture.c | 308 ++++++++++++++++++++++++++++++++++
 tests/meson.build             |   1 +
 2 files changed, 309 insertions(+)
 create mode 100644 tests/intel/xe_exec_capture.c

diff --git a/tests/intel/xe_exec_capture.c b/tests/intel/xe_exec_capture.c
new file mode 100644
index 000000000..89b544c93
--- /dev/null
+++ b/tests/intel/xe_exec_capture.c
@@ -0,0 +1,308 @@
+// SPDX-License-Identifier: MIT
+/*
+ * Copyright © 2024 Intel Corporation
+ */
+
+/**
+ * TEST: Basic tests for GuC based register capture
+ * Category: Core
+ * Mega feature: General Core features
+ * Sub-category: CMD submission
+ * Functionality: Debug
+ * Test category: functionality test
+ */
+
+#include <ctype.h>
+#include <fcntl.h>
+#include <stdio.h>
+#include <regex.h>
+
+#include "igt.h"
+#include "igt_device.h"
+#include "lib/igt_syncobj.h"
+#include "lib/intel_reg.h"
+#include "xe_drm.h"
+#include "xe/xe_ioctl.h"
+#include "xe/xe_query.h"
+#include "xe/xe_spin.h"
+
+#define MAX_N_EXECQUEUES		16
+#define MAX_INSTANCE			9
+#define GT_RESET			(0x1 << 0)
+#define CLOSE_FD			(0x1 << 1)
+#define CLOSE_EXEC_QUEUES		(0x1 << 2)
+#define VIRTUAL				(0x1 << 3)
+#define PARALLEL			(0x1 << 4)
+#define CAT_ERROR			(0x1 << 5)
+
+#define BASE_ADDRESS			0x1a0000
+/* Batch buffer element count, in number of dwords(uint32_t) */
+#define BATCH_DW_COUNT			16
+
+#define MAX_PATH_NAME_LEN		512
+#define MAX_LINES			512
+#define MAX_LINE_LEN			1024
+
+#define DUMP_PATH			"/sys/class/drm/card%d/device/devcoredump/data"
+#define START_TAG			"**** Job ****"
+#define REGEX_KEY_VALUE_PAIR		"^[ \t]*([^:]+):[ \t]*([^ \t]+)[ \t]*$"
+#define REGEX_KEY_INDEX			1
+#define REGEX_VALUE_INDEX		2
+#define REGEX_KEY_VALUE_MATCH_COUNT	3
+
+int card_id;
+regex_t regex;
+char lines[MAX_LINES][MAX_LINE_LEN];
+
+static bool access_devcoredump(bool load_file)
+{
+	FILE *fd;
+	char path[MAX_PATH_NAME_LEN];
+
+	sprintf(path, DUMP_PATH, card_id);
+	fd = fopen(path, "r");
+	if (!fd) {
+		igt_debug("Devcoredump not exist.\n");
+		return false;
+	}
+	igt_debug("Devcoredump found: %s\n", path);
+
+	/* Clear memory before load file */
+	if (load_file) {
+		int i = 0;
+		bool found = false;
+
+		memset(lines, 0, sizeof(lines));
+		while (!feof(fd)) {
+			fgets(lines[i], MAX_LINE_LEN, fd);
+
+			/* Only save lines after start tag */
+			if (!found)
+				found = strstr(lines[0], START_TAG);
+			else
+				if (++i >= MAX_LINES)
+					break;
+		}
+	}
+
+	fclose(fd);
+	return true;
+}
+
+static void rm_devcoredump(void)
+{
+	char path[MAX_PATH_NAME_LEN];
+	int fd;
+
+	igt_debug("Clearing devcoredump.\n");
+
+	sprintf(path, DUMP_PATH, card_id);
+	fd = open(path, O_WRONLY);
+	if (fd != -1) {
+		write(fd, "0", 1);
+		close(fd);
+	}
+}
+
+static char *get_coredump_item(const char *tag)
+{
+	int i;
+	regmatch_t match[REGEX_KEY_VALUE_MATCH_COUNT];
+
+	for (i = 0; i < MAX_LINES && lines[i][0]; i++) {
+		char *line = lines[i];
+
+		/* Skip lines without tag */
+		if (!strstr(line, tag))
+			continue;
+
+		if (regexec(&regex, line, REGEX_KEY_VALUE_MATCH_COUNT, match, 0) == 0) {
+			char *key, *value;
+
+			key = &line[match[REGEX_KEY_INDEX].rm_so];
+			line[match[REGEX_KEY_INDEX].rm_eo] = '\0';
+			value = &line[match[REGEX_VALUE_INDEX].rm_so];
+			line[match[REGEX_VALUE_INDEX].rm_eo] = '\0';
+
+			if (strcmp(tag, key) == 0)
+				return value;
+			/* if key != tag,  continue */
+		}
+	}
+
+	return NULL;
+}
+
+static void check_capture_output(const char *tag, uint64_t addr_lo, uint64_t addr_hi)
+{
+	uint64_t result;
+	char *output;
+
+	igt_assert(output = get_coredump_item(tag));
+	result = strtol(output, NULL, 16);
+	igt_debug("Compare %s: %s vs [0x%lX-0x%lX]\n", tag, output, addr_lo, addr_hi);
+	igt_assert((addr_lo <= result) && (result <= addr_hi));
+}
+
+static void check_capture_output_str(const char *tag, const char *target)
+{
+	char *output;
+
+	igt_assert(output = get_coredump_item(tag));
+	igt_debug("Compare %s: '%s' vs '%s'\n", tag, output, target);
+	igt_assert(!strcmp(output, target));
+}
+
+static void check_capture_out(uint64_t base_addr, uint64_t length)
+{
+	/* assert devcoredump created */
+	assert(access_devcoredump(true));
+
+	check_capture_output_str("Capture_source", "GuC");
+	check_capture_output("ACTHD", base_addr, base_addr +  length);
+	check_capture_output("RING_BBADDR", base_addr, base_addr + length);
+
+	/* clear devcoredump */
+	rm_devcoredump();
+	sleep(1);
+	/* Assert devcoredump removed */
+	assert(!access_devcoredump(false));
+}
+
+/**
+ * SUBTEST: close-fd
+ * Description: Test close fd, check if devcoredump register dump is within the
+ */
+static void
+test_legacy_mode(int fd, struct drm_xe_engine_class_instance *eci,
+		 int n_exec_queues, int n_execs, unsigned int flags)
+{
+	uint32_t vm;
+	const uint64_t addr = BASE_ADDRESS;
+	struct drm_xe_sync sync[2] = {
+		{ .type = DRM_XE_SYNC_TYPE_SYNCOBJ, .flags = DRM_XE_SYNC_FLAG_SIGNAL, },
+		{ .type = DRM_XE_SYNC_TYPE_SYNCOBJ, .flags = DRM_XE_SYNC_FLAG_SIGNAL, },
+	};
+	struct drm_xe_exec exec = {
+		.num_batch_buffer = 1,
+		.num_syncs = 2,
+		.syncs = to_user_pointer(sync),
+	};
+	uint32_t exec_queues[MAX_N_EXECQUEUES];
+	uint32_t syncobjs[MAX_N_EXECQUEUES];
+	size_t bo_size;
+	uint32_t bo = 0;
+	struct {
+		struct xe_spin spin;
+		uint32_t batch[BATCH_DW_COUNT];
+		uint64_t pad;
+		uint32_t data;
+	} *data;
+	struct xe_spin_opts spin_opts = { .preempt = false };
+	int i, b;
+
+	igt_assert(n_exec_queues <= MAX_N_EXECQUEUES);
+
+	if (flags & CLOSE_FD)
+		fd = drm_open_driver(DRIVER_XE);
+
+	vm = xe_vm_create(fd, 0, 0);
+	bo_size = sizeof(*data) * n_execs;
+	bo_size = xe_bb_size(fd, bo_size);
+
+	bo = xe_bo_create(fd, vm, bo_size,
+			  vram_if_possible(fd, eci->gt_id),
+			  DRM_XE_GEM_CREATE_FLAG_NEEDS_VISIBLE_VRAM);
+	data = xe_bo_map(fd, bo, bo_size);
+
+	for (i = 0; i < n_exec_queues; i++) {
+		exec_queues[i] = xe_exec_queue_create(fd, vm, eci, 0);
+		syncobjs[i] = syncobj_create(fd, 0);
+	};
+
+	sync[0].handle = syncobj_create(fd, 0);
+	xe_vm_bind_async(fd, vm, 0, bo, 0, addr, bo_size, sync, 1);
+
+	for (i = 0; i < n_execs; i++) {
+		uint64_t base_addr = addr;
+		uint64_t batch_offset = (char *)&data[i].batch - (char *)data;
+		uint64_t batch_addr = base_addr + batch_offset;
+		uint64_t spin_offset = (char *)&data[i].spin - (char *)data;
+		uint64_t sdi_offset = (char *)&data[i].data - (char *)data;
+		uint64_t sdi_addr = base_addr + sdi_offset;
+		uint64_t exec_addr;
+		int e = i % n_exec_queues;
+
+		if (!i) {
+			spin_opts.addr = base_addr + spin_offset;
+			xe_spin_init(&data[i].spin, &spin_opts);
+			exec_addr = spin_opts.addr;
+		} else {
+			b = 0;
+			data[i].batch[b++] = MI_STORE_DWORD_IMM_GEN4;
+			data[i].batch[b++] = sdi_addr;
+			data[i].batch[b++] = sdi_addr >> 32;
+			data[i].batch[b++] = 0xc0ffee;
+			data[i].batch[b++] = MI_BATCH_BUFFER_END;
+			igt_assert(b <= ARRAY_SIZE(data[i].batch));
+
+			exec_addr = batch_addr;
+		}
+
+		sync[0].flags &= ~DRM_XE_SYNC_FLAG_SIGNAL;
+		sync[1].flags |= DRM_XE_SYNC_FLAG_SIGNAL;
+		sync[1].handle = syncobjs[e];
+
+		exec.exec_queue_id = exec_queues[e];
+		exec.address = exec_addr;
+		if (e != i)
+			syncobj_reset(fd, &syncobjs[e], 1);
+		xe_exec(fd, &exec);
+	}
+
+	for (i = 0; i < n_exec_queues && n_execs; i++)
+		igt_assert(syncobj_wait(fd, &syncobjs[i], 1, INT64_MAX, 0,
+					NULL));
+	igt_assert(syncobj_wait(fd, &sync[0].handle, 1, INT64_MAX, 0, NULL));
+
+	sync[0].flags |= DRM_XE_SYNC_FLAG_SIGNAL;
+	xe_vm_unbind_async(fd, vm, 0, 0, addr, bo_size, sync, 1);
+	igt_assert(syncobj_wait(fd, &sync[0].handle, 1, INT64_MAX, 0, NULL));
+
+	syncobj_destroy(fd, sync[0].handle);
+	for (i = 0; i < n_exec_queues; i++) {
+		syncobj_destroy(fd, syncobjs[i]);
+		xe_exec_queue_destroy(fd, exec_queues[i]);
+	}
+
+	munmap(data, bo_size);
+	gem_close(fd, bo);
+	xe_vm_destroy(fd, vm);
+}
+
+igt_main
+{
+	struct drm_xe_engine_class_instance *hwe;
+	int fd;
+
+	igt_fixture {
+		fd = drm_open_driver(DRIVER_XE);
+		card_id = igt_device_get_card_index(fd);
+
+		regcomp(&regex, REGEX_KEY_VALUE_PAIR, REG_EXTENDED | REG_NEWLINE);
+	}
+
+	igt_subtest("close-fd")
+		xe_for_each_engine(fd, hwe) {
+			igt_debug("Running on engine class: %x instance: %x\n", hwe->engine_class,
+				  hwe->engine_instance);
+
+			test_legacy_mode(fd, hwe, 1, 1, 0);
+			check_capture_out(BASE_ADDRESS, sizeof(uint32_t) * BATCH_DW_COUNT);
+		}
+
+	igt_fixture {
+		drm_close_driver(fd);
+		regfree(&regex);
+	}
+}
diff --git a/tests/meson.build b/tests/meson.build
index 2d8cb87d5..b724a7c6d 100644
--- a/tests/meson.build
+++ b/tests/meson.build
@@ -284,6 +284,7 @@ intel_xe_progs = [
 	'xe_exec_atomic',
 	'xe_exec_balancer',
 	'xe_exec_basic',
+	'xe_exec_capture',
 	'xe_exec_compute_mode',
 	'xe_exec_fault_mode',
 	'xe_exec_mix_modes',
-- 
2.34.1



More information about the igt-dev mailing list