// SPDX-License-Identifier: GPL-2.0-only
/*
 * Samsung S5P/EXYNOS4 SoC series camera interface (camera capture) driver
 *
 * Copyright (C) 2010 - 2012 Samsung Electronics Co., Ltd.
 * Sylwester Nawrocki <s.nawrocki@samsung.com>
 */

#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/types.h>
#include <linux/errno.h>
#include <linux/bug.h>
#include <linux/interrupt.h>
#include <linux/device.h>
#include <linux/pm_runtime.h>
#include <linux/list.h>
#include <linux/slab.h>

#include <linux/videodev2.h>
#include <media/v4l2-device.h>
#include <media/v4l2-ioctl.h>
#include <media/v4l2-mem2mem.h>
#include <media/v4l2-rect.h>
#include <media/videobuf2-v4l2.h>
#include <media/videobuf2-dma-contig.h>

#include "common.h"
#include "fimc-core.h"
#include "fimc-reg.h"
#include "media-dev.h"

static int fimc_capture_hw_init(struct fimc_dev *fimc)
{
 struct fimc_source_info *si = &fimc->vid_cap.source_config;
 struct fimc_ctx *ctx = fimc->vid_cap.ctx;
 int ret;
 unsigned long flags;

 if (ctx == NULL || ctx->s_frame.fmt == NULL)
  return -EINVAL;

 if (si->fimc_bus_type == FIMC_BUS_TYPE_ISP_WRITEBACK) {
  ret = fimc_hw_camblk_cfg_writeback(fimc);
  if (ret < 0)
   return ret;
 }

 spin_lock_irqsave(&fimc->slock, flags);
 fimc_prepare_dma_offset(ctx, &ctx->d_frame);
 fimc_set_yuv_order(ctx);

 fimc_hw_set_camera_polarity(fimc, si);
 fimc_hw_set_camera_type(fimc, si);
 fimc_hw_set_camera_source(fimc, si);
 fimc_hw_set_camera_offset(fimc, &ctx->s_frame);

 ret = fimc_set_scaler_info(ctx);
 if (!ret) {
  fimc_hw_set_input_path(ctx);
  fimc_hw_set_prescaler(ctx);
  fimc_hw_set_mainscaler(ctx);
  fimc_hw_set_target_format(ctx);
  fimc_hw_set_rotation(ctx);
  fimc_hw_set_effect(ctx);
  fimc_hw_set_output_path(ctx);
  fimc_hw_set_out_dma(ctx);
  if (fimc->drv_data->alpha_color)
   fimc_hw_set_rgb_alpha(ctx);
  clear_bit(ST_CAPT_APPLY_CFG, &fimc->state);
 }
 spin_unlock_irqrestore(&fimc->slock, flags);
 return ret;
}

/*
 * Reinitialize the driver so it is ready to start the streaming again.
 * Set fimc->state to indicate stream off and the hardware shut down state.
 * If not suspending (@suspend is false), return any buffers to videobuf2.
 * Otherwise put any owned buffers onto the pending buffers queue, so they
 * can be re-spun when the device is being resumed. Also perform FIMC
 * software reset and disable streaming on the whole pipeline if required.
 */
static int fimc_capture_state_cleanup(struct fimc_dev *fimc, bool suspend)
{
 struct fimc_vid_cap *cap = &fimc->vid_cap;
 struct fimc_vid_buffer *buf;
 unsigned long flags;
 bool streaming;

 spin_lock_irqsave(&fimc->slock, flags);
 streaming = fimc->state & (1 << ST_CAPT_ISP_STREAM);

 fimc->state &= ~(1 << ST_CAPT_RUN | 1 << ST_CAPT_SHUT |
    1 << ST_CAPT_STREAM | 1 << ST_CAPT_ISP_STREAM);
 if (suspend)
  fimc->state |= (1 << ST_CAPT_SUSPENDED);
 else
  fimc->state &= ~(1 << ST_CAPT_PEND | 1 << ST_CAPT_SUSPENDED);

 /* Release unused buffers */
 while (!suspend && !list_empty(&cap->pending_buf_q)) {
  buf = fimc_pending_queue_pop(cap);
  vb2_buffer_done(&buf->vb.vb2_buf, VB2_BUF_STATE_ERROR);
 }
 /* If suspending put unused buffers onto pending queue */
 while (!list_empty(&cap->active_buf_q)) {
  buf = fimc_active_queue_pop(cap);
  if (suspend)
   fimc_pending_queue_add(cap, buf);
  else
   vb2_buffer_done(&buf->vb.vb2_buf, VB2_BUF_STATE_ERROR);
 }

 fimc_hw_reset(fimc);
 cap->buf_index = 0;

 spin_unlock_irqrestore(&fimc->slock, flags);

 if (streaming)
  return fimc_pipeline_call(&cap->ve, set_stream, 0);
 else
  return 0;
}

static int fimc_stop_capture(struct fimc_dev *fimc, bool suspend)
{
 unsigned long flags;

 if (!fimc_capture_active(fimc))
  return 0;

 spin_lock_irqsave(&fimc->slock, flags);
 set_bit(ST_CAPT_SHUT, &fimc->state);
 fimc_deactivate_capture(fimc);
 spin_unlock_irqrestore(&fimc->slock, flags);

 wait_event_timeout(fimc->irq_queue,
      !test_bit(ST_CAPT_SHUT, &fimc->state),
      (2*HZ/10)); /* 200 ms */

 return fimc_capture_state_cleanup(fimc, suspend);
}

/**
 * fimc_capture_config_update - apply the camera interface configuration
 * @ctx: FIMC capture context
 *
 * To be called from within the interrupt handler with fimc.slock
 * spinlock held. It updates the camera pixel crop, rotation and
 * image flip in H/W.
 */
static int fimc_capture_config_update(struct fimc_ctx *ctx)
{
 struct fimc_dev *fimc = ctx->fimc_dev;
 int ret;

 fimc_hw_set_camera_offset(fimc, &ctx->s_frame);

 ret = fimc_set_scaler_info(ctx);
 if (ret)
  return ret;

 fimc_hw_set_prescaler(ctx);
 fimc_hw_set_mainscaler(ctx);
 fimc_hw_set_target_format(ctx);
 fimc_hw_set_rotation(ctx);
 fimc_hw_set_effect(ctx);
 fimc_prepare_dma_offset(ctx, &ctx->d_frame);
 fimc_hw_set_out_dma(ctx);
 if (fimc->drv_data->alpha_color)
  fimc_hw_set_rgb_alpha(ctx);

 clear_bit(ST_CAPT_APPLY_CFG, &fimc->state);
 return ret;
}

void fimc_capture_irq_handler(struct fimc_dev *fimc, int deq_buf)
{
 struct fimc_vid_cap *cap = &fimc->vid_cap;
 struct fimc_pipeline *p = to_fimc_pipeline(cap->ve.pipe);
 struct v4l2_subdev *csis = p->subdevs[IDX_CSIS];
 const struct fimc_frame *f = &cap->ctx->d_frame;
 struct fimc_vid_buffer *v_buf;

 if (test_and_clear_bit(ST_CAPT_SHUT, &fimc->state)) {
  wake_up(&fimc->irq_queue);
  goto done;
 }

 if (!list_empty(&cap->active_buf_q) &&
     test_bit(ST_CAPT_RUN, &fimc->state) && deq_buf) {
  v_buf = fimc_active_queue_pop(cap);

  v_buf->vb.vb2_buf.timestamp = ktime_get_ns();
  v_buf->vb.sequence = cap->frame_count++;

  vb2_buffer_done(&v_buf->vb.vb2_buf, VB2_BUF_STATE_DONE);
 }

 if (!list_empty(&cap->pending_buf_q)) {

  v_buf = fimc_pending_queue_pop(cap);
  fimc_hw_set_output_addr(fimc, &v_buf->addr, cap->buf_index);
  v_buf->index = cap->buf_index;

  /* Move the buffer to the capture active queue */
  fimc_active_queue_add(cap, v_buf);

  dbg("next frame: %d, done frame: %d",
      fimc_hw_get_frame_index(fimc), v_buf->index);

  if (++cap->buf_index >= FIMC_MAX_OUT_BUFS)
   cap->buf_index = 0;
 }
 /*
  * Set up a buffer at MIPI-CSIS if current image format
  * requires the frame embedded data capture.
  */
 if (f->fmt->mdataplanes && !list_empty(&cap->active_buf_q)) {
  unsigned int plane = ffs(f->fmt->mdataplanes) - 1;
  unsigned int size = f->payload[plane];
  s32 index = fimc_hw_get_frame_index(fimc);
  void *vaddr;

  list_for_each_entry(v_buf, &cap->active_buf_q, list) {
   if (v_buf->index != index)
    continue;
   vaddr = vb2_plane_vaddr(&v_buf->vb.vb2_buf, plane);
   v4l2_subdev_call(csis, video, s_rx_buffer,
      vaddr, &size);
   break;
  }
 }

 if (cap->active_buf_cnt == 0) {
  if (deq_buf)
   clear_bit(ST_CAPT_RUN, &fimc->state);

  if (++cap->buf_index >= FIMC_MAX_OUT_BUFS)
   cap->buf_index = 0;
 } else {
  set_bit(ST_CAPT_RUN, &fimc->state);
 }

 if (test_bit(ST_CAPT_APPLY_CFG, &fimc->state))
  fimc_capture_config_update(cap->ctx);
done:
 if (cap->active_buf_cnt == 1) {
  fimc_deactivate_capture(fimc);
  clear_bit(ST_CAPT_STREAM, &fimc->state);
 }

 dbg("frame: %d, active_buf_cnt: %d",
     fimc_hw_get_frame_index(fimc), cap->active_buf_cnt);
}


