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);
169 struct intel_connector {
170 struct drm_connector base;
172 * The fixed encoder this connector is connected to.
174 struct intel_encoder *encoder;
177 * The new encoder this connector will be driven. Only differs from
178 * encoder while a modeset is in progress.
180 struct intel_encoder *new_encoder;
182 /* Reads out the current hw, returning true if the connector is enabled
183 * and active (i.e. dpms ON state). */
184 bool (*get_hw_state)(struct intel_connector *);
186 /* Panel info for eDP and LVDS */
187 struct intel_panel panel;
191 struct drm_crtc base;
194 u8 lut_r[256], lut_g[256], lut_b[256];
196 * Whether the crtc and the connected output pipeline is active. Implies
197 * that crtc->enabled is set, i.e. the current mode configuration has
198 * some outputs connected to this crtc.
201 bool primary_disabled; /* is the crtc obscured by a plane? */
203 struct intel_overlay *overlay;
204 struct intel_unpin_work *unpin_work;
207 /* Display surface base address adjustement for pageflips. Note that on
208 * gen4+ this only adjusts up to a tile, offsets within a tile are
209 * handled in the hw itself (with the TILEOFF register). */
210 unsigned long dspaddr_offset;
212 struct drm_i915_gem_object *cursor_bo;
213 uint32_t cursor_addr;
214 int16_t cursor_x, cursor_y;
215 int16_t cursor_width, cursor_height;
219 /* We can share PLLs across outputs if the timings match */
220 struct intel_pch_pll *pch_pll;
221 uint32_t ddi_pll_sel;
225 struct drm_plane base;
227 struct drm_i915_gem_object *obj;
229 u32 lut_r[1024], lut_g[1024], lut_b[1024];
230 void (*update_plane)(struct drm_plane *plane,
231 struct drm_framebuffer *fb,
232 struct drm_i915_gem_object *obj,
233 int crtc_x, int crtc_y,
234 unsigned int crtc_w, unsigned int crtc_h,
235 uint32_t x, uint32_t y,
236 uint32_t src_w, uint32_t src_h);
237 void (*disable_plane)(struct drm_plane *plane);
238 int (*update_colorkey)(struct drm_plane *plane,
239 struct drm_intel_sprite_colorkey *key);
240 void (*get_colorkey)(struct drm_plane *plane,
241 struct drm_intel_sprite_colorkey *key);
244 struct intel_watermark_params {
245 unsigned long fifo_size;
246 unsigned long max_wm;
247 unsigned long default_wm;
248 unsigned long guard_size;
249 unsigned long cacheline_size;
252 struct cxsr_latency {
255 unsigned long fsb_freq;
256 unsigned long mem_freq;
257 unsigned long display_sr;
258 unsigned long display_hpll_disable;
259 unsigned long cursor_sr;
260 unsigned long cursor_hpll_disable;
263 #define to_intel_crtc(x) container_of(x, struct intel_crtc, base)
264 #define to_intel_connector(x) container_of(x, struct intel_connector, base)
265 #define to_intel_encoder(x) container_of(x, struct intel_encoder, base)
266 #define to_intel_framebuffer(x) container_of(x, struct intel_framebuffer, base)
267 #define to_intel_plane(x) container_of(x, struct intel_plane, base)
269 #define DIP_HEADER_SIZE 5
271 #define DIP_TYPE_AVI 0x82
272 #define DIP_VERSION_AVI 0x2
273 #define DIP_LEN_AVI 13
274 #define DIP_AVI_PR_1 0
275 #define DIP_AVI_PR_2 1
277 #define DIP_TYPE_SPD 0x83
278 #define DIP_VERSION_SPD 0x1
279 #define DIP_LEN_SPD 25
280 #define DIP_SPD_UNKNOWN 0
281 #define DIP_SPD_DSTB 0x1
282 #define DIP_SPD_DVDP 0x2
283 #define DIP_SPD_DVHS 0x3
284 #define DIP_SPD_HDDVR 0x4
285 #define DIP_SPD_DVC 0x5
286 #define DIP_SPD_DSC 0x6
287 #define DIP_SPD_VCD 0x7
288 #define DIP_SPD_GAME 0x8
289 #define DIP_SPD_PC 0x9
290 #define DIP_SPD_BD 0xa
291 #define DIP_SPD_SCD 0xb
293 struct dip_infoframe {
294 uint8_t type; /* HB0 */
295 uint8_t ver; /* HB1 */
296 uint8_t len; /* HB2 - body len, not including checksum */
297 uint8_t ecc; /* Header ECC */
298 uint8_t checksum; /* PB0 */
301 /* PB1 - Y 6:5, A 4:4, B 3:2, S 1:0 */
303 /* PB2 - C 7:6, M 5:4, R 3:0 */
305 /* PB3 - ITC 7:7, EC 6:4, Q 3:2, SC 1:0 */
309 /* PB5 - YQ 7:6, CN 5:4, PR 3:0 */
312 uint16_t top_bar_end;
313 uint16_t bottom_bar_start;
314 uint16_t left_bar_end;
315 uint16_t right_bar_start;
316 } __attribute__ ((packed)) avi;
321 } __attribute__ ((packed)) spd;
323 } __attribute__ ((packed)) body;
324 } __attribute__((packed));
327 struct intel_encoder base;
331 uint32_t color_range;
334 enum hdmi_force_audio force_audio;
335 void (*write_infoframe)(struct drm_encoder *encoder,
336 struct dip_infoframe *frame);
337 void (*set_infoframes)(struct drm_encoder *encoder,
338 struct drm_display_mode *adjusted_mode);
341 #define DP_RECEIVER_CAP_SIZE 0xf
342 #define DP_MAX_DOWNSTREAM_PORTS 0x10
343 #define DP_LINK_CONFIGURATION_SIZE 9
346 struct intel_encoder base;
349 uint8_t link_configuration[DP_LINK_CONFIGURATION_SIZE];
351 enum hdmi_force_audio force_audio;
353 uint32_t color_range;
356 uint8_t dpcd[DP_RECEIVER_CAP_SIZE];
357 uint8_t downstream_ports[DP_MAX_DOWNSTREAM_PORTS];
358 struct i2c_adapter adapter;
359 struct i2c_algo_dp_aux_data algo;
361 uint8_t train_set[4];
362 int panel_power_up_delay;
363 int panel_power_down_delay;
364 int panel_power_cycle_delay;
365 int backlight_on_delay;
366 int backlight_off_delay;
367 struct drm_display_mode *panel_fixed_mode; /* for eDP */
368 struct delayed_work panel_vdd_work;
370 struct edid *edid; /* cached EDID for eDP */
374 static inline struct drm_crtc *
375 intel_get_crtc_for_pipe(struct drm_device *dev, int pipe)
377 struct drm_i915_private *dev_priv = dev->dev_private;
378 return dev_priv->pipe_to_crtc_mapping[pipe];
381 static inline struct drm_crtc *
382 intel_get_crtc_for_plane(struct drm_device *dev, int plane)
384 struct drm_i915_private *dev_priv = dev->dev_private;
385 return dev_priv->plane_to_crtc_mapping[plane];
388 struct intel_unpin_work {
389 struct work_struct work;
390 struct drm_device *dev;
391 struct drm_i915_gem_object *old_fb_obj;
392 struct drm_i915_gem_object *pending_flip_obj;
393 struct drm_pending_vblank_event *event;
395 bool enable_stall_check;
398 struct intel_fbc_work {
399 struct delayed_work work;
400 struct drm_crtc *crtc;
401 struct drm_framebuffer *fb;
405 int intel_connector_update_modes(struct drm_connector *connector,
407 int intel_ddc_get_modes(struct drm_connector *c, struct i2c_adapter *adapter);
409 extern void intel_attach_force_audio_property(struct drm_connector *connector);
410 extern void intel_attach_broadcast_rgb_property(struct drm_connector *connector);
412 extern void intel_crt_init(struct drm_device *dev);
413 extern void intel_hdmi_init(struct drm_device *dev,
414 int sdvox_reg, enum port port);
415 extern struct intel_hdmi *enc_to_intel_hdmi(struct drm_encoder *encoder);
416 extern void intel_dip_infoframe_csum(struct dip_infoframe *avi_if);
417 extern bool intel_sdvo_init(struct drm_device *dev, uint32_t sdvo_reg,
419 extern void intel_dvo_init(struct drm_device *dev);
420 extern void intel_tv_init(struct drm_device *dev);
421 extern void intel_mark_busy(struct drm_device *dev);
422 extern void intel_mark_idle(struct drm_device *dev);
423 extern void intel_mark_fb_busy(struct drm_i915_gem_object *obj);
424 extern void intel_mark_fb_idle(struct drm_i915_gem_object *obj);
425 extern bool intel_lvds_init(struct drm_device *dev);
426 extern void intel_dp_init(struct drm_device *dev, int output_reg,
429 intel_dp_set_m_n(struct drm_crtc *crtc, struct drm_display_mode *mode,
430 struct drm_display_mode *adjusted_mode);
431 extern void intel_dp_init_link_config(struct intel_dp *intel_dp);
432 extern void intel_dp_start_link_train(struct intel_dp *intel_dp);
433 extern void intel_dp_complete_link_train(struct intel_dp *intel_dp);
434 extern void intel_dp_sink_dpms(struct intel_dp *intel_dp, int mode);
435 extern bool intel_dpd_is_edp(struct drm_device *dev);
436 extern void intel_edp_link_config(struct intel_encoder *, int *, int *);
437 extern int intel_edp_target_clock(struct intel_encoder *,
438 struct drm_display_mode *mode);
439 extern bool intel_encoder_is_pch_edp(struct drm_encoder *encoder);
440 extern int intel_plane_init(struct drm_device *dev, enum pipe pipe);
441 extern void intel_flush_display_plane(struct drm_i915_private *dev_priv,
445 extern int intel_panel_init(struct intel_panel *panel);
446 extern void intel_panel_fini(struct intel_panel *panel);
448 extern void intel_fixed_panel_mode(struct drm_display_mode *fixed_mode,
449 struct drm_display_mode *adjusted_mode);
450 extern void intel_pch_panel_fitting(struct drm_device *dev,
452 const struct drm_display_mode *mode,
453 struct drm_display_mode *adjusted_mode);
454 extern u32 intel_panel_get_max_backlight(struct drm_device *dev);
455 extern void intel_panel_set_backlight(struct drm_device *dev, u32 level);
456 extern int intel_panel_setup_backlight(struct drm_connector *connector);
457 extern void intel_panel_enable_backlight(struct drm_device *dev,
459 extern void intel_panel_disable_backlight(struct drm_device *dev);
460 extern void intel_panel_destroy_backlight(struct drm_device *dev);
461 extern enum drm_connector_status intel_panel_detect(struct drm_device *dev);
463 struct intel_set_config {
464 struct drm_encoder **save_connector_encoders;
465 struct drm_crtc **save_encoder_crtcs;
471 extern bool intel_set_mode(struct drm_crtc *crtc, struct drm_display_mode *mode,
472 int x, int y, struct drm_framebuffer *old_fb);
473 extern void intel_modeset_disable(struct drm_device *dev);
474 extern void intel_crtc_load_lut(struct drm_crtc *crtc);
475 extern void intel_crtc_update_dpms(struct drm_crtc *crtc);
476 extern void intel_encoder_noop(struct drm_encoder *encoder);
477 extern void intel_encoder_destroy(struct drm_encoder *encoder);
478 extern void intel_encoder_dpms(struct intel_encoder *encoder, int mode);
479 extern bool intel_encoder_check_is_cloned(struct intel_encoder *encoder);
480 extern void intel_connector_dpms(struct drm_connector *, int mode);
481 extern bool intel_connector_get_hw_state(struct intel_connector *connector);
482 extern void intel_modeset_check_state(struct drm_device *dev);
485 static inline struct intel_encoder *intel_attached_encoder(struct drm_connector *connector)
487 return to_intel_connector(connector)->encoder;
490 static inline struct intel_dp *enc_to_intel_dp(struct drm_encoder *encoder)
492 return container_of(encoder, struct intel_dp, base.base);
495 extern void intel_connector_attach_encoder(struct intel_connector *connector,
496 struct intel_encoder *encoder);
497 extern struct drm_encoder *intel_best_encoder(struct drm_connector *connector);
499 extern struct drm_display_mode *intel_crtc_mode_get(struct drm_device *dev,
500 struct drm_crtc *crtc);
501 int intel_get_pipe_from_crtc_id(struct drm_device *dev, void *data,
502 struct drm_file *file_priv);
503 extern void intel_wait_for_vblank(struct drm_device *dev, int pipe);
504 extern void intel_wait_for_pipe_off(struct drm_device *dev, int pipe);
506 struct intel_load_detect_pipe {
507 struct drm_framebuffer *release_fb;
508 bool load_detect_temp;
511 extern bool intel_get_load_detect_pipe(struct drm_connector *connector,
512 struct drm_display_mode *mode,
513 struct intel_load_detect_pipe *old);
514 extern void intel_release_load_detect_pipe(struct drm_connector *connector,
515 struct intel_load_detect_pipe *old);
517 extern void intelfb_restore(void);
518 extern void intel_crtc_fb_gamma_set(struct drm_crtc *crtc, u16 red, u16 green,
519 u16 blue, int regno);
520 extern void intel_crtc_fb_gamma_get(struct drm_crtc *crtc, u16 *red, u16 *green,
521 u16 *blue, int regno);
522 extern void intel_enable_clock_gating(struct drm_device *dev);
524 extern int intel_pin_and_fence_fb_obj(struct drm_device *dev,
525 struct drm_i915_gem_object *obj,
526 struct intel_ring_buffer *pipelined);
527 extern void intel_unpin_fb_obj(struct drm_i915_gem_object *obj);
529 extern int intel_framebuffer_init(struct drm_device *dev,
530 struct intel_framebuffer *ifb,
531 struct drm_mode_fb_cmd2 *mode_cmd,
532 struct drm_i915_gem_object *obj);
533 extern int intel_fbdev_init(struct drm_device *dev);
534 extern void intel_fbdev_fini(struct drm_device *dev);
535 extern void intel_fbdev_set_suspend(struct drm_device *dev, int state);
536 extern void intel_prepare_page_flip(struct drm_device *dev, int plane);
537 extern void intel_finish_page_flip(struct drm_device *dev, int pipe);
538 extern void intel_finish_page_flip_plane(struct drm_device *dev, int plane);
540 extern void intel_setup_overlay(struct drm_device *dev);
541 extern void intel_cleanup_overlay(struct drm_device *dev);
542 extern int intel_overlay_switch_off(struct intel_overlay *overlay);
543 extern int intel_overlay_put_image(struct drm_device *dev, void *data,
544 struct drm_file *file_priv);
545 extern int intel_overlay_attrs(struct drm_device *dev, void *data,
546 struct drm_file *file_priv);
548 extern void intel_fb_output_poll_changed(struct drm_device *dev);
549 extern void intel_fb_restore_mode(struct drm_device *dev);
551 extern void assert_pipe(struct drm_i915_private *dev_priv, enum pipe pipe,
553 #define assert_pipe_enabled(d, p) assert_pipe(d, p, true)
554 #define assert_pipe_disabled(d, p) assert_pipe(d, p, false)
556 extern void intel_init_clock_gating(struct drm_device *dev);
557 extern void intel_write_eld(struct drm_encoder *encoder,
558 struct drm_display_mode *mode);
559 extern void intel_cpt_verify_modeset(struct drm_device *dev, int pipe);
560 extern void intel_prepare_ddi(struct drm_device *dev);
561 extern void hsw_fdi_link_train(struct drm_crtc *crtc);
562 extern void intel_ddi_init(struct drm_device *dev, enum port port);
564 /* For use by IVB LP watermark workaround in intel_sprite.c */
565 extern void intel_update_watermarks(struct drm_device *dev);
566 extern void intel_update_sprite_watermarks(struct drm_device *dev, int pipe,
567 uint32_t sprite_width,
569 extern void intel_update_linetime_watermarks(struct drm_device *dev, int pipe,
570 struct drm_display_mode *mode);
572 extern int intel_sprite_set_colorkey(struct drm_device *dev, void *data,
573 struct drm_file *file_priv);
574 extern int intel_sprite_get_colorkey(struct drm_device *dev, void *data,
575 struct drm_file *file_priv);
577 extern u32 intel_dpio_read(struct drm_i915_private *dev_priv, int reg);
579 /* Power-related functions, located in intel_pm.c */
580 extern void intel_init_pm(struct drm_device *dev);
582 extern bool intel_fbc_enabled(struct drm_device *dev);
583 extern void intel_enable_fbc(struct drm_crtc *crtc, unsigned long interval);
584 extern void intel_update_fbc(struct drm_device *dev);
586 extern void intel_gpu_ips_init(struct drm_i915_private *dev_priv);
587 extern void intel_gpu_ips_teardown(void);
589 extern void intel_init_power_wells(struct drm_device *dev);
590 extern void intel_enable_gt_powersave(struct drm_device *dev);
591 extern void intel_disable_gt_powersave(struct drm_device *dev);
592 extern void gen6_gt_check_fifodbg(struct drm_i915_private *dev_priv);
593 extern void ironlake_teardown_rc6(struct drm_device *dev);
595 extern void intel_enable_ddi(struct intel_encoder *encoder);
596 extern void intel_disable_ddi(struct intel_encoder *encoder);
597 extern bool intel_ddi_get_hw_state(struct intel_encoder *encoder,
599 extern void intel_ddi_mode_set(struct drm_encoder *encoder,
600 struct drm_display_mode *mode,
601 struct drm_display_mode *adjusted_mode);
602 extern void intel_ddi_pll_init(struct drm_device *dev);
603 extern void intel_ddi_enable_pipe_func(struct drm_crtc *crtc);
604 extern void intel_ddi_disable_pipe_func(struct drm_i915_private *dev_priv,
606 extern void intel_ddi_enable_pipe_clock(struct intel_crtc *intel_crtc);
607 extern void intel_ddi_disable_pipe_clock(struct intel_crtc *intel_crtc);
608 extern void intel_ddi_setup_hw_pll_state(struct drm_device *dev);
609 extern bool intel_ddi_pll_mode_set(struct drm_crtc *crtc, int clock);
610 extern void intel_ddi_pre_enable(struct intel_encoder *intel_encoder);
611 extern void intel_ddi_post_disable(struct intel_encoder *intel_encoder);
612 extern void intel_ddi_put_crtc_pll(struct drm_crtc *crtc);
613 extern void intel_ddi_set_pipe_settings(struct drm_crtc *crtc);
614 extern void intel_ddi_prepare_link_retrain(struct drm_encoder *encoder);
616 #endif /* __INTEL_DRV_H__ */