drm/i915: Pass intel_crtc to fdi_link_train() hooks
[platform/kernel/linux-starfive.git] / drivers / gpu / drm / i915 / i915_drv.h
1 /* i915_drv.h -- Private header for the I915 driver -*- linux-c -*-
2  */
3 /*
4  *
5  * Copyright 2003 Tungsten Graphics, Inc., Cedar Park, Texas.
6  * All Rights Reserved.
7  *
8  * Permission is hereby granted, free of charge, to any person obtaining a
9  * copy of this software and associated documentation files (the
10  * "Software"), to deal in the Software without restriction, including
11  * without limitation the rights to use, copy, modify, merge, publish,
12  * distribute, sub license, and/or sell copies of the Software, and to
13  * permit persons to whom the Software is furnished to do so, subject to
14  * the following conditions:
15  *
16  * The above copyright notice and this permission notice (including the
17  * next paragraph) shall be included in all copies or substantial portions
18  * of the Software.
19  *
20  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
21  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
22  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
23  * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR
24  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
25  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
26  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
27  *
28  */
29
30 #ifndef _I915_DRV_H_
31 #define _I915_DRV_H_
32
33 #include <uapi/drm/i915_drm.h>
34 #include <uapi/drm/drm_fourcc.h>
35
36 #include <linux/io-mapping.h>
37 #include <linux/i2c.h>
38 #include <linux/i2c-algo-bit.h>
39 #include <linux/backlight.h>
40 #include <linux/hashtable.h>
41 #include <linux/intel-iommu.h>
42 #include <linux/kref.h>
43 #include <linux/pm_qos.h>
44 #include <linux/reservation.h>
45 #include <linux/shmem_fs.h>
46
47 #include <drm/drmP.h>
48 #include <drm/intel-gtt.h>
49 #include <drm/drm_legacy.h> /* for struct drm_dma_handle */
50 #include <drm/drm_gem.h>
51 #include <drm/drm_auth.h>
52 #include <drm/drm_cache.h>
53
54 #include "i915_params.h"
55 #include "i915_reg.h"
56 #include "i915_utils.h"
57
58 #include "intel_bios.h"
59 #include "intel_dpll_mgr.h"
60 #include "intel_uc.h"
61 #include "intel_lrc.h"
62 #include "intel_ringbuffer.h"
63
64 #include "i915_gem.h"
65 #include "i915_gem_context.h"
66 #include "i915_gem_fence_reg.h"
67 #include "i915_gem_object.h"
68 #include "i915_gem_gtt.h"
69 #include "i915_gem_render_state.h"
70 #include "i915_gem_request.h"
71 #include "i915_gem_timeline.h"
72
73 #include "i915_vma.h"
74
75 #include "intel_gvt.h"
76
77 /* General customization:
78  */
79
80 #define DRIVER_NAME             "i915"
81 #define DRIVER_DESC             "Intel Graphics"
82 #define DRIVER_DATE             "20170206"
83 #define DRIVER_TIMESTAMP        1486372993
84
85 #undef WARN_ON
86 /* Many gcc seem to no see through this and fall over :( */
87 #if 0
88 #define WARN_ON(x) ({ \
89         bool __i915_warn_cond = (x); \
90         if (__builtin_constant_p(__i915_warn_cond)) \
91                 BUILD_BUG_ON(__i915_warn_cond); \
92         WARN(__i915_warn_cond, "WARN_ON(" #x ")"); })
93 #else
94 #define WARN_ON(x) WARN((x), "%s", "WARN_ON(" __stringify(x) ")")
95 #endif
96
97 #undef WARN_ON_ONCE
98 #define WARN_ON_ONCE(x) WARN_ONCE((x), "%s", "WARN_ON_ONCE(" __stringify(x) ")")
99
100 #define MISSING_CASE(x) WARN(1, "Missing switch case (%lu) in %s\n", \
101                              (long) (x), __func__);
102
103 /* Use I915_STATE_WARN(x) and I915_STATE_WARN_ON() (rather than WARN() and
104  * WARN_ON()) for hw state sanity checks to check for unexpected conditions
105  * which may not necessarily be a user visible problem.  This will either
106  * WARN() or DRM_ERROR() depending on the verbose_checks moduleparam, to
107  * enable distros and users to tailor their preferred amount of i915 abrt
108  * spam.
109  */
110 #define I915_STATE_WARN(condition, format...) ({                        \
111         int __ret_warn_on = !!(condition);                              \
112         if (unlikely(__ret_warn_on))                                    \
113                 if (!WARN(i915.verbose_state_checks, format))           \
114                         DRM_ERROR(format);                              \
115         unlikely(__ret_warn_on);                                        \
116 })
117
118 #define I915_STATE_WARN_ON(x)                                           \
119         I915_STATE_WARN((x), "%s", "WARN_ON(" __stringify(x) ")")
120
121 bool __i915_inject_load_failure(const char *func, int line);
122 #define i915_inject_load_failure() \
123         __i915_inject_load_failure(__func__, __LINE__)
124
125 typedef struct {
126         uint32_t val;
127 } uint_fixed_16_16_t;
128
129 #define FP_16_16_MAX ({ \
130         uint_fixed_16_16_t fp; \
131         fp.val = UINT_MAX; \
132         fp; \
133 })
134
135 static inline uint_fixed_16_16_t u32_to_fixed_16_16(uint32_t val)
136 {
137         uint_fixed_16_16_t fp;
138
139         WARN_ON(val >> 16);
140
141         fp.val = val << 16;
142         return fp;
143 }
144
145 static inline uint32_t fixed_16_16_to_u32_round_up(uint_fixed_16_16_t fp)
146 {
147         return DIV_ROUND_UP(fp.val, 1 << 16);
148 }
149
150 static inline uint32_t fixed_16_16_to_u32(uint_fixed_16_16_t fp)
151 {
152         return fp.val >> 16;
153 }
154
155 static inline uint_fixed_16_16_t min_fixed_16_16(uint_fixed_16_16_t min1,
156                                                  uint_fixed_16_16_t min2)
157 {
158         uint_fixed_16_16_t min;
159
160         min.val = min(min1.val, min2.val);
161         return min;
162 }
163
164 static inline uint_fixed_16_16_t max_fixed_16_16(uint_fixed_16_16_t max1,
165                                                  uint_fixed_16_16_t max2)
166 {
167         uint_fixed_16_16_t max;
168
169         max.val = max(max1.val, max2.val);
170         return max;
171 }
172
173 static inline uint_fixed_16_16_t fixed_16_16_div_round_up(uint32_t val,
174                                                           uint32_t d)
175 {
176         uint_fixed_16_16_t fp, res;
177
178         fp = u32_to_fixed_16_16(val);
179         res.val = DIV_ROUND_UP(fp.val, d);
180         return res;
181 }
182
183 static inline uint_fixed_16_16_t fixed_16_16_div_round_up_u64(uint32_t val,
184                                                               uint32_t d)
185 {
186         uint_fixed_16_16_t res;
187         uint64_t interm_val;
188
189         interm_val = (uint64_t)val << 16;
190         interm_val = DIV_ROUND_UP_ULL(interm_val, d);
191         WARN_ON(interm_val >> 32);
192         res.val = (uint32_t) interm_val;
193
194         return res;
195 }
196
197 static inline uint_fixed_16_16_t mul_u32_fixed_16_16(uint32_t val,
198                                                      uint_fixed_16_16_t mul)
199 {
200         uint64_t intermediate_val;
201         uint_fixed_16_16_t fp;
202
203         intermediate_val = (uint64_t) val * mul.val;
204         WARN_ON(intermediate_val >> 32);
205         fp.val = (uint32_t) intermediate_val;
206         return fp;
207 }
208
209 static inline const char *yesno(bool v)
210 {
211         return v ? "yes" : "no";
212 }
213
214 static inline const char *onoff(bool v)
215 {
216         return v ? "on" : "off";
217 }
218
219 static inline const char *enableddisabled(bool v)
220 {
221         return v ? "enabled" : "disabled";
222 }
223
224 enum pipe {
225         INVALID_PIPE = -1,
226         PIPE_A = 0,
227         PIPE_B,
228         PIPE_C,
229         _PIPE_EDP,
230         I915_MAX_PIPES = _PIPE_EDP
231 };
232 #define pipe_name(p) ((p) + 'A')
233
234 enum transcoder {
235         TRANSCODER_A = 0,
236         TRANSCODER_B,
237         TRANSCODER_C,
238         TRANSCODER_EDP,
239         TRANSCODER_DSI_A,
240         TRANSCODER_DSI_C,
241         I915_MAX_TRANSCODERS
242 };
243
244 static inline const char *transcoder_name(enum transcoder transcoder)
245 {
246         switch (transcoder) {
247         case TRANSCODER_A:
248                 return "A";
249         case TRANSCODER_B:
250                 return "B";
251         case TRANSCODER_C:
252                 return "C";
253         case TRANSCODER_EDP:
254                 return "EDP";
255         case TRANSCODER_DSI_A:
256                 return "DSI A";
257         case TRANSCODER_DSI_C:
258                 return "DSI C";
259         default:
260                 return "<invalid>";
261         }
262 }
263
264 static inline bool transcoder_is_dsi(enum transcoder transcoder)
265 {
266         return transcoder == TRANSCODER_DSI_A || transcoder == TRANSCODER_DSI_C;
267 }
268
269 /*
270  * Global legacy plane identifier. Valid only for primary/sprite
271  * planes on pre-g4x, and only for primary planes on g4x+.
272  */
273 enum plane {
274         PLANE_A,
275         PLANE_B,
276         PLANE_C,
277 };
278 #define plane_name(p) ((p) + 'A')
279
280 #define sprite_name(p, s) ((p) * INTEL_INFO(dev_priv)->num_sprites[(p)] + (s) + 'A')
281
282 /*
283  * Per-pipe plane identifier.
284  * I915_MAX_PLANES in the enum below is the maximum (across all platforms)
285  * number of planes per CRTC.  Not all platforms really have this many planes,
286  * which means some arrays of size I915_MAX_PLANES may have unused entries
287  * between the topmost sprite plane and the cursor plane.
288  *
289  * This is expected to be passed to various register macros
290  * (eg. PLANE_CTL(), PS_PLANE_SEL(), etc.) so adjust with care.
291  */
292 enum plane_id {
293         PLANE_PRIMARY,
294         PLANE_SPRITE0,
295         PLANE_SPRITE1,
296         PLANE_SPRITE2,
297         PLANE_CURSOR,
298         I915_MAX_PLANES,
299 };
300
301 #define for_each_plane_id_on_crtc(__crtc, __p) \
302         for ((__p) = PLANE_PRIMARY; (__p) < I915_MAX_PLANES; (__p)++) \
303                 for_each_if ((__crtc)->plane_ids_mask & BIT(__p))
304
305 enum port {
306         PORT_NONE = -1,
307         PORT_A = 0,
308         PORT_B,
309         PORT_C,
310         PORT_D,
311         PORT_E,
312         I915_MAX_PORTS
313 };
314 #define port_name(p) ((p) + 'A')
315
316 #define I915_NUM_PHYS_VLV 2
317
318 enum dpio_channel {
319         DPIO_CH0,
320         DPIO_CH1
321 };
322
323 enum dpio_phy {
324         DPIO_PHY0,
325         DPIO_PHY1,
326         DPIO_PHY2,
327 };
328
329 enum intel_display_power_domain {
330         POWER_DOMAIN_PIPE_A,
331         POWER_DOMAIN_PIPE_B,
332         POWER_DOMAIN_PIPE_C,
333         POWER_DOMAIN_PIPE_A_PANEL_FITTER,
334         POWER_DOMAIN_PIPE_B_PANEL_FITTER,
335         POWER_DOMAIN_PIPE_C_PANEL_FITTER,
336         POWER_DOMAIN_TRANSCODER_A,
337         POWER_DOMAIN_TRANSCODER_B,
338         POWER_DOMAIN_TRANSCODER_C,
339         POWER_DOMAIN_TRANSCODER_EDP,
340         POWER_DOMAIN_TRANSCODER_DSI_A,
341         POWER_DOMAIN_TRANSCODER_DSI_C,
342         POWER_DOMAIN_PORT_DDI_A_LANES,
343         POWER_DOMAIN_PORT_DDI_B_LANES,
344         POWER_DOMAIN_PORT_DDI_C_LANES,
345         POWER_DOMAIN_PORT_DDI_D_LANES,
346         POWER_DOMAIN_PORT_DDI_E_LANES,
347         POWER_DOMAIN_PORT_DDI_A_IO,
348         POWER_DOMAIN_PORT_DDI_B_IO,
349         POWER_DOMAIN_PORT_DDI_C_IO,
350         POWER_DOMAIN_PORT_DDI_D_IO,
351         POWER_DOMAIN_PORT_DDI_E_IO,
352         POWER_DOMAIN_PORT_DSI,
353         POWER_DOMAIN_PORT_CRT,
354         POWER_DOMAIN_PORT_OTHER,
355         POWER_DOMAIN_VGA,
356         POWER_DOMAIN_AUDIO,
357         POWER_DOMAIN_PLLS,
358         POWER_DOMAIN_AUX_A,
359         POWER_DOMAIN_AUX_B,
360         POWER_DOMAIN_AUX_C,
361         POWER_DOMAIN_AUX_D,
362         POWER_DOMAIN_GMBUS,
363         POWER_DOMAIN_MODESET,
364         POWER_DOMAIN_INIT,
365
366         POWER_DOMAIN_NUM,
367 };
368
369 #define POWER_DOMAIN_PIPE(pipe) ((pipe) + POWER_DOMAIN_PIPE_A)
370 #define POWER_DOMAIN_PIPE_PANEL_FITTER(pipe) \
371                 ((pipe) + POWER_DOMAIN_PIPE_A_PANEL_FITTER)
372 #define POWER_DOMAIN_TRANSCODER(tran) \
373         ((tran) == TRANSCODER_EDP ? POWER_DOMAIN_TRANSCODER_EDP : \
374          (tran) + POWER_DOMAIN_TRANSCODER_A)
375
376 enum hpd_pin {
377         HPD_NONE = 0,
378         HPD_TV = HPD_NONE,     /* TV is known to be unreliable */
379         HPD_CRT,
380         HPD_SDVO_B,
381         HPD_SDVO_C,
382         HPD_PORT_A,
383         HPD_PORT_B,
384         HPD_PORT_C,
385         HPD_PORT_D,
386         HPD_PORT_E,
387         HPD_NUM_PINS
388 };
389
390 #define for_each_hpd_pin(__pin) \
391         for ((__pin) = (HPD_NONE + 1); (__pin) < HPD_NUM_PINS; (__pin)++)
392
393 #define HPD_STORM_DEFAULT_THRESHOLD 5
394
395 struct i915_hotplug {
396         struct work_struct hotplug_work;
397
398         struct {
399                 unsigned long last_jiffies;
400                 int count;
401                 enum {
402                         HPD_ENABLED = 0,
403                         HPD_DISABLED = 1,
404                         HPD_MARK_DISABLED = 2
405                 } state;
406         } stats[HPD_NUM_PINS];
407         u32 event_bits;
408         struct delayed_work reenable_work;
409
410         struct intel_digital_port *irq_port[I915_MAX_PORTS];
411         u32 long_port_mask;
412         u32 short_port_mask;
413         struct work_struct dig_port_work;
414
415         struct work_struct poll_init_work;
416         bool poll_enabled;
417
418         unsigned int hpd_storm_threshold;
419
420         /*
421          * if we get a HPD irq from DP and a HPD irq from non-DP
422          * the non-DP HPD could block the workqueue on a mode config
423          * mutex getting, that userspace may have taken. However
424          * userspace is waiting on the DP workqueue to run which is
425          * blocked behind the non-DP one.
426          */
427         struct workqueue_struct *dp_wq;
428 };
429
430 #define I915_GEM_GPU_DOMAINS \
431         (I915_GEM_DOMAIN_RENDER | \
432          I915_GEM_DOMAIN_SAMPLER | \
433          I915_GEM_DOMAIN_COMMAND | \
434          I915_GEM_DOMAIN_INSTRUCTION | \
435          I915_GEM_DOMAIN_VERTEX)
436
437 #define for_each_pipe(__dev_priv, __p) \
438         for ((__p) = 0; (__p) < INTEL_INFO(__dev_priv)->num_pipes; (__p)++)
439 #define for_each_pipe_masked(__dev_priv, __p, __mask) \
440         for ((__p) = 0; (__p) < INTEL_INFO(__dev_priv)->num_pipes; (__p)++) \
441                 for_each_if ((__mask) & (1 << (__p)))
442 #define for_each_universal_plane(__dev_priv, __pipe, __p)               \
443         for ((__p) = 0;                                                 \
444              (__p) < INTEL_INFO(__dev_priv)->num_sprites[(__pipe)] + 1; \
445              (__p)++)
446 #define for_each_sprite(__dev_priv, __p, __s)                           \
447         for ((__s) = 0;                                                 \
448              (__s) < INTEL_INFO(__dev_priv)->num_sprites[(__p)];        \
449              (__s)++)
450
451 #define for_each_port_masked(__port, __ports_mask) \
452         for ((__port) = PORT_A; (__port) < I915_MAX_PORTS; (__port)++)  \
453                 for_each_if ((__ports_mask) & (1 << (__port)))
454
455 #define for_each_crtc(dev, crtc) \
456         list_for_each_entry(crtc, &(dev)->mode_config.crtc_list, head)
457
458 #define for_each_intel_plane(dev, intel_plane) \
459         list_for_each_entry(intel_plane,                        \
460                             &(dev)->mode_config.plane_list,     \
461                             base.head)
462
463 #define for_each_intel_plane_mask(dev, intel_plane, plane_mask)         \
464         list_for_each_entry(intel_plane,                                \
465                             &(dev)->mode_config.plane_list,             \
466                             base.head)                                  \
467                 for_each_if ((plane_mask) &                             \
468                              (1 << drm_plane_index(&intel_plane->base)))
469
470 #define for_each_intel_plane_on_crtc(dev, intel_crtc, intel_plane)      \
471         list_for_each_entry(intel_plane,                                \
472                             &(dev)->mode_config.plane_list,             \
473                             base.head)                                  \
474                 for_each_if ((intel_plane)->pipe == (intel_crtc)->pipe)
475
476 #define for_each_intel_crtc(dev, intel_crtc)                            \
477         list_for_each_entry(intel_crtc,                                 \
478                             &(dev)->mode_config.crtc_list,              \
479                             base.head)
480
481 #define for_each_intel_crtc_mask(dev, intel_crtc, crtc_mask)            \
482         list_for_each_entry(intel_crtc,                                 \
483                             &(dev)->mode_config.crtc_list,              \
484                             base.head)                                  \
485                 for_each_if ((crtc_mask) & (1 << drm_crtc_index(&intel_crtc->base)))
486
487 #define for_each_intel_encoder(dev, intel_encoder)              \
488         list_for_each_entry(intel_encoder,                      \
489                             &(dev)->mode_config.encoder_list,   \
490                             base.head)
491
492 #define for_each_intel_connector(dev, intel_connector)          \
493         list_for_each_entry(intel_connector,                    \
494                             &(dev)->mode_config.connector_list, \
495                             base.head)
496
497 #define for_each_encoder_on_crtc(dev, __crtc, intel_encoder) \
498         list_for_each_entry((intel_encoder), &(dev)->mode_config.encoder_list, base.head) \
499                 for_each_if ((intel_encoder)->base.crtc == (__crtc))
500
501 #define for_each_connector_on_encoder(dev, __encoder, intel_connector) \
502         list_for_each_entry((intel_connector), &(dev)->mode_config.connector_list, base.head) \
503                 for_each_if ((intel_connector)->base.encoder == (__encoder))
504
505 #define for_each_power_domain(domain, mask)                             \
506         for ((domain) = 0; (domain) < POWER_DOMAIN_NUM; (domain)++)     \
507                 for_each_if (BIT_ULL(domain) & (mask))
508
509 #define for_each_power_well(__dev_priv, __power_well)                           \
510         for ((__power_well) = (__dev_priv)->power_domains.power_wells;  \
511              (__power_well) - (__dev_priv)->power_domains.power_wells < \
512                 (__dev_priv)->power_domains.power_well_count;           \
513              (__power_well)++)
514
515 #define for_each_power_well_rev(__dev_priv, __power_well)                       \
516         for ((__power_well) = (__dev_priv)->power_domains.power_wells +         \
517                               (__dev_priv)->power_domains.power_well_count - 1; \
518              (__power_well) - (__dev_priv)->power_domains.power_wells >= 0;     \
519              (__power_well)--)
520
521 #define for_each_power_domain_well(__dev_priv, __power_well, __domain_mask)     \
522         for_each_power_well(__dev_priv, __power_well)                           \
523                 for_each_if ((__power_well)->domains & (__domain_mask))
524
525 #define for_each_power_domain_well_rev(__dev_priv, __power_well, __domain_mask) \
526         for_each_power_well_rev(__dev_priv, __power_well)                       \
527                 for_each_if ((__power_well)->domains & (__domain_mask))
528
529 struct drm_i915_private;
530 struct i915_mm_struct;
531 struct i915_mmu_object;
532
533 struct drm_i915_file_private {
534         struct drm_i915_private *dev_priv;
535         struct drm_file *file;
536
537         struct {
538                 spinlock_t lock;
539                 struct list_head request_list;
540 /* 20ms is a fairly arbitrary limit (greater than the average frame time)
541  * chosen to prevent the CPU getting more than a frame ahead of the GPU
542  * (when using lax throttling for the frontbuffer). We also use it to
543  * offer free GPU waitboosts for severely congested workloads.
544  */
545 #define DRM_I915_THROTTLE_JIFFIES msecs_to_jiffies(20)
546         } mm;
547         struct idr context_idr;
548
549         struct intel_rps_client {
550                 struct list_head link;
551                 unsigned boosts;
552         } rps;
553
554         unsigned int bsd_engine;
555
556 /* Client can have a maximum of 3 contexts banned before
557  * it is denied of creating new contexts. As one context
558  * ban needs 4 consecutive hangs, and more if there is
559  * progress in between, this is a last resort stop gap measure
560  * to limit the badly behaving clients access to gpu.
561  */
562 #define I915_MAX_CLIENT_CONTEXT_BANS 3
563         int context_bans;
564 };
565
566 /* Used by dp and fdi links */
567 struct intel_link_m_n {
568         uint32_t        tu;
569         uint32_t        gmch_m;
570         uint32_t        gmch_n;
571         uint32_t        link_m;
572         uint32_t        link_n;
573 };
574
575 void intel_link_compute_m_n(int bpp, int nlanes,
576                             int pixel_clock, int link_clock,
577                             struct intel_link_m_n *m_n);
578
579 /* Interface history:
580  *
581  * 1.1: Original.
582  * 1.2: Add Power Management
583  * 1.3: Add vblank support
584  * 1.4: Fix cmdbuffer path, add heap destroy
585  * 1.5: Add vblank pipe configuration
586  * 1.6: - New ioctl for scheduling buffer swaps on vertical blank
587  *      - Support vertical blank on secondary display pipe
588  */
589 #define DRIVER_MAJOR            1
590 #define DRIVER_MINOR            6
591 #define DRIVER_PATCHLEVEL       0
592
593 struct opregion_header;
594 struct opregion_acpi;
595 struct opregion_swsci;
596 struct opregion_asle;
597
598 struct intel_opregion {
599         struct opregion_header *header;
600         struct opregion_acpi *acpi;
601         struct opregion_swsci *swsci;
602         u32 swsci_gbda_sub_functions;
603         u32 swsci_sbcb_sub_functions;
604         struct opregion_asle *asle;
605         void *rvda;
606         const void *vbt;
607         u32 vbt_size;
608         u32 *lid_state;
609         struct work_struct asle_work;
610 };
611 #define OPREGION_SIZE            (8*1024)
612
613 struct intel_overlay;
614 struct intel_overlay_error_state;
615
616 struct sdvo_device_mapping {
617         u8 initialized;
618         u8 dvo_port;
619         u8 slave_addr;
620         u8 dvo_wiring;
621         u8 i2c_pin;
622         u8 ddc_pin;
623 };
624
625 struct intel_connector;
626 struct intel_encoder;
627 struct intel_atomic_state;
628 struct intel_crtc_state;
629 struct intel_initial_plane_config;
630 struct intel_crtc;
631 struct intel_limit;
632 struct dpll;
633 struct intel_cdclk_state;
634
635 struct drm_i915_display_funcs {
636         void (*get_cdclk)(struct drm_i915_private *dev_priv,
637                           struct intel_cdclk_state *cdclk_state);
638         void (*set_cdclk)(struct drm_i915_private *dev_priv,
639                           const struct intel_cdclk_state *cdclk_state);
640         int (*get_fifo_size)(struct drm_i915_private *dev_priv, int plane);
641         int (*compute_pipe_wm)(struct intel_crtc_state *cstate);
642         int (*compute_intermediate_wm)(struct drm_device *dev,
643                                        struct intel_crtc *intel_crtc,
644                                        struct intel_crtc_state *newstate);
645         void (*initial_watermarks)(struct intel_atomic_state *state,
646                                    struct intel_crtc_state *cstate);
647         void (*atomic_update_watermarks)(struct intel_atomic_state *state,
648                                          struct intel_crtc_state *cstate);
649         void (*optimize_watermarks)(struct intel_atomic_state *state,
650                                     struct intel_crtc_state *cstate);
651         int (*compute_global_watermarks)(struct drm_atomic_state *state);
652         void (*update_wm)(struct intel_crtc *crtc);
653         int (*modeset_calc_cdclk)(struct drm_atomic_state *state);
654         /* Returns the active state of the crtc, and if the crtc is active,
655          * fills out the pipe-config with the hw state. */
656         bool (*get_pipe_config)(struct intel_crtc *,
657                                 struct intel_crtc_state *);
658         void (*get_initial_plane_config)(struct intel_crtc *,
659                                          struct intel_initial_plane_config *);
660         int (*crtc_compute_clock)(struct intel_crtc *crtc,
661                                   struct intel_crtc_state *crtc_state);
662         void (*crtc_enable)(struct intel_crtc_state *pipe_config,
663                             struct drm_atomic_state *old_state);
664         void (*crtc_disable)(struct intel_crtc_state *old_crtc_state,
665                              struct drm_atomic_state *old_state);
666         void (*update_crtcs)(struct drm_atomic_state *state,
667                              unsigned int *crtc_vblank_mask);
668         void (*audio_codec_enable)(struct drm_connector *connector,
669                                    struct intel_encoder *encoder,
670                                    const struct drm_display_mode *adjusted_mode);
671         void (*audio_codec_disable)(struct intel_encoder *encoder);
672         void (*fdi_link_train)(struct intel_crtc *crtc);
673         void (*init_clock_gating)(struct drm_i915_private *dev_priv);
674         int (*queue_flip)(struct drm_device *dev, struct drm_crtc *crtc,
675                           struct drm_framebuffer *fb,
676                           struct drm_i915_gem_object *obj,
677                           struct drm_i915_gem_request *req,
678                           uint32_t flags);
679         void (*hpd_irq_setup)(struct drm_i915_private *dev_priv);
680         /* clock updates for mode set */
681         /* cursor updates */
682         /* render clock increase/decrease */
683         /* display clock increase/decrease */
684         /* pll clock increase/decrease */
685
686         void (*load_csc_matrix)(struct drm_crtc_state *crtc_state);
687         void (*load_luts)(struct drm_crtc_state *crtc_state);
688 };
689
690 enum forcewake_domain_id {
691         FW_DOMAIN_ID_RENDER = 0,
692         FW_DOMAIN_ID_BLITTER,
693         FW_DOMAIN_ID_MEDIA,
694
695         FW_DOMAIN_ID_COUNT
696 };
697
698 enum forcewake_domains {
699         FORCEWAKE_RENDER = (1 << FW_DOMAIN_ID_RENDER),
700         FORCEWAKE_BLITTER = (1 << FW_DOMAIN_ID_BLITTER),
701         FORCEWAKE_MEDIA = (1 << FW_DOMAIN_ID_MEDIA),
702         FORCEWAKE_ALL = (FORCEWAKE_RENDER |
703                          FORCEWAKE_BLITTER |
704                          FORCEWAKE_MEDIA)
705 };
706
707 #define FW_REG_READ  (1)
708 #define FW_REG_WRITE (2)
709
710 enum decoupled_power_domain {
711         GEN9_DECOUPLED_PD_BLITTER = 0,
712         GEN9_DECOUPLED_PD_RENDER,
713         GEN9_DECOUPLED_PD_MEDIA,
714         GEN9_DECOUPLED_PD_ALL
715 };
716
717 enum decoupled_ops {
718         GEN9_DECOUPLED_OP_WRITE = 0,
719         GEN9_DECOUPLED_OP_READ
720 };
721
722 enum forcewake_domains
723 intel_uncore_forcewake_for_reg(struct drm_i915_private *dev_priv,
724                                i915_reg_t reg, unsigned int op);
725
726 struct intel_uncore_funcs {
727         void (*force_wake_get)(struct drm_i915_private *dev_priv,
728                                                         enum forcewake_domains domains);
729         void (*force_wake_put)(struct drm_i915_private *dev_priv,
730                                                         enum forcewake_domains domains);
731
732         uint8_t  (*mmio_readb)(struct drm_i915_private *dev_priv, i915_reg_t r, bool trace);
733         uint16_t (*mmio_readw)(struct drm_i915_private *dev_priv, i915_reg_t r, bool trace);
734         uint32_t (*mmio_readl)(struct drm_i915_private *dev_priv, i915_reg_t r, bool trace);
735         uint64_t (*mmio_readq)(struct drm_i915_private *dev_priv, i915_reg_t r, bool trace);
736
737         void (*mmio_writeb)(struct drm_i915_private *dev_priv, i915_reg_t r,
738                                 uint8_t val, bool trace);
739         void (*mmio_writew)(struct drm_i915_private *dev_priv, i915_reg_t r,
740                                 uint16_t val, bool trace);
741         void (*mmio_writel)(struct drm_i915_private *dev_priv, i915_reg_t r,
742                                 uint32_t val, bool trace);
743 };
744
745 struct intel_forcewake_range {
746         u32 start;
747         u32 end;
748
749         enum forcewake_domains domains;
750 };
751
752 struct intel_uncore {
753         spinlock_t lock; /** lock is also taken in irq contexts. */
754
755         const struct intel_forcewake_range *fw_domains_table;
756         unsigned int fw_domains_table_entries;
757
758         struct intel_uncore_funcs funcs;
759
760         unsigned fifo_count;
761
762         enum forcewake_domains fw_domains;
763         enum forcewake_domains fw_domains_active;
764
765         struct intel_uncore_forcewake_domain {
766                 struct drm_i915_private *i915;
767                 enum forcewake_domain_id id;
768                 enum forcewake_domains mask;
769                 unsigned wake_count;
770                 struct hrtimer timer;
771                 i915_reg_t reg_set;
772                 u32 val_set;
773                 u32 val_clear;
774                 i915_reg_t reg_ack;
775                 i915_reg_t reg_post;
776                 u32 val_reset;
777         } fw_domain[FW_DOMAIN_ID_COUNT];
778
779         int unclaimed_mmio_check;
780 };
781
782 /* Iterate over initialised fw domains */
783 #define for_each_fw_domain_masked(domain__, mask__, dev_priv__) \
784         for ((domain__) = &(dev_priv__)->uncore.fw_domain[0]; \
785              (domain__) < &(dev_priv__)->uncore.fw_domain[FW_DOMAIN_ID_COUNT]; \
786              (domain__)++) \
787                 for_each_if ((mask__) & (domain__)->mask)
788
789 #define for_each_fw_domain(domain__, dev_priv__) \
790         for_each_fw_domain_masked(domain__, FORCEWAKE_ALL, dev_priv__)
791
792 #define CSR_VERSION(major, minor)       ((major) << 16 | (minor))
793 #define CSR_VERSION_MAJOR(version)      ((version) >> 16)
794 #define CSR_VERSION_MINOR(version)      ((version) & 0xffff)
795
796 struct intel_csr {
797         struct work_struct work;
798         const char *fw_path;
799         uint32_t *dmc_payload;
800         uint32_t dmc_fw_size;
801         uint32_t version;
802         uint32_t mmio_count;
803         i915_reg_t mmioaddr[8];
804         uint32_t mmiodata[8];
805         uint32_t dc_state;
806         uint32_t allowed_dc_mask;
807 };
808
809 #define DEV_INFO_FOR_EACH_FLAG(func) \
810         func(is_mobile); \
811         func(is_lp); \
812         func(is_alpha_support); \
813         /* Keep has_* in alphabetical order */ \
814         func(has_64bit_reloc); \
815         func(has_aliasing_ppgtt); \
816         func(has_csr); \
817         func(has_ddi); \
818         func(has_decoupled_mmio); \
819         func(has_dp_mst); \
820         func(has_fbc); \
821         func(has_fpga_dbg); \
822         func(has_full_ppgtt); \
823         func(has_full_48bit_ppgtt); \
824         func(has_gmbus_irq); \
825         func(has_gmch_display); \
826         func(has_guc); \
827         func(has_hotplug); \
828         func(has_hw_contexts); \
829         func(has_l3_dpf); \
830         func(has_llc); \
831         func(has_logical_ring_contexts); \
832         func(has_overlay); \
833         func(has_pipe_cxsr); \
834         func(has_pooled_eu); \
835         func(has_psr); \
836         func(has_rc6); \
837         func(has_rc6p); \
838         func(has_resource_streamer); \
839         func(has_runtime_pm); \
840         func(has_snoop); \
841         func(cursor_needs_physical); \
842         func(hws_needs_physical); \
843         func(overlay_needs_physical); \
844         func(supports_tv);
845
846 struct sseu_dev_info {
847         u8 slice_mask;
848         u8 subslice_mask;
849         u8 eu_total;
850         u8 eu_per_subslice;
851         u8 min_eu_in_pool;
852         /* For each slice, which subslice(s) has(have) 7 EUs (bitfield)? */
853         u8 subslice_7eu[3];
854         u8 has_slice_pg:1;
855         u8 has_subslice_pg:1;
856         u8 has_eu_pg:1;
857 };
858
859 static inline unsigned int sseu_subslice_total(const struct sseu_dev_info *sseu)
860 {
861         return hweight8(sseu->slice_mask) * hweight8(sseu->subslice_mask);
862 }
863
864 /* Keep in gen based order, and chronological order within a gen */
865 enum intel_platform {
866         INTEL_PLATFORM_UNINITIALIZED = 0,
867         INTEL_I830,
868         INTEL_I845G,
869         INTEL_I85X,
870         INTEL_I865G,
871         INTEL_I915G,
872         INTEL_I915GM,
873         INTEL_I945G,
874         INTEL_I945GM,
875         INTEL_G33,
876         INTEL_PINEVIEW,
877         INTEL_I965G,
878         INTEL_I965GM,
879         INTEL_G45,
880         INTEL_GM45,
881         INTEL_IRONLAKE,
882         INTEL_SANDYBRIDGE,
883         INTEL_IVYBRIDGE,
884         INTEL_VALLEYVIEW,
885         INTEL_HASWELL,
886         INTEL_BROADWELL,
887         INTEL_CHERRYVIEW,
888         INTEL_SKYLAKE,
889         INTEL_BROXTON,
890         INTEL_KABYLAKE,
891         INTEL_GEMINILAKE,
892         INTEL_MAX_PLATFORMS
893 };
894
895 struct intel_device_info {
896         u32 display_mmio_offset;
897         u16 device_id;
898         u8 num_pipes;
899         u8 num_sprites[I915_MAX_PIPES];
900         u8 num_scalers[I915_MAX_PIPES];
901         u8 gen;
902         u16 gen_mask;
903         enum intel_platform platform;
904         u8 ring_mask; /* Rings supported by the HW */
905         u8 num_rings;
906 #define DEFINE_FLAG(name) u8 name:1
907         DEV_INFO_FOR_EACH_FLAG(DEFINE_FLAG);
908 #undef DEFINE_FLAG
909         u16 ddb_size; /* in blocks */
910         /* Register offsets for the various display pipes and transcoders */
911         int pipe_offsets[I915_MAX_TRANSCODERS];
912         int trans_offsets[I915_MAX_TRANSCODERS];
913         int palette_offsets[I915_MAX_PIPES];
914         int cursor_offsets[I915_MAX_PIPES];
915
916         /* Slice/subslice/EU info */
917         struct sseu_dev_info sseu;
918
919         struct color_luts {
920                 u16 degamma_lut_size;
921                 u16 gamma_lut_size;
922         } color;
923 };
924
925 struct intel_display_error_state;
926
927 struct i915_gpu_state {
928         struct kref ref;
929         struct timeval time;
930         struct timeval boottime;
931         struct timeval uptime;
932
933         struct drm_i915_private *i915;
934
935         char error_msg[128];
936         bool simulated;
937         bool awake;
938         bool wakelock;
939         bool suspended;
940         int iommu;
941         u32 reset_count;
942         u32 suspend_count;
943         struct intel_device_info device_info;
944         struct i915_params params;
945
946         /* Generic register state */
947         u32 eir;
948         u32 pgtbl_er;
949         u32 ier;
950         u32 gtier[4], ngtier;
951         u32 ccid;
952         u32 derrmr;
953         u32 forcewake;
954         u32 error; /* gen6+ */
955         u32 err_int; /* gen7 */
956         u32 fault_data0; /* gen8, gen9 */
957         u32 fault_data1; /* gen8, gen9 */
958         u32 done_reg;
959         u32 gac_eco;
960         u32 gam_ecochk;
961         u32 gab_ctl;
962         u32 gfx_mode;
963
964         u32 nfence;
965         u64 fence[I915_MAX_NUM_FENCES];
966         struct intel_overlay_error_state *overlay;
967         struct intel_display_error_state *display;
968         struct drm_i915_error_object *semaphore;
969         struct drm_i915_error_object *guc_log;
970
971         struct drm_i915_error_engine {
972                 int engine_id;
973                 /* Software tracked state */
974                 bool waiting;
975                 int num_waiters;
976                 unsigned long hangcheck_timestamp;
977                 bool hangcheck_stalled;
978                 enum intel_engine_hangcheck_action hangcheck_action;
979                 struct i915_address_space *vm;
980                 int num_requests;
981
982                 /* position of active request inside the ring */
983                 u32 rq_head, rq_post, rq_tail;
984
985                 /* our own tracking of ring head and tail */
986                 u32 cpu_ring_head;
987                 u32 cpu_ring_tail;
988
989                 u32 last_seqno;
990
991                 /* Register state */
992                 u32 start;
993                 u32 tail;
994                 u32 head;
995                 u32 ctl;
996                 u32 mode;
997                 u32 hws;
998                 u32 ipeir;
999                 u32 ipehr;
1000                 u32 bbstate;
1001                 u32 instpm;
1002                 u32 instps;
1003                 u32 seqno;
1004                 u64 bbaddr;
1005                 u64 acthd;
1006                 u32 fault_reg;
1007                 u64 faddr;
1008                 u32 rc_psmi; /* sleep state */
1009                 u32 semaphore_mboxes[I915_NUM_ENGINES - 1];
1010                 struct intel_instdone instdone;
1011
1012                 struct drm_i915_error_context {
1013                         char comm[TASK_COMM_LEN];
1014                         pid_t pid;
1015                         u32 handle;
1016                         u32 hw_id;
1017                         int ban_score;
1018                         int active;
1019                         int guilty;
1020                 } context;
1021
1022                 struct drm_i915_error_object {
1023                         u64 gtt_offset;
1024                         u64 gtt_size;
1025                         int page_count;
1026                         int unused;
1027                         u32 *pages[0];
1028                 } *ringbuffer, *batchbuffer, *wa_batchbuffer, *ctx, *hws_page;
1029
1030                 struct drm_i915_error_object *wa_ctx;
1031
1032                 struct drm_i915_error_request {
1033                         long jiffies;
1034                         pid_t pid;
1035                         u32 context;
1036                         int ban_score;
1037                         u32 seqno;
1038                         u32 head;
1039                         u32 tail;
1040                 } *requests, execlist[2];
1041
1042                 struct drm_i915_error_waiter {
1043                         char comm[TASK_COMM_LEN];
1044                         pid_t pid;
1045                         u32 seqno;
1046                 } *waiters;
1047
1048                 struct {
1049                         u32 gfx_mode;
1050                         union {
1051                                 u64 pdp[4];
1052                                 u32 pp_dir_base;
1053                         };
1054                 } vm_info;
1055         } engine[I915_NUM_ENGINES];
1056
1057         struct drm_i915_error_buffer {
1058                 u32 size;
1059                 u32 name;
1060                 u32 rseqno[I915_NUM_ENGINES], wseqno;
1061                 u64 gtt_offset;
1062                 u32 read_domains;
1063                 u32 write_domain;
1064                 s32 fence_reg:I915_MAX_NUM_FENCE_BITS;
1065                 u32 tiling:2;
1066                 u32 dirty:1;
1067                 u32 purgeable:1;
1068                 u32 userptr:1;
1069                 s32 engine:4;
1070                 u32 cache_level:3;
1071         } *active_bo[I915_NUM_ENGINES], *pinned_bo;
1072         u32 active_bo_count[I915_NUM_ENGINES], pinned_bo_count;
1073         struct i915_address_space *active_vm[I915_NUM_ENGINES];
1074 };
1075
1076 enum i915_cache_level {
1077         I915_CACHE_NONE = 0,
1078         I915_CACHE_LLC, /* also used for snoopable memory on non-LLC */
1079         I915_CACHE_L3_LLC, /* gen7+, L3 sits between the domain specifc
1080                               caches, eg sampler/render caches, and the
1081                               large Last-Level-Cache. LLC is coherent with
1082                               the CPU, but L3 is only visible to the GPU. */
1083         I915_CACHE_WT, /* hsw:gt3e WriteThrough for scanouts */
1084 };
1085
1086 #define I915_COLOR_UNEVICTABLE (-1) /* a non-vma sharing the address space */
1087
1088 enum fb_op_origin {
1089         ORIGIN_GTT,
1090         ORIGIN_CPU,
1091         ORIGIN_CS,
1092         ORIGIN_FLIP,
1093         ORIGIN_DIRTYFB,
1094 };
1095
1096 struct intel_fbc {
1097         /* This is always the inner lock when overlapping with struct_mutex and
1098          * it's the outer lock when overlapping with stolen_lock. */
1099         struct mutex lock;
1100         unsigned threshold;
1101         unsigned int possible_framebuffer_bits;
1102         unsigned int busy_bits;
1103         unsigned int visible_pipes_mask;
1104         struct intel_crtc *crtc;
1105
1106         struct drm_mm_node compressed_fb;
1107         struct drm_mm_node *compressed_llb;
1108
1109         bool false_color;
1110
1111         bool enabled;
1112         bool active;
1113
1114         bool underrun_detected;
1115         struct work_struct underrun_work;
1116
1117         struct intel_fbc_state_cache {
1118                 struct i915_vma *vma;
1119
1120                 struct {
1121                         unsigned int mode_flags;
1122                         uint32_t hsw_bdw_pixel_rate;
1123                 } crtc;
1124
1125                 struct {
1126                         unsigned int rotation;
1127                         int src_w;
1128                         int src_h;
1129                         bool visible;
1130                 } plane;
1131
1132                 struct {
1133                         const struct drm_format_info *format;
1134                         unsigned int stride;
1135                 } fb;
1136         } state_cache;
1137
1138         struct intel_fbc_reg_params {
1139                 struct i915_vma *vma;
1140
1141                 struct {
1142                         enum pipe pipe;
1143                         enum plane plane;
1144                         unsigned int fence_y_offset;
1145                 } crtc;
1146
1147                 struct {
1148                         const struct drm_format_info *format;
1149                         unsigned int stride;
1150                 } fb;
1151
1152                 int cfb_size;
1153         } params;
1154
1155         struct intel_fbc_work {
1156                 bool scheduled;
1157                 u32 scheduled_vblank;
1158                 struct work_struct work;
1159         } work;
1160
1161         const char *no_fbc_reason;
1162 };
1163
1164 /*
1165  * HIGH_RR is the highest eDP panel refresh rate read from EDID
1166  * LOW_RR is the lowest eDP panel refresh rate found from EDID
1167  * parsing for same resolution.
1168  */
1169 enum drrs_refresh_rate_type {
1170         DRRS_HIGH_RR,
1171         DRRS_LOW_RR,
1172         DRRS_MAX_RR, /* RR count */
1173 };
1174
1175 enum drrs_support_type {
1176         DRRS_NOT_SUPPORTED = 0,
1177         STATIC_DRRS_SUPPORT = 1,
1178         SEAMLESS_DRRS_SUPPORT = 2
1179 };
1180
1181 struct intel_dp;
1182 struct i915_drrs {
1183         struct mutex mutex;
1184         struct delayed_work work;
1185         struct intel_dp *dp;
1186         unsigned busy_frontbuffer_bits;
1187         enum drrs_refresh_rate_type refresh_rate_type;
1188         enum drrs_support_type type;
1189 };
1190
1191 struct i915_psr {
1192         struct mutex lock;
1193         bool sink_support;
1194         bool source_ok;
1195         struct intel_dp *enabled;
1196         bool active;
1197         struct delayed_work work;
1198         unsigned busy_frontbuffer_bits;
1199         bool psr2_support;
1200         bool aux_frame_sync;
1201         bool link_standby;
1202         bool y_cord_support;
1203         bool colorimetry_support;
1204         bool alpm;
1205 };
1206
1207 enum intel_pch {
1208         PCH_NONE = 0,   /* No PCH present */
1209         PCH_IBX,        /* Ibexpeak PCH */
1210         PCH_CPT,        /* Cougarpoint PCH */
1211         PCH_LPT,        /* Lynxpoint PCH */
1212         PCH_SPT,        /* Sunrisepoint PCH */
1213         PCH_KBP,        /* Kabypoint PCH */
1214         PCH_NOP,
1215 };
1216
1217 enum intel_sbi_destination {
1218         SBI_ICLK,
1219         SBI_MPHY,
1220 };
1221
1222 #define QUIRK_PIPEA_FORCE (1<<0)
1223 #define QUIRK_LVDS_SSC_DISABLE (1<<1)
1224 #define QUIRK_INVERT_BRIGHTNESS (1<<2)
1225 #define QUIRK_BACKLIGHT_PRESENT (1<<3)
1226 #define QUIRK_PIPEB_FORCE (1<<4)
1227 #define QUIRK_PIN_SWIZZLED_PAGES (1<<5)
1228
1229 struct intel_fbdev;
1230 struct intel_fbc_work;
1231
1232 struct intel_gmbus {
1233         struct i2c_adapter adapter;
1234 #define GMBUS_FORCE_BIT_RETRY (1U << 31)
1235         u32 force_bit;
1236         u32 reg0;
1237         i915_reg_t gpio_reg;
1238         struct i2c_algo_bit_data bit_algo;
1239         struct drm_i915_private *dev_priv;
1240 };
1241
1242 struct i915_suspend_saved_registers {
1243         u32 saveDSPARB;
1244         u32 saveFBC_CONTROL;
1245         u32 saveCACHE_MODE_0;
1246         u32 saveMI_ARB_STATE;
1247         u32 saveSWF0[16];
1248         u32 saveSWF1[16];
1249         u32 saveSWF3[3];
1250         uint64_t saveFENCE[I915_MAX_NUM_FENCES];
1251         u32 savePCH_PORT_HOTPLUG;
1252         u16 saveGCDGMBUS;
1253 };
1254
1255 struct vlv_s0ix_state {
1256         /* GAM */
1257         u32 wr_watermark;
1258         u32 gfx_prio_ctrl;
1259         u32 arb_mode;
1260         u32 gfx_pend_tlb0;
1261         u32 gfx_pend_tlb1;
1262         u32 lra_limits[GEN7_LRA_LIMITS_REG_NUM];
1263         u32 media_max_req_count;
1264         u32 gfx_max_req_count;
1265         u32 render_hwsp;
1266         u32 ecochk;
1267         u32 bsd_hwsp;
1268         u32 blt_hwsp;
1269         u32 tlb_rd_addr;
1270
1271         /* MBC */
1272         u32 g3dctl;
1273         u32 gsckgctl;
1274         u32 mbctl;
1275
1276         /* GCP */
1277         u32 ucgctl1;
1278         u32 ucgctl3;
1279         u32 rcgctl1;
1280         u32 rcgctl2;
1281         u32 rstctl;
1282         u32 misccpctl;
1283
1284         /* GPM */
1285         u32 gfxpause;
1286         u32 rpdeuhwtc;
1287         u32 rpdeuc;
1288         u32 ecobus;
1289         u32 pwrdwnupctl;
1290         u32 rp_down_timeout;
1291         u32 rp_deucsw;
1292         u32 rcubmabdtmr;
1293         u32 rcedata;
1294         u32 spare2gh;
1295
1296         /* Display 1 CZ domain */
1297         u32 gt_imr;
1298         u32 gt_ier;
1299         u32 pm_imr;
1300         u32 pm_ier;
1301         u32 gt_scratch[GEN7_GT_SCRATCH_REG_NUM];
1302
1303         /* GT SA CZ domain */
1304         u32 tilectl;
1305         u32 gt_fifoctl;
1306         u32 gtlc_wake_ctrl;
1307         u32 gtlc_survive;
1308         u32 pmwgicz;
1309
1310         /* Display 2 CZ domain */
1311         u32 gu_ctl0;
1312         u32 gu_ctl1;
1313         u32 pcbr;
1314         u32 clock_gate_dis2;
1315 };
1316
1317 struct intel_rps_ei {
1318         u32 cz_clock;
1319         u32 render_c0;
1320         u32 media_c0;
1321 };
1322
1323 struct intel_gen6_power_mgmt {
1324         /*
1325          * work, interrupts_enabled and pm_iir are protected by
1326          * dev_priv->irq_lock
1327          */
1328         struct work_struct work;
1329         bool interrupts_enabled;
1330         u32 pm_iir;
1331
1332         /* PM interrupt bits that should never be masked */
1333         u32 pm_intr_keep;
1334
1335         /* Frequencies are stored in potentially platform dependent multiples.
1336          * In other words, *_freq needs to be multiplied by X to be interesting.
1337          * Soft limits are those which are used for the dynamic reclocking done
1338          * by the driver (raise frequencies under heavy loads, and lower for
1339          * lighter loads). Hard limits are those imposed by the hardware.
1340          *
1341          * A distinction is made for overclocking, which is never enabled by
1342          * default, and is considered to be above the hard limit if it's
1343          * possible at all.
1344          */
1345         u8 cur_freq;            /* Current frequency (cached, may not == HW) */
1346         u8 min_freq_softlimit;  /* Minimum frequency permitted by the driver */
1347         u8 max_freq_softlimit;  /* Max frequency permitted by the driver */
1348         u8 max_freq;            /* Maximum frequency, RP0 if not overclocking */
1349         u8 min_freq;            /* AKA RPn. Minimum frequency */
1350         u8 boost_freq;          /* Frequency to request when wait boosting */
1351         u8 idle_freq;           /* Frequency to request when we are idle */
1352         u8 efficient_freq;      /* AKA RPe. Pre-determined balanced frequency */
1353         u8 rp1_freq;            /* "less than" RP0 power/freqency */
1354         u8 rp0_freq;            /* Non-overclocked max frequency. */
1355         u16 gpll_ref_freq;      /* vlv/chv GPLL reference frequency */
1356
1357         u8 up_threshold; /* Current %busy required to uplock */
1358         u8 down_threshold; /* Current %busy required to downclock */
1359
1360         int last_adj;
1361         enum { LOW_POWER, BETWEEN, HIGH_POWER } power;
1362
1363         spinlock_t client_lock;
1364         struct list_head clients;
1365         bool client_boost;
1366
1367         bool enabled;
1368         struct delayed_work autoenable_work;
1369         unsigned boosts;
1370
1371         /* manual wa residency calculations */
1372         struct intel_rps_ei up_ei, down_ei;
1373
1374         /*
1375          * Protects RPS/RC6 register access and PCU communication.
1376          * Must be taken after struct_mutex if nested. Note that
1377          * this lock may be held for long periods of time when
1378          * talking to hw - so only take it when talking to hw!
1379          */
1380         struct mutex hw_lock;
1381 };
1382
1383 /* defined intel_pm.c */
1384 extern spinlock_t mchdev_lock;
1385
1386 struct intel_ilk_power_mgmt {
1387         u8 cur_delay;
1388         u8 min_delay;
1389         u8 max_delay;
1390         u8 fmax;
1391         u8 fstart;
1392
1393         u64 last_count1;
1394         unsigned long last_time1;
1395         unsigned long chipset_power;
1396         u64 last_count2;
1397         u64 last_time2;
1398         unsigned long gfx_power;
1399         u8 corr;
1400
1401         int c_m;
1402         int r_t;
1403 };
1404
1405 struct drm_i915_private;
1406 struct i915_power_well;
1407
1408 struct i915_power_well_ops {
1409         /*
1410          * Synchronize the well's hw state to match the current sw state, for
1411          * example enable/disable it based on the current refcount. Called
1412          * during driver init and resume time, possibly after first calling
1413          * the enable/disable handlers.
1414          */
1415         void (*sync_hw)(struct drm_i915_private *dev_priv,
1416                         struct i915_power_well *power_well);
1417         /*
1418          * Enable the well and resources that depend on it (for example
1419          * interrupts located on the well). Called after the 0->1 refcount
1420          * transition.
1421          */
1422         void (*enable)(struct drm_i915_private *dev_priv,
1423                        struct i915_power_well *power_well);
1424         /*
1425          * Disable the well and resources that depend on it. Called after
1426          * the 1->0 refcount transition.
1427          */
1428         void (*disable)(struct drm_i915_private *dev_priv,
1429                         struct i915_power_well *power_well);
1430         /* Returns the hw enabled state. */
1431         bool (*is_enabled)(struct drm_i915_private *dev_priv,
1432                            struct i915_power_well *power_well);
1433 };
1434
1435 /* Power well structure for haswell */
1436 struct i915_power_well {
1437         const char *name;
1438         bool always_on;
1439         /* power well enable/disable usage count */
1440         int count;
1441         /* cached hw enabled state */
1442         bool hw_enabled;
1443         u64 domains;
1444         /* unique identifier for this power well */
1445         unsigned long id;
1446         /*
1447          * Arbitraty data associated with this power well. Platform and power
1448          * well specific.
1449          */
1450         unsigned long data;
1451         const struct i915_power_well_ops *ops;
1452 };
1453
1454 struct i915_power_domains {
1455         /*
1456          * Power wells needed for initialization at driver init and suspend
1457          * time are on. They are kept on until after the first modeset.
1458          */
1459         bool init_power_on;
1460         bool initializing;
1461         int power_well_count;
1462
1463         struct mutex lock;
1464         int domain_use_count[POWER_DOMAIN_NUM];
1465         struct i915_power_well *power_wells;
1466 };
1467
1468 #define MAX_L3_SLICES 2
1469 struct intel_l3_parity {
1470         u32 *remap_info[MAX_L3_SLICES];
1471         struct work_struct error_work;
1472         int which_slice;
1473 };
1474
1475 struct i915_gem_mm {
1476         /** Memory allocator for GTT stolen memory */
1477         struct drm_mm stolen;
1478         /** Protects the usage of the GTT stolen memory allocator. This is
1479          * always the inner lock when overlapping with struct_mutex. */
1480         struct mutex stolen_lock;
1481
1482         /** List of all objects in gtt_space. Used to restore gtt
1483          * mappings on resume */
1484         struct list_head bound_list;
1485         /**
1486          * List of objects which are not bound to the GTT (thus
1487          * are idle and not used by the GPU). These objects may or may
1488          * not actually have any pages attached.
1489          */
1490         struct list_head unbound_list;
1491
1492         /** List of all objects in gtt_space, currently mmaped by userspace.
1493          * All objects within this list must also be on bound_list.
1494          */
1495         struct list_head userfault_list;
1496
1497         /**
1498          * List of objects which are pending destruction.
1499          */
1500         struct llist_head free_list;
1501         struct work_struct free_work;
1502
1503         /** Usable portion of the GTT for GEM */
1504         dma_addr_t stolen_base; /* limited to low memory (32-bit) */
1505
1506         /** PPGTT used for aliasing the PPGTT with the GTT */
1507         struct i915_hw_ppgtt *aliasing_ppgtt;
1508
1509         struct notifier_block oom_notifier;
1510         struct notifier_block vmap_notifier;
1511         struct shrinker shrinker;
1512
1513         /** LRU list of objects with fence regs on them. */
1514         struct list_head fence_list;
1515
1516         /**
1517          * Are we in a non-interruptible section of code like
1518          * modesetting?
1519          */
1520         bool interruptible;
1521
1522         /* the indicator for dispatch video commands on two BSD rings */
1523         atomic_t bsd_engine_dispatch_index;
1524
1525         /** Bit 6 swizzling required for X tiling */
1526         uint32_t bit_6_swizzle_x;
1527         /** Bit 6 swizzling required for Y tiling */
1528         uint32_t bit_6_swizzle_y;
1529
1530         /* accounting, useful for userland debugging */
1531         spinlock_t object_stat_lock;
1532         u64 object_memory;
1533         u32 object_count;
1534 };
1535
1536 struct drm_i915_error_state_buf {
1537         struct drm_i915_private *i915;
1538         unsigned bytes;
1539         unsigned size;
1540         int err;
1541         u8 *buf;
1542         loff_t start;
1543         loff_t pos;
1544 };
1545
1546 #define I915_RESET_TIMEOUT (10 * HZ) /* 10s */
1547 #define I915_FENCE_TIMEOUT (10 * HZ) /* 10s */
1548
1549 #define I915_ENGINE_DEAD_TIMEOUT  (4 * HZ)  /* Seqno, head and subunits dead */
1550 #define I915_SEQNO_DEAD_TIMEOUT   (12 * HZ) /* Seqno dead with active head */
1551
1552 struct i915_gpu_error {
1553         /* For hangcheck timer */
1554 #define DRM_I915_HANGCHECK_PERIOD 1500 /* in ms */
1555 #define DRM_I915_HANGCHECK_JIFFIES msecs_to_jiffies(DRM_I915_HANGCHECK_PERIOD)
1556
1557         struct delayed_work hangcheck_work;
1558
1559         /* For reset and error_state handling. */
1560         spinlock_t lock;
1561         /* Protected by the above dev->gpu_error.lock. */
1562         struct i915_gpu_state *first_error;
1563
1564         unsigned long missed_irq_rings;
1565
1566         /**
1567          * State variable controlling the reset flow and count
1568          *
1569          * This is a counter which gets incremented when reset is triggered,
1570          *
1571          * Before the reset commences, the I915_RESET_IN_PROGRESS bit is set
1572          * meaning that any waiters holding onto the struct_mutex should
1573          * relinquish the lock immediately in order for the reset to start.
1574          *
1575          * If reset is not completed succesfully, the I915_WEDGE bit is
1576          * set meaning that hardware is terminally sour and there is no
1577          * recovery. All waiters on the reset_queue will be woken when
1578          * that happens.
1579          *
1580          * This counter is used by the wait_seqno code to notice that reset
1581          * event happened and it needs to restart the entire ioctl (since most
1582          * likely the seqno it waited for won't ever signal anytime soon).
1583          *
1584          * This is important for lock-free wait paths, where no contended lock
1585          * naturally enforces the correct ordering between the bail-out of the
1586          * waiter and the gpu reset work code.
1587          */
1588         unsigned long reset_count;
1589
1590         unsigned long flags;
1591 #define I915_RESET_IN_PROGRESS  0
1592 #define I915_WEDGED             (BITS_PER_LONG - 1)
1593
1594         /**
1595          * Waitqueue to signal when a hang is detected. Used to for waiters
1596          * to release the struct_mutex for the reset to procede.
1597          */
1598         wait_queue_head_t wait_queue;
1599
1600         /**
1601          * Waitqueue to signal when the reset has completed. Used by clients
1602          * that wait for dev_priv->mm.wedged to settle.
1603          */
1604         wait_queue_head_t reset_queue;
1605
1606         /* For missed irq/seqno simulation. */
1607         unsigned long test_irq_rings;
1608 };
1609
1610 enum modeset_restore {
1611         MODESET_ON_LID_OPEN,
1612         MODESET_DONE,
1613         MODESET_SUSPENDED,
1614 };
1615
1616 #define DP_AUX_A 0x40
1617 #define DP_AUX_B 0x10
1618 #define DP_AUX_C 0x20
1619 #define DP_AUX_D 0x30
1620
1621 #define DDC_PIN_B  0x05
1622 #define DDC_PIN_C  0x04
1623 #define DDC_PIN_D  0x06
1624
1625 struct ddi_vbt_port_info {
1626         /*
1627          * This is an index in the HDMI/DVI DDI buffer translation table.
1628          * The special value HDMI_LEVEL_SHIFT_UNKNOWN means the VBT didn't
1629          * populate this field.
1630          */
1631 #define HDMI_LEVEL_SHIFT_UNKNOWN        0xff
1632         uint8_t hdmi_level_shift;
1633
1634         uint8_t supports_dvi:1;
1635         uint8_t supports_hdmi:1;
1636         uint8_t supports_dp:1;
1637         uint8_t supports_edp:1;
1638
1639         uint8_t alternate_aux_channel;
1640         uint8_t alternate_ddc_pin;
1641
1642         uint8_t dp_boost_level;
1643         uint8_t hdmi_boost_level;
1644 };
1645
1646 enum psr_lines_to_wait {
1647         PSR_0_LINES_TO_WAIT = 0,
1648         PSR_1_LINE_TO_WAIT,
1649         PSR_4_LINES_TO_WAIT,
1650         PSR_8_LINES_TO_WAIT
1651 };
1652
1653 struct intel_vbt_data {
1654         struct drm_display_mode *lfp_lvds_vbt_mode; /* if any */
1655         struct drm_display_mode *sdvo_lvds_vbt_mode; /* if any */
1656
1657         /* Feature bits */
1658         unsigned int int_tv_support:1;
1659         unsigned int lvds_dither:1;
1660         unsigned int lvds_vbt:1;
1661         unsigned int int_crt_support:1;
1662         unsigned int lvds_use_ssc:1;
1663         unsigned int display_clock_mode:1;
1664         unsigned int fdi_rx_polarity_inverted:1;
1665         unsigned int panel_type:4;
1666         int lvds_ssc_freq;
1667         unsigned int bios_lvds_val; /* initial [PCH_]LVDS reg val in VBIOS */
1668
1669         enum drrs_support_type drrs_type;
1670
1671         struct {
1672                 int rate;
1673                 int lanes;
1674                 int preemphasis;
1675                 int vswing;
1676                 bool low_vswing;
1677                 bool initialized;
1678                 bool support;
1679                 int bpp;
1680                 struct edp_power_seq pps;
1681         } edp;
1682
1683         struct {
1684                 bool full_link;
1685                 bool require_aux_wakeup;
1686                 int idle_frames;
1687                 enum psr_lines_to_wait lines_to_wait;
1688                 int tp1_wakeup_time;
1689                 int tp2_tp3_wakeup_time;
1690         } psr;
1691
1692         struct {
1693                 u16 pwm_freq_hz;
1694                 bool present;
1695                 bool active_low_pwm;
1696                 u8 min_brightness;      /* min_brightness/255 of max */
1697                 u8 controller;          /* brightness controller number */
1698                 enum intel_backlight_type type;
1699         } backlight;
1700
1701         /* MIPI DSI */
1702         struct {
1703                 u16 panel_id;
1704                 struct mipi_config *config;
1705                 struct mipi_pps_data *pps;
1706                 u8 seq_version;
1707                 u32 size;
1708                 u8 *data;
1709                 const u8 *sequence[MIPI_SEQ_MAX];
1710         } dsi;
1711
1712         int crt_ddc_pin;
1713
1714         int child_dev_num;
1715         union child_device_config *child_dev;
1716
1717         struct ddi_vbt_port_info ddi_port_info[I915_MAX_PORTS];
1718         struct sdvo_device_mapping sdvo_mappings[2];
1719 };
1720
1721 enum intel_ddb_partitioning {
1722         INTEL_DDB_PART_1_2,
1723         INTEL_DDB_PART_5_6, /* IVB+ */
1724 };
1725
1726 struct intel_wm_level {
1727         bool enable;
1728         uint32_t pri_val;
1729         uint32_t spr_val;
1730         uint32_t cur_val;
1731         uint32_t fbc_val;
1732 };
1733
1734 struct ilk_wm_values {
1735         uint32_t wm_pipe[3];
1736         uint32_t wm_lp[3];
1737         uint32_t wm_lp_spr[3];
1738         uint32_t wm_linetime[3];
1739         bool enable_fbc_wm;
1740         enum intel_ddb_partitioning partitioning;
1741 };
1742
1743 struct vlv_pipe_wm {
1744         uint16_t plane[I915_MAX_PLANES];
1745 };
1746
1747 struct vlv_sr_wm {
1748         uint16_t plane;
1749         uint16_t cursor;
1750 };
1751
1752 struct vlv_wm_ddl_values {
1753         uint8_t plane[I915_MAX_PLANES];
1754 };
1755
1756 struct vlv_wm_values {
1757         struct vlv_pipe_wm pipe[3];
1758         struct vlv_sr_wm sr;
1759         struct vlv_wm_ddl_values ddl[3];
1760         uint8_t level;
1761         bool cxsr;
1762 };
1763
1764 struct skl_ddb_entry {
1765         uint16_t start, end;    /* in number of blocks, 'end' is exclusive */
1766 };
1767
1768 static inline uint16_t skl_ddb_entry_size(const struct skl_ddb_entry *entry)
1769 {
1770         return entry->end - entry->start;
1771 }
1772
1773 static inline bool skl_ddb_entry_equal(const struct skl_ddb_entry *e1,
1774                                        const struct skl_ddb_entry *e2)
1775 {
1776         if (e1->start == e2->start && e1->end == e2->end)
1777                 return true;
1778
1779         return false;
1780 }
1781
1782 struct skl_ddb_allocation {
1783         struct skl_ddb_entry plane[I915_MAX_PIPES][I915_MAX_PLANES]; /* packed/uv */
1784         struct skl_ddb_entry y_plane[I915_MAX_PIPES][I915_MAX_PLANES];
1785 };
1786
1787 struct skl_wm_values {
1788         unsigned dirty_pipes;
1789         struct skl_ddb_allocation ddb;
1790 };
1791
1792 struct skl_wm_level {
1793         bool plane_en;
1794         uint16_t plane_res_b;
1795         uint8_t plane_res_l;
1796 };
1797
1798 /*
1799  * This struct helps tracking the state needed for runtime PM, which puts the
1800  * device in PCI D3 state. Notice that when this happens, nothing on the
1801  * graphics device works, even register access, so we don't get interrupts nor
1802  * anything else.
1803  *
1804  * Every piece of our code that needs to actually touch the hardware needs to
1805  * either call intel_runtime_pm_get or call intel_display_power_get with the
1806  * appropriate power domain.
1807  *
1808  * Our driver uses the autosuspend delay feature, which means we'll only really
1809  * suspend if we stay with zero refcount for a certain amount of time. The
1810  * default value is currently very conservative (see intel_runtime_pm_enable), but
1811  * it can be changed with the standard runtime PM files from sysfs.
1812  *
1813  * The irqs_disabled variable becomes true exactly after we disable the IRQs and
1814  * goes back to false exactly before we reenable the IRQs. We use this variable
1815  * to check if someone is trying to enable/disable IRQs while they're supposed
1816  * to be disabled. This shouldn't happen and we'll print some error messages in
1817  * case it happens.
1818  *
1819  * For more, read the Documentation/power/runtime_pm.txt.
1820  */
1821 struct i915_runtime_pm {
1822         atomic_t wakeref_count;
1823         bool suspended;
1824         bool irqs_enabled;
1825 };
1826
1827 enum intel_pipe_crc_source {
1828         INTEL_PIPE_CRC_SOURCE_NONE,
1829         INTEL_PIPE_CRC_SOURCE_PLANE1,
1830         INTEL_PIPE_CRC_SOURCE_PLANE2,
1831         INTEL_PIPE_CRC_SOURCE_PF,
1832         INTEL_PIPE_CRC_SOURCE_PIPE,
1833         /* TV/DP on pre-gen5/vlv can't use the pipe source. */
1834         INTEL_PIPE_CRC_SOURCE_TV,
1835         INTEL_PIPE_CRC_SOURCE_DP_B,
1836         INTEL_PIPE_CRC_SOURCE_DP_C,
1837         INTEL_PIPE_CRC_SOURCE_DP_D,
1838         INTEL_PIPE_CRC_SOURCE_AUTO,
1839         INTEL_PIPE_CRC_SOURCE_MAX,
1840 };
1841
1842 struct intel_pipe_crc_entry {
1843         uint32_t frame;
1844         uint32_t crc[5];
1845 };
1846
1847 #define INTEL_PIPE_CRC_ENTRIES_NR       128
1848 struct intel_pipe_crc {
1849         spinlock_t lock;
1850         bool opened;            /* exclusive access to the result file */
1851         struct intel_pipe_crc_entry *entries;
1852         enum intel_pipe_crc_source source;
1853         int head, tail;
1854         wait_queue_head_t wq;
1855         int skipped;
1856 };
1857
1858 struct i915_frontbuffer_tracking {
1859         spinlock_t lock;
1860
1861         /*
1862          * Tracking bits for delayed frontbuffer flushing du to gpu activity or
1863          * scheduled flips.
1864          */
1865         unsigned busy_bits;
1866         unsigned flip_bits;
1867 };
1868
1869 struct i915_wa_reg {
1870         i915_reg_t addr;
1871         u32 value;
1872         /* bitmask representing WA bits */
1873         u32 mask;
1874 };
1875
1876 /*
1877  * RING_MAX_NONPRIV_SLOTS is per-engine but at this point we are only
1878  * allowing it for RCS as we don't foresee any requirement of having
1879  * a whitelist for other engines. When it is really required for
1880  * other engines then the limit need to be increased.
1881  */
1882 #define I915_MAX_WA_REGS (16 + RING_MAX_NONPRIV_SLOTS)
1883
1884 struct i915_workarounds {
1885         struct i915_wa_reg reg[I915_MAX_WA_REGS];
1886         u32 count;
1887         u32 hw_whitelist_count[I915_NUM_ENGINES];
1888 };
1889
1890 struct i915_virtual_gpu {
1891         bool active;
1892 };
1893
1894 /* used in computing the new watermarks state */
1895 struct intel_wm_config {
1896         unsigned int num_pipes_active;
1897         bool sprites_enabled;
1898         bool sprites_scaled;
1899 };
1900
1901 struct i915_oa_format {
1902         u32 format;
1903         int size;
1904 };
1905
1906 struct i915_oa_reg {
1907         i915_reg_t addr;
1908         u32 value;
1909 };
1910
1911 struct i915_perf_stream;
1912
1913 /**
1914  * struct i915_perf_stream_ops - the OPs to support a specific stream type
1915  */
1916 struct i915_perf_stream_ops {
1917         /**
1918          * @enable: Enables the collection of HW samples, either in response to
1919          * `I915_PERF_IOCTL_ENABLE` or implicitly called when stream is opened
1920          * without `I915_PERF_FLAG_DISABLED`.
1921          */
1922         void (*enable)(struct i915_perf_stream *stream);
1923
1924         /**
1925          * @disable: Disables the collection of HW samples, either in response
1926          * to `I915_PERF_IOCTL_DISABLE` or implicitly called before destroying
1927          * the stream.
1928          */
1929         void (*disable)(struct i915_perf_stream *stream);
1930
1931         /**
1932          * @poll_wait: Call poll_wait, passing a wait queue that will be woken
1933          * once there is something ready to read() for the stream
1934          */
1935         void (*poll_wait)(struct i915_perf_stream *stream,
1936                           struct file *file,
1937                           poll_table *wait);
1938
1939         /**
1940          * @wait_unlocked: For handling a blocking read, wait until there is
1941          * something to ready to read() for the stream. E.g. wait on the same
1942          * wait queue that would be passed to poll_wait().
1943          */
1944         int (*wait_unlocked)(struct i915_perf_stream *stream);
1945
1946         /**
1947          * @read: Copy buffered metrics as records to userspace
1948          * **buf**: the userspace, destination buffer
1949          * **count**: the number of bytes to copy, requested by userspace
1950          * **offset**: zero at the start of the read, updated as the read
1951          * proceeds, it represents how many bytes have been copied so far and
1952          * the buffer offset for copying the next record.
1953          *
1954          * Copy as many buffered i915 perf samples and records for this stream
1955          * to userspace as will fit in the given buffer.
1956          *
1957          * Only write complete records; returning -%ENOSPC if there isn't room
1958          * for a complete record.
1959          *
1960          * Return any error condition that results in a short read such as
1961          * -%ENOSPC or -%EFAULT, even though these may be squashed before
1962          * returning to userspace.
1963          */
1964         int (*read)(struct i915_perf_stream *stream,
1965                     char __user *buf,
1966                     size_t count,
1967                     size_t *offset);
1968
1969         /**
1970          * @destroy: Cleanup any stream specific resources.
1971          *
1972          * The stream will always be disabled before this is called.
1973          */
1974         void (*destroy)(struct i915_perf_stream *stream);
1975 };
1976
1977 /**
1978  * struct i915_perf_stream - state for a single open stream FD
1979  */
1980 struct i915_perf_stream {
1981         /**
1982          * @dev_priv: i915 drm device
1983          */
1984         struct drm_i915_private *dev_priv;
1985
1986         /**
1987          * @link: Links the stream into ``&drm_i915_private->streams``
1988          */
1989         struct list_head link;
1990
1991         /**
1992          * @sample_flags: Flags representing the `DRM_I915_PERF_PROP_SAMPLE_*`
1993          * properties given when opening a stream, representing the contents
1994          * of a single sample as read() by userspace.
1995          */
1996         u32 sample_flags;
1997
1998         /**
1999          * @sample_size: Considering the configured contents of a sample
2000          * combined with the required header size, this is the total size
2001          * of a single sample record.
2002          */
2003         int sample_size;
2004
2005         /**
2006          * @ctx: %NULL if measuring system-wide across all contexts or a
2007          * specific context that is being monitored.
2008          */
2009         struct i915_gem_context *ctx;
2010
2011         /**
2012          * @enabled: Whether the stream is currently enabled, considering
2013          * whether the stream was opened in a disabled state and based
2014          * on `I915_PERF_IOCTL_ENABLE` and `I915_PERF_IOCTL_DISABLE` calls.
2015          */
2016         bool enabled;
2017
2018         /**
2019          * @ops: The callbacks providing the implementation of this specific
2020          * type of configured stream.
2021          */
2022         const struct i915_perf_stream_ops *ops;
2023 };
2024
2025 /**
2026  * struct i915_oa_ops - Gen specific implementation of an OA unit stream
2027  */
2028 struct i915_oa_ops {
2029         /**
2030          * @init_oa_buffer: Resets the head and tail pointers of the
2031          * circular buffer for periodic OA reports.
2032          *
2033          * Called when first opening a stream for OA metrics, but also may be
2034          * called in response to an OA buffer overflow or other error
2035          * condition.
2036          *
2037          * Note it may be necessary to clear the full OA buffer here as part of
2038          * maintaining the invariable that new reports must be written to
2039          * zeroed memory for us to be able to reliable detect if an expected
2040          * report has not yet landed in memory.  (At least on Haswell the OA
2041          * buffer tail pointer is not synchronized with reports being visible
2042          * to the CPU)
2043          */
2044         void (*init_oa_buffer)(struct drm_i915_private *dev_priv);
2045
2046         /**
2047          * @enable_metric_set: Applies any MUX configuration to set up the
2048          * Boolean and Custom (B/C) counters that are part of the counter
2049          * reports being sampled. May apply system constraints such as
2050          * disabling EU clock gating as required.
2051          */
2052         int (*enable_metric_set)(struct drm_i915_private *dev_priv);
2053
2054         /**
2055          * @disable_metric_set: Remove system constraints associated with using
2056          * the OA unit.
2057          */
2058         void (*disable_metric_set)(struct drm_i915_private *dev_priv);
2059
2060         /**
2061          * @oa_enable: Enable periodic sampling
2062          */
2063         void (*oa_enable)(struct drm_i915_private *dev_priv);
2064
2065         /**
2066          * @oa_disable: Disable periodic sampling
2067          */
2068         void (*oa_disable)(struct drm_i915_private *dev_priv);
2069
2070         /**
2071          * @read: Copy data from the circular OA buffer into a given userspace
2072          * buffer.
2073          */
2074         int (*read)(struct i915_perf_stream *stream,
2075                     char __user *buf,
2076                     size_t count,
2077                     size_t *offset);
2078
2079         /**
2080          * @oa_buffer_is_empty: Check if OA buffer empty (false positives OK)
2081          *
2082          * This is either called via fops or the poll check hrtimer (atomic
2083          * ctx) without any locks taken.
2084          *
2085          * It's safe to read OA config state here unlocked, assuming that this
2086          * is only called while the stream is enabled, while the global OA
2087          * configuration can't be modified.
2088          *
2089          * Efficiency is more important than avoiding some false positives
2090          * here, which will be handled gracefully - likely resulting in an
2091          * %EAGAIN error for userspace.
2092          */
2093         bool (*oa_buffer_is_empty)(struct drm_i915_private *dev_priv);
2094 };
2095
2096 struct intel_cdclk_state {
2097         unsigned int cdclk, vco, ref;
2098 };
2099
2100 struct drm_i915_private {
2101         struct drm_device drm;
2102
2103         struct kmem_cache *objects;
2104         struct kmem_cache *vmas;
2105         struct kmem_cache *requests;
2106         struct kmem_cache *dependencies;
2107
2108         const struct intel_device_info info;
2109
2110         void __iomem *regs;
2111
2112         struct intel_uncore uncore;
2113
2114         struct i915_virtual_gpu vgpu;
2115
2116         struct intel_gvt *gvt;
2117
2118         struct intel_huc huc;
2119         struct intel_guc guc;
2120
2121         struct intel_csr csr;
2122
2123         struct intel_gmbus gmbus[GMBUS_NUM_PINS];
2124
2125         /** gmbus_mutex protects against concurrent usage of the single hw gmbus
2126          * controller on different i2c buses. */
2127         struct mutex gmbus_mutex;
2128
2129         /**
2130          * Base address of the gmbus and gpio block.
2131          */
2132         uint32_t gpio_mmio_base;
2133
2134         /* MMIO base address for MIPI regs */
2135         uint32_t mipi_mmio_base;
2136
2137         uint32_t psr_mmio_base;
2138
2139         uint32_t pps_mmio_base;
2140
2141         wait_queue_head_t gmbus_wait_queue;
2142
2143         struct pci_dev *bridge_dev;
2144         struct i915_gem_context *kernel_context;
2145         struct intel_engine_cs *engine[I915_NUM_ENGINES];
2146         struct i915_vma *semaphore;
2147
2148         struct drm_dma_handle *status_page_dmah;
2149         struct resource mch_res;
2150
2151         /* protects the irq masks */
2152         spinlock_t irq_lock;
2153
2154         /* protects the mmio flip data */
2155         spinlock_t mmio_flip_lock;
2156
2157         bool display_irqs_enabled;
2158
2159         /* To control wakeup latency, e.g. for irq-driven dp aux transfers. */
2160         struct pm_qos_request pm_qos;
2161
2162         /* Sideband mailbox protection */
2163         struct mutex sb_lock;
2164
2165         /** Cached value of IMR to avoid reads in updating the bitfield */
2166         union {
2167                 u32 irq_mask;
2168                 u32 de_irq_mask[I915_MAX_PIPES];
2169         };
2170         u32 gt_irq_mask;
2171         u32 pm_imr;
2172         u32 pm_ier;
2173         u32 pm_rps_events;
2174         u32 pm_guc_events;
2175         u32 pipestat_irq_mask[I915_MAX_PIPES];
2176
2177         struct i915_hotplug hotplug;
2178         struct intel_fbc fbc;
2179         struct i915_drrs drrs;
2180         struct intel_opregion opregion;
2181         struct intel_vbt_data vbt;
2182
2183         bool preserve_bios_swizzle;
2184
2185         /* overlay */
2186         struct intel_overlay *overlay;
2187
2188         /* backlight registers and fields in struct intel_panel */
2189         struct mutex backlight_lock;
2190
2191         /* LVDS info */
2192         bool no_aux_handshake;
2193
2194         /* protects panel power sequencer state */
2195         struct mutex pps_mutex;
2196
2197         struct drm_i915_fence_reg fence_regs[I915_MAX_NUM_FENCES]; /* assume 965 */
2198         int num_fence_regs; /* 8 on pre-965, 16 otherwise */
2199
2200         unsigned int fsb_freq, mem_freq, is_ddr3;
2201         unsigned int skl_preferred_vco_freq;
2202         unsigned int max_cdclk_freq;
2203
2204         unsigned int max_dotclk_freq;
2205         unsigned int rawclk_freq;
2206         unsigned int hpll_freq;
2207         unsigned int czclk_freq;
2208
2209         struct {
2210                 /*
2211                  * The current logical cdclk state.
2212                  * See intel_atomic_state.cdclk.logical
2213                  *
2214                  * For reading holding any crtc lock is sufficient,
2215                  * for writing must hold all of them.
2216                  */
2217                 struct intel_cdclk_state logical;
2218                 /*
2219                  * The current actual cdclk state.
2220                  * See intel_atomic_state.cdclk.actual
2221                  */
2222                 struct intel_cdclk_state actual;
2223                 /* The current hardware cdclk state */
2224                 struct intel_cdclk_state hw;
2225         } cdclk;
2226
2227         /**
2228          * wq - Driver workqueue for GEM.
2229          *
2230          * NOTE: Work items scheduled here are not allowed to grab any modeset
2231          * locks, for otherwise the flushing done in the pageflip code will
2232          * result in deadlocks.
2233          */
2234         struct workqueue_struct *wq;
2235
2236         /* Display functions */
2237         struct drm_i915_display_funcs display;
2238
2239         /* PCH chipset type */
2240         enum intel_pch pch_type;
2241         unsigned short pch_id;
2242
2243         unsigned long quirks;
2244
2245         enum modeset_restore modeset_restore;
2246         struct mutex modeset_restore_lock;
2247         struct drm_atomic_state *modeset_restore_state;
2248         struct drm_modeset_acquire_ctx reset_ctx;
2249
2250         struct list_head vm_list; /* Global list of all address spaces */
2251         struct i915_ggtt ggtt; /* VM representing the global address space */
2252
2253         struct i915_gem_mm mm;
2254         DECLARE_HASHTABLE(mm_structs, 7);
2255         struct mutex mm_lock;
2256
2257         /* The hw wants to have a stable context identifier for the lifetime
2258          * of the context (for OA, PASID, faults, etc). This is limited
2259          * in execlists to 21 bits.
2260          */
2261         struct ida context_hw_ida;
2262 #define MAX_CONTEXT_HW_ID (1<<21) /* exclusive */
2263
2264         /* Kernel Modesetting */
2265
2266         struct intel_crtc *plane_to_crtc_mapping[I915_MAX_PIPES];
2267         struct intel_crtc *pipe_to_crtc_mapping[I915_MAX_PIPES];
2268         wait_queue_head_t pending_flip_queue;
2269
2270 #ifdef CONFIG_DEBUG_FS
2271         struct intel_pipe_crc pipe_crc[I915_MAX_PIPES];
2272 #endif
2273
2274         /* dpll and cdclk state is protected by connection_mutex */
2275         int num_shared_dpll;
2276         struct intel_shared_dpll shared_dplls[I915_NUM_PLLS];
2277         const struct intel_dpll_mgr *dpll_mgr;
2278
2279         /*
2280          * dpll_lock serializes intel_{prepare,enable,disable}_shared_dpll.
2281          * Must be global rather than per dpll, because on some platforms
2282          * plls share registers.
2283          */
2284         struct mutex dpll_lock;
2285
2286         unsigned int active_crtcs;
2287         unsigned int min_pixclk[I915_MAX_PIPES];
2288
2289         int dpio_phy_iosf_port[I915_NUM_PHYS_VLV];
2290
2291         struct i915_workarounds workarounds;
2292
2293         struct i915_frontbuffer_tracking fb_tracking;
2294
2295         struct intel_atomic_helper {
2296                 struct llist_head free_list;
2297                 struct work_struct free_work;
2298         } atomic_helper;
2299
2300         u16 orig_clock;
2301
2302         bool mchbar_need_disable;
2303
2304         struct intel_l3_parity l3_parity;
2305
2306         /* Cannot be determined by PCIID. You must always read a register. */
2307         u32 edram_cap;
2308
2309         /* gen6+ rps state */
2310         struct intel_gen6_power_mgmt rps;
2311
2312         /* ilk-only ips/rps state. Everything in here is protected by the global
2313          * mchdev_lock in intel_pm.c */
2314         struct intel_ilk_power_mgmt ips;
2315
2316         struct i915_power_domains power_domains;
2317
2318         struct i915_psr psr;
2319
2320         struct i915_gpu_error gpu_error;
2321
2322         struct drm_i915_gem_object *vlv_pctx;
2323
2324 #ifdef CONFIG_DRM_FBDEV_EMULATION
2325         /* list of fbdev register on this device */
2326         struct intel_fbdev *fbdev;
2327         struct work_struct fbdev_suspend_work;
2328 #endif
2329
2330         struct drm_property *broadcast_rgb_property;
2331         struct drm_property *force_audio_property;
2332
2333         /* hda/i915 audio component */
2334         struct i915_audio_component *audio_component;
2335         bool audio_component_registered;
2336         /**
2337          * av_mutex - mutex for audio/video sync
2338          *
2339          */
2340         struct mutex av_mutex;
2341
2342         uint32_t hw_context_size;
2343         struct list_head context_list;
2344
2345         u32 fdi_rx_config;
2346
2347         /* Shadow for DISPLAY_PHY_CONTROL which can't be safely read */
2348         u32 chv_phy_control;
2349         /*
2350          * Shadows for CHV DPLL_MD regs to keep the state
2351          * checker somewhat working in the presence hardware
2352          * crappiness (can't read out DPLL_MD for pipes B & C).
2353          */
2354         u32 chv_dpll_md[I915_MAX_PIPES];
2355         u32 bxt_phy_grc;
2356
2357         u32 suspend_count;
2358         bool suspended_to_idle;
2359         struct i915_suspend_saved_registers regfile;
2360         struct vlv_s0ix_state vlv_s0ix_state;
2361
2362         enum {
2363                 I915_SAGV_UNKNOWN = 0,
2364                 I915_SAGV_DISABLED,
2365                 I915_SAGV_ENABLED,
2366                 I915_SAGV_NOT_CONTROLLED
2367         } sagv_status;
2368
2369         struct {
2370                 /* protects DSPARB registers on pre-g4x/vlv/chv */
2371                 spinlock_t dsparb_lock;
2372
2373                 /*
2374                  * Raw watermark latency values:
2375                  * in 0.1us units for WM0,
2376                  * in 0.5us units for WM1+.
2377                  */
2378                 /* primary */
2379                 uint16_t pri_latency[5];
2380                 /* sprite */
2381                 uint16_t spr_latency[5];
2382                 /* cursor */
2383                 uint16_t cur_latency[5];
2384                 /*
2385                  * Raw watermark memory latency values
2386                  * for SKL for all 8 levels
2387                  * in 1us units.
2388                  */
2389                 uint16_t skl_latency[8];
2390
2391                 /* current hardware state */
2392                 union {
2393                         struct ilk_wm_values hw;
2394                         struct skl_wm_values skl_hw;
2395                         struct vlv_wm_values vlv;
2396                 };
2397
2398                 uint8_t max_level;
2399
2400                 /*
2401                  * Should be held around atomic WM register writing; also
2402                  * protects * intel_crtc->wm.active and
2403                  * cstate->wm.need_postvbl_update.
2404                  */
2405                 struct mutex wm_mutex;
2406
2407                 /*
2408                  * Set during HW readout of watermarks/DDB.  Some platforms
2409                  * need to know when we're still using BIOS-provided values
2410                  * (which we don't fully trust).
2411                  */
2412                 bool distrust_bios_wm;
2413         } wm;
2414
2415         struct i915_runtime_pm pm;
2416
2417         struct {
2418                 bool initialized;
2419
2420                 struct kobject *metrics_kobj;
2421                 struct ctl_table_header *sysctl_header;
2422
2423                 struct mutex lock;
2424                 struct list_head streams;
2425
2426                 spinlock_t hook_lock;
2427
2428                 struct {
2429                         struct i915_perf_stream *exclusive_stream;
2430
2431                         u32 specific_ctx_id;
2432
2433                         struct hrtimer poll_check_timer;
2434                         wait_queue_head_t poll_wq;
2435                         bool pollin;
2436
2437                         bool periodic;
2438                         int period_exponent;
2439                         int timestamp_frequency;
2440
2441                         int tail_margin;
2442
2443                         int metrics_set;
2444
2445                         const struct i915_oa_reg *mux_regs;
2446                         int mux_regs_len;
2447                         const struct i915_oa_reg *b_counter_regs;
2448                         int b_counter_regs_len;
2449
2450                         struct {
2451                                 struct i915_vma *vma;
2452                                 u8 *vaddr;
2453                                 int format;
2454                                 int format_size;
2455                         } oa_buffer;
2456
2457                         u32 gen7_latched_oastatus1;
2458
2459                         struct i915_oa_ops ops;
2460                         const struct i915_oa_format *oa_formats;
2461                         int n_builtin_sets;
2462                 } oa;
2463         } perf;
2464
2465         /* Abstract the submission mechanism (legacy ringbuffer or execlists) away */
2466         struct {
2467                 void (*resume)(struct drm_i915_private *);
2468                 void (*cleanup_engine)(struct intel_engine_cs *engine);
2469
2470                 struct list_head timelines;
2471                 struct i915_gem_timeline global_timeline;
2472                 u32 active_requests;
2473
2474                 /**
2475                  * Is the GPU currently considered idle, or busy executing
2476                  * userspace requests? Whilst idle, we allow runtime power
2477                  * management to power down the hardware and display clocks.
2478                  * In order to reduce the effect on performance, there
2479                  * is a slight delay before we do so.
2480                  */
2481                 bool awake;
2482
2483                 /**
2484                  * We leave the user IRQ off as much as possible,
2485                  * but this means that requests will finish and never
2486                  * be retired once the system goes idle. Set a timer to
2487                  * fire periodically while the ring is running. When it
2488                  * fires, go retire requests.
2489                  */
2490                 struct delayed_work retire_work;
2491
2492                 /**
2493                  * When we detect an idle GPU, we want to turn on
2494                  * powersaving features. So once we see that there
2495                  * are no more requests outstanding and no more
2496                  * arrive within a small period of time, we fire
2497                  * off the idle_work.
2498                  */
2499                 struct delayed_work idle_work;
2500
2501                 ktime_t last_init_time;
2502         } gt;
2503
2504         /* perform PHY state sanity checks? */
2505         bool chv_phy_assert[2];
2506
2507         bool ipc_enabled;
2508
2509         /* Used to save the pipe-to-encoder mapping for audio */
2510         struct intel_encoder *av_enc_map[I915_MAX_PIPES];
2511
2512         /*
2513          * NOTE: This is the dri1/ums dungeon, don't add stuff here. Your patch
2514          * will be rejected. Instead look for a better place.
2515          */
2516 };
2517
2518 static inline struct drm_i915_private *to_i915(const struct drm_device *dev)
2519 {
2520         return container_of(dev, struct drm_i915_private, drm);
2521 }
2522
2523 static inline struct drm_i915_private *kdev_to_i915(struct device *kdev)
2524 {
2525         return to_i915(dev_get_drvdata(kdev));
2526 }
2527
2528 static inline struct drm_i915_private *guc_to_i915(struct intel_guc *guc)
2529 {
2530         return container_of(guc, struct drm_i915_private, guc);
2531 }
2532
2533 /* Simple iterator over all initialised engines */
2534 #define for_each_engine(engine__, dev_priv__, id__) \
2535         for ((id__) = 0; \
2536              (id__) < I915_NUM_ENGINES; \
2537              (id__)++) \
2538                 for_each_if ((engine__) = (dev_priv__)->engine[(id__)])
2539
2540 #define __mask_next_bit(mask) ({                                        \
2541         int __idx = ffs(mask) - 1;                                      \
2542         mask &= ~BIT(__idx);                                            \
2543         __idx;                                                          \
2544 })
2545
2546 /* Iterator over subset of engines selected by mask */
2547 #define for_each_engine_masked(engine__, dev_priv__, mask__, tmp__) \
2548         for (tmp__ = mask__ & INTEL_INFO(dev_priv__)->ring_mask;        \
2549              tmp__ ? (engine__ = (dev_priv__)->engine[__mask_next_bit(tmp__)]), 1 : 0; )
2550
2551 enum hdmi_force_audio {
2552         HDMI_AUDIO_OFF_DVI = -2,        /* no aux data for HDMI-DVI converter */
2553         HDMI_AUDIO_OFF,                 /* force turn off HDMI audio */
2554         HDMI_AUDIO_AUTO,                /* trust EDID */
2555         HDMI_AUDIO_ON,                  /* force turn on HDMI audio */
2556 };
2557
2558 #define I915_GTT_OFFSET_NONE ((u32)-1)
2559
2560 /*
2561  * Frontbuffer tracking bits. Set in obj->frontbuffer_bits while a gem bo is
2562  * considered to be the frontbuffer for the given plane interface-wise. This
2563  * doesn't mean that the hw necessarily already scans it out, but that any
2564  * rendering (by the cpu or gpu) will land in the frontbuffer eventually.
2565  *
2566  * We have one bit per pipe and per scanout plane type.
2567  */
2568 #define INTEL_MAX_SPRITE_BITS_PER_PIPE 5
2569 #define INTEL_FRONTBUFFER_BITS_PER_PIPE 8
2570 #define INTEL_FRONTBUFFER_PRIMARY(pipe) \
2571         (1 << (INTEL_FRONTBUFFER_BITS_PER_PIPE * (pipe)))
2572 #define INTEL_FRONTBUFFER_CURSOR(pipe) \
2573         (1 << (1 + (INTEL_FRONTBUFFER_BITS_PER_PIPE * (pipe))))
2574 #define INTEL_FRONTBUFFER_SPRITE(pipe, plane) \
2575         (1 << (2 + plane + (INTEL_FRONTBUFFER_BITS_PER_PIPE * (pipe))))
2576 #define INTEL_FRONTBUFFER_OVERLAY(pipe) \
2577         (1 << (2 + INTEL_MAX_SPRITE_BITS_PER_PIPE + (INTEL_FRONTBUFFER_BITS_PER_PIPE * (pipe))))
2578 #define INTEL_FRONTBUFFER_ALL_MASK(pipe) \
2579         (0xff << (INTEL_FRONTBUFFER_BITS_PER_PIPE * (pipe)))
2580
2581 /*
2582  * Optimised SGL iterator for GEM objects
2583  */
2584 static __always_inline struct sgt_iter {
2585         struct scatterlist *sgp;
2586         union {
2587                 unsigned long pfn;
2588                 dma_addr_t dma;
2589         };
2590         unsigned int curr;
2591         unsigned int max;
2592 } __sgt_iter(struct scatterlist *sgl, bool dma) {
2593         struct sgt_iter s = { .sgp = sgl };
2594
2595         if (s.sgp) {
2596                 s.max = s.curr = s.sgp->offset;
2597                 s.max += s.sgp->length;
2598                 if (dma)
2599                         s.dma = sg_dma_address(s.sgp);
2600                 else
2601                         s.pfn = page_to_pfn(sg_page(s.sgp));
2602         }
2603
2604         return s;
2605 }
2606
2607 static inline struct scatterlist *____sg_next(struct scatterlist *sg)
2608 {
2609         ++sg;
2610         if (unlikely(sg_is_chain(sg)))
2611                 sg = sg_chain_ptr(sg);
2612         return sg;
2613 }
2614
2615 /**
2616  * __sg_next - return the next scatterlist entry in a list
2617  * @sg:         The current sg entry
2618  *
2619  * Description:
2620  *   If the entry is the last, return NULL; otherwise, step to the next
2621  *   element in the array (@sg@+1). If that's a chain pointer, follow it;
2622  *   otherwise just return the pointer to the current element.
2623  **/
2624 static inline struct scatterlist *__sg_next(struct scatterlist *sg)
2625 {
2626 #ifdef CONFIG_DEBUG_SG
2627         BUG_ON(sg->sg_magic != SG_MAGIC);
2628 #endif
2629         return sg_is_last(sg) ? NULL : ____sg_next(sg);
2630 }
2631
2632 /**
2633  * for_each_sgt_dma - iterate over the DMA addresses of the given sg_table
2634  * @__dmap:     DMA address (output)
2635  * @__iter:     'struct sgt_iter' (iterator state, internal)
2636  * @__sgt:      sg_table to iterate over (input)
2637  */
2638 #define for_each_sgt_dma(__dmap, __iter, __sgt)                         \
2639         for ((__iter) = __sgt_iter((__sgt)->sgl, true);                 \
2640              ((__dmap) = (__iter).dma + (__iter).curr);                 \
2641              (((__iter).curr += PAGE_SIZE) < (__iter).max) ||           \
2642              ((__iter) = __sgt_iter(__sg_next((__iter).sgp), true), 0))
2643
2644 /**
2645  * for_each_sgt_page - iterate over the pages of the given sg_table
2646  * @__pp:       page pointer (output)
2647  * @__iter:     'struct sgt_iter' (iterator state, internal)
2648  * @__sgt:      sg_table to iterate over (input)
2649  */
2650 #define for_each_sgt_page(__pp, __iter, __sgt)                          \
2651         for ((__iter) = __sgt_iter((__sgt)->sgl, false);                \
2652              ((__pp) = (__iter).pfn == 0 ? NULL :                       \
2653               pfn_to_page((__iter).pfn + ((__iter).curr >> PAGE_SHIFT))); \
2654              (((__iter).curr += PAGE_SIZE) < (__iter).max) ||           \
2655              ((__iter) = __sgt_iter(__sg_next((__iter).sgp), false), 0))
2656
2657 static inline const struct intel_device_info *
2658 intel_info(const struct drm_i915_private *dev_priv)
2659 {
2660         return &dev_priv->info;
2661 }
2662
2663 #define INTEL_INFO(dev_priv)    intel_info((dev_priv))
2664
2665 #define INTEL_GEN(dev_priv)     ((dev_priv)->info.gen)
2666 #define INTEL_DEVID(dev_priv)   ((dev_priv)->info.device_id)
2667
2668 #define REVID_FOREVER           0xff
2669 #define INTEL_REVID(dev_priv)   ((dev_priv)->drm.pdev->revision)
2670
2671 #define GEN_FOREVER (0)
2672 /*
2673  * Returns true if Gen is in inclusive range [Start, End].
2674  *
2675  * Use GEN_FOREVER for unbound start and or end.
2676  */
2677 #define IS_GEN(dev_priv, s, e) ({ \
2678         unsigned int __s = (s), __e = (e); \
2679         BUILD_BUG_ON(!__builtin_constant_p(s)); \
2680         BUILD_BUG_ON(!__builtin_constant_p(e)); \
2681         if ((__s) != GEN_FOREVER) \
2682                 __s = (s) - 1; \
2683         if ((__e) == GEN_FOREVER) \
2684                 __e = BITS_PER_LONG - 1; \
2685         else \
2686                 __e = (e) - 1; \
2687         !!((dev_priv)->info.gen_mask & GENMASK((__e), (__s))); \
2688 })
2689
2690 /*
2691  * Return true if revision is in range [since,until] inclusive.
2692  *
2693  * Use 0 for open-ended since, and REVID_FOREVER for open-ended until.
2694  */
2695 #define IS_REVID(p, since, until) \
2696         (INTEL_REVID(p) >= (since) && INTEL_REVID(p) <= (until))
2697
2698 #define IS_I830(dev_priv)       ((dev_priv)->info.platform == INTEL_I830)
2699 #define IS_I845G(dev_priv)      ((dev_priv)->info.platform == INTEL_I845G)
2700 #define IS_I85X(dev_priv)       ((dev_priv)->info.platform == INTEL_I85X)
2701 #define IS_I865G(dev_priv)      ((dev_priv)->info.platform == INTEL_I865G)
2702 #define IS_I915G(dev_priv)      ((dev_priv)->info.platform == INTEL_I915G)
2703 #define IS_I915GM(dev_priv)     ((dev_priv)->info.platform == INTEL_I915GM)
2704 #define IS_I945G(dev_priv)      ((dev_priv)->info.platform == INTEL_I945G)
2705 #define IS_I945GM(dev_priv)     ((dev_priv)->info.platform == INTEL_I945GM)
2706 #define IS_I965G(dev_priv)      ((dev_priv)->info.platform == INTEL_I965G)
2707 #define IS_I965GM(dev_priv)     ((dev_priv)->info.platform == INTEL_I965GM)
2708 #define IS_G45(dev_priv)        ((dev_priv)->info.platform == INTEL_G45)
2709 #define IS_GM45(dev_priv)       ((dev_priv)->info.platform == INTEL_GM45)
2710 #define IS_G4X(dev_priv)        (IS_G45(dev_priv) || IS_GM45(dev_priv))
2711 #define IS_PINEVIEW_G(dev_priv) (INTEL_DEVID(dev_priv) == 0xa001)
2712 #define IS_PINEVIEW_M(dev_priv) (INTEL_DEVID(dev_priv) == 0xa011)
2713 #define IS_PINEVIEW(dev_priv)   ((dev_priv)->info.platform == INTEL_PINEVIEW)
2714 #define IS_G33(dev_priv)        ((dev_priv)->info.platform == INTEL_G33)
2715 #define IS_IRONLAKE_M(dev_priv) (INTEL_DEVID(dev_priv) == 0x0046)
2716 #define IS_IVYBRIDGE(dev_priv)  ((dev_priv)->info.platform == INTEL_IVYBRIDGE)
2717 #define IS_IVB_GT1(dev_priv)    (INTEL_DEVID(dev_priv) == 0x0156 || \
2718                                  INTEL_DEVID(dev_priv) == 0x0152 || \
2719                                  INTEL_DEVID(dev_priv) == 0x015a)
2720 #define IS_VALLEYVIEW(dev_priv) ((dev_priv)->info.platform == INTEL_VALLEYVIEW)
2721 #define IS_CHERRYVIEW(dev_priv) ((dev_priv)->info.platform == INTEL_CHERRYVIEW)
2722 #define IS_HASWELL(dev_priv)    ((dev_priv)->info.platform == INTEL_HASWELL)
2723 #define IS_BROADWELL(dev_priv)  ((dev_priv)->info.platform == INTEL_BROADWELL)
2724 #define IS_SKYLAKE(dev_priv)    ((dev_priv)->info.platform == INTEL_SKYLAKE)
2725 #define IS_BROXTON(dev_priv)    ((dev_priv)->info.platform == INTEL_BROXTON)
2726 #define IS_KABYLAKE(dev_priv)   ((dev_priv)->info.platform == INTEL_KABYLAKE)
2727 #define IS_GEMINILAKE(dev_priv) ((dev_priv)->info.platform == INTEL_GEMINILAKE)
2728 #define IS_MOBILE(dev_priv)     ((dev_priv)->info.is_mobile)
2729 #define IS_HSW_EARLY_SDV(dev_priv) (IS_HASWELL(dev_priv) && \
2730                                     (INTEL_DEVID(dev_priv) & 0xFF00) == 0x0C00)
2731 #define IS_BDW_ULT(dev_priv)    (IS_BROADWELL(dev_priv) && \
2732                                  ((INTEL_DEVID(dev_priv) & 0xf) == 0x6 ||       \
2733                                  (INTEL_DEVID(dev_priv) & 0xf) == 0xb ||        \
2734                                  (INTEL_DEVID(dev_priv) & 0xf) == 0xe))
2735 /* ULX machines are also considered ULT. */
2736 #define IS_BDW_ULX(dev_priv)    (IS_BROADWELL(dev_priv) && \
2737                                  (INTEL_DEVID(dev_priv) & 0xf) == 0xe)
2738 #define IS_BDW_GT3(dev_priv)    (IS_BROADWELL(dev_priv) && \
2739                                  (INTEL_DEVID(dev_priv) & 0x00F0) == 0x0020)
2740 #define IS_HSW_ULT(dev_priv)    (IS_HASWELL(dev_priv) && \
2741                                  (INTEL_DEVID(dev_priv) & 0xFF00) == 0x0A00)
2742 #define IS_HSW_GT3(dev_priv)    (IS_HASWELL(dev_priv) && \
2743                                  (INTEL_DEVID(dev_priv) & 0x00F0) == 0x0020)
2744 /* ULX machines are also considered ULT. */
2745 #define IS_HSW_ULX(dev_priv)    (INTEL_DEVID(dev_priv) == 0x0A0E || \
2746                                  INTEL_DEVID(dev_priv) == 0x0A1E)
2747 #define IS_SKL_ULT(dev_priv)    (INTEL_DEVID(dev_priv) == 0x1906 || \
2748                                  INTEL_DEVID(dev_priv) == 0x1913 || \
2749                                  INTEL_DEVID(dev_priv) == 0x1916 || \
2750                                  INTEL_DEVID(dev_priv) == 0x1921 || \
2751                                  INTEL_DEVID(dev_priv) == 0x1926)
2752 #define IS_SKL_ULX(dev_priv)    (INTEL_DEVID(dev_priv) == 0x190E || \
2753                                  INTEL_DEVID(dev_priv) == 0x1915 || \
2754                                  INTEL_DEVID(dev_priv) == 0x191E)
2755 #define IS_KBL_ULT(dev_priv)    (INTEL_DEVID(dev_priv) == 0x5906 || \
2756                                  INTEL_DEVID(dev_priv) == 0x5913 || \
2757                                  INTEL_DEVID(dev_priv) == 0x5916 || \
2758                                  INTEL_DEVID(dev_priv) == 0x5921 || \
2759                                  INTEL_DEVID(dev_priv) == 0x5926)
2760 #define IS_KBL_ULX(dev_priv)    (INTEL_DEVID(dev_priv) == 0x590E || \
2761                                  INTEL_DEVID(dev_priv) == 0x5915 || \
2762                                  INTEL_DEVID(dev_priv) == 0x591E)
2763 #define IS_SKL_GT3(dev_priv)    (IS_SKYLAKE(dev_priv) && \
2764                                  (INTEL_DEVID(dev_priv) & 0x00F0) == 0x0020)
2765 #define IS_SKL_GT4(dev_priv)    (IS_SKYLAKE(dev_priv) && \
2766                                  (INTEL_DEVID(dev_priv) & 0x00F0) == 0x0030)
2767
2768 #define IS_ALPHA_SUPPORT(intel_info) ((intel_info)->is_alpha_support)
2769
2770 #define SKL_REVID_A0            0x0
2771 #define SKL_REVID_B0            0x1
2772 #define SKL_REVID_C0            0x2
2773 #define SKL_REVID_D0            0x3
2774 #define SKL_REVID_E0            0x4
2775 #define SKL_REVID_F0            0x5
2776 #define SKL_REVID_G0            0x6
2777 #define SKL_REVID_H0            0x7
2778
2779 #define IS_SKL_REVID(p, since, until) (IS_SKYLAKE(p) && IS_REVID(p, since, until))
2780
2781 #define BXT_REVID_A0            0x0
2782 #define BXT_REVID_A1            0x1
2783 #define BXT_REVID_B0            0x3
2784 #define BXT_REVID_B_LAST        0x8
2785 #define BXT_REVID_C0            0x9
2786
2787 #define IS_BXT_REVID(dev_priv, since, until) \
2788         (IS_BROXTON(dev_priv) && IS_REVID(dev_priv, since, until))
2789
2790 #define KBL_REVID_A0            0x0
2791 #define KBL_REVID_B0            0x1
2792 #define KBL_REVID_C0            0x2
2793 #define KBL_REVID_D0            0x3
2794 #define KBL_REVID_E0            0x4
2795
2796 #define IS_KBL_REVID(dev_priv, since, until) \
2797         (IS_KABYLAKE(dev_priv) && IS_REVID(dev_priv, since, until))
2798
2799 #define GLK_REVID_A0            0x0
2800 #define GLK_REVID_A1            0x1
2801
2802 #define IS_GLK_REVID(dev_priv, since, until) \
2803         (IS_GEMINILAKE(dev_priv) && IS_REVID(dev_priv, since, until))
2804
2805 /*
2806  * The genX designation typically refers to the render engine, so render
2807  * capability related checks should use IS_GEN, while display and other checks
2808  * have their own (e.g. HAS_PCH_SPLIT for ILK+ display, IS_foo for particular
2809  * chips, etc.).
2810  */
2811 #define IS_GEN2(dev_priv)       (!!((dev_priv)->info.gen_mask & BIT(1)))
2812 #define IS_GEN3(dev_priv)       (!!((dev_priv)->info.gen_mask & BIT(2)))
2813 #define IS_GEN4(dev_priv)       (!!((dev_priv)->info.gen_mask & BIT(3)))
2814 #define IS_GEN5(dev_priv)       (!!((dev_priv)->info.gen_mask & BIT(4)))
2815 #define IS_GEN6(dev_priv)       (!!((dev_priv)->info.gen_mask & BIT(5)))
2816 #define IS_GEN7(dev_priv)       (!!((dev_priv)->info.gen_mask & BIT(6)))
2817 #define IS_GEN8(dev_priv)       (!!((dev_priv)->info.gen_mask & BIT(7)))
2818 #define IS_GEN9(dev_priv)       (!!((dev_priv)->info.gen_mask & BIT(8)))
2819
2820 #define IS_LP(dev_priv) (INTEL_INFO(dev_priv)->is_lp)
2821 #define IS_GEN9_LP(dev_priv)    (IS_GEN9(dev_priv) && IS_LP(dev_priv))
2822 #define IS_GEN9_BC(dev_priv)    (IS_GEN9(dev_priv) && !IS_LP(dev_priv))
2823
2824 #define ENGINE_MASK(id) BIT(id)
2825 #define RENDER_RING     ENGINE_MASK(RCS)
2826 #define BSD_RING        ENGINE_MASK(VCS)
2827 #define BLT_RING        ENGINE_MASK(BCS)
2828 #define VEBOX_RING      ENGINE_MASK(VECS)
2829 #define BSD2_RING       ENGINE_MASK(VCS2)
2830 #define ALL_ENGINES     (~0)
2831
2832 #define HAS_ENGINE(dev_priv, id) \
2833         (!!((dev_priv)->info.ring_mask & ENGINE_MASK(id)))
2834
2835 #define HAS_BSD(dev_priv)       HAS_ENGINE(dev_priv, VCS)
2836 #define HAS_BSD2(dev_priv)      HAS_ENGINE(dev_priv, VCS2)
2837 #define HAS_BLT(dev_priv)       HAS_ENGINE(dev_priv, BCS)
2838 #define HAS_VEBOX(dev_priv)     HAS_ENGINE(dev_priv, VECS)
2839
2840 #define HAS_LLC(dev_priv)       ((dev_priv)->info.has_llc)
2841 #define HAS_SNOOP(dev_priv)     ((dev_priv)->info.has_snoop)
2842 #define HAS_EDRAM(dev_priv)     (!!((dev_priv)->edram_cap & EDRAM_ENABLED))
2843 #define HAS_WT(dev_priv)        ((IS_HASWELL(dev_priv) || \
2844                                  IS_BROADWELL(dev_priv)) && HAS_EDRAM(dev_priv))
2845
2846 #define HWS_NEEDS_PHYSICAL(dev_priv)    ((dev_priv)->info.hws_needs_physical)
2847
2848 #define HAS_HW_CONTEXTS(dev_priv)           ((dev_priv)->info.has_hw_contexts)
2849 #define HAS_LOGICAL_RING_CONTEXTS(dev_priv) \
2850                 ((dev_priv)->info.has_logical_ring_contexts)
2851 #define USES_PPGTT(dev_priv)            (i915.enable_ppgtt)
2852 #define USES_FULL_PPGTT(dev_priv)       (i915.enable_ppgtt >= 2)
2853 #define USES_FULL_48BIT_PPGTT(dev_priv) (i915.enable_ppgtt == 3)
2854
2855 #define HAS_OVERLAY(dev_priv)            ((dev_priv)->info.has_overlay)
2856 #define OVERLAY_NEEDS_PHYSICAL(dev_priv) \
2857                 ((dev_priv)->info.overlay_needs_physical)
2858
2859 /* Early gen2 have a totally busted CS tlb and require pinned batches. */
2860 #define HAS_BROKEN_CS_TLB(dev_priv)     (IS_I830(dev_priv) || IS_I845G(dev_priv))
2861
2862 /* WaRsDisableCoarsePowerGating:skl,bxt */
2863 #define NEEDS_WaRsDisableCoarsePowerGating(dev_priv) \
2864         (IS_SKL_GT3(dev_priv) || IS_SKL_GT4(dev_priv))
2865
2866 /*
2867  * dp aux and gmbus irq on gen4 seems to be able to generate legacy interrupts
2868  * even when in MSI mode. This results in spurious interrupt warnings if the
2869  * legacy irq no. is shared with another device. The kernel then disables that
2870  * interrupt source and so prevents the other device from working properly.
2871  */
2872 #define HAS_AUX_IRQ(dev_priv)   ((dev_priv)->info.gen >= 5)
2873 #define HAS_GMBUS_IRQ(dev_priv) ((dev_priv)->info.has_gmbus_irq)
2874
2875 /* With the 945 and later, Y tiling got adjusted so that it was 32 128-byte
2876  * rows, which changed the alignment requirements and fence programming.
2877  */
2878 #define HAS_128_BYTE_Y_TILING(dev_priv) (!IS_GEN2(dev_priv) && \
2879                                          !(IS_I915G(dev_priv) || \
2880                                          IS_I915GM(dev_priv)))
2881 #define SUPPORTS_TV(dev_priv)           ((dev_priv)->info.supports_tv)
2882 #define I915_HAS_HOTPLUG(dev_priv)      ((dev_priv)->info.has_hotplug)
2883
2884 #define HAS_FW_BLC(dev_priv)    (INTEL_GEN(dev_priv) > 2)
2885 #define HAS_PIPE_CXSR(dev_priv) ((dev_priv)->info.has_pipe_cxsr)
2886 #define HAS_FBC(dev_priv)       ((dev_priv)->info.has_fbc)
2887
2888 #define HAS_IPS(dev_priv)       (IS_HSW_ULT(dev_priv) || IS_BROADWELL(dev_priv))
2889
2890 #define HAS_DP_MST(dev_priv)    ((dev_priv)->info.has_dp_mst)
2891
2892 #define HAS_DDI(dev_priv)                ((dev_priv)->info.has_ddi)
2893 #define HAS_FPGA_DBG_UNCLAIMED(dev_priv) ((dev_priv)->info.has_fpga_dbg)
2894 #define HAS_PSR(dev_priv)                ((dev_priv)->info.has_psr)
2895 #define HAS_RC6(dev_priv)                ((dev_priv)->info.has_rc6)
2896 #define HAS_RC6p(dev_priv)               ((dev_priv)->info.has_rc6p)
2897
2898 #define HAS_CSR(dev_priv)       ((dev_priv)->info.has_csr)
2899
2900 #define HAS_RUNTIME_PM(dev_priv) ((dev_priv)->info.has_runtime_pm)
2901 #define HAS_64BIT_RELOC(dev_priv) ((dev_priv)->info.has_64bit_reloc)
2902
2903 /*
2904  * For now, anything with a GuC requires uCode loading, and then supports
2905  * command submission once loaded. But these are logically independent
2906  * properties, so we have separate macros to test them.
2907  */
2908 #define HAS_GUC(dev_priv)       ((dev_priv)->info.has_guc)
2909 #define HAS_GUC_UCODE(dev_priv) (HAS_GUC(dev_priv))
2910 #define HAS_GUC_SCHED(dev_priv) (HAS_GUC(dev_priv))
2911 #define HAS_HUC_UCODE(dev_priv) (HAS_GUC(dev_priv))
2912
2913 #define HAS_RESOURCE_STREAMER(dev_priv) ((dev_priv)->info.has_resource_streamer)
2914
2915 #define HAS_POOLED_EU(dev_priv) ((dev_priv)->info.has_pooled_eu)
2916
2917 #define INTEL_PCH_DEVICE_ID_MASK                0xff00
2918 #define INTEL_PCH_IBX_DEVICE_ID_TYPE            0x3b00
2919 #define INTEL_PCH_CPT_DEVICE_ID_TYPE            0x1c00
2920 #define INTEL_PCH_PPT_DEVICE_ID_TYPE            0x1e00
2921 #define INTEL_PCH_LPT_DEVICE_ID_TYPE            0x8c00
2922 #define INTEL_PCH_LPT_LP_DEVICE_ID_TYPE         0x9c00
2923 #define INTEL_PCH_SPT_DEVICE_ID_TYPE            0xA100
2924 #define INTEL_PCH_SPT_LP_DEVICE_ID_TYPE         0x9D00
2925 #define INTEL_PCH_KBP_DEVICE_ID_TYPE            0xA200
2926 #define INTEL_PCH_P2X_DEVICE_ID_TYPE            0x7100
2927 #define INTEL_PCH_P3X_DEVICE_ID_TYPE            0x7000
2928 #define INTEL_PCH_QEMU_DEVICE_ID_TYPE           0x2900 /* qemu q35 has 2918 */
2929
2930 #define INTEL_PCH_TYPE(dev_priv) ((dev_priv)->pch_type)
2931 #define HAS_PCH_KBP(dev_priv) (INTEL_PCH_TYPE(dev_priv) == PCH_KBP)
2932 #define HAS_PCH_SPT(dev_priv) (INTEL_PCH_TYPE(dev_priv) == PCH_SPT)
2933 #define HAS_PCH_LPT(dev_priv) (INTEL_PCH_TYPE(dev_priv) == PCH_LPT)
2934 #define HAS_PCH_LPT_LP(dev_priv) \
2935         ((dev_priv)->pch_id == INTEL_PCH_LPT_LP_DEVICE_ID_TYPE)
2936 #define HAS_PCH_LPT_H(dev_priv) \
2937         ((dev_priv)->pch_id == INTEL_PCH_LPT_DEVICE_ID_TYPE)
2938 #define HAS_PCH_CPT(dev_priv) (INTEL_PCH_TYPE(dev_priv) == PCH_CPT)
2939 #define HAS_PCH_IBX(dev_priv) (INTEL_PCH_TYPE(dev_priv) == PCH_IBX)
2940 #define HAS_PCH_NOP(dev_priv) (INTEL_PCH_TYPE(dev_priv) == PCH_NOP)
2941 #define HAS_PCH_SPLIT(dev_priv) (INTEL_PCH_TYPE(dev_priv) != PCH_NONE)
2942
2943 #define HAS_GMCH_DISPLAY(dev_priv) ((dev_priv)->info.has_gmch_display)
2944
2945 #define HAS_LSPCON(dev_priv) (IS_GEN9(dev_priv))
2946
2947 /* DPF == dynamic parity feature */
2948 #define HAS_L3_DPF(dev_priv) ((dev_priv)->info.has_l3_dpf)
2949 #define NUM_L3_SLICES(dev_priv) (IS_HSW_GT3(dev_priv) ? \
2950                                  2 : HAS_L3_DPF(dev_priv))
2951
2952 #define GT_FREQUENCY_MULTIPLIER 50
2953 #define GEN9_FREQ_SCALER 3
2954
2955 #define HAS_DECOUPLED_MMIO(dev_priv) (INTEL_INFO(dev_priv)->has_decoupled_mmio)
2956
2957 #include "i915_trace.h"
2958
2959 static inline bool intel_scanout_needs_vtd_wa(struct drm_i915_private *dev_priv)
2960 {
2961 #ifdef CONFIG_INTEL_IOMMU
2962         if (INTEL_GEN(dev_priv) >= 6 && intel_iommu_gfx_mapped)
2963                 return true;
2964 #endif
2965         return false;
2966 }
2967
2968 int intel_sanitize_enable_ppgtt(struct drm_i915_private *dev_priv,
2969                                 int enable_ppgtt);
2970
2971 bool intel_sanitize_semaphores(struct drm_i915_private *dev_priv, int value);
2972
2973 /* i915_drv.c */
2974 void __printf(3, 4)
2975 __i915_printk(struct drm_i915_private *dev_priv, const char *level,
2976               const char *fmt, ...);
2977
2978 #define i915_report_error(dev_priv, fmt, ...)                              \
2979         __i915_printk(dev_priv, KERN_ERR, fmt, ##__VA_ARGS__)
2980
2981 #ifdef CONFIG_COMPAT
2982 extern long i915_compat_ioctl(struct file *filp, unsigned int cmd,
2983                               unsigned long arg);
2984 #else
2985 #define i915_compat_ioctl NULL
2986 #endif
2987 extern const struct dev_pm_ops i915_pm_ops;
2988
2989 extern int i915_driver_load(struct pci_dev *pdev,
2990                             const struct pci_device_id *ent);
2991 extern void i915_driver_unload(struct drm_device *dev);
2992 extern int intel_gpu_reset(struct drm_i915_private *dev_priv, u32 engine_mask);
2993 extern bool intel_has_gpu_reset(struct drm_i915_private *dev_priv);
2994 extern void i915_reset(struct drm_i915_private *dev_priv);
2995 extern int intel_guc_reset(struct drm_i915_private *dev_priv);
2996 extern void intel_engine_init_hangcheck(struct intel_engine_cs *engine);
2997 extern void intel_hangcheck_init(struct drm_i915_private *dev_priv);
2998 extern unsigned long i915_chipset_val(struct drm_i915_private *dev_priv);
2999 extern unsigned long i915_mch_val(struct drm_i915_private *dev_priv);
3000 extern unsigned long i915_gfx_val(struct drm_i915_private *dev_priv);
3001 extern void i915_update_gfx_val(struct drm_i915_private *dev_priv);
3002 int vlv_force_gfx_clock(struct drm_i915_private *dev_priv, bool on);
3003
3004 int intel_engines_init_early(struct drm_i915_private *dev_priv);
3005 int intel_engines_init(struct drm_i915_private *dev_priv);
3006
3007 /* intel_hotplug.c */
3008 void intel_hpd_irq_handler(struct drm_i915_private *dev_priv,
3009                            u32 pin_mask, u32 long_mask);
3010 void intel_hpd_init(struct drm_i915_private *dev_priv);
3011 void intel_hpd_init_work(struct drm_i915_private *dev_priv);
3012 void intel_hpd_cancel_work(struct drm_i915_private *dev_priv);
3013 bool intel_hpd_pin_to_port(enum hpd_pin pin, enum port *port);
3014 bool intel_hpd_disable(struct drm_i915_private *dev_priv, enum hpd_pin pin);
3015 void intel_hpd_enable(struct drm_i915_private *dev_priv, enum hpd_pin pin);
3016
3017 /* i915_irq.c */
3018 static inline void i915_queue_hangcheck(struct drm_i915_private *dev_priv)
3019 {
3020         unsigned long delay;
3021
3022         if (unlikely(!i915.enable_hangcheck))
3023                 return;
3024
3025         /* Don't continually defer the hangcheck so that it is always run at
3026          * least once after work has been scheduled on any ring. Otherwise,
3027          * we will ignore a hung ring if a second ring is kept busy.
3028          */
3029
3030         delay = round_jiffies_up_relative(DRM_I915_HANGCHECK_JIFFIES);
3031         queue_delayed_work(system_long_wq,
3032                            &dev_priv->gpu_error.hangcheck_work, delay);
3033 }
3034
3035 __printf(3, 4)
3036 void i915_handle_error(struct drm_i915_private *dev_priv,
3037                        u32 engine_mask,
3038                        const char *fmt, ...);
3039
3040 extern void intel_irq_init(struct drm_i915_private *dev_priv);
3041 int intel_irq_install(struct drm_i915_private *dev_priv);
3042 void intel_irq_uninstall(struct drm_i915_private *dev_priv);
3043
3044 extern void intel_uncore_sanitize(struct drm_i915_private *dev_priv);
3045 extern void intel_uncore_early_sanitize(struct drm_i915_private *dev_priv,
3046                                         bool restore_forcewake);
3047 extern void intel_uncore_init(struct drm_i915_private *dev_priv);
3048 extern bool intel_uncore_unclaimed_mmio(struct drm_i915_private *dev_priv);
3049 extern bool intel_uncore_arm_unclaimed_mmio_detection(struct drm_i915_private *dev_priv);
3050 extern void intel_uncore_fini(struct drm_i915_private *dev_priv);
3051 extern void intel_uncore_forcewake_reset(struct drm_i915_private *dev_priv,
3052                                          bool restore);
3053 const char *intel_uncore_forcewake_domain_to_str(const enum forcewake_domain_id id);
3054 void intel_uncore_forcewake_get(struct drm_i915_private *dev_priv,
3055                                 enum forcewake_domains domains);
3056 void intel_uncore_forcewake_put(struct drm_i915_private *dev_priv,
3057                                 enum forcewake_domains domains);
3058 /* Like above but the caller must manage the uncore.lock itself.
3059  * Must be used with I915_READ_FW and friends.
3060  */
3061 void intel_uncore_forcewake_get__locked(struct drm_i915_private *dev_priv,
3062                                         enum forcewake_domains domains);
3063 void intel_uncore_forcewake_put__locked(struct drm_i915_private *dev_priv,
3064                                         enum forcewake_domains domains);
3065 u64 intel_uncore_edram_size(struct drm_i915_private *dev_priv);
3066
3067 void assert_forcewakes_inactive(struct drm_i915_private *dev_priv);
3068
3069 int intel_wait_for_register(struct drm_i915_private *dev_priv,
3070                             i915_reg_t reg,
3071                             const u32 mask,
3072                             const u32 value,
3073                             const unsigned long timeout_ms);
3074 int intel_wait_for_register_fw(struct drm_i915_private *dev_priv,
3075                                i915_reg_t reg,
3076                                const u32 mask,
3077                                const u32 value,
3078                                const unsigned long timeout_ms);
3079
3080 static inline bool intel_gvt_active(struct drm_i915_private *dev_priv)
3081 {
3082         return dev_priv->gvt;
3083 }
3084
3085 static inline bool intel_vgpu_active(struct drm_i915_private *dev_priv)
3086 {
3087         return dev_priv->vgpu.active;
3088 }
3089
3090 void
3091 i915_enable_pipestat(struct drm_i915_private *dev_priv, enum pipe pipe,
3092                      u32 status_mask);
3093
3094 void
3095 i915_disable_pipestat(struct drm_i915_private *dev_priv, enum pipe pipe,
3096                       u32 status_mask);
3097
3098 void valleyview_enable_display_irqs(struct drm_i915_private *dev_priv);
3099 void valleyview_disable_display_irqs(struct drm_i915_private *dev_priv);
3100 void i915_hotplug_interrupt_update(struct drm_i915_private *dev_priv,
3101                                    uint32_t mask,
3102                                    uint32_t bits);
3103 void ilk_update_display_irq(struct drm_i915_private *dev_priv,
3104                             uint32_t interrupt_mask,
3105                             uint32_t enabled_irq_mask);
3106 static inline void
3107 ilk_enable_display_irq(struct drm_i915_private *dev_priv, uint32_t bits)
3108 {
3109         ilk_update_display_irq(dev_priv, bits, bits);
3110 }
3111 static inline void
3112 ilk_disable_display_irq(struct drm_i915_private *dev_priv, uint32_t bits)
3113 {
3114         ilk_update_display_irq(dev_priv, bits, 0);
3115 }
3116 void bdw_update_pipe_irq(struct drm_i915_private *dev_priv,
3117                          enum pipe pipe,
3118                          uint32_t interrupt_mask,
3119                          uint32_t enabled_irq_mask);
3120 static inline void bdw_enable_pipe_irq(struct drm_i915_private *dev_priv,
3121                                        enum pipe pipe, uint32_t bits)
3122 {
3123         bdw_update_pipe_irq(dev_priv, pipe, bits, bits);
3124 }
3125 static inline void bdw_disable_pipe_irq(struct drm_i915_private *dev_priv,
3126                                         enum pipe pipe, uint32_t bits)
3127 {
3128         bdw_update_pipe_irq(dev_priv, pipe, bits, 0);
3129 }
3130 void ibx_display_interrupt_update(struct drm_i915_private *dev_priv,
3131                                   uint32_t interrupt_mask,
3132                                   uint32_t enabled_irq_mask);
3133 static inline void
3134 ibx_enable_display_interrupt(struct drm_i915_private *dev_priv, uint32_t bits)
3135 {
3136         ibx_display_interrupt_update(dev_priv, bits, bits);
3137 }
3138 static inline void
3139 ibx_disable_display_interrupt(struct drm_i915_private *dev_priv, uint32_t bits)
3140 {
3141         ibx_display_interrupt_update(dev_priv, bits, 0);
3142 }
3143
3144 /* i915_gem.c */
3145 int i915_gem_create_ioctl(struct drm_device *dev, void *data,
3146                           struct drm_file *file_priv);
3147 int i915_gem_pread_ioctl(struct drm_device *dev, void *data,
3148                          struct drm_file *file_priv);
3149 int i915_gem_pwrite_ioctl(struct drm_device *dev, void *data,
3150                           struct drm_file *file_priv);
3151 int i915_gem_mmap_ioctl(struct drm_device *dev, void *data,
3152                         struct drm_file *file_priv);
3153 int i915_gem_mmap_gtt_ioctl(struct drm_device *dev, void *data,
3154                         struct drm_file *file_priv);
3155 int i915_gem_set_domain_ioctl(struct drm_device *dev, void *data,
3156                               struct drm_file *file_priv);
3157 int i915_gem_sw_finish_ioctl(struct drm_device *dev, void *data,
3158                              struct drm_file *file_priv);
3159 int i915_gem_execbuffer(struct drm_device *dev, void *data,
3160                         struct drm_file *file_priv);
3161 int i915_gem_execbuffer2(struct drm_device *dev, void *data,
3162                          struct drm_file *file_priv);
3163 int i915_gem_busy_ioctl(struct drm_device *dev, void *data,
3164                         struct drm_file *file_priv);
3165 int i915_gem_get_caching_ioctl(struct drm_device *dev, void *data,
3166                                struct drm_file *file);
3167 int i915_gem_set_caching_ioctl(struct drm_device *dev, void *data,
3168                                struct drm_file *file);
3169 int i915_gem_throttle_ioctl(struct drm_device *dev, void *data,
3170                             struct drm_file *file_priv);
3171 int i915_gem_madvise_ioctl(struct drm_device *dev, void *data,
3172                            struct drm_file *file_priv);
3173 int i915_gem_set_tiling_ioctl(struct drm_device *dev, void *data,
3174                               struct drm_file *file_priv);
3175 int i915_gem_get_tiling_ioctl(struct drm_device *dev, void *data,
3176                               struct drm_file *file_priv);
3177 void i915_gem_init_userptr(struct drm_i915_private *dev_priv);
3178 int i915_gem_userptr_ioctl(struct drm_device *dev, void *data,
3179                            struct drm_file *file);
3180 int i915_gem_get_aperture_ioctl(struct drm_device *dev, void *data,
3181                                 struct drm_file *file_priv);
3182 int i915_gem_wait_ioctl(struct drm_device *dev, void *data,
3183                         struct drm_file *file_priv);
3184 void i915_gem_sanitize(struct drm_i915_private *i915);
3185 int i915_gem_load_init(struct drm_i915_private *dev_priv);
3186 void i915_gem_load_cleanup(struct drm_i915_private *dev_priv);
3187 void i915_gem_load_init_fences(struct drm_i915_private *dev_priv);
3188 int i915_gem_freeze(struct drm_i915_private *dev_priv);
3189 int i915_gem_freeze_late(struct drm_i915_private *dev_priv);
3190
3191 void *i915_gem_object_alloc(struct drm_i915_private *dev_priv);
3192 void i915_gem_object_free(struct drm_i915_gem_object *obj);
3193 void i915_gem_object_init(struct drm_i915_gem_object *obj,
3194                          const struct drm_i915_gem_object_ops *ops);
3195 struct drm_i915_gem_object *
3196 i915_gem_object_create(struct drm_i915_private *dev_priv, u64 size);
3197 struct drm_i915_gem_object *
3198 i915_gem_object_create_from_data(struct drm_i915_private *dev_priv,
3199                                  const void *data, size_t size);
3200 void i915_gem_close_object(struct drm_gem_object *gem, struct drm_file *file);
3201 void i915_gem_free_object(struct drm_gem_object *obj);
3202
3203 static inline void i915_gem_drain_freed_objects(struct drm_i915_private *i915)
3204 {
3205         /* A single pass should suffice to release all the freed objects (along
3206          * most call paths) , but be a little more paranoid in that freeing
3207          * the objects does take a little amount of time, during which the rcu
3208          * callbacks could have added new objects into the freed list, and
3209          * armed the work again.
3210          */
3211         do {
3212                 rcu_barrier();
3213         } while (flush_work(&i915->mm.free_work));
3214 }
3215
3216 struct i915_vma * __must_check
3217 i915_gem_object_ggtt_pin(struct drm_i915_gem_object *obj,
3218                          const struct i915_ggtt_view *view,
3219                          u64 size,
3220                          u64 alignment,
3221                          u64 flags);
3222
3223 int i915_gem_object_unbind(struct drm_i915_gem_object *obj);
3224 void i915_gem_release_mmap(struct drm_i915_gem_object *obj);
3225
3226 void i915_gem_runtime_suspend(struct drm_i915_private *dev_priv);
3227
3228 static inline int __sg_page_count(const struct scatterlist *sg)
3229 {
3230         return sg->length >> PAGE_SHIFT;
3231 }
3232
3233 struct scatterlist *
3234 i915_gem_object_get_sg(struct drm_i915_gem_object *obj,
3235                        unsigned int n, unsigned int *offset);
3236
3237 struct page *
3238 i915_gem_object_get_page(struct drm_i915_gem_object *obj,
3239                          unsigned int n);
3240
3241 struct page *
3242 i915_gem_object_get_dirty_page(struct drm_i915_gem_object *obj,
3243                                unsigned int n);
3244
3245 dma_addr_t
3246 i915_gem_object_get_dma_address(struct drm_i915_gem_object *obj,
3247                                 unsigned long n);
3248
3249 void __i915_gem_object_set_pages(struct drm_i915_gem_object *obj,
3250                                  struct sg_table *pages);
3251 int __i915_gem_object_get_pages(struct drm_i915_gem_object *obj);
3252
3253 static inline int __must_check
3254 i915_gem_object_pin_pages(struct drm_i915_gem_object *obj)
3255 {
3256         might_lock(&obj->mm.lock);
3257
3258         if (atomic_inc_not_zero(&obj->mm.pages_pin_count))
3259                 return 0;
3260
3261         return __i915_gem_object_get_pages(obj);
3262 }
3263
3264 static inline void
3265 __i915_gem_object_pin_pages(struct drm_i915_gem_object *obj)
3266 {
3267         GEM_BUG_ON(!obj->mm.pages);
3268
3269         atomic_inc(&obj->mm.pages_pin_count);
3270 }
3271
3272 static inline bool
3273 i915_gem_object_has_pinned_pages(struct drm_i915_gem_object *obj)
3274 {
3275         return atomic_read(&obj->mm.pages_pin_count);
3276 }
3277
3278 static inline void
3279 __i915_gem_object_unpin_pages(struct drm_i915_gem_object *obj)
3280 {
3281         GEM_BUG_ON(!i915_gem_object_has_pinned_pages(obj));
3282         GEM_BUG_ON(!obj->mm.pages);
3283
3284         atomic_dec(&obj->mm.pages_pin_count);
3285 }
3286
3287 static inline void
3288 i915_gem_object_unpin_pages(struct drm_i915_gem_object *obj)
3289 {
3290         __i915_gem_object_unpin_pages(obj);
3291 }
3292
3293 enum i915_mm_subclass { /* lockdep subclass for obj->mm.lock */
3294         I915_MM_NORMAL = 0,
3295         I915_MM_SHRINKER
3296 };
3297
3298 void __i915_gem_object_put_pages(struct drm_i915_gem_object *obj,
3299                                  enum i915_mm_subclass subclass);
3300 void __i915_gem_object_invalidate(struct drm_i915_gem_object *obj);
3301
3302 enum i915_map_type {
3303         I915_MAP_WB = 0,
3304         I915_MAP_WC,
3305 };
3306
3307 /**
3308  * i915_gem_object_pin_map - return a contiguous mapping of the entire object
3309  * @obj: the object to map into kernel address space
3310  * @type: the type of mapping, used to select pgprot_t
3311  *
3312  * Calls i915_gem_object_pin_pages() to prevent reaping of the object's
3313  * pages and then returns a contiguous mapping of the backing storage into
3314  * the kernel address space. Based on the @type of mapping, the PTE will be
3315  * set to either WriteBack or WriteCombine (via pgprot_t).
3316  *
3317  * The caller is responsible for calling i915_gem_object_unpin_map() when the
3318  * mapping is no longer required.
3319  *
3320  * Returns the pointer through which to access the mapped object, or an
3321  * ERR_PTR() on error.
3322  */
3323 void *__must_check i915_gem_object_pin_map(struct drm_i915_gem_object *obj,
3324                                            enum i915_map_type type);
3325
3326 /**
3327  * i915_gem_object_unpin_map - releases an earlier mapping
3328  * @obj: the object to unmap
3329  *
3330  * After pinning the object and mapping its pages, once you are finished
3331  * with your access, call i915_gem_object_unpin_map() to release the pin
3332  * upon the mapping. Once the pin count reaches zero, that mapping may be
3333  * removed.
3334  */
3335 static inline void i915_gem_object_unpin_map(struct drm_i915_gem_object *obj)
3336 {
3337         i915_gem_object_unpin_pages(obj);
3338 }
3339
3340 int i915_gem_obj_prepare_shmem_read(struct drm_i915_gem_object *obj,
3341                                     unsigned int *needs_clflush);
3342 int i915_gem_obj_prepare_shmem_write(struct drm_i915_gem_object *obj,
3343                                      unsigned int *needs_clflush);
3344 #define CLFLUSH_BEFORE 0x1
3345 #define CLFLUSH_AFTER 0x2
3346 #define CLFLUSH_FLAGS (CLFLUSH_BEFORE | CLFLUSH_AFTER)
3347
3348 static inline void
3349 i915_gem_obj_finish_shmem_access(struct drm_i915_gem_object *obj)
3350 {
3351         i915_gem_object_unpin_pages(obj);
3352 }
3353
3354 int __must_check i915_mutex_lock_interruptible(struct drm_device *dev);
3355 void i915_vma_move_to_active(struct i915_vma *vma,
3356                              struct drm_i915_gem_request *req,
3357                              unsigned int flags);
3358 int i915_gem_dumb_create(struct drm_file *file_priv,
3359                          struct drm_device *dev,
3360                          struct drm_mode_create_dumb *args);
3361 int i915_gem_mmap_gtt(struct drm_file *file_priv, struct drm_device *dev,
3362                       uint32_t handle, uint64_t *offset);
3363 int i915_gem_mmap_gtt_version(void);
3364
3365 void i915_gem_track_fb(struct drm_i915_gem_object *old,
3366                        struct drm_i915_gem_object *new,
3367                        unsigned frontbuffer_bits);
3368
3369 int __must_check i915_gem_set_global_seqno(struct drm_device *dev, u32 seqno);
3370
3371 struct drm_i915_gem_request *
3372 i915_gem_find_active_request(struct intel_engine_cs *engine);
3373
3374 void i915_gem_retire_requests(struct drm_i915_private *dev_priv);
3375
3376 static inline bool i915_reset_in_progress(struct i915_gpu_error *error)
3377 {
3378         return unlikely(test_bit(I915_RESET_IN_PROGRESS, &error->flags));
3379 }
3380
3381 static inline bool i915_terminally_wedged(struct i915_gpu_error *error)
3382 {
3383         return unlikely(test_bit(I915_WEDGED, &error->flags));
3384 }
3385
3386 static inline bool i915_reset_in_progress_or_wedged(struct i915_gpu_error *error)
3387 {
3388         return i915_reset_in_progress(error) | i915_terminally_wedged(error);
3389 }
3390
3391 static inline u32 i915_reset_count(struct i915_gpu_error *error)
3392 {
3393         return READ_ONCE(error->reset_count);
3394 }
3395
3396 int i915_gem_reset_prepare(struct drm_i915_private *dev_priv);
3397 void i915_gem_reset(struct drm_i915_private *dev_priv);
3398 void i915_gem_reset_finish(struct drm_i915_private *dev_priv);
3399 void i915_gem_set_wedged(struct drm_i915_private *dev_priv);
3400
3401 void i915_gem_init_mmio(struct drm_i915_private *i915);
3402 int __must_check i915_gem_init(struct drm_i915_private *dev_priv);
3403 int __must_check i915_gem_init_hw(struct drm_i915_private *dev_priv);
3404 void i915_gem_init_swizzling(struct drm_i915_private *dev_priv);
3405 void i915_gem_cleanup_engines(struct drm_i915_private *dev_priv);
3406 int i915_gem_wait_for_idle(struct drm_i915_private *dev_priv,
3407                            unsigned int flags);
3408 int __must_check i915_gem_suspend(struct drm_i915_private *dev_priv);
3409 void i915_gem_resume(struct drm_i915_private *dev_priv);
3410 int i915_gem_fault(struct vm_area_struct *vma, struct vm_fault *vmf);
3411 int i915_gem_object_wait(struct drm_i915_gem_object *obj,
3412                          unsigned int flags,
3413                          long timeout,
3414                          struct intel_rps_client *rps);
3415 int i915_gem_object_wait_priority(struct drm_i915_gem_object *obj,
3416                                   unsigned int flags,
3417                                   int priority);
3418 #define I915_PRIORITY_DISPLAY I915_PRIORITY_MAX
3419
3420 int __must_check
3421 i915_gem_object_set_to_gtt_domain(struct drm_i915_gem_object *obj,
3422                                   bool write);
3423 int __must_check
3424 i915_gem_object_set_to_cpu_domain(struct drm_i915_gem_object *obj, bool write);
3425 struct i915_vma * __must_check
3426 i915_gem_object_pin_to_display_plane(struct drm_i915_gem_object *obj,
3427                                      u32 alignment,
3428                                      const struct i915_ggtt_view *view);
3429 void i915_gem_object_unpin_from_display_plane(struct i915_vma *vma);
3430 int i915_gem_object_attach_phys(struct drm_i915_gem_object *obj,
3431                                 int align);
3432 int i915_gem_open(struct drm_device *dev, struct drm_file *file);
3433 void i915_gem_release(struct drm_device *dev, struct drm_file *file);
3434
3435 int i915_gem_object_set_cache_level(struct drm_i915_gem_object *obj,
3436                                     enum i915_cache_level cache_level);
3437
3438 struct drm_gem_object *i915_gem_prime_import(struct drm_device *dev,
3439                                 struct dma_buf *dma_buf);
3440
3441 struct dma_buf *i915_gem_prime_export(struct drm_device *dev,
3442                                 struct drm_gem_object *gem_obj, int flags);
3443
3444 static inline struct i915_hw_ppgtt *
3445 i915_vm_to_ppgtt(struct i915_address_space *vm)
3446 {
3447         return container_of(vm, struct i915_hw_ppgtt, base);
3448 }
3449
3450 /* i915_gem_fence_reg.c */
3451 int __must_check i915_vma_get_fence(struct i915_vma *vma);
3452 int __must_check i915_vma_put_fence(struct i915_vma *vma);
3453
3454 void i915_gem_revoke_fences(struct drm_i915_private *dev_priv);
3455 void i915_gem_restore_fences(struct drm_i915_private *dev_priv);
3456
3457 void i915_gem_detect_bit_6_swizzle(struct drm_i915_private *dev_priv);
3458 void i915_gem_object_do_bit_17_swizzle(struct drm_i915_gem_object *obj,
3459                                        struct sg_table *pages);
3460 void i915_gem_object_save_bit_17_swizzle(struct drm_i915_gem_object *obj,
3461                                          struct sg_table *pages);
3462
3463 static inline struct i915_gem_context *
3464 i915_gem_context_lookup(struct drm_i915_file_private *file_priv, u32 id)
3465 {
3466         struct i915_gem_context *ctx;
3467
3468         lockdep_assert_held(&file_priv->dev_priv->drm.struct_mutex);
3469
3470         ctx = idr_find(&file_priv->context_idr, id);
3471         if (!ctx)
3472                 return ERR_PTR(-ENOENT);
3473
3474         return ctx;
3475 }
3476
3477 static inline struct i915_gem_context *
3478 i915_gem_context_get(struct i915_gem_context *ctx)
3479 {
3480         kref_get(&ctx->ref);
3481         return ctx;
3482 }
3483
3484 static inline void i915_gem_context_put(struct i915_gem_context *ctx)
3485 {
3486         lockdep_assert_held(&ctx->i915->drm.struct_mutex);
3487         kref_put(&ctx->ref, i915_gem_context_free);
3488 }
3489
3490 static inline void i915_gem_context_put_unlocked(struct i915_gem_context *ctx)
3491 {
3492         struct mutex *lock = &ctx->i915->drm.struct_mutex;
3493
3494         if (kref_put_mutex(&ctx->ref, i915_gem_context_free, lock))
3495                 mutex_unlock(lock);
3496 }
3497
3498 static inline struct intel_timeline *
3499 i915_gem_context_lookup_timeline(struct i915_gem_context *ctx,
3500                                  struct intel_engine_cs *engine)
3501 {
3502         struct i915_address_space *vm;
3503
3504         vm = ctx->ppgtt ? &ctx->ppgtt->base : &ctx->i915->ggtt.base;
3505         return &vm->timeline.engine[engine->id];
3506 }
3507
3508 int i915_perf_open_ioctl(struct drm_device *dev, void *data,
3509                          struct drm_file *file);
3510
3511 /* i915_gem_evict.c */
3512 int __must_check i915_gem_evict_something(struct i915_address_space *vm,
3513                                           u64 min_size, u64 alignment,
3514                                           unsigned cache_level,
3515                                           u64 start, u64 end,
3516                                           unsigned flags);
3517 int __must_check i915_gem_evict_for_node(struct i915_address_space *vm,
3518                                          struct drm_mm_node *node,
3519                                          unsigned int flags);
3520 int i915_gem_evict_vm(struct i915_address_space *vm, bool do_idle);
3521
3522 /* belongs in i915_gem_gtt.h */
3523 static inline void i915_gem_chipset_flush(struct drm_i915_private *dev_priv)
3524 {
3525         wmb();
3526         if (INTEL_GEN(dev_priv) < 6)
3527                 intel_gtt_chipset_flush();
3528 }
3529
3530 /* i915_gem_stolen.c */
3531 int i915_gem_stolen_insert_node(struct drm_i915_private *dev_priv,
3532                                 struct drm_mm_node *node, u64 size,
3533                                 unsigned alignment);
3534 int i915_gem_stolen_insert_node_in_range(struct drm_i915_private *dev_priv,
3535                                          struct drm_mm_node *node, u64 size,
3536                                          unsigned alignment, u64 start,
3537                                          u64 end);
3538 void i915_gem_stolen_remove_node(struct drm_i915_private *dev_priv,
3539                                  struct drm_mm_node *node);
3540 int i915_gem_init_stolen(struct drm_i915_private *dev_priv);
3541 void i915_gem_cleanup_stolen(struct drm_device *dev);
3542 struct drm_i915_gem_object *
3543 i915_gem_object_create_stolen(struct drm_i915_private *dev_priv, u32 size);
3544 struct drm_i915_gem_object *
3545 i915_gem_object_create_stolen_for_preallocated(struct drm_i915_private *dev_priv,
3546                                                u32 stolen_offset,
3547                                                u32 gtt_offset,
3548                                                u32 size);
3549
3550 /* i915_gem_internal.c */
3551 struct drm_i915_gem_object *
3552 i915_gem_object_create_internal(struct drm_i915_private *dev_priv,
3553                                 phys_addr_t size);
3554
3555 /* i915_gem_shrinker.c */
3556 unsigned long i915_gem_shrink(struct drm_i915_private *dev_priv,
3557                               unsigned long target,
3558                               unsigned flags);
3559 #define I915_SHRINK_PURGEABLE 0x1
3560 #define I915_SHRINK_UNBOUND 0x2
3561 #define I915_SHRINK_BOUND 0x4
3562 #define I915_SHRINK_ACTIVE 0x8
3563 #define I915_SHRINK_VMAPS 0x10
3564 unsigned long i915_gem_shrink_all(struct drm_i915_private *dev_priv);
3565 void i915_gem_shrinker_init(struct drm_i915_private *dev_priv);
3566 void i915_gem_shrinker_cleanup(struct drm_i915_private *dev_priv);
3567
3568
3569 /* i915_gem_tiling.c */
3570 static inline bool i915_gem_object_needs_bit17_swizzle(struct drm_i915_gem_object *obj)
3571 {
3572         struct drm_i915_private *dev_priv = to_i915(obj->base.dev);
3573
3574         return dev_priv->mm.bit_6_swizzle_x == I915_BIT_6_SWIZZLE_9_10_17 &&
3575                 i915_gem_object_is_tiled(obj);
3576 }
3577
3578 u32 i915_gem_fence_size(struct drm_i915_private *dev_priv, u32 size,
3579                         unsigned int tiling, unsigned int stride);
3580 u32 i915_gem_fence_alignment(struct drm_i915_private *dev_priv, u32 size,
3581                              unsigned int tiling, unsigned int stride);
3582
3583 /* i915_debugfs.c */
3584 #ifdef CONFIG_DEBUG_FS
3585 int i915_debugfs_register(struct drm_i915_private *dev_priv);
3586 void i915_debugfs_unregister(struct drm_i915_private *dev_priv);
3587 int i915_debugfs_connector_add(struct drm_connector *connector);
3588 void intel_display_crc_init(struct drm_i915_private *dev_priv);
3589 #else
3590 static inline int i915_debugfs_register(struct drm_i915_private *dev_priv) {return 0;}
3591 static inline void i915_debugfs_unregister(struct drm_i915_private *dev_priv) {}
3592 static inline int i915_debugfs_connector_add(struct drm_connector *connector)
3593 { return 0; }
3594 static inline void intel_display_crc_init(struct drm_i915_private *dev_priv) {}
3595 #endif
3596
3597 /* i915_gpu_error.c */
3598 #if IS_ENABLED(CONFIG_DRM_I915_CAPTURE_ERROR)
3599
3600 __printf(2, 3)
3601 void i915_error_printf(struct drm_i915_error_state_buf *e, const char *f, ...);
3602 int i915_error_state_to_str(struct drm_i915_error_state_buf *estr,
3603                             const struct i915_gpu_state *gpu);
3604 int i915_error_state_buf_init(struct drm_i915_error_state_buf *eb,
3605                               struct drm_i915_private *i915,
3606                               size_t count, loff_t pos);
3607 static inline void i915_error_state_buf_release(
3608         struct drm_i915_error_state_buf *eb)
3609 {
3610         kfree(eb->buf);
3611 }
3612
3613 struct i915_gpu_state *i915_capture_gpu_state(struct drm_i915_private *i915);
3614 void i915_capture_error_state(struct drm_i915_private *dev_priv,
3615                               u32 engine_mask,
3616                               const char *error_msg);
3617
3618 static inline struct i915_gpu_state *
3619 i915_gpu_state_get(struct i915_gpu_state *gpu)
3620 {
3621         kref_get(&gpu->ref);
3622         return gpu;
3623 }
3624
3625 void __i915_gpu_state_free(struct kref *kref);
3626 static inline void i915_gpu_state_put(struct i915_gpu_state *gpu)
3627 {
3628         if (gpu)
3629                 kref_put(&gpu->ref, __i915_gpu_state_free);
3630 }
3631
3632 struct i915_gpu_state *i915_first_error_state(struct drm_i915_private *i915);
3633 void i915_reset_error_state(struct drm_i915_private *i915);
3634
3635 #else
3636
3637 static inline void i915_capture_error_state(struct drm_i915_private *dev_priv,
3638                                             u32 engine_mask,
3639                                             const char *error_msg)
3640 {
3641 }
3642
3643 static inline struct i915_gpu_state *
3644 i915_first_error_state(struct drm_i915_private *i915)
3645 {
3646         return NULL;
3647 }
3648
3649 static inline void i915_reset_error_state(struct drm_i915_private *i915)
3650 {
3651 }
3652
3653 #endif
3654
3655 const char *i915_cache_level_str(struct drm_i915_private *i915, int type);
3656
3657 /* i915_cmd_parser.c */
3658 int i915_cmd_parser_get_version(struct drm_i915_private *dev_priv);
3659 void intel_engine_init_cmd_parser(struct intel_engine_cs *engine);
3660 void intel_engine_cleanup_cmd_parser(struct intel_engine_cs *engine);
3661 int intel_engine_cmd_parser(struct intel_engine_cs *engine,
3662                             struct drm_i915_gem_object *batch_obj,
3663                             struct drm_i915_gem_object *shadow_batch_obj,
3664                             u32 batch_start_offset,
3665                             u32 batch_len,
3666                             bool is_master);
3667
3668 /* i915_perf.c */
3669 extern void i915_perf_init(struct drm_i915_private *dev_priv);
3670 extern void i915_perf_fini(struct drm_i915_private *dev_priv);
3671 extern void i915_perf_register(struct drm_i915_private *dev_priv);
3672 extern void i915_perf_unregister(struct drm_i915_private *dev_priv);
3673
3674 /* i915_suspend.c */
3675 extern int i915_save_state(struct drm_i915_private *dev_priv);
3676 extern int i915_restore_state(struct drm_i915_private *dev_priv);
3677
3678 /* i915_sysfs.c */
3679 void i915_setup_sysfs(struct drm_i915_private *dev_priv);
3680 void i915_teardown_sysfs(struct drm_i915_private *dev_priv);
3681
3682 /* intel_i2c.c */
3683 extern int intel_setup_gmbus(struct drm_i915_private *dev_priv);
3684 extern void intel_teardown_gmbus(struct drm_i915_private *dev_priv);
3685 extern bool intel_gmbus_is_valid_pin(struct drm_i915_private *dev_priv,
3686                                      unsigned int pin);
3687
3688 extern struct i2c_adapter *
3689 intel_gmbus_get_adapter(struct drm_i915_private *dev_priv, unsigned int pin);
3690 extern void intel_gmbus_set_speed(struct i2c_adapter *adapter, int speed);
3691 extern void intel_gmbus_force_bit(struct i2c_adapter *adapter, bool force_bit);
3692 static inline bool intel_gmbus_is_forced_bit(struct i2c_adapter *adapter)
3693 {
3694         return container_of(adapter, struct intel_gmbus, adapter)->force_bit;
3695 }
3696 extern void intel_i2c_reset(struct drm_i915_private *dev_priv);
3697
3698 /* intel_bios.c */
3699 int intel_bios_init(struct drm_i915_private *dev_priv);
3700 bool intel_bios_is_valid_vbt(const void *buf, size_t size);
3701 bool intel_bios_is_tv_present(struct drm_i915_private *dev_priv);
3702 bool intel_bios_is_lvds_present(struct drm_i915_private *dev_priv, u8 *i2c_pin);
3703 bool intel_bios_is_port_present(struct drm_i915_private *dev_priv, enum port port);
3704 bool intel_bios_is_port_edp(struct drm_i915_private *dev_priv, enum port port);
3705 bool intel_bios_is_port_dp_dual_mode(struct drm_i915_private *dev_priv, enum port port);
3706 bool intel_bios_is_dsi_present(struct drm_i915_private *dev_priv, enum port *port);
3707 bool intel_bios_is_port_hpd_inverted(struct drm_i915_private *dev_priv,
3708                                      enum port port);
3709 bool intel_bios_is_lspcon_present(struct drm_i915_private *dev_priv,
3710                                 enum port port);
3711
3712
3713 /* intel_opregion.c */
3714 #ifdef CONFIG_ACPI
3715 extern int intel_opregion_setup(struct drm_i915_private *dev_priv);
3716 extern void intel_opregion_register(struct drm_i915_private *dev_priv);
3717 extern void intel_opregion_unregister(struct drm_i915_private *dev_priv);
3718 extern void intel_opregion_asle_intr(struct drm_i915_private *dev_priv);
3719 extern int intel_opregion_notify_encoder(struct intel_encoder *intel_encoder,
3720                                          bool enable);
3721 extern int intel_opregion_notify_adapter(struct drm_i915_private *dev_priv,
3722                                          pci_power_t state);
3723 extern int intel_opregion_get_panel_type(struct drm_i915_private *dev_priv);
3724 #else
3725 static inline int intel_opregion_setup(struct drm_i915_private *dev) { return 0; }
3726 static inline void intel_opregion_register(struct drm_i915_private *dev_priv) { }
3727 static inline void intel_opregion_unregister(struct drm_i915_private *dev_priv) { }
3728 static inline void intel_opregion_asle_intr(struct drm_i915_private *dev_priv)
3729 {
3730 }
3731 static inline int
3732 intel_opregion_notify_encoder(struct intel_encoder *intel_encoder, bool enable)
3733 {
3734         return 0;
3735 }
3736 static inline int
3737 intel_opregion_notify_adapter(struct drm_i915_private *dev, pci_power_t state)
3738 {
3739         return 0;
3740 }
3741 static inline int intel_opregion_get_panel_type(struct drm_i915_private *dev)
3742 {
3743         return -ENODEV;
3744 }
3745 #endif
3746
3747 /* intel_acpi.c */
3748 #ifdef CONFIG_ACPI
3749 extern void intel_register_dsm_handler(void);
3750 extern void intel_unregister_dsm_handler(void);
3751 #else
3752 static inline void intel_register_dsm_handler(void) { return; }
3753 static inline void intel_unregister_dsm_handler(void) { return; }
3754 #endif /* CONFIG_ACPI */
3755
3756 /* intel_device_info.c */
3757 static inline struct intel_device_info *
3758 mkwrite_device_info(struct drm_i915_private *dev_priv)
3759 {
3760         return (struct intel_device_info *)&dev_priv->info;
3761 }
3762
3763 const char *intel_platform_name(enum intel_platform platform);
3764 void intel_device_info_runtime_init(struct drm_i915_private *dev_priv);
3765 void intel_device_info_dump(struct drm_i915_private *dev_priv);
3766
3767 /* modesetting */
3768 extern void intel_modeset_init_hw(struct drm_device *dev);
3769 extern int intel_modeset_init(struct drm_device *dev);
3770 extern void intel_modeset_gem_init(struct drm_device *dev);
3771 extern void intel_modeset_cleanup(struct drm_device *dev);
3772 extern int intel_connector_register(struct drm_connector *);
3773 extern void intel_connector_unregister(struct drm_connector *);
3774 extern int intel_modeset_vga_set_state(struct drm_i915_private *dev_priv,
3775                                        bool state);
3776 extern void intel_display_resume(struct drm_device *dev);
3777 extern void i915_redisable_vga(struct drm_i915_private *dev_priv);
3778 extern void i915_redisable_vga_power_on(struct drm_i915_private *dev_priv);
3779 extern bool ironlake_set_drps(struct drm_i915_private *dev_priv, u8 val);
3780 extern void intel_init_pch_refclk(struct drm_i915_private *dev_priv);
3781 extern int intel_set_rps(struct drm_i915_private *dev_priv, u8 val);
3782 extern bool intel_set_memory_cxsr(struct drm_i915_private *dev_priv,
3783                                   bool enable);
3784
3785 int i915_reg_read_ioctl(struct drm_device *dev, void *data,
3786                         struct drm_file *file);
3787
3788 /* overlay */
3789 extern struct intel_overlay_error_state *
3790 intel_overlay_capture_error_state(struct drm_i915_private *dev_priv);
3791 extern void intel_overlay_print_error_state(struct drm_i915_error_state_buf *e,
3792                                             struct intel_overlay_error_state *error);
3793
3794 extern struct intel_display_error_state *
3795 intel_display_capture_error_state(struct drm_i915_private *dev_priv);
3796 extern void intel_display_print_error_state(struct drm_i915_error_state_buf *e,
3797                                             struct intel_display_error_state *error);
3798
3799 int sandybridge_pcode_read(struct drm_i915_private *dev_priv, u32 mbox, u32 *val);
3800 int sandybridge_pcode_write(struct drm_i915_private *dev_priv, u32 mbox, u32 val);
3801 int skl_pcode_request(struct drm_i915_private *dev_priv, u32 mbox, u32 request,
3802                       u32 reply_mask, u32 reply, int timeout_base_ms);
3803
3804 /* intel_sideband.c */
3805 u32 vlv_punit_read(struct drm_i915_private *dev_priv, u32 addr);
3806 int vlv_punit_write(struct drm_i915_private *dev_priv, u32 addr, u32 val);
3807 u32 vlv_nc_read(struct drm_i915_private *dev_priv, u8 addr);
3808 u32 vlv_iosf_sb_read(struct drm_i915_private *dev_priv, u8 port, u32 reg);
3809 void vlv_iosf_sb_write(struct drm_i915_private *dev_priv, u8 port, u32 reg, u32 val);
3810 u32 vlv_cck_read(struct drm_i915_private *dev_priv, u32 reg);
3811 void vlv_cck_write(struct drm_i915_private *dev_priv, u32 reg, u32 val);
3812 u32 vlv_ccu_read(struct drm_i915_private *dev_priv, u32 reg);
3813 void vlv_ccu_write(struct drm_i915_private *dev_priv, u32 reg, u32 val);
3814 u32 vlv_bunit_read(struct drm_i915_private *dev_priv, u32 reg);
3815 void vlv_bunit_write(struct drm_i915_private *dev_priv, u32 reg, u32 val);
3816 u32 vlv_dpio_read(struct drm_i915_private *dev_priv, enum pipe pipe, int reg);
3817 void vlv_dpio_write(struct drm_i915_private *dev_priv, enum pipe pipe, int reg, u32 val);
3818 u32 intel_sbi_read(struct drm_i915_private *dev_priv, u16 reg,
3819                    enum intel_sbi_destination destination);
3820 void intel_sbi_write(struct drm_i915_private *dev_priv, u16 reg, u32 value,
3821                      enum intel_sbi_destination destination);
3822 u32 vlv_flisdsi_read(struct drm_i915_private *dev_priv, u32 reg);
3823 void vlv_flisdsi_write(struct drm_i915_private *dev_priv, u32 reg, u32 val);
3824
3825 /* intel_dpio_phy.c */
3826 void bxt_port_to_phy_channel(struct drm_i915_private *dev_priv, enum port port,
3827                              enum dpio_phy *phy, enum dpio_channel *ch);
3828 void bxt_ddi_phy_set_signal_level(struct drm_i915_private *dev_priv,
3829                                   enum port port, u32 margin, u32 scale,
3830                                   u32 enable, u32 deemphasis);
3831 void bxt_ddi_phy_init(struct drm_i915_private *dev_priv, enum dpio_phy phy);
3832 void bxt_ddi_phy_uninit(struct drm_i915_private *dev_priv, enum dpio_phy phy);
3833 bool bxt_ddi_phy_is_enabled(struct drm_i915_private *dev_priv,
3834                             enum dpio_phy phy);
3835 bool bxt_ddi_phy_verify_state(struct drm_i915_private *dev_priv,
3836                               enum dpio_phy phy);
3837 uint8_t bxt_ddi_phy_calc_lane_lat_optim_mask(struct intel_encoder *encoder,
3838                                              uint8_t lane_count);
3839 void bxt_ddi_phy_set_lane_optim_mask(struct intel_encoder *encoder,
3840                                      uint8_t lane_lat_optim_mask);
3841 uint8_t bxt_ddi_phy_get_lane_lat_optim_mask(struct intel_encoder *encoder);
3842
3843 void chv_set_phy_signal_level(struct intel_encoder *encoder,
3844                               u32 deemph_reg_value, u32 margin_reg_value,
3845                               bool uniq_trans_scale);
3846 void chv_data_lane_soft_reset(struct intel_encoder *encoder,
3847                               bool reset);
3848 void chv_phy_pre_pll_enable(struct intel_encoder *encoder);
3849 void chv_phy_pre_encoder_enable(struct intel_encoder *encoder);
3850 void chv_phy_release_cl2_override(struct intel_encoder *encoder);
3851 void chv_phy_post_pll_disable(struct intel_encoder *encoder);
3852
3853 void vlv_set_phy_signal_level(struct intel_encoder *encoder,
3854                               u32 demph_reg_value, u32 preemph_reg_value,
3855                               u32 uniqtranscale_reg_value, u32 tx3_demph);
3856 void vlv_phy_pre_pll_enable(struct intel_encoder *encoder);
3857 void vlv_phy_pre_encoder_enable(struct intel_encoder *encoder);
3858 void vlv_phy_reset_lanes(struct intel_encoder *encoder);
3859
3860 int intel_gpu_freq(struct drm_i915_private *dev_priv, int val);
3861 int intel_freq_opcode(struct drm_i915_private *dev_priv, int val);
3862
3863 #define I915_READ8(reg)         dev_priv->uncore.funcs.mmio_readb(dev_priv, (reg), true)
3864 #define I915_WRITE8(reg, val)   dev_priv->uncore.funcs.mmio_writeb(dev_priv, (reg), (val), true)
3865
3866 #define I915_READ16(reg)        dev_priv->uncore.funcs.mmio_readw(dev_priv, (reg), true)
3867 #define I915_WRITE16(reg, val)  dev_priv->uncore.funcs.mmio_writew(dev_priv, (reg), (val), true)
3868 #define I915_READ16_NOTRACE(reg)        dev_priv->uncore.funcs.mmio_readw(dev_priv, (reg), false)
3869 #define I915_WRITE16_NOTRACE(reg, val)  dev_priv->uncore.funcs.mmio_writew(dev_priv, (reg), (val), false)
3870
3871 #define I915_READ(reg)          dev_priv->uncore.funcs.mmio_readl(dev_priv, (reg), true)
3872 #define I915_WRITE(reg, val)    dev_priv->uncore.funcs.mmio_writel(dev_priv, (reg), (val), true)
3873 #define I915_READ_NOTRACE(reg)          dev_priv->uncore.funcs.mmio_readl(dev_priv, (reg), false)
3874 #define I915_WRITE_NOTRACE(reg, val)    dev_priv->uncore.funcs.mmio_writel(dev_priv, (reg), (val), false)
3875
3876 /* Be very careful with read/write 64-bit values. On 32-bit machines, they
3877  * will be implemented using 2 32-bit writes in an arbitrary order with
3878  * an arbitrary delay between them. This can cause the hardware to
3879  * act upon the intermediate value, possibly leading to corruption and
3880  * machine death. For this reason we do not support I915_WRITE64, or
3881  * dev_priv->uncore.funcs.mmio_writeq.
3882  *
3883  * When reading a 64-bit value as two 32-bit values, the delay may cause
3884  * the two reads to mismatch, e.g. a timestamp overflowing. Also note that
3885  * occasionally a 64-bit register does not actualy support a full readq
3886  * and must be read using two 32-bit reads.
3887  *
3888  * You have been warned.
3889  */
3890 #define I915_READ64(reg)        dev_priv->uncore.funcs.mmio_readq(dev_priv, (reg), true)
3891
3892 #define I915_READ64_2x32(lower_reg, upper_reg) ({                       \
3893         u32 upper, lower, old_upper, loop = 0;                          \
3894         upper = I915_READ(upper_reg);                                   \
3895         do {                                                            \
3896                 old_upper = upper;                                      \
3897                 lower = I915_READ(lower_reg);                           \
3898                 upper = I915_READ(upper_reg);                           \
3899         } while (upper != old_upper && loop++ < 2);                     \
3900         (u64)upper << 32 | lower; })
3901
3902 #define POSTING_READ(reg)       (void)I915_READ_NOTRACE(reg)
3903 #define POSTING_READ16(reg)     (void)I915_READ16_NOTRACE(reg)
3904
3905 #define __raw_read(x, s) \
3906 static inline uint##x##_t __raw_i915_read##x(struct drm_i915_private *dev_priv, \
3907                                              i915_reg_t reg) \
3908 { \
3909         return read##s(dev_priv->regs + i915_mmio_reg_offset(reg)); \
3910 }
3911
3912 #define __raw_write(x, s) \
3913 static inline void __raw_i915_write##x(struct drm_i915_private *dev_priv, \
3914                                        i915_reg_t reg, uint##x##_t val) \
3915 { \
3916         write##s(val, dev_priv->regs + i915_mmio_reg_offset(reg)); \
3917 }
3918 __raw_read(8, b)
3919 __raw_read(16, w)
3920 __raw_read(32, l)
3921 __raw_read(64, q)
3922
3923 __raw_write(8, b)
3924 __raw_write(16, w)
3925 __raw_write(32, l)
3926 __raw_write(64, q)
3927
3928 #undef __raw_read
3929 #undef __raw_write
3930
3931 /* These are untraced mmio-accessors that are only valid to be used inside
3932  * critical sections, such as inside IRQ handlers, where forcewake is explicitly
3933  * controlled.
3934  *
3935  * Think twice, and think again, before using these.
3936  *
3937  * As an example, these accessors can possibly be used between:
3938  *
3939  * spin_lock_irq(&dev_priv->uncore.lock);
3940  * intel_uncore_forcewake_get__locked();
3941  *
3942  * and
3943  *
3944  * intel_uncore_forcewake_put__locked();
3945  * spin_unlock_irq(&dev_priv->uncore.lock);
3946  *
3947  *
3948  * Note: some registers may not need forcewake held, so
3949  * intel_uncore_forcewake_{get,put} can be omitted, see
3950  * intel_uncore_forcewake_for_reg().
3951  *
3952  * Certain architectures will die if the same cacheline is concurrently accessed
3953  * by different clients (e.g. on Ivybridge). Access to registers should
3954  * therefore generally be serialised, by either the dev_priv->uncore.lock or
3955  * a more localised lock guarding all access to that bank of registers.
3956  */
3957 #define I915_READ_FW(reg__) __raw_i915_read32(dev_priv, (reg__))
3958 #define I915_WRITE_FW(reg__, val__) __raw_i915_write32(dev_priv, (reg__), (val__))
3959 #define I915_WRITE64_FW(reg__, val__) __raw_i915_write64(dev_priv, (reg__), (val__))
3960 #define POSTING_READ_FW(reg__) (void)I915_READ_FW(reg__)
3961
3962 /* "Broadcast RGB" property */
3963 #define INTEL_BROADCAST_RGB_AUTO 0
3964 #define INTEL_BROADCAST_RGB_FULL 1
3965 #define INTEL_BROADCAST_RGB_LIMITED 2
3966
3967 static inline i915_reg_t i915_vgacntrl_reg(struct drm_i915_private *dev_priv)
3968 {
3969         if (IS_VALLEYVIEW(dev_priv) || IS_CHERRYVIEW(dev_priv))
3970                 return VLV_VGACNTRL;
3971         else if (INTEL_GEN(dev_priv) >= 5)
3972                 return CPU_VGACNTRL;
3973         else
3974                 return VGACNTRL;
3975 }
3976
3977 static inline unsigned long msecs_to_jiffies_timeout(const unsigned int m)
3978 {
3979         unsigned long j = msecs_to_jiffies(m);
3980
3981         return min_t(unsigned long, MAX_JIFFY_OFFSET, j + 1);
3982 }
3983
3984 static inline unsigned long nsecs_to_jiffies_timeout(const u64 n)
3985 {
3986         return min_t(u64, MAX_JIFFY_OFFSET, nsecs_to_jiffies64(n) + 1);
3987 }
3988
3989 static inline unsigned long
3990 timespec_to_jiffies_timeout(const struct timespec *value)
3991 {
3992         unsigned long j = timespec_to_jiffies(value);
3993
3994         return min_t(unsigned long, MAX_JIFFY_OFFSET, j + 1);
3995 }
3996
3997 /*
3998  * If you need to wait X milliseconds between events A and B, but event B
3999  * doesn't happen exactly after event A, you record the timestamp (jiffies) of
4000  * when event A happened, then just before event B you call this function and
4001  * pass the timestamp as the first argument, and X as the second argument.
4002  */
4003 static inline void
4004 wait_remaining_ms_from_jiffies(unsigned long timestamp_jiffies, int to_wait_ms)
4005 {
4006         unsigned long target_jiffies, tmp_jiffies, remaining_jiffies;
4007
4008         /*
4009          * Don't re-read the value of "jiffies" every time since it may change
4010          * behind our back and break the math.
4011          */
4012         tmp_jiffies = jiffies;
4013         target_jiffies = timestamp_jiffies +
4014                          msecs_to_jiffies_timeout(to_wait_ms);
4015
4016         if (time_after(target_jiffies, tmp_jiffies)) {
4017                 remaining_jiffies = target_jiffies - tmp_jiffies;
4018                 while (remaining_jiffies)
4019                         remaining_jiffies =
4020                             schedule_timeout_uninterruptible(remaining_jiffies);
4021         }
4022 }
4023
4024 static inline bool
4025 __i915_request_irq_complete(const struct drm_i915_gem_request *req)
4026 {
4027         struct intel_engine_cs *engine = req->engine;
4028         u32 seqno;
4029
4030         /* Note that the engine may have wrapped around the seqno, and
4031          * so our request->global_seqno will be ahead of the hardware,
4032          * even though it completed the request before wrapping. We catch
4033          * this by kicking all the waiters before resetting the seqno
4034          * in hardware, and also signal the fence.
4035          */
4036         if (test_bit(DMA_FENCE_FLAG_SIGNALED_BIT, &req->fence.flags))
4037                 return true;
4038
4039         /* The request was dequeued before we were awoken. We check after
4040          * inspecting the hw to confirm that this was the same request
4041          * that generated the HWS update. The memory barriers within
4042          * the request execution are sufficient to ensure that a check
4043          * after reading the value from hw matches this request.
4044          */
4045         seqno = i915_gem_request_global_seqno(req);
4046         if (!seqno)
4047                 return false;
4048
4049         /* Before we do the heavier coherent read of the seqno,
4050          * check the value (hopefully) in the CPU cacheline.
4051          */
4052         if (__i915_gem_request_completed(req, seqno))
4053                 return true;
4054
4055         /* Ensure our read of the seqno is coherent so that we
4056          * do not "miss an interrupt" (i.e. if this is the last
4057          * request and the seqno write from the GPU is not visible
4058          * by the time the interrupt fires, we will see that the
4059          * request is incomplete and go back to sleep awaiting
4060          * another interrupt that will never come.)
4061          *
4062          * Strictly, we only need to do this once after an interrupt,
4063          * but it is easier and safer to do it every time the waiter
4064          * is woken.
4065          */
4066         if (engine->irq_seqno_barrier &&
4067             test_and_clear_bit(ENGINE_IRQ_BREADCRUMB, &engine->irq_posted)) {
4068                 struct intel_breadcrumbs *b = &engine->breadcrumbs;
4069                 unsigned long flags;
4070
4071                 /* The ordering of irq_posted versus applying the barrier
4072                  * is crucial. The clearing of the current irq_posted must
4073                  * be visible before we perform the barrier operation,
4074                  * such that if a subsequent interrupt arrives, irq_posted
4075                  * is reasserted and our task rewoken (which causes us to
4076                  * do another __i915_request_irq_complete() immediately
4077                  * and reapply the barrier). Conversely, if the clear
4078                  * occurs after the barrier, then an interrupt that arrived
4079                  * whilst we waited on the barrier would not trigger a
4080                  * barrier on the next pass, and the read may not see the
4081                  * seqno update.
4082                  */
4083                 engine->irq_seqno_barrier(engine);
4084
4085                 /* If we consume the irq, but we are no longer the bottom-half,
4086                  * the real bottom-half may not have serialised their own
4087                  * seqno check with the irq-barrier (i.e. may have inspected
4088                  * the seqno before we believe it coherent since they see
4089                  * irq_posted == false but we are still running).
4090                  */
4091                 spin_lock_irqsave(&b->lock, flags);
4092                 if (b->first_wait && b->first_wait->tsk != current)
4093                         /* Note that if the bottom-half is changed as we
4094                          * are sending the wake-up, the new bottom-half will
4095                          * be woken by whomever made the change. We only have
4096                          * to worry about when we steal the irq-posted for
4097                          * ourself.
4098                          */
4099                         wake_up_process(b->first_wait->tsk);
4100                 spin_unlock_irqrestore(&b->lock, flags);
4101
4102                 if (__i915_gem_request_completed(req, seqno))
4103                         return true;
4104         }
4105
4106         return false;
4107 }
4108
4109 void i915_memcpy_init_early(struct drm_i915_private *dev_priv);
4110 bool i915_memcpy_from_wc(void *dst, const void *src, unsigned long len);
4111
4112 /* The movntdqa instructions used for memcpy-from-wc require 16-byte alignment,
4113  * as well as SSE4.1 support. i915_memcpy_from_wc() will report if it cannot
4114  * perform the operation. To check beforehand, pass in the parameters to
4115  * to i915_can_memcpy_from_wc() - since we only care about the low 4 bits,
4116  * you only need to pass in the minor offsets, page-aligned pointers are
4117  * always valid.
4118  *
4119  * For just checking for SSE4.1, in the foreknowledge that the future use
4120  * will be correctly aligned, just use i915_has_memcpy_from_wc().
4121  */
4122 #define i915_can_memcpy_from_wc(dst, src, len) \
4123         i915_memcpy_from_wc((void *)((unsigned long)(dst) | (unsigned long)(src) | (len)), NULL, 0)
4124
4125 #define i915_has_memcpy_from_wc() \
4126         i915_memcpy_from_wc(NULL, NULL, 0)
4127
4128 /* i915_mm.c */
4129 int remap_io_mapping(struct vm_area_struct *vma,
4130                      unsigned long addr, unsigned long pfn, unsigned long size,
4131                      struct io_mapping *iomap);
4132
4133 static inline bool i915_gem_object_is_coherent(struct drm_i915_gem_object *obj)
4134 {
4135         return (obj->cache_level != I915_CACHE_NONE ||
4136                 HAS_LLC(to_i915(obj->base.dev)));
4137 }
4138
4139 #endif