static int start_streaming(struct vb2_queue *q, unsigned int count)
{
 struct fimc_ctx *ctx = q->drv_priv;
 struct fimc_dev *fimc = ctx->fimc_dev;
 struct fimc_vid_cap *vid_cap = &fimc->vid_cap;
 int min_bufs;
 int ret;

 vid_cap->frame_count = 0;

 ret = fimc_capture_hw_init(fimc);
 if (ret) {
  fimc_capture_state_cleanup(fimc, false);
  return ret;
 }

 set_bit(ST_CAPT_PEND, &fimc->state);

 min_bufs = fimc->vid_cap.reqbufs_count > 1 ? 2 : 1;

 if (vid_cap->active_buf_cnt >= min_bufs &&
     !test_and_set_bit(ST_CAPT_STREAM, &fimc->state)) {
  fimc_activate_capture(ctx);

  if (!test_and_set_bit(ST_CAPT_ISP_STREAM, &fimc->state))
   return fimc_pipeline_call(&vid_cap->ve, set_stream, 1);
 }

 return 0;
}

static void stop_streaming(struct vb2_queue *q)
{
 struct fimc_ctx *ctx = q->drv_priv;
 struct fimc_dev *fimc = ctx->fimc_dev;

 if (!fimc_capture_active(fimc))
  return;

 fimc_stop_capture(fimc, false);
}

int fimc_capture_suspend(struct fimc_dev *fimc)
{
 bool suspend = fimc_capture_busy(fimc);

 int ret = fimc_stop_capture(fimc, suspend);
 if (ret)
  return ret;
 return fimc_pipeline_call(&fimc->vid_cap.ve, close);
}

static void buffer_queue(struct vb2_buffer *vb);

int fimc_capture_resume(struct fimc_dev *fimc)
{
 struct fimc_vid_cap *vid_cap = &fimc->vid_cap;
 struct exynos_video_entity *ve = &vid_cap->ve;
 struct fimc_vid_buffer *buf;
 int i;

 if (!test_and_clear_bit(ST_CAPT_SUSPENDED, &fimc->state))
  return 0;

 INIT_LIST_HEAD(&fimc->vid_cap.active_buf_q);
 vid_cap->buf_index = 0;
 fimc_pipeline_call(ve, open, &ve->vdev.entity, false);
 fimc_capture_hw_init(fimc);

 clear_bit(ST_CAPT_SUSPENDED, &fimc->state);

 for (i = 0; i < vid_cap->reqbufs_count; i++) {
  if (list_empty(&vid_cap->pending_buf_q))
   break;
  buf = fimc_pending_queue_pop(vid_cap);
  buffer_queue(&buf->vb.vb2_buf);
 }
 return 0;

}

static int queue_setup(struct vb2_queue *vq,
         unsigned int *num_buffers, unsigned int *num_planes,
         unsigned int sizes[], struct device *alloc_devs[])
{
 struct fimc_ctx *ctx = vq->drv_priv;
 const struct fimc_frame *frame = &ctx->d_frame;
 const struct fimc_fmt *fmt = frame->fmt;
 unsigned long wh = frame->f_width * frame->f_height;
 int i;

 if (fmt == NULL)
  return -EINVAL;

 if (*num_planes) {
  if (*num_planes != fmt->memplanes)
   return -EINVAL;
  for (i = 0; i < *num_planes; i++)
   if (sizes[i] < (wh * fmt->depth[i]) / 8)
    return -EINVAL;
  return 0;
 }

 *num_planes = fmt->memplanes;

 for (i = 0; i < fmt->memplanes; i++) {
  unsigned int size = (wh * fmt->depth[i]) / 8;

  if (fimc_fmt_is_user_defined(fmt->color))
   sizes[i] = frame->payload[i];
  else
   sizes[i] = max_t(u32, size, frame->payload[i]);
 }

 return 0;
}

static int buffer_prepare(struct vb2_buffer *vb)
{
 struct vb2_queue *vq = vb->vb2_queue;
 struct fimc_ctx *ctx = vq->drv_priv;
 int i;

 if (ctx->d_frame.fmt == NULL)
  return -EINVAL;

 for (i = 0; i < ctx->d_frame.fmt->memplanes; i++) {
  unsigned long size = ctx->d_frame.payload[i];

  if (vb2_plane_size(vb, i) < size) {
   v4l2_err(&ctx->fimc_dev->vid_cap.ve.vdev,
     "User buffer too small (%ld < %ld)\n",
     vb2_plane_size(vb, i), size);
   return -EINVAL;
  }
  vb2_set_plane_payload(vb, i, size);
 }

 return 0;
}

static void buffer_queue(struct vb2_buffer *vb)
{
 struct vb2_v4l2_buffer *vbuf = to_vb2_v4l2_buffer(vb);
 struct fimc_vid_buffer *buf
  = container_of(vbuf, struct fimc_vid_buffer, vb);
 struct fimc_ctx *ctx = vb2_get_drv_priv(vb->vb2_queue);
 struct fimc_dev *fimc = ctx->fimc_dev;
 struct fimc_vid_cap *vid_cap = &fimc->vid_cap;
 struct exynos_video_entity *ve = &vid_cap->ve;
 unsigned long flags;
 int min_bufs;

 spin_lock_irqsave(&fimc->slock, flags);
 fimc_prepare_addr(ctx, &buf->vb.vb2_buf, &ctx->d_frame, &buf->addr);

 if (!test_bit(ST_CAPT_SUSPENDED, &fimc->state) &&
     !test_bit(ST_CAPT_STREAM, &fimc->state) &&
     vid_cap->active_buf_cnt < FIMC_MAX_OUT_BUFS) {
  /* Setup the buffer directly for processing. */
  int buf_id = (vid_cap->reqbufs_count == 1) ? -1 :
    vid_cap->buf_index;

  fimc_hw_set_output_addr(fimc, &buf->addr, buf_id);
  buf->index = vid_cap->buf_index;
  fimc_active_queue_add(vid_cap, buf);

  if (++vid_cap->buf_index >= FIMC_MAX_OUT_BUFS)
   vid_cap->buf_index = 0;
 } else {
  fimc_pending_queue_add(vid_cap, buf);
 }

 min_bufs = vid_cap->reqbufs_count > 1 ? 2 : 1;


 if (vb2_is_streaming(&vid_cap->vbq) &&
     vid_cap->active_buf_cnt >= min_bufs &&
     !test_and_set_bit(ST_CAPT_STREAM, &fimc->state)) {
  int ret;

  fimc_activate_capture(ctx);
  spin_unlock_irqrestore(&fimc->slock, flags);

  if (test_and_set_bit(ST_CAPT_ISP_STREAM, &fimc->state))
   return;

  ret = fimc_pipeline_call(ve, set_stream, 1);
  if (ret < 0)
   v4l2_err(&ve->vdev, "stream on failed: %d\n", ret);
  return;
 }
 spin_unlock_irqrestore(&fimc->slock, flags);
}

static const struct vb2_ops fimc_capture_qops = {
 .queue_setup  = queue_setup,
 .buf_prepare  = buffer_prepare,
 .buf_queue  = buffer_queue,
 .start_streaming = start_streaming,
 .stop_streaming  = stop_streaming,
};

static int fimc_capture_set_default_format(struct fimc_dev *fimc);

