xref: /openbmc/linux/include/video/imx-ipu-v3.h (revision 588b48ca)
1 /*
2  * Copyright 2005-2009 Freescale Semiconductor, Inc.
3  *
4  * The code contained herein is licensed under the GNU Lesser General
5  * Public License.  You may obtain a copy of the GNU Lesser General
6  * Public License Version 2.1 or later at the following locations:
7  *
8  * http://www.opensource.org/licenses/lgpl-license.html
9  * http://www.gnu.org/copyleft/lgpl.html
10  */
11 
12 #ifndef __DRM_IPU_H__
13 #define __DRM_IPU_H__
14 
15 #include <linux/types.h>
16 #include <linux/videodev2.h>
17 #include <linux/bitmap.h>
18 #include <linux/fb.h>
19 
20 struct ipu_soc;
21 
22 enum ipuv3_type {
23 	IPUV3EX,
24 	IPUV3M,
25 	IPUV3H,
26 };
27 
28 #define IPU_PIX_FMT_GBR24	v4l2_fourcc('G', 'B', 'R', '3')
29 
30 /*
31  * Bitfield of Display Interface signal polarities.
32  */
33 struct ipu_di_signal_cfg {
34 	unsigned datamask_en:1;
35 	unsigned interlaced:1;
36 	unsigned odd_field_first:1;
37 	unsigned clksel_en:1;
38 	unsigned clkidle_en:1;
39 	unsigned data_pol:1;	/* true = inverted */
40 	unsigned clk_pol:1;	/* true = rising edge */
41 	unsigned enable_pol:1;
42 	unsigned Hsync_pol:1;	/* true = active high */
43 	unsigned Vsync_pol:1;
44 
45 	u16 width;
46 	u16 height;
47 	u32 pixel_fmt;
48 	u16 h_start_width;
49 	u16 h_sync_width;
50 	u16 h_end_width;
51 	u16 v_start_width;
52 	u16 v_sync_width;
53 	u16 v_end_width;
54 	u32 v_to_h_sync;
55 	unsigned long pixelclock;
56 #define IPU_DI_CLKMODE_SYNC	(1 << 0)
57 #define IPU_DI_CLKMODE_EXT	(1 << 1)
58 	unsigned long clkflags;
59 
60 	u8 hsync_pin;
61 	u8 vsync_pin;
62 };
63 
64 enum ipu_color_space {
65 	IPUV3_COLORSPACE_RGB,
66 	IPUV3_COLORSPACE_YUV,
67 	IPUV3_COLORSPACE_UNKNOWN,
68 };
69 
70 struct ipuv3_channel;
71 
72 enum ipu_channel_irq {
73 	IPU_IRQ_EOF = 0,
74 	IPU_IRQ_NFACK = 64,
75 	IPU_IRQ_NFB4EOF = 128,
76 	IPU_IRQ_EOS = 192,
77 };
78 
79 int ipu_map_irq(struct ipu_soc *ipu, int irq);
80 int ipu_idmac_channel_irq(struct ipu_soc *ipu, struct ipuv3_channel *channel,
81 		enum ipu_channel_irq irq);
82 
83 #define IPU_IRQ_DP_SF_START		(448 + 2)
84 #define IPU_IRQ_DP_SF_END		(448 + 3)
85 #define IPU_IRQ_BG_SF_END		IPU_IRQ_DP_SF_END,
86 #define IPU_IRQ_DC_FC_0			(448 + 8)
87 #define IPU_IRQ_DC_FC_1			(448 + 9)
88 #define IPU_IRQ_DC_FC_2			(448 + 10)
89 #define IPU_IRQ_DC_FC_3			(448 + 11)
90 #define IPU_IRQ_DC_FC_4			(448 + 12)
91 #define IPU_IRQ_DC_FC_6			(448 + 13)
92 #define IPU_IRQ_VSYNC_PRE_0		(448 + 14)
93 #define IPU_IRQ_VSYNC_PRE_1		(448 + 15)
94 
95 /*
96  * IPU Image DMA Controller (idmac) functions
97  */
98 struct ipuv3_channel *ipu_idmac_get(struct ipu_soc *ipu, unsigned channel);
99 void ipu_idmac_put(struct ipuv3_channel *);
100 
101 int ipu_idmac_enable_channel(struct ipuv3_channel *channel);
102 int ipu_idmac_disable_channel(struct ipuv3_channel *channel);
103 int ipu_idmac_wait_busy(struct ipuv3_channel *channel, int ms);
104 
105 void ipu_idmac_set_double_buffer(struct ipuv3_channel *channel,
106 		bool doublebuffer);
107 int ipu_idmac_get_current_buffer(struct ipuv3_channel *channel);
108 void ipu_idmac_select_buffer(struct ipuv3_channel *channel, u32 buf_num);
109 
110 /*
111  * IPU Display Controller (dc) functions
112  */
113 struct ipu_dc;
114 struct ipu_di;
115 struct ipu_dc *ipu_dc_get(struct ipu_soc *ipu, int channel);
116 void ipu_dc_put(struct ipu_dc *dc);
117 int ipu_dc_init_sync(struct ipu_dc *dc, struct ipu_di *di, bool interlaced,
118 		u32 pixel_fmt, u32 width);
119 void ipu_dc_enable(struct ipu_soc *ipu);
120 void ipu_dc_enable_channel(struct ipu_dc *dc);
121 void ipu_dc_disable_channel(struct ipu_dc *dc);
122 void ipu_dc_disable(struct ipu_soc *ipu);
123 
124 /*
125  * IPU Display Interface (di) functions
126  */
127 struct ipu_di *ipu_di_get(struct ipu_soc *ipu, int disp);
128 void ipu_di_put(struct ipu_di *);
129 int ipu_di_disable(struct ipu_di *);
130 int ipu_di_enable(struct ipu_di *);
131 int ipu_di_get_num(struct ipu_di *);
132 int ipu_di_init_sync_panel(struct ipu_di *, struct ipu_di_signal_cfg *sig);
133 
134 /*
135  * IPU Display Multi FIFO Controller (dmfc) functions
136  */
137 struct dmfc_channel;
138 int ipu_dmfc_enable_channel(struct dmfc_channel *dmfc);
139 void ipu_dmfc_disable_channel(struct dmfc_channel *dmfc);
140 int ipu_dmfc_alloc_bandwidth(struct dmfc_channel *dmfc,
141 		unsigned long bandwidth_mbs, int burstsize);
142 void ipu_dmfc_free_bandwidth(struct dmfc_channel *dmfc);
143 int ipu_dmfc_init_channel(struct dmfc_channel *dmfc, int width);
144 struct dmfc_channel *ipu_dmfc_get(struct ipu_soc *ipu, int ipuv3_channel);
145 void ipu_dmfc_put(struct dmfc_channel *dmfc);
146 
147 /*
148  * IPU Display Processor (dp) functions
149  */
150 #define IPU_DP_FLOW_SYNC_BG	0
151 #define IPU_DP_FLOW_SYNC_FG	1
152 #define IPU_DP_FLOW_ASYNC0_BG	2
153 #define IPU_DP_FLOW_ASYNC0_FG	3
154 #define IPU_DP_FLOW_ASYNC1_BG	4
155 #define IPU_DP_FLOW_ASYNC1_FG	5
156 
157 struct ipu_dp *ipu_dp_get(struct ipu_soc *ipu, unsigned int flow);
158 void ipu_dp_put(struct ipu_dp *);
159 int ipu_dp_enable(struct ipu_soc *ipu);
160 int ipu_dp_enable_channel(struct ipu_dp *dp);
161 void ipu_dp_disable_channel(struct ipu_dp *dp);
162 void ipu_dp_disable(struct ipu_soc *ipu);
163 int ipu_dp_setup_channel(struct ipu_dp *dp,
164 		enum ipu_color_space in, enum ipu_color_space out);
165 int ipu_dp_set_window_pos(struct ipu_dp *, u16 x_pos, u16 y_pos);
166 int ipu_dp_set_global_alpha(struct ipu_dp *dp, bool enable, u8 alpha,
167 		bool bg_chan);
168 
169 /*
170  * IPU CMOS Sensor Interface (csi) functions
171  */
172 int ipu_csi_enable(struct ipu_soc *ipu, int csi);
173 int ipu_csi_disable(struct ipu_soc *ipu, int csi);
174 
175 /*
176  * IPU Sensor Multiple FIFO Controller (SMFC) functions
177  */
178 int ipu_smfc_enable(struct ipu_soc *ipu);
179 int ipu_smfc_disable(struct ipu_soc *ipu);
180 int ipu_smfc_map_channel(struct ipu_soc *ipu, int channel, int csi_id, int mipi_id);
181 int ipu_smfc_set_burstsize(struct ipu_soc *ipu, int channel, int burstsize);
182 
183 #define IPU_CPMEM_WORD(word, ofs, size) ((((word) * 160 + (ofs)) << 8) | (size))
184 
185 #define IPU_FIELD_UBO		IPU_CPMEM_WORD(0, 46, 22)
186 #define IPU_FIELD_VBO		IPU_CPMEM_WORD(0, 68, 22)
187 #define IPU_FIELD_IOX		IPU_CPMEM_WORD(0, 90, 4)
188 #define IPU_FIELD_RDRW		IPU_CPMEM_WORD(0, 94, 1)
189 #define IPU_FIELD_SO		IPU_CPMEM_WORD(0, 113, 1)
190 #define IPU_FIELD_SLY		IPU_CPMEM_WORD(1, 102, 14)
191 #define IPU_FIELD_SLUV		IPU_CPMEM_WORD(1, 128, 14)
192 
193 #define IPU_FIELD_XV		IPU_CPMEM_WORD(0, 0, 10)
194 #define IPU_FIELD_YV		IPU_CPMEM_WORD(0, 10, 9)
195 #define IPU_FIELD_XB		IPU_CPMEM_WORD(0, 19, 13)
196 #define IPU_FIELD_YB		IPU_CPMEM_WORD(0, 32, 12)
197 #define IPU_FIELD_NSB_B		IPU_CPMEM_WORD(0, 44, 1)
198 #define IPU_FIELD_CF		IPU_CPMEM_WORD(0, 45, 1)
199 #define IPU_FIELD_SX		IPU_CPMEM_WORD(0, 46, 12)
200 #define IPU_FIELD_SY		IPU_CPMEM_WORD(0, 58, 11)
201 #define IPU_FIELD_NS		IPU_CPMEM_WORD(0, 69, 10)
202 #define IPU_FIELD_SDX		IPU_CPMEM_WORD(0, 79, 7)
203 #define IPU_FIELD_SM		IPU_CPMEM_WORD(0, 86, 10)
204 #define IPU_FIELD_SCC		IPU_CPMEM_WORD(0, 96, 1)
205 #define IPU_FIELD_SCE		IPU_CPMEM_WORD(0, 97, 1)
206 #define IPU_FIELD_SDY		IPU_CPMEM_WORD(0, 98, 7)
207 #define IPU_FIELD_SDRX		IPU_CPMEM_WORD(0, 105, 1)
208 #define IPU_FIELD_SDRY		IPU_CPMEM_WORD(0, 106, 1)
209 #define IPU_FIELD_BPP		IPU_CPMEM_WORD(0, 107, 3)
210 #define IPU_FIELD_DEC_SEL	IPU_CPMEM_WORD(0, 110, 2)
211 #define IPU_FIELD_DIM		IPU_CPMEM_WORD(0, 112, 1)
212 #define IPU_FIELD_BNDM		IPU_CPMEM_WORD(0, 114, 3)
213 #define IPU_FIELD_BM		IPU_CPMEM_WORD(0, 117, 2)
214 #define IPU_FIELD_ROT		IPU_CPMEM_WORD(0, 119, 1)
215 #define IPU_FIELD_HF		IPU_CPMEM_WORD(0, 120, 1)
216 #define IPU_FIELD_VF		IPU_CPMEM_WORD(0, 121, 1)
217 #define IPU_FIELD_THE		IPU_CPMEM_WORD(0, 122, 1)
218 #define IPU_FIELD_CAP		IPU_CPMEM_WORD(0, 123, 1)
219 #define IPU_FIELD_CAE		IPU_CPMEM_WORD(0, 124, 1)
220 #define IPU_FIELD_FW		IPU_CPMEM_WORD(0, 125, 13)
221 #define IPU_FIELD_FH		IPU_CPMEM_WORD(0, 138, 12)
222 #define IPU_FIELD_EBA0		IPU_CPMEM_WORD(1, 0, 29)
223 #define IPU_FIELD_EBA1		IPU_CPMEM_WORD(1, 29, 29)
224 #define IPU_FIELD_ILO		IPU_CPMEM_WORD(1, 58, 20)
225 #define IPU_FIELD_NPB		IPU_CPMEM_WORD(1, 78, 7)
226 #define IPU_FIELD_PFS		IPU_CPMEM_WORD(1, 85, 4)
227 #define IPU_FIELD_ALU		IPU_CPMEM_WORD(1, 89, 1)
228 #define IPU_FIELD_ALBM		IPU_CPMEM_WORD(1, 90, 3)
229 #define IPU_FIELD_ID		IPU_CPMEM_WORD(1, 93, 2)
230 #define IPU_FIELD_TH		IPU_CPMEM_WORD(1, 95, 7)
231 #define IPU_FIELD_SL		IPU_CPMEM_WORD(1, 102, 14)
232 #define IPU_FIELD_WID0		IPU_CPMEM_WORD(1, 116, 3)
233 #define IPU_FIELD_WID1		IPU_CPMEM_WORD(1, 119, 3)
234 #define IPU_FIELD_WID2		IPU_CPMEM_WORD(1, 122, 3)
235 #define IPU_FIELD_WID3		IPU_CPMEM_WORD(1, 125, 3)
236 #define IPU_FIELD_OFS0		IPU_CPMEM_WORD(1, 128, 5)
237 #define IPU_FIELD_OFS1		IPU_CPMEM_WORD(1, 133, 5)
238 #define IPU_FIELD_OFS2		IPU_CPMEM_WORD(1, 138, 5)
239 #define IPU_FIELD_OFS3		IPU_CPMEM_WORD(1, 143, 5)
240 #define IPU_FIELD_SXYS		IPU_CPMEM_WORD(1, 148, 1)
241 #define IPU_FIELD_CRE		IPU_CPMEM_WORD(1, 149, 1)
242 #define IPU_FIELD_DEC_SEL2	IPU_CPMEM_WORD(1, 150, 1)
243 
244 struct ipu_cpmem_word {
245 	u32 data[5];
246 	u32 res[3];
247 };
248 
249 struct ipu_ch_param {
250 	struct ipu_cpmem_word word[2];
251 };
252 
253 void ipu_ch_param_write_field(struct ipu_ch_param __iomem *base, u32 wbs, u32 v);
254 u32 ipu_ch_param_read_field(struct ipu_ch_param __iomem *base, u32 wbs);
255 struct ipu_ch_param __iomem *ipu_get_cpmem(struct ipuv3_channel *channel);
256 void ipu_ch_param_dump(struct ipu_ch_param __iomem *p);
257 
258 static inline void ipu_ch_param_zero(struct ipu_ch_param __iomem *p)
259 {
260 	int i;
261 	void __iomem *base = p;
262 
263 	for (i = 0; i < sizeof(*p) / sizeof(u32); i++)
264 		writel(0, base + i * sizeof(u32));
265 }
266 
267 static inline void ipu_cpmem_set_buffer(struct ipu_ch_param __iomem *p,
268 		int bufnum, dma_addr_t buf)
269 {
270 	if (bufnum)
271 		ipu_ch_param_write_field(p, IPU_FIELD_EBA1, buf >> 3);
272 	else
273 		ipu_ch_param_write_field(p, IPU_FIELD_EBA0, buf >> 3);
274 }
275 
276 static inline void ipu_cpmem_set_resolution(struct ipu_ch_param __iomem *p,
277 		int xres, int yres)
278 {
279 	ipu_ch_param_write_field(p, IPU_FIELD_FW, xres - 1);
280 	ipu_ch_param_write_field(p, IPU_FIELD_FH, yres - 1);
281 }
282 
283 static inline void ipu_cpmem_set_stride(struct ipu_ch_param __iomem *p,
284 		int stride)
285 {
286 	ipu_ch_param_write_field(p, IPU_FIELD_SLY, stride - 1);
287 }
288 
289 void ipu_cpmem_set_high_priority(struct ipuv3_channel *channel);
290 
291 struct ipu_rgb {
292 	struct fb_bitfield	red;
293 	struct fb_bitfield	green;
294 	struct fb_bitfield	blue;
295 	struct fb_bitfield	transp;
296 	int			bits_per_pixel;
297 };
298 
299 struct ipu_image {
300 	struct v4l2_pix_format pix;
301 	struct v4l2_rect rect;
302 	dma_addr_t phys;
303 };
304 
305 int ipu_cpmem_set_format_passthrough(struct ipu_ch_param __iomem *p,
306 		int width);
307 
308 int ipu_cpmem_set_format_rgb(struct ipu_ch_param __iomem *,
309 		const struct ipu_rgb *rgb);
310 
311 static inline void ipu_cpmem_interlaced_scan(struct ipu_ch_param *p,
312 		int stride)
313 {
314 	ipu_ch_param_write_field(p, IPU_FIELD_SO, 1);
315 	ipu_ch_param_write_field(p, IPU_FIELD_ILO, stride / 8);
316 	ipu_ch_param_write_field(p, IPU_FIELD_SLY, (stride * 2) - 1);
317 };
318 
319 void ipu_cpmem_set_yuv_planar(struct ipu_ch_param __iomem *p, u32 pixel_format,
320 			int stride, int height);
321 void ipu_cpmem_set_yuv_interleaved(struct ipu_ch_param __iomem *p,
322 				   u32 pixel_format);
323 void ipu_cpmem_set_yuv_planar_full(struct ipu_ch_param __iomem *p,
324 		u32 pixel_format, int stride, int u_offset, int v_offset);
325 int ipu_cpmem_set_fmt(struct ipu_ch_param __iomem *cpmem, u32 pixelformat);
326 int ipu_cpmem_set_image(struct ipu_ch_param __iomem *cpmem,
327 		struct ipu_image *image);
328 
329 enum ipu_color_space ipu_drm_fourcc_to_colorspace(u32 drm_fourcc);
330 enum ipu_color_space ipu_pixelformat_to_colorspace(u32 pixelformat);
331 
332 static inline void ipu_cpmem_set_burstsize(struct ipu_ch_param __iomem *p,
333 		int burstsize)
334 {
335 	ipu_ch_param_write_field(p, IPU_FIELD_NPB, burstsize - 1);
336 };
337 
338 struct ipu_client_platformdata {
339 	int csi;
340 	int di;
341 	int dc;
342 	int dp;
343 	int dmfc;
344 	int dma[2];
345 };
346 
347 #endif /* __DRM_IPU_H__ */
348