xref: /OK3568_Linux_fs/u-boot/drivers/video/ipu.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /*
2*4882a593Smuzhiyun  * Porting to u-boot:
3*4882a593Smuzhiyun  *
4*4882a593Smuzhiyun  * (C) Copyright 2010
5*4882a593Smuzhiyun  * Stefano Babic, DENX Software Engineering, sbabic@denx.de
6*4882a593Smuzhiyun  *
7*4882a593Smuzhiyun  * Linux IPU driver for MX51:
8*4882a593Smuzhiyun  *
9*4882a593Smuzhiyun  * (C) Copyright 2005-2010 Freescale Semiconductor, Inc.
10*4882a593Smuzhiyun  *
11*4882a593Smuzhiyun  * SPDX-License-Identifier:	GPL-2.0+
12*4882a593Smuzhiyun  */
13*4882a593Smuzhiyun 
14*4882a593Smuzhiyun #ifndef __ASM_ARCH_IPU_H__
15*4882a593Smuzhiyun #define __ASM_ARCH_IPU_H__
16*4882a593Smuzhiyun 
17*4882a593Smuzhiyun #include <linux/types.h>
18*4882a593Smuzhiyun #include <ipu_pixfmt.h>
19*4882a593Smuzhiyun 
20*4882a593Smuzhiyun #define IDMA_CHAN_INVALID	0xFF
21*4882a593Smuzhiyun #define HIGH_RESOLUTION_WIDTH	1024
22*4882a593Smuzhiyun 
23*4882a593Smuzhiyun struct clk {
24*4882a593Smuzhiyun 	const char *name;
25*4882a593Smuzhiyun 	int id;
26*4882a593Smuzhiyun 	/* Source clock this clk depends on */
27*4882a593Smuzhiyun 	struct clk *parent;
28*4882a593Smuzhiyun 	/* Secondary clock to enable/disable with this clock */
29*4882a593Smuzhiyun 	struct clk *secondary;
30*4882a593Smuzhiyun 	/* Current clock rate */
31*4882a593Smuzhiyun 	unsigned long rate;
32*4882a593Smuzhiyun 	/* Reference count of clock enable/disable */
33*4882a593Smuzhiyun 	__s8 usecount;
34*4882a593Smuzhiyun 	/* Register bit position for clock's enable/disable control. */
35*4882a593Smuzhiyun 	u8 enable_shift;
36*4882a593Smuzhiyun 	/* Register address for clock's enable/disable control. */
37*4882a593Smuzhiyun 	void *enable_reg;
38*4882a593Smuzhiyun 	u32 flags;
39*4882a593Smuzhiyun 	/*
40*4882a593Smuzhiyun 	 * Function ptr to recalculate the clock's rate based on parent
41*4882a593Smuzhiyun 	 * clock's rate
42*4882a593Smuzhiyun 	 */
43*4882a593Smuzhiyun 	void (*recalc) (struct clk *);
44*4882a593Smuzhiyun 	/*
45*4882a593Smuzhiyun 	 * Function ptr to set the clock to a new rate. The rate must match a
46*4882a593Smuzhiyun 	 * supported rate returned from round_rate. Leave blank if clock is not
47*4882a593Smuzhiyun 	* programmable
48*4882a593Smuzhiyun 	 */
49*4882a593Smuzhiyun 	int (*set_rate) (struct clk *, unsigned long);
50*4882a593Smuzhiyun 	/*
51*4882a593Smuzhiyun 	 * Function ptr to round the requested clock rate to the nearest
52*4882a593Smuzhiyun 	 * supported rate that is less than or equal to the requested rate.
53*4882a593Smuzhiyun 	 */
54*4882a593Smuzhiyun 	unsigned long (*round_rate) (struct clk *, unsigned long);
55*4882a593Smuzhiyun 	/*
56*4882a593Smuzhiyun 	 * Function ptr to enable the clock. Leave blank if clock can not
57*4882a593Smuzhiyun 	 * be gated.
58*4882a593Smuzhiyun 	 */
59*4882a593Smuzhiyun 	int (*enable) (struct clk *);
60*4882a593Smuzhiyun 	/*
61*4882a593Smuzhiyun 	 * Function ptr to disable the clock. Leave blank if clock can not
62*4882a593Smuzhiyun 	 * be gated.
63*4882a593Smuzhiyun 	 */
64*4882a593Smuzhiyun 	void (*disable) (struct clk *);
65*4882a593Smuzhiyun 	/* Function ptr to set the parent clock of the clock. */
66*4882a593Smuzhiyun 	int (*set_parent) (struct clk *, struct clk *);
67*4882a593Smuzhiyun };
68*4882a593Smuzhiyun 
69*4882a593Smuzhiyun /*
70*4882a593Smuzhiyun  * Enumeration of Synchronous (Memory-less) panel types
71*4882a593Smuzhiyun  */
72*4882a593Smuzhiyun typedef enum {
73*4882a593Smuzhiyun 	IPU_PANEL_SHARP_TFT,
74*4882a593Smuzhiyun 	IPU_PANEL_TFT,
75*4882a593Smuzhiyun } ipu_panel_t;
76*4882a593Smuzhiyun 
77*4882a593Smuzhiyun /*
78*4882a593Smuzhiyun  * IPU Driver channels definitions.
79*4882a593Smuzhiyun  * Note these are different from IDMA channels
80*4882a593Smuzhiyun  */
81*4882a593Smuzhiyun #define IPU_MAX_CH	32
82*4882a593Smuzhiyun #define _MAKE_CHAN(num, v_in, g_in, a_in, out) \
83*4882a593Smuzhiyun 	((num << 24) | (v_in << 18) | (g_in << 12) | (a_in << 6) | out)
84*4882a593Smuzhiyun #define _MAKE_ALT_CHAN(ch)		(ch | (IPU_MAX_CH << 24))
85*4882a593Smuzhiyun #define IPU_CHAN_ID(ch)			(ch >> 24)
86*4882a593Smuzhiyun #define IPU_CHAN_ALT(ch)		(ch & 0x02000000)
87*4882a593Smuzhiyun #define IPU_CHAN_ALPHA_IN_DMA(ch)	((uint32_t) (ch >> 6) & 0x3F)
88*4882a593Smuzhiyun #define IPU_CHAN_GRAPH_IN_DMA(ch)	((uint32_t) (ch >> 12) & 0x3F)
89*4882a593Smuzhiyun #define IPU_CHAN_VIDEO_IN_DMA(ch)	((uint32_t) (ch >> 18) & 0x3F)
90*4882a593Smuzhiyun #define IPU_CHAN_OUT_DMA(ch)		((uint32_t) (ch & 0x3F))
91*4882a593Smuzhiyun #define NO_DMA 0x3F
92*4882a593Smuzhiyun #define ALT	1
93*4882a593Smuzhiyun 
94*4882a593Smuzhiyun /*
95*4882a593Smuzhiyun  * Enumeration of IPU logical channels. An IPU logical channel is defined as a
96*4882a593Smuzhiyun  * combination of an input (memory to IPU), output (IPU to memory), and/or
97*4882a593Smuzhiyun  * secondary input IDMA channels and in some cases an Image Converter task.
98*4882a593Smuzhiyun  * Some channels consist of only an input or output.
99*4882a593Smuzhiyun  */
100*4882a593Smuzhiyun typedef enum {
101*4882a593Smuzhiyun 	CHAN_NONE = -1,
102*4882a593Smuzhiyun 
103*4882a593Smuzhiyun 	MEM_DC_SYNC = _MAKE_CHAN(7, 28, NO_DMA, NO_DMA, NO_DMA),
104*4882a593Smuzhiyun 	MEM_DC_ASYNC = _MAKE_CHAN(8, 41, NO_DMA, NO_DMA, NO_DMA),
105*4882a593Smuzhiyun 	MEM_BG_SYNC = _MAKE_CHAN(9, 23, NO_DMA, 51, NO_DMA),
106*4882a593Smuzhiyun 	MEM_FG_SYNC = _MAKE_CHAN(10, 27, NO_DMA, 31, NO_DMA),
107*4882a593Smuzhiyun 
108*4882a593Smuzhiyun 	MEM_BG_ASYNC0 = _MAKE_CHAN(11, 24, NO_DMA, 52, NO_DMA),
109*4882a593Smuzhiyun 	MEM_FG_ASYNC0 = _MAKE_CHAN(12, 29, NO_DMA, 33, NO_DMA),
110*4882a593Smuzhiyun 	MEM_BG_ASYNC1 = _MAKE_ALT_CHAN(MEM_BG_ASYNC0),
111*4882a593Smuzhiyun 	MEM_FG_ASYNC1 = _MAKE_ALT_CHAN(MEM_FG_ASYNC0),
112*4882a593Smuzhiyun 
113*4882a593Smuzhiyun 	DIRECT_ASYNC0 = _MAKE_CHAN(13, NO_DMA, NO_DMA, NO_DMA, NO_DMA),
114*4882a593Smuzhiyun 	DIRECT_ASYNC1 = _MAKE_CHAN(14, NO_DMA, NO_DMA, NO_DMA, NO_DMA),
115*4882a593Smuzhiyun 
116*4882a593Smuzhiyun } ipu_channel_t;
117*4882a593Smuzhiyun 
118*4882a593Smuzhiyun /*
119*4882a593Smuzhiyun  * Enumeration of types of buffers for a logical channel.
120*4882a593Smuzhiyun  */
121*4882a593Smuzhiyun typedef enum {
122*4882a593Smuzhiyun 	IPU_OUTPUT_BUFFER = 0,	/*< Buffer for output from IPU */
123*4882a593Smuzhiyun 	IPU_ALPHA_IN_BUFFER = 1,	/*< Buffer for input to IPU */
124*4882a593Smuzhiyun 	IPU_GRAPH_IN_BUFFER = 2,	/*< Buffer for input to IPU */
125*4882a593Smuzhiyun 	IPU_VIDEO_IN_BUFFER = 3,	/*< Buffer for input to IPU */
126*4882a593Smuzhiyun 	IPU_INPUT_BUFFER = IPU_VIDEO_IN_BUFFER,
127*4882a593Smuzhiyun 	IPU_SEC_INPUT_BUFFER = IPU_GRAPH_IN_BUFFER,
128*4882a593Smuzhiyun } ipu_buffer_t;
129*4882a593Smuzhiyun 
130*4882a593Smuzhiyun #define IPU_PANEL_SERIAL		1
131*4882a593Smuzhiyun #define IPU_PANEL_PARALLEL		2
132*4882a593Smuzhiyun 
133*4882a593Smuzhiyun struct ipu_channel {
134*4882a593Smuzhiyun 	u8 video_in_dma;
135*4882a593Smuzhiyun 	u8 alpha_in_dma;
136*4882a593Smuzhiyun 	u8 graph_in_dma;
137*4882a593Smuzhiyun 	u8 out_dma;
138*4882a593Smuzhiyun };
139*4882a593Smuzhiyun 
140*4882a593Smuzhiyun enum ipu_dmfc_type {
141*4882a593Smuzhiyun 	DMFC_NORMAL = 0,
142*4882a593Smuzhiyun 	DMFC_HIGH_RESOLUTION_DC,
143*4882a593Smuzhiyun 	DMFC_HIGH_RESOLUTION_DP,
144*4882a593Smuzhiyun 	DMFC_HIGH_RESOLUTION_ONLY_DP,
145*4882a593Smuzhiyun };
146*4882a593Smuzhiyun 
147*4882a593Smuzhiyun 
148*4882a593Smuzhiyun /*
149*4882a593Smuzhiyun  * Union of initialization parameters for a logical channel.
150*4882a593Smuzhiyun  */
151*4882a593Smuzhiyun typedef union {
152*4882a593Smuzhiyun 	struct {
153*4882a593Smuzhiyun 		uint32_t di;
154*4882a593Smuzhiyun 		unsigned char interlaced;
155*4882a593Smuzhiyun 	} mem_dc_sync;
156*4882a593Smuzhiyun 	struct {
157*4882a593Smuzhiyun 		uint32_t temp;
158*4882a593Smuzhiyun 	} mem_sdc_fg;
159*4882a593Smuzhiyun 	struct {
160*4882a593Smuzhiyun 		uint32_t di;
161*4882a593Smuzhiyun 		unsigned char interlaced;
162*4882a593Smuzhiyun 		uint32_t in_pixel_fmt;
163*4882a593Smuzhiyun 		uint32_t out_pixel_fmt;
164*4882a593Smuzhiyun 		unsigned char alpha_chan_en;
165*4882a593Smuzhiyun 	} mem_dp_bg_sync;
166*4882a593Smuzhiyun 	struct {
167*4882a593Smuzhiyun 		uint32_t temp;
168*4882a593Smuzhiyun 	} mem_sdc_bg;
169*4882a593Smuzhiyun 	struct {
170*4882a593Smuzhiyun 		uint32_t di;
171*4882a593Smuzhiyun 		unsigned char interlaced;
172*4882a593Smuzhiyun 		uint32_t in_pixel_fmt;
173*4882a593Smuzhiyun 		uint32_t out_pixel_fmt;
174*4882a593Smuzhiyun 		unsigned char alpha_chan_en;
175*4882a593Smuzhiyun 	} mem_dp_fg_sync;
176*4882a593Smuzhiyun } ipu_channel_params_t;
177*4882a593Smuzhiyun 
178*4882a593Smuzhiyun /*
179*4882a593Smuzhiyun  * Enumeration of IPU interrupts.
180*4882a593Smuzhiyun  */
181*4882a593Smuzhiyun enum ipu_irq_line {
182*4882a593Smuzhiyun 	IPU_IRQ_DP_SF_END = 448 + 3,
183*4882a593Smuzhiyun 	IPU_IRQ_DC_FC_1 = 448 + 9,
184*4882a593Smuzhiyun };
185*4882a593Smuzhiyun 
186*4882a593Smuzhiyun /*
187*4882a593Smuzhiyun  * Bitfield of Display Interface signal polarities.
188*4882a593Smuzhiyun  */
189*4882a593Smuzhiyun typedef struct {
190*4882a593Smuzhiyun 	unsigned datamask_en:1;
191*4882a593Smuzhiyun 	unsigned ext_clk:1;
192*4882a593Smuzhiyun 	unsigned interlaced:1;
193*4882a593Smuzhiyun 	unsigned odd_field_first:1;
194*4882a593Smuzhiyun 	unsigned clksel_en:1;
195*4882a593Smuzhiyun 	unsigned clkidle_en:1;
196*4882a593Smuzhiyun 	unsigned data_pol:1;	/* true = inverted */
197*4882a593Smuzhiyun 	unsigned clk_pol:1;	/* true = rising edge */
198*4882a593Smuzhiyun 	unsigned enable_pol:1;
199*4882a593Smuzhiyun 	unsigned Hsync_pol:1;	/* true = active high */
200*4882a593Smuzhiyun 	unsigned Vsync_pol:1;
201*4882a593Smuzhiyun } ipu_di_signal_cfg_t;
202*4882a593Smuzhiyun 
203*4882a593Smuzhiyun typedef enum {
204*4882a593Smuzhiyun 	RGB,
205*4882a593Smuzhiyun 	YCbCr,
206*4882a593Smuzhiyun 	YUV
207*4882a593Smuzhiyun } ipu_color_space_t;
208*4882a593Smuzhiyun 
209*4882a593Smuzhiyun /* Common IPU API */
210*4882a593Smuzhiyun int32_t ipu_init_channel(ipu_channel_t channel, ipu_channel_params_t *params);
211*4882a593Smuzhiyun void ipu_uninit_channel(ipu_channel_t channel);
212*4882a593Smuzhiyun 
213*4882a593Smuzhiyun int32_t ipu_init_channel_buffer(ipu_channel_t channel, ipu_buffer_t type,
214*4882a593Smuzhiyun 				uint32_t pixel_fmt,
215*4882a593Smuzhiyun 				uint16_t width, uint16_t height,
216*4882a593Smuzhiyun 				uint32_t stride,
217*4882a593Smuzhiyun 				dma_addr_t phyaddr_0, dma_addr_t phyaddr_1,
218*4882a593Smuzhiyun 				uint32_t u_offset, uint32_t v_offset);
219*4882a593Smuzhiyun 
220*4882a593Smuzhiyun int32_t ipu_update_channel_buffer(ipu_channel_t channel, ipu_buffer_t type,
221*4882a593Smuzhiyun 				  uint32_t bufNum, dma_addr_t phyaddr);
222*4882a593Smuzhiyun 
223*4882a593Smuzhiyun int32_t ipu_is_channel_busy(ipu_channel_t channel);
224*4882a593Smuzhiyun void ipu_clear_buffer_ready(ipu_channel_t channel, ipu_buffer_t type,
225*4882a593Smuzhiyun 		uint32_t bufNum);
226*4882a593Smuzhiyun int32_t ipu_enable_channel(ipu_channel_t channel);
227*4882a593Smuzhiyun int32_t ipu_disable_channel(ipu_channel_t channel);
228*4882a593Smuzhiyun 
229*4882a593Smuzhiyun int32_t ipu_init_sync_panel(int disp,
230*4882a593Smuzhiyun 			    uint32_t pixel_clk,
231*4882a593Smuzhiyun 			    uint16_t width, uint16_t height,
232*4882a593Smuzhiyun 			    uint32_t pixel_fmt,
233*4882a593Smuzhiyun 			    uint16_t h_start_width, uint16_t h_sync_width,
234*4882a593Smuzhiyun 			    uint16_t h_end_width, uint16_t v_start_width,
235*4882a593Smuzhiyun 			    uint16_t v_sync_width, uint16_t v_end_width,
236*4882a593Smuzhiyun 			    uint32_t v_to_h_sync, ipu_di_signal_cfg_t sig);
237*4882a593Smuzhiyun 
238*4882a593Smuzhiyun int32_t ipu_disp_set_global_alpha(ipu_channel_t channel, unsigned char enable,
239*4882a593Smuzhiyun 				  uint8_t alpha);
240*4882a593Smuzhiyun int32_t ipu_disp_set_color_key(ipu_channel_t channel, unsigned char enable,
241*4882a593Smuzhiyun 			       uint32_t colorKey);
242*4882a593Smuzhiyun 
243*4882a593Smuzhiyun uint32_t bytes_per_pixel(uint32_t fmt);
244*4882a593Smuzhiyun 
245*4882a593Smuzhiyun void clk_enable(struct clk *clk);
246*4882a593Smuzhiyun void clk_disable(struct clk *clk);
247*4882a593Smuzhiyun u32 clk_get_rate(struct clk *clk);
248*4882a593Smuzhiyun int clk_set_rate(struct clk *clk, unsigned long rate);
249*4882a593Smuzhiyun long clk_round_rate(struct clk *clk, unsigned long rate);
250*4882a593Smuzhiyun int clk_set_parent(struct clk *clk, struct clk *parent);
251*4882a593Smuzhiyun int clk_get_usecount(struct clk *clk);
252*4882a593Smuzhiyun struct clk *clk_get_parent(struct clk *clk);
253*4882a593Smuzhiyun 
254*4882a593Smuzhiyun void ipu_dump_registers(void);
255*4882a593Smuzhiyun int ipu_probe(void);
256*4882a593Smuzhiyun bool ipu_clk_enabled(void);
257*4882a593Smuzhiyun 
258*4882a593Smuzhiyun void ipu_dmfc_init(int dmfc_type, int first);
259*4882a593Smuzhiyun void ipu_init_dc_mappings(void);
260*4882a593Smuzhiyun void ipu_dmfc_set_wait4eot(int dma_chan, int width);
261*4882a593Smuzhiyun void ipu_dc_init(int dc_chan, int di, unsigned char interlaced);
262*4882a593Smuzhiyun void ipu_dc_uninit(int dc_chan);
263*4882a593Smuzhiyun void ipu_dp_dc_enable(ipu_channel_t channel);
264*4882a593Smuzhiyun int ipu_dp_init(ipu_channel_t channel, uint32_t in_pixel_fmt,
265*4882a593Smuzhiyun 		 uint32_t out_pixel_fmt);
266*4882a593Smuzhiyun void ipu_dp_uninit(ipu_channel_t channel);
267*4882a593Smuzhiyun void ipu_dp_dc_disable(ipu_channel_t channel, unsigned char swap);
268*4882a593Smuzhiyun ipu_color_space_t format_to_colorspace(uint32_t fmt);
269*4882a593Smuzhiyun #endif
270