static int fimc_capture_open(struct file *file)
{
 struct fimc_dev *fimc = video_drvdata(file);
 struct fimc_vid_cap *vc = &fimc->vid_cap;
 struct exynos_video_entity *ve = &vc->ve;
 int ret = -EBUSY;

 dbg("pid: %d, state: 0x%lx", task_pid_nr(current), fimc->state);

 mutex_lock(&fimc->lock);

 if (fimc_m2m_active(fimc))
  goto unlock;

 set_bit(ST_CAPT_BUSY, &fimc->state);
 ret = pm_runtime_resume_and_get(&fimc->pdev->dev);
 if (ret < 0)
  goto unlock;

 ret = v4l2_fh_open(file);
 if (ret) {
  pm_runtime_put_sync(&fimc->pdev->dev);
  goto unlock;
 }

 if (v4l2_fh_is_singular_file(file)) {
  fimc_md_graph_lock(ve);

  ret = fimc_pipeline_call(ve, open, &ve->vdev.entity, true);

  if (ret == 0)
   ve->vdev.entity.use_count++;

  fimc_md_graph_unlock(ve);

  if (ret == 0)
   ret = fimc_capture_set_default_format(fimc);

  if (ret < 0) {
   clear_bit(ST_CAPT_BUSY, &fimc->state);
   pm_runtime_put_sync(&fimc->pdev->dev);
   v4l2_fh_release(file);
  }
 }
unlock:
 mutex_unlock(&fimc->lock);
 return ret;
}

static int fimc_capture_release(struct file *file)
{
 struct fimc_dev *fimc = video_drvdata(file);
 struct fimc_vid_cap *vc = &fimc->vid_cap;
 bool close = v4l2_fh_is_singular_file(file);
 int ret;

 dbg("pid: %d, state: 0x%lx", task_pid_nr(current), fimc->state);

 mutex_lock(&fimc->lock);

 if (close && vc->streaming) {
  video_device_pipeline_stop(&vc->ve.vdev);
  vc->streaming = false;
 }

 ret = _vb2_fop_release(file, NULL);

 if (close) {
  clear_bit(ST_CAPT_BUSY, &fimc->state);
  fimc_pipeline_call(&vc->ve, close);
  clear_bit(ST_CAPT_SUSPENDED, &fimc->state);

  fimc_md_graph_lock(&vc->ve);
  vc->ve.vdev.entity.use_count--;
  fimc_md_graph_unlock(&vc->ve);
 }

 pm_runtime_put_sync(&fimc->pdev->dev);
 mutex_unlock(&fimc->lock);

 return ret;
}

static const struct v4l2_file_operations fimc_capture_fops = {
 .owner  = THIS_MODULE,
 .open  = fimc_capture_open,
 .release = fimc_capture_release,
 .poll  = vb2_fop_poll,
 .unlocked_ioctl = video_ioctl2,
 .mmap  = vb2_fop_mmap,
};

/*
 * Format and crop negotiation helpers
 */

static const struct fimc_fmt *fimc_capture_try_format(struct fimc_ctx *ctx,
            u32 *width, u32 *height,
            u32 *code, u32 *fourcc, int pad)
{
 bool rotation = ctx->rotation == 90 || ctx->rotation == 270;
 struct fimc_dev *fimc = ctx->fimc_dev;
 const struct fimc_variant *var = fimc->variant;
 const struct fimc_pix_limit *pl = var->pix_limit;
 const struct fimc_frame *dst = &ctx->d_frame;
 u32 depth, min_w, max_w, min_h, align_h = 3;
 const struct fimc_fmt *ffmt;
 u32 mask = FMT_FLAGS_CAM;

 /* Conversion from/to JPEG or User Defined format is not supported */
 if (code && ctx->s_frame.fmt && pad == FIMC_SD_PAD_SOURCE &&
     fimc_fmt_is_user_defined(ctx->s_frame.fmt->color))
  *code = ctx->s_frame.fmt->mbus_code;

 if (fourcc && *fourcc != V4L2_PIX_FMT_JPEG && pad == FIMC_SD_PAD_SOURCE)
  mask |= FMT_FLAGS_M2M;

 if (pad == FIMC_SD_PAD_SINK_FIFO)
  mask = FMT_FLAGS_WRITEBACK;

 ffmt = fimc_find_format(fourcc, code, mask, 0);
 if (WARN_ON(!ffmt))
  return NULL;

 if (code)
  *code = ffmt->mbus_code;
 if (fourcc)
  *fourcc = ffmt->fourcc;

 if (pad != FIMC_SD_PAD_SOURCE) {
  max_w = fimc_fmt_is_user_defined(ffmt->color) ?
   pl->scaler_dis_w : pl->scaler_en_w;
  /* Apply the camera input interface pixel constraints */
  v4l_bound_align_image(width, max_t(u32, *width, 32), max_w, 4,
          height, max_t(u32, *height, 32),
          FIMC_CAMIF_MAX_HEIGHT,
          fimc_fmt_is_user_defined(ffmt->color) ?
          3 : 1,
          0);
  return ffmt;
 }
 /* Can't scale or crop in transparent (JPEG) transfer mode */
 if (fimc_fmt_is_user_defined(ffmt->color)) {
  *width  = ctx->s_frame.f_width;
  *height = ctx->s_frame.f_height;
  return ffmt;
 }
 /* Apply the scaler and the output DMA constraints */
 max_w = rotation ? pl->out_rot_en_w : pl->out_rot_dis_w;
 if (ctx->state & FIMC_COMPOSE) {
  min_w = dst->offs_h + dst->width;
  min_h = dst->offs_v + dst->height;
 } else {
  min_w = var->min_out_pixsize;
  min_h = var->min_out_pixsize;
 }
 if (var->min_vsize_align == 1 && !rotation)
  align_h = fimc_fmt_is_rgb(ffmt->color) ? 0 : 1;

 depth = fimc_get_format_depth(ffmt);
 v4l_bound_align_image(width, min_w, max_w,
         ffs(var->min_out_pixsize) - 1,
         height, min_h, FIMC_CAMIF_MAX_HEIGHT,
         align_h,
         64/(ALIGN(depth, 8)));

 dbg("pad%d: code: 0x%x, %dx%d. dst fmt: %dx%d",
     pad, code ? *code : 0, *width, *height,
     dst->f_width, dst->f_height);

 return ffmt;
}

static void fimc_capture_try_selection(struct fimc_ctx *ctx,
           struct v4l2_rect *r,
           int target)
{
 bool rotate = ctx->rotation == 90 || ctx->rotation == 270;
 struct fimc_dev *fimc = ctx->fimc_dev;
 const struct fimc_variant *var = fimc->variant;
 const struct fimc_pix_limit *pl = var->pix_limit;
 const struct fimc_frame *sink = &ctx->s_frame;
 u32 max_w, max_h, min_w = 0, min_h = 0, min_sz;
 u32 align_sz = 0, align_h = 4;
 u32 max_sc_h, max_sc_v;

 /* In JPEG transparent transfer mode cropping is not supported */
 if (fimc_fmt_is_user_defined(ctx->d_frame.fmt->color)) {
  r->width  = sink->f_width;
  r->height = sink->f_height;
  r->left   = r->top = 0;
  return;
 }
 if (target == V4L2_SEL_TGT_COMPOSE) {
  u32 tmp_min_h = ffs(sink->width) - 3;
  u32 tmp_min_v = ffs(sink->height) - 1;

  if (ctx->rotation != 90 && ctx->rotation != 270)
   align_h = 1;
  max_sc_h = min(SCALER_MAX_HRATIO, 1 << tmp_min_h);
  max_sc_v = min(SCALER_MAX_VRATIO, 1 << tmp_min_v);
  min_sz = var->min_out_pixsize;
 } else {
  u32 depth = fimc_get_format_depth(sink->fmt);
  align_sz = 64/ALIGN(depth, 8);
  min_sz = var->min_inp_pixsize;
  min_w = min_h = min_sz;
  max_sc_h = max_sc_v = 1;
 }
 /*
  * For the compose rectangle the following constraints must be met:
  * - it must fit in the sink pad format rectangle (f_width/f_height);
  * - maximum downscaling ratio is 64;
  * - maximum crop size depends if the rotator is used or not;
  * - the sink pad format width/height must be 4 multiple of the
  *   prescaler ratios determined by sink pad size and source pad crop,
  *   the prescaler ratio is returned by fimc_get_scaler_factor().
  */
 max_w = min_t(u32,
        rotate ? pl->out_rot_en_w : pl->out_rot_dis_w,
        rotate ? sink->f_height : sink->f_width);
 max_h = min_t(u32, FIMC_CAMIF_MAX_HEIGHT, sink->f_height);

 if (target == V4L2_SEL_TGT_COMPOSE) {
  min_w = min_t(u32, max_w, sink->f_width / max_sc_h);
  min_h = min_t(u32, max_h, sink->f_height / max_sc_v);
  if (rotate) {
   swap(max_sc_h, max_sc_v);
   swap(min_w, min_h);
  }
 }
 v4l_bound_align_image(&r->width, min_w, max_w, ffs(min_sz) - 1,
         &r->height, min_h, max_h, align_h,
         align_sz);
 /* Adjust left/top if crop/compose rectangle is out of bounds */
 r->left = clamp_t(u32, r->left, 0, sink->f_width - r->width);
 r->top  = clamp_t(u32, r->top, 0, sink->f_height - r->height);
 r->left = round_down(r->left, var->hor_offs_align);

 dbg("target %#x: (%d,%d)/%ux%u, sink fmt: %dx%d",
     target, r->left, r->top, r->width, r->height,
     sink->f_width, sink->f_height);
}

