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 284