drivers/gpu/drm/msm/msm_fence.h

Source file repositories/reference/linux-study-clean/drivers/gpu/drm/msm/msm_fence.h

File Facts

System
Linux kernel
Corpus path
drivers/gpu/drm/msm/msm_fence.h
Extension
.h
Size
2757 bytes
Lines
102
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 msm_fence_context {
	/** @dev: the drm device */
	struct drm_device *dev;
	/** @name: human readable name for fence timeline */
	char name[32];
	/** @context: see dma_fence_context_alloc() */
	unsigned context;
	/** @index: similar to context, but local to msm_fence_context's */
	unsigned index;
	/**
	 * @last_fence:
	 * Last assigned fence, incremented each time a fence is created
	 * on this fence context.  If last_fence == completed_fence,
	 * there is no remaining pending work
	 */
	uint32_t last_fence;
	/**
	 * @completed_fence:
	 * The last completed fence, updated from the CPU after interrupt
	 * from GPU
	 */
	uint32_t completed_fence;
	/**
	 * @fenceptr:
	 * The address that the GPU directly writes with completed fence
	 * seqno.  This can be ahead of completed_fence.  We can peek at
	 * this to see if a fence has already signaled but the CPU hasn't
	 * gotten around to handling the irq and updating completed_fence
	 */
	volatile uint32_t *fenceptr;

	/**
	 * @spinlock: fence context spinlock
	 */
	spinlock_t spinlock;

	/*
	 * TODO this doesn't really deal with multiple deadlines, like
	 * if userspace got multiple frames ahead.. OTOH atomic updates
	 * don't queue, so maybe that is ok
	 */

	/** @next_deadline: Time of next deadline */
	ktime_t next_deadline;
	/**
	 * @next_deadline_fence:
	 * Fence value for next pending deadline.  The deadline timer is
	 * canceled when this fence is signaled.
	 */
	uint32_t next_deadline_fence;
	/**
	 * @deadline_timer: tracks nearest deadline of a fence timeline and
	 * expires just before it.
	 */
	struct hrtimer deadline_timer;
	/**
	 * @deadline_work: work to do after deadline_timer expires
	 */
	struct kthread_work deadline_work;
};

struct msm_fence_context * msm_fence_context_alloc(struct drm_device *dev,
		volatile uint32_t *fenceptr, const char *name);
void msm_fence_context_free(struct msm_fence_context *fctx);

bool msm_fence_completed(struct msm_fence_context *fctx, uint32_t fence);
void msm_update_fence(struct msm_fence_context *fctx, uint32_t fence);

struct dma_fence * msm_fence_alloc(void);
void msm_fence_init(struct dma_fence *fence, struct msm_fence_context *fctx);

static inline bool
fence_before(uint32_t a, uint32_t b)
{
   return (int32_t)(a - b) < 0;
}

static inline bool
fence_after(uint32_t a, uint32_t b)
{
   return (int32_t)(a - b) > 0;
}

#endif

Annotation

Implementation Notes