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/s5p_fimc.h> 28 29 /* FIXME: revisit these constraints */ 30 #define FIMC_ISP_SINK_WIDTH_MIN (16 + 8) 31 #define FIMC_ISP_SINK_HEIGHT_MIN (12 + 8) 32 #define FIMC_ISP_SOURCE_WIDTH_MIN 8 33 #define FIMC_ISP_SOURC_HEIGHT_MIN 8 34 #define FIMC_ISP_CAC_MARGIN_WIDTH 16 35 #define FIMC_ISP_CAC_MARGIN_HEIGHT 12 36 37 #define FIMC_ISP_SINK_WIDTH_MAX (4000 - 16) 38 #define FIMC_ISP_SINK_HEIGHT_MAX (4000 + 12) 39 #define FIMC_ISP_SOURCE_WIDTH_MAX 4000 40 #define FIMC_ISP_SOURC_HEIGHT_MAX 4000 41 42 #define FIMC_ISP_NUM_FORMATS 3 43 #define FIMC_ISP_REQ_BUFS_MIN 2 44 45 #define FIMC_ISP_SD_PAD_SINK 0 46 #define FIMC_ISP_SD_PAD_SRC_FIFO 1 47 #define FIMC_ISP_SD_PAD_SRC_DMA 2 48 #define FIMC_ISP_SD_PADS_NUM 3 49 #define FIMC_ISP_MAX_PLANES 1 50 51 /** 52 * struct fimc_isp_frame - source/target frame properties 53 * @width: full image width 54 * @height: full image height 55 * @rect: crop/composition rectangle 56 */ 57 struct fimc_isp_frame { 58 u16 width; 59 u16 height; 60 struct v4l2_rect rect; 61 }; 62 63 struct fimc_isp_ctrls { 64 struct v4l2_ctrl_handler handler; 65 66 /* Auto white balance */ 67 struct v4l2_ctrl *auto_wb; 68 /* Auto ISO control cluster */ 69 struct { 70 struct v4l2_ctrl *auto_iso; 71 struct v4l2_ctrl *iso; 72 }; 73 /* Adjust - contrast */ 74 struct v4l2_ctrl *contrast; 75 /* Adjust - saturation */ 76 struct v4l2_ctrl *saturation; 77 /* Adjust - sharpness */ 78 struct v4l2_ctrl *sharpness; 79 /* Adjust - brightness */ 80 struct v4l2_ctrl *brightness; 81 /* Adjust - hue */ 82 struct v4l2_ctrl *hue; 83 84 /* Auto/manual exposure */ 85 struct v4l2_ctrl *auto_exp; 86 /* Manual exposure value */ 87 struct v4l2_ctrl *exposure; 88 /* AE/AWB lock/unlock */ 89 struct v4l2_ctrl *aewb_lock; 90 /* Exposure metering mode */ 91 struct v4l2_ctrl *exp_metering; 92 /* AFC */ 93 struct v4l2_ctrl *afc; 94 /* ISP image effect */ 95 struct v4l2_ctrl *colorfx; 96 }; 97 98 /** 99 * struct fimc_is_video - fimc-is video device structure 100 * @vdev: video_device structure 101 * @type: video device type (CAPTURE/OUTPUT) 102 * @pad: video device media (sink) pad 103 * @pending_buf_q: pending buffers queue head 104 * @active_buf_q: a queue head of buffers scheduled in hardware 105 * @vb_queue: vb2 buffer queue 106 * @active_buf_count: number of video buffers scheduled in hardware 107 * @frame_count: counter of frames dequeued to user space 108 * @reqbufs_count: number of buffers requested with REQBUFS ioctl 109 * @format: current pixel format 110 */ 111 struct fimc_is_video { 112 struct video_device vdev; 113 enum v4l2_buf_type type; 114 struct media_pad pad; 115 struct list_head pending_buf_q; 116 struct list_head active_buf_q; 117 struct vb2_queue vb_queue; 118 unsigned int frame_count; 119 unsigned int reqbufs_count; 120 int streaming; 121 unsigned long payload[FIMC_ISP_MAX_PLANES]; 122 const struct fimc_fmt *format; 123 }; 124 125 /** 126 * struct fimc_isp - FIMC-IS ISP data structure 127 * @pdev: pointer to FIMC-IS platform device 128 * @alloc_ctx: videobuf2 memory allocator context 129 * @subdev: ISP v4l2_subdev 130 * @subdev_pads: the ISP subdev media pads 131 * @ctrl_handler: v4l2 controls handler 132 * @test_pattern: test pattern controls 133 * @pipeline: video capture pipeline data structure 134 * @video_lock: mutex serializing video device and the subdev operations 135 * @fmt: pointer to color format description structure 136 * @payload: image size in bytes (w x h x bpp) 137 * @inp_frame: camera input frame structure 138 * @out_frame: DMA output frame structure 139 * @source_subdev_grp_id: group id of remote source subdev 140 * @cac_margin_x: horizontal CAC margin in pixels 141 * @cac_margin_y: vertical CAC margin in pixels 142 * @state: driver state flags 143 * @video_capture: the ISP block video capture device 144 */ 145 struct fimc_isp { 146 struct platform_device *pdev; 147 struct vb2_alloc_ctx *alloc_ctx; 148 struct v4l2_subdev subdev; 149 struct media_pad subdev_pads[FIMC_ISP_SD_PADS_NUM]; 150 struct v4l2_mbus_framefmt subdev_fmt; 151 struct v4l2_ctrl *test_pattern; 152 struct fimc_isp_ctrls ctrls; 153 154 struct mutex video_lock; 155 struct mutex subdev_lock; 156 157 struct fimc_isp_frame inp_frame; 158 struct fimc_isp_frame out_frame; 159 unsigned int source_subdev_grp_id; 160 161 unsigned int cac_margin_x; 162 unsigned int cac_margin_y; 163 164 unsigned long state; 165 166 struct fimc_is_video video_capture; 167 }; 168 169 #define ctrl_to_fimc_isp(_ctrl) \ 170 container_of(ctrl->handler, struct fimc_isp, ctrls.handler) 171 172 struct fimc_is; 173 174 int fimc_isp_subdev_create(struct fimc_isp *isp); 175 void fimc_isp_subdev_destroy(struct fimc_isp *isp); 176 void fimc_isp_irq_handler(struct fimc_is *is); 177 int fimc_is_create_controls(struct fimc_isp *isp); 178 int fimc_is_delete_controls(struct fimc_isp *isp); 179 const struct fimc_fmt *fimc_isp_find_format(const u32 *pixelformat, 180 const u32 *mbus_code, int index); 181 #endif /* FIMC_ISP_H_ */ 182