1 /* 2 * Copyright (C) STMicroelectronics SA 2014 3 * Authors: Fabien Dessenne <fabien.dessenne@st.com> for STMicroelectronics. 4 * License terms: GNU General Public License (GPL), version 2 5 */ 6 7 #include <linux/clk.h> 8 #include <linux/ktime.h> 9 #include <linux/platform_device.h> 10 #include <linux/spinlock.h> 11 12 #include <media/v4l2-ctrls.h> 13 #include <media/v4l2-device.h> 14 #include <media/v4l2-mem2mem.h> 15 16 #include <media/videobuf2-dma-contig.h> 17 18 #define BDISP_NAME "bdisp" 19 20 /* 21 * Max nb of nodes in node-list: 22 * - 2 nodes to handle wide 4K pictures 23 * - 2 nodes to handle two planes (Y & CbCr) */ 24 #define MAX_OUTPUT_PLANES 2 25 #define MAX_VERTICAL_STRIDES 2 26 #define MAX_NB_NODE (MAX_OUTPUT_PLANES * MAX_VERTICAL_STRIDES) 27 28 /* struct bdisp_ctrls - bdisp control set 29 * @hflip: horizontal flip 30 * @vflip: vertical flip 31 */ 32 struct bdisp_ctrls { 33 struct v4l2_ctrl *hflip; 34 struct v4l2_ctrl *vflip; 35 }; 36 37 /** 38 * struct bdisp_fmt - driver's internal color format data 39 * @pixelformat:fourcc code for this format 40 * @nb_planes: number of planes (ex: [0]=RGB/Y - [1]=Cb/Cr, ...) 41 * @bpp: bits per pixel (general) 42 * @bpp_plane0: byte per pixel for the 1st plane 43 * @w_align: width alignment in pixel (multiple of) 44 * @h_align: height alignment in pixel (multiple of) 45 */ 46 struct bdisp_fmt { 47 u32 pixelformat; 48 u8 nb_planes; 49 u8 bpp; 50 u8 bpp_plane0; 51 u8 w_align; 52 u8 h_align; 53 }; 54 55 /** 56 * struct bdisp_frame - frame properties 57 * 58 * @width: frame width (including padding) 59 * @height: frame height (including padding) 60 * @fmt: pointer to frame format descriptor 61 * @field: frame / field type 62 * @bytesperline: stride of the 1st plane 63 * @sizeimage: image size in bytes 64 * @colorspace: colorspace 65 * @crop: crop area 66 * @paddr: image physical addresses per plane ([0]=RGB/Y - [1]=Cb/Cr, ...) 67 */ 68 struct bdisp_frame { 69 u32 width; 70 u32 height; 71 const struct bdisp_fmt *fmt; 72 enum v4l2_field field; 73 u32 bytesperline; 74 u32 sizeimage; 75 enum v4l2_colorspace colorspace; 76 struct v4l2_rect crop; 77 dma_addr_t paddr[4]; 78 }; 79 80 /** 81 * struct bdisp_request - bdisp request 82 * 83 * @src: source frame properties 84 * @dst: destination frame properties 85 * @hflip: horizontal flip 86 * @vflip: vertical flip 87 * @nb_req: number of run request 88 */ 89 struct bdisp_request { 90 struct bdisp_frame src; 91 struct bdisp_frame dst; 92 unsigned int hflip:1; 93 unsigned int vflip:1; 94 int nb_req; 95 }; 96 97 /** 98 * struct bdisp_ctx - device context data 99 * 100 * @src: source frame properties 101 * @dst: destination frame properties 102 * @state: flags to keep track of user configuration 103 * @hflip: horizontal flip 104 * @vflip: vertical flip 105 * @bdisp_dev: the device this context applies to 106 * @node: node array 107 * @node_paddr: node physical address array 108 * @fh: v4l2 file handle 109 * @ctrl_handler: v4l2 controls handler 110 * @bdisp_ctrls: bdisp control set 111 * @ctrls_rdy: true if the control handler is initialized 112 */ 113 struct bdisp_ctx { 114 struct bdisp_frame src; 115 struct bdisp_frame dst; 116 u32 state; 117 unsigned int hflip:1; 118 unsigned int vflip:1; 119 struct bdisp_dev *bdisp_dev; 120 struct bdisp_node *node[MAX_NB_NODE]; 121 dma_addr_t node_paddr[MAX_NB_NODE]; 122 struct v4l2_fh fh; 123 struct v4l2_ctrl_handler ctrl_handler; 124 struct bdisp_ctrls bdisp_ctrls; 125 bool ctrls_rdy; 126 }; 127 128 /** 129 * struct bdisp_m2m_device - v4l2 memory-to-memory device data 130 * 131 * @vdev: video device node for v4l2 m2m mode 132 * @m2m_dev: v4l2 m2m device data 133 * @ctx: hardware context data 134 * @refcnt: reference counter 135 */ 136 struct bdisp_m2m_device { 137 struct video_device *vdev; 138 struct v4l2_m2m_dev *m2m_dev; 139 struct bdisp_ctx *ctx; 140 int refcnt; 141 }; 142 143 /** 144 * struct bdisp_dbg - debug info 145 * 146 * @debugfs_entry: debugfs 147 * @copy_node: array of last used nodes 148 * @copy_request: last bdisp request 149 * @hw_start: start time of last HW request 150 * @last_duration: last HW processing duration in microsecs 151 * @min_duration: min HW processing duration in microsecs 152 * @max_duration: max HW processing duration in microsecs 153 * @tot_duration: total HW processing duration in microsecs 154 */ 155 struct bdisp_dbg { 156 struct dentry *debugfs_entry; 157 struct bdisp_node *copy_node[MAX_NB_NODE]; 158 struct bdisp_request copy_request; 159 ktime_t hw_start; 160 s64 last_duration; 161 s64 min_duration; 162 s64 max_duration; 163 s64 tot_duration; 164 }; 165 166 /** 167 * struct bdisp_dev - abstraction for bdisp entity 168 * 169 * @v4l2_dev: v4l2 device 170 * @vdev: video device 171 * @pdev: platform device 172 * @dev: device 173 * @lock: mutex protecting this data structure 174 * @slock: spinlock protecting this data structure 175 * @id: device index 176 * @m2m: memory-to-memory V4L2 device information 177 * @state: flags used to synchronize m2m and capture mode operation 178 * @clock: IP clock 179 * @regs: registers 180 * @irq_queue: interrupt handler waitqueue 181 * @work_queue: workqueue to handle timeouts 182 * @timeout_work: IRQ timeout structure 183 * @dbg: debug info 184 */ 185 struct bdisp_dev { 186 struct v4l2_device v4l2_dev; 187 struct video_device vdev; 188 struct platform_device *pdev; 189 struct device *dev; 190 spinlock_t slock; 191 struct mutex lock; 192 u16 id; 193 struct bdisp_m2m_device m2m; 194 unsigned long state; 195 struct clk *clock; 196 void __iomem *regs; 197 wait_queue_head_t irq_queue; 198 struct workqueue_struct *work_queue; 199 struct delayed_work timeout_work; 200 struct bdisp_dbg dbg; 201 }; 202 203 void bdisp_hw_free_nodes(struct bdisp_ctx *ctx); 204 int bdisp_hw_alloc_nodes(struct bdisp_ctx *ctx); 205 void bdisp_hw_free_filters(struct device *dev); 206 int bdisp_hw_alloc_filters(struct device *dev); 207 int bdisp_hw_reset(struct bdisp_dev *bdisp); 208 int bdisp_hw_get_and_clear_irq(struct bdisp_dev *bdisp); 209 int bdisp_hw_update(struct bdisp_ctx *ctx); 210 211 void bdisp_debugfs_remove(struct bdisp_dev *bdisp); 212 int bdisp_debugfs_create(struct bdisp_dev *bdisp); 213 void bdisp_dbg_perf_begin(struct bdisp_dev *bdisp); 214 void bdisp_dbg_perf_end(struct bdisp_dev *bdisp); 215