/*
 * The video node ioctl operations
 */
static int fimc_cap_querycap(struct file *file, void *priv,
     struct v4l2_capability *cap)
{
 struct fimc_dev *fimc = video_drvdata(file);

 __fimc_vidioc_querycap(&fimc->pdev->dev, cap);
 return 0;
}

static int fimc_cap_enum_fmt(struct file *file, void *priv,
        struct v4l2_fmtdesc *f)
{
 const struct fimc_fmt *fmt;

 fmt = fimc_find_format(NULL, NULL, FMT_FLAGS_CAM | FMT_FLAGS_M2M,
          f->index);
 if (!fmt)
  return -EINVAL;
 f->pixelformat = fmt->fourcc;
 return 0;
}

static struct media_entity *fimc_pipeline_get_head(struct media_entity *me)
{
 struct media_pad *pad = &me->pads[0];

 while (!(pad->flags & MEDIA_PAD_FL_SOURCE)) {
  pad = media_pad_remote_pad_first(pad);
  if (!pad)
   break;
  me = pad->entity;
  pad = &me->pads[0];
 }

 return me;
}

/**
 * fimc_pipeline_try_format - negotiate and/or set formats at pipeline
 *                            elements
 * @ctx: FIMC capture context
 * @tfmt: media bus format to try/set on subdevs
 * @fmt_id: fimc pixel format id corresponding to returned @tfmt (output)
 * @set: true to set format on subdevs, false to try only
 */
static int fimc_pipeline_try_format(struct fimc_ctx *ctx,
        struct v4l2_mbus_framefmt *tfmt,
        const struct fimc_fmt **fmt_id,
        bool set)
{
 struct fimc_dev *fimc = ctx->fimc_dev;
 struct fimc_pipeline *p = to_fimc_pipeline(fimc->vid_cap.ve.pipe);
 struct v4l2_subdev *sd = p->subdevs[IDX_SENSOR];
 struct v4l2_subdev_format sfmt = {
  .which = set ? V4L2_SUBDEV_FORMAT_ACTIVE
         : V4L2_SUBDEV_FORMAT_TRY,
 };
 struct v4l2_mbus_framefmt *mf = &sfmt.format;
 const struct fimc_fmt *ffmt;
 struct media_entity *me;
 struct media_pad *pad;
 int ret, i = 1;
 u32 fcc;

 if (WARN_ON(!sd || !tfmt))
  return -EINVAL;

 sfmt.format = *tfmt;

 me = fimc_pipeline_get_head(&sd->entity);

 while (1) {
  ffmt = fimc_find_format(NULL, mf->code != 0 ? &mf->code : NULL,
     FMT_FLAGS_CAM, i++);
  if (ffmt == NULL) {
   /*
    * Notify user-space if common pixel code for
    * host and sensor does not exist.
    */
   return -EINVAL;
  }
  mf->code = tfmt->code = ffmt->mbus_code;

  /* set format on all pipeline subdevs */
  while (me != &fimc->vid_cap.subdev.entity) {
   sd = media_entity_to_v4l2_subdev(me);

   sfmt.pad = 0;
   ret = v4l2_subdev_call(sd, pad, set_fmt, NULL, &sfmt);
   if (ret)
    return ret;

   if (me->pads[0].flags & MEDIA_PAD_FL_SINK) {
    sfmt.pad = me->num_pads - 1;
    mf->code = tfmt->code;
    ret = v4l2_subdev_call(sd, pad, set_fmt, NULL,
         &sfmt);
    if (ret)
     return ret;
   }

   pad = media_pad_remote_pad_first(&me->pads[sfmt.pad]);
   if (!pad)
    return -EINVAL;
   me = pad->entity;
  }

  if (mf->code != tfmt->code)
   continue;

  fcc = ffmt->fourcc;
  tfmt->width  = mf->width;
  tfmt->height = mf->height;
  ffmt = fimc_capture_try_format(ctx, &tfmt->width, &tfmt->height,
     NULL, &fcc, FIMC_SD_PAD_SINK_CAM);
  ffmt = fimc_capture_try_format(ctx, &tfmt->width, &tfmt->height,
     NULL, &fcc, FIMC_SD_PAD_SOURCE);
  if (ffmt && ffmt->mbus_code)
   mf->code = ffmt->mbus_code;
  if (mf->width != tfmt->width || mf->height != tfmt->height)
   continue;
  tfmt->code = mf->code;
  break;
 }

 if (fmt_id && ffmt)
  *fmt_id = ffmt;
 *tfmt = *mf;

 return 0;
}

/**
 * fimc_get_sensor_frame_desc - query the sensor for media bus frame parameters
 * @sensor: pointer to the sensor subdev
 * @plane_fmt: provides plane sizes corresponding to the frame layout entries
 * @num_planes: number of planes
 * @try: true to set the frame parameters, false to query only
 *
 * This function is used by this driver only for compressed/blob data formats.
 */
static int fimc_get_sensor_frame_desc(struct v4l2_subdev *sensor,
          struct v4l2_plane_pix_format *plane_fmt,
          unsigned int num_planes, bool try)
{
 struct v4l2_mbus_frame_desc fd = { };
 int i, ret;
 int pad;

 for (i = 0; i < num_planes; i++)
  fd.entry[i].length = plane_fmt[i].sizeimage;

 pad = sensor->entity.num_pads - 1;
 if (try)
  ret = v4l2_subdev_call(sensor, pad, set_frame_desc, pad, &fd);
 else
  ret = v4l2_subdev_call(sensor, pad, get_frame_desc, pad, &fd);

 if (ret < 0)
  return ret;

 if (num_planes != fd.num_entries)
  return -EINVAL;

 for (i = 0; i < num_planes; i++)
  plane_fmt[i].sizeimage = fd.entry[i].length;

 if (fd.entry[0].length > FIMC_MAX_JPEG_BUF_SIZE) {
  v4l2_err(sensor->v4l2_dev,  "Unsupported buffer size: %u\n",
    fd.entry[0].length);

  return -EINVAL;
 }

 return 0;
}

static int fimc_cap_g_fmt_mplane(struct file *file, void *fh,
     struct v4l2_format *f)
{
 struct fimc_dev *fimc = video_drvdata(file);

 __fimc_get_format(&fimc->vid_cap.ctx->d_frame, f);
 return 0;
}

/*
 * Try or set format on the fimc.X.capture video node and additionally
 * on the whole pipeline if @try is false.
 * Locking: the caller must _not_ hold the graph mutex.
 */
static int __video_try_or_set_format(struct fimc_dev *fimc,
         struct v4l2_format *f, bool try,
         const struct fimc_fmt **inp_fmt,
         const struct fimc_fmt **out_fmt)
{
 struct v4l2_pix_format_mplane *pix = &f->fmt.pix_mp;
 struct fimc_vid_cap *vc = &fimc->vid_cap;
 struct exynos_video_entity *ve = &vc->ve;
 struct fimc_ctx *ctx = vc->ctx;
 unsigned int width = 0, height = 0;
 int ret = 0;

 /* Pre-configure format at the camera input interface, for JPEG only */
 if (fimc_jpeg_fourcc(pix->pixelformat)) {
  fimc_capture_try_format(ctx, &pix->width, &pix->height,
     NULL, &pix->pixelformat,
     FIMC_SD_PAD_SINK_CAM);
  if (try) {
   width = pix->width;
   height = pix->height;
  } else {
   ctx->s_frame.f_width = pix->width;
   ctx->s_frame.f_height = pix->height;
  }
 }

 /* Try the format at the scaler and the DMA output */
 *out_fmt = fimc_capture_try_format(ctx, &pix->width, &pix->height,
       NULL, &pix->pixelformat,
       FIMC_SD_PAD_SOURCE);
 if (*out_fmt == NULL)
  return -EINVAL;

 /* Restore image width/height for JPEG (no resizing supported). */
 if (try && fimc_jpeg_fourcc(pix->pixelformat)) {
  pix->width = width;
  pix->height = height;
 }

 /* Try to match format at the host and the sensor */
 if (!vc->user_subdev_api) {
  struct v4l2_mbus_framefmt mbus_fmt;
  struct v4l2_mbus_framefmt *mf;

  mf = try ? &mbus_fmt : &fimc->vid_cap.ci_fmt;

  mf->code = (*out_fmt)->mbus_code;
  mf->width = pix->width;
  mf->height = pix->height;

  fimc_md_graph_lock(ve);
  ret = fimc_pipeline_try_format(ctx, mf, inp_fmt, try);
  fimc_md_graph_unlock(ve);

  if (ret < 0)
   return ret;

  pix->width = mf->width;
  pix->height = mf->height;
 }

 fimc_adjust_mplane_format(*out_fmt, pix->width, pix->height, pix);

 if ((*out_fmt)->flags & FMT_FLAGS_COMPRESSED) {
  struct v4l2_subdev *sensor;

  fimc_md_graph_lock(ve);

  sensor = __fimc_md_get_subdev(ve->pipe, IDX_SENSOR);
  if (sensor)
   fimc_get_sensor_frame_desc(sensor, pix->plane_fmt,
         (*out_fmt)->memplanes, try);
  else
   ret = -EPIPE;

  fimc_md_graph_unlock(ve);
 }

 return ret;
}

