1 /* 2 * linux/drivers/video/omap2/dss/dss.h 3 * 4 * Copyright (C) 2009 Nokia Corporation 5 * Author: Tomi Valkeinen <tomi.valkeinen@nokia.com> 6 * 7 * Some code and ideas taken from drivers/video/omap/ driver 8 * by Imre Deak. 9 * 10 * This program is free software; you can redistribute it and/or modify it 11 * under the terms of the GNU General Public License version 2 as published by 12 * the Free Software Foundation. 13 * 14 * This program is distributed in the hope that it will be useful, but WITHOUT 15 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 16 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for 17 * more details. 18 * 19 * You should have received a copy of the GNU General Public License along with 20 * this program. If not, see <http://www.gnu.org/licenses/>. 21 */ 22 23 #ifndef __OMAP2_DSS_H 24 #define __OMAP2_DSS_H 25 26 #include <linux/interrupt.h> 27 28 #include "omapdss.h" 29 30 #ifdef pr_fmt 31 #undef pr_fmt 32 #endif 33 34 #ifdef DSS_SUBSYS_NAME 35 #define pr_fmt(fmt) DSS_SUBSYS_NAME ": " fmt 36 #else 37 #define pr_fmt(fmt) fmt 38 #endif 39 40 #define DSSDBG(format, ...) \ 41 pr_debug(format, ## __VA_ARGS__) 42 43 #ifdef DSS_SUBSYS_NAME 44 #define DSSERR(format, ...) \ 45 pr_err("omapdss " DSS_SUBSYS_NAME " error: " format, ##__VA_ARGS__) 46 #else 47 #define DSSERR(format, ...) \ 48 pr_err("omapdss error: " format, ##__VA_ARGS__) 49 #endif 50 51 #ifdef DSS_SUBSYS_NAME 52 #define DSSINFO(format, ...) \ 53 pr_info("omapdss " DSS_SUBSYS_NAME ": " format, ##__VA_ARGS__) 54 #else 55 #define DSSINFO(format, ...) \ 56 pr_info("omapdss: " format, ## __VA_ARGS__) 57 #endif 58 59 #ifdef DSS_SUBSYS_NAME 60 #define DSSWARN(format, ...) \ 61 pr_warn("omapdss " DSS_SUBSYS_NAME ": " format, ##__VA_ARGS__) 62 #else 63 #define DSSWARN(format, ...) \ 64 pr_warn("omapdss: " format, ##__VA_ARGS__) 65 #endif 66 67 /* OMAP TRM gives bitfields as start:end, where start is the higher bit 68 number. For example 7:0 */ 69 #define FLD_MASK(start, end) (((1 << ((start) - (end) + 1)) - 1) << (end)) 70 #define FLD_VAL(val, start, end) (((val) << (end)) & FLD_MASK(start, end)) 71 #define FLD_GET(val, start, end) (((val) & FLD_MASK(start, end)) >> (end)) 72 #define FLD_MOD(orig, val, start, end) \ 73 (((orig) & ~FLD_MASK(start, end)) | FLD_VAL(val, start, end)) 74 75 enum dss_io_pad_mode { 76 DSS_IO_PAD_MODE_RESET, 77 DSS_IO_PAD_MODE_RFBI, 78 DSS_IO_PAD_MODE_BYPASS, 79 }; 80 81 enum dss_hdmi_venc_clk_source_select { 82 DSS_VENC_TV_CLK = 0, 83 DSS_HDMI_M_PCLK = 1, 84 }; 85 86 enum dss_dsi_content_type { 87 DSS_DSI_CONTENT_DCS, 88 DSS_DSI_CONTENT_GENERIC, 89 }; 90 91 enum dss_writeback_channel { 92 DSS_WB_LCD1_MGR = 0, 93 DSS_WB_LCD2_MGR = 1, 94 DSS_WB_TV_MGR = 2, 95 DSS_WB_OVL0 = 3, 96 DSS_WB_OVL1 = 4, 97 DSS_WB_OVL2 = 5, 98 DSS_WB_OVL3 = 6, 99 DSS_WB_LCD3_MGR = 7, 100 }; 101 102 enum dss_clk_source { 103 DSS_CLK_SRC_FCK = 0, 104 105 DSS_CLK_SRC_PLL1_1, 106 DSS_CLK_SRC_PLL1_2, 107 DSS_CLK_SRC_PLL1_3, 108 109 DSS_CLK_SRC_PLL2_1, 110 DSS_CLK_SRC_PLL2_2, 111 DSS_CLK_SRC_PLL2_3, 112 113 DSS_CLK_SRC_HDMI_PLL, 114 }; 115 116 enum dss_pll_id { 117 DSS_PLL_DSI1, 118 DSS_PLL_DSI2, 119 DSS_PLL_HDMI, 120 DSS_PLL_VIDEO1, 121 DSS_PLL_VIDEO2, 122 }; 123 124 struct dss_pll; 125 126 #define DSS_PLL_MAX_HSDIVS 4 127 128 enum dss_pll_type { 129 DSS_PLL_TYPE_A, 130 DSS_PLL_TYPE_B, 131 }; 132 133 /* 134 * Type-A PLLs: clkout[]/mX[] refer to hsdiv outputs m4, m5, m6, m7. 135 * Type-B PLLs: clkout[0] refers to m2. 136 */ 137 struct dss_pll_clock_info { 138 /* rates that we get with dividers below */ 139 unsigned long fint; 140 unsigned long clkdco; 141 unsigned long clkout[DSS_PLL_MAX_HSDIVS]; 142 143 /* dividers */ 144 u16 n; 145 u16 m; 146 u32 mf; 147 u16 mX[DSS_PLL_MAX_HSDIVS]; 148 u16 sd; 149 }; 150 151 struct dss_pll_ops { 152 int (*enable)(struct dss_pll *pll); 153 void (*disable)(struct dss_pll *pll); 154 int (*set_config)(struct dss_pll *pll, 155 const struct dss_pll_clock_info *cinfo); 156 }; 157 158 struct dss_pll_hw { 159 enum dss_pll_type type; 160 161 unsigned n_max; 162 unsigned m_min; 163 unsigned m_max; 164 unsigned mX_max; 165 166 unsigned long fint_min, fint_max; 167 unsigned long clkdco_min, clkdco_low, clkdco_max; 168 169 u8 n_msb, n_lsb; 170 u8 m_msb, m_lsb; 171 u8 mX_msb[DSS_PLL_MAX_HSDIVS], mX_lsb[DSS_PLL_MAX_HSDIVS]; 172 173 bool has_stopmode; 174 bool has_freqsel; 175 bool has_selfreqdco; 176 bool has_refsel; 177 }; 178 179 struct dss_pll { 180 const char *name; 181 enum dss_pll_id id; 182 183 struct clk *clkin; 184 struct regulator *regulator; 185 186 void __iomem *base; 187 188 const struct dss_pll_hw *hw; 189 190 const struct dss_pll_ops *ops; 191 192 struct dss_pll_clock_info cinfo; 193 }; 194 195 struct dispc_clock_info { 196 /* rates that we get with dividers below */ 197 unsigned long lck; 198 unsigned long pck; 199 200 /* dividers */ 201 u16 lck_div; 202 u16 pck_div; 203 }; 204 205 struct dss_lcd_mgr_config { 206 enum dss_io_pad_mode io_pad_mode; 207 208 bool stallmode; 209 bool fifohandcheck; 210 211 struct dispc_clock_info clock_info; 212 213 int video_port_width; 214 215 int lcden_sig_polarity; 216 }; 217 218 struct seq_file; 219 struct platform_device; 220 221 /* core */ 222 int dss_dsi_enable_pads(int dsi_id, unsigned lane_mask); 223 void dss_dsi_disable_pads(int dsi_id, unsigned lane_mask); 224 int dss_set_min_bus_tput(struct device *dev, unsigned long tput); 225 int dss_debugfs_create_file(const char *name, void (*write)(struct seq_file *)); 226 227 static inline bool dss_mgr_is_lcd(enum omap_channel id) 228 { 229 if (id == OMAP_DSS_CHANNEL_LCD || id == OMAP_DSS_CHANNEL_LCD2 || 230 id == OMAP_DSS_CHANNEL_LCD3) 231 return true; 232 else 233 return false; 234 } 235 236 /* DSS */ 237 int dss_init_platform_driver(void) __init; 238 void dss_uninit_platform_driver(void); 239 240 int dss_runtime_get(void); 241 void dss_runtime_put(void); 242 243 unsigned long dss_get_dispc_clk_rate(void); 244 int dss_dpi_select_source(int port, enum omap_channel channel); 245 void dss_select_hdmi_venc_clk_source(enum dss_hdmi_venc_clk_source_select); 246 enum dss_hdmi_venc_clk_source_select dss_get_hdmi_venc_clk_source(void); 247 const char *dss_get_clk_source_name(enum dss_clk_source clk_src); 248 void dss_dump_clocks(struct seq_file *s); 249 250 /* DSS VIDEO PLL */ 251 struct dss_pll *dss_video_pll_init(struct platform_device *pdev, int id, 252 struct regulator *regulator); 253 void dss_video_pll_uninit(struct dss_pll *pll); 254 255 #if defined(CONFIG_OMAP2_DSS_DEBUGFS) 256 void dss_debug_dump_clocks(struct seq_file *s); 257 #endif 258 259 void dss_ctrl_pll_enable(enum dss_pll_id pll_id, bool enable); 260 261 void dss_sdi_init(int datapairs); 262 int dss_sdi_enable(void); 263 void dss_sdi_disable(void); 264 265 void dss_select_dsi_clk_source(int dsi_module, 266 enum dss_clk_source clk_src); 267 void dss_select_lcd_clk_source(enum omap_channel channel, 268 enum dss_clk_source clk_src); 269 enum dss_clk_source dss_get_dispc_clk_source(void); 270 enum dss_clk_source dss_get_dsi_clk_source(int dsi_module); 271 enum dss_clk_source dss_get_lcd_clk_source(enum omap_channel channel); 272 273 void dss_set_venc_output(enum omap_dss_venc_type type); 274 void dss_set_dac_pwrdn_bgz(bool enable); 275 276 int dss_set_fck_rate(unsigned long rate); 277 278 typedef bool (*dss_div_calc_func)(unsigned long fck, void *data); 279 bool dss_div_calc(unsigned long pck, unsigned long fck_min, 280 dss_div_calc_func func, void *data); 281 282 /* SDI */ 283 #ifdef CONFIG_OMAP2_DSS_SDI 284 int sdi_init_port(struct platform_device *pdev, struct device_node *port); 285 void sdi_uninit_port(struct device_node *port); 286 #else 287 static inline int sdi_init_port(struct platform_device *pdev, 288 struct device_node *port) 289 { 290 return 0; 291 } 292 static inline void sdi_uninit_port(struct device_node *port) 293 { 294 } 295 #endif 296 297 /* DSI */ 298 299 #ifdef CONFIG_OMAP2_DSS_DSI 300 301 struct dentry; 302 struct file_operations; 303 304 int dsi_init_platform_driver(void) __init; 305 void dsi_uninit_platform_driver(void); 306 307 void dsi_dump_clocks(struct seq_file *s); 308 309 void dsi_irq_handler(void); 310 311 #endif 312 313 /* DPI */ 314 #ifdef CONFIG_OMAP2_DSS_DPI 315 int dpi_init_port(struct platform_device *pdev, struct device_node *port); 316 void dpi_uninit_port(struct device_node *port); 317 #else 318 static inline int dpi_init_port(struct platform_device *pdev, 319 struct device_node *port) 320 { 321 return 0; 322 } 323 static inline void dpi_uninit_port(struct device_node *port) 324 { 325 } 326 #endif 327 328 /* DISPC */ 329 int dispc_init_platform_driver(void) __init; 330 void dispc_uninit_platform_driver(void); 331 void dispc_dump_clocks(struct seq_file *s); 332 333 int dispc_runtime_get(void); 334 void dispc_runtime_put(void); 335 336 void dispc_enable_sidle(void); 337 void dispc_disable_sidle(void); 338 339 void dispc_lcd_enable_signal(bool enable); 340 void dispc_pck_free_enable(bool enable); 341 void dispc_enable_fifomerge(bool enable); 342 void dispc_enable_gamma_table(bool enable); 343 344 typedef bool (*dispc_div_calc_func)(int lckd, int pckd, unsigned long lck, 345 unsigned long pck, void *data); 346 bool dispc_div_calc(unsigned long dispc, 347 unsigned long pck_min, unsigned long pck_max, 348 dispc_div_calc_func func, void *data); 349 350 bool dispc_mgr_timings_ok(enum omap_channel channel, const struct videomode *vm); 351 int dispc_calc_clock_rates(unsigned long dispc_fclk_rate, 352 struct dispc_clock_info *cinfo); 353 354 355 void dispc_ovl_set_fifo_threshold(enum omap_plane_id plane, u32 low, 356 u32 high); 357 void dispc_ovl_compute_fifo_thresholds(enum omap_plane_id plane, 358 u32 *fifo_low, u32 *fifo_high, bool use_fifomerge, 359 bool manual_update); 360 361 void dispc_mgr_set_clock_div(enum omap_channel channel, 362 const struct dispc_clock_info *cinfo); 363 int dispc_mgr_get_clock_div(enum omap_channel channel, 364 struct dispc_clock_info *cinfo); 365 void dispc_set_tv_pclk(unsigned long pclk); 366 367 u32 dispc_wb_get_framedone_irq(void); 368 bool dispc_wb_go_busy(void); 369 void dispc_wb_go(void); 370 void dispc_wb_set_channel_in(enum dss_writeback_channel channel); 371 int dispc_wb_setup(const struct omap_dss_writeback_info *wi, 372 bool mem_to_mem, const struct videomode *vm); 373 374 /* VENC */ 375 int venc_init_platform_driver(void) __init; 376 void venc_uninit_platform_driver(void); 377 378 /* HDMI */ 379 int hdmi4_init_platform_driver(void) __init; 380 void hdmi4_uninit_platform_driver(void); 381 382 int hdmi5_init_platform_driver(void) __init; 383 void hdmi5_uninit_platform_driver(void); 384 385 386 #ifdef CONFIG_OMAP2_DSS_COLLECT_IRQ_STATS 387 static inline void dss_collect_irq_stats(u32 irqstatus, unsigned *irq_arr) 388 { 389 int b; 390 for (b = 0; b < 32; ++b) { 391 if (irqstatus & (1 << b)) 392 irq_arr[b]++; 393 } 394 } 395 #endif 396 397 /* PLL */ 398 typedef bool (*dss_pll_calc_func)(int n, int m, unsigned long fint, 399 unsigned long clkdco, void *data); 400 typedef bool (*dss_hsdiv_calc_func)(int m_dispc, unsigned long dispc, 401 void *data); 402 403 int dss_pll_register(struct dss_pll *pll); 404 void dss_pll_unregister(struct dss_pll *pll); 405 struct dss_pll *dss_pll_find(const char *name); 406 struct dss_pll *dss_pll_find_by_src(enum dss_clk_source src); 407 unsigned dss_pll_get_clkout_idx_for_src(enum dss_clk_source src); 408 int dss_pll_enable(struct dss_pll *pll); 409 void dss_pll_disable(struct dss_pll *pll); 410 int dss_pll_set_config(struct dss_pll *pll, 411 const struct dss_pll_clock_info *cinfo); 412 413 bool dss_pll_hsdiv_calc_a(const struct dss_pll *pll, unsigned long clkdco, 414 unsigned long out_min, unsigned long out_max, 415 dss_hsdiv_calc_func func, void *data); 416 bool dss_pll_calc_a(const struct dss_pll *pll, unsigned long clkin, 417 unsigned long pll_min, unsigned long pll_max, 418 dss_pll_calc_func func, void *data); 419 420 bool dss_pll_calc_b(const struct dss_pll *pll, unsigned long clkin, 421 unsigned long target_clkout, struct dss_pll_clock_info *cinfo); 422 423 int dss_pll_write_config_type_a(struct dss_pll *pll, 424 const struct dss_pll_clock_info *cinfo); 425 int dss_pll_write_config_type_b(struct dss_pll *pll, 426 const struct dss_pll_clock_info *cinfo); 427 int dss_pll_wait_reset_done(struct dss_pll *pll); 428 429 #endif 430