]> git.proxmox.com Git - mirror_ubuntu-bionic-kernel.git/blame - drivers/gpu/drm/i915/intel_drv.h
drm/i915: Pass intel_crtc to DDI functions called from crtc en/disable
[mirror_ubuntu-bionic-kernel.git] / drivers / gpu / drm / i915 / intel_drv.h
CommitLineData
79e53945
JB
1/*
2 * Copyright (c) 2006 Dave Airlie <airlied@linux.ie>
3 * Copyright (c) 2007-2008 Intel Corporation
4 * Jesse Barnes <jesse.barnes@intel.com>
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the "Software"),
8 * to deal in the Software without restriction, including without limitation
9 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10 * and/or sell copies of the Software, and to permit persons to whom the
11 * Software is furnished to do so, subject to the following conditions:
12 *
13 * The above copyright notice and this permission notice (including the next
14 * paragraph) shall be included in all copies or substantial portions of the
15 * Software.
16 *
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
22 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
23 * IN THE SOFTWARE.
24 */
25#ifndef __INTEL_DRV_H__
26#define __INTEL_DRV_H__
27
d1d70677 28#include <linux/async.h>
79e53945 29#include <linux/i2c.h>
178f736a 30#include <linux/hdmi.h>
760285e7 31#include <drm/i915_drm.h>
80824003 32#include "i915_drv.h"
760285e7
DH
33#include <drm/drm_crtc.h>
34#include <drm/drm_crtc_helper.h>
9338203c 35#include <drm/drm_encoder.h>
760285e7 36#include <drm/drm_fb_helper.h>
b1ba124d 37#include <drm/drm_dp_dual_mode_helper.h>
0e32b39c 38#include <drm/drm_dp_mst_helper.h>
eeca778a 39#include <drm/drm_rect.h>
10f81c19 40#include <drm/drm_atomic.h>
913d8d11 41
1d5bfac9
DV
42/**
43 * _wait_for - magic (register) wait macro
44 *
45 * Does the right thing for modeset paths when run under kdgb or similar atomic
46 * contexts. Note that it's important that we check the condition again after
47 * having timed out, since the timeout could be due to preemption or similar and
48 * we've never had a chance to check the condition before the timeout.
0351b939
TU
49 *
50 * TODO: When modesetting has fully transitioned to atomic, the below
51 * drm_can_sleep() can be removed and in_atomic()/!in_atomic() asserts
52 * added.
1d5bfac9 53 */
3f177625
TU
54#define _wait_for(COND, US, W) ({ \
55 unsigned long timeout__ = jiffies + usecs_to_jiffies(US) + 1; \
b0876afd
DG
56 int ret__; \
57 for (;;) { \
58 bool expired__ = time_after(jiffies, timeout__); \
59 if (COND) { \
60 ret__ = 0; \
61 break; \
62 } \
63 if (expired__) { \
64 ret__ = -ETIMEDOUT; \
913d8d11
CW
65 break; \
66 } \
9848de08 67 if ((W) && drm_can_sleep()) { \
3f177625 68 usleep_range((W), (W)*2); \
0cc2764c
BW
69 } else { \
70 cpu_relax(); \
71 } \
913d8d11
CW
72 } \
73 ret__; \
74})
75
3f177625 76#define wait_for(COND, MS) _wait_for((COND), (MS) * 1000, 1000)
3f177625 77
0351b939
TU
78/* If CONFIG_PREEMPT_COUNT is disabled, in_atomic() always reports false. */
79#if defined(CONFIG_DRM_I915_DEBUG) && defined(CONFIG_PREEMPT_COUNT)
18f4b843 80# define _WAIT_FOR_ATOMIC_CHECK(ATOMIC) WARN_ON_ONCE((ATOMIC) && !in_atomic())
0351b939 81#else
18f4b843 82# define _WAIT_FOR_ATOMIC_CHECK(ATOMIC) do { } while (0)
0351b939
TU
83#endif
84
18f4b843
TU
85#define _wait_for_atomic(COND, US, ATOMIC) \
86({ \
87 int cpu, ret, timeout = (US) * 1000; \
88 u64 base; \
89 _WAIT_FOR_ATOMIC_CHECK(ATOMIC); \
0351b939 90 BUILD_BUG_ON((US) > 50000); \
18f4b843
TU
91 if (!(ATOMIC)) { \
92 preempt_disable(); \
93 cpu = smp_processor_id(); \
94 } \
95 base = local_clock(); \
96 for (;;) { \
97 u64 now = local_clock(); \
98 if (!(ATOMIC)) \
99 preempt_enable(); \
100 if (COND) { \
101 ret = 0; \
102 break; \
103 } \
104 if (now - base >= timeout) { \
105 ret = -ETIMEDOUT; \
0351b939
TU
106 break; \
107 } \
108 cpu_relax(); \
18f4b843
TU
109 if (!(ATOMIC)) { \
110 preempt_disable(); \
111 if (unlikely(cpu != smp_processor_id())) { \
112 timeout -= now - base; \
113 cpu = smp_processor_id(); \
114 base = local_clock(); \
115 } \
116 } \
0351b939 117 } \
18f4b843
TU
118 ret; \
119})
120
121#define wait_for_us(COND, US) \
122({ \
123 int ret__; \
124 BUILD_BUG_ON(!__builtin_constant_p(US)); \
125 if ((US) > 10) \
126 ret__ = _wait_for((COND), (US), 10); \
127 else \
128 ret__ = _wait_for_atomic((COND), (US), 0); \
0351b939
TU
129 ret__; \
130})
131
18f4b843
TU
132#define wait_for_atomic(COND, MS) _wait_for_atomic((COND), (MS) * 1000, 1)
133#define wait_for_atomic_us(COND, US) _wait_for_atomic((COND), (US), 1)
481b6af3 134
49938ac4
JN
135#define KHz(x) (1000 * (x))
136#define MHz(x) KHz(1000 * (x))
021357ac 137
79e53945
JB
138/*
139 * Display related stuff
140 */
141
142/* store information about an Ixxx DVO */
143/* The i830->i865 use multiple DVOs with multiple i2cs */
144/* the i915, i945 have a single sDVO i2c bus - which is different */
145#define MAX_OUTPUTS 6
146/* maximum connectors per crtcs in the mode set */
79e53945 147
4726e0b0
SK
148/* Maximum cursor sizes */
149#define GEN2_CURSOR_WIDTH 64
150#define GEN2_CURSOR_HEIGHT 64
068be561
DL
151#define MAX_CURSOR_WIDTH 256
152#define MAX_CURSOR_HEIGHT 256
4726e0b0 153
79e53945
JB
154#define INTEL_I2C_BUS_DVO 1
155#define INTEL_I2C_BUS_SDVO 2
156
157/* these are outputs from the chip - integrated only
158 external chips are via DVO or SDVO output */
6847d71b
PZ
159enum intel_output_type {
160 INTEL_OUTPUT_UNUSED = 0,
161 INTEL_OUTPUT_ANALOG = 1,
162 INTEL_OUTPUT_DVO = 2,
163 INTEL_OUTPUT_SDVO = 3,
164 INTEL_OUTPUT_LVDS = 4,
165 INTEL_OUTPUT_TVOUT = 5,
166 INTEL_OUTPUT_HDMI = 6,
cca0502b 167 INTEL_OUTPUT_DP = 7,
6847d71b
PZ
168 INTEL_OUTPUT_EDP = 8,
169 INTEL_OUTPUT_DSI = 9,
170 INTEL_OUTPUT_UNKNOWN = 10,
171 INTEL_OUTPUT_DP_MST = 11,
172};
79e53945
JB
173
174#define INTEL_DVO_CHIP_NONE 0
175#define INTEL_DVO_CHIP_LVDS 1
176#define INTEL_DVO_CHIP_TMDS 2
177#define INTEL_DVO_CHIP_TVOUT 4
178
dfba2e2d
SK
179#define INTEL_DSI_VIDEO_MODE 0
180#define INTEL_DSI_COMMAND_MODE 1
72ffa333 181
79e53945
JB
182struct intel_framebuffer {
183 struct drm_framebuffer base;
05394f39 184 struct drm_i915_gem_object *obj;
2d7a215f 185 struct intel_rotation_info rot_info;
6687c906
VS
186
187 /* for each plane in the normal GTT view */
188 struct {
189 unsigned int x, y;
190 } normal[2];
191 /* for each plane in the rotated GTT view */
192 struct {
193 unsigned int x, y;
194 unsigned int pitch; /* pixels */
195 } rotated[2];
79e53945
JB
196};
197
37811fcc
CW
198struct intel_fbdev {
199 struct drm_fb_helper helper;
8bcd4553 200 struct intel_framebuffer *fb;
058d88c4 201 struct i915_vma *vma;
43cee314 202 async_cookie_t cookie;
d978ef14 203 int preferred_bpp;
37811fcc 204};
79e53945 205
21d40d37 206struct intel_encoder {
4ef69c7a 207 struct drm_encoder base;
9a935856 208
6847d71b 209 enum intel_output_type type;
03cdc1d4 210 enum port port;
bc079e8b 211 unsigned int cloneable;
21d40d37 212 void (*hot_plug)(struct intel_encoder *);
7ae89233 213 bool (*compute_config)(struct intel_encoder *,
0a478c27
ML
214 struct intel_crtc_state *,
215 struct drm_connector_state *);
fd6bbda9
ML
216 void (*pre_pll_enable)(struct intel_encoder *,
217 struct intel_crtc_state *,
218 struct drm_connector_state *);
219 void (*pre_enable)(struct intel_encoder *,
220 struct intel_crtc_state *,
221 struct drm_connector_state *);
222 void (*enable)(struct intel_encoder *,
223 struct intel_crtc_state *,
224 struct drm_connector_state *);
225 void (*disable)(struct intel_encoder *,
226 struct intel_crtc_state *,
227 struct drm_connector_state *);
228 void (*post_disable)(struct intel_encoder *,
229 struct intel_crtc_state *,
230 struct drm_connector_state *);
231 void (*post_pll_disable)(struct intel_encoder *,
232 struct intel_crtc_state *,
233 struct drm_connector_state *);
f0947c37
DV
234 /* Read out the current hw state of this connector, returning true if
235 * the encoder is active. If the encoder is enabled it also set the pipe
236 * it is connected to in the pipe parameter. */
237 bool (*get_hw_state)(struct intel_encoder *, enum pipe *pipe);
045ac3b5 238 /* Reconstructs the equivalent mode flags for the current hardware
fdafa9e2 239 * state. This must be called _after_ display->get_pipe_config has
63000ef6
XZ
240 * pre-filled the pipe config. Note that intel_encoder->base.crtc must
241 * be set correctly before calling this function. */
045ac3b5 242 void (*get_config)(struct intel_encoder *,
5cec258b 243 struct intel_crtc_state *pipe_config);
62b69566
ACO
244 /* Returns a mask of power domains that need to be referenced as part
245 * of the hardware state readout code. */
246 u64 (*get_power_domains)(struct intel_encoder *encoder);
07f9cd0b
ID
247 /*
248 * Called during system suspend after all pending requests for the
249 * encoder are flushed (for example for DP AUX transactions) and
250 * device interrupts are disabled.
251 */
252 void (*suspend)(struct intel_encoder *);
f8aed700 253 int crtc_mask;
1d843f9d 254 enum hpd_pin hpd_pin;
79f255a0 255 enum intel_display_power_domain power_domain;
f1a3acea
PD
256 /* for communication with audio component; protected by av_mutex */
257 const struct drm_connector *audio_connector;
79e53945
JB
258};
259
1d508706 260struct intel_panel {
dd06f90e 261 struct drm_display_mode *fixed_mode;
ec9ed197 262 struct drm_display_mode *downclock_mode;
4d891523 263 int fitting_mode;
58c68779
JN
264
265 /* backlight */
266 struct {
c91c9f32 267 bool present;
58c68779 268 u32 level;
6dda730e 269 u32 min;
7bd688cd 270 u32 max;
58c68779 271 bool enabled;
636baebf
JN
272 bool combination_mode; /* gen 2/4 only */
273 bool active_low_pwm;
32b421e7 274 bool alternate_pwm_increment; /* lpt+ */
b029e66f
SK
275
276 /* PWM chip */
022e4e52
SK
277 bool util_pin_active_low; /* bxt+ */
278 u8 controller; /* bxt+ only */
b029e66f
SK
279 struct pwm_device *pwm;
280
58c68779 281 struct backlight_device *device;
ab656bb9 282
5507faeb
JN
283 /* Connector and platform specific backlight functions */
284 int (*setup)(struct intel_connector *connector, enum pipe pipe);
285 uint32_t (*get)(struct intel_connector *connector);
286 void (*set)(struct intel_connector *connector, uint32_t level);
287 void (*disable)(struct intel_connector *connector);
288 void (*enable)(struct intel_connector *connector);
289 uint32_t (*hz_to_pwm)(struct intel_connector *connector,
290 uint32_t hz);
291 void (*power)(struct intel_connector *, bool enable);
292 } backlight;
1d508706
JN
293};
294
5daa55eb
ZW
295struct intel_connector {
296 struct drm_connector base;
9a935856
DV
297 /*
298 * The fixed encoder this connector is connected to.
299 */
df0e9248 300 struct intel_encoder *encoder;
9a935856 301
8e1b56a4
JN
302 /* ACPI device id for ACPI and driver cooperation */
303 u32 acpi_device_id;
304
f0947c37
DV
305 /* Reads out the current hw, returning true if the connector is enabled
306 * and active (i.e. dpms ON state). */
307 bool (*get_hw_state)(struct intel_connector *);
1d508706
JN
308
309 /* Panel info for eDP and LVDS */
310 struct intel_panel panel;
9cd300e0
JN
311
312 /* Cached EDID for eDP and LVDS. May hold ERR_PTR for invalid EDID. */
313 struct edid *edid;
beb60608 314 struct edid *detect_edid;
821450c6
EE
315
316 /* since POLL and HPD connectors may use the same HPD line keep the native
317 state of connector->polled in case hotplug storm detection changes it */
318 u8 polled;
0e32b39c
DA
319
320 void *port; /* store this opaque as its illegal to dereference it */
321
322 struct intel_dp *mst_port;
5daa55eb
ZW
323};
324
9e2c8475 325struct dpll {
80ad9206
VS
326 /* given values */
327 int n;
328 int m1, m2;
329 int p1, p2;
330 /* derived values */
331 int dot;
332 int vco;
333 int m;
334 int p;
9e2c8475 335};
80ad9206 336
de419ab6
ML
337struct intel_atomic_state {
338 struct drm_atomic_state base;
339
bb0f4aab
VS
340 struct {
341 /*
342 * Logical state of cdclk (used for all scaling, watermark,
343 * etc. calculations and checks). This is computed as if all
344 * enabled crtcs were active.
345 */
346 struct intel_cdclk_state logical;
347
348 /*
349 * Actual state of cdclk, can be different from the logical
350 * state only when all crtc's are DPMS off.
351 */
352 struct intel_cdclk_state actual;
353 } cdclk;
1a617b77 354
565602d7
ML
355 bool dpll_set, modeset;
356
8b4a7d05
MR
357 /*
358 * Does this transaction change the pipes that are active? This mask
359 * tracks which CRTC's have changed their active state at the end of
360 * the transaction (not counting the temporary disable during modesets).
361 * This mask should only be non-zero when intel_state->modeset is true,
362 * but the converse is not necessarily true; simply changing a mode may
363 * not flip the final active status of any CRTC's
364 */
365 unsigned int active_pipe_changes;
366
565602d7
ML
367 unsigned int active_crtcs;
368 unsigned int min_pixclk[I915_MAX_PIPES];
369
2c42e535 370 struct intel_shared_dpll_state shared_dpll[I915_NUM_PLLS];
ed4a6a7c
MR
371
372 /*
373 * Current watermarks can't be trusted during hardware readout, so
374 * don't bother calculating intermediate watermarks.
375 */
376 bool skip_intermediate_wm;
98d39494
MR
377
378 /* Gen9+ only */
734fa01f 379 struct skl_wm_values wm_results;
c004a90b
CW
380
381 struct i915_sw_fence commit_ready;
eb955eee
CW
382
383 struct llist_node freed;
de419ab6
ML
384};
385
eeca778a 386struct intel_plane_state {
2b875c22 387 struct drm_plane_state base;
eeca778a 388 struct drm_rect clip;
be1e3415 389 struct i915_vma *vma;
32b7eeec 390
b63a16f6
VS
391 struct {
392 u32 offset;
393 int x, y;
394 } main;
8d970654
VS
395 struct {
396 u32 offset;
397 int x, y;
398 } aux;
b63a16f6 399
be41e336
CK
400 /*
401 * scaler_id
402 * = -1 : not using a scaler
403 * >= 0 : using a scalers
404 *
405 * plane requiring a scaler:
406 * - During check_plane, its bit is set in
407 * crtc_state->scaler_state.scaler_users by calling helper function
86adf9d7 408 * update_scaler_plane.
be41e336
CK
409 * - scaler_id indicates the scaler it got assigned.
410 *
411 * plane doesn't require a scaler:
412 * - this can happen when scaling is no more required or plane simply
413 * got disabled.
414 * - During check_plane, corresponding bit is reset in
415 * crtc_state->scaler_state.scaler_users by calling helper function
86adf9d7 416 * update_scaler_plane.
be41e336
CK
417 */
418 int scaler_id;
818ed961
ML
419
420 struct drm_intel_sprite_colorkey ckey;
eeca778a
GP
421};
422
5724dbd1 423struct intel_initial_plane_config {
2d14030b 424 struct intel_framebuffer *fb;
49af449b 425 unsigned int tiling;
46f297fb
JB
426 int size;
427 u32 base;
428};
429
be41e336
CK
430#define SKL_MIN_SRC_W 8
431#define SKL_MAX_SRC_W 4096
432#define SKL_MIN_SRC_H 8
6156a456 433#define SKL_MAX_SRC_H 4096
be41e336
CK
434#define SKL_MIN_DST_W 8
435#define SKL_MAX_DST_W 4096
436#define SKL_MIN_DST_H 8
6156a456 437#define SKL_MAX_DST_H 4096
be41e336
CK
438
439struct intel_scaler {
be41e336
CK
440 int in_use;
441 uint32_t mode;
442};
443
444struct intel_crtc_scaler_state {
445#define SKL_NUM_SCALERS 2
446 struct intel_scaler scalers[SKL_NUM_SCALERS];
447
448 /*
449 * scaler_users: keeps track of users requesting scalers on this crtc.
450 *
451 * If a bit is set, a user is using a scaler.
452 * Here user can be a plane or crtc as defined below:
453 * bits 0-30 - plane (bit position is index from drm_plane_index)
454 * bit 31 - crtc
455 *
456 * Instead of creating a new index to cover planes and crtc, using
457 * existing drm_plane_index for planes which is well less than 31
458 * planes and bit 31 for crtc. This should be fine to cover all
459 * our platforms.
460 *
461 * intel_atomic_setup_scalers will setup available scalers to users
462 * requesting scalers. It will gracefully fail if request exceeds
463 * avilability.
464 */
465#define SKL_CRTC_INDEX 31
466 unsigned scaler_users;
467
468 /* scaler used by crtc for panel fitting purpose */
469 int scaler_id;
470};
471
1ed51de9
DV
472/* drm_mode->private_flags */
473#define I915_MODE_FLAG_INHERITED 1
474
4e0963c7
MR
475struct intel_pipe_wm {
476 struct intel_wm_level wm[5];
71f0a626 477 struct intel_wm_level raw_wm[5];
4e0963c7
MR
478 uint32_t linetime;
479 bool fbc_wm_enabled;
480 bool pipe_enabled;
481 bool sprites_enabled;
482 bool sprites_scaled;
483};
484
a62163e9 485struct skl_plane_wm {
4e0963c7
MR
486 struct skl_wm_level wm[8];
487 struct skl_wm_level trans_wm;
a62163e9
L
488};
489
490struct skl_pipe_wm {
491 struct skl_plane_wm planes[I915_MAX_PLANES];
4e0963c7
MR
492 uint32_t linetime;
493};
494
e8f1f02e
MR
495struct intel_crtc_wm_state {
496 union {
497 struct {
498 /*
499 * Intermediate watermarks; these can be
500 * programmed immediately since they satisfy
501 * both the current configuration we're
502 * switching away from and the new
503 * configuration we're switching to.
504 */
505 struct intel_pipe_wm intermediate;
506
507 /*
508 * Optimal watermarks, programmed post-vblank
509 * when this state is committed.
510 */
511 struct intel_pipe_wm optimal;
512 } ilk;
513
514 struct {
515 /* gen9+ only needs 1-step wm programming */
516 struct skl_pipe_wm optimal;
ce0ba283 517 struct skl_ddb_entry ddb;
e8f1f02e
MR
518 } skl;
519 };
520
521 /*
522 * Platforms with two-step watermark programming will need to
523 * update watermark programming post-vblank to switch from the
524 * safe intermediate watermarks to the optimal final
525 * watermarks.
526 */
527 bool need_postvbl_update;
528};
529
5cec258b 530struct intel_crtc_state {
2d112de7
ACO
531 struct drm_crtc_state base;
532
bb760063
DV
533 /**
534 * quirks - bitfield with hw state readout quirks
535 *
536 * For various reasons the hw state readout code might not be able to
537 * completely faithfully read out the current state. These cases are
538 * tracked with quirk flags so that fastboot and state checker can act
539 * accordingly.
540 */
9953599b 541#define PIPE_CONFIG_QUIRK_MODE_SYNC_FLAGS (1<<0) /* unreliable sync mode.flags */
bb760063
DV
542 unsigned long quirks;
543
cd202f69 544 unsigned fb_bits; /* framebuffers to flip */
ab1d3a0e
ML
545 bool update_pipe; /* can a fast modeset be performed? */
546 bool disable_cxsr;
caed361d 547 bool update_wm_pre, update_wm_post; /* watermarks are updated */
e8861675 548 bool fb_changed; /* fb on any of the planes is changed */
bfd16b2a 549
37327abd
VS
550 /* Pipe source size (ie. panel fitter input size)
551 * All planes will be positioned inside this space,
552 * and get clipped at the edges. */
553 int pipe_src_w, pipe_src_h;
554
a7d1b3f4
VS
555 /*
556 * Pipe pixel rate, adjusted for
557 * panel fitter/pipe scaler downscaling.
558 */
559 unsigned int pixel_rate;
560
5bfe2ac0
DV
561 /* Whether to set up the PCH/FDI. Note that we never allow sharing
562 * between pch encoders and cpu encoders. */
563 bool has_pch_encoder;
50f3b016 564
e43823ec
JB
565 /* Are we sending infoframes on the attached port */
566 bool has_infoframe;
567
3b117c8f 568 /* CPU Transcoder for the pipe. Currently this can only differ from the
4d1de975
JN
569 * pipe on Haswell and later (where we have a special eDP transcoder)
570 * and Broxton (where we have special DSI transcoders). */
3b117c8f
DV
571 enum transcoder cpu_transcoder;
572
50f3b016
DV
573 /*
574 * Use reduced/limited/broadcast rbg range, compressing from the full
575 * range fed into the crtcs.
576 */
577 bool limited_color_range;
578
253c84c8
VS
579 /* Bitmask of encoder types (enum intel_output_type)
580 * driven by the pipe.
581 */
582 unsigned int output_types;
583
6897b4b5
DV
584 /* Whether we should send NULL infoframes. Required for audio. */
585 bool has_hdmi_sink;
586
9ed109a7
DV
587 /* Audio enabled on this pipe. Only valid if either has_hdmi_sink or
588 * has_dp_encoder is set. */
589 bool has_audio;
590
d8b32247
DV
591 /*
592 * Enable dithering, used when the selected pipe bpp doesn't match the
593 * plane bpp.
594 */
965e0c48 595 bool dither;
f47709a9 596
611032bf
MN
597 /*
598 * Dither gets enabled for 18bpp which causes CRC mismatch errors for
599 * compliance video pattern tests.
600 * Disable dither only if it is a compliance test request for
601 * 18bpp.
602 */
603 bool dither_force_disable;
604
f47709a9
DV
605 /* Controls for the clock computation, to override various stages. */
606 bool clock_set;
607
09ede541
DV
608 /* SDVO TV has a bunch of special case. To make multifunction encoders
609 * work correctly, we need to track this at runtime.*/
610 bool sdvo_tv_clock;
611
e29c22c0
DV
612 /*
613 * crtc bandwidth limit, don't increase pipe bpp or clock if not really
614 * required. This is set in the 2nd loop of calling encoder's
615 * ->compute_config if the first pick doesn't work out.
616 */
617 bool bw_constrained;
618
f47709a9
DV
619 /* Settings for the intel dpll used on pretty much everything but
620 * haswell. */
80ad9206 621 struct dpll dpll;
f47709a9 622
8106ddbd
ACO
623 /* Selected dpll when shared or NULL. */
624 struct intel_shared_dpll *shared_dpll;
a43f6e0f 625
66e985c0
DV
626 /* Actual register state of the dpll, for shared dpll cross-checking. */
627 struct intel_dpll_hw_state dpll_hw_state;
628
47eacbab
VS
629 /* DSI PLL registers */
630 struct {
631 u32 ctrl, div;
632 } dsi_pll;
633
965e0c48 634 int pipe_bpp;
6cf86a5e 635 struct intel_link_m_n dp_m_n;
ff9a6750 636
439d7ac0
PB
637 /* m2_n2 for eDP downclock */
638 struct intel_link_m_n dp_m2_n2;
f769cd24 639 bool has_drrs;
439d7ac0 640
ff9a6750
DV
641 /*
642 * Frequence the dpll for the port should run at. Differs from the
3c52f4eb
VS
643 * adjusted dotclock e.g. for DP or 12bpc hdmi mode. This is also
644 * already multiplied by pixel_multiplier.
df92b1e6 645 */
ff9a6750
DV
646 int port_clock;
647
6cc5f341
DV
648 /* Used by SDVO (and if we ever fix it, HDMI). */
649 unsigned pixel_multiplier;
2dd24552 650
90a6b7b0
VS
651 uint8_t lane_count;
652
95a7a2ae
ID
653 /*
654 * Used by platforms having DP/HDMI PHY with programmable lane
655 * latency optimization.
656 */
657 uint8_t lane_lat_optim_mask;
658
2dd24552 659 /* Panel fitter controls for gen2-gen4 + VLV */
b074cec8
JB
660 struct {
661 u32 control;
662 u32 pgm_ratios;
68fc8742 663 u32 lvds_border_bits;
b074cec8
JB
664 } gmch_pfit;
665
666 /* Panel fitter placement and size for Ironlake+ */
667 struct {
668 u32 pos;
669 u32 size;
fd4daa9c 670 bool enabled;
fabf6e51 671 bool force_thru;
b074cec8 672 } pch_pfit;
33d29b14 673
ca3a0ff8 674 /* FDI configuration, only valid if has_pch_encoder is set. */
33d29b14 675 int fdi_lanes;
ca3a0ff8 676 struct intel_link_m_n fdi_m_n;
42db64ef
PZ
677
678 bool ips_enabled;
cf532bb2 679
f51be2e0
PZ
680 bool enable_fbc;
681
cf532bb2 682 bool double_wide;
0e32b39c 683
0e32b39c 684 int pbn;
be41e336
CK
685
686 struct intel_crtc_scaler_state scaler_state;
99d736a2
ML
687
688 /* w/a for waiting 2 vblanks during crtc enable */
689 enum pipe hsw_workaround_pipe;
d21fbe87
MR
690
691 /* IVB sprite scaling w/a (WaCxSRDisabledForSpriteScaling:ivb) */
692 bool disable_lp_wm;
4e0963c7 693
e8f1f02e 694 struct intel_crtc_wm_state wm;
05dc698c
LL
695
696 /* Gamma mode programmed on the pipe */
697 uint32_t gamma_mode;
b8cecdf5
DV
698};
699
262cd2e1
VS
700struct vlv_wm_state {
701 struct vlv_pipe_wm wm[3];
702 struct vlv_sr_wm sr[3];
703 uint8_t num_active_planes;
704 uint8_t num_levels;
705 uint8_t level;
706 bool cxsr;
707};
708
79e53945
JB
709struct intel_crtc {
710 struct drm_crtc base;
80824003
JB
711 enum pipe pipe;
712 enum plane plane;
79e53945 713 u8 lut_r[256], lut_g[256], lut_b[256];
08a48469
DV
714 /*
715 * Whether the crtc and the connected output pipeline is active. Implies
716 * that crtc->enabled is set, i.e. the current mode configuration has
717 * some outputs connected to this crtc.
08a48469
DV
718 */
719 bool active;
652c393a 720 bool lowfreq_avail;
d97d7b48 721 u8 plane_ids_mask;
d8fc70b7 722 unsigned long long enabled_power_domains;
02e792fb 723 struct intel_overlay *overlay;
5a21b665 724 struct intel_flip_work *flip_work;
cda4b7d3 725
b4a98e57
CW
726 atomic_t unpin_work_count;
727
e506a0c6
DV
728 /* Display surface base address adjustement for pageflips. Note that on
729 * gen4+ this only adjusts up to a tile, offsets within a tile are
730 * handled in the hw itself (with the TILEOFF register). */
54ea9da8 731 u32 dspaddr_offset;
2db3366b
PZ
732 int adjusted_x;
733 int adjusted_y;
e506a0c6 734
cda4b7d3 735 uint32_t cursor_addr;
4b0e333e 736 uint32_t cursor_cntl;
dc41c154 737 uint32_t cursor_size;
4b0e333e 738 uint32_t cursor_base;
4b645f14 739
6e3c9717 740 struct intel_crtc_state *config;
b8cecdf5 741
8af29b0c
CW
742 /* global reset count when the last flip was submitted */
743 unsigned int reset_count;
5a21b665 744
8664281b
PZ
745 /* Access to these should be protected by dev_priv->irq_lock. */
746 bool cpu_fifo_underrun_disabled;
747 bool pch_fifo_underrun_disabled;
0b2ae6d7
VS
748
749 /* per-pipe watermark state */
750 struct {
751 /* watermarks currently being used */
4e0963c7
MR
752 union {
753 struct intel_pipe_wm ilk;
4e0963c7 754 } active;
ed4a6a7c 755
852eb00d
VS
756 /* allow CxSR on this pipe */
757 bool cxsr_allowed;
0b2ae6d7 758 } wm;
8d7849db 759
80715b2f 760 int scanline_offset;
32b7eeec 761
eb120ef6
JB
762 struct {
763 unsigned start_vbl_count;
764 ktime_t start_vbl_time;
765 int min_vbl, max_vbl;
766 int scanline_start;
767 } debug;
85a62bf9 768
be41e336
CK
769 /* scalers available on this crtc */
770 int num_scalers;
262cd2e1
VS
771
772 struct vlv_wm_state wm_state;
79e53945
JB
773};
774
c35426d2
VS
775struct intel_plane_wm_parameters {
776 uint32_t horiz_pixels;
ed57cb8a 777 uint32_t vert_pixels;
2cd601c6
CK
778 /*
779 * For packed pixel formats:
780 * bytes_per_pixel - holds bytes per pixel
781 * For planar pixel formats:
782 * bytes_per_pixel - holds bytes per pixel for uv-plane
783 * y_bytes_per_pixel - holds bytes per pixel for y-plane
784 */
c35426d2 785 uint8_t bytes_per_pixel;
2cd601c6 786 uint8_t y_bytes_per_pixel;
c35426d2
VS
787 bool enabled;
788 bool scaled;
0fda6568 789 u64 tiling;
1fc0a8f7 790 unsigned int rotation;
6eb1a681 791 uint16_t fifo_size;
c35426d2
VS
792};
793
b840d907
JB
794struct intel_plane {
795 struct drm_plane base;
b14e5848
VS
796 u8 plane;
797 enum plane_id id;
b840d907 798 enum pipe pipe;
2d354c34 799 bool can_scale;
b840d907 800 int max_downscale;
a9ff8714 801 uint32_t frontbuffer_bit;
526682e9
PZ
802
803 /* Since we need to change the watermarks before/after
804 * enabling/disabling the planes, we need to store the parameters here
805 * as the other pieces of the struct may not reflect the values we want
806 * for the watermark calculations. Currently only Haswell uses this.
807 */
c35426d2 808 struct intel_plane_wm_parameters wm;
526682e9 809
8e7d688b
MR
810 /*
811 * NOTE: Do not place new plane state fields here (e.g., when adding
812 * new plane properties). New runtime state should now be placed in
2fde1391 813 * the intel_plane_state structure and accessed via plane_state.
8e7d688b
MR
814 */
815
b840d907 816 void (*update_plane)(struct drm_plane *plane,
2fde1391
ML
817 const struct intel_crtc_state *crtc_state,
818 const struct intel_plane_state *plane_state);
b39d53f6 819 void (*disable_plane)(struct drm_plane *plane,
7fabf5ef 820 struct drm_crtc *crtc);
c59cb179 821 int (*check_plane)(struct drm_plane *plane,
061e4b8d 822 struct intel_crtc_state *crtc_state,
c59cb179 823 struct intel_plane_state *state);
b840d907
JB
824};
825
b445e3b0 826struct intel_watermark_params {
ae9400ca
TU
827 u16 fifo_size;
828 u16 max_wm;
829 u8 default_wm;
830 u8 guard_size;
831 u8 cacheline_size;
b445e3b0
ED
832};
833
834struct cxsr_latency {
c13fb778
TU
835 bool is_desktop : 1;
836 bool is_ddr3 : 1;
44a655ca
TU
837 u16 fsb_freq;
838 u16 mem_freq;
839 u16 display_sr;
840 u16 display_hpll_disable;
841 u16 cursor_sr;
842 u16 cursor_hpll_disable;
b445e3b0
ED
843};
844
de419ab6 845#define to_intel_atomic_state(x) container_of(x, struct intel_atomic_state, base)
79e53945 846#define to_intel_crtc(x) container_of(x, struct intel_crtc, base)
10f81c19 847#define to_intel_crtc_state(x) container_of(x, struct intel_crtc_state, base)
5daa55eb 848#define to_intel_connector(x) container_of(x, struct intel_connector, base)
4ef69c7a 849#define to_intel_encoder(x) container_of(x, struct intel_encoder, base)
79e53945 850#define to_intel_framebuffer(x) container_of(x, struct intel_framebuffer, base)
b840d907 851#define to_intel_plane(x) container_of(x, struct intel_plane, base)
ea2c67bb 852#define to_intel_plane_state(x) container_of(x, struct intel_plane_state, base)
155e6369 853#define intel_fb_obj(x) (x ? to_intel_framebuffer(x)->obj : NULL)
79e53945 854
f5bbfca3 855struct intel_hdmi {
f0f59a00 856 i915_reg_t hdmi_reg;
f5bbfca3 857 int ddc_bus;
b1ba124d
VS
858 struct {
859 enum drm_dp_dual_mode_type type;
860 int max_tmds_clock;
861 } dp_dual_mode;
0f2a2a75 862 bool limited_color_range;
55bc60db 863 bool color_range_auto;
f5bbfca3
ED
864 bool has_hdmi_sink;
865 bool has_audio;
866 enum hdmi_force_audio force_audio;
abedc077 867 bool rgb_quant_range_selectable;
94a11ddc 868 enum hdmi_picture_aspect aspect_ratio;
d8b4c43a 869 struct intel_connector *attached_connector;
f5bbfca3 870 void (*write_infoframe)(struct drm_encoder *encoder,
ac240288 871 const struct intel_crtc_state *crtc_state,
178f736a 872 enum hdmi_infoframe_type type,
fff63867 873 const void *frame, ssize_t len);
687f4d06 874 void (*set_infoframes)(struct drm_encoder *encoder,
6897b4b5 875 bool enable,
ac240288
ML
876 const struct intel_crtc_state *crtc_state,
877 const struct drm_connector_state *conn_state);
cda0aaaf
VS
878 bool (*infoframe_enabled)(struct drm_encoder *encoder,
879 const struct intel_crtc_state *pipe_config);
f5bbfca3
ED
880};
881
0e32b39c 882struct intel_dp_mst_encoder;
b091cd92 883#define DP_MAX_DOWNSTREAM_PORTS 0x10
54d63ca6 884
fe3cd48d
R
885/*
886 * enum link_m_n_set:
887 * When platform provides two set of M_N registers for dp, we can
888 * program them and switch between them incase of DRRS.
889 * But When only one such register is provided, we have to program the
890 * required divider value on that registers itself based on the DRRS state.
891 *
892 * M1_N1 : Program dp_m_n on M1_N1 registers
893 * dp_m2_n2 on M2_N2 registers (If supported)
894 *
895 * M2_N2 : Program dp_m2_n2 on M1_N1 registers
896 * M2_N2 registers are not supported
897 */
898
899enum link_m_n_set {
900 /* Sets the m1_n1 and m2_n2 */
901 M1_N1 = 0,
902 M2_N2
903};
904
7b3fc170
ID
905struct intel_dp_desc {
906 u8 oui[3];
907 u8 device_id[6];
908 u8 hw_rev;
909 u8 sw_major_rev;
910 u8 sw_minor_rev;
911} __packed;
912
c1617abc
MN
913struct intel_dp_compliance_data {
914 unsigned long edid;
611032bf
MN
915 uint8_t video_pattern;
916 uint16_t hdisplay, vdisplay;
917 uint8_t bpc;
c1617abc
MN
918};
919
920struct intel_dp_compliance {
921 unsigned long test_type;
922 struct intel_dp_compliance_data test_data;
923 bool test_active;
da15f7cb
MN
924 int test_link_rate;
925 u8 test_lane_count;
c1617abc
MN
926};
927
54d63ca6 928struct intel_dp {
f0f59a00
VS
929 i915_reg_t output_reg;
930 i915_reg_t aux_ch_ctl_reg;
931 i915_reg_t aux_ch_data_reg[5];
54d63ca6 932 uint32_t DP;
901c2daf
VS
933 int link_rate;
934 uint8_t lane_count;
30d9aa42 935 uint8_t sink_count;
64ee2fd2 936 bool link_mst;
54d63ca6 937 bool has_audio;
7d23e3c3 938 bool detect_done;
c92bd2fa 939 bool channel_eq_status;
d7e8ef02 940 bool reset_link_params;
54d63ca6 941 enum hdmi_force_audio force_audio;
0f2a2a75 942 bool limited_color_range;
55bc60db 943 bool color_range_auto;
54d63ca6 944 uint8_t dpcd[DP_RECEIVER_CAP_SIZE];
2293bb5c 945 uint8_t psr_dpcd[EDP_PSR_RECEIVER_CAP_SIZE];
b091cd92 946 uint8_t downstream_ports[DP_MAX_DOWNSTREAM_PORTS];
86ee27b5 947 uint8_t edp_dpcd[EDP_DISPLAY_CTL_CAP_SIZE];
94ca719e
VS
948 /* sink rates as reported by DP_SUPPORTED_LINK_RATES */
949 uint8_t num_sink_rates;
950 int sink_rates[DP_MAX_SUPPORTED_RATES];
f482984a
MN
951 /* Max lane count for the sink as per DPCD registers */
952 uint8_t max_sink_lane_count;
953 /* Max link BW for the sink as per DPCD registers */
954 int max_sink_link_bw;
7b3fc170
ID
955 /* sink or branch descriptor */
956 struct intel_dp_desc desc;
9d1a1031 957 struct drm_dp_aux aux;
5432fcaf 958 enum intel_display_power_domain aux_power_domain;
54d63ca6
SK
959 uint8_t train_set[4];
960 int panel_power_up_delay;
961 int panel_power_down_delay;
962 int panel_power_cycle_delay;
963 int backlight_on_delay;
964 int backlight_off_delay;
54d63ca6
SK
965 struct delayed_work panel_vdd_work;
966 bool want_panel_vdd;
dce56b3c
PZ
967 unsigned long last_power_on;
968 unsigned long last_backlight_off;
d28d4731 969 ktime_t panel_power_off_time;
5d42f82a 970
01527b31
CT
971 struct notifier_block edp_notifier;
972
a4a5d2f8
VS
973 /*
974 * Pipe whose power sequencer is currently locked into
975 * this port. Only relevant on VLV/CHV.
976 */
977 enum pipe pps_pipe;
9f2bdb00
VS
978 /*
979 * Pipe currently driving the port. Used for preventing
980 * the use of the PPS for any pipe currentrly driving
981 * external DP as that will mess things up on VLV.
982 */
983 enum pipe active_pipe;
78597996
ID
984 /*
985 * Set if the sequencer may be reset due to a power transition,
986 * requiring a reinitialization. Only relevant on BXT.
987 */
988 bool pps_reset;
36b5f425 989 struct edp_power_seq pps_delays;
a4a5d2f8 990
0e32b39c
DA
991 bool can_mst; /* this port supports mst */
992 bool is_mst;
19e0b4ca 993 int active_mst_links;
0e32b39c 994 /* connector directly attached - won't be use for modeset in mst world */
dd06f90e 995 struct intel_connector *attached_connector;
ec5b01dd 996
0e32b39c
DA
997 /* mst connector list */
998 struct intel_dp_mst_encoder *mst_encoders[I915_MAX_PIPES];
999 struct drm_dp_mst_topology_mgr mst_mgr;
1000
ec5b01dd 1001 uint32_t (*get_aux_clock_divider)(struct intel_dp *dp, int index);
153b1100
DL
1002 /*
1003 * This function returns the value we have to program the AUX_CTL
1004 * register with to kick off an AUX transaction.
1005 */
1006 uint32_t (*get_aux_send_ctl)(struct intel_dp *dp,
1007 bool has_aux_irq,
1008 int send_bytes,
1009 uint32_t aux_clock_divider);
ad64217b
ACO
1010
1011 /* This is called before a link training is starterd */
1012 void (*prepare_link_retrain)(struct intel_dp *intel_dp);
1013
c5d5ab7a 1014 /* Displayport compliance testing */
c1617abc 1015 struct intel_dp_compliance compliance;
54d63ca6
SK
1016};
1017
dbe9e61b
SS
1018struct intel_lspcon {
1019 bool active;
1020 enum drm_lspcon_mode mode;
dbe9e61b
SS
1021};
1022
da63a9f2
PZ
1023struct intel_digital_port {
1024 struct intel_encoder base;
174edf1f 1025 enum port port;
bcf53de4 1026 u32 saved_port_bits;
da63a9f2
PZ
1027 struct intel_dp dp;
1028 struct intel_hdmi hdmi;
dbe9e61b 1029 struct intel_lspcon lspcon;
b2c5c181 1030 enum irqreturn (*hpd_pulse)(struct intel_digital_port *, bool);
b0b33846 1031 bool release_cl2_override;
ccb1a831 1032 uint8_t max_lanes;
62b69566 1033 enum intel_display_power_domain ddi_io_power_domain;
da63a9f2
PZ
1034};
1035
0e32b39c
DA
1036struct intel_dp_mst_encoder {
1037 struct intel_encoder base;
1038 enum pipe pipe;
1039 struct intel_digital_port *primary;
0552f765 1040 struct intel_connector *connector;
0e32b39c
DA
1041};
1042
65d64cc5 1043static inline enum dpio_channel
89b667f8
JB
1044vlv_dport_to_channel(struct intel_digital_port *dport)
1045{
1046 switch (dport->port) {
1047 case PORT_B:
00fc31b7 1048 case PORT_D:
e4607fcf 1049 return DPIO_CH0;
89b667f8 1050 case PORT_C:
e4607fcf 1051 return DPIO_CH1;
89b667f8
JB
1052 default:
1053 BUG();
1054 }
1055}
1056
65d64cc5
VS
1057static inline enum dpio_phy
1058vlv_dport_to_phy(struct intel_digital_port *dport)
1059{
1060 switch (dport->port) {
1061 case PORT_B:
1062 case PORT_C:
1063 return DPIO_PHY0;
1064 case PORT_D:
1065 return DPIO_PHY1;
1066 default:
1067 BUG();
1068 }
1069}
1070
1071static inline enum dpio_channel
eb69b0e5
CML
1072vlv_pipe_to_channel(enum pipe pipe)
1073{
1074 switch (pipe) {
1075 case PIPE_A:
1076 case PIPE_C:
1077 return DPIO_CH0;
1078 case PIPE_B:
1079 return DPIO_CH1;
1080 default:
1081 BUG();
1082 }
1083}
1084
e2af48c6 1085static inline struct intel_crtc *
b91eb5cc 1086intel_get_crtc_for_pipe(struct drm_i915_private *dev_priv, enum pipe pipe)
f875c15a 1087{
f875c15a
CW
1088 return dev_priv->pipe_to_crtc_mapping[pipe];
1089}
1090
e2af48c6 1091static inline struct intel_crtc *
b91eb5cc 1092intel_get_crtc_for_plane(struct drm_i915_private *dev_priv, enum plane plane)
417ae147 1093{
417ae147
CW
1094 return dev_priv->plane_to_crtc_mapping[plane];
1095}
1096
51cbaf01
ML
1097struct intel_flip_work {
1098 struct work_struct unpin_work;
1099 struct work_struct mmio_work;
1100
5a21b665 1101 struct drm_crtc *crtc;
be1e3415 1102 struct i915_vma *old_vma;
5a21b665
DV
1103 struct drm_framebuffer *old_fb;
1104 struct drm_i915_gem_object *pending_flip_obj;
4e5359cd 1105 struct drm_pending_vblank_event *event;
e7d841ca 1106 atomic_t pending;
5a21b665
DV
1107 u32 flip_count;
1108 u32 gtt_offset;
1109 struct drm_i915_gem_request *flip_queued_req;
66f59c5c 1110 u32 flip_queued_vblank;
5a21b665
DV
1111 u32 flip_ready_vblank;
1112 unsigned int rotation;
4e5359cd
SF
1113};
1114
5f1aae65 1115struct intel_load_detect_pipe {
edde3617 1116 struct drm_atomic_state *restore_state;
5f1aae65 1117};
79e53945 1118
5f1aae65
PZ
1119static inline struct intel_encoder *
1120intel_attached_encoder(struct drm_connector *connector)
df0e9248
CW
1121{
1122 return to_intel_connector(connector)->encoder;
1123}
1124
da63a9f2
PZ
1125static inline struct intel_digital_port *
1126enc_to_dig_port(struct drm_encoder *encoder)
1127{
9a5da00b
ACO
1128 struct intel_encoder *intel_encoder = to_intel_encoder(encoder);
1129
1130 switch (intel_encoder->type) {
1131 case INTEL_OUTPUT_UNKNOWN:
1132 WARN_ON(!HAS_DDI(to_i915(encoder->dev)));
1133 case INTEL_OUTPUT_DP:
1134 case INTEL_OUTPUT_EDP:
1135 case INTEL_OUTPUT_HDMI:
1136 return container_of(encoder, struct intel_digital_port,
1137 base.base);
1138 default:
1139 return NULL;
1140 }
9ff8c9ba
ID
1141}
1142
0e32b39c
DA
1143static inline struct intel_dp_mst_encoder *
1144enc_to_mst(struct drm_encoder *encoder)
1145{
1146 return container_of(encoder, struct intel_dp_mst_encoder, base.base);
1147}
1148
9ff8c9ba
ID
1149static inline struct intel_dp *enc_to_intel_dp(struct drm_encoder *encoder)
1150{
1151 return &enc_to_dig_port(encoder)->dp;
da63a9f2
PZ
1152}
1153
1154static inline struct intel_digital_port *
1155dp_to_dig_port(struct intel_dp *intel_dp)
1156{
1157 return container_of(intel_dp, struct intel_digital_port, dp);
1158}
1159
dd75f6dd
ID
1160static inline struct intel_lspcon *
1161dp_to_lspcon(struct intel_dp *intel_dp)
1162{
1163 return &dp_to_dig_port(intel_dp)->lspcon;
1164}
1165
da63a9f2
PZ
1166static inline struct intel_digital_port *
1167hdmi_to_dig_port(struct intel_hdmi *intel_hdmi)
1168{
1169 return container_of(intel_hdmi, struct intel_digital_port, hdmi);
7739c33b
PZ
1170}
1171
47339cd9 1172/* intel_fifo_underrun.c */
a72e4c9f 1173bool intel_set_cpu_fifo_underrun_reporting(struct drm_i915_private *dev_priv,
87440425 1174 enum pipe pipe, bool enable);
a72e4c9f 1175bool intel_set_pch_fifo_underrun_reporting(struct drm_i915_private *dev_priv,
87440425
PZ
1176 enum transcoder pch_transcoder,
1177 bool enable);
1f7247c0
DV
1178void intel_cpu_fifo_underrun_irq_handler(struct drm_i915_private *dev_priv,
1179 enum pipe pipe);
1180void intel_pch_fifo_underrun_irq_handler(struct drm_i915_private *dev_priv,
1181 enum transcoder pch_transcoder);
aca7b684
VS
1182void intel_check_cpu_fifo_underruns(struct drm_i915_private *dev_priv);
1183void intel_check_pch_fifo_underruns(struct drm_i915_private *dev_priv);
47339cd9
DV
1184
1185/* i915_irq.c */
480c8033
DV
1186void gen5_enable_gt_irq(struct drm_i915_private *dev_priv, uint32_t mask);
1187void gen5_disable_gt_irq(struct drm_i915_private *dev_priv, uint32_t mask);
f4e9af4f
AG
1188void gen6_reset_pm_iir(struct drm_i915_private *dev_priv, u32 mask);
1189void gen6_mask_pm_irq(struct drm_i915_private *dev_priv, u32 mask);
1190void gen6_unmask_pm_irq(struct drm_i915_private *dev_priv, u32 mask);
480c8033
DV
1191void gen6_enable_pm_irq(struct drm_i915_private *dev_priv, uint32_t mask);
1192void gen6_disable_pm_irq(struct drm_i915_private *dev_priv, uint32_t mask);
dc97997a 1193void gen6_reset_rps_interrupts(struct drm_i915_private *dev_priv);
91d14251
TU
1194void gen6_enable_rps_interrupts(struct drm_i915_private *dev_priv);
1195void gen6_disable_rps_interrupts(struct drm_i915_private *dev_priv);
59d02a1f 1196u32 gen6_sanitize_rps_pm_mask(struct drm_i915_private *dev_priv, u32 mask);
b963291c
DV
1197void intel_runtime_pm_disable_interrupts(struct drm_i915_private *dev_priv);
1198void intel_runtime_pm_enable_interrupts(struct drm_i915_private *dev_priv);
9df7575f
JB
1199static inline bool intel_irqs_enabled(struct drm_i915_private *dev_priv)
1200{
1201 /*
1202 * We only use drm_irq_uninstall() at unload and VT switch, so
1203 * this is the only thing we need to check.
1204 */
2aeb7d3a 1205 return dev_priv->pm.irqs_enabled;
9df7575f
JB
1206}
1207
a225f079 1208int intel_get_crtc_scanline(struct intel_crtc *crtc);
4c6c03be
DL
1209void gen8_irq_power_well_post_enable(struct drm_i915_private *dev_priv,
1210 unsigned int pipe_mask);
aae8ba84
VS
1211void gen8_irq_power_well_pre_disable(struct drm_i915_private *dev_priv,
1212 unsigned int pipe_mask);
26705e20
SAK
1213void gen9_reset_guc_interrupts(struct drm_i915_private *dev_priv);
1214void gen9_enable_guc_interrupts(struct drm_i915_private *dev_priv);
1215void gen9_disable_guc_interrupts(struct drm_i915_private *dev_priv);
5f1aae65 1216
5f1aae65 1217/* intel_crt.c */
c39055b0 1218void intel_crt_init(struct drm_i915_private *dev_priv);
9504a892 1219void intel_crt_reset(struct drm_encoder *encoder);
5f1aae65
PZ
1220
1221/* intel_ddi.c */
e404ba8d 1222void intel_ddi_clk_select(struct intel_encoder *encoder,
c856052a 1223 struct intel_shared_dpll *pll);
b7076546
ML
1224void intel_ddi_fdi_post_disable(struct intel_encoder *intel_encoder,
1225 struct intel_crtc_state *old_crtc_state,
1226 struct drm_connector_state *old_conn_state);
32bdc400 1227void intel_prepare_dp_ddi_buffers(struct intel_encoder *encoder);
dc4a1094
ACO
1228void hsw_fdi_link_train(struct intel_crtc *crtc,
1229 const struct intel_crtc_state *crtc_state);
c39055b0 1230void intel_ddi_init(struct drm_i915_private *dev_priv, enum port port);
87440425
PZ
1231enum port intel_ddi_get_encoder_port(struct intel_encoder *intel_encoder);
1232bool intel_ddi_get_hw_state(struct intel_encoder *encoder, enum pipe *pipe);
e9ce1a62 1233void intel_ddi_enable_transcoder_func(struct intel_crtc *crtc);
87440425
PZ
1234void intel_ddi_disable_transcoder_func(struct drm_i915_private *dev_priv,
1235 enum transcoder cpu_transcoder);
1236void intel_ddi_enable_pipe_clock(struct intel_crtc *intel_crtc);
1237void intel_ddi_disable_pipe_clock(struct intel_crtc *intel_crtc);
190f68c5
ACO
1238bool intel_ddi_pll_select(struct intel_crtc *crtc,
1239 struct intel_crtc_state *crtc_state);
e9ce1a62 1240void intel_ddi_set_pipe_settings(struct intel_crtc *crtc);
ad64217b 1241void intel_ddi_prepare_link_retrain(struct intel_dp *intel_dp);
87440425 1242bool intel_ddi_connector_get_hw_state(struct intel_connector *intel_connector);
9935f7fa
LY
1243bool intel_ddi_is_audio_enabled(struct drm_i915_private *dev_priv,
1244 struct intel_crtc *intel_crtc);
87440425 1245void intel_ddi_get_config(struct intel_encoder *encoder,
5cec258b 1246 struct intel_crtc_state *pipe_config);
bcddf610
S
1247struct intel_encoder *
1248intel_ddi_get_crtc_new_encoder(struct intel_crtc_state *crtc_state);
5f1aae65 1249
44905a27 1250void intel_ddi_init_dp_buf_reg(struct intel_encoder *encoder);
0e32b39c 1251void intel_ddi_clock_get(struct intel_encoder *encoder,
5cec258b 1252 struct intel_crtc_state *pipe_config);
e9ce1a62 1253void intel_ddi_set_vc_payload_alloc(struct intel_crtc *crtc, bool state);
f8896f5d 1254uint32_t ddi_signal_levels(struct intel_dp *intel_dp);
ffe5111e
VS
1255u8 intel_ddi_dp_voltage_max(struct intel_encoder *encoder);
1256
24dbf51a 1257unsigned int intel_fb_align_height(struct drm_i915_private *dev_priv,
6761dd31
TU
1258 unsigned int height,
1259 uint32_t pixel_format,
1260 uint64_t fb_format_modifier);
7b49f948
VS
1261u32 intel_fb_stride_alignment(const struct drm_i915_private *dev_priv,
1262 uint64_t fb_modifier, uint32_t pixel_format);
b680c37a 1263
7c10a2b5 1264/* intel_audio.c */
88212941 1265void intel_init_audio_hooks(struct drm_i915_private *dev_priv);
bbf35e9d
ML
1266void intel_audio_codec_enable(struct intel_encoder *encoder,
1267 const struct intel_crtc_state *crtc_state,
1268 const struct drm_connector_state *conn_state);
69bfe1a9 1269void intel_audio_codec_disable(struct intel_encoder *encoder);
58fddc28
ID
1270void i915_audio_component_init(struct drm_i915_private *dev_priv);
1271void i915_audio_component_cleanup(struct drm_i915_private *dev_priv);
7c10a2b5 1272
7ff89ca2
VS
1273/* intel_cdclk.c */
1274void intel_init_cdclk_hooks(struct drm_i915_private *dev_priv);
1275void intel_update_max_cdclk(struct drm_i915_private *dev_priv);
1276void intel_update_cdclk(struct drm_i915_private *dev_priv);
1277void intel_update_rawclk(struct drm_i915_private *dev_priv);
49cd97a3
VS
1278bool intel_cdclk_state_compare(const struct intel_cdclk_state *a,
1279 const struct intel_cdclk_state *b);
b0587e4d
VS
1280void intel_set_cdclk(struct drm_i915_private *dev_priv,
1281 const struct intel_cdclk_state *cdclk_state);
7ff89ca2 1282
b680c37a 1283/* intel_display.c */
65f2130c 1284enum transcoder intel_crtc_pch_transcoder(struct intel_crtc *crtc);
19ab4ed3 1285void intel_update_rawclk(struct drm_i915_private *dev_priv);
49cd97a3 1286int vlv_get_hpll_vco(struct drm_i915_private *dev_priv);
c30fec65
VS
1287int vlv_get_cck_clock(struct drm_i915_private *dev_priv,
1288 const char *name, u32 reg, int ref_freq);
7ff89ca2
VS
1289int vlv_get_cck_clock_hpll(struct drm_i915_private *dev_priv,
1290 const char *name, u32 reg);
b7076546
ML
1291void lpt_disable_pch_transcoder(struct drm_i915_private *dev_priv);
1292void lpt_disable_iclkip(struct drm_i915_private *dev_priv);
65a3fea0 1293extern const struct drm_plane_funcs intel_plane_funcs;
88212941 1294void intel_init_display_hooks(struct drm_i915_private *dev_priv);
6687c906 1295unsigned int intel_fb_xy_to_linear(int x, int y,
2949056c
VS
1296 const struct intel_plane_state *state,
1297 int plane);
6687c906 1298void intel_add_fb_offsets(int *x, int *y,
2949056c 1299 const struct intel_plane_state *state, int plane);
1663b9d6 1300unsigned int intel_rotation_info_size(const struct intel_rotation_info *rot_info);
49d73912 1301bool intel_has_pending_fb_unpin(struct drm_i915_private *dev_priv);
7d993739
TU
1302void intel_mark_busy(struct drm_i915_private *dev_priv);
1303void intel_mark_idle(struct drm_i915_private *dev_priv);
87440425 1304void intel_crtc_restore_mode(struct drm_crtc *crtc);
70e0bd74 1305int intel_display_suspend(struct drm_device *dev);
8090ba8c 1306void intel_pps_unlock_regs_wa(struct drm_i915_private *dev_priv);
87440425 1307void intel_encoder_destroy(struct drm_encoder *encoder);
08d9bc92
ACO
1308int intel_connector_init(struct intel_connector *);
1309struct intel_connector *intel_connector_alloc(void);
87440425 1310bool intel_connector_get_hw_state(struct intel_connector *connector);
87440425
PZ
1311void intel_connector_attach_encoder(struct intel_connector *connector,
1312 struct intel_encoder *encoder);
87440425
PZ
1313struct drm_display_mode *intel_crtc_mode_get(struct drm_device *dev,
1314 struct drm_crtc *crtc);
752aa88a 1315enum pipe intel_get_pipe_from_connector(struct intel_connector *connector);
08d7b3d1
CW
1316int intel_get_pipe_from_crtc_id(struct drm_device *dev, void *data,
1317 struct drm_file *file_priv);
87440425
PZ
1318enum transcoder intel_pipe_to_cpu_transcoder(struct drm_i915_private *dev_priv,
1319 enum pipe pipe);
2d84d2b3
VS
1320static inline bool
1321intel_crtc_has_type(const struct intel_crtc_state *crtc_state,
1322 enum intel_output_type type)
1323{
1324 return crtc_state->output_types & (1 << type);
1325}
37a5650b
VS
1326static inline bool
1327intel_crtc_has_dp_encoder(const struct intel_crtc_state *crtc_state)
1328{
1329 return crtc_state->output_types &
cca0502b 1330 ((1 << INTEL_OUTPUT_DP) |
37a5650b
VS
1331 (1 << INTEL_OUTPUT_DP_MST) |
1332 (1 << INTEL_OUTPUT_EDP));
1333}
4f905cf9 1334static inline void
0f0f74bc 1335intel_wait_for_vblank(struct drm_i915_private *dev_priv, enum pipe pipe)
4f905cf9 1336{
0f0f74bc 1337 drm_wait_one_vblank(&dev_priv->drm, pipe);
4f905cf9 1338}
0c241d5b 1339static inline void
0f0f74bc 1340intel_wait_for_vblank_if_active(struct drm_i915_private *dev_priv, int pipe)
0c241d5b 1341{
b91eb5cc 1342 const struct intel_crtc *crtc = intel_get_crtc_for_pipe(dev_priv, pipe);
0c241d5b
VS
1343
1344 if (crtc->active)
0f0f74bc 1345 intel_wait_for_vblank(dev_priv, pipe);
0c241d5b 1346}
a2991414
ML
1347
1348u32 intel_crtc_get_vblank_counter(struct intel_crtc *crtc);
1349
87440425 1350int ironlake_get_lanes_required(int target_clock, int link_bw, int bpp);
e4607fcf 1351void vlv_wait_port_ready(struct drm_i915_private *dev_priv,
9b6de0a1
VS
1352 struct intel_digital_port *dport,
1353 unsigned int expected_mask);
87440425
PZ
1354bool intel_get_load_detect_pipe(struct drm_connector *connector,
1355 struct drm_display_mode *mode,
51fd371b
RC
1356 struct intel_load_detect_pipe *old,
1357 struct drm_modeset_acquire_ctx *ctx);
87440425 1358void intel_release_load_detect_pipe(struct drm_connector *connector,
49172fee
ACO
1359 struct intel_load_detect_pipe *old,
1360 struct drm_modeset_acquire_ctx *ctx);
058d88c4
CW
1361struct i915_vma *
1362intel_pin_and_fence_fb_obj(struct drm_framebuffer *fb, unsigned int rotation);
be1e3415 1363void intel_unpin_fb_vma(struct i915_vma *vma);
a8bb6818 1364struct drm_framebuffer *
24dbf51a
CW
1365intel_framebuffer_create(struct drm_i915_gem_object *obj,
1366 struct drm_mode_fb_cmd2 *mode_cmd);
5a21b665 1367void intel_finish_page_flip_cs(struct drm_i915_private *dev_priv, int pipe);
51cbaf01 1368void intel_finish_page_flip_mmio(struct drm_i915_private *dev_priv, int pipe);
5a21b665 1369void intel_check_page_flip(struct drm_i915_private *dev_priv, int pipe);
6beb8c23 1370int intel_prepare_plane_fb(struct drm_plane *plane,
1832040d 1371 struct drm_plane_state *new_state);
38f3ce3a 1372void intel_cleanup_plane_fb(struct drm_plane *plane,
1832040d 1373 struct drm_plane_state *old_state);
a98b3431
MR
1374int intel_plane_atomic_get_property(struct drm_plane *plane,
1375 const struct drm_plane_state *state,
1376 struct drm_property *property,
1377 uint64_t *val);
1378int intel_plane_atomic_set_property(struct drm_plane *plane,
1379 struct drm_plane_state *state,
1380 struct drm_property *property,
1381 uint64_t val);
da20eabd
ML
1382int intel_plane_atomic_calc_changes(struct drm_crtc_state *crtc_state,
1383 struct drm_plane_state *plane_state);
716c2e55 1384
832be82f
VS
1385unsigned int intel_tile_height(const struct drm_i915_private *dev_priv,
1386 uint64_t fb_modifier, unsigned int cpp);
50470bb0 1387
7abd4b35
ACO
1388void assert_pch_transcoder_disabled(struct drm_i915_private *dev_priv,
1389 enum pipe pipe);
1390
30ad9814 1391int vlv_force_pll_on(struct drm_i915_private *dev_priv, enum pipe pipe,
3f36b937 1392 const struct dpll *dpll);
30ad9814 1393void vlv_force_pll_off(struct drm_i915_private *dev_priv, enum pipe pipe);
8802e5b6 1394int lpt_get_iclkip(struct drm_i915_private *dev_priv);
d288f65f 1395
716c2e55 1396/* modesetting asserts */
b680c37a
DV
1397void assert_panel_unlocked(struct drm_i915_private *dev_priv,
1398 enum pipe pipe);
55607e8a
DV
1399void assert_pll(struct drm_i915_private *dev_priv,
1400 enum pipe pipe, bool state);
1401#define assert_pll_enabled(d, p) assert_pll(d, p, true)
1402#define assert_pll_disabled(d, p) assert_pll(d, p, false)
8563b1e8
LL
1403void assert_dsi_pll(struct drm_i915_private *dev_priv, bool state);
1404#define assert_dsi_pll_enabled(d) assert_dsi_pll(d, true)
1405#define assert_dsi_pll_disabled(d) assert_dsi_pll(d, false)
55607e8a
DV
1406void assert_fdi_rx_pll(struct drm_i915_private *dev_priv,
1407 enum pipe pipe, bool state);
1408#define assert_fdi_rx_pll_enabled(d, p) assert_fdi_rx_pll(d, p, true)
1409#define assert_fdi_rx_pll_disabled(d, p) assert_fdi_rx_pll(d, p, false)
87440425 1410void assert_pipe(struct drm_i915_private *dev_priv, enum pipe pipe, bool state);
b840d907
JB
1411#define assert_pipe_enabled(d, p) assert_pipe(d, p, true)
1412#define assert_pipe_disabled(d, p) assert_pipe(d, p, false)
4f2d9934 1413u32 intel_compute_tile_offset(int *x, int *y,
2949056c 1414 const struct intel_plane_state *state, int plane);
c033666a
CW
1415void intel_prepare_reset(struct drm_i915_private *dev_priv);
1416void intel_finish_reset(struct drm_i915_private *dev_priv);
a14cb6fc
PZ
1417void hsw_enable_pc8(struct drm_i915_private *dev_priv);
1418void hsw_disable_pc8(struct drm_i915_private *dev_priv);
324513c0
ID
1419void bxt_init_cdclk(struct drm_i915_private *dev_priv);
1420void bxt_uninit_cdclk(struct drm_i915_private *dev_priv);
da2f41d1 1421void gen9_sanitize_dc_state(struct drm_i915_private *dev_priv);
664326f8
SK
1422void bxt_enable_dc9(struct drm_i915_private *dev_priv);
1423void bxt_disable_dc9(struct drm_i915_private *dev_priv);
f62c79b3 1424void gen9_enable_dc5(struct drm_i915_private *dev_priv);
5d96d8af
DL
1425void skl_init_cdclk(struct drm_i915_private *dev_priv);
1426void skl_uninit_cdclk(struct drm_i915_private *dev_priv);
c89e39f3 1427unsigned int skl_cdclk_get_vco(unsigned int freq);
0a9d2bed
AM
1428void skl_enable_dc6(struct drm_i915_private *dev_priv);
1429void skl_disable_dc6(struct drm_i915_private *dev_priv);
87440425 1430void intel_dp_get_m_n(struct intel_crtc *crtc,
5cec258b 1431 struct intel_crtc_state *pipe_config);
fe3cd48d 1432void intel_dp_set_m_n(struct intel_crtc *crtc, enum link_m_n_set m_n);
87440425 1433int intel_dotclock_calculate(int link_freq, const struct intel_link_m_n *m_n);
5ab7b0b7 1434bool bxt_find_best_dpll(struct intel_crtc_state *crtc_state, int target_clock,
9e2c8475
ACO
1435 struct dpll *best_clock);
1436int chv_calc_dpll_params(int refclk, struct dpll *pll_clock);
dccbea3b 1437
525b9311 1438bool intel_crtc_active(struct intel_crtc *crtc);
20bc8673
VS
1439void hsw_enable_ips(struct intel_crtc *crtc);
1440void hsw_disable_ips(struct intel_crtc *crtc);
79f255a0 1441enum intel_display_power_domain intel_port_to_power_domain(enum port port);
f6a83288 1442void intel_mode_from_pipe_config(struct drm_display_mode *mode,
5cec258b 1443 struct intel_crtc_state *pipe_config);
86adf9d7 1444
e435d6e5 1445int skl_update_scaler_crtc(struct intel_crtc_state *crtc_state);
6156a456 1446int skl_max_scale(struct intel_crtc *crtc, struct intel_crtc_state *crtc_state);
8ea30864 1447
be1e3415
CW
1448static inline u32 intel_plane_ggtt_offset(const struct intel_plane_state *state)
1449{
1450 return i915_ggtt_offset(state->vma);
1451}
dedf278c 1452
6156a456
CK
1453u32 skl_plane_ctl_format(uint32_t pixel_format);
1454u32 skl_plane_ctl_tiling(uint64_t fb_modifier);
1455u32 skl_plane_ctl_rotation(unsigned int rotation);
d2196774
VS
1456u32 skl_plane_stride(const struct drm_framebuffer *fb, int plane,
1457 unsigned int rotation);
b63a16f6 1458int skl_check_plane_surface(struct intel_plane_state *plane_state);
121920fa 1459
eb805623 1460/* intel_csr.c */
f4448375 1461void intel_csr_ucode_init(struct drm_i915_private *);
2abc525b 1462void intel_csr_load_program(struct drm_i915_private *);
f4448375 1463void intel_csr_ucode_fini(struct drm_i915_private *);
f74ed08d
ID
1464void intel_csr_ucode_suspend(struct drm_i915_private *);
1465void intel_csr_ucode_resume(struct drm_i915_private *);
eb805623 1466
5f1aae65 1467/* intel_dp.c */
c39055b0
ACO
1468bool intel_dp_init(struct drm_i915_private *dev_priv, i915_reg_t output_reg,
1469 enum port port);
87440425
PZ
1470bool intel_dp_init_connector(struct intel_digital_port *intel_dig_port,
1471 struct intel_connector *intel_connector);
901c2daf 1472void intel_dp_set_link_params(struct intel_dp *intel_dp,
dfa10480
ACO
1473 int link_rate, uint8_t lane_count,
1474 bool link_mst);
fdb14d33
MN
1475int intel_dp_get_link_train_fallback_values(struct intel_dp *intel_dp,
1476 int link_rate, uint8_t lane_count);
87440425 1477void intel_dp_start_link_train(struct intel_dp *intel_dp);
87440425
PZ
1478void intel_dp_stop_link_train(struct intel_dp *intel_dp);
1479void intel_dp_sink_dpms(struct intel_dp *intel_dp, int mode);
bf93ba67
ID
1480void intel_dp_encoder_reset(struct drm_encoder *encoder);
1481void intel_dp_encoder_suspend(struct intel_encoder *intel_encoder);
87440425 1482void intel_dp_encoder_destroy(struct drm_encoder *encoder);
d2e216d0 1483int intel_dp_sink_crc(struct intel_dp *intel_dp, u8 *crc);
87440425 1484bool intel_dp_compute_config(struct intel_encoder *encoder,
0a478c27
ML
1485 struct intel_crtc_state *pipe_config,
1486 struct drm_connector_state *conn_state);
dd11bc10 1487bool intel_dp_is_edp(struct drm_i915_private *dev_priv, enum port port);
b2c5c181
DV
1488enum irqreturn intel_dp_hpd_pulse(struct intel_digital_port *intel_dig_port,
1489 bool long_hpd);
4be73780
DV
1490void intel_edp_backlight_on(struct intel_dp *intel_dp);
1491void intel_edp_backlight_off(struct intel_dp *intel_dp);
24f3e092 1492void intel_edp_panel_vdd_on(struct intel_dp *intel_dp);
4be73780
DV
1493void intel_edp_panel_on(struct intel_dp *intel_dp);
1494void intel_edp_panel_off(struct intel_dp *intel_dp);
0e32b39c
DA
1495void intel_dp_add_properties(struct intel_dp *intel_dp, struct drm_connector *connector);
1496void intel_dp_mst_suspend(struct drm_device *dev);
1497void intel_dp_mst_resume(struct drm_device *dev);
50fec21a 1498int intel_dp_max_link_rate(struct intel_dp *intel_dp);
ed4e9c1d 1499int intel_dp_rate_select(struct intel_dp *intel_dp, int rate);
0e32b39c 1500void intel_dp_hot_plug(struct intel_encoder *intel_encoder);
78597996 1501void intel_power_sequencer_reset(struct drm_i915_private *dev_priv);
0bc12bcb 1502uint32_t intel_dp_pack_aux(const uint8_t *src, int src_bytes);
4a3b8769 1503void intel_plane_destroy(struct drm_plane *plane);
85cb48a1
ML
1504void intel_edp_drrs_enable(struct intel_dp *intel_dp,
1505 struct intel_crtc_state *crtc_state);
1506void intel_edp_drrs_disable(struct intel_dp *intel_dp,
1507 struct intel_crtc_state *crtc_state);
5748b6a1
CW
1508void intel_edp_drrs_invalidate(struct drm_i915_private *dev_priv,
1509 unsigned int frontbuffer_bits);
1510void intel_edp_drrs_flush(struct drm_i915_private *dev_priv,
1511 unsigned int frontbuffer_bits);
0bc12bcb 1512
94223d04
ACO
1513void
1514intel_dp_program_link_training_pattern(struct intel_dp *intel_dp,
1515 uint8_t dp_train_pat);
1516void
1517intel_dp_set_signal_levels(struct intel_dp *intel_dp);
1518void intel_dp_set_idle_link_train(struct intel_dp *intel_dp);
1519uint8_t
1520intel_dp_voltage_max(struct intel_dp *intel_dp);
1521uint8_t
1522intel_dp_pre_emphasis_max(struct intel_dp *intel_dp, uint8_t voltage_swing);
1523void intel_dp_compute_rate(struct intel_dp *intel_dp, int port_clock,
1524 uint8_t *link_bw, uint8_t *rate_select);
e588fa18 1525bool intel_dp_source_supports_hbr2(struct intel_dp *intel_dp);
94223d04
ACO
1526bool
1527intel_dp_get_link_status(struct intel_dp *intel_dp, uint8_t link_status[DP_LINK_STATUS_SIZE]);
1528
419b1b7a
ACO
1529static inline unsigned int intel_dp_unused_lane_mask(int lane_count)
1530{
1531 return ~((1 << lane_count) - 1) & 0xf;
1532}
1533
24e807e7 1534bool intel_dp_read_dpcd(struct intel_dp *intel_dp);
489375c8
ID
1535bool __intel_dp_read_desc(struct intel_dp *intel_dp,
1536 struct intel_dp_desc *desc);
12a47a42 1537bool intel_dp_read_desc(struct intel_dp *intel_dp);
22a2c8e0
DP
1538int intel_dp_link_required(int pixel_clock, int bpp);
1539int intel_dp_max_data_rate(int max_link_clock, int max_lanes);
390b4e00
ID
1540bool intel_digital_port_connected(struct drm_i915_private *dev_priv,
1541 struct intel_digital_port *port);
24e807e7 1542
e7156c83
YA
1543/* intel_dp_aux_backlight.c */
1544int intel_dp_aux_init_backlight_funcs(struct intel_connector *intel_connector);
1545
0e32b39c
DA
1546/* intel_dp_mst.c */
1547int intel_dp_mst_encoder_init(struct intel_digital_port *intel_dig_port, int conn_id);
1548void intel_dp_mst_encoder_cleanup(struct intel_digital_port *intel_dig_port);
5f1aae65 1549/* intel_dsi.c */
c39055b0 1550void intel_dsi_init(struct drm_i915_private *dev_priv);
5f1aae65 1551
90198355
JN
1552/* intel_dsi_dcs_backlight.c */
1553int intel_dsi_dcs_init_backlight_funcs(struct intel_connector *intel_connector);
5f1aae65
PZ
1554
1555/* intel_dvo.c */
c39055b0 1556void intel_dvo_init(struct drm_i915_private *dev_priv);
19625e85
L
1557/* intel_hotplug.c */
1558void intel_hpd_poll_init(struct drm_i915_private *dev_priv);
5f1aae65
PZ
1559
1560
0632fef6 1561/* legacy fbdev emulation in intel_fbdev.c */
0695726e 1562#ifdef CONFIG_DRM_FBDEV_EMULATION
4520f53a 1563extern int intel_fbdev_init(struct drm_device *dev);
e00bf696 1564extern void intel_fbdev_initial_config_async(struct drm_device *dev);
4520f53a 1565extern void intel_fbdev_fini(struct drm_device *dev);
82e3b8c1 1566extern void intel_fbdev_set_suspend(struct drm_device *dev, int state, bool synchronous);
0632fef6
DV
1567extern void intel_fbdev_output_poll_changed(struct drm_device *dev);
1568extern void intel_fbdev_restore_mode(struct drm_device *dev);
4520f53a
DV
1569#else
1570static inline int intel_fbdev_init(struct drm_device *dev)
1571{
1572 return 0;
1573}
5f1aae65 1574
e00bf696 1575static inline void intel_fbdev_initial_config_async(struct drm_device *dev)
4520f53a
DV
1576{
1577}
1578
1579static inline void intel_fbdev_fini(struct drm_device *dev)
1580{
1581}
1582
82e3b8c1 1583static inline void intel_fbdev_set_suspend(struct drm_device *dev, int state, bool synchronous)
4520f53a
DV
1584{
1585}
1586
d9c409d6
JN
1587static inline void intel_fbdev_output_poll_changed(struct drm_device *dev)
1588{
1589}
1590
0632fef6 1591static inline void intel_fbdev_restore_mode(struct drm_device *dev)
4520f53a
DV
1592{
1593}
1594#endif
5f1aae65 1595
7ff0ebcc 1596/* intel_fbc.c */
f51be2e0
PZ
1597void intel_fbc_choose_crtc(struct drm_i915_private *dev_priv,
1598 struct drm_atomic_state *state);
0e631adc 1599bool intel_fbc_is_active(struct drm_i915_private *dev_priv);
faf68d92
ML
1600void intel_fbc_pre_update(struct intel_crtc *crtc,
1601 struct intel_crtc_state *crtc_state,
1602 struct intel_plane_state *plane_state);
1eb52238 1603void intel_fbc_post_update(struct intel_crtc *crtc);
7ff0ebcc 1604void intel_fbc_init(struct drm_i915_private *dev_priv);
010cf73d 1605void intel_fbc_init_pipe_state(struct drm_i915_private *dev_priv);
faf68d92
ML
1606void intel_fbc_enable(struct intel_crtc *crtc,
1607 struct intel_crtc_state *crtc_state,
1608 struct intel_plane_state *plane_state);
c937ab3e
PZ
1609void intel_fbc_disable(struct intel_crtc *crtc);
1610void intel_fbc_global_disable(struct drm_i915_private *dev_priv);
dbef0f15
PZ
1611void intel_fbc_invalidate(struct drm_i915_private *dev_priv,
1612 unsigned int frontbuffer_bits,
1613 enum fb_op_origin origin);
1614void intel_fbc_flush(struct drm_i915_private *dev_priv,
6f4551fe 1615 unsigned int frontbuffer_bits, enum fb_op_origin origin);
7733b49b 1616void intel_fbc_cleanup_cfb(struct drm_i915_private *dev_priv);
61a585d6 1617void intel_fbc_handle_fifo_underrun_irq(struct drm_i915_private *dev_priv);
7ff0ebcc 1618
5f1aae65 1619/* intel_hdmi.c */
c39055b0
ACO
1620void intel_hdmi_init(struct drm_i915_private *dev_priv, i915_reg_t hdmi_reg,
1621 enum port port);
87440425
PZ
1622void intel_hdmi_init_connector(struct intel_digital_port *intel_dig_port,
1623 struct intel_connector *intel_connector);
1624struct intel_hdmi *enc_to_intel_hdmi(struct drm_encoder *encoder);
1625bool intel_hdmi_compute_config(struct intel_encoder *encoder,
0a478c27
ML
1626 struct intel_crtc_state *pipe_config,
1627 struct drm_connector_state *conn_state);
b2ccb822 1628void intel_dp_dual_mode_set_tmds_output(struct intel_hdmi *hdmi, bool enable);
5f1aae65
PZ
1629
1630
1631/* intel_lvds.c */
c39055b0 1632void intel_lvds_init(struct drm_i915_private *dev_priv);
97a824e1 1633struct intel_encoder *intel_get_lvds_encoder(struct drm_device *dev);
87440425 1634bool intel_is_dual_link_lvds(struct drm_device *dev);
5f1aae65
PZ
1635
1636
1637/* intel_modes.c */
1638int intel_connector_update_modes(struct drm_connector *connector,
87440425 1639 struct edid *edid);
5f1aae65 1640int intel_ddc_get_modes(struct drm_connector *c, struct i2c_adapter *adapter);
87440425
PZ
1641void intel_attach_force_audio_property(struct drm_connector *connector);
1642void intel_attach_broadcast_rgb_property(struct drm_connector *connector);
7949dd47 1643void intel_attach_aspect_ratio_property(struct drm_connector *connector);
5f1aae65
PZ
1644
1645
1646/* intel_overlay.c */
1ee8da6d
CW
1647void intel_setup_overlay(struct drm_i915_private *dev_priv);
1648void intel_cleanup_overlay(struct drm_i915_private *dev_priv);
87440425 1649int intel_overlay_switch_off(struct intel_overlay *overlay);
1ee8da6d
CW
1650int intel_overlay_put_image_ioctl(struct drm_device *dev, void *data,
1651 struct drm_file *file_priv);
1652int intel_overlay_attrs_ioctl(struct drm_device *dev, void *data,
1653 struct drm_file *file_priv);
1362b776 1654void intel_overlay_reset(struct drm_i915_private *dev_priv);
5f1aae65
PZ
1655
1656
1657/* intel_panel.c */
87440425 1658int intel_panel_init(struct intel_panel *panel,
4b6ed685
VK
1659 struct drm_display_mode *fixed_mode,
1660 struct drm_display_mode *downclock_mode);
87440425
PZ
1661void intel_panel_fini(struct intel_panel *panel);
1662void intel_fixed_panel_mode(const struct drm_display_mode *fixed_mode,
1663 struct drm_display_mode *adjusted_mode);
1664void intel_pch_panel_fitting(struct intel_crtc *crtc,
5cec258b 1665 struct intel_crtc_state *pipe_config,
87440425
PZ
1666 int fitting_mode);
1667void intel_gmch_panel_fitting(struct intel_crtc *crtc,
5cec258b 1668 struct intel_crtc_state *pipe_config,
87440425 1669 int fitting_mode);
6dda730e
JN
1670void intel_panel_set_backlight_acpi(struct intel_connector *connector,
1671 u32 level, u32 max);
fda9ee98
CW
1672int intel_panel_setup_backlight(struct drm_connector *connector,
1673 enum pipe pipe);
752aa88a
JB
1674void intel_panel_enable_backlight(struct intel_connector *connector);
1675void intel_panel_disable_backlight(struct intel_connector *connector);
db31af1d 1676void intel_panel_destroy_backlight(struct drm_connector *connector);
1650be74 1677enum drm_connector_status intel_panel_detect(struct drm_i915_private *dev_priv);
ec9ed197 1678extern struct drm_display_mode *intel_find_panel_downclock(
a318b4c4 1679 struct drm_i915_private *dev_priv,
ec9ed197
VK
1680 struct drm_display_mode *fixed_mode,
1681 struct drm_connector *connector);
e63d87c0
CW
1682
1683#if IS_ENABLED(CONFIG_BACKLIGHT_CLASS_DEVICE)
1ebaa0b9 1684int intel_backlight_device_register(struct intel_connector *connector);
e63d87c0
CW
1685void intel_backlight_device_unregister(struct intel_connector *connector);
1686#else /* CONFIG_BACKLIGHT_CLASS_DEVICE */
1ebaa0b9
CW
1687static int intel_backlight_device_register(struct intel_connector *connector)
1688{
1689 return 0;
1690}
e63d87c0
CW
1691static inline void intel_backlight_device_unregister(struct intel_connector *connector)
1692{
1693}
1694#endif /* CONFIG_BACKLIGHT_CLASS_DEVICE */
0962c3c9 1695
5f1aae65 1696
0bc12bcb 1697/* intel_psr.c */
0bc12bcb
RV
1698void intel_psr_enable(struct intel_dp *intel_dp);
1699void intel_psr_disable(struct intel_dp *intel_dp);
5748b6a1 1700void intel_psr_invalidate(struct drm_i915_private *dev_priv,
20c8838b 1701 unsigned frontbuffer_bits);
5748b6a1 1702void intel_psr_flush(struct drm_i915_private *dev_priv,
169de131
RV
1703 unsigned frontbuffer_bits,
1704 enum fb_op_origin origin);
c39055b0 1705void intel_psr_init(struct drm_i915_private *dev_priv);
5748b6a1 1706void intel_psr_single_frame_update(struct drm_i915_private *dev_priv,
20c8838b 1707 unsigned frontbuffer_bits);
0bc12bcb 1708
9c065a7d
DV
1709/* intel_runtime_pm.c */
1710int intel_power_domains_init(struct drm_i915_private *);
f458ebbc 1711void intel_power_domains_fini(struct drm_i915_private *);
73dfc227
ID
1712void intel_power_domains_init_hw(struct drm_i915_private *dev_priv, bool resume);
1713void intel_power_domains_suspend(struct drm_i915_private *dev_priv);
8d8c386c 1714void intel_power_domains_verify_state(struct drm_i915_private *dev_priv);
d7d7c9ee
ID
1715void bxt_display_core_init(struct drm_i915_private *dev_priv, bool resume);
1716void bxt_display_core_uninit(struct drm_i915_private *dev_priv);
f458ebbc 1717void intel_runtime_pm_enable(struct drm_i915_private *dev_priv);
9895ad03
DS
1718const char *
1719intel_display_power_domain_str(enum intel_display_power_domain domain);
9c065a7d 1720
f458ebbc
DV
1721bool intel_display_power_is_enabled(struct drm_i915_private *dev_priv,
1722 enum intel_display_power_domain domain);
1723bool __intel_display_power_is_enabled(struct drm_i915_private *dev_priv,
1724 enum intel_display_power_domain domain);
9c065a7d
DV
1725void intel_display_power_get(struct drm_i915_private *dev_priv,
1726 enum intel_display_power_domain domain);
09731280
ID
1727bool intel_display_power_get_if_enabled(struct drm_i915_private *dev_priv,
1728 enum intel_display_power_domain domain);
9c065a7d
DV
1729void intel_display_power_put(struct drm_i915_private *dev_priv,
1730 enum intel_display_power_domain domain);
da5827c3
ID
1731
1732static inline void
1733assert_rpm_device_not_suspended(struct drm_i915_private *dev_priv)
1734{
1735 WARN_ONCE(dev_priv->pm.suspended,
1736 "Device suspended during HW access\n");
1737}
1738
1739static inline void
1740assert_rpm_wakelock_held(struct drm_i915_private *dev_priv)
1741{
1742 assert_rpm_device_not_suspended(dev_priv);
1f58c8e7
CW
1743 WARN_ONCE(!atomic_read(&dev_priv->pm.wakeref_count),
1744 "RPM wakelock ref not held during HW access");
da5827c3
ID
1745}
1746
1f814dac
ID
1747/**
1748 * disable_rpm_wakeref_asserts - disable the RPM assert checks
1749 * @dev_priv: i915 device instance
1750 *
1751 * This function disable asserts that check if we hold an RPM wakelock
1752 * reference, while keeping the device-not-suspended checks still enabled.
1753 * It's meant to be used only in special circumstances where our rule about
1754 * the wakelock refcount wrt. the device power state doesn't hold. According
1755 * to this rule at any point where we access the HW or want to keep the HW in
1756 * an active state we must hold an RPM wakelock reference acquired via one of
1757 * the intel_runtime_pm_get() helpers. Currently there are a few special spots
1758 * where this rule doesn't hold: the IRQ and suspend/resume handlers, the
1759 * forcewake release timer, and the GPU RPS and hangcheck works. All other
1760 * users should avoid using this function.
1761 *
1762 * Any calls to this function must have a symmetric call to
1763 * enable_rpm_wakeref_asserts().
1764 */
1765static inline void
1766disable_rpm_wakeref_asserts(struct drm_i915_private *dev_priv)
1767{
1768 atomic_inc(&dev_priv->pm.wakeref_count);
1769}
1770
1771/**
1772 * enable_rpm_wakeref_asserts - re-enable the RPM assert checks
1773 * @dev_priv: i915 device instance
1774 *
1775 * This function re-enables the RPM assert checks after disabling them with
1776 * disable_rpm_wakeref_asserts. It's meant to be used only in special
1777 * circumstances otherwise its use should be avoided.
1778 *
1779 * Any calls to this function must have a symmetric call to
1780 * disable_rpm_wakeref_asserts().
1781 */
1782static inline void
1783enable_rpm_wakeref_asserts(struct drm_i915_private *dev_priv)
1784{
1785 atomic_dec(&dev_priv->pm.wakeref_count);
1786}
1787
9c065a7d 1788void intel_runtime_pm_get(struct drm_i915_private *dev_priv);
09731280 1789bool intel_runtime_pm_get_if_in_use(struct drm_i915_private *dev_priv);
9c065a7d
DV
1790void intel_runtime_pm_get_noresume(struct drm_i915_private *dev_priv);
1791void intel_runtime_pm_put(struct drm_i915_private *dev_priv);
1792
d9bc89d9
DV
1793void intel_display_set_init_power(struct drm_i915_private *dev, bool enable);
1794
e0fce78f
VS
1795void chv_phy_powergate_lanes(struct intel_encoder *encoder,
1796 bool override, unsigned int mask);
b0b33846
VS
1797bool chv_phy_powergate_ch(struct drm_i915_private *dev_priv, enum dpio_phy phy,
1798 enum dpio_channel ch, bool override);
e0fce78f
VS
1799
1800
5f1aae65 1801/* intel_pm.c */
46f16e63 1802void intel_init_clock_gating(struct drm_i915_private *dev_priv);
712bf364 1803void intel_suspend_hw(struct drm_i915_private *dev_priv);
5db94019 1804int ilk_wm_max_level(const struct drm_i915_private *dev_priv);
432081bc 1805void intel_update_watermarks(struct intel_crtc *crtc);
62d75df7 1806void intel_init_pm(struct drm_i915_private *dev_priv);
bb400da9 1807void intel_init_clock_gating_hooks(struct drm_i915_private *dev_priv);
192aa181 1808void intel_pm_setup(struct drm_i915_private *dev_priv);
87440425
PZ
1809void intel_gpu_ips_init(struct drm_i915_private *dev_priv);
1810void intel_gpu_ips_teardown(void);
dc97997a 1811void intel_init_gt_powersave(struct drm_i915_private *dev_priv);
54b4f68f
CW
1812void intel_cleanup_gt_powersave(struct drm_i915_private *dev_priv);
1813void intel_sanitize_gt_powersave(struct drm_i915_private *dev_priv);
dc97997a 1814void intel_enable_gt_powersave(struct drm_i915_private *dev_priv);
54b4f68f 1815void intel_autoenable_gt_powersave(struct drm_i915_private *dev_priv);
dc97997a 1816void intel_disable_gt_powersave(struct drm_i915_private *dev_priv);
54b4f68f 1817void intel_suspend_gt_powersave(struct drm_i915_private *dev_priv);
43cf3bf0
CW
1818void gen6_rps_busy(struct drm_i915_private *dev_priv);
1819void gen6_rps_reset_ei(struct drm_i915_private *dev_priv);
076e29f2 1820void gen6_rps_idle(struct drm_i915_private *dev_priv);
1854d5ca 1821void gen6_rps_boost(struct drm_i915_private *dev_priv,
e61b9958
CW
1822 struct intel_rps_client *rps,
1823 unsigned long submitted);
91d14251 1824void intel_queue_rps_boost_for_request(struct drm_i915_gem_request *req);
6eb1a681 1825void vlv_wm_get_hw_state(struct drm_device *dev);
243e6a44 1826void ilk_wm_get_hw_state(struct drm_device *dev);
3078999f 1827void skl_wm_get_hw_state(struct drm_device *dev);
08db6652
DL
1828void skl_ddb_get_hw_state(struct drm_i915_private *dev_priv,
1829 struct skl_ddb_allocation *ddb /* out */);
bf9d99ad 1830void skl_pipe_wm_get_hw_state(struct drm_crtc *crtc,
1831 struct skl_pipe_wm *out);
16dcdc4e
PZ
1832bool intel_can_enable_sagv(struct drm_atomic_state *state);
1833int intel_enable_sagv(struct drm_i915_private *dev_priv);
1834int intel_disable_sagv(struct drm_i915_private *dev_priv);
45ece230 1835bool skl_wm_level_equals(const struct skl_wm_level *l1,
1836 const struct skl_wm_level *l2);
5eff503b
ML
1837bool skl_ddb_allocation_overlaps(const struct skl_ddb_entry **entries,
1838 const struct skl_ddb_entry *ddb,
1839 int ignore);
ed4a6a7c 1840bool ilk_disable_lp_wm(struct drm_device *dev);
dc97997a
CW
1841int sanitize_rc6_option(struct drm_i915_private *dev_priv, int enable_rc6);
1842static inline int intel_enable_rc6(void)
1843{
1844 return i915.enable_rc6;
1845}
72662e10 1846
5f1aae65 1847/* intel_sdvo.c */
c39055b0 1848bool intel_sdvo_init(struct drm_i915_private *dev_priv,
f0f59a00 1849 i915_reg_t reg, enum port port);
96a02917 1850
2b28bb1b 1851
5f1aae65 1852/* intel_sprite.c */
dfd2e9ab
VS
1853int intel_usecs_to_scanlines(const struct drm_display_mode *adjusted_mode,
1854 int usecs);
580503c7 1855struct intel_plane *intel_sprite_plane_create(struct drm_i915_private *dev_priv,
b079bd17 1856 enum pipe pipe, int plane);
87440425
PZ
1857int intel_sprite_set_colorkey(struct drm_device *dev, void *data,
1858 struct drm_file *file_priv);
34e0adbb 1859void intel_pipe_update_start(struct intel_crtc *crtc);
51cbaf01 1860void intel_pipe_update_end(struct intel_crtc *crtc, struct intel_flip_work *work);
5f1aae65
PZ
1861
1862/* intel_tv.c */
c39055b0 1863void intel_tv_init(struct drm_i915_private *dev_priv);
20ddf665 1864
ea2c67bb 1865/* intel_atomic.c */
2545e4a6
MR
1866int intel_connector_atomic_get_property(struct drm_connector *connector,
1867 const struct drm_connector_state *state,
1868 struct drm_property *property,
1869 uint64_t *val);
1356837e
MR
1870struct drm_crtc_state *intel_crtc_duplicate_state(struct drm_crtc *crtc);
1871void intel_crtc_destroy_state(struct drm_crtc *crtc,
1872 struct drm_crtc_state *state);
de419ab6
ML
1873struct drm_atomic_state *intel_atomic_state_alloc(struct drm_device *dev);
1874void intel_atomic_state_clear(struct drm_atomic_state *);
de419ab6 1875
10f81c19
ACO
1876static inline struct intel_crtc_state *
1877intel_atomic_get_crtc_state(struct drm_atomic_state *state,
1878 struct intel_crtc *crtc)
1879{
1880 struct drm_crtc_state *crtc_state;
1881 crtc_state = drm_atomic_get_crtc_state(state, &crtc->base);
1882 if (IS_ERR(crtc_state))
0b6cc188 1883 return ERR_CAST(crtc_state);
10f81c19
ACO
1884
1885 return to_intel_crtc_state(crtc_state);
1886}
e3bddded 1887
ccc24b39
MK
1888static inline struct intel_crtc_state *
1889intel_atomic_get_existing_crtc_state(struct drm_atomic_state *state,
1890 struct intel_crtc *crtc)
1891{
1892 struct drm_crtc_state *crtc_state;
1893
1894 crtc_state = drm_atomic_get_existing_crtc_state(state, &crtc->base);
1895
1896 if (crtc_state)
1897 return to_intel_crtc_state(crtc_state);
1898 else
1899 return NULL;
1900}
1901
e3bddded
ML
1902static inline struct intel_plane_state *
1903intel_atomic_get_existing_plane_state(struct drm_atomic_state *state,
1904 struct intel_plane *plane)
1905{
1906 struct drm_plane_state *plane_state;
1907
1908 plane_state = drm_atomic_get_existing_plane_state(state, &plane->base);
1909
1910 return to_intel_plane_state(plane_state);
1911}
1912
6ebc6923
ACO
1913int intel_atomic_setup_scalers(struct drm_i915_private *dev_priv,
1914 struct intel_crtc *intel_crtc,
1915 struct intel_crtc_state *crtc_state);
5ee67f1c
MR
1916
1917/* intel_atomic_plane.c */
8e7d688b 1918struct intel_plane_state *intel_create_plane_state(struct drm_plane *plane);
ea2c67bb
MR
1919struct drm_plane_state *intel_plane_duplicate_state(struct drm_plane *plane);
1920void intel_plane_destroy_state(struct drm_plane *plane,
1921 struct drm_plane_state *state);
1922extern const struct drm_plane_helper_funcs intel_plane_helper_funcs;
f79f2692
ML
1923int intel_plane_atomic_check_with_state(struct intel_crtc_state *crtc_state,
1924 struct intel_plane_state *intel_state);
ea2c67bb 1925
8563b1e8
LL
1926/* intel_color.c */
1927void intel_color_init(struct drm_crtc *crtc);
82cf435b 1928int intel_color_check(struct drm_crtc *crtc, struct drm_crtc_state *state);
b95c5321
ML
1929void intel_color_set_csc(struct drm_crtc_state *crtc_state);
1930void intel_color_load_luts(struct drm_crtc_state *crtc_state);
8563b1e8 1931
dbe9e61b
SS
1932/* intel_lspcon.c */
1933bool lspcon_init(struct intel_digital_port *intel_dig_port);
910530c0 1934void lspcon_resume(struct intel_lspcon *lspcon);
357c0ae9 1935void lspcon_wait_pcon_mode(struct intel_lspcon *lspcon);
731035fe
TV
1936
1937/* intel_pipe_crc.c */
1938int intel_pipe_crc_create(struct drm_minor *minor);
1939void intel_pipe_crc_cleanup(struct drm_minor *minor);
8c6b709d
TV
1940#ifdef CONFIG_DEBUG_FS
1941int intel_crtc_set_crc_source(struct drm_crtc *crtc, const char *source_name,
1942 size_t *values_cnt);
1943#else
1944#define intel_crtc_set_crc_source NULL
1945#endif
731035fe 1946extern const struct file_operations i915_display_crc_ctl_fops;
79e53945 1947#endif /* __INTEL_DRV_H__ */