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); 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