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_connector_update_modes(struct drm_connector *connector,
410 int intel_ddc_get_modes(struct drm_connector *c, struct i2c_adapter *adapter);
412 extern void intel_attach_force_audio_property(struct drm_connector *connector);
413 extern void intel_attach_broadcast_rgb_property(struct drm_connector *connector);
415 extern void intel_crt_init(struct drm_device *dev);
416 extern void intel_hdmi_init(struct drm_device *dev,
417 int sdvox_reg, enum port port);
418 extern struct intel_hdmi *enc_to_intel_hdmi(struct drm_encoder *encoder);
419 extern void intel_dip_infoframe_csum(struct dip_infoframe *avi_if);
420 extern bool intel_sdvo_init(struct drm_device *dev, uint32_t sdvo_reg,
422 extern void intel_dvo_init(struct drm_device *dev);
423 extern void intel_tv_init(struct drm_device *dev);
424 extern void intel_mark_busy(struct drm_device *dev);
425 extern void intel_mark_idle(struct drm_device *dev);
426 extern void intel_mark_fb_busy(struct drm_i915_gem_object *obj);
427 extern void intel_mark_fb_idle(struct drm_i915_gem_object *obj);
428 extern bool intel_lvds_init(struct drm_device *dev);
429 extern void intel_dp_init(struct drm_device *dev, int output_reg,
432 intel_dp_set_m_n(struct drm_crtc *crtc, struct drm_display_mode *mode,
433 struct drm_display_mode *adjusted_mode);
434 extern void intel_dp_init_link_config(struct intel_dp *intel_dp);
435 extern void intel_dp_start_link_train(struct intel_dp *intel_dp);
436 extern void intel_dp_complete_link_train(struct intel_dp *intel_dp);
437 extern void intel_dp_sink_dpms(struct intel_dp *intel_dp, int mode);
438 extern bool intel_dpd_is_edp(struct drm_device *dev);
439 extern void intel_edp_link_config(struct intel_encoder *, int *, int *);
440 extern int intel_edp_target_clock(struct intel_encoder *,
441 struct drm_display_mode *mode);
442 extern bool intel_encoder_is_pch_edp(struct drm_encoder *encoder);
443 extern int intel_plane_init(struct drm_device *dev, enum pipe pipe);
444 extern void intel_flush_display_plane(struct drm_i915_private *dev_priv,
448 extern int intel_panel_init(struct intel_panel *panel,
449 struct drm_display_mode *fixed_mode);
450 extern void intel_panel_fini(struct intel_panel *panel);
452 extern void intel_fixed_panel_mode(struct drm_display_mode *fixed_mode,
453 struct drm_display_mode *adjusted_mode);
454 extern void intel_pch_panel_fitting(struct drm_device *dev,
456 const struct drm_display_mode *mode,
457 struct drm_display_mode *adjusted_mode);
458 extern u32 intel_panel_get_max_backlight(struct drm_device *dev);
459 extern void intel_panel_set_backlight(struct drm_device *dev, u32 level);
460 extern int intel_panel_setup_backlight(struct drm_connector *connector);
461 extern void intel_panel_enable_backlight(struct drm_device *dev,
463 extern void intel_panel_disable_backlight(struct drm_device *dev);
464 extern void intel_panel_destroy_backlight(struct drm_device *dev);
465 extern enum drm_connector_status intel_panel_detect(struct drm_device *dev);
467 struct intel_set_config {
468 struct drm_encoder **save_connector_encoders;
469 struct drm_crtc **save_encoder_crtcs;
475 extern bool intel_set_mode(struct drm_crtc *crtc, struct drm_display_mode *mode,
476 int x, int y, struct drm_framebuffer *old_fb);
477 extern void intel_modeset_disable(struct drm_device *dev);
478 extern void intel_crtc_load_lut(struct drm_crtc *crtc);
479 extern void intel_crtc_update_dpms(struct drm_crtc *crtc);
480 extern void intel_encoder_noop(struct drm_encoder *encoder);
481 extern void intel_encoder_destroy(struct drm_encoder *encoder);
482 extern void intel_encoder_dpms(struct intel_encoder *encoder, int mode);
483 extern bool intel_encoder_check_is_cloned(struct intel_encoder *encoder);
484 extern void intel_connector_dpms(struct drm_connector *, int mode);
485 extern bool intel_connector_get_hw_state(struct intel_connector *connector);
486 extern void intel_modeset_check_state(struct drm_device *dev);
489 static inline struct intel_encoder *intel_attached_encoder(struct drm_connector *connector)
491 return to_intel_connector(connector)->encoder;
494 static inline struct intel_dp *enc_to_intel_dp(struct drm_encoder *encoder)
496 return container_of(encoder, struct intel_dp, base.base);
499 extern void intel_connector_attach_encoder(struct intel_connector *connector,
500 struct intel_encoder *encoder);
501 extern struct drm_encoder *intel_best_encoder(struct drm_connector *connector);
503 extern struct drm_display_mode *intel_crtc_mode_get(struct drm_device *dev,
504 struct drm_crtc *crtc);
505 int intel_get_pipe_from_crtc_id(struct drm_device *dev, void *data,
506 struct drm_file *file_priv);
507 extern void intel_wait_for_vblank(struct drm_device *dev, int pipe);
508 extern void intel_wait_for_pipe_off(struct drm_device *dev, int pipe);
510 struct intel_load_detect_pipe {
511 struct drm_framebuffer *release_fb;
512 bool load_detect_temp;
515 extern bool intel_get_load_detect_pipe(struct drm_connector *connector,
516 struct drm_display_mode *mode,
517 struct intel_load_detect_pipe *old);
518 extern void intel_release_load_detect_pipe(struct drm_connector *connector,
519 struct intel_load_detect_pipe *old);
521 extern void intelfb_restore(void);
522 extern void intel_crtc_fb_gamma_set(struct drm_crtc *crtc, u16 red, u16 green,
523 u16 blue, int regno);
524 extern void intel_crtc_fb_gamma_get(struct drm_crtc *crtc, u16 *red, u16 *green,
525 u16 *blue, int regno);
526 extern void intel_enable_clock_gating(struct drm_device *dev);
528 extern int intel_pin_and_fence_fb_obj(struct drm_device *dev,
529 struct drm_i915_gem_object *obj,
530 struct intel_ring_buffer *pipelined);
531 extern void intel_unpin_fb_obj(struct drm_i915_gem_object *obj);
533 extern int intel_framebuffer_init(struct drm_device *dev,
534 struct intel_framebuffer *ifb,
535 struct drm_mode_fb_cmd2 *mode_cmd,
536 struct drm_i915_gem_object *obj);
537 extern int intel_fbdev_init(struct drm_device *dev);
538 extern void intel_fbdev_fini(struct drm_device *dev);
539 extern void intel_fbdev_set_suspend(struct drm_device *dev, int state);
540 extern void intel_prepare_page_flip(struct drm_device *dev, int plane);
541 extern void intel_finish_page_flip(struct drm_device *dev, int pipe);
542 extern void intel_finish_page_flip_plane(struct drm_device *dev, int plane);
544 extern void intel_setup_overlay(struct drm_device *dev);
545 extern void intel_cleanup_overlay(struct drm_device *dev);
546 extern int intel_overlay_switch_off(struct intel_overlay *overlay);
547 extern int intel_overlay_put_image(struct drm_device *dev, void *data,
548 struct drm_file *file_priv);
549 extern int intel_overlay_attrs(struct drm_device *dev, void *data,
550 struct drm_file *file_priv);
552 extern void intel_fb_output_poll_changed(struct drm_device *dev);
553 extern void intel_fb_restore_mode(struct drm_device *dev);
555 extern void assert_pipe(struct drm_i915_private *dev_priv, enum pipe pipe,
557 #define assert_pipe_enabled(d, p) assert_pipe(d, p, true)
558 #define assert_pipe_disabled(d, p) assert_pipe(d, p, false)
560 extern void intel_init_clock_gating(struct drm_device *dev);
561 extern void intel_write_eld(struct drm_encoder *encoder,
562 struct drm_display_mode *mode);
563 extern void intel_cpt_verify_modeset(struct drm_device *dev, int pipe);
564 extern void intel_prepare_ddi(struct drm_device *dev);
565 extern void hsw_fdi_link_train(struct drm_crtc *crtc);
566 extern void intel_ddi_init(struct drm_device *dev, enum port port);
568 /* For use by IVB LP watermark workaround in intel_sprite.c */
569 extern void intel_update_watermarks(struct drm_device *dev);
570 extern void intel_update_sprite_watermarks(struct drm_device *dev, int pipe,
571 uint32_t sprite_width,
573 extern void intel_update_linetime_watermarks(struct drm_device *dev, int pipe,
574 struct drm_display_mode *mode);
576 extern int intel_sprite_set_colorkey(struct drm_device *dev, void *data,
577 struct drm_file *file_priv);
578 extern int intel_sprite_get_colorkey(struct drm_device *dev, void *data,
579 struct drm_file *file_priv);
581 extern u32 intel_dpio_read(struct drm_i915_private *dev_priv, int reg);
583 /* Power-related functions, located in intel_pm.c */
584 extern void intel_init_pm(struct drm_device *dev);
586 extern bool intel_fbc_enabled(struct drm_device *dev);
587 extern void intel_enable_fbc(struct drm_crtc *crtc, unsigned long interval);
588 extern void intel_update_fbc(struct drm_device *dev);
590 extern void intel_gpu_ips_init(struct drm_i915_private *dev_priv);
591 extern void intel_gpu_ips_teardown(void);
593 extern void intel_init_power_wells(struct drm_device *dev);
594 extern void intel_enable_gt_powersave(struct drm_device *dev);
595 extern void intel_disable_gt_powersave(struct drm_device *dev);
596 extern void gen6_gt_check_fifodbg(struct drm_i915_private *dev_priv);
597 extern void ironlake_teardown_rc6(struct drm_device *dev);
599 extern void intel_enable_ddi(struct intel_encoder *encoder);
600 extern void intel_disable_ddi(struct intel_encoder *encoder);
601 extern bool intel_ddi_get_hw_state(struct intel_encoder *encoder,
603 extern void intel_ddi_mode_set(struct drm_encoder *encoder,
604 struct drm_display_mode *mode,
605 struct drm_display_mode *adjusted_mode);
606 extern void intel_ddi_pll_init(struct drm_device *dev);
607 extern void intel_ddi_enable_pipe_func(struct drm_crtc *crtc);
608 extern void intel_ddi_disable_pipe_func(struct drm_i915_private *dev_priv,
610 extern void intel_ddi_enable_pipe_clock(struct intel_crtc *intel_crtc);
611 extern void intel_ddi_disable_pipe_clock(struct intel_crtc *intel_crtc);
612 extern void intel_ddi_setup_hw_pll_state(struct drm_device *dev);
613 extern bool intel_ddi_pll_mode_set(struct drm_crtc *crtc, int clock);
614 extern void intel_ddi_pre_enable(struct intel_encoder *intel_encoder);
615 extern void intel_ddi_post_disable(struct intel_encoder *intel_encoder);
616 extern void intel_ddi_put_crtc_pll(struct drm_crtc *crtc);
617 extern void intel_ddi_set_pipe_settings(struct drm_crtc *crtc);
618 extern void intel_ddi_prepare_link_retrain(struct drm_encoder *encoder);
620 #endif /* __INTEL_DRV_H__ */