drivers/gpu/drm/i915/gt/selftest_ring.c

Source file repositories/reference/linux-study-clean/drivers/gpu/drm/i915/gt/selftest_ring.c

File Facts

System
Linux kernel
Corpus path
drivers/gpu/drm/i915/gt/selftest_ring.c
Extension
.c
Size
2401 bytes
Lines
111
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

// SPDX-License-Identifier: GPL-2.0
/*
 * Copyright © 2020 Intel Corporation
 */

static struct intel_ring *mock_ring(unsigned long sz)
{
	struct intel_ring *ring;

	ring = kzalloc(sizeof(*ring) + sz, GFP_KERNEL);
	if (!ring)
		return NULL;

	kref_init(&ring->ref);
	ring->size = sz;
	ring->wrap = BITS_PER_TYPE(ring->size) - ilog2(sz);
	ring->effective_size = sz;
	ring->vaddr = (void *)(ring + 1);
	atomic_set(&ring->pin_count, 1);

	intel_ring_update_space(ring);

	return ring;
}

static void mock_ring_free(struct intel_ring *ring)
{
	kfree(ring);
}

static int check_ring_direction(struct intel_ring *ring,
				u32 next, u32 prev,
				int expected)
{
	int result;

	result = intel_ring_direction(ring, next, prev);
	if (result < 0)
		result = -1;
	else if (result > 0)
		result = 1;

	if (result != expected) {
		pr_err("intel_ring_direction(%u, %u):%d != %d\n",
		       next, prev, result, expected);
		return -EINVAL;
	}

	return 0;
}

static int check_ring_step(struct intel_ring *ring, u32 x, u32 step)
{
	u32 prev = x, next = intel_ring_wrap(ring, x + step);
	int err = 0;

	err |= check_ring_direction(ring, next, next,  0);
	err |= check_ring_direction(ring, prev, prev,  0);
	err |= check_ring_direction(ring, next, prev,  1);
	err |= check_ring_direction(ring, prev, next, -1);

	return err;
}

static int check_ring_offset(struct intel_ring *ring, u32 x, u32 step)
{
	int err = 0;

	err |= check_ring_step(ring, x, step);
	err |= check_ring_step(ring, intel_ring_wrap(ring, x + 1), step);
	err |= check_ring_step(ring, intel_ring_wrap(ring, x - 1), step);

	return err;
}

static int igt_ring_direction(void *dummy)
{
	struct intel_ring *ring;
	unsigned int half = 2048;
	int step, err = 0;

	ring = mock_ring(2 * half);
	if (!ring)
		return -ENOMEM;

	GEM_BUG_ON(ring->size != 2 * half);

	/* Precision of wrap detection is limited to ring->size / 2 */
	for (step = 1; step < half; step <<= 1) {
		err |= check_ring_offset(ring, 0, step);

Annotation

Implementation Notes