1 /*
2  * Copyright © 2014 Intel Corporation
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice (including the next
12  * paragraph) shall be included in all copies or substantial portions of the
13  * Software.
14  *
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
18  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
21  * DEALINGS IN THE SOFTWARE.
22  */
23 
24 #ifndef _INTEL_LRC_H_
25 #define _INTEL_LRC_H_
26 
27 #include "intel_ringbuffer.h"
28 #include "i915_gem_context.h"
29 
30 #define GEN8_LR_CONTEXT_ALIGN I915_GTT_MIN_ALIGNMENT
31 
32 /* Execlists regs */
33 #define RING_ELSP(engine)			_MMIO((engine)->mmio_base + 0x230)
34 #define RING_EXECLIST_STATUS_LO(engine)		_MMIO((engine)->mmio_base + 0x234)
35 #define RING_EXECLIST_STATUS_HI(engine)		_MMIO((engine)->mmio_base + 0x234 + 4)
36 #define RING_CONTEXT_CONTROL(engine)		_MMIO((engine)->mmio_base + 0x244)
37 #define	  CTX_CTRL_INHIBIT_SYN_CTX_SWITCH	(1 << 3)
38 #define	  CTX_CTRL_ENGINE_CTX_RESTORE_INHIBIT	(1 << 0)
39 #define   CTX_CTRL_RS_CTX_ENABLE                (1 << 1)
40 #define	  CTX_CTRL_ENGINE_CTX_SAVE_INHIBIT	(1 << 2)
41 #define RING_CONTEXT_STATUS_BUF_BASE(engine)	_MMIO((engine)->mmio_base + 0x370)
42 #define RING_CONTEXT_STATUS_BUF_LO(engine, i)	_MMIO((engine)->mmio_base + 0x370 + (i) * 8)
43 #define RING_CONTEXT_STATUS_BUF_HI(engine, i)	_MMIO((engine)->mmio_base + 0x370 + (i) * 8 + 4)
44 #define RING_CONTEXT_STATUS_PTR(engine)		_MMIO((engine)->mmio_base + 0x3a0)
45 #define RING_EXECLIST_SQ_CONTENTS(engine)	_MMIO((engine)->mmio_base + 0x510)
46 #define RING_EXECLIST_CONTROL(engine)		_MMIO((engine)->mmio_base + 0x550)
47 #define	  EL_CTRL_LOAD				(1 << 0)
48 
49 /* The docs specify that the write pointer wraps around after 5h, "After status
50  * is written out to the last available status QW at offset 5h, this pointer
51  * wraps to 0."
52  *
53  * Therefore, one must infer than even though there are 3 bits available, 6 and
54  * 7 appear to be * reserved.
55  */
56 #define GEN8_CSB_ENTRIES 6
57 #define GEN8_CSB_PTR_MASK 0x7
58 #define GEN8_CSB_READ_PTR_MASK (GEN8_CSB_PTR_MASK << 8)
59 #define GEN8_CSB_WRITE_PTR_MASK (GEN8_CSB_PTR_MASK << 0)
60 #define GEN8_CSB_WRITE_PTR(csb_status) \
61 	(((csb_status) & GEN8_CSB_WRITE_PTR_MASK) >> 0)
62 #define GEN8_CSB_READ_PTR(csb_status) \
63 	(((csb_status) & GEN8_CSB_READ_PTR_MASK) >> 8)
64 
65 enum {
66 	INTEL_CONTEXT_SCHEDULE_IN = 0,
67 	INTEL_CONTEXT_SCHEDULE_OUT,
68 	INTEL_CONTEXT_SCHEDULE_PREEMPTED,
69 };
70 
71 /* Logical Rings */
72 void intel_logical_ring_cleanup(struct intel_engine_cs *engine);
73 int logical_render_ring_init(struct intel_engine_cs *engine);
74 int logical_xcs_ring_init(struct intel_engine_cs *engine);
75 
76 /* Logical Ring Contexts */
77 
78 /*
79  * We allocate a header at the start of the context image for our own
80  * use, therefore the actual location of the logical state is offset
81  * from the start of the VMA. The layout is
82  *
83  * | [guc]          | [hwsp] [logical state] |
84  * |<- our header ->|<- context image      ->|
85  *
86  */
87 /* The first page is used for sharing data with the GuC */
88 #define LRC_GUCSHR_PN	(0)
89 #define LRC_GUCSHR_SZ	(1)
90 /* At the start of the context image is its per-process HWS page */
91 #define LRC_PPHWSP_PN	(LRC_GUCSHR_PN + LRC_GUCSHR_SZ)
92 #define LRC_PPHWSP_SZ	(1)
93 /* Finally we have the logical state for the context */
94 #define LRC_STATE_PN	(LRC_PPHWSP_PN + LRC_PPHWSP_SZ)
95 
96 /*
97  * Currently we include the PPHWSP in __intel_engine_context_size() so
98  * the size of the header is synonymous with the start of the PPHWSP.
99  */
100 #define LRC_HEADER_PAGES LRC_PPHWSP_PN
101 
102 struct drm_i915_private;
103 struct i915_gem_context;
104 
105 void intel_lr_context_resume(struct drm_i915_private *dev_priv);
106 
107 void intel_execlists_set_default_submission(struct intel_engine_cs *engine);
108 
109 #endif /* _INTEL_LRC_H_ */
110