kernel/drivers/media/platform/am437x/am437x-vpfe.h

   1 /*
   2  * Copyright (C) 2013 - 2014 Texas Instruments, Inc.
   3  *
   4  * Benoit Parrot <bparrot@ti.com>
   5  * Lad, Prabhakar <prabhakar.csengg@gmail.com>
   6  *
   7  * This program is free software; you may redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; version 2 of the License.
  10  *
  11  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  12  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  13  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  14  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
  15  * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
  16  * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  17  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  18  * SOFTWARE.
  19  */
  20
  21 #ifndef AM437X_VPFE_H
  22 #define AM437X_VPFE_H
  23
  24 #include <linux/am437x-vpfe.h>
  25 #include <linux/clk.h>
  26 #include <linux/device.h>
  27 #include <linux/io.h>
  28 #include <linux/i2c.h>
  29 #include <linux/videodev2.h>
  30
  31 #include <media/v4l2-dev.h>
  32 #include <media/v4l2-device.h>
  33 #include <media/v4l2-ioctl.h>
  34 #include <media/videobuf2-dma-contig.h>
  35
  36 #include "am437x-vpfe_regs.h"
  37
  38 enum vpfe_pin_pol {
  39         VPFE_PINPOL_POSITIVE = 0,
  40         VPFE_PINPOL_NEGATIVE,
  41 };
  42
  43 enum vpfe_hw_if_type {
  44         /* Raw Bayer */
  45         VPFE_RAW_BAYER = 0,
  46         /* BT656 - 8 bit */
  47         VPFE_BT656,
  48         /* BT656 - 10 bit */
  49         VPFE_BT656_10BIT,
  50         /* YCbCr - 8 bit with external sync */
  51         VPFE_YCBCR_SYNC_8,
  52         /* YCbCr - 16 bit with external sync */
  53         VPFE_YCBCR_SYNC_16,
  54 };
  55
  56 /* interface description */
  57 struct vpfe_hw_if_param {
  58         enum vpfe_hw_if_type if_type;
  59         enum vpfe_pin_pol hdpol;
  60         enum vpfe_pin_pol vdpol;
  61         unsigned int bus_width;
  62 };
  63
  64 #define VPFE_MAX_SUBDEV         1
  65 #define VPFE_MAX_INPUTS         1
  66
  67 struct vpfe_pixel_format {
  68         struct v4l2_fmtdesc fmtdesc;
  69         /* bytes per pixel */
  70         int bpp;
  71 };
  72
  73 struct vpfe_std_info {
  74         int active_pixels;
  75         int active_lines;
  76         /* current frame format */
  77         int frame_format;
  78 };
  79
  80 struct vpfe_route {
  81         u32 input;
  82         u32 output;
  83 };
  84
  85 struct vpfe_subdev_info {
  86         /* Sub device group id */
  87         int grp_id;
  88         /* inputs available at the sub device */
  89         struct v4l2_input inputs[VPFE_MAX_INPUTS];
  90         /* Sub dev routing information for each input */
  91         struct vpfe_route *routes;
  92         /* check if sub dev supports routing */
  93         int can_route;
  94         /* ccdc bus/interface configuration */
  95         struct vpfe_hw_if_param vpfe_param;
  96         struct v4l2_subdev *sd;
  97 };
  98
  99 struct vpfe_config {
 100         /* information about each subdev */
 101         struct vpfe_subdev_info sub_devs[VPFE_MAX_SUBDEV];
 102         /* Flat array, arranged in groups */
 103         struct v4l2_async_subdev *asd[VPFE_MAX_SUBDEV];
 104 };
 105
 106 struct vpfe_cap_buffer {
 107         struct vb2_buffer vb;
 108         struct list_head list;
 109 };
 110
 111 enum ccdc_pixfmt {
 112         CCDC_PIXFMT_RAW = 0,
 113         CCDC_PIXFMT_YCBCR_16BIT,
 114         CCDC_PIXFMT_YCBCR_8BIT,
 115 };
 116
 117 enum ccdc_frmfmt {
 118         CCDC_FRMFMT_PROGRESSIVE = 0,
 119         CCDC_FRMFMT_INTERLACED,
 120 };
 121
 122 /* PIXEL ORDER IN MEMORY from LSB to MSB */
 123 /* only applicable for 8-bit input mode  */
 124 enum ccdc_pixorder {
 125         CCDC_PIXORDER_YCBYCR,
 126         CCDC_PIXORDER_CBYCRY,
 127 };
 128
 129 enum ccdc_buftype {
 130         CCDC_BUFTYPE_FLD_INTERLEAVED,
 131         CCDC_BUFTYPE_FLD_SEPARATED
 132 };
 133
 134
 135 /* returns the highest bit used for the gamma */
 136 static inline u8 ccdc_gamma_width_max_bit(enum vpfe_ccdc_gamma_width width)
 137 {
 138         return 15 - width;
 139 }
 140
 141 /* returns the highest bit used for this data size */
 142 static inline u8 ccdc_data_size_max_bit(enum vpfe_ccdc_data_size sz)
 143 {
 144         return sz == VPFE_CCDC_DATA_8BITS ? 7 : 15 - sz;
 145 }
 146
 147 /* Structure for CCDC configuration parameters for raw capture mode */
 148 struct ccdc_params_raw {
 149         /* pixel format */
 150         enum ccdc_pixfmt pix_fmt;
 151         /* progressive or interlaced frame */
 152         enum ccdc_frmfmt frm_fmt;
 153         struct v4l2_rect win;
 154         /* Current Format Bytes Per Pixels */
 155         unsigned int bytesperpixel;
 156         /* Current Format Bytes per Lines
 157          * (Aligned to 32 bytes) used for HORZ_INFO
 158          */
 159         unsigned int bytesperline;
 160         /* field id polarity */
 161         enum vpfe_pin_pol fid_pol;
 162         /* vertical sync polarity */
 163         enum vpfe_pin_pol vd_pol;
 164         /* horizontal sync polarity */
 165         enum vpfe_pin_pol hd_pol;
 166         /* interleaved or separated fields */
 167         enum ccdc_buftype buf_type;
 168         /*
 169          * enable to store the image in inverse
 170          * order in memory(bottom to top)
 171          */
 172         unsigned char image_invert_enable;
 173         /* configurable parameters */
 174         struct vpfe_ccdc_config_params_raw config_params;
 175 };
 176
 177 struct ccdc_params_ycbcr {
 178         /* pixel format */
 179         enum ccdc_pixfmt pix_fmt;
 180         /* progressive or interlaced frame */
 181         enum ccdc_frmfmt frm_fmt;
 182         struct v4l2_rect win;
 183         /* Current Format Bytes Per Pixels */
 184         unsigned int bytesperpixel;
 185         /* Current Format Bytes per Lines
 186          * (Aligned to 32 bytes) used for HORZ_INFO
 187          */
 188         unsigned int bytesperline;
 189         /* field id polarity */
 190         enum vpfe_pin_pol fid_pol;
 191         /* vertical sync polarity */
 192         enum vpfe_pin_pol vd_pol;
 193         /* horizontal sync polarity */
 194         enum vpfe_pin_pol hd_pol;
 195         /* enable BT.656 embedded sync mode */
 196         int bt656_enable;
 197         /* cb:y:cr:y or y:cb:y:cr in memory */
 198         enum ccdc_pixorder pix_order;
 199         /* interleaved or separated fields  */
 200         enum ccdc_buftype buf_type;
 201 };
 202
 203 /*
 204  * CCDC operational configuration
 205  */
 206 struct ccdc_config {
 207         /* CCDC interface type */
 208         enum vpfe_hw_if_type if_type;
 209         /* Raw Bayer configuration */
 210         struct ccdc_params_raw bayer;
 211         /* YCbCr configuration */
 212         struct ccdc_params_ycbcr ycbcr;
 213         /* ccdc base address */
 214         void __iomem *base_addr;
 215 };
 216
 217 struct vpfe_ccdc {
 218         struct ccdc_config ccdc_cfg;
 219         u32 ccdc_ctx[VPFE_REG_END / sizeof(u32)];
 220 };
 221
 222 struct vpfe_device {
 223         /* V4l2 specific parameters */
 224         /* Identifies video device for this channel */
 225         struct video_device video_dev;
 226         /* sub devices */
 227         struct v4l2_subdev **sd;
 228         /* vpfe cfg */
 229         struct vpfe_config *cfg;
 230         /* V4l2 device */
 231         struct v4l2_device v4l2_dev;
 232         /* parent device */
 233         struct device *pdev;
 234         /* subdevice async Notifier */
 235         struct v4l2_async_notifier notifier;
 236         /* Indicates id of the field which is being displayed */
 237         unsigned field;
 238         unsigned sequence;
 239         /* current interface type */
 240         struct vpfe_hw_if_param vpfe_if_params;
 241         /* ptr to currently selected sub device */
 242         struct vpfe_subdev_info *current_subdev;
 243         /* current input at the sub device */
 244         int current_input;
 245         /* Keeps track of the information about the standard */
 246         struct vpfe_std_info std_info;
 247         /* std index into std table */
 248         int std_index;
 249         /* IRQs used when CCDC output to SDRAM */
 250         unsigned int irq;
 251         /* Pointer pointing to current v4l2_buffer */
 252         struct vpfe_cap_buffer *cur_frm;
 253         /* Pointer pointing to next v4l2_buffer */
 254         struct vpfe_cap_buffer *next_frm;
 255         /* Used to store pixel format */
 256         struct v4l2_format fmt;
 257         /* Used to store current bytes per pixel based on current format */
 258         unsigned int bpp;
 259         /*
 260          * used when IMP is chained to store the crop window which
 261          * is different from the image window
 262          */
 263         struct v4l2_rect crop;
 264         /* Buffer queue used in video-buf */
 265         struct vb2_queue buffer_queue;
 266         /* Allocator-specific contexts for each plane */
 267         struct vb2_alloc_ctx *alloc_ctx;
 268         /* Queue of filled frames */
 269         struct list_head dma_queue;
 270         /* IRQ lock for DMA queue */
 271         spinlock_t dma_queue_lock;
 272         /* lock used to access this structure */
 273         struct mutex lock;
 274         /*
 275          * offset where second field starts from the starting of the
 276          * buffer for field separated YCbCr formats
 277          */
 278         u32 field_off;
 279         struct vpfe_ccdc ccdc;
 280 };
 281
 282 #endif  /* AM437X_VPFE_H */