static int fimc_cap_try_fmt_mplane(struct file *file, void *fh,
       struct v4l2_format *f)
{
 struct fimc_dev *fimc = video_drvdata(file);
 const struct fimc_fmt *out_fmt = NULL, *inp_fmt = NULL;

 return __video_try_or_set_format(fimc, f, true, &inp_fmt, &out_fmt);
}

static void fimc_capture_mark_jpeg_xfer(struct fimc_ctx *ctx,
     enum fimc_color_fmt color)
{
 bool jpeg = fimc_fmt_is_user_defined(color);

 ctx->scaler.enabled = !jpeg;
 fimc_ctrls_activate(ctx, !jpeg);

 if (jpeg)
  set_bit(ST_CAPT_JPEG, &ctx->fimc_dev->state);
 else
  clear_bit(ST_CAPT_JPEG, &ctx->fimc_dev->state);
}

static int __fimc_capture_set_format(struct fimc_dev *fimc,
         struct v4l2_format *f)
{
 struct fimc_vid_cap *vc = &fimc->vid_cap;
 struct fimc_ctx *ctx = vc->ctx;
 const struct v4l2_pix_format_mplane *pix = &f->fmt.pix_mp;
 struct fimc_frame *ff = &ctx->d_frame;
 const struct fimc_fmt *inp_fmt = NULL;
 int ret, i;

 if (vb2_is_busy(&fimc->vid_cap.vbq))
  return -EBUSY;

 ret = __video_try_or_set_format(fimc, f, false, &inp_fmt, &ff->fmt);
 if (ret < 0)
  return ret;

 /* Update RGB Alpha control state and value range */
 fimc_alpha_ctrl_update(ctx);

 for (i = 0; i < ff->fmt->memplanes; i++) {
  ff->bytesperline[i] = pix->plane_fmt[i].bytesperline;
  ff->payload[i] = pix->plane_fmt[i].sizeimage;
 }

 set_frame_bounds(ff, pix->width, pix->height);
 /* Reset the composition rectangle if not yet configured */
 if (!(ctx->state & FIMC_COMPOSE))
  set_frame_crop(ff, 0, 0, pix->width, pix->height);

 fimc_capture_mark_jpeg_xfer(ctx, ff->fmt->color);

 /* Reset cropping and set format at the camera interface input */
 if (!vc->user_subdev_api) {
  ctx->s_frame.fmt = inp_fmt;
  set_frame_bounds(&ctx->s_frame, pix->width, pix->height);
  set_frame_crop(&ctx->s_frame, 0, 0, pix->width, pix->height);
 }

 return ret;
}

static int fimc_cap_s_fmt_mplane(struct file *file, void *priv,
     struct v4l2_format *f)
{
 struct fimc_dev *fimc = video_drvdata(file);

 return __fimc_capture_set_format(fimc, f);
}

static int fimc_cap_enum_input(struct file *file, void *priv,
          struct v4l2_input *i)
{
 struct fimc_dev *fimc = video_drvdata(file);
 struct exynos_video_entity *ve = &fimc->vid_cap.ve;
 struct v4l2_subdev *sd;

 if (i->index != 0)
  return -EINVAL;

 i->type = V4L2_INPUT_TYPE_CAMERA;
 fimc_md_graph_lock(ve);
 sd = __fimc_md_get_subdev(ve->pipe, IDX_SENSOR);
 fimc_md_graph_unlock(ve);

 if (sd)
  strscpy(i->name, sd->name, sizeof(i->name));

 return 0;
}

static int fimc_cap_s_input(struct file *file, void *priv, unsigned int i)
{
 return i == 0 ? i : -EINVAL;
}

static int fimc_cap_g_input(struct file *file, void *priv, unsigned int *i)
{
 *i = 0;
 return 0;
}

/**
 * fimc_pipeline_validate - check for formats inconsistencies
 *                          between source and sink pad of each link
 * @fimc: the FIMC device this context applies to
 *
 * Return 0 if all formats match or -EPIPE otherwise.
 */
static int fimc_pipeline_validate(struct fimc_dev *fimc)
{
 struct v4l2_subdev_format sink_fmt = {
  .which = V4L2_SUBDEV_FORMAT_ACTIVE,
 };
 struct v4l2_subdev_format src_fmt = {
  .which = V4L2_SUBDEV_FORMAT_ACTIVE,
 };
 struct fimc_vid_cap *vc = &fimc->vid_cap;
 struct v4l2_subdev *sd = &vc->subdev;
 struct fimc_pipeline *p = to_fimc_pipeline(vc->ve.pipe);
 struct media_pad *sink_pad, *src_pad;
 int i, ret;

 while (1) {
  /*
   * Find current entity sink pad and any remote sink pad linked
   * to it. We stop if there is no sink pad in current entity or
   * it is not linked to any other remote entity.
   */
  src_pad = NULL;

  for (i = 0; i < sd->entity.num_pads; i++) {
   struct media_pad *p = &sd->entity.pads[i];

   if (p->flags & MEDIA_PAD_FL_SINK) {
    sink_pad = p;
    src_pad = media_pad_remote_pad_first(sink_pad);
    if (src_pad)
     break;
   }
  }

  if (!src_pad || !is_media_entity_v4l2_subdev(src_pad->entity))
   break;

  /* Don't call FIMC subdev operation to avoid nested locking */
  if (sd == &vc->subdev) {
   const struct fimc_frame *ff = &vc->ctx->s_frame;
   sink_fmt.format.width = ff->f_width;
   sink_fmt.format.height = ff->f_height;
   sink_fmt.format.code = ff->fmt ? ff->fmt->mbus_code : 0;
  } else {
   sink_fmt.pad = sink_pad->index;
   ret = v4l2_subdev_call(sd, pad, get_fmt, NULL, &sink_fmt);
   if (ret < 0 && ret != -ENOIOCTLCMD)
    return -EPIPE;
  }

  /* Retrieve format at the source pad */
  sd = media_entity_to_v4l2_subdev(src_pad->entity);
  src_fmt.pad = src_pad->index;
  ret = v4l2_subdev_call(sd, pad, get_fmt, NULL, &src_fmt);
  if (ret < 0 && ret != -ENOIOCTLCMD)
   return -EPIPE;

  if (src_fmt.format.width != sink_fmt.format.width ||
      src_fmt.format.height != sink_fmt.format.height ||
      src_fmt.format.code != sink_fmt.format.code)
   return -EPIPE;

  if (sd == p->subdevs[IDX_SENSOR] &&
      fimc_user_defined_mbus_fmt(src_fmt.format.code)) {
   struct v4l2_plane_pix_format plane_fmt[FIMC_MAX_PLANES];
   const struct fimc_frame *frame = &vc->ctx->d_frame;
   unsigned int i;

   ret = fimc_get_sensor_frame_desc(sd, plane_fmt,
        frame->fmt->memplanes,
        false);
   if (ret < 0)
    return -EPIPE;

   for (i = 0; i < frame->fmt->memplanes; i++)
    if (frame->payload[i] < plane_fmt[i].sizeimage)
     return -EPIPE;
  }
 }
 return 0;
}

static int fimc_cap_streamon(struct file *file, void *priv,
        enum v4l2_buf_type type)
{
 struct fimc_dev *fimc = video_drvdata(file);
 struct fimc_vid_cap *vc = &fimc->vid_cap;
 struct fimc_source_info *si = NULL;
 struct v4l2_subdev *sd;
 int ret;

 if (fimc_capture_active(fimc))
  return -EBUSY;

 ret = video_device_pipeline_start(&vc->ve.vdev, &vc->ve.pipe->mp);
 if (ret < 0)
  return ret;

 sd = __fimc_md_get_subdev(vc->ve.pipe, IDX_SENSOR);
 if (sd)
  si = v4l2_get_subdev_hostdata(sd);

 if (si == NULL) {
  ret = -EPIPE;
  goto err_p_stop;
 }
 /*
  * Save configuration data related to currently attached image
  * sensor or other data source, e.g. FIMC-IS.
  */
 vc->source_config = *si;

