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