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
  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 Channel Parameter Memory (cpmem) functions
 112  */
 113 struct ipu_rgb {
 114         struct fb_bitfield      red;
 115         struct fb_bitfield      green;
 116         struct fb_bitfield      blue;
 117         struct fb_bitfield      transp;
 118         int                     bits_per_pixel;
 119 };
 120
 121 struct ipu_image {
 122         struct v4l2_pix_format pix;
 123         struct v4l2_rect rect;
 124         dma_addr_t phys;
 125 };
 126
 127 void ipu_cpmem_zero(struct ipuv3_channel *ch);
 128 void ipu_cpmem_set_resolution(struct ipuv3_channel *ch, int xres, int yres);
 129 void ipu_cpmem_set_stride(struct ipuv3_channel *ch, int stride);
 130 void ipu_cpmem_set_high_priority(struct ipuv3_channel *ch);
 131 void ipu_cpmem_set_buffer(struct ipuv3_channel *ch, int bufnum, dma_addr_t buf);
 132 void ipu_cpmem_interlaced_scan(struct ipuv3_channel *ch, int stride);
 133 void ipu_cpmem_set_burstsize(struct ipuv3_channel *ch, int burstsize);
 134 int ipu_cpmem_set_format_rgb(struct ipuv3_channel *ch,
 135                              const struct ipu_rgb *rgb);
 136 int ipu_cpmem_set_format_passthrough(struct ipuv3_channel *ch, int width);
 137 void ipu_cpmem_set_yuv_interleaved(struct ipuv3_channel *ch, u32 pixel_format);
 138 void ipu_cpmem_set_yuv_planar_full(struct ipuv3_channel *ch,
 139                                    u32 pixel_format, int stride,
 140                                    int u_offset, int v_offset);
 141 void ipu_cpmem_set_yuv_planar(struct ipuv3_channel *ch,
 142                               u32 pixel_format, int stride, int height);
 143 int ipu_cpmem_set_fmt(struct ipuv3_channel *ch, u32 drm_fourcc);
 144 int ipu_cpmem_set_image(struct ipuv3_channel *ch, struct ipu_image *image);
 145
 146 /*
 147  * IPU Display Controller (dc) functions
 148  */
 149 struct ipu_dc;
 150 struct ipu_di;
 151 struct ipu_dc *ipu_dc_get(struct ipu_soc *ipu, int channel);
 152 void ipu_dc_put(struct ipu_dc *dc);
 153 int ipu_dc_init_sync(struct ipu_dc *dc, struct ipu_di *di, bool interlaced,
 154                 u32 pixel_fmt, u32 width);
 155 void ipu_dc_enable(struct ipu_soc *ipu);
 156 void ipu_dc_enable_channel(struct ipu_dc *dc);
 157 void ipu_dc_disable_channel(struct ipu_dc *dc);
 158 void ipu_dc_disable(struct ipu_soc *ipu);
 159
 160 /*
 161  * IPU Display Interface (di) functions
 162  */
 163 struct ipu_di *ipu_di_get(struct ipu_soc *ipu, int disp);
 164 void ipu_di_put(struct ipu_di *);
 165 int ipu_di_disable(struct ipu_di *);
 166 int ipu_di_enable(struct ipu_di *);
 167 int ipu_di_get_num(struct ipu_di *);
 168 int ipu_di_init_sync_panel(struct ipu_di *, struct ipu_di_signal_cfg *sig);
 169
 170 /*
 171  * IPU Display Multi FIFO Controller (dmfc) functions
 172  */
 173 struct dmfc_channel;
 174 int ipu_dmfc_enable_channel(struct dmfc_channel *dmfc);
 175 void ipu_dmfc_disable_channel(struct dmfc_channel *dmfc);
 176 int ipu_dmfc_alloc_bandwidth(struct dmfc_channel *dmfc,
 177                 unsigned long bandwidth_mbs, int burstsize);
 178 void ipu_dmfc_free_bandwidth(struct dmfc_channel *dmfc);
 179 int ipu_dmfc_init_channel(struct dmfc_channel *dmfc, int width);
 180 struct dmfc_channel *ipu_dmfc_get(struct ipu_soc *ipu, int ipuv3_channel);
 181 void ipu_dmfc_put(struct dmfc_channel *dmfc);
 182
 183 /*
 184  * IPU Display Processor (dp) functions
 185  */
 186 #define IPU_DP_FLOW_SYNC_BG     0
 187 #define IPU_DP_FLOW_SYNC_FG     1
 188 #define IPU_DP_FLOW_ASYNC0_BG   2
 189 #define IPU_DP_FLOW_ASYNC0_FG   3
 190 #define IPU_DP_FLOW_ASYNC1_BG   4
 191 #define IPU_DP_FLOW_ASYNC1_FG   5
 192
 193 struct ipu_dp *ipu_dp_get(struct ipu_soc *ipu, unsigned int flow);
 194 void ipu_dp_put(struct ipu_dp *);
 195 int ipu_dp_enable(struct ipu_soc *ipu);
 196 int ipu_dp_enable_channel(struct ipu_dp *dp);
 197 void ipu_dp_disable_channel(struct ipu_dp *dp);
 198 void ipu_dp_disable(struct ipu_soc *ipu);
 199 int ipu_dp_setup_channel(struct ipu_dp *dp,
 200                 enum ipu_color_space in, enum ipu_color_space out);
 201 int ipu_dp_set_window_pos(struct ipu_dp *, u16 x_pos, u16 y_pos);
 202 int ipu_dp_set_global_alpha(struct ipu_dp *dp, bool enable, u8 alpha,
 203                 bool bg_chan);
 204
 205 /*
 206  * IPU CMOS Sensor Interface (csi) functions
 207  */
 208 int ipu_csi_enable(struct ipu_soc *ipu, int csi);
 209 int ipu_csi_disable(struct ipu_soc *ipu, int csi);
 210
 211 /*
 212  * IPU Sensor Multiple FIFO Controller (SMFC) functions
 213  */
 214 int ipu_smfc_enable(struct ipu_soc *ipu);
 215 int ipu_smfc_disable(struct ipu_soc *ipu);
 216 int ipu_smfc_map_channel(struct ipu_soc *ipu, int channel, int csi_id, int mipi_id);
 217 int ipu_smfc_set_burstsize(struct ipu_soc *ipu, int channel, int burstsize);
 218
 219 enum ipu_color_space ipu_drm_fourcc_to_colorspace(u32 drm_fourcc);
 220 enum ipu_color_space ipu_pixelformat_to_colorspace(u32 pixelformat);
 221
 222 struct ipu_client_platformdata {
 223         int csi;
 224         int di;
 225         int dc;
 226         int dp;
 227         int dmfc;
 228         int dma[2];
 229 };
 230
 231 #endif /* __DRM_IPU_H__ */