 if (vc->input == GRP_ID_FIMC_IS)
  vc->source_config.fimc_bus_type = FIMC_BUS_TYPE_ISP_WRITEBACK;

 if (vc->user_subdev_api) {
  ret = fimc_pipeline_validate(fimc);
  if (ret < 0)
   goto err_p_stop;
 }

 ret = vb2_ioctl_streamon(file, priv, type);
 if (!ret) {
  vc->streaming = true;
  return ret;
 }

err_p_stop:
 video_device_pipeline_stop(&vc->ve.vdev);
 return ret;
}

static int fimc_cap_streamoff(struct file *file, void *priv,
       enum v4l2_buf_type type)
{
 struct fimc_dev *fimc = video_drvdata(file);
 struct fimc_vid_cap *vc = &fimc->vid_cap;
 int ret;

 ret = vb2_ioctl_streamoff(file, priv, type);
 if (ret < 0)
  return ret;

 if (vc->streaming) {
  video_device_pipeline_stop(&vc->ve.vdev);
  vc->streaming = false;
 }

 return 0;
}

static int fimc_cap_reqbufs(struct file *file, void *priv,
       struct v4l2_requestbuffers *reqbufs)
{
 struct fimc_dev *fimc = video_drvdata(file);
 int ret;

 ret = vb2_ioctl_reqbufs(file, priv, reqbufs);

 if (!ret)
  fimc->vid_cap.reqbufs_count = reqbufs->count;

 return ret;
}

static int fimc_cap_g_selection(struct file *file, void *fh,
    struct v4l2_selection *s)
{
 struct fimc_dev *fimc = video_drvdata(file);
 struct fimc_ctx *ctx = fimc->vid_cap.ctx;
 const struct fimc_frame *f = &ctx->s_frame;

 if (s->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
  return -EINVAL;

 switch (s->target) {
 case V4L2_SEL_TGT_COMPOSE_DEFAULT:
 case V4L2_SEL_TGT_COMPOSE_BOUNDS:
  f = &ctx->d_frame;
  fallthrough;
 case V4L2_SEL_TGT_CROP_BOUNDS:
 case V4L2_SEL_TGT_CROP_DEFAULT:
  s->r.left = 0;
  s->r.top = 0;
  s->r.width = f->o_width;
  s->r.height = f->o_height;
  return 0;

 case V4L2_SEL_TGT_COMPOSE:
  f = &ctx->d_frame;
  fallthrough;
 case V4L2_SEL_TGT_CROP:
  s->r.left = f->offs_h;
  s->r.top = f->offs_v;
  s->r.width = f->width;
  s->r.height = f->height;
  return 0;
 }

 return -EINVAL;
}

static int fimc_cap_s_selection(struct file *file, void *fh,
    struct v4l2_selection *s)
{
 struct fimc_dev *fimc = video_drvdata(file);
 struct fimc_ctx *ctx = fimc->vid_cap.ctx;
 struct v4l2_rect rect = s->r;
 struct fimc_frame *f;
 unsigned long flags;

 if (s->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
  return -EINVAL;

 if (s->target == V4L2_SEL_TGT_COMPOSE)
  f = &ctx->d_frame;
 else if (s->target == V4L2_SEL_TGT_CROP)
  f = &ctx->s_frame;
 else
  return -EINVAL;

 fimc_capture_try_selection(ctx, &rect, s->target);

 if (s->flags & V4L2_SEL_FLAG_LE &&
     !v4l2_rect_enclosed(&rect, &s->r))
  return -ERANGE;

 if (s->flags & V4L2_SEL_FLAG_GE &&
     !v4l2_rect_enclosed(&s->r, &rect))
  return -ERANGE;

 s->r = rect;
 spin_lock_irqsave(&fimc->slock, flags);
 set_frame_crop(f, s->r.left, s->r.top, s->r.width,
         s->r.height);
 spin_unlock_irqrestore(&fimc->slock, flags);

 set_bit(ST_CAPT_APPLY_CFG, &fimc->state);
 return 0;
}

static const struct v4l2_ioctl_ops fimc_capture_ioctl_ops = {
 .vidioc_querycap  = fimc_cap_querycap,

 .vidioc_enum_fmt_vid_cap = fimc_cap_enum_fmt,
 .vidioc_try_fmt_vid_cap_mplane = fimc_cap_try_fmt_mplane,
 .vidioc_s_fmt_vid_cap_mplane = fimc_cap_s_fmt_mplane,
 .vidioc_g_fmt_vid_cap_mplane = fimc_cap_g_fmt_mplane,

 .vidioc_reqbufs   = fimc_cap_reqbufs,
 .vidioc_querybuf  = vb2_ioctl_querybuf,
 .vidioc_qbuf   = vb2_ioctl_qbuf,
 .vidioc_dqbuf   = vb2_ioctl_dqbuf,
 .vidioc_expbuf   = vb2_ioctl_expbuf,
 .vidioc_prepare_buf  = vb2_ioctl_prepare_buf,
 .vidioc_create_bufs  = vb2_ioctl_create_bufs,

 .vidioc_streamon  = fimc_cap_streamon,
 .vidioc_streamoff  = fimc_cap_streamoff,

 .vidioc_g_selection  = fimc_cap_g_selection,
 .vidioc_s_selection  = fimc_cap_s_selection,

 .vidioc_enum_input  = fimc_cap_enum_input,
 .vidioc_s_input   = fimc_cap_s_input,
 .vidioc_g_input   = fimc_cap_g_input,
};

/* Capture subdev media entity operations */
static int fimc_link_setup(struct media_entity *entity,
      const struct media_pad *local,
      const struct media_pad *remote, u32 flags)
{
 struct v4l2_subdev *sd = media_entity_to_v4l2_subdev(entity);
 struct fimc_dev *fimc = v4l2_get_subdevdata(sd);
 struct fimc_vid_cap *vc = &fimc->vid_cap;
 struct v4l2_subdev *sensor;

 if (!is_media_entity_v4l2_subdev(remote->entity))
  return -EINVAL;

 if (WARN_ON(fimc == NULL))
  return 0;

 dbg("%s --> %s, flags: 0x%x. input: 0x%x",
     local->entity->name, remote->entity->name, flags,
     fimc->vid_cap.input);

 if (!(flags & MEDIA_LNK_FL_ENABLED)) {
  fimc->vid_cap.input = 0;
  return 0;
 }

 if (vc->input != 0)
  return -EBUSY;

 vc->input = sd->grp_id;

 if (vc->user_subdev_api)
  return 0;

 /* Inherit V4L2 controls from the image sensor subdev. */
 sensor = fimc_find_remote_sensor(&vc->subdev.entity);
 if (sensor == NULL)
  return 0;

 return v4l2_ctrl_add_handler(&vc->ctx->ctrls.handler,
         sensor->ctrl_handler, NULL, true);
}

static const struct media_entity_operations fimc_sd_media_ops = {
 .link_setup = fimc_link_setup,
};

/**
 * fimc_sensor_notify - v4l2_device notification from a sensor subdev
 * @sd: pointer to a subdev generating the notification
 * @notification: the notification type, must be S5P_FIMC_TX_END_NOTIFY
 * @arg: pointer to an u32 type integer that stores the frame payload value
 *
 * The End Of Frame notification sent by sensor subdev in its still capture
 * mode. If there is only a single VSYNC generated by the sensor at the
 * beginning of a frame transmission, FIMC does not issue the LastIrq
 * (end of frame) interrupt. And this notification is used to complete the
 * frame capture and returning a buffer to user-space. Subdev drivers should
 * call this notification from their last 'End of frame capture' interrupt.
 */
void fimc_sensor_notify(struct v4l2_subdev *sd, unsigned int notification,
   void *arg)
{
 struct fimc_source_info *si;
 struct fimc_vid_buffer *buf;
 struct fimc_md *fmd;
 struct fimc_dev *fimc;
 unsigned long flags;

 if (sd == NULL)
  return;

 si = v4l2_get_subdev_hostdata(sd);
 fmd = entity_to_fimc_mdev(&sd->entity);

 spin_lock_irqsave(&fmd->slock, flags);

 fimc = si ? source_to_sensor_info(si)->host : NULL;

 if (fimc && arg && notification == S5P_FIMC_TX_END_NOTIFY &&
     test_bit(ST_CAPT_PEND, &fimc->state)) {
  unsigned long irq_flags;
  spin_lock_irqsave(&fimc->slock, irq_flags);
  if (!list_empty(&fimc->vid_cap.active_buf_q)) {
   buf = list_entry(fimc->vid_cap.active_buf_q.next,
      struct fimc_vid_buffer, list);
   vb2_set_plane_payload(&buf->vb.vb2_buf, 0,
           *((u32 *)arg));
  }
  fimc_capture_irq_handler(fimc, 1);
  fimc_deactivate_capture(fimc);
  spin_unlock_irqrestore(&fimc->slock, irq_flags);
 }
 spin_unlock_irqrestore(&fmd->slock, flags);
}

static int fimc_subdev_enum_mbus_code(struct v4l2_subdev *sd,
          struct v4l2_subdev_state *sd_state,
          struct v4l2_subdev_mbus_code_enum *code)
{
 const struct fimc_fmt *fmt;

