[deliverable/linux.git] / drivers / media / platform / rcar-vin / rcar-vin.h

/*
 * Driver for Renesas R-Car VIN
 *
 * Copyright (C) 2016 Renesas Electronics Corp.
 * Copyright (C) 2011-2013 Renesas Solutions Corp.
 * Copyright (C) 2013 Cogent Embedded, Inc., <source@cogentembedded.com>
 * Copyright (C) 2008 Magnus Damm
 *
 * Based on the soc-camera rcar_vin driver
 *
 * This program is free software; you can redistribute  it and/or modify it
 * under  the terms of  the GNU General  Public License as published by the
 * Free Software Foundation;  either version 2 of the  License, or (at your
 * option) any later version.
 */

#ifndef __RCAR_VIN__
#define __RCAR_VIN__

#include <media/v4l2-async.h>
#include <media/v4l2-ctrls.h>
#include <media/v4l2-dev.h>
#include <media/v4l2-device.h>
#include <media/videobuf2-v4l2.h>

/* Number of HW buffers */
#define HW_BUFFER_NUM 3

/* Address alignment mask for HW buffers */
#define HW_BUFFER_MASK 0x7f

enum chip_id {
	RCAR_H1,
	RCAR_M1,
	RCAR_GEN2,
};

/**
 * STOPPED  - No operation in progress
 * RUNNING  - Operation in progress have buffers
 * STALLED  - No operation in progress have no buffers
 * STOPPING - Stopping operation
 */
enum rvin_dma_state {
	STOPPED = 0,
	RUNNING,
	STALLED,
	STOPPING,
};

/**
 * struct rvin_source_fmt - Source information
 * @width:	Width from source
 * @height:	Height from source
 */
struct rvin_source_fmt {
	u32 width;
	u32 height;
};

/**
 * struct rvin_video_format - Data format stored in memory
 * @fourcc:	Pixelformat
 * @bpp:	Bytes per pixel
 */
struct rvin_video_format {
	u32 fourcc;
	u8 bpp;
};

/**
 * struct rvin_graph_entity - Video endpoint from async framework
 * @asd:	sub-device descriptor for async framework
 * @subdev:	subdevice matched using async framework
 * @code:	Media bus format from source
 * @mbus_cfg:	Media bus format from DT
 */
struct rvin_graph_entity {
	struct v4l2_async_subdev asd;
	struct v4l2_subdev *subdev;

	u32 code;
	struct v4l2_mbus_config mbus_cfg;
};

/**
 * struct rvin_dev - Renesas VIN device structure
 * @dev:		(OF) device
 * @base:		device I/O register space remapped to virtual memory
 * @chip:		type of VIN chip
 *
 * @vdev:		V4L2 video device associated with VIN
 * @v4l2_dev:		V4L2 device
 * @src_pad_idx:	source pad index for media controller drivers
 * @ctrl_handler:	V4L2 control handler
 * @notifier:		V4L2 asynchronous subdevs notifier
 * @digital:		entity in the DT for local digital subdevice
 *
 * @lock:		protects @queue
 * @queue:		vb2 buffers queue
 *
 * @qlock:		protects @queue_buf, @buf_list, @continuous, @sequence
 *			@state
 * @queue_buf:		Keeps track of buffers given to HW slot
 * @buf_list:		list of queued buffers
 * @continuous:		tracks if active operation is continuous or single mode
 * @sequence:		V4L2 buffers sequence number
 * @state:		keeps track of operation state
 *
 * @source:		active format from the video source
 * @format:		active V4L2 pixel format
 *
 * @crop:		active cropping
 * @compose:		active composing
 */
struct rvin_dev {
	struct device *dev;
	void __iomem *base;
	enum chip_id chip;

	struct video_device vdev;
	struct v4l2_device v4l2_dev;
	int src_pad_idx;
	struct v4l2_ctrl_handler ctrl_handler;
	struct v4l2_async_notifier notifier;
	struct rvin_graph_entity digital;

	struct mutex lock;
	struct vb2_queue queue;

