]> git.kernelconcepts.de Git - karo-tx-linux.git/blob - include/video/imx-ipu-v3.h
Merge tag 'sound-fix-4.12-rc1' of git://git.kernel.org/pub/scm/linux/kernel/git/tiwai...
[karo-tx-linux.git] / include / video / imx-ipu-v3.h
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 #include <linux/of.h>
20 #include <media/v4l2-mediabus.h>
21 #include <video/videomode.h>
22
23 struct ipu_soc;
24
25 enum ipuv3_type {
26         IPUV3EX,
27         IPUV3M,
28         IPUV3H,
29 };
30
31 #define IPU_PIX_FMT_GBR24       v4l2_fourcc('G', 'B', 'R', '3')
32
33 /*
34  * Bitfield of Display Interface signal polarities.
35  */
36 struct ipu_di_signal_cfg {
37         unsigned data_pol:1;    /* true = inverted */
38         unsigned clk_pol:1;     /* true = rising edge */
39         unsigned enable_pol:1;
40
41         struct videomode mode;
42
43         u32 bus_format;
44         u32 v_to_h_sync;
45
46 #define IPU_DI_CLKMODE_SYNC     (1 << 0)
47 #define IPU_DI_CLKMODE_EXT      (1 << 1)
48         unsigned long clkflags;
49
50         u8 hsync_pin;
51         u8 vsync_pin;
52 };
53
54 /*
55  * Enumeration of CSI destinations
56  */
57 enum ipu_csi_dest {
58         IPU_CSI_DEST_IDMAC, /* to memory via SMFC */
59         IPU_CSI_DEST_IC,        /* to Image Converter */
60         IPU_CSI_DEST_VDIC,  /* to VDIC */
61 };
62
63 /*
64  * Enumeration of IPU rotation modes
65  */
66 #define IPU_ROT_BIT_VFLIP (1 << 0)
67 #define IPU_ROT_BIT_HFLIP (1 << 1)
68 #define IPU_ROT_BIT_90    (1 << 2)
69
70 enum ipu_rotate_mode {
71         IPU_ROTATE_NONE = 0,
72         IPU_ROTATE_VERT_FLIP = IPU_ROT_BIT_VFLIP,
73         IPU_ROTATE_HORIZ_FLIP = IPU_ROT_BIT_HFLIP,
74         IPU_ROTATE_180 = (IPU_ROT_BIT_VFLIP | IPU_ROT_BIT_HFLIP),
75         IPU_ROTATE_90_RIGHT = IPU_ROT_BIT_90,
76         IPU_ROTATE_90_RIGHT_VFLIP = (IPU_ROT_BIT_90 | IPU_ROT_BIT_VFLIP),
77         IPU_ROTATE_90_RIGHT_HFLIP = (IPU_ROT_BIT_90 | IPU_ROT_BIT_HFLIP),
78         IPU_ROTATE_90_LEFT = (IPU_ROT_BIT_90 |
79                               IPU_ROT_BIT_VFLIP | IPU_ROT_BIT_HFLIP),
80 };
81
82 /* 90-degree rotations require the IRT unit */
83 #define ipu_rot_mode_is_irt(m) (((m) & IPU_ROT_BIT_90) != 0)
84
85 enum ipu_color_space {
86         IPUV3_COLORSPACE_RGB,
87         IPUV3_COLORSPACE_YUV,
88         IPUV3_COLORSPACE_UNKNOWN,
89 };
90
91 /*
92  * Enumeration of VDI MOTION select
93  */
94 enum ipu_motion_sel {
95         MOTION_NONE = 0,
96         LOW_MOTION,
97         MED_MOTION,
98         HIGH_MOTION,
99 };
100
101 struct ipuv3_channel;
102
103 enum ipu_channel_irq {
104         IPU_IRQ_EOF = 0,
105         IPU_IRQ_NFACK = 64,
106         IPU_IRQ_NFB4EOF = 128,
107         IPU_IRQ_EOS = 192,
108 };
109
110 /*
111  * Enumeration of IDMAC channels
112  */
113 #define IPUV3_CHANNEL_CSI0                       0
114 #define IPUV3_CHANNEL_CSI1                       1
115 #define IPUV3_CHANNEL_CSI2                       2
116 #define IPUV3_CHANNEL_CSI3                       3
117 #define IPUV3_CHANNEL_VDI_MEM_IC_VF              5
118 /*
119  * NOTE: channels 6,7 are unused in the IPU and are not IDMAC channels,
120  * but the direct CSI->VDI linking is handled the same way as IDMAC
121  * channel linking in the FSU via the IPU_FS_PROC_FLOW registers, so
122  * these channel names are used to support the direct CSI->VDI link.
123  */
124 #define IPUV3_CHANNEL_CSI_DIRECT                 6
125 #define IPUV3_CHANNEL_CSI_VDI_PREV               7
126 #define IPUV3_CHANNEL_MEM_VDI_PREV               8
127 #define IPUV3_CHANNEL_MEM_VDI_CUR                9
128 #define IPUV3_CHANNEL_MEM_VDI_NEXT              10
129 #define IPUV3_CHANNEL_MEM_IC_PP                 11
130 #define IPUV3_CHANNEL_MEM_IC_PRP_VF             12
131 #define IPUV3_CHANNEL_VDI_MEM_RECENT            13
132 #define IPUV3_CHANNEL_G_MEM_IC_PRP_VF           14
133 #define IPUV3_CHANNEL_G_MEM_IC_PP               15
134 #define IPUV3_CHANNEL_G_MEM_IC_PRP_VF_ALPHA     17
135 #define IPUV3_CHANNEL_G_MEM_IC_PP_ALPHA         18
136 #define IPUV3_CHANNEL_MEM_VDI_PLANE1_COMB_ALPHA 19
137 #define IPUV3_CHANNEL_IC_PRP_ENC_MEM            20
138 #define IPUV3_CHANNEL_IC_PRP_VF_MEM             21
139 #define IPUV3_CHANNEL_IC_PP_MEM                 22
140 #define IPUV3_CHANNEL_MEM_BG_SYNC               23
141 #define IPUV3_CHANNEL_MEM_BG_ASYNC              24
142 #define IPUV3_CHANNEL_MEM_VDI_PLANE1_COMB       25
143 #define IPUV3_CHANNEL_MEM_VDI_PLANE3_COMB       26
144 #define IPUV3_CHANNEL_MEM_FG_SYNC               27
145 #define IPUV3_CHANNEL_MEM_DC_SYNC               28
146 #define IPUV3_CHANNEL_MEM_FG_ASYNC              29
147 #define IPUV3_CHANNEL_MEM_FG_SYNC_ALPHA         31
148 #define IPUV3_CHANNEL_MEM_FG_ASYNC_ALPHA        33
149 #define IPUV3_CHANNEL_DC_MEM_READ               40
150 #define IPUV3_CHANNEL_MEM_DC_ASYNC              41
151 #define IPUV3_CHANNEL_MEM_DC_COMMAND            42
152 #define IPUV3_CHANNEL_MEM_DC_COMMAND2           43
153 #define IPUV3_CHANNEL_MEM_DC_OUTPUT_MASK        44
154 #define IPUV3_CHANNEL_MEM_ROT_ENC               45
155 #define IPUV3_CHANNEL_MEM_ROT_VF                46
156 #define IPUV3_CHANNEL_MEM_ROT_PP                47
157 #define IPUV3_CHANNEL_ROT_ENC_MEM               48
158 #define IPUV3_CHANNEL_ROT_VF_MEM                49
159 #define IPUV3_CHANNEL_ROT_PP_MEM                50
160 #define IPUV3_CHANNEL_MEM_BG_SYNC_ALPHA         51
161 #define IPUV3_CHANNEL_MEM_BG_ASYNC_ALPHA        52
162 #define IPUV3_NUM_CHANNELS                      64
163
164 static inline int ipu_channel_alpha_channel(int ch_num)
165 {
166         switch (ch_num) {
167         case IPUV3_CHANNEL_G_MEM_IC_PRP_VF:
168                 return IPUV3_CHANNEL_G_MEM_IC_PRP_VF_ALPHA;
169         case IPUV3_CHANNEL_G_MEM_IC_PP:
170                 return IPUV3_CHANNEL_G_MEM_IC_PP_ALPHA;
171         case IPUV3_CHANNEL_MEM_FG_SYNC:
172                 return IPUV3_CHANNEL_MEM_FG_SYNC_ALPHA;
173         case IPUV3_CHANNEL_MEM_FG_ASYNC:
174                 return IPUV3_CHANNEL_MEM_FG_ASYNC_ALPHA;
175         case IPUV3_CHANNEL_MEM_BG_SYNC:
176                 return IPUV3_CHANNEL_MEM_BG_SYNC_ALPHA;
177         case IPUV3_CHANNEL_MEM_BG_ASYNC:
178                 return IPUV3_CHANNEL_MEM_BG_ASYNC_ALPHA;
179         case IPUV3_CHANNEL_MEM_VDI_PLANE1_COMB:
180                 return IPUV3_CHANNEL_MEM_VDI_PLANE1_COMB_ALPHA;
181         default:
182                 return -EINVAL;
183         }
184 }
185
186 int ipu_map_irq(struct ipu_soc *ipu, int irq);
187 int ipu_idmac_channel_irq(struct ipu_soc *ipu, struct ipuv3_channel *channel,
188                 enum ipu_channel_irq irq);
189
190 #define IPU_IRQ_DP_SF_START             (448 + 2)
191 #define IPU_IRQ_DP_SF_END               (448 + 3)
192 #define IPU_IRQ_BG_SF_END               IPU_IRQ_DP_SF_END,
193 #define IPU_IRQ_DC_FC_0                 (448 + 8)
194 #define IPU_IRQ_DC_FC_1                 (448 + 9)
195 #define IPU_IRQ_DC_FC_2                 (448 + 10)
196 #define IPU_IRQ_DC_FC_3                 (448 + 11)
197 #define IPU_IRQ_DC_FC_4                 (448 + 12)
198 #define IPU_IRQ_DC_FC_6                 (448 + 13)
199 #define IPU_IRQ_VSYNC_PRE_0             (448 + 14)
200 #define IPU_IRQ_VSYNC_PRE_1             (448 + 15)
201
202 /*
203  * IPU Common functions
204  */
205 int ipu_get_num(struct ipu_soc *ipu);
206 void ipu_set_csi_src_mux(struct ipu_soc *ipu, int csi_id, bool mipi_csi2);
207 void ipu_set_ic_src_mux(struct ipu_soc *ipu, int csi_id, bool vdi);
208 void ipu_dump(struct ipu_soc *ipu);
209
210 /*
211  * IPU Image DMA Controller (idmac) functions
212  */
213 struct ipuv3_channel *ipu_idmac_get(struct ipu_soc *ipu, unsigned channel);
214 void ipu_idmac_put(struct ipuv3_channel *);
215
216 int ipu_idmac_enable_channel(struct ipuv3_channel *channel);
217 int ipu_idmac_disable_channel(struct ipuv3_channel *channel);
218 void ipu_idmac_enable_watermark(struct ipuv3_channel *channel, bool enable);
219 int ipu_idmac_lock_enable(struct ipuv3_channel *channel, int num_bursts);
220 int ipu_idmac_wait_busy(struct ipuv3_channel *channel, int ms);
221
222 void ipu_idmac_set_double_buffer(struct ipuv3_channel *channel,
223                 bool doublebuffer);
224 int ipu_idmac_get_current_buffer(struct ipuv3_channel *channel);
225 bool ipu_idmac_buffer_is_ready(struct ipuv3_channel *channel, u32 buf_num);
226 void ipu_idmac_select_buffer(struct ipuv3_channel *channel, u32 buf_num);
227 void ipu_idmac_clear_buffer(struct ipuv3_channel *channel, u32 buf_num);
228 int ipu_fsu_link(struct ipu_soc *ipu, int src_ch, int sink_ch);
229 int ipu_fsu_unlink(struct ipu_soc *ipu, int src_ch, int sink_ch);
230 int ipu_idmac_link(struct ipuv3_channel *src, struct ipuv3_channel *sink);
231 int ipu_idmac_unlink(struct ipuv3_channel *src, struct ipuv3_channel *sink);
232
233 /*
234  * IPU Channel Parameter Memory (cpmem) functions
235  */
236 struct ipu_rgb {
237         struct fb_bitfield      red;
238         struct fb_bitfield      green;
239         struct fb_bitfield      blue;
240         struct fb_bitfield      transp;
241         int                     bits_per_pixel;
242 };
243
244 struct ipu_image {
245         struct v4l2_pix_format pix;
246         struct v4l2_rect rect;
247         dma_addr_t phys0;
248         dma_addr_t phys1;
249 };
250
251 void ipu_cpmem_zero(struct ipuv3_channel *ch);
252 void ipu_cpmem_set_resolution(struct ipuv3_channel *ch, int xres, int yres);
253 void ipu_cpmem_set_stride(struct ipuv3_channel *ch, int stride);
254 void ipu_cpmem_set_high_priority(struct ipuv3_channel *ch);
255 void ipu_cpmem_set_buffer(struct ipuv3_channel *ch, int bufnum, dma_addr_t buf);
256 void ipu_cpmem_set_uv_offset(struct ipuv3_channel *ch, u32 u_off, u32 v_off);
257 void ipu_cpmem_interlaced_scan(struct ipuv3_channel *ch, int stride);
258 void ipu_cpmem_set_axi_id(struct ipuv3_channel *ch, u32 id);
259 int ipu_cpmem_get_burstsize(struct ipuv3_channel *ch);
260 void ipu_cpmem_set_burstsize(struct ipuv3_channel *ch, int burstsize);
261 void ipu_cpmem_set_block_mode(struct ipuv3_channel *ch);
262 void ipu_cpmem_set_rotation(struct ipuv3_channel *ch,
263                             enum ipu_rotate_mode rot);
264 int ipu_cpmem_set_format_rgb(struct ipuv3_channel *ch,
265                              const struct ipu_rgb *rgb);
266 int ipu_cpmem_set_format_passthrough(struct ipuv3_channel *ch, int width);
267 void ipu_cpmem_set_yuv_interleaved(struct ipuv3_channel *ch, u32 pixel_format);
268 void ipu_cpmem_set_yuv_planar_full(struct ipuv3_channel *ch,
269                                    unsigned int uv_stride,
270                                    unsigned int u_offset,
271                                    unsigned int v_offset);
272 int ipu_cpmem_set_fmt(struct ipuv3_channel *ch, u32 drm_fourcc);
273 int ipu_cpmem_set_image(struct ipuv3_channel *ch, struct ipu_image *image);
274 void ipu_cpmem_dump(struct ipuv3_channel *ch);
275
276 /*
277  * IPU Display Controller (dc) functions
278  */
279 struct ipu_dc;
280 struct ipu_di;
281 struct ipu_dc *ipu_dc_get(struct ipu_soc *ipu, int channel);
282 void ipu_dc_put(struct ipu_dc *dc);
283 int ipu_dc_init_sync(struct ipu_dc *dc, struct ipu_di *di, bool interlaced,
284                 u32 pixel_fmt, u32 width);
285 void ipu_dc_enable(struct ipu_soc *ipu);
286 void ipu_dc_enable_channel(struct ipu_dc *dc);
287 void ipu_dc_disable_channel(struct ipu_dc *dc);
288 void ipu_dc_disable(struct ipu_soc *ipu);
289
290 /*
291  * IPU Display Interface (di) functions
292  */
293 struct ipu_di *ipu_di_get(struct ipu_soc *ipu, int disp);
294 void ipu_di_put(struct ipu_di *);
295 int ipu_di_disable(struct ipu_di *);
296 int ipu_di_enable(struct ipu_di *);
297 int ipu_di_get_num(struct ipu_di *);
298 int ipu_di_adjust_videomode(struct ipu_di *di, struct videomode *mode);
299 int ipu_di_init_sync_panel(struct ipu_di *, struct ipu_di_signal_cfg *sig);
300
301 /*
302  * IPU Display Multi FIFO Controller (dmfc) functions
303  */
304 struct dmfc_channel;
305 int ipu_dmfc_enable_channel(struct dmfc_channel *dmfc);
306 void ipu_dmfc_disable_channel(struct dmfc_channel *dmfc);
307 void ipu_dmfc_config_wait4eot(struct dmfc_channel *dmfc, int width);
308 struct dmfc_channel *ipu_dmfc_get(struct ipu_soc *ipu, int ipuv3_channel);
309 void ipu_dmfc_put(struct dmfc_channel *dmfc);
310
311 /*
312  * IPU Display Processor (dp) functions
313  */
314 #define IPU_DP_FLOW_SYNC_BG     0
315 #define IPU_DP_FLOW_SYNC_FG     1
316 #define IPU_DP_FLOW_ASYNC0_BG   2
317 #define IPU_DP_FLOW_ASYNC0_FG   3
318 #define IPU_DP_FLOW_ASYNC1_BG   4
319 #define IPU_DP_FLOW_ASYNC1_FG   5
320
321 struct ipu_dp *ipu_dp_get(struct ipu_soc *ipu, unsigned int flow);
322 void ipu_dp_put(struct ipu_dp *);
323 int ipu_dp_enable(struct ipu_soc *ipu);
324 int ipu_dp_enable_channel(struct ipu_dp *dp);
325 void ipu_dp_disable_channel(struct ipu_dp *dp, bool sync);
326 void ipu_dp_disable(struct ipu_soc *ipu);
327 int ipu_dp_setup_channel(struct ipu_dp *dp,
328                 enum ipu_color_space in, enum ipu_color_space out);
329 int ipu_dp_set_window_pos(struct ipu_dp *, u16 x_pos, u16 y_pos);
330 int ipu_dp_set_global_alpha(struct ipu_dp *dp, bool enable, u8 alpha,
331                 bool bg_chan);
332
333 /*
334  * IPU Prefetch Resolve Gasket (prg) functions
335  */
336 int ipu_prg_max_active_channels(void);
337 bool ipu_prg_present(struct ipu_soc *ipu);
338 bool ipu_prg_format_supported(struct ipu_soc *ipu, uint32_t format,
339                               uint64_t modifier);
340 int ipu_prg_enable(struct ipu_soc *ipu);
341 void ipu_prg_disable(struct ipu_soc *ipu);
342 void ipu_prg_channel_disable(struct ipuv3_channel *ipu_chan);
343 int ipu_prg_channel_configure(struct ipuv3_channel *ipu_chan,
344                               unsigned int axi_id,  unsigned int width,
345                               unsigned int height, unsigned int stride,
346                               u32 format, unsigned long *eba);
347
348 /*
349  * IPU CMOS Sensor Interface (csi) functions
350  */
351 struct ipu_csi;
352 int ipu_csi_init_interface(struct ipu_csi *csi,
353                            struct v4l2_mbus_config *mbus_cfg,
354                            struct v4l2_mbus_framefmt *mbus_fmt);
355 bool ipu_csi_is_interlaced(struct ipu_csi *csi);
356 void ipu_csi_get_window(struct ipu_csi *csi, struct v4l2_rect *w);
357 void ipu_csi_set_window(struct ipu_csi *csi, struct v4l2_rect *w);
358 void ipu_csi_set_downsize(struct ipu_csi *csi, bool horiz, bool vert);
359 void ipu_csi_set_test_generator(struct ipu_csi *csi, bool active,
360                                 u32 r_value, u32 g_value, u32 b_value,
361                                 u32 pix_clk);
362 int ipu_csi_set_mipi_datatype(struct ipu_csi *csi, u32 vc,
363                               struct v4l2_mbus_framefmt *mbus_fmt);
364 int ipu_csi_set_skip_smfc(struct ipu_csi *csi, u32 skip,
365                           u32 max_ratio, u32 id);
366 int ipu_csi_set_dest(struct ipu_csi *csi, enum ipu_csi_dest csi_dest);
367 int ipu_csi_enable(struct ipu_csi *csi);
368 int ipu_csi_disable(struct ipu_csi *csi);
369 struct ipu_csi *ipu_csi_get(struct ipu_soc *ipu, int id);
370 void ipu_csi_put(struct ipu_csi *csi);
371 void ipu_csi_dump(struct ipu_csi *csi);
372
373 /*
374  * IPU Image Converter (ic) functions
375  */
376 enum ipu_ic_task {
377         IC_TASK_ENCODER,
378         IC_TASK_VIEWFINDER,
379         IC_TASK_POST_PROCESSOR,
380         IC_NUM_TASKS,
381 };
382
383 struct ipu_ic;
384 int ipu_ic_task_init(struct ipu_ic *ic,
385                      int in_width, int in_height,
386                      int out_width, int out_height,
387                      enum ipu_color_space in_cs,
388                      enum ipu_color_space out_cs);
389 int ipu_ic_task_graphics_init(struct ipu_ic *ic,
390                               enum ipu_color_space in_g_cs,
391                               bool galpha_en, u32 galpha,
392                               bool colorkey_en, u32 colorkey);
393 void ipu_ic_task_enable(struct ipu_ic *ic);
394 void ipu_ic_task_disable(struct ipu_ic *ic);
395 int ipu_ic_task_idma_init(struct ipu_ic *ic, struct ipuv3_channel *channel,
396                           u32 width, u32 height, int burst_size,
397                           enum ipu_rotate_mode rot);
398 int ipu_ic_enable(struct ipu_ic *ic);
399 int ipu_ic_disable(struct ipu_ic *ic);
400 struct ipu_ic *ipu_ic_get(struct ipu_soc *ipu, enum ipu_ic_task task);
401 void ipu_ic_put(struct ipu_ic *ic);
402 void ipu_ic_dump(struct ipu_ic *ic);
403
404 /*
405  * IPU Video De-Interlacer (vdi) functions
406  */
407 struct ipu_vdi;
408 void ipu_vdi_set_field_order(struct ipu_vdi *vdi, v4l2_std_id std, u32 field);
409 void ipu_vdi_set_motion(struct ipu_vdi *vdi, enum ipu_motion_sel motion_sel);
410 void ipu_vdi_setup(struct ipu_vdi *vdi, u32 code, int xres, int yres);
411 void ipu_vdi_unsetup(struct ipu_vdi *vdi);
412 int ipu_vdi_enable(struct ipu_vdi *vdi);
413 int ipu_vdi_disable(struct ipu_vdi *vdi);
414 struct ipu_vdi *ipu_vdi_get(struct ipu_soc *ipu);
415 void ipu_vdi_put(struct ipu_vdi *vdi);
416
417 /*
418  * IPU Sensor Multiple FIFO Controller (SMFC) functions
419  */
420 struct ipu_smfc *ipu_smfc_get(struct ipu_soc *ipu, unsigned int chno);
421 void ipu_smfc_put(struct ipu_smfc *smfc);
422 int ipu_smfc_enable(struct ipu_smfc *smfc);
423 int ipu_smfc_disable(struct ipu_smfc *smfc);
424 int ipu_smfc_map_channel(struct ipu_smfc *smfc, int csi_id, int mipi_id);
425 int ipu_smfc_set_burstsize(struct ipu_smfc *smfc, int burstsize);
426 int ipu_smfc_set_watermark(struct ipu_smfc *smfc, u32 set_level, u32 clr_level);
427
428 enum ipu_color_space ipu_drm_fourcc_to_colorspace(u32 drm_fourcc);
429 enum ipu_color_space ipu_pixelformat_to_colorspace(u32 pixelformat);
430 enum ipu_color_space ipu_mbus_code_to_colorspace(u32 mbus_code);
431 int ipu_stride_to_bytes(u32 pixel_stride, u32 pixelformat);
432 bool ipu_pixelformat_is_planar(u32 pixelformat);
433 int ipu_degrees_to_rot_mode(enum ipu_rotate_mode *mode, int degrees,
434                             bool hflip, bool vflip);
435 int ipu_rot_mode_to_degrees(int *degrees, enum ipu_rotate_mode mode,
436                             bool hflip, bool vflip);
437
438 struct ipu_client_platformdata {
439         int csi;
440         int di;
441         int dc;
442         int dp;
443         int dma[2];
444         struct device_node *of_node;
445 };
446
447 #endif /* __DRM_IPU_H__ */