drivers/gpu/drm/xe/xe_lrc.c

Source file repositories/reference/linux-study-clean/drivers/gpu/drm/xe/xe_lrc.c

File Facts

System
Linux kernel
Corpus path
drivers/gpu/drm/xe/xe_lrc.c
Extension
.c
Size
75911 bytes
Lines
2800
Domain
Driver Families
Bucket
drivers/gpu
Inferred role
Driver Families: implementation source
Status
source implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

Dependency Surface

Detected Declarations

Annotated Snippet

struct bo_setup {
	ssize_t (*setup)(struct xe_lrc *lrc, struct xe_hw_engine *hwe,
			 u32 *batch, size_t max_size);
};

struct bo_setup_state {
	/* Input: */
	struct xe_lrc		*lrc;
	struct xe_hw_engine	*hwe;
	size_t			max_size;
	size_t                  reserve_dw;
	unsigned int		offset;
	const struct bo_setup	*funcs;
	unsigned int		num_funcs;

	/* State: */
	u32			*buffer;
	u32			*ptr;
	unsigned int		written;
};

static int setup_bo(struct bo_setup_state *state)
{
	ssize_t remain;

	if (state->lrc->bo->vmap.is_iomem) {
		xe_gt_assert(state->hwe->gt, state->buffer);
		state->ptr = state->buffer;
	} else {
		state->ptr = state->lrc->bo->vmap.vaddr + state->offset;
	}

	remain = state->max_size / sizeof(u32);

	for (size_t i = 0; i < state->num_funcs; i++) {
		ssize_t len = state->funcs[i].setup(state->lrc, state->hwe,
						    state->ptr, remain);

		remain -= len;

		/*
		 * Caller has asked for at least reserve_dw to remain unused.
		 */
		if (len < 0 ||
		    xe_gt_WARN_ON(state->lrc->gt, remain < state->reserve_dw))
			goto fail;

		state->ptr += len;
		state->written += len;
	}

	return 0;

fail:
	return -ENOSPC;
}

static void finish_bo(struct bo_setup_state *state)
{
	if (!state->lrc->bo->vmap.is_iomem)
		return;

	xe_map_memcpy_to(gt_to_xe(state->lrc->gt), &state->lrc->bo->vmap,
			 state->offset, state->buffer,
			 state->written * sizeof(u32));
}

/**
 * xe_lrc_setup_wa_bb_with_scratch - Execute all wa bb setup callbacks.
 * @lrc: the &xe_lrc struct instance
 * @hwe: the &xe_hw_engine struct instance
 * @scratch: preallocated scratch buffer for temporary storage
 * Return: 0 on success, negative error code on failure
 */
int xe_lrc_setup_wa_bb_with_scratch(struct xe_lrc *lrc, struct xe_hw_engine *hwe, u32 *scratch)
{
	static const struct bo_setup funcs[] = {
		{ .setup = setup_timestamp_wa },
		{ .setup = setup_invalidate_state_cache_wa },
		{ .setup = setup_utilization_wa },
		{ .setup = setup_configfs_post_ctx_restore_bb },
	};
	struct bo_setup_state state = {
		.lrc = lrc,
		.hwe = hwe,
		.max_size = LRC_WA_BB_SIZE,
		.buffer = scratch,
		.reserve_dw = 1,
		.offset = __xe_lrc_wa_bb_offset(lrc),
		.funcs = funcs,

Annotation

Implementation Notes