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
14 struct drm_i915_gem_object;
15 struct intel_engine_cs;
16 struct 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
29 void lrc_init_wa_ctx(struct intel_engine_cs *engine);
30 void lrc_fini_wa_ctx(struct intel_engine_cs *engine);
31
32 int lrc_alloc(struct intel_context *ce,
33 struct intel_engine_cs *engine);
34 void lrc_reset(struct intel_context *ce);
35 void lrc_fini(struct intel_context *ce);
36 void lrc_destroy(struct kref *kref);
37
38 int
39 lrc_pre_pin(struct intel_context *ce,
40 struct intel_engine_cs *engine,
41 struct i915_gem_ww_ctx *ww,
42 void **vaddr);
43 int
44 lrc_pin(struct intel_context *ce,
45 struct intel_engine_cs *engine,
46 void *vaddr);
47 void lrc_unpin(struct intel_context *ce);
48 void lrc_post_unpin(struct intel_context *ce);
49
50 void lrc_init_state(struct intel_context *ce,
51 struct intel_engine_cs *engine,
52 void *state);
53
54 void lrc_init_regs(const struct intel_context *ce,
55 const struct intel_engine_cs *engine,
56 bool clear);
57 void lrc_reset_regs(const struct intel_context *ce,
58 const struct intel_engine_cs *engine);
59
60 u32 lrc_update_regs(const struct intel_context *ce,
61 const struct intel_engine_cs *engine,
62 u32 head);
63 void lrc_update_offsets(struct intel_context *ce,
64 struct intel_engine_cs *engine);
65
66 void lrc_check_regs(const struct intel_context *ce,
67 const struct intel_engine_cs *engine,
68 const char *when);
69
70 void lrc_update_runtime(struct intel_context *ce);
lrc_get_runtime(const struct intel_context * ce)71 static 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__ */
83