linux/include/video/imx-ipu-v3.h
<<
>>
Prefs
   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 <media/v4l2-mediabus.h>
  20#include <video/videomode.h>
  21
  22struct ipu_soc;
  23
  24enum ipuv3_type {
  25        IPUV3EX,
  26        IPUV3M,
  27        IPUV3H,
  28};
  29
  30#define IPU_PIX_FMT_GBR24       v4l2_fourcc('G', 'B', 'R', '3')
  31
  32/*
  33 * Bitfield of Display Interface signal polarities.
  34 */
  35struct ipu_di_signal_cfg {
  36        unsigned data_pol:1;    /* true = inverted */
  37        unsigned clk_pol:1;     /* true = rising edge */
  38        unsigned enable_pol:1;
  39
  40        struct videomode mode;
  41
  42        u32 bus_format;
  43        u32 v_to_h_sync;
  44
  45#define IPU_DI_CLKMODE_SYNC     (1 << 0)
  46#define IPU_DI_CLKMODE_EXT      (1 << 1)
  47        unsigned long clkflags;
  48
  49        u8 hsync_pin;
  50        u8 vsync_pin;
  51};
  52
  53/*
  54 * Enumeration of CSI destinations
  55 */
  56enum ipu_csi_dest {
  57        IPU_CSI_DEST_IDMAC, /* to memory via SMFC */
  58        IPU_CSI_DEST_IC,        /* to Image Converter */
  59        IPU_CSI_DEST_VDIC,  /* to VDIC */
  60};
  61
  62/*
  63 * Enumeration of IPU rotation modes
  64 */
  65enum ipu_rotate_mode {
  66        IPU_ROTATE_NONE = 0,
  67        IPU_ROTATE_VERT_FLIP,
  68        IPU_ROTATE_HORIZ_FLIP,
  69        IPU_ROTATE_180,
  70        IPU_ROTATE_90_RIGHT,
  71        IPU_ROTATE_90_RIGHT_VFLIP,
  72        IPU_ROTATE_90_RIGHT_HFLIP,
  73        IPU_ROTATE_90_LEFT,
  74};
  75
  76enum ipu_color_space {
  77        IPUV3_COLORSPACE_RGB,
  78        IPUV3_COLORSPACE_YUV,
  79        IPUV3_COLORSPACE_UNKNOWN,
  80};
  81
  82struct ipuv3_channel;
  83
  84enum ipu_channel_irq {
  85        IPU_IRQ_EOF = 0,
  86        IPU_IRQ_NFACK = 64,
  87        IPU_IRQ_NFB4EOF = 128,
  88        IPU_IRQ_EOS = 192,
  89};
  90
  91/*
  92 * Enumeration of IDMAC channels
  93 */
  94#define IPUV3_CHANNEL_CSI0                       0
  95#define IPUV3_CHANNEL_CSI1                       1
  96#define IPUV3_CHANNEL_CSI2                       2
  97#define IPUV3_CHANNEL_CSI3                       3
  98#define IPUV3_CHANNEL_VDI_MEM_IC_VF              5
  99#define IPUV3_CHANNEL_MEM_IC_PP                 11
 100#define IPUV3_CHANNEL_MEM_IC_PRP_VF             12
 101#define IPUV3_CHANNEL_G_MEM_IC_PRP_VF           14
 102#define IPUV3_CHANNEL_G_MEM_IC_PP               15
 103#define IPUV3_CHANNEL_IC_PRP_ENC_MEM            20
 104#define IPUV3_CHANNEL_IC_PRP_VF_MEM             21
 105#define IPUV3_CHANNEL_IC_PP_MEM                 22
 106#define IPUV3_CHANNEL_MEM_BG_SYNC               23
 107#define IPUV3_CHANNEL_MEM_BG_ASYNC              24
 108#define IPUV3_CHANNEL_MEM_FG_SYNC               27
 109#define IPUV3_CHANNEL_MEM_DC_SYNC               28
 110#define IPUV3_CHANNEL_MEM_FG_ASYNC              29
 111#define IPUV3_CHANNEL_MEM_FG_SYNC_ALPHA         31
 112#define IPUV3_CHANNEL_MEM_DC_ASYNC              41
 113#define IPUV3_CHANNEL_MEM_ROT_ENC               45
 114#define IPUV3_CHANNEL_MEM_ROT_VF                46
 115#define IPUV3_CHANNEL_MEM_ROT_PP                47
 116#define IPUV3_CHANNEL_ROT_ENC_MEM               48
 117#define IPUV3_CHANNEL_ROT_VF_MEM                49
 118#define IPUV3_CHANNEL_ROT_PP_MEM                50
 119#define IPUV3_CHANNEL_MEM_BG_SYNC_ALPHA         51
 120
 121int ipu_map_irq(struct ipu_soc *ipu, int irq);
 122int ipu_idmac_channel_irq(struct ipu_soc *ipu, struct ipuv3_channel *channel,
 123                enum ipu_channel_irq irq);
 124
 125#define IPU_IRQ_DP_SF_START             (448 + 2)
 126#define IPU_IRQ_DP_SF_END               (448 + 3)
 127#define IPU_IRQ_BG_SF_END               IPU_IRQ_DP_SF_END,
 128#define IPU_IRQ_DC_FC_0                 (448 + 8)
 129#define IPU_IRQ_DC_FC_1                 (448 + 9)
 130#define IPU_IRQ_DC_FC_2                 (448 + 10)
 131#define IPU_IRQ_DC_FC_3                 (448 + 11)
 132#define IPU_IRQ_DC_FC_4                 (448 + 12)
 133#define IPU_IRQ_DC_FC_6                 (448 + 13)
 134#define IPU_IRQ_VSYNC_PRE_0             (448 + 14)
 135#define IPU_IRQ_VSYNC_PRE_1             (448 + 15)
 136
 137/*
 138 * IPU Common functions
 139 */
 140void ipu_set_csi_src_mux(struct ipu_soc *ipu, int csi_id, bool mipi_csi2);
 141void ipu_set_ic_src_mux(struct ipu_soc *ipu, int csi_id, bool vdi);
 142void ipu_dump(struct ipu_soc *ipu);
 143
 144/*
 145 * IPU Image DMA Controller (idmac) functions
 146 */
 147struct ipuv3_channel *ipu_idmac_get(struct ipu_soc *ipu, unsigned channel);
 148void ipu_idmac_put(struct ipuv3_channel *);
 149
 150int ipu_idmac_enable_channel(struct ipuv3_channel *channel);
 151int ipu_idmac_disable_channel(struct ipuv3_channel *channel);
 152void ipu_idmac_enable_watermark(struct ipuv3_channel *channel, bool enable);
 153int ipu_idmac_lock_enable(struct ipuv3_channel *channel, int num_bursts);
 154int ipu_idmac_wait_busy(struct ipuv3_channel *channel, int ms);
 155
 156void ipu_idmac_set_double_buffer(struct ipuv3_channel *channel,
 157                bool doublebuffer);
 158int ipu_idmac_get_current_buffer(struct ipuv3_channel *channel);
 159bool ipu_idmac_buffer_is_ready(struct ipuv3_channel *channel, u32 buf_num);
 160void ipu_idmac_select_buffer(struct ipuv3_channel *channel, u32 buf_num);
 161void ipu_idmac_clear_buffer(struct ipuv3_channel *channel, u32 buf_num);
 162
 163/*
 164 * IPU Channel Parameter Memory (cpmem) functions
 165 */
 166struct ipu_rgb {
 167        struct fb_bitfield      red;
 168        struct fb_bitfield      green;
 169        struct fb_bitfield      blue;
 170        struct fb_bitfield      transp;
 171        int                     bits_per_pixel;
 172};
 173
 174struct ipu_image {
 175        struct v4l2_pix_format pix;
 176        struct v4l2_rect rect;
 177        dma_addr_t phys0;
 178        dma_addr_t phys1;
 179};
 180
 181void ipu_cpmem_zero(struct ipuv3_channel *ch);
 182void ipu_cpmem_set_resolution(struct ipuv3_channel *ch, int xres, int yres);
 183void ipu_cpmem_set_stride(struct ipuv3_channel *ch, int stride);
 184void ipu_cpmem_set_high_priority(struct ipuv3_channel *ch);
 185void ipu_cpmem_set_buffer(struct ipuv3_channel *ch, int bufnum, dma_addr_t buf);
 186void ipu_cpmem_interlaced_scan(struct ipuv3_channel *ch, int stride);
 187void ipu_cpmem_set_axi_id(struct ipuv3_channel *ch, u32 id);
 188void ipu_cpmem_set_burstsize(struct ipuv3_channel *ch, int burstsize);
 189void ipu_cpmem_set_block_mode(struct ipuv3_channel *ch);
 190void ipu_cpmem_set_rotation(struct ipuv3_channel *ch,
 191                            enum ipu_rotate_mode rot);
 192int ipu_cpmem_set_format_rgb(struct ipuv3_channel *ch,
 193                             const struct ipu_rgb *rgb);
 194int ipu_cpmem_set_format_passthrough(struct ipuv3_channel *ch, int width);
 195void ipu_cpmem_set_yuv_interleaved(struct ipuv3_channel *ch, u32 pixel_format);
 196void ipu_cpmem_set_yuv_planar_full(struct ipuv3_channel *ch,
 197                                   unsigned int uv_stride,
 198                                   unsigned int u_offset,
 199                                   unsigned int v_offset);
 200void ipu_cpmem_set_yuv_planar(struct ipuv3_channel *ch,
 201                              u32 pixel_format, int stride, int height);
 202int ipu_cpmem_set_fmt(struct ipuv3_channel *ch, u32 drm_fourcc);
 203int ipu_cpmem_set_image(struct ipuv3_channel *ch, struct ipu_image *image);
 204void ipu_cpmem_dump(struct ipuv3_channel *ch);
 205
 206/*
 207 * IPU Display Controller (dc) functions
 208 */
 209struct ipu_dc;
 210struct ipu_di;
 211struct ipu_dc *ipu_dc_get(struct ipu_soc *ipu, int channel);
 212void ipu_dc_put(struct ipu_dc *dc);
 213int ipu_dc_init_sync(struct ipu_dc *dc, struct ipu_di *di, bool interlaced,
 214                u32 pixel_fmt, u32 width);
 215void ipu_dc_enable(struct ipu_soc *ipu);
 216void ipu_dc_enable_channel(struct ipu_dc *dc);
 217void ipu_dc_disable_channel(struct ipu_dc *dc);
 218void ipu_dc_disable(struct ipu_soc *ipu);
 219
 220/*
 221 * IPU Display Interface (di) functions
 222 */
 223struct ipu_di *ipu_di_get(struct ipu_soc *ipu, int disp);
 224void ipu_di_put(struct ipu_di *);
 225int ipu_di_disable(struct ipu_di *);
 226int ipu_di_enable(struct ipu_di *);
 227int ipu_di_get_num(struct ipu_di *);
 228int ipu_di_adjust_videomode(struct ipu_di *di, struct videomode *mode);
 229int ipu_di_init_sync_panel(struct ipu_di *, struct ipu_di_signal_cfg *sig);
 230
 231/*
 232 * IPU Display Multi FIFO Controller (dmfc) functions
 233 */
 234struct dmfc_channel;
 235int ipu_dmfc_enable_channel(struct dmfc_channel *dmfc);
 236void ipu_dmfc_disable_channel(struct dmfc_channel *dmfc);
 237int ipu_dmfc_alloc_bandwidth(struct dmfc_channel *dmfc,
 238                unsigned long bandwidth_mbs, int burstsize);
 239void ipu_dmfc_free_bandwidth(struct dmfc_channel *dmfc);
 240void ipu_dmfc_config_wait4eot(struct dmfc_channel *dmfc, int width);
 241struct dmfc_channel *ipu_dmfc_get(struct ipu_soc *ipu, int ipuv3_channel);
 242void ipu_dmfc_put(struct dmfc_channel *dmfc);
 243
 244/*
 245 * IPU Display Processor (dp) functions
 246 */
 247#define IPU_DP_FLOW_SYNC_BG     0
 248#define IPU_DP_FLOW_SYNC_FG     1
 249#define IPU_DP_FLOW_ASYNC0_BG   2
 250#define IPU_DP_FLOW_ASYNC0_FG   3
 251#define IPU_DP_FLOW_ASYNC1_BG   4
 252#define IPU_DP_FLOW_ASYNC1_FG   5
 253
 254struct ipu_dp *ipu_dp_get(struct ipu_soc *ipu, unsigned int flow);
 255void ipu_dp_put(struct ipu_dp *);
 256int ipu_dp_enable(struct ipu_soc *ipu);
 257int ipu_dp_enable_channel(struct ipu_dp *dp);
 258void ipu_dp_disable_channel(struct ipu_dp *dp);
 259void ipu_dp_disable(struct ipu_soc *ipu);
 260int ipu_dp_setup_channel(struct ipu_dp *dp,
 261                enum ipu_color_space in, enum ipu_color_space out);
 262int ipu_dp_set_window_pos(struct ipu_dp *, u16 x_pos, u16 y_pos);
 263int ipu_dp_set_global_alpha(struct ipu_dp *dp, bool enable, u8 alpha,
 264                bool bg_chan);
 265
 266/*
 267 * IPU CMOS Sensor Interface (csi) functions
 268 */
 269struct ipu_csi;
 270int ipu_csi_init_interface(struct ipu_csi *csi,
 271                           struct v4l2_mbus_config *mbus_cfg,
 272                           struct v4l2_mbus_framefmt *mbus_fmt);
 273bool ipu_csi_is_interlaced(struct ipu_csi *csi);
 274void ipu_csi_get_window(struct ipu_csi *csi, struct v4l2_rect *w);
 275void ipu_csi_set_window(struct ipu_csi *csi, struct v4l2_rect *w);
 276void ipu_csi_set_test_generator(struct ipu_csi *csi, bool active,
 277                                u32 r_value, u32 g_value, u32 b_value,
 278                                u32 pix_clk);
 279int ipu_csi_set_mipi_datatype(struct ipu_csi *csi, u32 vc,
 280                              struct v4l2_mbus_framefmt *mbus_fmt);
 281int ipu_csi_set_skip_smfc(struct ipu_csi *csi, u32 skip,
 282                          u32 max_ratio, u32 id);
 283int ipu_csi_set_dest(struct ipu_csi *csi, enum ipu_csi_dest csi_dest);
 284int ipu_csi_enable(struct ipu_csi *csi);
 285int ipu_csi_disable(struct ipu_csi *csi);
 286struct ipu_csi *ipu_csi_get(struct ipu_soc *ipu, int id);
 287void ipu_csi_put(struct ipu_csi *csi);
 288void ipu_csi_dump(struct ipu_csi *csi);
 289
 290/*
 291 * IPU Image Converter (ic) functions
 292 */
 293enum ipu_ic_task {
 294        IC_TASK_ENCODER,
 295        IC_TASK_VIEWFINDER,
 296        IC_TASK_POST_PROCESSOR,
 297        IC_NUM_TASKS,
 298};
 299
 300struct ipu_ic;
 301int ipu_ic_task_init(struct ipu_ic *ic,
 302                     int in_width, int in_height,
 303                     int out_width, int out_height,
 304                     enum ipu_color_space in_cs,
 305                     enum ipu_color_space out_cs);
 306int ipu_ic_task_graphics_init(struct ipu_ic *ic,
 307                              enum ipu_color_space in_g_cs,
 308                              bool galpha_en, u32 galpha,
 309                              bool colorkey_en, u32 colorkey);
 310void ipu_ic_task_enable(struct ipu_ic *ic);
 311void ipu_ic_task_disable(struct ipu_ic *ic);
 312int ipu_ic_task_idma_init(struct ipu_ic *ic, struct ipuv3_channel *channel,
 313                          u32 width, u32 height, int burst_size,
 314                          enum ipu_rotate_mode rot);
 315int ipu_ic_enable(struct ipu_ic *ic);
 316int ipu_ic_disable(struct ipu_ic *ic);
 317struct ipu_ic *ipu_ic_get(struct ipu_soc *ipu, enum ipu_ic_task task);
 318void ipu_ic_put(struct ipu_ic *ic);
 319void ipu_ic_dump(struct ipu_ic *ic);
 320
 321/*
 322 * IPU Sensor Multiple FIFO Controller (SMFC) functions
 323 */
 324struct ipu_smfc *ipu_smfc_get(struct ipu_soc *ipu, unsigned int chno);
 325void ipu_smfc_put(struct ipu_smfc *smfc);
 326int ipu_smfc_enable(struct ipu_smfc *smfc);
 327int ipu_smfc_disable(struct ipu_smfc *smfc);
 328int ipu_smfc_map_channel(struct ipu_smfc *smfc, int csi_id, int mipi_id);
 329int ipu_smfc_set_burstsize(struct ipu_smfc *smfc, int burstsize);
 330int ipu_smfc_set_watermark(struct ipu_smfc *smfc, u32 set_level, u32 clr_level);
 331
 332enum ipu_color_space ipu_drm_fourcc_to_colorspace(u32 drm_fourcc);
 333enum ipu_color_space ipu_pixelformat_to_colorspace(u32 pixelformat);
 334enum ipu_color_space ipu_mbus_code_to_colorspace(u32 mbus_code);
 335int ipu_stride_to_bytes(u32 pixel_stride, u32 pixelformat);
 336bool ipu_pixelformat_is_planar(u32 pixelformat);
 337int ipu_degrees_to_rot_mode(enum ipu_rotate_mode *mode, int degrees,
 338                            bool hflip, bool vflip);
 339int ipu_rot_mode_to_degrees(int *degrees, enum ipu_rotate_mode mode,
 340                            bool hflip, bool vflip);
 341
 342struct ipu_client_platformdata {
 343        int csi;
 344        int di;
 345        int dc;
 346        int dp;
 347        int dma[2];
 348};
 349
 350#endif /* __DRM_IPU_H__ */
 351