include/media/davinci/vpbe_display.h

   1 /*
   2  * Copyright (C) 2010 Texas Instruments Incorporated - http://www.ti.com/
   3  *
   4  * This program is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU General Public License as
   6  * published by the Free Software Foundation version 2.
   7  *
   8  * This program is distributed WITHOUT ANY WARRANTY of any
   9  * kind, whether express or implied; without even the implied warranty
  10  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  11  * GNU General Public License for more details.
  12  */
  13 #ifndef VPBE_DISPLAY_H
  14 #define VPBE_DISPLAY_H
  15
  16 /* Header files */
  17 #include <linux/videodev2.h>
  18 #include <media/v4l2-common.h>
  19 #include <media/videobuf-dma-contig.h>
  20 #include <media/davinci/vpbe_types.h>
  21 #include <media/davinci/vpbe_osd.h>
  22 #include <media/davinci/vpbe.h>
  23
  24 #define VPBE_DISPLAY_MAX_DEVICES 2
  25
  26 enum vpbe_display_device_id {
  27         VPBE_DISPLAY_DEVICE_0,
  28         VPBE_DISPLAY_DEVICE_1
  29 };
  30
  31 #define VPBE_DISPLAY_DRV_NAME   "vpbe-display"
  32
  33 #define VPBE_DISPLAY_MAJOR_RELEASE              1
  34 #define VPBE_DISPLAY_MINOR_RELEASE              0
  35 #define VPBE_DISPLAY_BUILD                      1
  36 #define VPBE_DISPLAY_VERSION_CODE ((VPBE_DISPLAY_MAJOR_RELEASE << 16) | \
  37         (VPBE_DISPLAY_MINOR_RELEASE << 8)  | \
  38         VPBE_DISPLAY_BUILD)
  39
  40 #define VPBE_DISPLAY_VALID_FIELD(field)   ((V4L2_FIELD_NONE == field) || \
  41          (V4L2_FIELD_ANY == field) || (V4L2_FIELD_INTERLACED == field))
  42
  43 /* Exp ratio numerator and denominator constants */
  44 #define VPBE_DISPLAY_H_EXP_RATIO_N      9
  45 #define VPBE_DISPLAY_H_EXP_RATIO_D      8
  46 #define VPBE_DISPLAY_V_EXP_RATIO_N      6
  47 #define VPBE_DISPLAY_V_EXP_RATIO_D      5
  48
  49 /* Zoom multiplication factor */
  50 #define VPBE_DISPLAY_ZOOM_4X    4
  51 #define VPBE_DISPLAY_ZOOM_2X    2
  52
  53 /* Structures */
  54 struct display_layer_info {
  55         int enable;
  56         /* Layer ID used by Display Manager */
  57         enum osd_layer id;
  58         struct osd_layer_config config;
  59         enum osd_zoom_factor h_zoom;
  60         enum osd_zoom_factor v_zoom;
  61         enum osd_h_exp_ratio h_exp;
  62         enum osd_v_exp_ratio v_exp;
  63 };
  64
  65 /* vpbe display object structure */
  66 struct vpbe_layer {
  67         /* number of buffers in fbuffers */
  68         unsigned int numbuffers;
  69         /* Pointer to the vpbe_display */
  70         struct vpbe_display *disp_dev;
  71         /* Pointer pointing to current v4l2_buffer */
  72         struct videobuf_buffer *cur_frm;
  73         /* Pointer pointing to next v4l2_buffer */
  74         struct videobuf_buffer *next_frm;
  75         /* videobuf specific parameters
  76          * Buffer queue used in video-buf
  77          */
  78         struct videobuf_queue buffer_queue;
  79         /* Queue of filled frames */
  80         struct list_head dma_queue;
  81         /* Used in video-buf */
  82         spinlock_t irqlock;
  83         /* V4l2 specific parameters */
  84         /* Identifies video device for this layer */
  85         struct video_device video_dev;
  86         /* This field keeps track of type of buffer exchange mechanism user
  87          * has selected
  88          */
  89         enum v4l2_memory memory;
  90         /* Used to keep track of state of the priority */
  91         struct v4l2_prio_state prio;
  92         /* Used to store pixel format */
  93         struct v4l2_pix_format pix_fmt;
  94         enum v4l2_field buf_field;
  95         /* Video layer configuration params */
  96         struct display_layer_info layer_info;
  97         /* vpbe specific parameters
  98          * enable window for display
  99          */
 100         unsigned char window_enable;
 101         /* number of open instances of the layer */
 102         unsigned int usrs;
 103         /* number of users performing IO */
 104         unsigned int io_usrs;
 105         /* Indicates id of the field which is being displayed */
 106         unsigned int field_id;
 107         /* Indicates whether streaming started */
 108         unsigned char started;
 109         /* Identifies device object */
 110         enum vpbe_display_device_id device_id;
 111         /* facilitation of ioctl ops lock by v4l2*/
 112         struct mutex opslock;
 113         u8 layer_first_int;
 114 };
 115
 116 /* vpbe device structure */
 117 struct vpbe_display {
 118         /* layer specific parameters */
 119         /* lock for isr updates to buf layers*/
 120         spinlock_t dma_queue_lock;
 121         /* C-Plane offset from start of y-plane */
 122         unsigned int cbcr_ofst;
 123         struct vpbe_layer *dev[VPBE_DISPLAY_MAX_DEVICES];
 124         struct vpbe_device *vpbe_dev;
 125         struct osd_state *osd_device;
 126 };
 127
 128 /* File handle structure */
 129 struct vpbe_fh {
 130         /* vpbe device structure */
 131         struct vpbe_display *disp_dev;
 132         /* pointer to layer object for opened device */
 133         struct vpbe_layer *layer;
 134         /* Indicates whether this file handle is doing IO */
 135         unsigned char io_allowed;
 136         /* Used to keep track priority of this instance */
 137         enum v4l2_priority prio;
 138 };
 139
 140 struct buf_config_params {
 141         unsigned char min_numbuffers;
 142         unsigned char numbuffers[VPBE_DISPLAY_MAX_DEVICES];
 143         unsigned int min_bufsize[VPBE_DISPLAY_MAX_DEVICES];
 144         unsigned int layer_bufsize[VPBE_DISPLAY_MAX_DEVICES];
 145 };
 146
 147 #endif  /* VPBE_DISPLAY_H */