dss.h 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449
  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. #ifndef __OMAP2_DSS_H
  23. #define __OMAP2_DSS_H
  24. #include <linux/interrupt.h>
  25. #ifdef pr_fmt
  26. #undef pr_fmt
  27. #endif
  28. #ifdef DSS_SUBSYS_NAME
  29. #define pr_fmt(fmt) DSS_SUBSYS_NAME ": " fmt
  30. #else
  31. #define pr_fmt(fmt) fmt
  32. #endif
  33. #define DSSDBG(format, ...) \
  34. pr_debug(format, ## __VA_ARGS__)
  35. #ifdef DSS_SUBSYS_NAME
  36. #define DSSERR(format, ...) \
  37. printk(KERN_ERR "omapdss " DSS_SUBSYS_NAME " error: " format, \
  38. ## __VA_ARGS__)
  39. #else
  40. #define DSSERR(format, ...) \
  41. printk(KERN_ERR "omapdss error: " format, ## __VA_ARGS__)
  42. #endif
  43. #ifdef DSS_SUBSYS_NAME
  44. #define DSSINFO(format, ...) \
  45. printk(KERN_INFO "omapdss " DSS_SUBSYS_NAME ": " format, \
  46. ## __VA_ARGS__)
  47. #else
  48. #define DSSINFO(format, ...) \
  49. printk(KERN_INFO "omapdss: " format, ## __VA_ARGS__)
  50. #endif
  51. #ifdef DSS_SUBSYS_NAME
  52. #define DSSWARN(format, ...) \
  53. printk(KERN_WARNING "omapdss " DSS_SUBSYS_NAME ": " format, \
  54. ## __VA_ARGS__)
  55. #else
  56. #define DSSWARN(format, ...) \
  57. printk(KERN_WARNING "omapdss: " format, ## __VA_ARGS__)
  58. #endif
  59. /* OMAP TRM gives bitfields as start:end, where start is the higher bit
  60. number. For example 7:0 */
  61. #define FLD_MASK(start, end) (((1 << ((start) - (end) + 1)) - 1) << (end))
  62. #define FLD_VAL(val, start, end) (((val) << (end)) & FLD_MASK(start, end))
  63. #define FLD_GET(val, start, end) (((val) & FLD_MASK(start, end)) >> (end))
  64. #define FLD_MOD(orig, val, start, end) \
  65. (((orig) & ~FLD_MASK(start, end)) | FLD_VAL(val, start, end))
  66. enum dss_io_pad_mode {
  67. DSS_IO_PAD_MODE_RESET,
  68. DSS_IO_PAD_MODE_RFBI,
  69. DSS_IO_PAD_MODE_BYPASS,
  70. };
  71. enum dss_hdmi_venc_clk_source_select {
  72. DSS_VENC_TV_CLK = 0,
  73. DSS_HDMI_M_PCLK = 1,
  74. };
  75. enum dss_dsi_content_type {
  76. DSS_DSI_CONTENT_DCS,
  77. DSS_DSI_CONTENT_GENERIC,
  78. };
  79. enum dss_writeback_channel {
  80. DSS_WB_LCD1_MGR = 0,
  81. DSS_WB_LCD2_MGR = 1,
  82. DSS_WB_TV_MGR = 2,
  83. DSS_WB_OVL0 = 3,
  84. DSS_WB_OVL1 = 4,
  85. DSS_WB_OVL2 = 5,
  86. DSS_WB_OVL3 = 6,
  87. DSS_WB_LCD3_MGR = 7,
  88. };
  89. struct dss_clock_info {
  90. /* rates that we get with dividers below */
  91. unsigned long fck;
  92. /* dividers */
  93. u16 fck_div;
  94. };
  95. struct dispc_clock_info {
  96. /* rates that we get with dividers below */
  97. unsigned long lck;
  98. unsigned long pck;
  99. /* dividers */
  100. u16 lck_div;
  101. u16 pck_div;
  102. };
  103. struct dsi_clock_info {
  104. /* rates that we get with dividers below */
  105. unsigned long fint;
  106. unsigned long clkin4ddr;
  107. unsigned long clkin;
  108. unsigned long dsi_pll_hsdiv_dispc_clk; /* OMAP3: DSI1_PLL_CLK
  109. * OMAP4: PLLx_CLK1 */
  110. unsigned long dsi_pll_hsdiv_dsi_clk; /* OMAP3: DSI2_PLL_CLK
  111. * OMAP4: PLLx_CLK2 */
  112. unsigned long lp_clk;
  113. /* dividers */
  114. u16 regn;
  115. u16 regm;
  116. u16 regm_dispc; /* OMAP3: REGM3
  117. * OMAP4: REGM4 */
  118. u16 regm_dsi; /* OMAP3: REGM4
  119. * OMAP4: REGM5 */
  120. u16 lp_clk_div;
  121. };
  122. struct reg_field {
  123. u16 reg;
  124. u8 high;
  125. u8 low;
  126. };
  127. struct dss_lcd_mgr_config {
  128. enum dss_io_pad_mode io_pad_mode;
  129. bool stallmode;
  130. bool fifohandcheck;
  131. struct dispc_clock_info clock_info;
  132. int video_port_width;
  133. int lcden_sig_polarity;
  134. };
  135. struct seq_file;
  136. struct platform_device;
  137. /* core */
  138. struct platform_device *dss_get_core_pdev(void);
  139. int dss_dsi_enable_pads(int dsi_id, unsigned lane_mask);
  140. void dss_dsi_disable_pads(int dsi_id, unsigned lane_mask);
  141. int dss_set_min_bus_tput(struct device *dev, unsigned long tput);
  142. int dss_debugfs_create_file(const char *name, void (*write)(struct seq_file *));
  143. /* display */
  144. int dss_suspend_all_devices(void);
  145. int dss_resume_all_devices(void);
  146. void dss_disable_all_devices(void);
  147. int display_init_sysfs(struct platform_device *pdev);
  148. void display_uninit_sysfs(struct platform_device *pdev);
  149. /* manager */
  150. int dss_init_overlay_managers(void);
  151. void dss_uninit_overlay_managers(void);
  152. int dss_init_overlay_managers_sysfs(struct platform_device *pdev);
  153. void dss_uninit_overlay_managers_sysfs(struct platform_device *pdev);
  154. int dss_mgr_simple_check(struct omap_overlay_manager *mgr,
  155. const struct omap_overlay_manager_info *info);
  156. int dss_mgr_check_timings(struct omap_overlay_manager *mgr,
  157. const struct omap_video_timings *timings);
  158. int dss_mgr_check(struct omap_overlay_manager *mgr,
  159. struct omap_overlay_manager_info *info,
  160. const struct omap_video_timings *mgr_timings,
  161. const struct dss_lcd_mgr_config *config,
  162. struct omap_overlay_info **overlay_infos);
  163. static inline bool dss_mgr_is_lcd(enum omap_channel id)
  164. {
  165. if (id == OMAP_DSS_CHANNEL_LCD || id == OMAP_DSS_CHANNEL_LCD2 ||
  166. id == OMAP_DSS_CHANNEL_LCD3)
  167. return true;
  168. else
  169. return false;
  170. }
  171. int dss_manager_kobj_init(struct omap_overlay_manager *mgr,
  172. struct platform_device *pdev);
  173. void dss_manager_kobj_uninit(struct omap_overlay_manager *mgr);
  174. /* overlay */
  175. void dss_init_overlays(struct platform_device *pdev);
  176. void dss_uninit_overlays(struct platform_device *pdev);
  177. void dss_overlay_setup_dispc_manager(struct omap_overlay_manager *mgr);
  178. int dss_ovl_simple_check(struct omap_overlay *ovl,
  179. const struct omap_overlay_info *info);
  180. int dss_ovl_check(struct omap_overlay *ovl, struct omap_overlay_info *info,
  181. const struct omap_video_timings *mgr_timings);
  182. bool dss_ovl_use_replication(struct dss_lcd_mgr_config config,
  183. enum omap_color_mode mode);
  184. int dss_overlay_kobj_init(struct omap_overlay *ovl,
  185. struct platform_device *pdev);
  186. void dss_overlay_kobj_uninit(struct omap_overlay *ovl);
  187. /* DSS */
  188. int dss_init_platform_driver(void) __init;
  189. void dss_uninit_platform_driver(void);
  190. unsigned long dss_get_dispc_clk_rate(void);
  191. int dss_dpi_select_source(enum omap_channel channel);
  192. void dss_select_hdmi_venc_clk_source(enum dss_hdmi_venc_clk_source_select);
  193. enum dss_hdmi_venc_clk_source_select dss_get_hdmi_venc_clk_source(void);
  194. const char *dss_get_generic_clk_source_name(enum omap_dss_clk_source clk_src);
  195. void dss_dump_clocks(struct seq_file *s);
  196. #if defined(CONFIG_OMAP2_DSS_DEBUGFS)
  197. void dss_debug_dump_clocks(struct seq_file *s);
  198. #endif
  199. int dss_get_ctx_loss_count(void);
  200. void dss_sdi_init(int datapairs);
  201. int dss_sdi_enable(void);
  202. void dss_sdi_disable(void);
  203. void dss_select_dsi_clk_source(int dsi_module,
  204. enum omap_dss_clk_source clk_src);
  205. void dss_select_lcd_clk_source(enum omap_channel channel,
  206. enum omap_dss_clk_source clk_src);
  207. enum omap_dss_clk_source dss_get_dispc_clk_source(void);
  208. enum omap_dss_clk_source dss_get_dsi_clk_source(int dsi_module);
  209. enum omap_dss_clk_source dss_get_lcd_clk_source(enum omap_channel channel);
  210. void dss_set_venc_output(enum omap_dss_venc_type type);
  211. void dss_set_dac_pwrdn_bgz(bool enable);
  212. unsigned long dss_get_dpll4_rate(void);
  213. int dss_calc_clock_rates(struct dss_clock_info *cinfo);
  214. int dss_set_clock_div(struct dss_clock_info *cinfo);
  215. typedef bool (*dss_div_calc_func)(int fckd, unsigned long fck, void *data);
  216. bool dss_div_calc(unsigned long fck_min, dss_div_calc_func func, void *data);
  217. /* SDI */
  218. int sdi_init_platform_driver(void) __init;
  219. void sdi_uninit_platform_driver(void) __exit;
  220. /* DSI */
  221. typedef bool (*dsi_pll_calc_func)(int regn, int regm, unsigned long fint,
  222. unsigned long pll, void *data);
  223. typedef bool (*dsi_hsdiv_calc_func)(int regm_dispc, unsigned long dispc,
  224. void *data);
  225. #ifdef CONFIG_OMAP2_DSS_DSI
  226. struct dentry;
  227. struct file_operations;
  228. int dsi_init_platform_driver(void) __init;
  229. void dsi_uninit_platform_driver(void) __exit;
  230. int dsi_runtime_get(struct platform_device *dsidev);
  231. void dsi_runtime_put(struct platform_device *dsidev);
  232. void dsi_dump_clocks(struct seq_file *s);
  233. void dsi_irq_handler(void);
  234. u8 dsi_get_pixel_size(enum omap_dss_dsi_pixel_format fmt);
  235. unsigned long dsi_get_pll_clkin(struct platform_device *dsidev);
  236. bool dsi_hsdiv_calc(struct platform_device *dsidev, unsigned long pll,
  237. unsigned long out_min, dsi_hsdiv_calc_func func, void *data);
  238. bool dsi_pll_calc(struct platform_device *dsidev, unsigned long clkin,
  239. unsigned long pll_min, unsigned long pll_max,
  240. dsi_pll_calc_func func, void *data);
  241. unsigned long dsi_get_pll_hsdiv_dispc_rate(struct platform_device *dsidev);
  242. int dsi_pll_set_clock_div(struct platform_device *dsidev,
  243. struct dsi_clock_info *cinfo);
  244. int dsi_pll_init(struct platform_device *dsidev, bool enable_hsclk,
  245. bool enable_hsdiv);
  246. void dsi_pll_uninit(struct platform_device *dsidev, bool disconnect_lanes);
  247. void dsi_wait_pll_hsdiv_dispc_active(struct platform_device *dsidev);
  248. void dsi_wait_pll_hsdiv_dsi_active(struct platform_device *dsidev);
  249. struct platform_device *dsi_get_dsidev_from_id(int module);
  250. #else
  251. static inline int dsi_runtime_get(struct platform_device *dsidev)
  252. {
  253. return 0;
  254. }
  255. static inline void dsi_runtime_put(struct platform_device *dsidev)
  256. {
  257. }
  258. static inline u8 dsi_get_pixel_size(enum omap_dss_dsi_pixel_format fmt)
  259. {
  260. WARN("%s: DSI not compiled in, returning pixel_size as 0\n", __func__);
  261. return 0;
  262. }
  263. static inline unsigned long dsi_get_pll_hsdiv_dispc_rate(struct platform_device *dsidev)
  264. {
  265. WARN("%s: DSI not compiled in, returning rate as 0\n", __func__);
  266. return 0;
  267. }
  268. static inline int dsi_pll_set_clock_div(struct platform_device *dsidev,
  269. struct dsi_clock_info *cinfo)
  270. {
  271. WARN("%s: DSI not compiled in\n", __func__);
  272. return -ENODEV;
  273. }
  274. static inline int dsi_pll_init(struct platform_device *dsidev,
  275. bool enable_hsclk, bool enable_hsdiv)
  276. {
  277. WARN("%s: DSI not compiled in\n", __func__);
  278. return -ENODEV;
  279. }
  280. static inline void dsi_pll_uninit(struct platform_device *dsidev,
  281. bool disconnect_lanes)
  282. {
  283. }
  284. static inline void dsi_wait_pll_hsdiv_dispc_active(struct platform_device *dsidev)
  285. {
  286. }
  287. static inline void dsi_wait_pll_hsdiv_dsi_active(struct platform_device *dsidev)
  288. {
  289. }
  290. static inline struct platform_device *dsi_get_dsidev_from_id(int module)
  291. {
  292. return NULL;
  293. }
  294. static inline unsigned long dsi_get_pll_clkin(struct platform_device *dsidev)
  295. {
  296. return 0;
  297. }
  298. static inline bool dsi_hsdiv_calc(struct platform_device *dsidev,
  299. unsigned long pll, unsigned long out_min,
  300. dsi_hsdiv_calc_func func, void *data)
  301. {
  302. return false;
  303. }
  304. static inline bool dsi_pll_calc(struct platform_device *dsidev,
  305. unsigned long clkin,
  306. unsigned long pll_min, unsigned long pll_max,
  307. dsi_pll_calc_func func, void *data)
  308. {
  309. return false;
  310. }
  311. #endif
  312. /* DPI */
  313. int dpi_init_platform_driver(void) __init;
  314. void dpi_uninit_platform_driver(void) __exit;
  315. /* DISPC */
  316. int dispc_init_platform_driver(void) __init;
  317. void dispc_uninit_platform_driver(void) __exit;
  318. void dispc_dump_clocks(struct seq_file *s);
  319. void dispc_enable_sidle(void);
  320. void dispc_disable_sidle(void);
  321. void dispc_lcd_enable_signal(bool enable);
  322. void dispc_pck_free_enable(bool enable);
  323. void dispc_enable_fifomerge(bool enable);
  324. void dispc_enable_gamma_table(bool enable);
  325. void dispc_set_loadmode(enum omap_dss_load_mode mode);
  326. typedef bool (*dispc_div_calc_func)(int lckd, int pckd, unsigned long lck,
  327. unsigned long pck, void *data);
  328. bool dispc_div_calc(unsigned long dispc,
  329. unsigned long pck_min, unsigned long pck_max,
  330. dispc_div_calc_func func, void *data);
  331. bool dispc_mgr_timings_ok(enum omap_channel channel,
  332. const struct omap_video_timings *timings);
  333. unsigned long dispc_fclk_rate(void);
  334. int dispc_calc_clock_rates(unsigned long dispc_fclk_rate,
  335. struct dispc_clock_info *cinfo);
  336. void dispc_ovl_set_fifo_threshold(enum omap_plane plane, u32 low, u32 high);
  337. void dispc_ovl_compute_fifo_thresholds(enum omap_plane plane,
  338. u32 *fifo_low, u32 *fifo_high, bool use_fifomerge,
  339. bool manual_update);
  340. unsigned long dispc_mgr_lclk_rate(enum omap_channel channel);
  341. unsigned long dispc_mgr_pclk_rate(enum omap_channel channel);
  342. unsigned long dispc_core_clk_rate(void);
  343. void dispc_mgr_set_clock_div(enum omap_channel channel,
  344. const struct dispc_clock_info *cinfo);
  345. int dispc_mgr_get_clock_div(enum omap_channel channel,
  346. struct dispc_clock_info *cinfo);
  347. void dispc_set_tv_pclk(unsigned long pclk);
  348. u32 dispc_wb_get_framedone_irq(void);
  349. bool dispc_wb_go_busy(void);
  350. void dispc_wb_go(void);
  351. void dispc_wb_enable(bool enable);
  352. bool dispc_wb_is_enabled(void);
  353. void dispc_wb_set_channel_in(enum dss_writeback_channel channel);
  354. int dispc_wb_setup(const struct omap_dss_writeback_info *wi,
  355. bool mem_to_mem, const struct omap_video_timings *timings);
  356. /* VENC */
  357. int venc_init_platform_driver(void) __init;
  358. void venc_uninit_platform_driver(void) __exit;
  359. /* HDMI */
  360. int hdmi_init_platform_driver(void) __init;
  361. void hdmi_uninit_platform_driver(void) __exit;
  362. /* RFBI */
  363. int rfbi_init_platform_driver(void) __init;
  364. void rfbi_uninit_platform_driver(void) __exit;
  365. #ifdef CONFIG_OMAP2_DSS_COLLECT_IRQ_STATS
  366. static inline void dss_collect_irq_stats(u32 irqstatus, unsigned *irq_arr)
  367. {
  368. int b;
  369. for (b = 0; b < 32; ++b) {
  370. if (irqstatus & (1 << b))
  371. irq_arr[b]++;
  372. }
  373. }
  374. #endif
  375. #endif