 fmt = fimc_find_format(NULL, NULL, FMT_FLAGS_CAM, code->index);
 if (!fmt)
  return -EINVAL;
 code->code = fmt->mbus_code;
 return 0;
}

static int fimc_subdev_get_fmt(struct v4l2_subdev *sd,
          struct v4l2_subdev_state *sd_state,
          struct v4l2_subdev_format *fmt)
{
 struct fimc_dev *fimc = v4l2_get_subdevdata(sd);
 struct fimc_ctx *ctx = fimc->vid_cap.ctx;
 const struct fimc_frame *ff = &ctx->s_frame;
 struct v4l2_mbus_framefmt *mf;

 if (fmt->which == V4L2_SUBDEV_FORMAT_TRY) {
  mf = v4l2_subdev_state_get_format(sd_state, fmt->pad);
  fmt->format = *mf;
  return 0;
 }

 mf = &fmt->format;
 mutex_lock(&fimc->lock);

 switch (fmt->pad) {
 case FIMC_SD_PAD_SOURCE:
  if (!WARN_ON(ff->fmt == NULL))
   mf->code = ff->fmt->mbus_code;
  /* Sink pads crop rectangle size */
  mf->width = ff->width;
  mf->height = ff->height;
  break;
 case FIMC_SD_PAD_SINK_FIFO:
  *mf = fimc->vid_cap.wb_fmt;
  break;
 case FIMC_SD_PAD_SINK_CAM:
 default:
  *mf = fimc->vid_cap.ci_fmt;
  break;
 }

 mutex_unlock(&fimc->lock);
 mf->colorspace = V4L2_COLORSPACE_JPEG;

 return 0;
}

static int fimc_subdev_set_fmt(struct v4l2_subdev *sd,
          struct v4l2_subdev_state *sd_state,
          struct v4l2_subdev_format *fmt)
{
 struct fimc_dev *fimc = v4l2_get_subdevdata(sd);
 struct v4l2_mbus_framefmt *mf = &fmt->format;
 struct fimc_vid_cap *vc = &fimc->vid_cap;
 struct fimc_ctx *ctx = vc->ctx;
 struct fimc_frame *ff;
 const struct fimc_fmt *ffmt;

 dbg("pad%d: code: 0x%x, %dx%d",
     fmt->pad, mf->code, mf->width, mf->height);

 if (fmt->pad == FIMC_SD_PAD_SOURCE && vb2_is_busy(&vc->vbq))
  return -EBUSY;

 mutex_lock(&fimc->lock);
 ffmt = fimc_capture_try_format(ctx, &mf->width, &mf->height,
           &mf->code, NULL, fmt->pad);
 mutex_unlock(&fimc->lock);
 mf->colorspace = V4L2_COLORSPACE_JPEG;

 if (fmt->which == V4L2_SUBDEV_FORMAT_TRY) {
  mf = v4l2_subdev_state_get_format(sd_state, fmt->pad);
  *mf = fmt->format;
  return 0;
 }
 /* There must be a bug in the driver if this happens */
 if (WARN_ON(ffmt == NULL))
  return -EINVAL;

 /* Update RGB Alpha control state and value range */
 fimc_alpha_ctrl_update(ctx);

 fimc_capture_mark_jpeg_xfer(ctx, ffmt->color);
 if (fmt->pad == FIMC_SD_PAD_SOURCE) {
  ff = &ctx->d_frame;
  /* Sink pads crop rectangle size */
  mf->width = ctx->s_frame.width;
  mf->height = ctx->s_frame.height;
 } else {
  ff = &ctx->s_frame;
 }

 mutex_lock(&fimc->lock);
 set_frame_bounds(ff, mf->width, mf->height);

 if (fmt->pad == FIMC_SD_PAD_SINK_FIFO)
  vc->wb_fmt = *mf;
 else if (fmt->pad == FIMC_SD_PAD_SINK_CAM)
  vc->ci_fmt = *mf;

 ff->fmt = ffmt;

 /* Reset the crop rectangle if required. */
 if (!(fmt->pad == FIMC_SD_PAD_SOURCE && (ctx->state & FIMC_COMPOSE)))
  set_frame_crop(ff, 0, 0, mf->width, mf->height);

 if (fmt->pad != FIMC_SD_PAD_SOURCE)
  ctx->state &= ~FIMC_COMPOSE;

 mutex_unlock(&fimc->lock);
 return 0;
}

static int fimc_subdev_get_selection(struct v4l2_subdev *sd,
         struct v4l2_subdev_state *sd_state,
         struct v4l2_subdev_selection *sel)
{
 struct fimc_dev *fimc = v4l2_get_subdevdata(sd);
 struct fimc_ctx *ctx = fimc->vid_cap.ctx;
 const struct fimc_frame *f = &ctx->s_frame;
 struct v4l2_rect *r = &sel->r;
 struct v4l2_rect *try_sel;

 if (sel->pad == FIMC_SD_PAD_SOURCE)
  return -EINVAL;

 mutex_lock(&fimc->lock);

 switch (sel->target) {
 case V4L2_SEL_TGT_COMPOSE_BOUNDS:
  f = &ctx->d_frame;
  fallthrough;
 case V4L2_SEL_TGT_CROP_BOUNDS:
  r->width = f->o_width;
  r->height = f->o_height;
  r->left = 0;
  r->top = 0;
  mutex_unlock(&fimc->lock);
  return 0;

 case V4L2_SEL_TGT_CROP:
  try_sel = v4l2_subdev_state_get_crop(sd_state, sel->pad);
  break;
 case V4L2_SEL_TGT_COMPOSE:
  try_sel = v4l2_subdev_state_get_compose(sd_state, sel->pad);
  f = &ctx->d_frame;
  break;
 default:
  mutex_unlock(&fimc->lock);
  return -EINVAL;
 }

 if (sel->which == V4L2_SUBDEV_FORMAT_TRY) {
  sel->r = *try_sel;
 } else {
  r->left = f->offs_h;
  r->top = f->offs_v;
  r->width = f->width;
  r->height = f->height;
 }

 dbg("target %#x: (%d,%d)/%ux%u, f_w: %d, f_h: %d",
     sel->pad, r->left, r->top, r->width, r->height,
     f->f_width, f->f_height);

 mutex_unlock(&fimc->lock);
 return 0;
}

static int fimc_subdev_set_selection(struct v4l2_subdev *sd,
         struct v4l2_subdev_state *sd_state,
         struct v4l2_subdev_selection *sel)
{
 struct fimc_dev *fimc = v4l2_get_subdevdata(sd);
 struct fimc_ctx *ctx = fimc->vid_cap.ctx;
 struct fimc_frame *f = &ctx->s_frame;
 struct v4l2_rect *r = &sel->r;
 struct v4l2_rect *try_sel;
 unsigned long flags;

 if (sel->pad == FIMC_SD_PAD_SOURCE)
  return -EINVAL;

 mutex_lock(&fimc->lock);
 fimc_capture_try_selection(ctx, r, V4L2_SEL_TGT_CROP);

 switch (sel->target) {
 case V4L2_SEL_TGT_CROP:
  try_sel = v4l2_subdev_state_get_crop(sd_state, sel->pad);
  break;
 case V4L2_SEL_TGT_COMPOSE:
  try_sel = v4l2_subdev_state_get_compose(sd_state, sel->pad);
  f = &ctx->d_frame;
  break;
 default:
  mutex_unlock(&fimc->lock);
  return -EINVAL;
 }

 if (sel->which == V4L2_SUBDEV_FORMAT_TRY) {
  *try_sel = sel->r;
 } else {
  spin_lock_irqsave(&fimc->slock, flags);
  set_frame_crop(f, r->left, r->top, r->width, r->height);
  set_bit(ST_CAPT_APPLY_CFG, &fimc->state);
  if (sel->target == V4L2_SEL_TGT_COMPOSE)
   ctx->state |= FIMC_COMPOSE;
  spin_unlock_irqrestore(&fimc->slock, flags);
 }

 dbg("target %#x: (%d,%d)/%ux%u", sel->target, r->left, r->top,
     r->width, r->height);

