1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3 * Copyright (C) 2009 Nokia Corporation
4 * Author: Tomi Valkeinen <tomi.valkeinen@ti.com>
5 *
6 * Some code and ideas taken from drivers/video/omap/ driver
7 * by Imre Deak.
8 */
9
10 #ifndef __OMAP2_DSS_H
11 #define __OMAP2_DSS_H
12
13 #include <linux/interrupt.h>
14
15 #include "omapdss.h"
16
17 struct dispc_device;
18 struct dss_debugfs_entry;
19 struct platform_device;
20 struct seq_file;
21
22 #define MAX_DSS_LCD_MANAGERS 3
23 #define MAX_NUM_DSI 2
24
25 #ifdef pr_fmt
26 #undef pr_fmt
27 #endif
28
29 #ifdef DSS_SUBSYS_NAME
30 #define pr_fmt(fmt) DSS_SUBSYS_NAME ": " fmt
31 #else
32 #define pr_fmt(fmt) fmt
33 #endif
34
35 #define DSSDBG(format, ...) \
36 pr_debug(format, ## __VA_ARGS__)
37
38 #ifdef DSS_SUBSYS_NAME
39 #define DSSERR(format, ...) \
40 pr_err("omapdss " DSS_SUBSYS_NAME " error: " format, ##__VA_ARGS__)
41 #else
42 #define DSSERR(format, ...) \
43 pr_err("omapdss error: " format, ##__VA_ARGS__)
44 #endif
45
46 #ifdef DSS_SUBSYS_NAME
47 #define DSSINFO(format, ...) \
48 pr_info("omapdss " DSS_SUBSYS_NAME ": " format, ##__VA_ARGS__)
49 #else
50 #define DSSINFO(format, ...) \
51 pr_info("omapdss: " format, ## __VA_ARGS__)
52 #endif
53
54 #ifdef DSS_SUBSYS_NAME
55 #define DSSWARN(format, ...) \
56 pr_warn("omapdss " DSS_SUBSYS_NAME ": " format, ##__VA_ARGS__)
57 #else
58 #define DSSWARN(format, ...) \
59 pr_warn("omapdss: " format, ##__VA_ARGS__)
60 #endif
61
62 /* OMAP TRM gives bitfields as start:end, where start is the higher bit
63 number. For example 7:0 */
64 #define FLD_MASK(start, end) (((1 << ((start) - (end) + 1)) - 1) << (end))
65 #define FLD_VAL(val, start, end) (((val) << (end)) & FLD_MASK(start, end))
66 #define FLD_GET(val, start, end) (((val) & FLD_MASK(start, end)) >> (end))
67 #define FLD_MOD(orig, val, start, end) \
68 (((orig) & ~FLD_MASK(start, end)) | FLD_VAL(val, start, end))
69
70 enum dss_model {
71 DSS_MODEL_OMAP2,
72 DSS_MODEL_OMAP3,
73 DSS_MODEL_OMAP4,
74 DSS_MODEL_OMAP5,
75 DSS_MODEL_DRA7,
76 };
77
78 enum dss_io_pad_mode {
79 DSS_IO_PAD_MODE_RESET,
80 DSS_IO_PAD_MODE_RFBI,
81 DSS_IO_PAD_MODE_BYPASS,
82 };
83
84 enum dss_hdmi_venc_clk_source_select {
85 DSS_VENC_TV_CLK = 0,
86 DSS_HDMI_M_PCLK = 1,
87 };
88
89 enum dss_dsi_content_type {
90 DSS_DSI_CONTENT_DCS,
91 DSS_DSI_CONTENT_GENERIC,
92 };
93
94 enum dss_clk_source {
95 DSS_CLK_SRC_FCK = 0,
96
97 DSS_CLK_SRC_PLL1_1,
98 DSS_CLK_SRC_PLL1_2,
99 DSS_CLK_SRC_PLL1_3,
100
101 DSS_CLK_SRC_PLL2_1,
102 DSS_CLK_SRC_PLL2_2,
103 DSS_CLK_SRC_PLL2_3,
104
105 DSS_CLK_SRC_HDMI_PLL,
106 };
107
108 enum dss_pll_id {
109 DSS_PLL_DSI1,
110 DSS_PLL_DSI2,
111 DSS_PLL_HDMI,
112 DSS_PLL_VIDEO1,
113 DSS_PLL_VIDEO2,
114 };
115
116 struct dss_pll;
117
118 #define DSS_PLL_MAX_HSDIVS 4
119
120 enum dss_pll_type {
121 DSS_PLL_TYPE_A,
122 DSS_PLL_TYPE_B,
123 };
124
125 /*
126 * Type-A PLLs: clkout[]/mX[] refer to hsdiv outputs m4, m5, m6, m7.
127 * Type-B PLLs: clkout[0] refers to m2.
128 */
129 struct dss_pll_clock_info {
130 /* rates that we get with dividers below */
131 unsigned long fint;
132 unsigned long clkdco;
133 unsigned long clkout[DSS_PLL_MAX_HSDIVS];
134
135 /* dividers */
136 u16 n;
137 u16 m;
138 u32 mf;
139 u16 mX[DSS_PLL_MAX_HSDIVS];
140 u16 sd;
141 };
142
143 struct dss_pll_ops {
144 int (*enable)(struct dss_pll *pll);
145 void (*disable)(struct dss_pll *pll);
146 int (*set_config)(struct dss_pll *pll,
147 const struct dss_pll_clock_info *cinfo);
148 };
149
150 struct dss_pll_hw {
151 enum dss_pll_type type;
152
153 unsigned int n_max;
154 unsigned int m_min;
155 unsigned int m_max;
156 unsigned int mX_max;
157
158 unsigned long fint_min, fint_max;
159 unsigned long clkdco_min, clkdco_low, clkdco_max;
160
161 u8 n_msb, n_lsb;
162 u8 m_msb, m_lsb;
163 u8 mX_msb[DSS_PLL_MAX_HSDIVS], mX_lsb[DSS_PLL_MAX_HSDIVS];
164
165 bool has_stopmode;
166 bool has_freqsel;
167 bool has_selfreqdco;
168 bool has_refsel;
169
170 /* DRA7 errata i886: use high N & M to avoid jitter */
171 bool errata_i886;
172
173 /* DRA7 errata i932: retry pll lock on failure */
174 bool errata_i932;
175 };
176
177 struct dss_pll {
178 const char *name;
179 enum dss_pll_id id;
180 struct dss_device *dss;
181
182 struct clk *clkin;
183 struct regulator *regulator;
184
185 void __iomem *base;
186
187 const struct dss_pll_hw *hw;
188
189 const struct dss_pll_ops *ops;
190
191 struct dss_pll_clock_info cinfo;
192 };
193
194 /* Defines a generic omap register field */
195 struct dss_reg_field {
196 u8 start, end;
197 };
198
199 struct dispc_clock_info {
200 /* rates that we get with dividers below */
201 unsigned long lck;
202 unsigned long pck;
203
204 /* dividers */
205 u16 lck_div;
206 u16 pck_div;
207 };
208
209 struct dss_lcd_mgr_config {
210 enum dss_io_pad_mode io_pad_mode;
211
212 bool stallmode;
213 bool fifohandcheck;
214
215 struct dispc_clock_info clock_info;
216
217 int video_port_width;
218
219 int lcden_sig_polarity;
220 };
221
222 #define DSS_SZ_REGS SZ_512
223
224 struct dss_device {
225 struct platform_device *pdev;
226 void __iomem *base;
227 struct regmap *syscon_pll_ctrl;
228 u32 syscon_pll_ctrl_offset;
229
230 struct platform_device *drm_pdev;
231
232 struct clk *parent_clk;
233 struct clk *dss_clk;
234 unsigned long dss_clk_rate;
235
236 unsigned long cache_req_pck;
237 unsigned long cache_prate;
238 struct dispc_clock_info cache_dispc_cinfo;
239
240 enum dss_clk_source dsi_clk_source[MAX_NUM_DSI];
241 enum dss_clk_source dispc_clk_source;
242 enum dss_clk_source lcd_clk_source[MAX_DSS_LCD_MANAGERS];
243
244 bool ctx_valid;
245 u32 ctx[DSS_SZ_REGS / sizeof(u32)];
246
247 const struct dss_features *feat;
248
249 struct {
250 struct dentry *root;
251 struct dss_debugfs_entry *clk;
252 struct dss_debugfs_entry *dss;
253 } debugfs;
254
255 struct dss_pll *plls[4];
256 struct dss_pll *video1_pll;
257 struct dss_pll *video2_pll;
258
259 struct dispc_device *dispc;
260 struct omap_drm_private *mgr_ops_priv;
261 };
262
263 /* core */
dss_set_min_bus_tput(struct device * dev,unsigned long tput)264 static inline int dss_set_min_bus_tput(struct device *dev, unsigned long tput)
265 {
266 /* To be implemented when the OMAP platform will provide this feature */
267 return 0;
268 }
269
dss_mgr_is_lcd(enum omap_channel id)270 static inline bool dss_mgr_is_lcd(enum omap_channel id)
271 {
272 if (id == OMAP_DSS_CHANNEL_LCD || id == OMAP_DSS_CHANNEL_LCD2 ||
273 id == OMAP_DSS_CHANNEL_LCD3)
274 return true;
275 else
276 return false;
277 }
278
279 /* DSS */
280 #if defined(CONFIG_OMAP2_DSS_DEBUGFS)
281 struct dss_debugfs_entry *
282 dss_debugfs_create_file(struct dss_device *dss, const char *name,
283 int (*show_fn)(struct seq_file *s, void *data),
284 void *data);
285 void dss_debugfs_remove_file(struct dss_debugfs_entry *entry);
286 #else
287 static inline struct dss_debugfs_entry *
dss_debugfs_create_file(struct dss_device * dss,const char * name,int (* show_fn)(struct seq_file * s,void * data),void * data)288 dss_debugfs_create_file(struct dss_device *dss, const char *name,
289 int (*show_fn)(struct seq_file *s, void *data),
290 void *data)
291 {
292 return NULL;
293 }
294
dss_debugfs_remove_file(struct dss_debugfs_entry * entry)295 static inline void dss_debugfs_remove_file(struct dss_debugfs_entry *entry)
296 {
297 }
298 #endif /* CONFIG_OMAP2_DSS_DEBUGFS */
299
300 struct dss_device *dss_get_device(struct device *dev);
301
302 int dss_runtime_get(struct dss_device *dss);
303 void dss_runtime_put(struct dss_device *dss);
304
305 unsigned long dss_get_dispc_clk_rate(struct dss_device *dss);
306 unsigned long dss_get_max_fck_rate(struct dss_device *dss);
307 int dss_dpi_select_source(struct dss_device *dss, int port,
308 enum omap_channel channel);
309 void dss_select_hdmi_venc_clk_source(struct dss_device *dss,
310 enum dss_hdmi_venc_clk_source_select src);
311 const char *dss_get_clk_source_name(enum dss_clk_source clk_src);
312
313 /* DSS VIDEO PLL */
314 struct dss_pll *dss_video_pll_init(struct dss_device *dss,
315 struct platform_device *pdev, int id,
316 struct regulator *regulator);
317 void dss_video_pll_uninit(struct dss_pll *pll);
318
319 void dss_ctrl_pll_enable(struct dss_pll *pll, bool enable);
320
321 void dss_sdi_init(struct dss_device *dss, int datapairs);
322 int dss_sdi_enable(struct dss_device *dss);
323 void dss_sdi_disable(struct dss_device *dss);
324
325 void dss_select_dsi_clk_source(struct dss_device *dss, int dsi_module,
326 enum dss_clk_source clk_src);
327 void dss_select_lcd_clk_source(struct dss_device *dss,
328 enum omap_channel channel,
329 enum dss_clk_source clk_src);
330 enum dss_clk_source dss_get_dispc_clk_source(struct dss_device *dss);
331 enum dss_clk_source dss_get_dsi_clk_source(struct dss_device *dss,
332 int dsi_module);
333 enum dss_clk_source dss_get_lcd_clk_source(struct dss_device *dss,
334 enum omap_channel channel);
335
336 void dss_set_venc_output(struct dss_device *dss, enum omap_dss_venc_type type);
337 void dss_set_dac_pwrdn_bgz(struct dss_device *dss, bool enable);
338
339 int dss_set_fck_rate(struct dss_device *dss, unsigned long rate);
340
341 typedef bool (*dss_div_calc_func)(unsigned long fck, void *data);
342 bool dss_div_calc(struct dss_device *dss, unsigned long pck,
343 unsigned long fck_min, dss_div_calc_func func, void *data);
344
345 /* SDI */
346 #ifdef CONFIG_OMAP2_DSS_SDI
347 int sdi_init_port(struct dss_device *dss, struct platform_device *pdev,
348 struct device_node *port);
349 void sdi_uninit_port(struct device_node *port);
350 #else
sdi_init_port(struct dss_device * dss,struct platform_device * pdev,struct device_node * port)351 static inline int sdi_init_port(struct dss_device *dss,
352 struct platform_device *pdev,
353 struct device_node *port)
354 {
355 return 0;
356 }
sdi_uninit_port(struct device_node * port)357 static inline void sdi_uninit_port(struct device_node *port)
358 {
359 }
360 #endif
361
362 /* DSI */
363
364 #ifdef CONFIG_OMAP2_DSS_DSI
365
366 void dsi_irq_handler(void);
367
368 #endif
369
370 /* DPI */
371 #ifdef CONFIG_OMAP2_DSS_DPI
372 int dpi_init_port(struct dss_device *dss, struct platform_device *pdev,
373 struct device_node *port, enum dss_model dss_model);
374 void dpi_uninit_port(struct device_node *port);
375 #else
dpi_init_port(struct dss_device * dss,struct platform_device * pdev,struct device_node * port,enum dss_model dss_model)376 static inline int dpi_init_port(struct dss_device *dss,
377 struct platform_device *pdev,
378 struct device_node *port,
379 enum dss_model dss_model)
380 {
381 return 0;
382 }
dpi_uninit_port(struct device_node * port)383 static inline void dpi_uninit_port(struct device_node *port)
384 {
385 }
386 #endif
387
388 /* DISPC */
389 void dispc_dump_clocks(struct dispc_device *dispc, struct seq_file *s);
390
391 int dispc_runtime_get(struct dispc_device *dispc);
392 void dispc_runtime_put(struct dispc_device *dispc);
393
394 int dispc_get_num_ovls(struct dispc_device *dispc);
395 int dispc_get_num_mgrs(struct dispc_device *dispc);
396
397 const u32 *dispc_ovl_get_color_modes(struct dispc_device *dispc,
398 enum omap_plane_id plane);
399
400 u32 dispc_read_irqstatus(struct dispc_device *dispc);
401 void dispc_clear_irqstatus(struct dispc_device *dispc, u32 mask);
402 void dispc_write_irqenable(struct dispc_device *dispc, u32 mask);
403
404 int dispc_request_irq(struct dispc_device *dispc, irq_handler_t handler,
405 void *dev_id);
406 void dispc_free_irq(struct dispc_device *dispc, void *dev_id);
407
408 u32 dispc_mgr_get_vsync_irq(struct dispc_device *dispc,
409 enum omap_channel channel);
410 u32 dispc_mgr_get_framedone_irq(struct dispc_device *dispc,
411 enum omap_channel channel);
412 u32 dispc_mgr_get_sync_lost_irq(struct dispc_device *dispc,
413 enum omap_channel channel);
414 u32 dispc_wb_get_framedone_irq(struct dispc_device *dispc);
415
416 u32 dispc_get_memory_bandwidth_limit(struct dispc_device *dispc);
417
418 void dispc_mgr_enable(struct dispc_device *dispc,
419 enum omap_channel channel, bool enable);
420
421 bool dispc_mgr_go_busy(struct dispc_device *dispc,
422 enum omap_channel channel);
423
424 void dispc_mgr_go(struct dispc_device *dispc, enum omap_channel channel);
425
426 void dispc_mgr_set_lcd_config(struct dispc_device *dispc,
427 enum omap_channel channel,
428 const struct dss_lcd_mgr_config *config);
429 void dispc_mgr_set_timings(struct dispc_device *dispc,
430 enum omap_channel channel,
431 const struct videomode *vm);
432 void dispc_mgr_setup(struct dispc_device *dispc,
433 enum omap_channel channel,
434 const struct omap_overlay_manager_info *info);
435
436 int dispc_mgr_check_timings(struct dispc_device *dispc,
437 enum omap_channel channel,
438 const struct videomode *vm);
439
440 u32 dispc_mgr_gamma_size(struct dispc_device *dispc,
441 enum omap_channel channel);
442 void dispc_mgr_set_gamma(struct dispc_device *dispc,
443 enum omap_channel channel,
444 const struct drm_color_lut *lut,
445 unsigned int length);
446
447 int dispc_ovl_setup(struct dispc_device *dispc,
448 enum omap_plane_id plane,
449 const struct omap_overlay_info *oi,
450 const struct videomode *vm, bool mem_to_mem,
451 enum omap_channel channel);
452
453 int dispc_ovl_enable(struct dispc_device *dispc,
454 enum omap_plane_id plane, bool enable);
455
456 bool dispc_has_writeback(struct dispc_device *dispc);
457 int dispc_wb_setup(struct dispc_device *dispc,
458 const struct omap_dss_writeback_info *wi,
459 bool mem_to_mem, const struct videomode *vm,
460 enum dss_writeback_channel channel_in);
461 bool dispc_wb_go_busy(struct dispc_device *dispc);
462 void dispc_wb_go(struct dispc_device *dispc);
463
464 void dispc_enable_sidle(struct dispc_device *dispc);
465 void dispc_disable_sidle(struct dispc_device *dispc);
466
467 void dispc_lcd_enable_signal(struct dispc_device *dispc, bool enable);
468 void dispc_pck_free_enable(struct dispc_device *dispc, bool enable);
469 void dispc_enable_fifomerge(struct dispc_device *dispc, bool enable);
470
471 typedef bool (*dispc_div_calc_func)(int lckd, int pckd, unsigned long lck,
472 unsigned long pck, void *data);
473 bool dispc_div_calc(struct dispc_device *dispc, unsigned long dispc_freq,
474 unsigned long pck_min, unsigned long pck_max,
475 dispc_div_calc_func func, void *data);
476
477 int dispc_calc_clock_rates(struct dispc_device *dispc,
478 unsigned long dispc_fclk_rate,
479 struct dispc_clock_info *cinfo);
480
481
482 void dispc_ovl_set_fifo_threshold(struct dispc_device *dispc,
483 enum omap_plane_id plane, u32 low, u32 high);
484 void dispc_ovl_compute_fifo_thresholds(struct dispc_device *dispc,
485 enum omap_plane_id plane,
486 u32 *fifo_low, u32 *fifo_high,
487 bool use_fifomerge, bool manual_update);
488
489 void dispc_mgr_set_clock_div(struct dispc_device *dispc,
490 enum omap_channel channel,
491 const struct dispc_clock_info *cinfo);
492 int dispc_mgr_get_clock_div(struct dispc_device *dispc,
493 enum omap_channel channel,
494 struct dispc_clock_info *cinfo);
495 void dispc_set_tv_pclk(struct dispc_device *dispc, unsigned long pclk);
496
497 #ifdef CONFIG_OMAP2_DSS_COLLECT_IRQ_STATS
dss_collect_irq_stats(u32 irqstatus,unsigned int * irq_arr)498 static inline void dss_collect_irq_stats(u32 irqstatus, unsigned int *irq_arr)
499 {
500 int b;
501 for (b = 0; b < 32; ++b) {
502 if (irqstatus & (1 << b))
503 irq_arr[b]++;
504 }
505 }
506 #endif
507
508 /* PLL */
509 typedef bool (*dss_pll_calc_func)(int n, int m, unsigned long fint,
510 unsigned long clkdco, void *data);
511 typedef bool (*dss_hsdiv_calc_func)(int m_dispc, unsigned long dispc,
512 void *data);
513
514 int dss_pll_register(struct dss_device *dss, struct dss_pll *pll);
515 void dss_pll_unregister(struct dss_pll *pll);
516 struct dss_pll *dss_pll_find(struct dss_device *dss, const char *name);
517 struct dss_pll *dss_pll_find_by_src(struct dss_device *dss,
518 enum dss_clk_source src);
519 unsigned int dss_pll_get_clkout_idx_for_src(enum dss_clk_source src);
520 int dss_pll_enable(struct dss_pll *pll);
521 void dss_pll_disable(struct dss_pll *pll);
522 int dss_pll_set_config(struct dss_pll *pll,
523 const struct dss_pll_clock_info *cinfo);
524
525 bool dss_pll_hsdiv_calc_a(const struct dss_pll *pll, unsigned long clkdco,
526 unsigned long out_min, unsigned long out_max,
527 dss_hsdiv_calc_func func, void *data);
528 bool dss_pll_calc_a(const struct dss_pll *pll, unsigned long clkin,
529 unsigned long pll_min, unsigned long pll_max,
530 dss_pll_calc_func func, void *data);
531
532 bool dss_pll_calc_b(const struct dss_pll *pll, unsigned long clkin,
533 unsigned long target_clkout, struct dss_pll_clock_info *cinfo);
534
535 int dss_pll_write_config_type_a(struct dss_pll *pll,
536 const struct dss_pll_clock_info *cinfo);
537 int dss_pll_write_config_type_b(struct dss_pll *pll,
538 const struct dss_pll_clock_info *cinfo);
539 int dss_pll_wait_reset_done(struct dss_pll *pll);
540
541 extern struct platform_driver omap_dsshw_driver;
542 extern struct platform_driver omap_dispchw_driver;
543 #ifdef CONFIG_OMAP2_DSS_DSI
544 extern struct platform_driver omap_dsihw_driver;
545 #endif
546 #ifdef CONFIG_OMAP2_DSS_VENC
547 extern struct platform_driver omap_venchw_driver;
548 #endif
549 #ifdef CONFIG_OMAP4_DSS_HDMI
550 extern struct platform_driver omapdss_hdmi4hw_driver;
551 #endif
552 #ifdef CONFIG_OMAP5_DSS_HDMI
553 extern struct platform_driver omapdss_hdmi5hw_driver;
554 #endif
555
556 #endif
557