1/* SPDX-License-Identifier: MIT */
 2/*
 3 * Copyright © 2014 Intel Corporation
 4 */
 5
 6#ifndef __INTEL_LRC_H__
 7#define __INTEL_LRC_H__
 8
 9#include <linux/types.h>
10
11#include "intel_context.h"
12#include "intel_lrc_reg.h"
13
14struct drm_i915_gem_object;
15struct intel_engine_cs;
16struct intel_ring;
17
18/* At the start of the context image is its per-process HWS page */
19#define LRC_PPHWSP_PN	(0)
20#define LRC_PPHWSP_SZ	(1)
21/* After the PPHWSP we have the logical state for the context */
22#define LRC_STATE_PN	(LRC_PPHWSP_PN + LRC_PPHWSP_SZ)
23#define LRC_STATE_OFFSET (LRC_STATE_PN * PAGE_SIZE)
24
25/* Space within PPHWSP reserved to be used as scratch */
26#define LRC_PPHWSP_SCRATCH		0x34
27#define LRC_PPHWSP_SCRATCH_ADDR		(LRC_PPHWSP_SCRATCH * sizeof(u32))
28
29void lrc_init_wa_ctx(struct intel_engine_cs *engine);
30void lrc_fini_wa_ctx(struct intel_engine_cs *engine);
31
32int lrc_alloc(struct intel_context *ce,
33	      struct intel_engine_cs *engine);
34void lrc_reset(struct intel_context *ce);
35void lrc_fini(struct intel_context *ce);
36void lrc_destroy(struct kref *kref);
37
38int
39lrc_pre_pin(struct intel_context *ce,
40	    struct intel_engine_cs *engine,
41	    struct i915_gem_ww_ctx *ww,
42	    void **vaddr);
43int
44lrc_pin(struct intel_context *ce,
45	struct intel_engine_cs *engine,
46	void *vaddr);
47void lrc_unpin(struct intel_context *ce);
48void lrc_post_unpin(struct intel_context *ce);
49
50void lrc_init_state(struct intel_context *ce,
51		    struct intel_engine_cs *engine,
52		    void *state);
53
54void lrc_init_regs(const struct intel_context *ce,
55		   const struct intel_engine_cs *engine,
56		   bool clear);
57void lrc_reset_regs(const struct intel_context *ce,
58		    const struct intel_engine_cs *engine);
59
60u32 lrc_update_regs(const struct intel_context *ce,
61		    const struct intel_engine_cs *engine,
62		    u32 head);
63void lrc_update_offsets(struct intel_context *ce,
64			struct intel_engine_cs *engine);
65
66void lrc_check_regs(const struct intel_context *ce,
67		    const struct intel_engine_cs *engine,
68		    const char *when);
69
70void lrc_update_runtime(struct intel_context *ce);
71static inline u32 lrc_get_runtime(const struct intel_context *ce)
72{
73	/*
74	 * We can use either ppHWSP[16] which is recorded before the context
75	 * switch (and so excludes the cost of context switches) or use the
76	 * value from the context image itself, which is saved/restored earlier
77	 * and so includes the cost of the save.
78	 */
79	return READ_ONCE(ce->lrc_reg_state[CTX_TIMESTAMP]);
80}
81
82#endif /* __INTEL_LRC_H__ */