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_set_min_bus_tput(struct device *dev, unsigned long tput); 223 int dss_debugfs_create_file(const char *name, void (*write)(struct seq_file *)); 224 225 static inline bool dss_mgr_is_lcd(enum omap_channel id) 226 { 227 if (id == OMAP_DSS_CHANNEL_LCD || id == OMAP_DSS_CHANNEL_LCD2 || 228 id == OMAP_DSS_CHANNEL_LCD3) 229 return true; 230 else 231 return false; 232 } 233 234 /* DSS */ 235 int dss_init_platform_driver(void) __init; 236 void dss_uninit_platform_driver(void); 237 238 int dss_runtime_get(void); 239 void dss_runtime_put(void); 240 241 unsigned long dss_get_dispc_clk_rate(void); 242 int dss_dpi_select_source(int port, enum omap_channel channel); 243 void dss_select_hdmi_venc_clk_source(enum dss_hdmi_venc_clk_source_select); 244 enum dss_hdmi_venc_clk_source_select dss_get_hdmi_venc_clk_source(void); 245 const char *dss_get_clk_source_name(enum dss_clk_source clk_src); 246 void dss_dump_clocks(struct seq_file *s); 247 248 /* DSS VIDEO PLL */ 249 struct dss_pll *dss_video_pll_init(struct platform_device *pdev, int id, 250 struct regulator *regulator); 251 void dss_video_pll_uninit(struct dss_pll *pll); 252 253 #if defined(CONFIG_OMAP2_DSS_DEBUGFS) 254 void dss_debug_dump_clocks(struct seq_file *s); 255 #endif 256 257 void dss_ctrl_pll_enable(enum dss_pll_id pll_id, bool enable); 258 259 void dss_sdi_init(int datapairs); 260 int dss_sdi_enable(void); 261 void dss_sdi_disable(void); 262 263 void dss_select_dsi_clk_source(int dsi_module, 264 enum dss_clk_source clk_src); 265 void dss_select_lcd_clk_source(enum omap_channel channel, 266 enum dss_clk_source clk_src); 267 enum dss_clk_source dss_get_dispc_clk_source(void); 268 enum dss_clk_source dss_get_dsi_clk_source(int dsi_module); 269 enum dss_clk_source dss_get_lcd_clk_source(enum omap_channel channel); 270 271 void dss_set_venc_output(enum omap_dss_venc_type type); 272 void dss_set_dac_pwrdn_bgz(bool enable); 273 274 int dss_set_fck_rate(unsigned long rate); 275 276 typedef bool (*dss_div_calc_func)(unsigned long fck, void *data); 277 bool dss_div_calc(unsigned long pck, unsigned long fck_min, 278 dss_div_calc_func func, void *data); 279 280 /* SDI */ 281 #ifdef CONFIG_OMAP2_DSS_SDI 282 int sdi_init_port(struct platform_device *pdev, struct device_node *port); 283 void sdi_uninit_port(struct device_node *port); 284 #else 285 static inline int sdi_init_port(struct platform_device *pdev, 286 struct device_node *port) 287 { 288 return 0; 289 } 290 static inline void sdi_uninit_port(struct device_node *port) 291 { 292 } 293 #endif 294 295 /* DSI */ 296 297 #ifdef CONFIG_OMAP2_DSS_DSI 298 299 struct dentry; 300 struct file_operations; 301 302 int dsi_init_platform_driver(void) __init; 303 void dsi_uninit_platform_driver(void); 304 305 void dsi_dump_clocks(struct seq_file *s); 306 307 void dsi_irq_handler(void); 308 309 #endif 310 311 /* DPI */ 312 #ifdef CONFIG_OMAP2_DSS_DPI 313 int dpi_init_port(struct platform_device *pdev, struct device_node *port); 314 void dpi_uninit_port(struct device_node *port); 315 #else 316 static inline int dpi_init_port(struct platform_device *pdev, 317 struct device_node *port) 318 { 319 return 0; 320 } 321 static inline void dpi_uninit_port(struct device_node *port) 322 { 323 } 324 #endif 325 326 /* DISPC */ 327 int dispc_init_platform_driver(void) __init; 328 void dispc_uninit_platform_driver(void); 329 void dispc_dump_clocks(struct seq_file *s); 330 331 int dispc_runtime_get(void); 332 void dispc_runtime_put(void); 333 334 void dispc_enable_sidle(void); 335 void dispc_disable_sidle(void); 336 337 void dispc_lcd_enable_signal(bool enable); 338 void dispc_pck_free_enable(bool enable); 339 void dispc_enable_fifomerge(bool enable); 340 void dispc_enable_gamma_table(bool enable); 341 342 typedef bool (*dispc_div_calc_func)(int lckd, int pckd, unsigned long lck, 343 unsigned long pck, void *data); 344 bool dispc_div_calc(unsigned long dispc, 345 unsigned long pck_min, unsigned long pck_max, 346 dispc_div_calc_func func, void *data); 347 348 bool dispc_mgr_timings_ok(enum omap_channel channel, const struct videomode *vm); 349 int dispc_calc_clock_rates(unsigned long dispc_fclk_rate, 350 struct dispc_clock_info *cinfo); 351 352 353 void dispc_ovl_set_fifo_threshold(enum omap_plane_id plane, u32 low, 354 u32 high); 355 void dispc_ovl_compute_fifo_thresholds(enum omap_plane_id plane, 356 u32 *fifo_low, u32 *fifo_high, bool use_fifomerge, 357 bool manual_update); 358 359 void dispc_mgr_set_clock_div(enum omap_channel channel, 360 const struct dispc_clock_info *cinfo); 361 int dispc_mgr_get_clock_div(enum omap_channel channel, 362 struct dispc_clock_info *cinfo); 363 void dispc_set_tv_pclk(unsigned long pclk); 364 365 u32 dispc_wb_get_framedone_irq(void); 366 bool dispc_wb_go_busy(void); 367 void dispc_wb_go(void); 368 void dispc_wb_set_channel_in(enum dss_writeback_channel channel); 369 int dispc_wb_setup(const struct omap_dss_writeback_info *wi, 370 bool mem_to_mem, const struct videomode *vm); 371 372 /* VENC */ 373 int venc_init_platform_driver(void) __init; 374 void venc_uninit_platform_driver(void); 375 376 /* HDMI */ 377 int hdmi4_init_platform_driver(void) __init; 378 void hdmi4_uninit_platform_driver(void); 379 380 int hdmi5_init_platform_driver(void) __init; 381 void hdmi5_uninit_platform_driver(void); 382 383 384 #ifdef CONFIG_OMAP2_DSS_COLLECT_IRQ_STATS 385 static inline void dss_collect_irq_stats(u32 irqstatus, unsigned *irq_arr) 386 { 387 int b; 388 for (b = 0; b < 32; ++b) { 389 if (irqstatus & (1 << b)) 390 irq_arr[b]++; 391 } 392 } 393 #endif 394 395 /* PLL */ 396 typedef bool (*dss_pll_calc_func)(int n, int m, unsigned long fint, 397 unsigned long clkdco, void *data); 398 typedef bool (*dss_hsdiv_calc_func)(int m_dispc, unsigned long dispc, 399 void *data); 400 401 int dss_pll_register(struct dss_pll *pll); 402 void dss_pll_unregister(struct dss_pll *pll); 403 struct dss_pll *dss_pll_find(const char *name); 404 struct dss_pll *dss_pll_find_by_src(enum dss_clk_source src); 405 unsigned dss_pll_get_clkout_idx_for_src(enum dss_clk_source src); 406 int dss_pll_enable(struct dss_pll *pll); 407 void dss_pll_disable(struct dss_pll *pll); 408 int dss_pll_set_config(struct dss_pll *pll, 409 const struct dss_pll_clock_info *cinfo); 410 411 bool dss_pll_hsdiv_calc_a(const struct dss_pll *pll, unsigned long clkdco, 412 unsigned long out_min, unsigned long out_max, 413 dss_hsdiv_calc_func func, void *data); 414 bool dss_pll_calc_a(const struct dss_pll *pll, unsigned long clkin, 415 unsigned long pll_min, unsigned long pll_max, 416 dss_pll_calc_func func, void *data); 417 418 bool dss_pll_calc_b(const struct dss_pll *pll, unsigned long clkin, 419 unsigned long target_clkout, struct dss_pll_clock_info *cinfo); 420 421 int dss_pll_write_config_type_a(struct dss_pll *pll, 422 const struct dss_pll_clock_info *cinfo); 423 int dss_pll_write_config_type_b(struct dss_pll *pll, 424 const struct dss_pll_clock_info *cinfo); 425 int dss_pll_wait_reset_done(struct dss_pll *pll); 426 427 #endif 428