linux/drivers/media/platform/ti-vpe/vpdma.h
<<
>>
Prefs
   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 */
  18struct vpdma_buf {
  19        void                    *addr;
  20        dma_addr_t              dma_addr;
  21        size_t                  size;
  22        bool                    mapped;
  23};
  24
  25struct vpdma_desc_list {
  26        struct vpdma_buf buf;
  27        void *next;
  28        int type;
  29};
  30
  31struct 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
  43enum vpdma_data_format_type {
  44        VPDMA_DATA_FMT_TYPE_YUV,
  45        VPDMA_DATA_FMT_TYPE_RGB,
  46        VPDMA_DATA_FMT_TYPE_MISC,
  47};
  48
  49struct 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
  68enum 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_CB420,
  76        VPDMA_DATA_FMT_YCR422,
  77        VPDMA_DATA_FMT_YC444,
  78        VPDMA_DATA_FMT_CRY422,
  79        VPDMA_DATA_FMT_CBY422,
  80        VPDMA_DATA_FMT_YCB422,
  81};
  82
  83enum vpdma_rgb_formats {
  84        VPDMA_DATA_FMT_RGB565 = 0,
  85        VPDMA_DATA_FMT_ARGB16_1555,
  86        VPDMA_DATA_FMT_ARGB16,
  87        VPDMA_DATA_FMT_RGBA16_5551,
  88        VPDMA_DATA_FMT_RGBA16,
  89        VPDMA_DATA_FMT_ARGB24,
  90        VPDMA_DATA_FMT_RGB24,
  91        VPDMA_DATA_FMT_ARGB32,
  92        VPDMA_DATA_FMT_RGBA24,
  93        VPDMA_DATA_FMT_RGBA32,
  94        VPDMA_DATA_FMT_BGR565,
  95        VPDMA_DATA_FMT_ABGR16_1555,
  96        VPDMA_DATA_FMT_ABGR16,
  97        VPDMA_DATA_FMT_BGRA16_5551,
  98        VPDMA_DATA_FMT_BGRA16,
  99        VPDMA_DATA_FMT_ABGR24,
 100        VPDMA_DATA_FMT_BGR24,
 101        VPDMA_DATA_FMT_ABGR32,
 102        VPDMA_DATA_FMT_BGRA24,
 103        VPDMA_DATA_FMT_BGRA32,
 104};
 105
 106enum vpdma_raw_formats {
 107        VPDMA_DATA_FMT_RAW8 = 0,
 108        VPDMA_DATA_FMT_RAW16,
 109};
 110
 111enum vpdma_misc_formats {
 112        VPDMA_DATA_FMT_MV = 0,
 113};
 114
 115extern const struct vpdma_data_format vpdma_yuv_fmts[];
 116extern const struct vpdma_data_format vpdma_rgb_fmts[];
 117extern const struct vpdma_data_format vpdma_raw_fmts[];
 118extern const struct vpdma_data_format vpdma_misc_fmts[];
 119
 120enum vpdma_frame_start_event {
 121        VPDMA_FSEVENT_HDMI_FID = 0,
 122        VPDMA_FSEVENT_DVO2_FID,
 123        VPDMA_FSEVENT_HDCOMP_FID,
 124        VPDMA_FSEVENT_SD_FID,
 125        VPDMA_FSEVENT_LM_FID0,
 126        VPDMA_FSEVENT_LM_FID1,
 127        VPDMA_FSEVENT_LM_FID2,
 128        VPDMA_FSEVENT_CHANNEL_ACTIVE,
 129};
 130
 131/* max width configurations */
 132enum vpdma_max_width {
 133        MAX_OUT_WIDTH_UNLIMITED = 0,
 134        MAX_OUT_WIDTH_REG1,
 135        MAX_OUT_WIDTH_REG2,
 136        MAX_OUT_WIDTH_REG3,
 137        MAX_OUT_WIDTH_352,
 138        MAX_OUT_WIDTH_768,
 139        MAX_OUT_WIDTH_1280,
 140        MAX_OUT_WIDTH_1920,
 141};
 142
 143/* max height configurations */
 144enum vpdma_max_height {
 145        MAX_OUT_HEIGHT_UNLIMITED = 0,
 146        MAX_OUT_HEIGHT_REG1,
 147        MAX_OUT_HEIGHT_REG2,
 148        MAX_OUT_HEIGHT_REG3,
 149        MAX_OUT_HEIGHT_288,
 150        MAX_OUT_HEIGHT_576,
 151        MAX_OUT_HEIGHT_720,
 152        MAX_OUT_HEIGHT_1080,
 153};
 154
 155/*
 156 * VPDMA channel numbers
 157 */
 158enum vpdma_channel {
 159        VPE_CHAN_LUMA1_IN,
 160        VPE_CHAN_CHROMA1_IN,
 161        VPE_CHAN_LUMA2_IN,
 162        VPE_CHAN_CHROMA2_IN,
 163        VPE_CHAN_LUMA3_IN,
 164        VPE_CHAN_CHROMA3_IN,
 165        VPE_CHAN_MV_IN,
 166        VPE_CHAN_MV_OUT,
 167        VPE_CHAN_LUMA_OUT,
 168        VPE_CHAN_CHROMA_OUT,
 169        VPE_CHAN_RGB_OUT,
 170};
 171
 172#define VIP_CHAN_VIP2_OFFSET            70
 173#define VIP_CHAN_MULT_PORTB_OFFSET      16
 174#define VIP_CHAN_YUV_PORTB_OFFSET       2
 175#define VIP_CHAN_RGB_PORTB_OFFSET       1
 176
 177#define VPDMA_MAX_CHANNELS              256
 178
 179/* flags for VPDMA data descriptors */
 180#define VPDMA_DATA_ODD_LINE_SKIP        (1 << 0)
 181#define VPDMA_DATA_EVEN_LINE_SKIP       (1 << 1)
 182#define VPDMA_DATA_FRAME_1D             (1 << 2)
 183#define VPDMA_DATA_MODE_TILED           (1 << 3)
 184
 185/*
 186 * client identifiers used for configuration descriptors
 187 */
 188#define CFD_MMR_CLIENT          0
 189#define CFD_SC_CLIENT           4
 190
 191/* Address data block header format */
 192struct vpdma_adb_hdr {
 193        u32                     offset;
 194        u32                     nwords;
 195        u32                     reserved0;
 196        u32                     reserved1;
 197};
 198
 199/* helpers for creating ADB headers for config descriptors MMRs as client */
 200#define ADB_ADDR(dma_buf, str, fld)     ((dma_buf)->addr + offsetof(str, fld))
 201#define MMR_ADB_ADDR(buf, str, fld)     ADB_ADDR(&(buf), struct str, fld)
 202
 203#define VPDMA_SET_MMR_ADB_HDR(buf, str, hdr, regs, offset_a)    \
 204        do {                                                    \
 205                struct vpdma_adb_hdr *h;                        \
 206                struct str *adb = NULL;                         \
 207                h = MMR_ADB_ADDR(buf, str, hdr);                \
 208                h->offset = (offset_a);                         \
 209                h->nwords = sizeof(adb->regs) >> 2;             \
 210        } while (0)
 211
 212/* vpdma descriptor buffer allocation and management */
 213int vpdma_alloc_desc_buf(struct vpdma_buf *buf, size_t size);
 214void vpdma_free_desc_buf(struct vpdma_buf *buf);
 215int vpdma_map_desc_buf(struct vpdma_data *vpdma, struct vpdma_buf *buf);
 216void vpdma_unmap_desc_buf(struct vpdma_data *vpdma, struct vpdma_buf *buf);
 217
 218/* vpdma descriptor list funcs */
 219int vpdma_create_desc_list(struct vpdma_desc_list *list, size_t size, int type);
 220void vpdma_reset_desc_list(struct vpdma_desc_list *list);
 221void vpdma_free_desc_list(struct vpdma_desc_list *list);
 222int vpdma_submit_descs(struct vpdma_data *vpdma, struct vpdma_desc_list *list,
 223                       int list_num);
 224bool vpdma_list_busy(struct vpdma_data *vpdma, int list_num);
 225void vpdma_update_dma_addr(struct vpdma_data *vpdma,
 226        struct vpdma_desc_list *list, dma_addr_t dma_addr,
 227        void *write_dtd, int drop, int idx);
 228
 229/* VPDMA hardware list funcs */
 230int vpdma_hwlist_alloc(struct vpdma_data *vpdma, void *priv);
 231void *vpdma_hwlist_get_priv(struct vpdma_data *vpdma, int list_num);
 232void *vpdma_hwlist_release(struct vpdma_data *vpdma, int list_num);
 233
 234/* helpers for creating vpdma descriptors */
 235void vpdma_add_cfd_block(struct vpdma_desc_list *list, int client,
 236                struct vpdma_buf *blk, u32 dest_offset);
 237void vpdma_add_cfd_adb(struct vpdma_desc_list *list, int client,
 238                struct vpdma_buf *adb);
 239void vpdma_add_sync_on_channel_ctd(struct vpdma_desc_list *list,
 240                enum vpdma_channel chan);
 241void vpdma_add_abort_channel_ctd(struct vpdma_desc_list *list,
 242                int chan_num);
 243void vpdma_add_out_dtd(struct vpdma_desc_list *list, int width,
 244                int stride, const struct v4l2_rect *c_rect,
 245                const struct vpdma_data_format *fmt, dma_addr_t dma_addr,
 246                int max_w, int max_h, enum vpdma_channel chan, u32 flags);
 247void vpdma_rawchan_add_out_dtd(struct vpdma_desc_list *list, int width,
 248                int stride, const struct v4l2_rect *c_rect,
 249                const struct vpdma_data_format *fmt, dma_addr_t dma_addr,
 250                int max_w, int max_h, int raw_vpdma_chan, u32 flags);
 251
 252void vpdma_add_in_dtd(struct vpdma_desc_list *list, int width,
 253                int stride, const struct v4l2_rect *c_rect,
 254                const struct vpdma_data_format *fmt, dma_addr_t dma_addr,
 255                enum vpdma_channel chan, int field, u32 flags, int frame_width,
 256                int frame_height, int start_h, int start_v);
 257int vpdma_list_cleanup(struct vpdma_data *vpdma, int list_num,
 258                int *channels, int size);
 259
 260/* vpdma list interrupt management */
 261void vpdma_enable_list_complete_irq(struct vpdma_data *vpdma, int irq_num,
 262                int list_num, bool enable);
 263void vpdma_clear_list_stat(struct vpdma_data *vpdma, int irq_num,
 264                           int list_num);
 265unsigned int vpdma_get_list_stat(struct vpdma_data *vpdma, int irq_num);
 266unsigned int vpdma_get_list_mask(struct vpdma_data *vpdma, int irq_num);
 267
 268/* vpdma client configuration */
 269void vpdma_set_line_mode(struct vpdma_data *vpdma, int line_mode,
 270                enum vpdma_channel chan);
 271void vpdma_set_frame_start_event(struct vpdma_data *vpdma,
 272                enum vpdma_frame_start_event fs_event, enum vpdma_channel chan);
 273void vpdma_set_max_size(struct vpdma_data *vpdma, int reg_addr,
 274                        u32 width, u32 height);
 275
 276void vpdma_set_bg_color(struct vpdma_data *vpdma,
 277                        struct vpdma_data_format *fmt, u32 color);
 278void vpdma_dump_regs(struct vpdma_data *vpdma);
 279
 280/* initialize vpdma, passed with VPE's platform device pointer */
 281int vpdma_create(struct platform_device *pdev, struct vpdma_data *vpdma,
 282                void (*cb)(struct platform_device *pdev));
 283
 284#endif
 285