	spinlock_t qlock;
	struct vb2_v4l2_buffer *queue_buf[HW_BUFFER_NUM];
	struct list_head buf_list;
	bool continuous;
	unsigned int sequence;
	enum rvin_dma_state state;

	struct rvin_source_fmt source;
	struct v4l2_pix_format format;

	struct v4l2_rect crop;
	struct v4l2_rect compose;
};

#define vin_to_source(vin)		vin->digital.subdev

/* Debug */
#define vin_dbg(d, fmt, arg...)		dev_dbg(d->dev, fmt, ##arg)
#define vin_info(d, fmt, arg...)	dev_info(d->dev, fmt, ##arg)
#define vin_warn(d, fmt, arg...)	dev_warn(d->dev, fmt, ##arg)
#define vin_err(d, fmt, arg...)		dev_err(d->dev, fmt, ##arg)

int rvin_dma_probe(struct rvin_dev *vin, int irq);
void rvin_dma_remove(struct rvin_dev *vin);

int rvin_v4l2_probe(struct rvin_dev *vin);
void rvin_v4l2_remove(struct rvin_dev *vin);

const struct rvin_video_format *rvin_format_from_pixel(u32 pixelformat);

/* Cropping, composing and scaling */
void rvin_scale_try(struct rvin_dev *vin, struct v4l2_pix_format *pix,
		    u32 width, u32 height);
void rvin_crop_scale_comp(struct rvin_dev *vin);

#endif
Commit	Line	Data
f00add96 NS	1	/*
	2	* Driver for Renesas R-Car VIN
	3	*
	4	* Copyright (C) 2016 Renesas Electronics Corp.
	5	* Copyright (C) 2011-2013 Renesas Solutions Corp.
	6	* Copyright (C) 2013 Cogent Embedded, Inc., <source@cogentembedded.com>
	7	* Copyright (C) 2008 Magnus Damm
	8	*
	9	* Based on the soc-camera rcar_vin driver
	10	*
	11	* This program is free software; you can redistribute it and/or modify it
	12	* under the terms of the GNU General Public License as published by the
	13	* Free Software Foundation; either version 2 of the License, or (at your
	14	* option) any later version.
	15	*/
	16
	17	#ifndef __RCAR_VIN__
	18	#define __RCAR_VIN__
	19
	20	#include <media/v4l2-async.h>
	21	#include <media/v4l2-ctrls.h>
	22	#include <media/v4l2-dev.h>
	23	#include <media/v4l2-device.h>
	24	#include <media/videobuf2-v4l2.h>
	25
	26	/* Number of HW buffers */
	27	#define HW_BUFFER_NUM 3
	28
	29	/* Address alignment mask for HW buffers */
	30	#define HW_BUFFER_MASK 0x7f
	31
	32	enum chip_id {
f00add96 NS	33	RCAR_H1,
f00add96 NS	34	RCAR_M1,
23eb2c86	35	RCAR_GEN2,
f00add96 NS	36	};
	37
	38	/**
	39	* STOPPED - No operation in progress
	40	* RUNNING - Operation in progress have buffers
	41	* STALLED - No operation in progress have no buffers
	42	* STOPPING - Stopping operation
	43	*/
	44	enum rvin_dma_state {
	45	STOPPED = 0,
	46	RUNNING,
	47	STALLED,
	48	STOPPING,
	49	};
	50
	51	/**
	52	* struct rvin_source_fmt - Source information
f00add96 NS	53	* @width: Width from source
	54	* @height: Height from source
	55	*/
	56	struct rvin_source_fmt {
f00add96 NS	57	u32 width;
	58	u32 height;
	59	};
	60
	61	/**
	62	* struct rvin_video_format - Data format stored in memory
	63	* @fourcc: Pixelformat
	64	* @bpp: Bytes per pixel
	65	*/
	66	struct rvin_video_format {
	67	u32 fourcc;
	68	u8 bpp;
	69	};
	70
