dss.h 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486
  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. struct bus_type *dss_get_bus(void);
  140. struct regulator *dss_get_vdds_dsi(void);
  141. struct regulator *dss_get_vdds_sdi(void);
  142. int dss_dsi_enable_pads(int dsi_id, unsigned lane_mask);
  143. void dss_dsi_disable_pads(int dsi_id, unsigned lane_mask);
  144. int dss_set_min_bus_tput(struct device *dev, unsigned long tput);
  145. int dss_debugfs_create_file(const char *name, void (*write)(struct seq_file *));
  146. struct omap_dss_device *dss_alloc_and_init_device(struct device *parent);
  147. int dss_add_device(struct omap_dss_device *dssdev);
  148. void dss_unregister_device(struct omap_dss_device *dssdev);
  149. void dss_unregister_child_devices(struct device *parent);
  150. void dss_put_device(struct omap_dss_device *dssdev);
  151. void dss_copy_device_pdata(struct omap_dss_device *dst,
  152. const struct omap_dss_device *src);
  153. /* output */
  154. void dss_register_output(struct omap_dss_output *out);
  155. void dss_unregister_output(struct omap_dss_output *out);
  156. /* display */
  157. int dss_suspend_all_devices(void);
  158. int dss_resume_all_devices(void);
  159. void dss_disable_all_devices(void);
  160. int display_init_sysfs(struct platform_device *pdev,
  161. struct omap_dss_device *dssdev);
  162. void display_uninit_sysfs(struct platform_device *pdev,
  163. struct omap_dss_device *dssdev);
  164. /* manager */
  165. int dss_init_overlay_managers(struct platform_device *pdev);
  166. void dss_uninit_overlay_managers(struct platform_device *pdev);
  167. int dss_mgr_simple_check(struct omap_overlay_manager *mgr,
  168. const struct omap_overlay_manager_info *info);
  169. int dss_mgr_check_timings(struct omap_overlay_manager *mgr,
  170. const struct omap_video_timings *timings);
  171. int dss_mgr_check(struct omap_overlay_manager *mgr,
  172. struct omap_overlay_manager_info *info,
  173. const struct omap_video_timings *mgr_timings,
  174. const struct dss_lcd_mgr_config *config,
  175. struct omap_overlay_info **overlay_infos);
  176. static inline bool dss_mgr_is_lcd(enum omap_channel id)
  177. {
  178. if (id == OMAP_DSS_CHANNEL_LCD || id == OMAP_DSS_CHANNEL_LCD2 ||
  179. id == OMAP_DSS_CHANNEL_LCD3)
  180. return true;
  181. else
  182. return false;
  183. }
  184. int dss_manager_kobj_init(struct omap_overlay_manager *mgr,
  185. struct platform_device *pdev);
  186. void dss_manager_kobj_uninit(struct omap_overlay_manager *mgr);
  187. /* overlay */
  188. void dss_init_overlays(struct platform_device *pdev);
  189. void dss_uninit_overlays(struct platform_device *pdev);
  190. void dss_overlay_setup_dispc_manager(struct omap_overlay_manager *mgr);
  191. int dss_ovl_simple_check(struct omap_overlay *ovl,
  192. const struct omap_overlay_info *info);
  193. int dss_ovl_check(struct omap_overlay *ovl, struct omap_overlay_info *info,
  194. const struct omap_video_timings *mgr_timings);
  195. bool dss_ovl_use_replication(struct dss_lcd_mgr_config config,
  196. enum omap_color_mode mode);
  197. int dss_overlay_kobj_init(struct omap_overlay *ovl,
  198. struct platform_device *pdev);
  199. void dss_overlay_kobj_uninit(struct omap_overlay *ovl);
  200. /* DSS */
  201. int dss_init_platform_driver(void) __init;
  202. void dss_uninit_platform_driver(void);
  203. unsigned long dss_get_dispc_clk_rate(void);
  204. int dss_dpi_select_source(enum omap_channel channel);
  205. void dss_select_hdmi_venc_clk_source(enum dss_hdmi_venc_clk_source_select);
  206. enum dss_hdmi_venc_clk_source_select dss_get_hdmi_venc_clk_source(void);
  207. const char *dss_get_generic_clk_source_name(enum omap_dss_clk_source clk_src);
  208. void dss_dump_clocks(struct seq_file *s);
  209. #if defined(CONFIG_OMAP2_DSS_DEBUGFS)
  210. void dss_debug_dump_clocks(struct seq_file *s);
  211. #endif
  212. int dss_get_ctx_loss_count(void);
  213. void dss_sdi_init(int datapairs);
  214. int dss_sdi_enable(void);
  215. void dss_sdi_disable(void);
  216. void dss_select_dsi_clk_source(int dsi_module,
  217. enum omap_dss_clk_source clk_src);
  218. void dss_select_lcd_clk_source(enum omap_channel channel,
  219. enum omap_dss_clk_source clk_src);
  220. enum omap_dss_clk_source dss_get_dispc_clk_source(void);
  221. enum omap_dss_clk_source dss_get_dsi_clk_source(int dsi_module);
  222. enum omap_dss_clk_source dss_get_lcd_clk_source(enum omap_channel channel);
  223. void dss_set_venc_output(enum omap_dss_venc_type type);
  224. void dss_set_dac_pwrdn_bgz(bool enable);
  225. unsigned long dss_get_dpll4_rate(void);
  226. int dss_calc_clock_rates(struct dss_clock_info *cinfo);
  227. int dss_set_clock_div(struct dss_clock_info *cinfo);
  228. int dss_calc_clock_div(unsigned long req_pck, struct dss_clock_info *dss_cinfo,
  229. struct dispc_clock_info *dispc_cinfo);
  230. /* SDI */
  231. int sdi_init_platform_driver(void) __init;
  232. void sdi_uninit_platform_driver(void) __exit;
  233. /* DSI */
  234. #ifdef CONFIG_OMAP2_DSS_DSI
  235. struct dentry;
  236. struct file_operations;
  237. int dsi_init_platform_driver(void) __init;
  238. void dsi_uninit_platform_driver(void) __exit;
  239. int dsi_runtime_get(struct platform_device *dsidev);
  240. void dsi_runtime_put(struct platform_device *dsidev);
  241. void dsi_dump_clocks(struct seq_file *s);
  242. void dsi_irq_handler(void);
  243. u8 dsi_get_pixel_size(enum omap_dss_dsi_pixel_format fmt);
  244. unsigned long dsi_get_pll_hsdiv_dispc_rate(struct platform_device *dsidev);
  245. int dsi_pll_set_clock_div(struct platform_device *dsidev,
  246. struct dsi_clock_info *cinfo);
  247. int dsi_pll_calc_clock_div_pck(struct platform_device *dsidev,
  248. unsigned long req_pck, struct dsi_clock_info *cinfo,
  249. struct dispc_clock_info *dispc_cinfo);
  250. int dsi_pll_init(struct platform_device *dsidev, bool enable_hsclk,
  251. bool enable_hsdiv);
  252. void dsi_pll_uninit(struct platform_device *dsidev, bool disconnect_lanes);
  253. void dsi_wait_pll_hsdiv_dispc_active(struct platform_device *dsidev);
  254. void dsi_wait_pll_hsdiv_dsi_active(struct platform_device *dsidev);
  255. struct platform_device *dsi_get_dsidev_from_id(int module);
  256. #else
  257. static inline int dsi_runtime_get(struct platform_device *dsidev)
  258. {
  259. return 0;
  260. }
  261. static inline void dsi_runtime_put(struct platform_device *dsidev)
  262. {
  263. }
  264. static inline u8 dsi_get_pixel_size(enum omap_dss_dsi_pixel_format fmt)
  265. {
  266. WARN("%s: DSI not compiled in, returning pixel_size as 0\n", __func__);
  267. return 0;
  268. }
  269. static inline unsigned long dsi_get_pll_hsdiv_dispc_rate(struct platform_device *dsidev)
  270. {
  271. WARN("%s: DSI not compiled in, returning rate as 0\n", __func__);
  272. return 0;
  273. }
  274. static inline int dsi_pll_set_clock_div(struct platform_device *dsidev,
  275. struct dsi_clock_info *cinfo)
  276. {
  277. WARN("%s: DSI not compiled in\n", __func__);
  278. return -ENODEV;
  279. }
  280. static inline int dsi_pll_calc_clock_div_pck(struct platform_device *dsidev,
  281. unsigned long req_pck,
  282. struct dsi_clock_info *dsi_cinfo,
  283. struct dispc_clock_info *dispc_cinfo)
  284. {
  285. WARN("%s: DSI not compiled in\n", __func__);
  286. return -ENODEV;
  287. }
  288. static inline int dsi_pll_init(struct platform_device *dsidev,
  289. bool enable_hsclk, bool enable_hsdiv)
  290. {
  291. WARN("%s: DSI not compiled in\n", __func__);
  292. return -ENODEV;
  293. }
  294. static inline void dsi_pll_uninit(struct platform_device *dsidev,
  295. bool disconnect_lanes)
  296. {
  297. }
  298. static inline void dsi_wait_pll_hsdiv_dispc_active(struct platform_device *dsidev)
  299. {
  300. }
  301. static inline void dsi_wait_pll_hsdiv_dsi_active(struct platform_device *dsidev)
  302. {
  303. }
  304. static inline struct platform_device *dsi_get_dsidev_from_id(int module)
  305. {
  306. return NULL;
  307. }
  308. #endif
  309. /* DPI */
  310. int dpi_init_platform_driver(void) __init;
  311. void dpi_uninit_platform_driver(void) __exit;
  312. /* DISPC */
  313. int dispc_init_platform_driver(void) __init;
  314. void dispc_uninit_platform_driver(void) __exit;
  315. void dispc_dump_clocks(struct seq_file *s);
  316. void dispc_enable_sidle(void);
  317. void dispc_disable_sidle(void);
  318. void dispc_lcd_enable_signal(bool enable);
  319. void dispc_pck_free_enable(bool enable);
  320. void dispc_enable_fifomerge(bool enable);
  321. void dispc_enable_gamma_table(bool enable);
  322. void dispc_set_loadmode(enum omap_dss_load_mode mode);
  323. bool dispc_mgr_timings_ok(enum omap_channel channel,
  324. const struct omap_video_timings *timings);
  325. unsigned long dispc_fclk_rate(void);
  326. void dispc_find_clk_divs(unsigned long req_pck, unsigned long fck,
  327. struct dispc_clock_info *cinfo);
  328. int dispc_calc_clock_rates(unsigned long dispc_fclk_rate,
  329. struct dispc_clock_info *cinfo);
  330. void dispc_ovl_set_fifo_threshold(enum omap_plane plane, u32 low, u32 high);
  331. void dispc_ovl_compute_fifo_thresholds(enum omap_plane plane,
  332. u32 *fifo_low, u32 *fifo_high, bool use_fifomerge,
  333. bool manual_update);
  334. unsigned long dispc_mgr_lclk_rate(enum omap_channel channel);
  335. unsigned long dispc_mgr_pclk_rate(enum omap_channel channel);
  336. unsigned long dispc_core_clk_rate(void);
  337. void dispc_mgr_set_clock_div(enum omap_channel channel,
  338. const struct dispc_clock_info *cinfo);
  339. int dispc_mgr_get_clock_div(enum omap_channel channel,
  340. struct dispc_clock_info *cinfo);
  341. u32 dispc_wb_get_framedone_irq(void);
  342. bool dispc_wb_go_busy(void);
  343. void dispc_wb_go(void);
  344. void dispc_wb_enable(bool enable);
  345. bool dispc_wb_is_enabled(void);
  346. void dispc_wb_set_channel_in(enum dss_writeback_channel channel);
  347. int dispc_wb_setup(const struct omap_dss_writeback_info *wi,
  348. bool mem_to_mem, const struct omap_video_timings *timings);
  349. /* VENC */
  350. #ifdef CONFIG_OMAP2_DSS_VENC
  351. int venc_init_platform_driver(void) __init;
  352. void venc_uninit_platform_driver(void) __exit;
  353. unsigned long venc_get_pixel_clock(void);
  354. #else
  355. static inline unsigned long venc_get_pixel_clock(void)
  356. {
  357. WARN("%s: VENC not compiled in, returning pclk as 0\n", __func__);
  358. return 0;
  359. }
  360. #endif
  361. int omapdss_venc_display_enable(struct omap_dss_device *dssdev);
  362. void omapdss_venc_display_disable(struct omap_dss_device *dssdev);
  363. void omapdss_venc_set_timings(struct omap_dss_device *dssdev,
  364. struct omap_video_timings *timings);
  365. int omapdss_venc_check_timings(struct omap_dss_device *dssdev,
  366. struct omap_video_timings *timings);
  367. u32 omapdss_venc_get_wss(struct omap_dss_device *dssdev);
  368. int omapdss_venc_set_wss(struct omap_dss_device *dssdev, u32 wss);
  369. void omapdss_venc_set_type(struct omap_dss_device *dssdev,
  370. enum omap_dss_venc_type type);
  371. void omapdss_venc_invert_vid_out_polarity(struct omap_dss_device *dssdev,
  372. bool invert_polarity);
  373. int venc_panel_init(void);
  374. void venc_panel_exit(void);
  375. /* HDMI */
  376. #ifdef CONFIG_OMAP4_DSS_HDMI
  377. int hdmi_init_platform_driver(void) __init;
  378. void hdmi_uninit_platform_driver(void) __exit;
  379. unsigned long hdmi_get_pixel_clock(void);
  380. #else
  381. static inline unsigned long hdmi_get_pixel_clock(void)
  382. {
  383. WARN("%s: HDMI not compiled in, returning pclk as 0\n", __func__);
  384. return 0;
  385. }
  386. #endif
  387. int omapdss_hdmi_display_enable(struct omap_dss_device *dssdev);
  388. void omapdss_hdmi_display_disable(struct omap_dss_device *dssdev);
  389. int omapdss_hdmi_core_enable(struct omap_dss_device *dssdev);
  390. void omapdss_hdmi_core_disable(struct omap_dss_device *dssdev);
  391. void omapdss_hdmi_display_set_timing(struct omap_dss_device *dssdev,
  392. struct omap_video_timings *timings);
  393. int omapdss_hdmi_display_check_timing(struct omap_dss_device *dssdev,
  394. struct omap_video_timings *timings);
  395. int omapdss_hdmi_read_edid(u8 *buf, int len);
  396. bool omapdss_hdmi_detect(void);
  397. int hdmi_panel_init(void);
  398. void hdmi_panel_exit(void);
  399. #ifdef CONFIG_OMAP4_DSS_HDMI_AUDIO
  400. int hdmi_audio_enable(void);
  401. void hdmi_audio_disable(void);
  402. int hdmi_audio_start(void);
  403. void hdmi_audio_stop(void);
  404. bool hdmi_mode_has_audio(void);
  405. int hdmi_audio_config(struct omap_dss_audio *audio);
  406. #endif
  407. /* RFBI */
  408. int rfbi_init_platform_driver(void) __init;
  409. void rfbi_uninit_platform_driver(void) __exit;
  410. #ifdef CONFIG_OMAP2_DSS_COLLECT_IRQ_STATS
  411. static inline void dss_collect_irq_stats(u32 irqstatus, unsigned *irq_arr)
  412. {
  413. int b;
  414. for (b = 0; b < 32; ++b) {
  415. if (irqstatus & (1 << b))
  416. irq_arr[b]++;
  417. }
  418. }
  419. #endif
  420. #endif