root/drivers/media/platform/ti-vpe/vpdma.h

INCLUDED FROM

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * Copyright (c) 2013 Texas Instruments Inc.
   4  *
   5  * David Griego, <dagriego@biglakesoftware.com>
   6  * Dale Farnsworth, <dale@farnsworth.org>
   7  * Archit Taneja, <archit@ti.com>
   8  */
   9 
  10 #ifndef __TI_VPDMA_H_
  11 #define __TI_VPDMA_H_
  12 
  13 #define VPDMA_MAX_NUM_LIST              8
  14 /*
  15  * A vpdma_buf tracks the size, DMA address and mapping status of each
  16  * driver DMA area.
  17  */
  18 struct vpdma_buf {
  19         void                    *addr;
  20         dma_addr_t              dma_addr;
  21         size_t                  size;
  22         bool                    mapped;
  23 };
  24 
  25 struct vpdma_desc_list {
  26         struct vpdma_buf buf;
  27         void *next;
  28         int type;
  29 };
  30 
  31 struct vpdma_data {
  32         void __iomem            *base;
  33 
  34         struct platform_device  *pdev;
  35 
  36         spinlock_t              lock;
  37         bool                    hwlist_used[VPDMA_MAX_NUM_LIST];
  38         void                    *hwlist_priv[VPDMA_MAX_NUM_LIST];
  39         /* callback to VPE driver when the firmware is loaded */
  40         void (*cb)(struct platform_device *pdev);
  41 };
  42 
  43 enum vpdma_data_format_type {
  44         VPDMA_DATA_FMT_TYPE_YUV,
  45         VPDMA_DATA_FMT_TYPE_RGB,
  46         VPDMA_DATA_FMT_TYPE_MISC,
  47 };
  48 
  49 struct vpdma_data_format {
  50         enum vpdma_data_format_type type;
  51         int data_type;
  52         u8 depth;
  53 };
  54 
  55 #define VPDMA_DESC_ALIGN                16      /* 16-byte descriptor alignment */
  56 #define VPDMA_STRIDE_ALIGN              16      /*
  57                                                  * line stride of source and dest
  58                                                  * buffers should be 16 byte aligned
  59                                                  */
  60 #define VPDMA_MAX_STRIDE                65520   /* Max line stride 16 byte aligned */
  61 #define VPDMA_DTD_DESC_SIZE             32      /* 8 words */
  62 #define VPDMA_CFD_CTD_DESC_SIZE         16      /* 4 words */
  63 
  64 #define VPDMA_LIST_TYPE_NORMAL          0
  65 #define VPDMA_LIST_TYPE_SELF_MODIFYING  1
  66 #define VPDMA_LIST_TYPE_DOORBELL        2
  67 
  68 enum vpdma_yuv_formats {
  69         VPDMA_DATA_FMT_Y444 = 0,
  70         VPDMA_DATA_FMT_Y422,
  71         VPDMA_DATA_FMT_Y420,
  72         VPDMA_DATA_FMT_C444,
  73         VPDMA_DATA_FMT_C422,
  74         VPDMA_DATA_FMT_C420,
  75         VPDMA_DATA_FMT_YCR422,
  76         VPDMA_DATA_FMT_YC444,
  77         VPDMA_DATA_FMT_CRY422,
  78         VPDMA_DATA_FMT_CBY422,
  79         VPDMA_DATA_FMT_YCB422,
  80 };
  81 
  82 enum vpdma_rgb_formats {
  83         VPDMA_DATA_FMT_RGB565 = 0,
  84         VPDMA_DATA_FMT_ARGB16_1555,
  85         VPDMA_DATA_FMT_ARGB16,
  86         VPDMA_DATA_FMT_RGBA16_5551,
  87         VPDMA_DATA_FMT_RGBA16,
  88         VPDMA_DATA_FMT_ARGB24,
  89         VPDMA_DATA_FMT_RGB24,
  90         VPDMA_DATA_FMT_ARGB32,
  91         VPDMA_DATA_FMT_RGBA24,
  92         VPDMA_DATA_FMT_RGBA32,
  93         VPDMA_DATA_FMT_BGR565,
  94         VPDMA_DATA_FMT_ABGR16_1555,
  95         VPDMA_DATA_FMT_ABGR16,
  96         VPDMA_DATA_FMT_BGRA16_5551,
  97         VPDMA_DATA_FMT_BGRA16,
  98         VPDMA_DATA_FMT_ABGR24,
  99         VPDMA_DATA_FMT_BGR24,
 100         VPDMA_DATA_FMT_ABGR32,
 101         VPDMA_DATA_FMT_BGRA24,
 102         VPDMA_DATA_FMT_BGRA32,
 103 };
 104 
 105 enum vpdma_raw_formats {
 106         VPDMA_DATA_FMT_RAW8 = 0,
 107         VPDMA_DATA_FMT_RAW16,
 108 };
 109 
 110 enum vpdma_misc_formats {
 111         VPDMA_DATA_FMT_MV = 0,
 112 };
 113 
 114 extern const struct vpdma_data_format vpdma_yuv_fmts[];
 115 extern const struct vpdma_data_format vpdma_rgb_fmts[];
 116 extern const struct vpdma_data_format vpdma_raw_fmts[];
 117 extern const struct vpdma_data_format vpdma_misc_fmts[];
 118 
 119 enum vpdma_frame_start_event {
 120         VPDMA_FSEVENT_HDMI_FID = 0,
 121         VPDMA_FSEVENT_DVO2_FID,
 122         VPDMA_FSEVENT_HDCOMP_FID,
 123         VPDMA_FSEVENT_SD_FID,
 124         VPDMA_FSEVENT_LM_FID0,
 125         VPDMA_FSEVENT_LM_FID1,
 126         VPDMA_FSEVENT_LM_FID2,
 127         VPDMA_FSEVENT_CHANNEL_ACTIVE,
 128 };
 129 
 130 /* max width configurations */
 131 enum vpdma_max_width {
 132         MAX_OUT_WIDTH_UNLIMITED = 0,
 133         MAX_OUT_WIDTH_REG1,
 134         MAX_OUT_WIDTH_REG2,
 135         MAX_OUT_WIDTH_REG3,
 136         MAX_OUT_WIDTH_352,
 137         MAX_OUT_WIDTH_768,
 138         MAX_OUT_WIDTH_1280,
 139         MAX_OUT_WIDTH_1920,
 140 };
 141 
 142 /* max height configurations */
 143 enum vpdma_max_height {
 144         MAX_OUT_HEIGHT_UNLIMITED = 0,
 145         MAX_OUT_HEIGHT_REG1,
 146         MAX_OUT_HEIGHT_REG2,
 147         MAX_OUT_HEIGHT_REG3,
 148         MAX_OUT_HEIGHT_288,
 149         MAX_OUT_HEIGHT_576,
 150         MAX_OUT_HEIGHT_720,
 151         MAX_OUT_HEIGHT_1080,
 152 };
 153 
 154 /*
 155  * VPDMA channel numbers
 156  */
 157 enum vpdma_channel {
 158         VPE_CHAN_LUMA1_IN,
 159         VPE_CHAN_CHROMA1_IN,
 160         VPE_CHAN_LUMA2_IN,
 161         VPE_CHAN_CHROMA2_IN,
 162         VPE_CHAN_LUMA3_IN,
 163         VPE_CHAN_CHROMA3_IN,
 164         VPE_CHAN_MV_IN,
 165         VPE_CHAN_MV_OUT,
 166         VPE_CHAN_LUMA_OUT,
 167         VPE_CHAN_CHROMA_OUT,
 168         VPE_CHAN_RGB_OUT,
 169 };
 170 
 171 #define VIP_CHAN_VIP2_OFFSET            70
 172 #define VIP_CHAN_MULT_PORTB_OFFSET      16
 173 #define VIP_CHAN_YUV_PORTB_OFFSET       2
 174 #define VIP_CHAN_RGB_PORTB_OFFSET       1
 175 
 176 #define VPDMA_MAX_CHANNELS              256
 177 
 178 /* flags for VPDMA data descriptors */
 179 #define VPDMA_DATA_ODD_LINE_SKIP        (1 << 0)
 180 #define VPDMA_DATA_EVEN_LINE_SKIP       (1 << 1)
 181 #define VPDMA_DATA_FRAME_1D             (1 << 2)
 182 #define VPDMA_DATA_MODE_TILED           (1 << 3)
 183 
 184 /*
 185  * client identifiers used for configuration descriptors
 186  */
 187 #define CFD_MMR_CLIENT          0
 188 #define CFD_SC_CLIENT           4
 189 
 190 /* Address data block header format */
 191 struct vpdma_adb_hdr {
 192         u32                     offset;
 193         u32                     nwords;
 194         u32                     reserved0;
 195         u32                     reserved1;
 196 };
 197 
 198 /* helpers for creating ADB headers for config descriptors MMRs as client */
 199 #define ADB_ADDR(dma_buf, str, fld)     ((dma_buf)->addr + offsetof(str, fld))
 200 #define MMR_ADB_ADDR(buf, str, fld)     ADB_ADDR(&(buf), struct str, fld)
 201 
 202 #define VPDMA_SET_MMR_ADB_HDR(buf, str, hdr, regs, offset_a)    \
 203         do {                                                    \
 204                 struct vpdma_adb_hdr *h;                        \
 205                 struct str *adb = NULL;                         \
 206                 h = MMR_ADB_ADDR(buf, str, hdr);                \
 207                 h->offset = (offset_a);                         \
 208                 h->nwords = sizeof(adb->regs) >> 2;             \
 209         } while (0)
 210 
 211 /* vpdma descriptor buffer allocation and management */
 212 int vpdma_alloc_desc_buf(struct vpdma_buf *buf, size_t size);
 213 void vpdma_free_desc_buf(struct vpdma_buf *buf);
 214 int vpdma_map_desc_buf(struct vpdma_data *vpdma, struct vpdma_buf *buf);
 215 void vpdma_unmap_desc_buf(struct vpdma_data *vpdma, struct vpdma_buf *buf);
 216 
 217 /* vpdma descriptor list funcs */
 218 int vpdma_create_desc_list(struct vpdma_desc_list *list, size_t size, int type);
 219 void vpdma_reset_desc_list(struct vpdma_desc_list *list);
 220 void vpdma_free_desc_list(struct vpdma_desc_list *list);
 221 int vpdma_submit_descs(struct vpdma_data *vpdma, struct vpdma_desc_list *list,
 222                        int list_num);
 223 bool vpdma_list_busy(struct vpdma_data *vpdma, int list_num);
 224 void vpdma_update_dma_addr(struct vpdma_data *vpdma,
 225         struct vpdma_desc_list *list, dma_addr_t dma_addr,
 226         void *write_dtd, int drop, int idx);
 227 
 228 /* VPDMA hardware list funcs */
 229 int vpdma_hwlist_alloc(struct vpdma_data *vpdma, void *priv);
 230 void *vpdma_hwlist_get_priv(struct vpdma_data *vpdma, int list_num);
 231 void *vpdma_hwlist_release(struct vpdma_data *vpdma, int list_num);
 232 
 233 /* helpers for creating vpdma descriptors */
 234 void vpdma_add_cfd_block(struct vpdma_desc_list *list, int client,
 235                 struct vpdma_buf *blk, u32 dest_offset);
 236 void vpdma_add_cfd_adb(struct vpdma_desc_list *list, int client,
 237                 struct vpdma_buf *adb);
 238 void vpdma_add_sync_on_channel_ctd(struct vpdma_desc_list *list,
 239                 enum vpdma_channel chan);
 240 void vpdma_add_abort_channel_ctd(struct vpdma_desc_list *list,
 241                 int chan_num);
 242 void vpdma_add_out_dtd(struct vpdma_desc_list *list, int width,
 243                 int stride, const struct v4l2_rect *c_rect,
 244                 const struct vpdma_data_format *fmt, dma_addr_t dma_addr,
 245                 int max_w, int max_h, enum vpdma_channel chan, u32 flags);
 246 void vpdma_rawchan_add_out_dtd(struct vpdma_desc_list *list, int width,
 247                 int stride, const struct v4l2_rect *c_rect,
 248                 const struct vpdma_data_format *fmt, dma_addr_t dma_addr,
 249                 int max_w, int max_h, int raw_vpdma_chan, u32 flags);
 250 
 251 void vpdma_add_in_dtd(struct vpdma_desc_list *list, int width,
 252                 int stride, const struct v4l2_rect *c_rect,
 253                 const struct vpdma_data_format *fmt, dma_addr_t dma_addr,
 254                 enum vpdma_channel chan, int field, u32 flags, int frame_width,
 255                 int frame_height, int start_h, int start_v);
 256 int vpdma_list_cleanup(struct vpdma_data *vpdma, int list_num,
 257                 int *channels, int size);
 258 
 259 /* vpdma list interrupt management */
 260 void vpdma_enable_list_complete_irq(struct vpdma_data *vpdma, int irq_num,
 261                 int list_num, bool enable);
 262 void vpdma_clear_list_stat(struct vpdma_data *vpdma, int irq_num,
 263                            int list_num);
 264 unsigned int vpdma_get_list_stat(struct vpdma_data *vpdma, int irq_num);
 265 unsigned int vpdma_get_list_mask(struct vpdma_data *vpdma, int irq_num);
 266 
 267 /* vpdma client configuration */
 268 void vpdma_set_line_mode(struct vpdma_data *vpdma, int line_mode,
 269                 enum vpdma_channel chan);
 270 void vpdma_set_frame_start_event(struct vpdma_data *vpdma,
 271                 enum vpdma_frame_start_event fs_event, enum vpdma_channel chan);
 272 void vpdma_set_max_size(struct vpdma_data *vpdma, int reg_addr,
 273                         u32 width, u32 height);
 274 
 275 void vpdma_set_bg_color(struct vpdma_data *vpdma,
 276                         struct vpdma_data_format *fmt, u32 color);
 277 void vpdma_dump_regs(struct vpdma_data *vpdma);
 278 
 279 /* initialize vpdma, passed with VPE's platform device pointer */
 280 int vpdma_create(struct platform_device *pdev, struct vpdma_data *vpdma,
 281                 void (*cb)(struct platform_device *pdev));
 282 
 283 #endif