1 /* 2 * Samsung EXYNOS4x12 FIMC-IS (Imaging Subsystem) driver 3 * 4 * Copyright (C) 2013 Samsung Electronics Co., Ltd. 5 * 6 * Authors: Sylwester Nawrocki <s.nawrocki@samsung.com> 7 * Younghwan Joo <yhwan.joo@samsung.com> 8 * 9 * This program is free software; you can redistribute it and/or modify 10 * it under the terms of the GNU General Public License version 2 as 11 * published by the Free Software Foundation. 12 */ 13 #ifndef FIMC_ISP_H_ 14 #define FIMC_ISP_H_ 15 16 #include <linux/io.h> 17 #include <linux/platform_device.h> 18 #include <linux/sched.h> 19 #include <linux/spinlock.h> 20 #include <linux/types.h> 21 #include <linux/videodev2.h> 22 23 #include <media/media-entity.h> 24 #include <media/videobuf2-core.h> 25 #include <media/v4l2-device.h> 26 #include <media/v4l2-mediabus.h> 27 #include <media/exynos-fimc.h> 28 29 extern int fimc_isp_debug; 30 31 #define isp_dbg(level, dev, fmt, arg...) \ 32 v4l2_dbg(level, fimc_isp_debug, dev, fmt, ## arg) 33 34 /* FIXME: revisit these constraints */ 35 #define FIMC_ISP_SINK_WIDTH_MIN (16 + 8) 36 #define FIMC_ISP_SINK_HEIGHT_MIN (12 + 8) 37 #define FIMC_ISP_SOURCE_WIDTH_MIN 8 38 #define FIMC_ISP_SOURCE_HEIGHT_MIN 8 39 #define FIMC_ISP_CAC_MARGIN_WIDTH 16 40 #define FIMC_ISP_CAC_MARGIN_HEIGHT 12 41 42 #define FIMC_ISP_SINK_WIDTH_MAX (4000 - 16) 43 #define FIMC_ISP_SINK_HEIGHT_MAX (4000 + 12) 44 #define FIMC_ISP_SOURCE_WIDTH_MAX 4000 45 #define FIMC_ISP_SOURCE_HEIGHT_MAX 4000 46 47 #define FIMC_ISP_NUM_FORMATS 3 48 #define FIMC_ISP_REQ_BUFS_MIN 2 49 #define FIMC_ISP_REQ_BUFS_MAX 32 50 51 #define FIMC_ISP_SD_PAD_SINK 0 52 #define FIMC_ISP_SD_PAD_SRC_FIFO 1 53 #define FIMC_ISP_SD_PAD_SRC_DMA 2 54 #define FIMC_ISP_SD_PADS_NUM 3 55 #define FIMC_ISP_MAX_PLANES 1 56 57 /** 58 * struct fimc_isp_frame - source/target frame properties 59 * @width: full image width 60 * @height: full image height 61 * @rect: crop/composition rectangle 62 */ 63 struct fimc_isp_frame { 64 u16 width; 65 u16 height; 66 struct v4l2_rect rect; 67 }; 68 69 struct fimc_isp_ctrls { 70 struct v4l2_ctrl_handler handler; 71 72 /* Auto white balance */ 73 struct v4l2_ctrl *auto_wb; 74 /* Auto ISO control cluster */ 75 struct { 76 struct v4l2_ctrl *auto_iso; 77 struct v4l2_ctrl *iso; 78 }; 79 /* Adjust - contrast */ 80 struct v4l2_ctrl *contrast; 81 /* Adjust - saturation */ 82 struct v4l2_ctrl *saturation; 83 /* Adjust - sharpness */ 84 struct v4l2_ctrl *sharpness; 85 /* Adjust - brightness */ 86 struct v4l2_ctrl *brightness; 87 /* Adjust - hue */ 88 struct v4l2_ctrl *hue; 89 90 /* Auto/manual exposure */ 91 struct v4l2_ctrl *auto_exp; 92 /* Manual exposure value */ 93 struct v4l2_ctrl *exposure; 94 /* AE/AWB lock/unlock */ 95 struct v4l2_ctrl *aewb_lock; 96 /* Exposure metering mode */ 97 struct v4l2_ctrl *exp_metering; 98 /* AFC */ 99 struct v4l2_ctrl *afc; 100 /* ISP image effect */ 101 struct v4l2_ctrl *colorfx; 102 }; 103 104 struct isp_video_buf { 105 struct vb2_buffer vb; 106 dma_addr_t dma_addr[FIMC_ISP_MAX_PLANES]; 107 unsigned int index; 108 }; 109 110 #define to_isp_video_buf(_b) container_of(_b, struct isp_video_buf, vb) 111 112 #define FIMC_ISP_MAX_BUFS 4 113 114 /** 115 * struct fimc_is_video - fimc-is video device structure 116 * @vdev: video_device structure 117 * @type: video device type (CAPTURE/OUTPUT) 118 * @pad: video device media (sink) pad 119 * @pending_buf_q: pending buffers queue head 120 * @active_buf_q: a queue head of buffers scheduled in hardware 121 * @vb_queue: vb2 buffer queue 122 * @active_buf_count: number of video buffers scheduled in hardware 123 * @frame_count: counter of frames dequeued to user space 124 * @reqbufs_count: number of buffers requested with REQBUFS ioctl 125 * @format: current pixel format 126 */ 127 struct fimc_is_video { 128 struct exynos_video_entity ve; 129 enum v4l2_buf_type type; 130 struct media_pad pad; 131 struct list_head pending_buf_q; 132 struct list_head active_buf_q; 133 struct vb2_queue vb_queue; 134 unsigned int reqbufs_count; 135 unsigned int buf_count; 136 unsigned int buf_mask; 137 unsigned int frame_count; 138 int streaming; 139 struct isp_video_buf *buffers[FIMC_ISP_MAX_BUFS]; 140 const struct fimc_fmt *format; 141 struct v4l2_pix_format_mplane pixfmt; 142 }; 143 144 /* struct fimc_isp:state bit definitions */ 145 #define ST_ISP_VID_CAP_BUF_PREP 0 146 #define ST_ISP_VID_CAP_STREAMING 1 147 148 /** 149 * struct fimc_isp - FIMC-IS ISP data structure 150 * @pdev: pointer to FIMC-IS platform device 151 * @alloc_ctx: videobuf2 memory allocator context 152 * @subdev: ISP v4l2_subdev 153 * @subdev_pads: the ISP subdev media pads 154 * @test_pattern: test pattern controls 155 * @ctrls: v4l2 controls structure 156 * @video_lock: mutex serializing video device and the subdev operations 157 * @cac_margin_x: horizontal CAC margin in pixels 158 * @cac_margin_y: vertical CAC margin in pixels 159 * @state: driver state flags 160 * @video_capture: the ISP block video capture device 161 */ 162 struct fimc_isp { 163 struct platform_device *pdev; 164 struct vb2_alloc_ctx *alloc_ctx; 165 struct v4l2_subdev subdev; 166 struct media_pad subdev_pads[FIMC_ISP_SD_PADS_NUM]; 167 struct v4l2_mbus_framefmt src_fmt; 168 struct v4l2_mbus_framefmt sink_fmt; 169 struct v4l2_ctrl *test_pattern; 170 struct fimc_isp_ctrls ctrls; 171 172 struct mutex video_lock; 173 struct mutex subdev_lock; 174 175 unsigned int cac_margin_x; 176 unsigned int cac_margin_y; 177 178 unsigned long state; 179 180 struct fimc_is_video video_capture; 181 }; 182 183 #define ctrl_to_fimc_isp(_ctrl) \ 184 container_of(ctrl->handler, struct fimc_isp, ctrls.handler) 185 186 struct fimc_is; 187 188 int fimc_isp_subdev_create(struct fimc_isp *isp); 189 void fimc_isp_subdev_destroy(struct fimc_isp *isp); 190 void fimc_isp_irq_handler(struct fimc_is *is); 191 int fimc_is_create_controls(struct fimc_isp *isp); 192 int fimc_is_delete_controls(struct fimc_isp *isp); 193 const struct fimc_fmt *fimc_isp_find_format(const u32 *pixelformat, 194 const u32 *mbus_code, int index); 195 #endif /* FIMC_ISP_H_ */ 196