blob: cb6e96c6cd47d4ecd813742924613f1febc83230 [file] [log] [blame]
Zou Nan hai8187a2b2010-05-21 09:08:55 +08001#ifndef _INTEL_RINGBUFFER_H_
2#define _INTEL_RINGBUFFER_H_
3
Brad Volkin44e895a2014-05-10 14:10:43 -07004#include <linux/hashtable.h>
Chris Wilson06fbca72015-04-07 16:20:36 +01005#include "i915_gem_batch_pool.h"
Chris Wilsondcff85c2016-08-05 10:14:11 +01006#include "i915_gem_request.h"
Brad Volkin44e895a2014-05-10 14:10:43 -07007
8#define I915_CMD_HASH_ORDER 9
9
Oscar Mateo47122742014-07-24 17:04:28 +010010/* Early gen2 devices have a cacheline of just 32 bytes, using 64 is overkill,
11 * but keeps the logic simple. Indeed, the whole purpose of this macro is just
12 * to give some inclination as to some of the magic values used in the various
13 * workarounds!
14 */
15#define CACHELINE_BYTES 64
Arun Siluvery17ee9502015-06-19 19:07:01 +010016#define CACHELINE_DWORDS (CACHELINE_BYTES / sizeof(uint32_t))
Oscar Mateo47122742014-07-24 17:04:28 +010017
Ville Syrjälä633cf8f2012-12-03 18:43:32 +020018/*
19 * Gen2 BSpec "1. Programming Environment" / 1.4.4.6 "Ring Buffer Use"
20 * Gen3 BSpec "vol1c Memory Interface Functions" / 2.3.4.5 "Ring Buffer Use"
21 * Gen4+ BSpec "vol1c Memory Interface and Command Stream" / 5.3.4.5 "Ring Buffer Use"
22 *
23 * "If the Ring Buffer Head Pointer and the Tail Pointer are on the same
24 * cacheline, the Head Pointer must not be greater than the Tail
25 * Pointer."
26 */
27#define I915_RING_FREE_SPACE 64
28
Chris Wilson57e88532016-08-15 10:48:57 +010029struct intel_hw_status_page {
30 struct i915_vma *vma;
31 u32 *page_addr;
32 u32 ggtt_offset;
Zou Nan hai8187a2b2010-05-21 09:08:55 +080033};
34
Dave Gordonbbdc070a2016-07-20 18:16:05 +010035#define I915_READ_TAIL(engine) I915_READ(RING_TAIL((engine)->mmio_base))
36#define I915_WRITE_TAIL(engine, val) I915_WRITE(RING_TAIL((engine)->mmio_base), val)
Zou Nan haicae58522010-11-09 17:17:32 +080037
Dave Gordonbbdc070a2016-07-20 18:16:05 +010038#define I915_READ_START(engine) I915_READ(RING_START((engine)->mmio_base))
39#define I915_WRITE_START(engine, val) I915_WRITE(RING_START((engine)->mmio_base), val)
Zou Nan haicae58522010-11-09 17:17:32 +080040
Dave Gordonbbdc070a2016-07-20 18:16:05 +010041#define I915_READ_HEAD(engine) I915_READ(RING_HEAD((engine)->mmio_base))
42#define I915_WRITE_HEAD(engine, val) I915_WRITE(RING_HEAD((engine)->mmio_base), val)
Zou Nan haicae58522010-11-09 17:17:32 +080043
Dave Gordonbbdc070a2016-07-20 18:16:05 +010044#define I915_READ_CTL(engine) I915_READ(RING_CTL((engine)->mmio_base))
45#define I915_WRITE_CTL(engine, val) I915_WRITE(RING_CTL((engine)->mmio_base), val)
Zou Nan haicae58522010-11-09 17:17:32 +080046
Dave Gordonbbdc070a2016-07-20 18:16:05 +010047#define I915_READ_IMR(engine) I915_READ(RING_IMR((engine)->mmio_base))
48#define I915_WRITE_IMR(engine, val) I915_WRITE(RING_IMR((engine)->mmio_base), val)
Daniel Vetter870e86d2010-08-02 16:29:44 +020049
Dave Gordonbbdc070a2016-07-20 18:16:05 +010050#define I915_READ_MODE(engine) I915_READ(RING_MI_MODE((engine)->mmio_base))
51#define I915_WRITE_MODE(engine, val) I915_WRITE(RING_MI_MODE((engine)->mmio_base), val)
Naresh Kumar Kachhie9fea572014-03-12 16:39:41 +053052
Ben Widawsky3e789982014-06-30 09:53:37 -070053/* seqno size is actually only a uint32, but since we plan to use MI_FLUSH_DW to
54 * do the writes, and that must have qw aligned offsets, simply pretend it's 8b.
55 */
Chris Wilson8c126722016-04-07 07:29:14 +010056#define gen8_semaphore_seqno_size sizeof(uint64_t)
57#define GEN8_SEMAPHORE_OFFSET(__from, __to) \
58 (((__from) * I915_NUM_ENGINES + (__to)) * gen8_semaphore_seqno_size)
Ben Widawsky3e789982014-06-30 09:53:37 -070059#define GEN8_SIGNAL_OFFSET(__ring, to) \
Chris Wilson51d545d2016-08-15 10:49:02 +010060 (dev_priv->semaphore->node.start + \
Chris Wilson8c126722016-04-07 07:29:14 +010061 GEN8_SEMAPHORE_OFFSET((__ring)->id, (to)))
Ben Widawsky3e789982014-06-30 09:53:37 -070062#define GEN8_WAIT_OFFSET(__ring, from) \
Chris Wilson51d545d2016-08-15 10:49:02 +010063 (dev_priv->semaphore->node.start + \
Chris Wilson8c126722016-04-07 07:29:14 +010064 GEN8_SEMAPHORE_OFFSET(from, (__ring)->id))
Ben Widawsky3e789982014-06-30 09:53:37 -070065
Chris Wilson7e37f882016-08-02 22:50:21 +010066enum intel_engine_hangcheck_action {
Mika Kuoppalada661462013-09-06 16:03:28 +030067 HANGCHECK_IDLE = 0,
Jani Nikulaf2f4d822013-08-11 12:44:01 +030068 HANGCHECK_WAIT,
69 HANGCHECK_ACTIVE,
70 HANGCHECK_KICK,
71 HANGCHECK_HUNG,
72};
Mika Kuoppalaad8beae2013-06-12 12:35:32 +030073
Mika Kuoppalab6b0fac2014-01-30 19:04:43 +020074#define HANGCHECK_SCORE_RING_HUNG 31
75
Ben Widawskyf9e61372016-09-20 16:54:33 +030076#define I915_MAX_SLICES 3
77#define I915_MAX_SUBSLICES 3
78
79#define instdone_slice_mask(dev_priv__) \
80 (INTEL_GEN(dev_priv__) == 7 ? \
81 1 : INTEL_INFO(dev_priv__)->sseu.slice_mask)
82
83#define instdone_subslice_mask(dev_priv__) \
84 (INTEL_GEN(dev_priv__) == 7 ? \
85 1 : INTEL_INFO(dev_priv__)->sseu.subslice_mask)
86
87#define for_each_instdone_slice_subslice(dev_priv__, slice__, subslice__) \
88 for ((slice__) = 0, (subslice__) = 0; \
89 (slice__) < I915_MAX_SLICES; \
90 (subslice__) = ((subslice__) + 1) < I915_MAX_SUBSLICES ? (subslice__) + 1 : 0, \
91 (slice__) += ((subslice__) == 0)) \
92 for_each_if((BIT(slice__) & instdone_slice_mask(dev_priv__)) && \
93 (BIT(subslice__) & instdone_subslice_mask(dev_priv__)))
94
Ben Widawskyd6369512016-09-20 16:54:32 +030095struct intel_instdone {
96 u32 instdone;
97 /* The following exist only in the RCS engine */
98 u32 slice_common;
Ben Widawskyf9e61372016-09-20 16:54:33 +030099 u32 sampler[I915_MAX_SLICES][I915_MAX_SUBSLICES];
100 u32 row[I915_MAX_SLICES][I915_MAX_SUBSLICES];
Ben Widawskyd6369512016-09-20 16:54:32 +0300101};
102
Chris Wilson7e37f882016-08-02 22:50:21 +0100103struct intel_engine_hangcheck {
Chris Wilson50877442014-03-21 12:41:53 +0000104 u64 acthd;
Mika Kuoppala92cab732013-05-24 17:16:07 +0300105 u32 seqno;
Mika Kuoppala05407ff2013-05-30 09:04:29 +0300106 int score;
Chris Wilson7e37f882016-08-02 22:50:21 +0100107 enum intel_engine_hangcheck_action action;
Chris Wilson4be17382014-06-06 10:22:29 +0100108 int deadlock;
Ben Widawskyd6369512016-09-20 16:54:32 +0300109 struct intel_instdone instdone;
Mika Kuoppala92cab732013-05-24 17:16:07 +0300110};
111
Chris Wilson7e37f882016-08-02 22:50:21 +0100112struct intel_ring {
Tvrtko Ursulin0eb973d2016-01-15 15:10:28 +0000113 struct i915_vma *vma;
Chris Wilson57e88532016-08-15 10:48:57 +0100114 void *vaddr;
Oscar Mateo8ee14972014-05-22 14:13:34 +0100115
Tvrtko Ursulin4a570db2016-03-16 11:00:38 +0000116 struct intel_engine_cs *engine;
Daniel Vetter0c7dd532014-08-11 16:17:44 +0200117
Chris Wilson675d9ad2016-08-04 07:52:36 +0100118 struct list_head request_list;
119
Oscar Mateo8ee14972014-05-22 14:13:34 +0100120 u32 head;
121 u32 tail;
122 int space;
123 int size;
124 int effective_size;
125
126 /** We track the position of the requests in the ring buffer, and
127 * when each is retired we increment last_retired_head as the GPU
128 * must have finished processing the request and so we know we
129 * can advance the ringbuffer up to that position.
130 *
131 * last_retired_head is set to -1 after the value is consumed so
132 * we can detect new retirements.
133 */
134 u32 last_retired_head;
135};
136
Chris Wilsone2efd132016-05-24 14:53:34 +0100137struct i915_gem_context;
Jordan Justen361b0272016-03-06 23:30:27 -0800138struct drm_i915_reg_table;
Nick Hoath21076372015-01-15 13:10:38 +0000139
Arun Siluvery17ee9502015-06-19 19:07:01 +0100140/*
141 * we use a single page to load ctx workarounds so all of these
142 * values are referred in terms of dwords
143 *
144 * struct i915_wa_ctx_bb:
145 * offset: specifies batch starting position, also helpful in case
146 * if we want to have multiple batches at different offsets based on
147 * some criteria. It is not a requirement at the moment but provides
148 * an option for future use.
149 * size: size of the batch in DWORDS
150 */
Chris Wilson48bb74e2016-08-15 10:49:04 +0100151struct i915_ctx_workarounds {
Arun Siluvery17ee9502015-06-19 19:07:01 +0100152 struct i915_wa_ctx_bb {
153 u32 offset;
154 u32 size;
155 } indirect_ctx, per_ctx;
Chris Wilson48bb74e2016-08-15 10:49:04 +0100156 struct i915_vma *vma;
Arun Siluvery17ee9502015-06-19 19:07:01 +0100157};
158
Chris Wilsonc81d4612016-07-01 17:23:25 +0100159struct drm_i915_gem_request;
Chris Wilson4e50f082016-10-28 13:58:31 +0100160struct intel_render_state;
Chris Wilsonc81d4612016-07-01 17:23:25 +0100161
Chris Wilsonc0336662016-05-06 15:40:21 +0100162struct intel_engine_cs {
163 struct drm_i915_private *i915;
Zou Nan hai8187a2b2010-05-21 09:08:55 +0800164 const char *name;
Tvrtko Ursulin117897f2016-03-16 11:00:40 +0000165 enum intel_engine_id {
Tvrtko Ursulinde1add32016-01-15 15:12:50 +0000166 RCS = 0,
Daniel Vetter96154f22011-12-14 13:57:00 +0100167 BCS,
Tvrtko Ursulinde1add32016-01-15 15:12:50 +0000168 VCS,
169 VCS2, /* Keep instances of the same type engine together. */
170 VECS
Chris Wilson92204342010-09-18 11:02:01 +0100171 } id;
Tvrtko Ursulin666796d2016-03-16 11:00:39 +0000172#define I915_NUM_ENGINES 5
Tvrtko Ursulinde1add32016-01-15 15:12:50 +0000173#define _VCS(n) (VCS + (n))
Chris Wilson426960b2016-01-15 16:51:46 +0000174 unsigned int exec_id;
Tvrtko Ursulin5ec2cf72016-08-16 17:04:20 +0100175 enum intel_engine_hw_id {
176 RCS_HW = 0,
177 VCS_HW,
178 BCS_HW,
179 VECS_HW,
180 VCS2_HW
181 } hw_id;
182 enum intel_engine_hw_id guc_id; /* XXX same as hw_id? */
Chris Wilson04769652016-07-20 09:21:11 +0100183 u64 fence_context;
Daniel Vetter333e9fe2010-08-02 16:24:01 +0200184 u32 mmio_base;
Dave Gordonc2c7f242016-07-13 16:03:35 +0100185 unsigned int irq_shift;
Chris Wilson7e37f882016-08-02 22:50:21 +0100186 struct intel_ring *buffer;
Zou Nan hai8187a2b2010-05-21 09:08:55 +0800187
Chris Wilson4e50f082016-10-28 13:58:31 +0100188 struct intel_render_state *render_state;
189
Chris Wilson688e6c72016-07-01 17:23:15 +0100190 /* Rather than have every client wait upon all user interrupts,
191 * with the herd waking after every interrupt and each doing the
192 * heavyweight seqno dance, we delegate the task (of being the
193 * bottom-half of the user interrupt) to the first client. After
194 * every interrupt, we wake up one client, who does the heavyweight
195 * coherent seqno read and either goes back to sleep (if incomplete),
196 * or wakes up all the completed clients in parallel, before then
197 * transferring the bottom-half status to the next client in the queue.
198 *
199 * Compared to walking the entire list of waiters in a single dedicated
200 * bottom-half, we reduce the latency of the first waiter by avoiding
201 * a context switch, but incur additional coherent seqno reads when
202 * following the chain of request breadcrumbs. Since it is most likely
203 * that we have a single client waiting on each seqno, then reducing
204 * the overhead of waking that client is much preferred.
205 */
206 struct intel_breadcrumbs {
Chris Wilsondbd6ef22016-08-09 17:47:52 +0100207 struct task_struct __rcu *irq_seqno_bh; /* bh for interrupts */
Chris Wilsonaca34b62016-07-06 12:39:02 +0100208 bool irq_posted;
209
Chris Wilson688e6c72016-07-01 17:23:15 +0100210 spinlock_t lock; /* protects the lists of requests */
211 struct rb_root waiters; /* sorted by retirement, priority */
Chris Wilsonc81d4612016-07-01 17:23:25 +0100212 struct rb_root signals; /* sorted by retirement */
Chris Wilson688e6c72016-07-01 17:23:15 +0100213 struct intel_wait *first_wait; /* oldest waiter by retirement */
Chris Wilsonc81d4612016-07-01 17:23:25 +0100214 struct task_struct *signaler; /* used for fence signalling */
Chris Wilsonb3850852016-07-01 17:23:26 +0100215 struct drm_i915_gem_request *first_signal;
Chris Wilson688e6c72016-07-01 17:23:15 +0100216 struct timer_list fake_irq; /* used after a missed interrupt */
Chris Wilson83348ba2016-08-09 17:47:51 +0100217 struct timer_list hangcheck; /* detect missed interrupts */
218
219 unsigned long timeout;
Chris Wilsonaca34b62016-07-06 12:39:02 +0100220
221 bool irq_enabled : 1;
222 bool rpm_wakelock : 1;
Chris Wilson688e6c72016-07-01 17:23:15 +0100223 } breadcrumbs;
224
Chris Wilson06fbca72015-04-07 16:20:36 +0100225 /*
226 * A pool of objects to use as shadow copies of client batch buffers
227 * when the command parser is enabled. Prevents the client from
228 * modifying the batch contents after software parsing.
229 */
230 struct i915_gem_batch_pool batch_pool;
231
Zou Nan hai8187a2b2010-05-21 09:08:55 +0800232 struct intel_hw_status_page status_page;
Arun Siluvery17ee9502015-06-19 19:07:01 +0100233 struct i915_ctx_workarounds wa_ctx;
Chris Wilson56c0f1a2016-08-15 10:48:58 +0100234 struct i915_vma *scratch;
Zou Nan hai8187a2b2010-05-21 09:08:55 +0800235
Chris Wilson61ff75a2016-07-01 17:23:28 +0100236 u32 irq_keep_mask; /* always keep these interrupts */
237 u32 irq_enable_mask; /* bitmask to enable ring interrupt */
Dave Gordon38a0f2d2016-07-20 18:16:06 +0100238 void (*irq_enable)(struct intel_engine_cs *engine);
239 void (*irq_disable)(struct intel_engine_cs *engine);
Zou Nan hai8187a2b2010-05-21 09:08:55 +0800240
Dave Gordon38a0f2d2016-07-20 18:16:06 +0100241 int (*init_hw)(struct intel_engine_cs *engine);
Chris Wilson821ed7d2016-09-09 14:11:53 +0100242 void (*reset_hw)(struct intel_engine_cs *engine,
243 struct drm_i915_gem_request *req);
Zou Nan hai8187a2b2010-05-21 09:08:55 +0800244
John Harrison87531812015-05-29 17:43:44 +0100245 int (*init_context)(struct drm_i915_gem_request *req);
Arun Siluvery86d7f232014-08-26 14:44:50 +0100246
Chris Wilsonddd66c52016-08-02 22:50:31 +0100247 int (*emit_flush)(struct drm_i915_gem_request *request,
248 u32 mode);
249#define EMIT_INVALIDATE BIT(0)
250#define EMIT_FLUSH BIT(1)
251#define EMIT_BARRIER (EMIT_INVALIDATE | EMIT_FLUSH)
252 int (*emit_bb_start)(struct drm_i915_gem_request *req,
253 u64 offset, u32 length,
254 unsigned int dispatch_flags);
255#define I915_DISPATCH_SECURE BIT(0)
256#define I915_DISPATCH_PINNED BIT(1)
257#define I915_DISPATCH_RS BIT(2)
258 int (*emit_request)(struct drm_i915_gem_request *req);
Chris Wilson5590af32016-09-09 14:11:54 +0100259
260 /* Pass the request to the hardware queue (e.g. directly into
261 * the legacy ringbuffer or to the end of an execlist).
262 *
263 * This is called from an atomic context with irqs disabled; must
264 * be irq safe.
265 */
Chris Wilsonddd66c52016-08-02 22:50:31 +0100266 void (*submit_request)(struct drm_i915_gem_request *req);
Chris Wilson5590af32016-09-09 14:11:54 +0100267
Chris Wilsonb2eadbc2012-08-09 10:58:30 +0100268 /* Some chipsets are not quite as coherent as advertised and need
269 * an expensive kick to force a true read of the up-to-date seqno.
270 * However, the up-to-date seqno is not always required and the last
271 * seen value is good enough. Note that the seqno will always be
272 * monotonic, even if not coherent.
273 */
Dave Gordon38a0f2d2016-07-20 18:16:06 +0100274 void (*irq_seqno_barrier)(struct intel_engine_cs *engine);
Dave Gordon38a0f2d2016-07-20 18:16:06 +0100275 void (*cleanup)(struct intel_engine_cs *engine);
Ben Widawskyebc348b2014-04-29 14:52:28 -0700276
Ben Widawsky3e789982014-06-30 09:53:37 -0700277 /* GEN8 signal/wait table - never trust comments!
278 * signal to signal to signal to signal to signal to
279 * RCS VCS BCS VECS VCS2
280 * --------------------------------------------------------------------
281 * RCS | NOP (0x00) | VCS (0x08) | BCS (0x10) | VECS (0x18) | VCS2 (0x20) |
282 * |-------------------------------------------------------------------
283 * VCS | RCS (0x28) | NOP (0x30) | BCS (0x38) | VECS (0x40) | VCS2 (0x48) |
284 * |-------------------------------------------------------------------
285 * BCS | RCS (0x50) | VCS (0x58) | NOP (0x60) | VECS (0x68) | VCS2 (0x70) |
286 * |-------------------------------------------------------------------
287 * VECS | RCS (0x78) | VCS (0x80) | BCS (0x88) | NOP (0x90) | VCS2 (0x98) |
288 * |-------------------------------------------------------------------
289 * VCS2 | RCS (0xa0) | VCS (0xa8) | BCS (0xb0) | VECS (0xb8) | NOP (0xc0) |
290 * |-------------------------------------------------------------------
291 *
292 * Generalization:
293 * f(x, y) := (x->id * NUM_RINGS * seqno_size) + (seqno_size * y->id)
294 * ie. transpose of g(x, y)
295 *
296 * sync from sync from sync from sync from sync from
297 * RCS VCS BCS VECS VCS2
298 * --------------------------------------------------------------------
299 * RCS | NOP (0x00) | VCS (0x28) | BCS (0x50) | VECS (0x78) | VCS2 (0xa0) |
300 * |-------------------------------------------------------------------
301 * VCS | RCS (0x08) | NOP (0x30) | BCS (0x58) | VECS (0x80) | VCS2 (0xa8) |
302 * |-------------------------------------------------------------------
303 * BCS | RCS (0x10) | VCS (0x38) | NOP (0x60) | VECS (0x88) | VCS2 (0xb0) |
304 * |-------------------------------------------------------------------
305 * VECS | RCS (0x18) | VCS (0x40) | BCS (0x68) | NOP (0x90) | VCS2 (0xb8) |
306 * |-------------------------------------------------------------------
307 * VCS2 | RCS (0x20) | VCS (0x48) | BCS (0x70) | VECS (0x98) | NOP (0xc0) |
308 * |-------------------------------------------------------------------
309 *
310 * Generalization:
311 * g(x, y) := (y->id * NUM_RINGS * seqno_size) + (seqno_size * x->id)
312 * ie. transpose of f(x, y)
313 */
Ben Widawskyebc348b2014-04-29 14:52:28 -0700314 struct {
Tvrtko Ursulin666796d2016-03-16 11:00:39 +0000315 u32 sync_seqno[I915_NUM_ENGINES-1];
Ben Widawsky78325f22014-04-29 14:52:29 -0700316
Ben Widawsky3e789982014-06-30 09:53:37 -0700317 union {
Tvrtko Ursulin318f89c2016-08-16 17:04:21 +0100318#define GEN6_SEMAPHORE_LAST VECS_HW
319#define GEN6_NUM_SEMAPHORES (GEN6_SEMAPHORE_LAST + 1)
320#define GEN6_SEMAPHORES_MASK GENMASK(GEN6_SEMAPHORE_LAST, 0)
Ben Widawsky3e789982014-06-30 09:53:37 -0700321 struct {
322 /* our mbox written by others */
Tvrtko Ursulin318f89c2016-08-16 17:04:21 +0100323 u32 wait[GEN6_NUM_SEMAPHORES];
Ben Widawsky3e789982014-06-30 09:53:37 -0700324 /* mboxes this ring signals to */
Tvrtko Ursulin318f89c2016-08-16 17:04:21 +0100325 i915_reg_t signal[GEN6_NUM_SEMAPHORES];
Ben Widawsky3e789982014-06-30 09:53:37 -0700326 } mbox;
Tvrtko Ursulin666796d2016-03-16 11:00:39 +0000327 u64 signal_ggtt[I915_NUM_ENGINES];
Ben Widawsky3e789982014-06-30 09:53:37 -0700328 };
Ben Widawsky78325f22014-04-29 14:52:29 -0700329
330 /* AKA wait() */
Chris Wilsonad7bdb22016-08-02 22:50:40 +0100331 int (*sync_to)(struct drm_i915_gem_request *req,
332 struct drm_i915_gem_request *signal);
333 int (*signal)(struct drm_i915_gem_request *req);
Ben Widawskyebc348b2014-04-29 14:52:28 -0700334 } semaphore;
Ben Widawskyad776f82013-05-28 19:22:18 -0700335
Oscar Mateo4da46e12014-07-24 17:04:27 +0100336 /* Execlists */
Tvrtko Ursulin27af5ee2016-04-04 12:11:56 +0100337 struct tasklet_struct irq_tasklet;
338 spinlock_t execlist_lock; /* used inside tasklet, use spin_lock_bh */
Chris Wilson70c2a242016-09-09 14:11:46 +0100339 struct execlist_port {
340 struct drm_i915_gem_request *request;
341 unsigned int count;
342 } execlist_port[2];
Michel Thierryacdd8842014-07-24 17:04:38 +0100343 struct list_head execlist_queue;
Tvrtko Ursulin37566852016-04-12 14:37:31 +0100344 unsigned int fw_domains;
Tvrtko Ursulinca825802016-01-15 15:10:27 +0000345 bool disable_lite_restore_wa;
Chris Wilson70c2a242016-09-09 14:11:46 +0100346 bool preempt_wa;
Tvrtko Ursulinca825802016-01-15 15:10:27 +0000347 u32 ctx_desc_template;
Oscar Mateo4da46e12014-07-24 17:04:27 +0100348
Zou Nan hai8187a2b2010-05-21 09:08:55 +0800349 /**
Zou Nan hai8187a2b2010-05-21 09:08:55 +0800350 * List of breadcrumbs associated with GPU requests currently
351 * outstanding.
352 */
353 struct list_head request_list;
354
Chris Wilsona56ba562010-09-28 10:07:56 +0100355 /**
Tomas Elf94f7bbe2015-07-09 15:30:57 +0100356 * Seqno of request most recently submitted to request_list.
357 * Used exclusively by hang checker to avoid grabbing lock while
358 * inspecting request list.
359 */
360 u32 last_submitted_seqno;
Chris Wilson8687b3e2016-10-07 07:53:24 +0100361 u32 last_pending_seqno;
Tomas Elf94f7bbe2015-07-09 15:30:57 +0100362
Chris Wilsondcff85c2016-08-05 10:14:11 +0100363 /* An RCU guarded pointer to the last request. No reference is
364 * held to the request, users must carefully acquire a reference to
Chris Wilson1426f712016-08-09 17:03:22 +0100365 * the request using i915_gem_active_get_rcu(), or hold the
Chris Wilsondcff85c2016-08-05 10:14:11 +0100366 * struct_mutex.
367 */
368 struct i915_gem_active last_request;
369
Chris Wilsone2efd132016-05-24 14:53:34 +0100370 struct i915_gem_context *last_context;
Ben Widawsky40521052012-06-04 14:42:43 -0700371
Chris Wilson7e37f882016-08-02 22:50:21 +0100372 struct intel_engine_hangcheck hangcheck;
Mika Kuoppala92cab732013-05-24 17:16:07 +0300373
Brad Volkin44e895a2014-05-10 14:10:43 -0700374 bool needs_cmd_parser;
375
Brad Volkin351e3db2014-02-18 10:15:46 -0800376 /*
Brad Volkin44e895a2014-05-10 14:10:43 -0700377 * Table of commands the command parser needs to know about
Chris Wilson33a051a2016-07-27 09:07:26 +0100378 * for this engine.
Brad Volkin351e3db2014-02-18 10:15:46 -0800379 */
Brad Volkin44e895a2014-05-10 14:10:43 -0700380 DECLARE_HASHTABLE(cmd_hash, I915_CMD_HASH_ORDER);
Brad Volkin351e3db2014-02-18 10:15:46 -0800381
382 /*
383 * Table of registers allowed in commands that read/write registers.
384 */
Jordan Justen361b0272016-03-06 23:30:27 -0800385 const struct drm_i915_reg_table *reg_tables;
386 int reg_table_count;
Brad Volkin351e3db2014-02-18 10:15:46 -0800387
388 /*
389 * Returns the bitmask for the length field of the specified command.
390 * Return 0 for an unrecognized/invalid command.
391 *
Chris Wilson33a051a2016-07-27 09:07:26 +0100392 * If the command parser finds an entry for a command in the engine's
Brad Volkin351e3db2014-02-18 10:15:46 -0800393 * cmd_tables, it gets the command's length based on the table entry.
Chris Wilson33a051a2016-07-27 09:07:26 +0100394 * If not, it calls this function to determine the per-engine length
395 * field encoding for the command (i.e. different opcode ranges use
396 * certain bits to encode the command length in the header).
Brad Volkin351e3db2014-02-18 10:15:46 -0800397 */
398 u32 (*get_cmd_length_mask)(u32 cmd_header);
Zou Nan hai8187a2b2010-05-21 09:08:55 +0800399};
400
Daniel Vetter96154f22011-12-14 13:57:00 +0100401static inline unsigned
Chris Wilson67d97da2016-07-04 08:08:31 +0100402intel_engine_flag(const struct intel_engine_cs *engine)
Daniel Vetter96154f22011-12-14 13:57:00 +0100403{
Tvrtko Ursulin0bc40be2016-03-16 11:00:37 +0000404 return 1 << engine->id;
Daniel Vetter96154f22011-12-14 13:57:00 +0100405}
406
Zou Nan hai8187a2b2010-05-21 09:08:55 +0800407static inline u32
Chris Wilson7e37f882016-08-02 22:50:21 +0100408intel_engine_sync_index(struct intel_engine_cs *engine,
409 struct intel_engine_cs *other)
Chris Wilson1ec14ad2010-12-04 11:30:53 +0000410{
411 int idx;
412
413 /*
Rodrigo Vividdd4dbc2014-06-30 09:51:11 -0700414 * rcs -> 0 = vcs, 1 = bcs, 2 = vecs, 3 = vcs2;
415 * vcs -> 0 = bcs, 1 = vecs, 2 = vcs2, 3 = rcs;
416 * bcs -> 0 = vecs, 1 = vcs2. 2 = rcs, 3 = vcs;
417 * vecs -> 0 = vcs2, 1 = rcs, 2 = vcs, 3 = bcs;
418 * vcs2 -> 0 = rcs, 1 = vcs, 2 = bcs, 3 = vecs;
Chris Wilson1ec14ad2010-12-04 11:30:53 +0000419 */
420
Akash Goel3b3f1652016-10-13 22:44:48 +0530421 idx = (other->id - engine->id) - 1;
Chris Wilson1ec14ad2010-12-04 11:30:53 +0000422 if (idx < 0)
Tvrtko Ursulin666796d2016-03-16 11:00:39 +0000423 idx += I915_NUM_ENGINES;
Chris Wilson1ec14ad2010-12-04 11:30:53 +0000424
425 return idx;
426}
427
Imre Deak319404d2015-08-14 18:35:27 +0300428static inline void
Tvrtko Ursulin0bc40be2016-03-16 11:00:37 +0000429intel_flush_status_page(struct intel_engine_cs *engine, int reg)
Imre Deak319404d2015-08-14 18:35:27 +0300430{
Chris Wilson0d317ce2016-04-09 10:57:56 +0100431 mb();
432 clflush(&engine->status_page.page_addr[reg]);
433 mb();
Imre Deak319404d2015-08-14 18:35:27 +0300434}
435
Chris Wilson1ec14ad2010-12-04 11:30:53 +0000436static inline u32
Chris Wilson5dd8e502016-04-09 10:57:57 +0100437intel_read_status_page(struct intel_engine_cs *engine, int reg)
Zou Nan hai8187a2b2010-05-21 09:08:55 +0800438{
Daniel Vetter4225d0f2012-04-26 23:28:16 +0200439 /* Ensure that the compiler doesn't optimize away the load. */
Chris Wilson5dd8e502016-04-09 10:57:57 +0100440 return READ_ONCE(engine->status_page.page_addr[reg]);
Zou Nan hai8187a2b2010-05-21 09:08:55 +0800441}
442
Mika Kuoppalab70ec5b2012-12-19 11:13:05 +0200443static inline void
Tvrtko Ursulin0bc40be2016-03-16 11:00:37 +0000444intel_write_status_page(struct intel_engine_cs *engine,
Mika Kuoppalab70ec5b2012-12-19 11:13:05 +0200445 int reg, u32 value)
446{
Tvrtko Ursulin0bc40be2016-03-16 11:00:37 +0000447 engine->status_page.page_addr[reg] = value;
Mika Kuoppalab70ec5b2012-12-19 11:13:05 +0200448}
449
Jani Nikulae2828912016-01-18 09:19:47 +0200450/*
Chris Wilson311bd682011-01-13 19:06:50 +0000451 * Reads a dword out of the status page, which is written to from the command
452 * queue by automatic updates, MI_REPORT_HEAD, MI_STORE_DATA_INDEX, or
453 * MI_STORE_DATA_IMM.
454 *
455 * The following dwords have a reserved meaning:
456 * 0x00: ISR copy, updated when an ISR bit not set in the HWSTAM changes.
457 * 0x04: ring 0 head pointer
458 * 0x05: ring 1 head pointer (915-class)
459 * 0x06: ring 2 head pointer (915-class)
460 * 0x10-0x1b: Context status DWords (GM45)
461 * 0x1f: Last written status offset. (GM45)
Thomas Danielb07da532015-02-18 11:48:21 +0000462 * 0x20-0x2f: Reserved (Gen6+)
Chris Wilson311bd682011-01-13 19:06:50 +0000463 *
Thomas Danielb07da532015-02-18 11:48:21 +0000464 * The area from dword 0x30 to 0x3ff is available for driver usage.
Chris Wilson311bd682011-01-13 19:06:50 +0000465 */
Thomas Danielb07da532015-02-18 11:48:21 +0000466#define I915_GEM_HWS_INDEX 0x30
Chris Wilson7c17d372016-01-20 15:43:35 +0200467#define I915_GEM_HWS_INDEX_ADDR (I915_GEM_HWS_INDEX << MI_STORE_DWORD_INDEX_SHIFT)
Thomas Danielb07da532015-02-18 11:48:21 +0000468#define I915_GEM_HWS_SCRATCH_INDEX 0x40
Jesse Barnes9a289772012-10-26 09:42:42 -0700469#define I915_GEM_HWS_SCRATCH_ADDR (I915_GEM_HWS_SCRATCH_INDEX << MI_STORE_DWORD_INDEX_SHIFT)
Chris Wilson311bd682011-01-13 19:06:50 +0000470
Chris Wilson7e37f882016-08-02 22:50:21 +0100471struct intel_ring *
472intel_engine_create_ring(struct intel_engine_cs *engine, int size);
Chris Wilsonaad29fb2016-08-02 22:50:23 +0100473int intel_ring_pin(struct intel_ring *ring);
474void intel_ring_unpin(struct intel_ring *ring);
Chris Wilson7e37f882016-08-02 22:50:21 +0100475void intel_ring_free(struct intel_ring *ring);
Oscar Mateo84c23772014-07-24 17:04:15 +0100476
Chris Wilson7e37f882016-08-02 22:50:21 +0100477void intel_engine_stop(struct intel_engine_cs *engine);
478void intel_engine_cleanup(struct intel_engine_cs *engine);
Ben Widawsky96f298a2011-03-19 18:14:27 -0700479
Chris Wilson821ed7d2016-09-09 14:11:53 +0100480void intel_legacy_submission_resume(struct drm_i915_private *dev_priv);
481
John Harrison6689cb22015-03-19 12:30:08 +0000482int intel_ring_alloc_request_extras(struct drm_i915_gem_request *request);
483
John Harrison5fb9de12015-05-29 17:44:07 +0100484int __must_check intel_ring_begin(struct drm_i915_gem_request *req, int n);
John Harrisonbba09b12015-05-29 17:44:06 +0100485int __must_check intel_ring_cacheline_align(struct drm_i915_gem_request *req);
Chris Wilson406ea8d2016-07-20 13:31:55 +0100486
Chris Wilson7e37f882016-08-02 22:50:21 +0100487static inline void intel_ring_emit(struct intel_ring *ring, u32 data)
Chris Wilsone898cd22010-08-04 15:18:14 +0100488{
Chris Wilsonb5321f32016-08-02 22:50:18 +0100489 *(uint32_t *)(ring->vaddr + ring->tail) = data;
490 ring->tail += 4;
Chris Wilsone898cd22010-08-04 15:18:14 +0100491}
Chris Wilson406ea8d2016-07-20 13:31:55 +0100492
Chris Wilson7e37f882016-08-02 22:50:21 +0100493static inline void intel_ring_emit_reg(struct intel_ring *ring, i915_reg_t reg)
Ville Syrjäläf92a9162015-11-04 23:20:07 +0200494{
Chris Wilsonb5321f32016-08-02 22:50:18 +0100495 intel_ring_emit(ring, i915_mmio_reg_offset(reg));
Ville Syrjäläf92a9162015-11-04 23:20:07 +0200496}
Chris Wilson406ea8d2016-07-20 13:31:55 +0100497
Chris Wilson7e37f882016-08-02 22:50:21 +0100498static inline void intel_ring_advance(struct intel_ring *ring)
Chris Wilson09246732013-08-10 22:16:32 +0100499{
Chris Wilson8f942012016-08-02 22:50:30 +0100500 /* Dummy function.
501 *
502 * This serves as a placeholder in the code so that the reader
503 * can compare against the preceding intel_ring_begin() and
504 * check that the number of dwords emitted matches the space
505 * reserved for the command packet (i.e. the value passed to
506 * intel_ring_begin()).
Chris Wilsonc5efa1a2016-08-02 22:50:29 +0100507 */
Chris Wilson8f942012016-08-02 22:50:30 +0100508}
509
510static inline u32 intel_ring_offset(struct intel_ring *ring, u32 value)
511{
512 /* Don't write ring->size (equivalent to 0) as that hangs some GPUs. */
513 return value & (ring->size - 1);
Chris Wilson09246732013-08-10 22:16:32 +0100514}
Chris Wilson406ea8d2016-07-20 13:31:55 +0100515
Oscar Mateo82e104c2014-07-24 17:04:26 +0100516int __intel_ring_space(int head, int tail, int size);
Chris Wilson32c04f12016-08-02 22:50:22 +0100517void intel_ring_update_space(struct intel_ring *ring);
Chris Wilson09246732013-08-10 22:16:32 +0100518
Chris Wilson7e37f882016-08-02 22:50:21 +0100519void intel_engine_init_seqno(struct intel_engine_cs *engine, u32 seqno);
Zou Nan hai8187a2b2010-05-21 09:08:55 +0800520
Tvrtko Ursulin019bf272016-07-13 16:03:41 +0100521void intel_engine_setup_common(struct intel_engine_cs *engine);
522int intel_engine_init_common(struct intel_engine_cs *engine);
Chris Wilsonadc320c2016-08-15 10:48:59 +0100523int intel_engine_create_scratch(struct intel_engine_cs *engine, int size);
Chris Wilson96a945a2016-08-03 13:19:16 +0100524void intel_engine_cleanup_common(struct intel_engine_cs *engine);
Tvrtko Ursulin019bf272016-07-13 16:03:41 +0100525
Chris Wilsondcff85c2016-08-05 10:14:11 +0100526static inline int intel_engine_idle(struct intel_engine_cs *engine,
Chris Wilsonea746f32016-09-09 14:11:49 +0100527 unsigned int flags)
Chris Wilsondcff85c2016-08-05 10:14:11 +0100528{
529 /* Wait upon the last request to be completed */
Chris Wilson2e369912016-10-28 13:58:28 +0100530 return i915_gem_active_wait(&engine->last_request, flags);
Chris Wilsondcff85c2016-08-05 10:14:11 +0100531}
532
Tvrtko Ursulin8b3e2d32016-07-13 16:03:37 +0100533int intel_init_render_ring_buffer(struct intel_engine_cs *engine);
534int intel_init_bsd_ring_buffer(struct intel_engine_cs *engine);
535int intel_init_bsd2_ring_buffer(struct intel_engine_cs *engine);
536int intel_init_blt_ring_buffer(struct intel_engine_cs *engine);
537int intel_init_vebox_ring_buffer(struct intel_engine_cs *engine);
Zou Nan hai8187a2b2010-05-21 09:08:55 +0800538
Chris Wilson7e37f882016-08-02 22:50:21 +0100539u64 intel_engine_get_active_head(struct intel_engine_cs *engine);
Chris Wilson1b365952016-10-04 21:11:31 +0100540u64 intel_engine_get_last_batch_head(struct intel_engine_cs *engine);
541
Chris Wilson1b7744e2016-07-01 17:23:17 +0100542static inline u32 intel_engine_get_seqno(struct intel_engine_cs *engine)
543{
544 return intel_read_status_page(engine, I915_GEM_HWS_INDEX);
545}
Daniel Vetter79f321b2010-09-24 21:20:10 +0200546
Tvrtko Ursulin0bc40be2016-03-16 11:00:37 +0000547int init_workarounds_ring(struct intel_engine_cs *engine);
Michel Thierry771b9a52014-11-11 16:47:33 +0000548
Chris Wilson0e704472016-10-12 10:05:17 +0100549void intel_engine_get_instdone(struct intel_engine_cs *engine,
550 struct intel_instdone *instdone);
551
John Harrison29b1b412015-06-18 13:10:09 +0100552/*
553 * Arbitrary size for largest possible 'add request' sequence. The code paths
554 * are complex and variable. Empirical measurement shows that the worst case
Chris Wilson596e5ef2016-04-29 09:07:04 +0100555 * is BDW at 192 bytes (6 + 6 + 36 dwords), then ILK at 136 bytes. However,
556 * we need to allocate double the largest single packet within that emission
557 * to account for tail wraparound (so 6 + 6 + 72 dwords for BDW).
John Harrison29b1b412015-06-18 13:10:09 +0100558 */
Chris Wilson596e5ef2016-04-29 09:07:04 +0100559#define MIN_SPACE_FOR_ADD_REQUEST 336
John Harrison29b1b412015-06-18 13:10:09 +0100560
Chris Wilsona58c01a2016-04-29 13:18:21 +0100561static inline u32 intel_hws_seqno_address(struct intel_engine_cs *engine)
562{
Chris Wilson57e88532016-08-15 10:48:57 +0100563 return engine->status_page.ggtt_offset + I915_GEM_HWS_INDEX_ADDR;
Chris Wilsona58c01a2016-04-29 13:18:21 +0100564}
565
Chris Wilson688e6c72016-07-01 17:23:15 +0100566/* intel_breadcrumbs.c -- user interrupt bottom-half for waiters */
Chris Wilson688e6c72016-07-01 17:23:15 +0100567int intel_engine_init_breadcrumbs(struct intel_engine_cs *engine);
568
569static inline void intel_wait_init(struct intel_wait *wait, u32 seqno)
570{
571 wait->tsk = current;
572 wait->seqno = seqno;
573}
574
575static inline bool intel_wait_complete(const struct intel_wait *wait)
576{
577 return RB_EMPTY_NODE(&wait->node);
578}
579
580bool intel_engine_add_wait(struct intel_engine_cs *engine,
581 struct intel_wait *wait);
582void intel_engine_remove_wait(struct intel_engine_cs *engine,
583 struct intel_wait *wait);
Chris Wilsonb3850852016-07-01 17:23:26 +0100584void intel_engine_enable_signaling(struct drm_i915_gem_request *request);
Chris Wilson688e6c72016-07-01 17:23:15 +0100585
Chris Wilsondbd6ef22016-08-09 17:47:52 +0100586static inline bool intel_engine_has_waiter(const struct intel_engine_cs *engine)
Chris Wilson688e6c72016-07-01 17:23:15 +0100587{
Chris Wilsondbd6ef22016-08-09 17:47:52 +0100588 return rcu_access_pointer(engine->breadcrumbs.irq_seqno_bh);
Chris Wilson688e6c72016-07-01 17:23:15 +0100589}
590
Chris Wilsondbd6ef22016-08-09 17:47:52 +0100591static inline bool intel_engine_wakeup(const struct intel_engine_cs *engine)
Chris Wilson688e6c72016-07-01 17:23:15 +0100592{
593 bool wakeup = false;
Chris Wilsondbd6ef22016-08-09 17:47:52 +0100594
Chris Wilson688e6c72016-07-01 17:23:15 +0100595 /* Note that for this not to dangerously chase a dangling pointer,
Chris Wilsondbd6ef22016-08-09 17:47:52 +0100596 * we must hold the rcu_read_lock here.
Chris Wilson688e6c72016-07-01 17:23:15 +0100597 *
598 * Also note that tsk is likely to be in !TASK_RUNNING state so an
599 * early test for tsk->state != TASK_RUNNING before wake_up_process()
600 * is unlikely to be beneficial.
601 */
Chris Wilsondbd6ef22016-08-09 17:47:52 +0100602 if (intel_engine_has_waiter(engine)) {
603 struct task_struct *tsk;
604
605 rcu_read_lock();
606 tsk = rcu_dereference(engine->breadcrumbs.irq_seqno_bh);
607 if (tsk)
608 wakeup = wake_up_process(tsk);
609 rcu_read_unlock();
610 }
611
Chris Wilson688e6c72016-07-01 17:23:15 +0100612 return wakeup;
613}
614
Chris Wilsonad07dfc2016-10-07 07:53:26 +0100615void intel_engine_reset_breadcrumbs(struct intel_engine_cs *engine);
Chris Wilson688e6c72016-07-01 17:23:15 +0100616void intel_engine_fini_breadcrumbs(struct intel_engine_cs *engine);
617unsigned int intel_kick_waiters(struct drm_i915_private *i915);
Chris Wilsonc81d4612016-07-01 17:23:25 +0100618unsigned int intel_kick_signalers(struct drm_i915_private *i915);
Chris Wilson688e6c72016-07-01 17:23:15 +0100619
Chris Wilsondcff85c2016-08-05 10:14:11 +0100620static inline bool intel_engine_is_active(struct intel_engine_cs *engine)
621{
622 return i915_gem_active_isset(&engine->last_request);
623}
624
Zou Nan hai8187a2b2010-05-21 09:08:55 +0800625#endif /* _INTEL_RINGBUFFER_H_ */