1 /* 2 * Copyright © 2013 Intel Corporation 3 * 4 * Permission is hereby granted, free of charge, to any person obtaining a 5 * copy of this software and associated documentation files (the "Software"), 6 * to deal in the Software without restriction, including without limitation 7 * the rights to use, copy, modify, merge, publish, distribute, sublicense, 8 * and/or sell copies of the Software, and to permit persons to whom the 9 * Software is furnished to do so, subject to the following conditions: 10 * 11 * The above copyright notice and this permission notice (including the next 12 * paragraph) shall be included in all copies or substantial portions of the 13 * Software. 14 * 15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 20 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 21 * DEALINGS IN THE SOFTWARE. 22 */ 23 24 #ifndef _INTEL_DSI_H 25 #define _INTEL_DSI_H 26 27 #include <drm/drm_crtc.h> 28 #include <drm/drm_mipi_dsi.h> 29 30 #include "intel_display_types.h" 31 32 struct intel_dsi_host; 33 struct ref_tracker; 34 35 #define INTEL_DSI_VIDEO_MODE 0 36 #define INTEL_DSI_COMMAND_MODE 1 37 38 /* Dual Link support */ 39 #define DSI_DUAL_LINK_NONE 0 40 #define DSI_DUAL_LINK_FRONT_BACK 1 41 #define DSI_DUAL_LINK_PIXEL_ALT 2 42 43 struct intel_dsi { 44 struct intel_encoder base; 45 46 struct intel_dsi_host *dsi_hosts[I915_MAX_PORTS]; 47 struct ref_tracker *io_wakeref[I915_MAX_PORTS]; 48 49 /* GPIO Desc for panel and backlight control */ 50 struct gpio_desc *gpio_panel; 51 struct gpio_desc *gpio_backlight; 52 53 struct intel_connector *attached_connector; 54 55 /* bit mask of ports (vlv dsi) or phys (icl dsi) being driven */ 56 union { 57 u16 ports; /* VLV DSI */ 58 u16 phys; /* ICL DSI */ 59 }; 60 61 /* virtual channel */ 62 int channel; 63 64 /* Video mode or command mode */ 65 u16 operation_mode; 66 67 /* number of DSI lanes */ 68 unsigned int lane_count; 69 70 /* i2c bus associated with the target device */ 71 int i2c_bus_num; 72 73 /* 74 * video mode pixel format 75 * 76 * XXX: consolidate on .format in struct mipi_dsi_device. 77 */ 78 enum mipi_dsi_pixel_format pixel_format; 79 80 /* NON_BURST_SYNC_PULSE, NON_BURST_SYNC_EVENTS, or BURST_MODE */ 81 int video_mode; 82 83 /* eot for MIPI_EOT_DISABLE register */ 84 u8 eotp_pkt; 85 u8 clock_stop; 86 87 u8 escape_clk_div; 88 u8 dual_link; 89 90 /* RGB or BGR */ 91 bool bgr_enabled; 92 93 u8 pixel_overlap; 94 u32 bw_timer; 95 u32 dphy_reg; 96 97 /* data lanes dphy timing */ 98 u32 dphy_data_lane_reg; 99 u32 video_frmt_cfg_bits; 100 u16 lp_byte_clk; 101 102 /* timeouts in byte clocks */ 103 u16 hs_tx_timeout; 104 u16 lp_rx_timeout; 105 u16 turn_arnd_val; 106 u16 rst_timer_val; 107 u16 hs_to_lp_count; 108 u16 clk_lp_to_hs_count; 109 u16 clk_hs_to_lp_count; 110 111 u16 init_count; 112 u32 pclk; 113 u16 burst_mode_ratio; 114 115 /* all delays in ms */ 116 u16 backlight_off_delay; 117 u16 backlight_on_delay; 118 u16 panel_on_delay; 119 u16 panel_off_delay; 120 u16 panel_pwr_cycle_delay; 121 ktime_t panel_power_off_time; 122 }; 123 124 struct intel_dsi_host { 125 struct mipi_dsi_host base; 126 struct intel_dsi *intel_dsi; 127 enum port port; 128 129 /* our little hack */ 130 struct mipi_dsi_device *device; 131 }; 132 133 static inline struct intel_dsi_host *to_intel_dsi_host(struct mipi_dsi_host *h) 134 { 135 return container_of(h, struct intel_dsi_host, base); 136 } 137 138 #define for_each_dsi_port(__port, __ports_mask) \ 139 for_each_port_masked(__port, __ports_mask) 140 #define for_each_dsi_phy(__phy, __phys_mask) \ 141 for_each_phy_masked(__phy, __phys_mask) 142 143 static inline struct intel_dsi *enc_to_intel_dsi(struct intel_encoder *encoder) 144 { 145 return container_of(&encoder->base, struct intel_dsi, base.base); 146 } 147 148 static inline bool is_vid_mode(struct intel_dsi *intel_dsi) 149 { 150 return intel_dsi->operation_mode == INTEL_DSI_VIDEO_MODE; 151 } 152 153 static inline bool is_cmd_mode(struct intel_dsi *intel_dsi) 154 { 155 return intel_dsi->operation_mode == INTEL_DSI_COMMAND_MODE; 156 } 157 158 static inline u16 intel_dsi_encoder_ports(struct intel_encoder *encoder) 159 { 160 return enc_to_intel_dsi(encoder)->ports; 161 } 162 163 int intel_dsi_bitrate(const struct intel_dsi *intel_dsi); 164 int intel_dsi_tlpx_ns(const struct intel_dsi *intel_dsi); 165 enum drm_panel_orientation 166 intel_dsi_get_panel_orientation(struct intel_connector *connector); 167 int intel_dsi_get_modes(struct drm_connector *connector); 168 enum drm_mode_status intel_dsi_mode_valid(struct drm_connector *connector, 169 const struct drm_display_mode *mode); 170 struct intel_dsi_host *intel_dsi_host_init(struct intel_dsi *intel_dsi, 171 const struct mipi_dsi_host_ops *funcs, 172 enum port port); 173 void intel_dsi_wait_panel_power_cycle(struct intel_dsi *intel_dsi); 174 void intel_dsi_shutdown(struct intel_encoder *encoder); 175 176 #endif /* _INTEL_DSI_H */ 177