2 * Copyright (c) 2006 Dave Airlie <airlied@linux.ie>
3 * Copyright (c) 2007-2008 Intel Corporation
4 * Jesse Barnes <jesse.barnes@intel.com>
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:
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
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
25 #ifndef __INTEL_DRV_H__
26 #define __INTEL_DRV_H__
28 #include <linux/i2c.h>
29 #include <drm/i915_drm.h>
31 #include <drm/drm_crtc.h>
32 #include <drm/drm_crtc_helper.h>
33 #include <drm/drm_fb_helper.h>
34 #include <drm/drm_dp_helper.h>
36 #define _wait_for(COND, MS, W) ({ \
37 unsigned long timeout__ = jiffies + msecs_to_jiffies(MS); \
40 if (time_after(jiffies, timeout__)) { \
44 if (W && drm_can_sleep()) { \
53 #define wait_for_atomic_us(COND, US) ({ \
54 unsigned long timeout__ = jiffies + usecs_to_jiffies(US); \
57 if (time_after(jiffies, timeout__)) { \
66 #define wait_for(COND, MS) _wait_for(COND, MS, 1)
67 #define wait_for_atomic(COND, MS) _wait_for(COND, MS, 0)
69 #define KHz(x) (1000*x)
70 #define MHz(x) KHz(1000*x)
73 * Display related stuff
76 /* store information about an Ixxx DVO */
77 /* The i830->i865 use multiple DVOs with multiple i2cs */
78 /* the i915, i945 have a single sDVO i2c bus - which is different */
80 /* maximum connectors per crtcs in the mode set */
81 #define INTELFB_CONN_LIMIT 4
83 #define INTEL_I2C_BUS_DVO 1
84 #define INTEL_I2C_BUS_SDVO 2
86 /* these are outputs from the chip - integrated only
87 external chips are via DVO or SDVO output */
88 #define INTEL_OUTPUT_UNUSED 0
89 #define INTEL_OUTPUT_ANALOG 1
90 #define INTEL_OUTPUT_DVO 2
91 #define INTEL_OUTPUT_SDVO 3
92 #define INTEL_OUTPUT_LVDS 4
93 #define INTEL_OUTPUT_TVOUT 5
94 #define INTEL_OUTPUT_HDMI 6
95 #define INTEL_OUTPUT_DISPLAYPORT 7
96 #define INTEL_OUTPUT_EDP 8
98 #define INTEL_DVO_CHIP_NONE 0
99 #define INTEL_DVO_CHIP_LVDS 1
100 #define INTEL_DVO_CHIP_TMDS 2
101 #define INTEL_DVO_CHIP_TVOUT 4
103 /* drm_display_mode->private_flags */
104 #define INTEL_MODE_PIXEL_MULTIPLIER_SHIFT (0x0)
105 #define INTEL_MODE_PIXEL_MULTIPLIER_MASK (0xf << INTEL_MODE_PIXEL_MULTIPLIER_SHIFT)
106 #define INTEL_MODE_DP_FORCE_6BPC (0x10)
107 /* This flag must be set by the encoder's mode_fixup if it changes the crtc
108 * timings in the mode to prevent the crtc fixup from overwriting them.
109 * Currently only lvds needs that. */
110 #define INTEL_MODE_CRTC_TIMINGS_SET (0x20)
113 intel_mode_set_pixel_multiplier(struct drm_display_mode *mode,
116 mode->clock *= multiplier;
117 mode->private_flags |= multiplier;
121 intel_mode_get_pixel_multiplier(const struct drm_display_mode *mode)
123 return (mode->private_flags & INTEL_MODE_PIXEL_MULTIPLIER_MASK) >> INTEL_MODE_PIXEL_MULTIPLIER_SHIFT;
126 struct intel_framebuffer {
127 struct drm_framebuffer base;
128 struct drm_i915_gem_object *obj;
132 struct drm_fb_helper helper;
133 struct intel_framebuffer ifb;
134 struct list_head fbdev_list;
135 struct drm_display_mode *our_mode;
138 struct intel_encoder {
139 struct drm_encoder base;
141 * The new crtc this encoder will be driven from. Only differs from
142 * base->crtc while a modeset is in progress.
144 struct intel_crtc *new_crtc;
149 * Intel hw has only one MUX where encoders could be clone, hence a
150 * simple flag is enough to compute the possible_clones mask.
153 bool connectors_active;
154 void (*hot_plug)(struct intel_encoder *);
155 void (*pre_enable)(struct intel_encoder *);
156 void (*enable)(struct intel_encoder *);
157 void (*disable)(struct intel_encoder *);
158 void (*post_disable)(struct intel_encoder *);
159 /* Read out the current hw state of this connector, returning true if
160 * the encoder is active. If the encoder is enabled it also set the pipe
161 * it is connected to in the pipe parameter. */
162 bool (*get_hw_state)(struct intel_encoder *, enum pipe *pipe);
167 struct drm_display_mode *fixed_mode;
170 struct intel_connector {
171 struct drm_connector base;
173 * The fixed encoder this connector is connected to.
175 struct intel_encoder *encoder;
178 * The new encoder this connector will be driven. Only differs from
179 * encoder while a modeset is in progress.
181 struct intel_encoder *new_encoder;
183 /* Reads out the current hw, returning true if the connector is enabled
184 * and active (i.e. dpms ON state). */
185 bool (*get_hw_state)(struct intel_connector *);
187 /* Panel info for eDP and LVDS */
188 struct intel_panel panel;
190 /* Cached EDID for eDP and LVDS. May hold ERR_PTR for invalid EDID. */
195 struct drm_crtc base;
198 u8 lut_r[256], lut_g[256], lut_b[256];
200 * Whether the crtc and the connected output pipeline is active. Implies
201 * that crtc->enabled is set, i.e. the current mode configuration has
202 * some outputs connected to this crtc.
205 bool primary_disabled; /* is the crtc obscured by a plane? */
207 struct intel_overlay *overlay;
208 struct intel_unpin_work *unpin_work;
211 /* Display surface base address adjustement for pageflips. Note that on
212 * gen4+ this only adjusts up to a tile, offsets within a tile are
213 * handled in the hw itself (with the TILEOFF register). */
214 unsigned long dspaddr_offset;
216 struct drm_i915_gem_object *cursor_bo;
217 uint32_t cursor_addr;
218 int16_t cursor_x, cursor_y;
219 int16_t cursor_width, cursor_height;
223 /* We can share PLLs across outputs if the timings match */
224 struct intel_pch_pll *pch_pll;
225 uint32_t ddi_pll_sel;
229 struct drm_plane base;
231 struct drm_i915_gem_object *obj;
234 u32 lut_r[1024], lut_g[1024], lut_b[1024];
235 void (*update_plane)(struct drm_plane *plane,
236 struct drm_framebuffer *fb,
237 struct drm_i915_gem_object *obj,
238 int crtc_x, int crtc_y,
239 unsigned int crtc_w, unsigned int crtc_h,
240 uint32_t x, uint32_t y,
241 uint32_t src_w, uint32_t src_h);
242 void (*disable_plane)(struct drm_plane *plane);
243 int (*update_colorkey)(struct drm_plane *plane,
244 struct drm_intel_sprite_colorkey *key);
245 void (*get_colorkey)(struct drm_plane *plane,
246 struct drm_intel_sprite_colorkey *key);
249 struct intel_watermark_params {
250 unsigned long fifo_size;
251 unsigned long max_wm;
252 unsigned long default_wm;
253 unsigned long guard_size;
254 unsigned long cacheline_size;
257 struct cxsr_latency {
260 unsigned long fsb_freq;
261 unsigned long mem_freq;
262 unsigned long display_sr;
263 unsigned long display_hpll_disable;
264 unsigned long cursor_sr;
265 unsigned long cursor_hpll_disable;
268 #define to_intel_crtc(x) container_of(x, struct intel_crtc, base)
269 #define to_intel_connector(x) container_of(x, struct intel_connector, base)
270 #define to_intel_encoder(x) container_of(x, struct intel_encoder, base)
271 #define to_intel_framebuffer(x) container_of(x, struct intel_framebuffer, base)
272 #define to_intel_plane(x) container_of(x, struct intel_plane, base)
274 #define DIP_HEADER_SIZE 5
276 #define DIP_TYPE_AVI 0x82
277 #define DIP_VERSION_AVI 0x2
278 #define DIP_LEN_AVI 13
279 #define DIP_AVI_PR_1 0
280 #define DIP_AVI_PR_2 1
282 #define DIP_TYPE_SPD 0x83
283 #define DIP_VERSION_SPD 0x1
284 #define DIP_LEN_SPD 25
285 #define DIP_SPD_UNKNOWN 0
286 #define DIP_SPD_DSTB 0x1
287 #define DIP_SPD_DVDP 0x2
288 #define DIP_SPD_DVHS 0x3
289 #define DIP_SPD_HDDVR 0x4
290 #define DIP_SPD_DVC 0x5
291 #define DIP_SPD_DSC 0x6
292 #define DIP_SPD_VCD 0x7
293 #define DIP_SPD_GAME 0x8
294 #define DIP_SPD_PC 0x9
295 #define DIP_SPD_BD 0xa
296 #define DIP_SPD_SCD 0xb
298 struct dip_infoframe {
299 uint8_t type; /* HB0 */
300 uint8_t ver; /* HB1 */
301 uint8_t len; /* HB2 - body len, not including checksum */
302 uint8_t ecc; /* Header ECC */
303 uint8_t checksum; /* PB0 */
306 /* PB1 - Y 6:5, A 4:4, B 3:2, S 1:0 */
308 /* PB2 - C 7:6, M 5:4, R 3:0 */
310 /* PB3 - ITC 7:7, EC 6:4, Q 3:2, SC 1:0 */
314 /* PB5 - YQ 7:6, CN 5:4, PR 3:0 */
317 uint16_t top_bar_end;
318 uint16_t bottom_bar_start;
319 uint16_t left_bar_end;
320 uint16_t right_bar_start;
321 } __attribute__ ((packed)) avi;
326 } __attribute__ ((packed)) spd;
328 } __attribute__ ((packed)) body;
329 } __attribute__((packed));
332 struct intel_encoder base;
336 uint32_t color_range;
339 enum hdmi_force_audio force_audio;
340 void (*write_infoframe)(struct drm_encoder *encoder,
341 struct dip_infoframe *frame);
342 void (*set_infoframes)(struct drm_encoder *encoder,
343 struct drm_display_mode *adjusted_mode);
346 #define DP_RECEIVER_CAP_SIZE 0xf
347 #define DP_MAX_DOWNSTREAM_PORTS 0x10
348 #define DP_LINK_CONFIGURATION_SIZE 9
351 struct intel_encoder base;
354 uint8_t link_configuration[DP_LINK_CONFIGURATION_SIZE];
356 enum hdmi_force_audio force_audio;
358 uint32_t color_range;
361 uint8_t dpcd[DP_RECEIVER_CAP_SIZE];
362 uint8_t downstream_ports[DP_MAX_DOWNSTREAM_PORTS];
363 struct i2c_adapter adapter;
364 struct i2c_algo_dp_aux_data algo;
366 uint8_t train_set[4];
367 int panel_power_up_delay;
368 int panel_power_down_delay;
369 int panel_power_cycle_delay;
370 int backlight_on_delay;
371 int backlight_off_delay;
372 struct delayed_work panel_vdd_work;
374 struct intel_connector *attached_connector;
377 static inline struct drm_crtc *
378 intel_get_crtc_for_pipe(struct drm_device *dev, int pipe)
380 struct drm_i915_private *dev_priv = dev->dev_private;
381 return dev_priv->pipe_to_crtc_mapping[pipe];
384 static inline struct drm_crtc *
385 intel_get_crtc_for_plane(struct drm_device *dev, int plane)
387 struct drm_i915_private *dev_priv = dev->dev_private;
388 return dev_priv->plane_to_crtc_mapping[plane];
391 struct intel_unpin_work {
392 struct work_struct work;
393 struct drm_device *dev;
394 struct drm_i915_gem_object *old_fb_obj;
395 struct drm_i915_gem_object *pending_flip_obj;
396 struct drm_pending_vblank_event *event;
398 bool enable_stall_check;
401 struct intel_fbc_work {
402 struct delayed_work work;
403 struct drm_crtc *crtc;
404 struct drm_framebuffer *fb;
408 int intel_pch_rawclk(struct drm_device *dev);
410 int intel_connector_update_modes(struct drm_connector *connector,
412 int intel_ddc_get_modes(struct drm_connector *c, struct i2c_adapter *adapter);
414 extern void intel_attach_force_audio_property(struct drm_connector *connector);
415 extern void intel_attach_broadcast_rgb_property(struct drm_connector *connector);
417 extern void intel_crt_init(struct drm_device *dev);
418 extern void intel_hdmi_init(struct drm_device *dev,
419 int sdvox_reg, enum port port);
420 extern struct intel_hdmi *enc_to_intel_hdmi(struct drm_encoder *encoder);
421 extern void intel_dip_infoframe_csum(struct dip_infoframe *avi_if);
422 extern bool intel_sdvo_init(struct drm_device *dev, uint32_t sdvo_reg,
424 extern void intel_dvo_init(struct drm_device *dev);
425 extern void intel_tv_init(struct drm_device *dev);
426 extern void intel_mark_busy(struct drm_device *dev);
427 extern void intel_mark_idle(struct drm_device *dev);
428 extern void intel_mark_fb_busy(struct drm_i915_gem_object *obj);
429 extern void intel_mark_fb_idle(struct drm_i915_gem_object *obj);
430 extern bool intel_lvds_init(struct drm_device *dev);
431 extern void intel_dp_init(struct drm_device *dev, int output_reg,
434 intel_dp_set_m_n(struct drm_crtc *crtc, struct drm_display_mode *mode,
435 struct drm_display_mode *adjusted_mode);
436 extern void intel_dp_init_link_config(struct intel_dp *intel_dp);
437 extern void intel_dp_start_link_train(struct intel_dp *intel_dp);
438 extern void intel_dp_complete_link_train(struct intel_dp *intel_dp);
439 extern void intel_dp_sink_dpms(struct intel_dp *intel_dp, int mode);
440 extern bool intel_dpd_is_edp(struct drm_device *dev);
441 extern void intel_edp_link_config(struct intel_encoder *, int *, int *);
442 extern int intel_edp_target_clock(struct intel_encoder *,
443 struct drm_display_mode *mode);
444 extern bool intel_encoder_is_pch_edp(struct drm_encoder *encoder);
445 extern int intel_plane_init(struct drm_device *dev, enum pipe pipe);
446 extern void intel_flush_display_plane(struct drm_i915_private *dev_priv,
450 extern int intel_panel_init(struct intel_panel *panel,
451 struct drm_display_mode *fixed_mode);
452 extern void intel_panel_fini(struct intel_panel *panel);
454 extern void intel_fixed_panel_mode(struct drm_display_mode *fixed_mode,
455 struct drm_display_mode *adjusted_mode);
456 extern void intel_pch_panel_fitting(struct drm_device *dev,
458 const struct drm_display_mode *mode,
459 struct drm_display_mode *adjusted_mode);
460 extern u32 intel_panel_get_max_backlight(struct drm_device *dev);
461 extern void intel_panel_set_backlight(struct drm_device *dev, u32 level);
462 extern int intel_panel_setup_backlight(struct drm_connector *connector);
463 extern void intel_panel_enable_backlight(struct drm_device *dev,
465 extern void intel_panel_disable_backlight(struct drm_device *dev);
466 extern void intel_panel_destroy_backlight(struct drm_device *dev);
467 extern enum drm_connector_status intel_panel_detect(struct drm_device *dev);
469 struct intel_set_config {
470 struct drm_encoder **save_connector_encoders;
471 struct drm_crtc **save_encoder_crtcs;
477 extern bool intel_set_mode(struct drm_crtc *crtc, struct drm_display_mode *mode,
478 int x, int y, struct drm_framebuffer *old_fb);
479 extern void intel_modeset_disable(struct drm_device *dev);
480 extern void intel_crtc_load_lut(struct drm_crtc *crtc);
481 extern void intel_crtc_update_dpms(struct drm_crtc *crtc);
482 extern void intel_encoder_noop(struct drm_encoder *encoder);
483 extern void intel_encoder_destroy(struct drm_encoder *encoder);
484 extern void intel_encoder_dpms(struct intel_encoder *encoder, int mode);
485 extern bool intel_encoder_check_is_cloned(struct intel_encoder *encoder);
486 extern void intel_connector_dpms(struct drm_connector *, int mode);
487 extern bool intel_connector_get_hw_state(struct intel_connector *connector);
488 extern void intel_modeset_check_state(struct drm_device *dev);
491 static inline struct intel_encoder *intel_attached_encoder(struct drm_connector *connector)
493 return to_intel_connector(connector)->encoder;
496 static inline struct intel_dp *enc_to_intel_dp(struct drm_encoder *encoder)
498 return container_of(encoder, struct intel_dp, base.base);
501 extern void intel_connector_attach_encoder(struct intel_connector *connector,
502 struct intel_encoder *encoder);
503 extern struct drm_encoder *intel_best_encoder(struct drm_connector *connector);
505 extern struct drm_display_mode *intel_crtc_mode_get(struct drm_device *dev,
506 struct drm_crtc *crtc);
507 int intel_get_pipe_from_crtc_id(struct drm_device *dev, void *data,
508 struct drm_file *file_priv);
509 extern void intel_wait_for_vblank(struct drm_device *dev, int pipe);
510 extern void intel_wait_for_pipe_off(struct drm_device *dev, int pipe);
512 struct intel_load_detect_pipe {
513 struct drm_framebuffer *release_fb;
514 bool load_detect_temp;
517 extern bool intel_get_load_detect_pipe(struct drm_connector *connector,
518 struct drm_display_mode *mode,
519 struct intel_load_detect_pipe *old);
520 extern void intel_release_load_detect_pipe(struct drm_connector *connector,
521 struct intel_load_detect_pipe *old);
523 extern void intelfb_restore(void);
524 extern void intel_crtc_fb_gamma_set(struct drm_crtc *crtc, u16 red, u16 green,
525 u16 blue, int regno);
526 extern void intel_crtc_fb_gamma_get(struct drm_crtc *crtc, u16 *red, u16 *green,
527 u16 *blue, int regno);
528 extern void intel_enable_clock_gating(struct drm_device *dev);
530 extern int intel_pin_and_fence_fb_obj(struct drm_device *dev,
531 struct drm_i915_gem_object *obj,
532 struct intel_ring_buffer *pipelined);
533 extern void intel_unpin_fb_obj(struct drm_i915_gem_object *obj);
535 extern int intel_framebuffer_init(struct drm_device *dev,
536 struct intel_framebuffer *ifb,
537 struct drm_mode_fb_cmd2 *mode_cmd,
538 struct drm_i915_gem_object *obj);
539 extern int intel_fbdev_init(struct drm_device *dev);
540 extern void intel_fbdev_fini(struct drm_device *dev);
541 extern void intel_fbdev_set_suspend(struct drm_device *dev, int state);
542 extern void intel_prepare_page_flip(struct drm_device *dev, int plane);
543 extern void intel_finish_page_flip(struct drm_device *dev, int pipe);
544 extern void intel_finish_page_flip_plane(struct drm_device *dev, int plane);
546 extern void intel_setup_overlay(struct drm_device *dev);
547 extern void intel_cleanup_overlay(struct drm_device *dev);
548 extern int intel_overlay_switch_off(struct intel_overlay *overlay);
549 extern int intel_overlay_put_image(struct drm_device *dev, void *data,
550 struct drm_file *file_priv);
551 extern int intel_overlay_attrs(struct drm_device *dev, void *data,
552 struct drm_file *file_priv);
554 extern void intel_fb_output_poll_changed(struct drm_device *dev);
555 extern void intel_fb_restore_mode(struct drm_device *dev);
557 extern void assert_pipe(struct drm_i915_private *dev_priv, enum pipe pipe,
559 #define assert_pipe_enabled(d, p) assert_pipe(d, p, true)
560 #define assert_pipe_disabled(d, p) assert_pipe(d, p, false)
562 extern void intel_init_clock_gating(struct drm_device *dev);
563 extern void intel_write_eld(struct drm_encoder *encoder,
564 struct drm_display_mode *mode);
565 extern void intel_cpt_verify_modeset(struct drm_device *dev, int pipe);
566 extern void intel_prepare_ddi(struct drm_device *dev);
567 extern void hsw_fdi_link_train(struct drm_crtc *crtc);
568 extern void intel_ddi_init(struct drm_device *dev, enum port port);
570 /* For use by IVB LP watermark workaround in intel_sprite.c */
571 extern void intel_update_watermarks(struct drm_device *dev);
572 extern void intel_update_sprite_watermarks(struct drm_device *dev, int pipe,
573 uint32_t sprite_width,
575 extern void intel_update_linetime_watermarks(struct drm_device *dev, int pipe,
576 struct drm_display_mode *mode);
578 extern int intel_sprite_set_colorkey(struct drm_device *dev, void *data,
579 struct drm_file *file_priv);
580 extern int intel_sprite_get_colorkey(struct drm_device *dev, void *data,
581 struct drm_file *file_priv);
583 extern u32 intel_dpio_read(struct drm_i915_private *dev_priv, int reg);
585 /* Power-related functions, located in intel_pm.c */
586 extern void intel_init_pm(struct drm_device *dev);
588 extern bool intel_fbc_enabled(struct drm_device *dev);
589 extern void intel_enable_fbc(struct drm_crtc *crtc, unsigned long interval);
590 extern void intel_update_fbc(struct drm_device *dev);
592 extern void intel_gpu_ips_init(struct drm_i915_private *dev_priv);
593 extern void intel_gpu_ips_teardown(void);
595 extern void intel_init_power_wells(struct drm_device *dev);
596 extern void intel_enable_gt_powersave(struct drm_device *dev);
597 extern void intel_disable_gt_powersave(struct drm_device *dev);
598 extern void gen6_gt_check_fifodbg(struct drm_i915_private *dev_priv);
599 extern void ironlake_teardown_rc6(struct drm_device *dev);
601 extern void intel_enable_ddi(struct intel_encoder *encoder);
602 extern void intel_disable_ddi(struct intel_encoder *encoder);
603 extern bool intel_ddi_get_hw_state(struct intel_encoder *encoder,
605 extern void intel_ddi_mode_set(struct drm_encoder *encoder,
606 struct drm_display_mode *mode,
607 struct drm_display_mode *adjusted_mode);
608 extern void intel_ddi_pll_init(struct drm_device *dev);
609 extern void intel_ddi_enable_pipe_func(struct drm_crtc *crtc);
610 extern void intel_ddi_disable_pipe_func(struct drm_i915_private *dev_priv,
612 extern void intel_ddi_enable_pipe_clock(struct intel_crtc *intel_crtc);
613 extern void intel_ddi_disable_pipe_clock(struct intel_crtc *intel_crtc);
614 extern void intel_ddi_setup_hw_pll_state(struct drm_device *dev);
615 extern bool intel_ddi_pll_mode_set(struct drm_crtc *crtc, int clock);
616 extern void intel_ddi_pre_enable(struct intel_encoder *intel_encoder);
617 extern void intel_ddi_post_disable(struct intel_encoder *intel_encoder);
618 extern void intel_ddi_put_crtc_pll(struct drm_crtc *crtc);
619 extern void intel_ddi_set_pipe_settings(struct drm_crtc *crtc);
620 extern void intel_ddi_prepare_link_retrain(struct drm_encoder *encoder);
622 #endif /* __INTEL_DRV_H__ */