 mutex_unlock(&fimc->lock);
 return 0;
}

static const struct v4l2_subdev_pad_ops fimc_subdev_pad_ops = {
 .enum_mbus_code = fimc_subdev_enum_mbus_code,
 .get_selection = fimc_subdev_get_selection,
 .set_selection = fimc_subdev_set_selection,
 .get_fmt = fimc_subdev_get_fmt,
 .set_fmt = fimc_subdev_set_fmt,
};

static const struct v4l2_subdev_ops fimc_subdev_ops = {
 .pad = &fimc_subdev_pad_ops,
};

/* Set default format at the sensor and host interface */
static int fimc_capture_set_default_format(struct fimc_dev *fimc)
{
 struct v4l2_format fmt = {
  .type = V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE,
  .fmt.pix_mp = {
   .width  = FIMC_DEFAULT_WIDTH,
   .height  = FIMC_DEFAULT_HEIGHT,
   .pixelformat = V4L2_PIX_FMT_YUYV,
   .field  = V4L2_FIELD_NONE,
   .colorspace = V4L2_COLORSPACE_JPEG,
  },
 };

 return __fimc_capture_set_format(fimc, &fmt);
}

/* fimc->lock must be already initialized */
static int fimc_register_capture_device(struct fimc_dev *fimc,
     struct v4l2_device *v4l2_dev)
{
 struct video_device *vfd = &fimc->vid_cap.ve.vdev;
 struct vb2_queue *q = &fimc->vid_cap.vbq;
 struct fimc_vid_cap *vid_cap;
 const struct fimc_fmt *fmt;
 struct fimc_ctx *ctx;
 int ret = -ENOMEM;

 ctx = kzalloc(sizeof(*ctx), GFP_KERNEL);
 if (!ctx)
  return -ENOMEM;

 ctx->fimc_dev  = fimc;
 ctx->in_path  = FIMC_IO_CAMERA;
 ctx->out_path  = FIMC_IO_DMA;
 ctx->state  = FIMC_CTX_CAP;
 ctx->s_frame.fmt = fimc_find_format(NULL, NULL, FMT_FLAGS_CAM, 0);
 ctx->d_frame.fmt = ctx->s_frame.fmt;

 memset(vfd, 0, sizeof(*vfd));
 snprintf(vfd->name, sizeof(vfd->name), "fimc.%d.capture", fimc->id);

 vfd->fops = &fimc_capture_fops;
 vfd->ioctl_ops = &fimc_capture_ioctl_ops;
 vfd->v4l2_dev = v4l2_dev;
 vfd->minor = -1;
 vfd->release = video_device_release_empty;
 vfd->queue = q;
 vfd->lock = &fimc->lock;
 vfd->device_caps = V4L2_CAP_STREAMING | V4L2_CAP_VIDEO_CAPTURE_MPLANE;

 video_set_drvdata(vfd, fimc);
 vid_cap = &fimc->vid_cap;
 vid_cap->active_buf_cnt = 0;
 vid_cap->reqbufs_count = 0;
 vid_cap->ctx = ctx;

 INIT_LIST_HEAD(&vid_cap->pending_buf_q);
 INIT_LIST_HEAD(&vid_cap->active_buf_q);

 memset(q, 0, sizeof(*q));
 q->type = V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE;
 q->io_modes = VB2_MMAP | VB2_USERPTR | VB2_DMABUF;
 q->drv_priv = ctx;
 q->ops = &fimc_capture_qops;
 q->mem_ops = &vb2_dma_contig_memops;
 q->buf_struct_size = sizeof(struct fimc_vid_buffer);
 q->timestamp_flags = V4L2_BUF_FLAG_TIMESTAMP_MONOTONIC;
 q->lock = &fimc->lock;
 q->dev = &fimc->pdev->dev;

 ret = vb2_queue_init(q);
 if (ret)
  goto err_free_ctx;

 /* Default format configuration */
 fmt = fimc_find_format(NULL, NULL, FMT_FLAGS_CAM, 0);
 vid_cap->ci_fmt.width = FIMC_DEFAULT_WIDTH;
 vid_cap->ci_fmt.height = FIMC_DEFAULT_HEIGHT;
 vid_cap->ci_fmt.code = fmt->mbus_code;

 ctx->s_frame.width = FIMC_DEFAULT_WIDTH;
 ctx->s_frame.height = FIMC_DEFAULT_HEIGHT;
 ctx->s_frame.fmt = fmt;

 fmt = fimc_find_format(NULL, NULL, FMT_FLAGS_WRITEBACK, 0);
 vid_cap->wb_fmt = vid_cap->ci_fmt;
 vid_cap->wb_fmt.code = fmt->mbus_code;

 vid_cap->vd_pad.flags = MEDIA_PAD_FL_SINK;
 vfd->entity.function = MEDIA_ENT_F_PROC_VIDEO_SCALER;
 ret = media_entity_pads_init(&vfd->entity, 1, &vid_cap->vd_pad);
 if (ret)
  goto err_free_ctx;

 ret = fimc_ctrls_create(ctx);
 if (ret)
  goto err_me_cleanup;

 ret = video_register_device(vfd, VFL_TYPE_VIDEO, -1);
 if (ret)
  goto err_ctrl_free;

 v4l2_info(v4l2_dev, "Registered %s as /dev/%s\n",
    vfd->name, video_device_node_name(vfd));

 vfd->ctrl_handler = &ctx->ctrls.handler;
 return 0;

err_ctrl_free:
 fimc_ctrls_delete(ctx);
err_me_cleanup:
 media_entity_cleanup(&vfd->entity);
err_free_ctx:
 kfree(ctx);
 return ret;
}

static int fimc_capture_subdev_registered(struct v4l2_subdev *sd)
{
 struct fimc_dev *fimc = v4l2_get_subdevdata(sd);
 int ret;

 if (fimc == NULL)
  return -ENXIO;

 ret = fimc_register_m2m_device(fimc, sd->v4l2_dev);
 if (ret)
  return ret;

 fimc->vid_cap.ve.pipe = v4l2_get_subdev_hostdata(sd);

 ret = fimc_register_capture_device(fimc, sd->v4l2_dev);
 if (ret) {
  fimc_unregister_m2m_device(fimc);
  fimc->vid_cap.ve.pipe = NULL;
 }

 return ret;
}

static void fimc_capture_subdev_unregistered(struct v4l2_subdev *sd)
{
 struct fimc_dev *fimc = v4l2_get_subdevdata(sd);
 struct video_device *vdev;

 if (fimc == NULL)
  return;

 mutex_lock(&fimc->lock);

 fimc_unregister_m2m_device(fimc);
 vdev = &fimc->vid_cap.ve.vdev;

 if (video_is_registered(vdev)) {
  video_unregister_device(vdev);
  media_entity_cleanup(&vdev->entity);
  fimc_ctrls_delete(fimc->vid_cap.ctx);
  fimc->vid_cap.ve.pipe = NULL;
 }
 kfree(fimc->vid_cap.ctx);
 fimc->vid_cap.ctx = NULL;

 mutex_unlock(&fimc->lock);
}

static const struct v4l2_subdev_internal_ops fimc_capture_sd_internal_ops = {
 .registered = fimc_capture_subdev_registered,
 .unregistered = fimc_capture_subdev_unregistered,
};

int fimc_initialize_capture_subdev(struct fimc_dev *fimc)
{
 struct v4l2_subdev *sd = &fimc->vid_cap.subdev;
 int ret;

 v4l2_subdev_init(sd, &fimc_subdev_ops);
 sd->flags |= V4L2_SUBDEV_FL_HAS_DEVNODE;
 snprintf(sd->name, sizeof(sd->name), "FIMC.%d", fimc->id);

 fimc->vid_cap.sd_pads[FIMC_SD_PAD_SINK_CAM].flags = MEDIA_PAD_FL_SINK;
 fimc->vid_cap.sd_pads[FIMC_SD_PAD_SINK_FIFO].flags = MEDIA_PAD_FL_SINK;
 fimc->vid_cap.sd_pads[FIMC_SD_PAD_SOURCE].flags = MEDIA_PAD_FL_SOURCE;
 ret = media_entity_pads_init(&sd->entity, FIMC_SD_PADS_NUM,
    fimc->vid_cap.sd_pads);
 if (ret)
  return ret;

 sd->entity.ops = &fimc_sd_media_ops;
 sd->entity.function = MEDIA_ENT_F_PROC_VIDEO_SCALER;
 sd->internal_ops = &fimc_capture_sd_internal_ops;
 v4l2_set_subdevdata(sd, fimc);
 return 0;
}

void fimc_unregister_capture_subdev(struct fimc_dev *fimc)
{
 struct v4l2_subdev *sd = &fimc->vid_cap.subdev;

 v4l2_device_unregister_subdev(sd);
 media_entity_cleanup(&sd->entity);
 v4l2_set_subdevdata(sd, NULL);
}