drivers/media/platform/exynos4-is/fimc-lite.h - kernel/common - Git at Google

 /* SPDX-License-Identifier: GPL-2.0-only */
 /*
  * Copyright (C) 2012 Samsung Electronics Co., Ltd.
  */

 #ifndef FIMC_LITE_H_
 #define FIMC_LITE_H_

 #include <linux/sizes.h>
 #include <linux/io.h>
 #include <linux/irqreturn.h>
 #include <linux/platform_device.h>
 #include <linux/sched.h>
 #include <linux/spinlock.h>
 #include <linux/types.h>
 #include <linux/videodev2.h>

 #include <media/media-entity.h>
 #include <media/videobuf2-v4l2.h>
 #include <media/v4l2-ctrls.h>
 #include <media/v4l2-device.h>
 #include <media/v4l2-mediabus.h>
 #include <media/drv-intf/exynos-fimc.h>

 #define FIMC_LITE_DRV_NAME	"exynos-fimc-lite"
 #define FLITE_CLK_NAME		"flite"
 #define FIMC_LITE_MAX_DEVS	3
 #define FLITE_REQ_BUFS_MIN	2
 #define FLITE_DEFAULT_WIDTH	640
 #define FLITE_DEFAULT_HEIGHT	480

 /* Bit index definitions for struct fimc_lite::state */
 enum {
 	ST_FLITE_LPM,
 	ST_FLITE_PENDING,
 	ST_FLITE_RUN,
 	ST_FLITE_STREAM,
 	ST_FLITE_SUSPENDED,
 	ST_FLITE_OFF,
 	ST_FLITE_IN_USE,
 	ST_FLITE_CONFIG,
 	ST_SENSOR_STREAM,
 };

 #define FLITE_SD_PAD_SINK	0
 #define FLITE_SD_PAD_SOURCE_DMA	1
 #define FLITE_SD_PAD_SOURCE_ISP	2
 #define FLITE_SD_PADS_NUM	3

 /**
  * struct flite_drvdata - FIMC-LITE IP variant data structure
  * @max_width: maximum camera interface input width in pixels
  * @max_height: maximum camera interface input height in pixels
  * @out_width_align: minimum output width alignment in pixels
  * @win_hor_offs_align: minimum camera interface crop window horizontal
  *			offset alignment in pixels
  * @out_hor_offs_align: minimum output DMA compose rectangle horizontal
  *			offset alignment in pixels
  * @max_dma_bufs: number of output DMA buffer start address registers
  * @num_instances: total number of FIMC-LITE IP instances available
  */
 struct flite_drvdata {
 	unsigned short max_width;
 	unsigned short max_height;
 	unsigned short out_width_align;
 	unsigned short win_hor_offs_align;
 	unsigned short out_hor_offs_align;
 	unsigned short max_dma_bufs;
 	unsigned short num_instances;
 };

 struct fimc_lite_events {
 	unsigned int data_overflow;
 };

 #define FLITE_MAX_PLANES	1

 /**
  * struct flite_frame - source/target frame properties
  * @f_width: full pixel width
  * @f_height: full pixel height
  * @rect: crop/composition rectangle
  * @fmt: pointer to pixel format description data structure
  */
 struct flite_frame {
 	u16 f_width;
 	u16 f_height;
 	struct v4l2_rect rect;
 	const struct fimc_fmt *fmt;
 };

 /**
  * struct flite_buffer - video buffer structure
  * @vb:    vb2 buffer
  * @list:  list head for the buffers queue
  * @addr: DMA buffer start address
  * @index: DMA start address register's index
  */
 struct flite_buffer {
 	struct vb2_v4l2_buffer vb;
 	struct list_head list;
 	dma_addr_t addr;
 	unsigned short index;
 };

 /**
  * struct fimc_lite - fimc lite structure
  * @pdev: pointer to FIMC-LITE platform device
  * @dd: SoC specific driver data structure
  * @ve: exynos video device entity structure
  * @v4l2_dev: pointer to top the level v4l2_device
  * @fh: v4l2 file handle
  * @subdev: FIMC-LITE subdev
  * @vd_pad: media (sink) pad for the capture video node
  * @subdev_pads: the subdev media pads
  * @sensor: sensor subdev attached to FIMC-LITE directly or through MIPI-CSIS
  * @ctrl_handler: v4l2 control handler
  * @test_pattern: test pattern controls
  * @index: FIMC-LITE platform device index
  * @pipeline: video capture pipeline data structure
  * @pipeline_ops: media pipeline ops for the video node driver
  * @slock: spinlock protecting this data structure and the hw registers
  * @lock: mutex serializing video device and the subdev operations
  * @clock: FIMC-LITE gate clock
  * @regs: memory mapped io registers
  * @irq_queue: interrupt handler waitqueue
  * @payload: image size in bytes (w x h x bpp)
  * @inp_frame: camera input frame structure
  * @out_frame: DMA output frame structure
  * @out_path: output data path (DMA or FIFO)
  * @source_subdev_grp_id: source subdev group id
  * @state: driver state flags
  * @pending_buf_q: pending buffers queue head
  * @active_buf_q: the queue head of buffers scheduled in hardware
  * @vb_queue: vb2 buffers queue
  * @buf_index: helps to keep track of the DMA start address register index
  * @active_buf_count: number of video buffers scheduled in hardware
  * @frame_count: the captured frames counter
  * @reqbufs_count: the number of buffers requested with REQBUFS ioctl
  * @events: event info
  * @streaming: is streaming in progress?
  */
 struct fimc_lite {
 	struct platform_device	*pdev;
 	struct flite_drvdata	*dd;
 	struct exynos_video_entity ve;
 	struct v4l2_device	*v4l2_dev;
 	struct v4l2_fh		fh;
 	struct v4l2_subdev	subdev;
 	struct media_pad	vd_pad;
 	struct media_pad	subdev_pads[FLITE_SD_PADS_NUM];
 	struct v4l2_subdev	*sensor;
 	struct v4l2_ctrl_handler ctrl_handler;
 	struct v4l2_ctrl	*test_pattern;
 	int			index;

 	struct mutex		lock;
 	spinlock_t		slock;

 	struct clk		*clock;
 	void __iomem		*regs;
 	wait_queue_head_t	irq_queue;

 	unsigned long		payload[FLITE_MAX_PLANES];
 	struct flite_frame	inp_frame;
 	struct flite_frame	out_frame;
 	atomic_t		out_path;
 	unsigned int		source_subdev_grp_id;

 	unsigned long		state;
 	struct list_head	pending_buf_q;
 	struct list_head	active_buf_q;
 	struct vb2_queue	vb_queue;
 	unsigned short		buf_index;
 	unsigned int		frame_count;
 	unsigned int		reqbufs_count;

 	struct fimc_lite_events	events;
 	bool			streaming;
 };

 static inline bool fimc_lite_active(struct fimc_lite *fimc)
 {
 	unsigned long flags;
 	bool ret;

 	spin_lock_irqsave(&fimc->slock, flags);
 	ret = fimc->state & (1 << ST_FLITE_RUN) ||
 		fimc->state & (1 << ST_FLITE_PENDING);
 	spin_unlock_irqrestore(&fimc->slock, flags);
 	return ret;
 }

 static inline void fimc_lite_active_queue_add(struct fimc_lite *dev,
 					 struct flite_buffer *buf)
 {
 	list_add_tail(&buf->list, &dev->active_buf_q);
 }

 static inline struct flite_buffer *fimc_lite_active_queue_pop(
 					struct fimc_lite *dev)
 {
 	struct flite_buffer *buf = list_entry(dev->active_buf_q.next,
 					      struct flite_buffer, list);
 	list_del(&buf->list);
 	return buf;
 }

 static inline void fimc_lite_pending_queue_add(struct fimc_lite *dev,
 					struct flite_buffer *buf)
 {
 	list_add_tail(&buf->list, &dev->pending_buf_q);
 }

 static inline struct flite_buffer *fimc_lite_pending_queue_pop(
 					struct fimc_lite *dev)
 {
 	struct flite_buffer *buf = list_entry(dev->pending_buf_q.next,
 					      struct flite_buffer, list);
 	list_del(&buf->list);
 	return buf;
 }

 #endif /* FIMC_LITE_H_ */
	/* SPDX-License-Identifier: GPL-2.0-only */
	/*
	* Copyright (C) 2012 Samsung Electronics Co., Ltd.
	*/

	#ifndef FIMC_LITE_H_
	#define FIMC_LITE_H_

	#include <linux/sizes.h>
	#include <linux/io.h>
	#include <linux/irqreturn.h>
	#include <linux/platform_device.h>
	#include <linux/sched.h>
	#include <linux/spinlock.h>
	#include <linux/types.h>
	#include <linux/videodev2.h>

	#include <media/media-entity.h>
	#include <media/videobuf2-v4l2.h>
	#include <media/v4l2-ctrls.h>
	#include <media/v4l2-device.h>
	#include <media/v4l2-mediabus.h>
	#include <media/drv-intf/exynos-fimc.h>

	#define FIMC_LITE_DRV_NAME "exynos-fimc-lite"
	#define FLITE_CLK_NAME "flite"
	#define FIMC_LITE_MAX_DEVS 3
	#define FLITE_REQ_BUFS_MIN 2
	#define FLITE_DEFAULT_WIDTH 640
	#define FLITE_DEFAULT_HEIGHT 480

	/* Bit index definitions for struct fimc_lite::state */
	enum {
	ST_FLITE_LPM,
	ST_FLITE_PENDING,
	ST_FLITE_RUN,
	ST_FLITE_STREAM,
	ST_FLITE_SUSPENDED,
	ST_FLITE_OFF,
	ST_FLITE_IN_USE,
	ST_FLITE_CONFIG,
	ST_SENSOR_STREAM,
	};

	#define FLITE_SD_PAD_SINK 0
	#define FLITE_SD_PAD_SOURCE_DMA 1
	#define FLITE_SD_PAD_SOURCE_ISP 2
	#define FLITE_SD_PADS_NUM 3

	/**
	* struct flite_drvdata - FIMC-LITE IP variant data structure
	* @max_width: maximum camera interface input width in pixels
	* @max_height: maximum camera interface input height in pixels
	* @out_width_align: minimum output width alignment in pixels
	* @win_hor_offs_align: minimum camera interface crop window horizontal
	* offset alignment in pixels
	* @out_hor_offs_align: minimum output DMA compose rectangle horizontal
	* offset alignment in pixels
	* @max_dma_bufs: number of output DMA buffer start address registers
	* @num_instances: total number of FIMC-LITE IP instances available
	*/
	struct flite_drvdata {
	unsigned short max_width;
	unsigned short max_height;
	unsigned short out_width_align;
	unsigned short win_hor_offs_align;
	unsigned short out_hor_offs_align;
	unsigned short max_dma_bufs;
	unsigned short num_instances;
	};

	struct fimc_lite_events {
	unsigned int data_overflow;
	};

	#define FLITE_MAX_PLANES 1

	/**
	* struct flite_frame - source/target frame properties
	* @f_width: full pixel width
	* @f_height: full pixel height
	* @rect: crop/composition rectangle
	* @fmt: pointer to pixel format description data structure
	*/
	struct flite_frame {
	u16 f_width;
	u16 f_height;
	struct v4l2_rect rect;
	const struct fimc_fmt *fmt;
	};

	/**
	* struct flite_buffer - video buffer structure
	* @vb: vb2 buffer
	* @list: list head for the buffers queue
	* @addr: DMA buffer start address
	* @index: DMA start address register's index
	*/
	struct flite_buffer {
	struct vb2_v4l2_buffer vb;
	struct list_head list;
	dma_addr_t addr;
	unsigned short index;
	};

	/**
	* struct fimc_lite - fimc lite structure
	* @pdev: pointer to FIMC-LITE platform device
	* @dd: SoC specific driver data structure
	* @ve: exynos video device entity structure
	* @v4l2_dev: pointer to top the level v4l2_device
	* @fh: v4l2 file handle
	* @subdev: FIMC-LITE subdev
	* @vd_pad: media (sink) pad for the capture video node
	* @subdev_pads: the subdev media pads
	* @sensor: sensor subdev attached to FIMC-LITE directly or through MIPI-CSIS
	* @ctrl_handler: v4l2 control handler
	* @test_pattern: test pattern controls
	* @index: FIMC-LITE platform device index
	* @pipeline: video capture pipeline data structure
	* @pipeline_ops: media pipeline ops for the video node driver
	* @slock: spinlock protecting this data structure and the hw registers
	* @lock: mutex serializing video device and the subdev operations
	* @clock: FIMC-LITE gate clock
	* @regs: memory mapped io registers
	* @irq_queue: interrupt handler waitqueue
	* @payload: image size in bytes (w x h x bpp)
	* @inp_frame: camera input frame structure
	* @out_frame: DMA output frame structure
	* @out_path: output data path (DMA or FIFO)
	* @source_subdev_grp_id: source subdev group id
	* @state: driver state flags
	* @pending_buf_q: pending buffers queue head
	* @active_buf_q: the queue head of buffers scheduled in hardware
	* @vb_queue: vb2 buffers queue
	* @buf_index: helps to keep track of the DMA start address register index
	* @active_buf_count: number of video buffers scheduled in hardware
	* @frame_count: the captured frames counter
	* @reqbufs_count: the number of buffers requested with REQBUFS ioctl
	* @events: event info
	* @streaming: is streaming in progress?
	*/
	struct fimc_lite {
	struct platform_device *pdev;
	struct flite_drvdata *dd;
	struct exynos_video_entity ve;
	struct v4l2_device *v4l2_dev;
	struct v4l2_fh fh;
	struct v4l2_subdev subdev;
	struct media_pad vd_pad;
	struct media_pad subdev_pads[FLITE_SD_PADS_NUM];
	struct v4l2_subdev *sensor;
	struct v4l2_ctrl_handler ctrl_handler;
	struct v4l2_ctrl *test_pattern;
	int index;

	struct mutex lock;
	spinlock_t slock;

	struct clk *clock;
	void __iomem *regs;
	wait_queue_head_t irq_queue;

	unsigned long payload[FLITE_MAX_PLANES];
	struct flite_frame inp_frame;
	struct flite_frame out_frame;
	atomic_t out_path;
	unsigned int source_subdev_grp_id;

	unsigned long state;
	struct list_head pending_buf_q;
	struct list_head active_buf_q;
	struct vb2_queue vb_queue;
	unsigned short buf_index;
	unsigned int frame_count;
	unsigned int reqbufs_count;

	struct fimc_lite_events events;
	bool streaming;
	};

	static inline bool fimc_lite_active(struct fimc_lite *fimc)
	{
	unsigned long flags;
	bool ret;

	spin_lock_irqsave(&fimc->slock, flags);
	ret = fimc->state & (1 << ST_FLITE_RUN) \|\|
	fimc->state & (1 << ST_FLITE_PENDING);
	spin_unlock_irqrestore(&fimc->slock, flags);
	return ret;
	}

	static inline void fimc_lite_active_queue_add(struct fimc_lite *dev,
	struct flite_buffer *buf)
	{
	list_add_tail(&buf->list, &dev->active_buf_q);
	}

	static inline struct flite_buffer *fimc_lite_active_queue_pop(
	struct fimc_lite *dev)
	{
	struct flite_buffer *buf = list_entry(dev->active_buf_q.next,
	struct flite_buffer, list);
	list_del(&buf->list);
	return buf;
	}

	static inline void fimc_lite_pending_queue_add(struct fimc_lite *dev,
	struct flite_buffer *buf)
	{
	list_add_tail(&buf->list, &dev->pending_buf_q);
	}

	static inline struct flite_buffer *fimc_lite_pending_queue_pop(
	struct fimc_lite *dev)
	{
	struct flite_buffer *buf = list_entry(dev->pending_buf_q.next,
	struct flite_buffer, list);
	list_del(&buf->list);
	return buf;
	}

	#endif /* FIMC_LITE_H_ */