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 */ 57struct fimc_isp_frame { 58 u16 width; 59 u16 height; 60 struct v4l2_rect rect; 61}; 62 63struct 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 */ 111struct 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 */ 145struct 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 172struct fimc_is; 173 174int fimc_isp_subdev_create(struct fimc_isp *isp); 175void fimc_isp_subdev_destroy(struct fimc_isp *isp); 176void fimc_isp_irq_handler(struct fimc_is *is); 177int fimc_is_create_controls(struct fimc_isp *isp); 178int fimc_is_delete_controls(struct fimc_isp *isp); 179const struct fimc_fmt *fimc_isp_find_format(const u32 *pixelformat, 180 const u32 *mbus_code, int index); 181#endif /* FIMC_ISP_H_ */ 182