83fba2c0 NS	71	/**
	72	* struct rvin_graph_entity - Video endpoint from async framework
	73	* @asd: sub-device descriptor for async framework
	74	* @subdev: subdevice matched using async framework
b50b77e6 NS	75	* @code: Media bus format from source
b50b77e6 NS	76	* @mbus_cfg: Media bus format from DT
83fba2c0	77	*/
f00add96	78	struct rvin_graph_entity {
f00add96 NS	79	struct v4l2_async_subdev asd;
f00add96 NS	80	struct v4l2_subdev *subdev;
b50b77e6 NS	81
	82	u32 code;
	83	struct v4l2_mbus_config mbus_cfg;
f00add96 NS	84	};
	85
	86	/**
	87	* struct rvin_dev - Renesas VIN device structure
	88	* @dev: (OF) device
	89	* @base: device I/O register space remapped to virtual memory
	90	* @chip: type of VIN chip
f00add96 NS	91	*
	92	* @vdev: V4L2 video device associated with VIN
	93	* @v4l2_dev: V4L2 device
fa037403	94	* @src_pad_idx: source pad index for media controller drivers
f00add96 NS	95	* @ctrl_handler: V4L2 control handler
f00add96 NS	96	* @notifier: V4L2 asynchronous subdevs notifier
4869ce9d	97	* @digital: entity in the DT for local digital subdevice
f00add96 NS	98	*
	99	* @lock: protects @queue
	100	* @queue: vb2 buffers queue
f00add96 NS	101	*
	102	* @qlock: protects @queue_buf, @buf_list, @continuous, @sequence
	103	* @state
	104	* @queue_buf: Keeps track of buffers given to HW slot
	105	* @buf_list: list of queued buffers
	106	* @continuous: tracks if active operation is continuous or single mode
	107	* @sequence: V4L2 buffers sequence number
	108	* @state: keeps track of operation state
	109	*
	110	* @source: active format from the video source
	111	* @format: active V4L2 pixel format
	112	*
	113	* @crop: active cropping
	114	* @compose: active composing
	115	*/
	116	struct rvin_dev {
	117	struct device *dev;
	118	void __iomem *base;
	119	enum chip_id chip;
f00add96 NS	120
	121	struct video_device vdev;
	122	struct v4l2_device v4l2_dev;
fa037403	123	int src_pad_idx;
f00add96 NS	124	struct v4l2_ctrl_handler ctrl_handler;
f00add96 NS	125	struct v4l2_async_notifier notifier;
4869ce9d	126	struct rvin_graph_entity digital;
f00add96 NS	127
	128	struct mutex lock;
	129	struct vb2_queue queue;
f00add96 NS	130
	131	spinlock_t qlock;
	132	struct vb2_v4l2_buffer *queue_buf[HW_BUFFER_NUM];
	133	struct list_head buf_list;
	134	bool continuous;
	135	unsigned int sequence;
	136	enum rvin_dma_state state;
	137
	138	struct rvin_source_fmt source;
	139	struct v4l2_pix_format format;
	140
	141	struct v4l2_rect crop;
	142	struct v4l2_rect compose;
	143	};
	144
4869ce9d	145	#define vin_to_source(vin) vin->digital.subdev
f00add96 NS	146
	147	/* Debug */
	148	#define vin_dbg(d, fmt, arg...) dev_dbg(d->dev, fmt, ##arg)
	149	#define vin_info(d, fmt, arg...) dev_info(d->dev, fmt, ##arg)
	150	#define vin_warn(d, fmt, arg...) dev_warn(d->dev, fmt, ##arg)
	151	#define vin_err(d, fmt, arg...) dev_err(d->dev, fmt, ##arg)
	152
	153	int rvin_dma_probe(struct rvin_dev *vin, int irq);
	154	void rvin_dma_remove(struct rvin_dev *vin);
	155
	156	int rvin_v4l2_probe(struct rvin_dev *vin);
	157	void rvin_v4l2_remove(struct rvin_dev *vin);
	158
	159	const struct rvin_video_format *rvin_format_from_pixel(u32 pixelformat);
	160
	161	/* Cropping, composing and scaling */
	162	void rvin_scale_try(struct rvin_dev vin, struct v4l2_pix_format pix,
	163	u32 width, u32 height);
	164	void rvin_crop_scale_comp(struct rvin_dev *vin);
	165
	166	#endif