[deliverable/linux.git] / drivers / media / platform / omap3isp / ispccdc.h

/*
 * ispccdc.h
 *
 * TI OMAP3 ISP - CCDC module
 *
 * Copyright (C) 2009-2010 Nokia Corporation
 * Copyright (C) 2009 Texas Instruments, Inc.
 *
 * Contacts: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
 *	     Sakari Ailus <sakari.ailus@iki.fi>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation.
 */

#ifndef OMAP3_ISP_CCDC_H
#define OMAP3_ISP_CCDC_H

#include <linux/omap3isp.h>
#include <linux/workqueue.h>

#include "ispvideo.h"

enum ccdc_input_entity {
	CCDC_INPUT_NONE,
	CCDC_INPUT_PARALLEL,
	CCDC_INPUT_CSI2A,
	CCDC_INPUT_CCP2B,
	CCDC_INPUT_CSI2C
};

#define CCDC_OUTPUT_MEMORY	(1 << 0)
#define CCDC_OUTPUT_PREVIEW	(1 << 1)
#define CCDC_OUTPUT_RESIZER	(1 << 2)

#define	OMAP3ISP_CCDC_NEVENTS	16

struct ispccdc_fpc {
	void *addr;
	dma_addr_t dma;
	unsigned int fpnum;
};

enum ispccdc_lsc_state {
	LSC_STATE_STOPPED = 0,
	LSC_STATE_STOPPING = 1,
	LSC_STATE_RUNNING = 2,
	LSC_STATE_RECONFIG = 3,
};

struct ispccdc_lsc_config_req {
	struct list_head list;
	struct omap3isp_ccdc_lsc_config config;
	unsigned char enable;

	struct {
		void *addr;
		dma_addr_t dma;
		struct sg_table sgt;
	} table;
};

/*
 * ispccdc_lsc - CCDC LSC parameters
 */
struct ispccdc_lsc {
	enum ispccdc_lsc_state state;
	struct work_struct table_work;

	/* LSC queue of configurations */
	spinlock_t req_lock;
	struct ispccdc_lsc_config_req *request;	/* requested configuration */
	struct ispccdc_lsc_config_req *active;	/* active configuration */
	struct list_head free_queue;	/* configurations for freeing */
};

#define CCDC_STOP_NOT_REQUESTED		0x00
#define CCDC_STOP_REQUEST		0x01
#define CCDC_STOP_EXECUTED		(0x02 | CCDC_STOP_REQUEST)
#define CCDC_STOP_CCDC_FINISHED		0x04
#define CCDC_STOP_LSC_FINISHED		0x08
#define CCDC_STOP_FINISHED		\
	(CCDC_STOP_EXECUTED | CCDC_STOP_CCDC_FINISHED | CCDC_STOP_LSC_FINISHED)

#define CCDC_EVENT_VD1			0x10
#define CCDC_EVENT_VD0			0x20
#define CCDC_EVENT_LSC_DONE		0x40

/* Sink and source CCDC pads */
#define CCDC_PAD_SINK			0
#define CCDC_PAD_SOURCE_OF		1
#define CCDC_PAD_SOURCE_VP		2
#define CCDC_PADS_NUM			3

#define CCDC_FIELD_TOP			1
#define CCDC_FIELD_BOTTOM		2
#define CCDC_FIELD_BOTH			3

/*
 * struct isp_ccdc_device - Structure for the CCDC module to store its own
 *			    information
 * @subdev: V4L2 subdevice
 * @pads: Sink and source media entity pads
 * @formats: Active video formats
 * @crop: Active crop rectangle on the OF source pad
 * @input: Active input
 * @output: Active outputs
 * @video_out: Output video node
 * @alaw: A-law compression enabled (1) or disabled (0)
 * @lpf: Low pass filter enabled (1) or disabled (0)
 * @obclamp: Optical-black clamp enabled (1) or disabled (0)
 * @fpc_en: Faulty pixels correction enabled (1) or disabled (0)
 * @blcomp: Black level compensation configuration
 * @clamp: Optical-black or digital clamp configuration
 * @fpc: Faulty pixels correction configuration
 * @lsc: Lens shading compensation configuration
 * @update: Bitmask of controls to update during the next interrupt
 * @shadow_update: Controls update in progress by userspace
 * @bt656: Whether the input interface uses BT.656 synchronization
 * @fields: The fields (CCDC_FIELD_*) stored in the current buffer
 * @underrun: A buffer underrun occurred and a new buffer has been queued
 * @state: Streaming state
 * @lock: Serializes shadow_update with interrupt handler
 * @wait: Wait queue used to stop the module
 * @stopping: Stopping state
 * @running: Is the CCDC hardware running
 * @ioctl_lock: Serializes ioctl calls and LSC requests freeing
 */
struct isp_ccdc_device {
	struct v4l2_subdev subdev;
	struct media_pad pads[CCDC_PADS_NUM];
	struct v4l2_mbus_framefmt formats[CCDC_PADS_NUM];
	struct v4l2_rect crop;

	enum ccdc_input_entity input;
	unsigned int output;
	struct isp_video video_out;

	unsigned int alaw:1,
		     lpf:1,
		     obclamp:1,
		     fpc_en:1;
	struct omap3isp_ccdc_blcomp blcomp;
	struct omap3isp_ccdc_bclamp clamp;
	struct ispccdc_fpc fpc;
	struct ispccdc_lsc lsc;
	unsigned int update;
	unsigned int shadow_update;

	bool bt656;
	unsigned int fields;

	unsigned int underrun:1;
	enum isp_pipeline_stream_state state;
	spinlock_t lock;
	wait_queue_head_t wait;
	unsigned int stopping;
	bool running;
	struct mutex ioctl_lock;
};

struct isp_device;

int omap3isp_ccdc_init(struct isp_device *isp);
void omap3isp_ccdc_cleanup(struct isp_device *isp);
int omap3isp_ccdc_register_entities(struct isp_ccdc_device *ccdc,
	struct v4l2_device *vdev);
void omap3isp_ccdc_unregister_entities(struct isp_ccdc_device *ccdc);

int omap3isp_ccdc_busy(struct isp_ccdc_device *isp_ccdc);
int omap3isp_ccdc_isr(struct isp_ccdc_device *isp_ccdc, u32 events);
void omap3isp_ccdc_restore_context(struct isp_device *isp);
void omap3isp_ccdc_max_rate(struct isp_ccdc_device *ccdc,
	unsigned int *max_rate);

#endif	/* OMAP3_ISP_CCDC_H */
Commit	Line	Data
de1135d4 LP	1	/*
	2	* ispccdc.h
	3	*
	4	* TI OMAP3 ISP - CCDC module
	5	*
	6	* Copyright (C) 2009-2010 Nokia Corporation
	7	* Copyright (C) 2009 Texas Instruments, Inc.
	8	*
	9	* Contacts: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
	10	* Sakari Ailus <sakari.ailus@iki.fi>
	11	*
	12	* This program is free software; you can redistribute it and/or modify
	13	* it under the terms of the GNU General Public License version 2 as
	14	* published by the Free Software Foundation.
de1135d4 LP	15	*/
	16
	17	#ifndef OMAP3_ISP_CCDC_H
	18	#define OMAP3_ISP_CCDC_H
	19
	20	#include <linux/omap3isp.h>
	21	#include <linux/workqueue.h>
	22
	23	#include "ispvideo.h"
	24
	25	enum ccdc_input_entity {
	26	CCDC_INPUT_NONE,
	27	CCDC_INPUT_PARALLEL,
	28	CCDC_INPUT_CSI2A,
	29	CCDC_INPUT_CCP2B,
	30	CCDC_INPUT_CSI2C
	31	};
	32
	33	#define CCDC_OUTPUT_MEMORY (1 << 0)
	34	#define CCDC_OUTPUT_PREVIEW (1 << 1)
	35	#define CCDC_OUTPUT_RESIZER (1 << 2)
	36
	37	#define OMAP3ISP_CCDC_NEVENTS 16
	38
c60e153d LP	39	struct ispccdc_fpc {
	40	void *addr;
	41	dma_addr_t dma;
	42	unsigned int fpnum;
	43	};
	44
de1135d4 LP	45	enum ispccdc_lsc_state {
	46	LSC_STATE_STOPPED = 0,
	47	LSC_STATE_STOPPING = 1,
	48	LSC_STATE_RUNNING = 2,
	49	LSC_STATE_RECONFIG = 3,
	50	};
	51
	52	struct ispccdc_lsc_config_req {
	53	struct list_head list;
	54	struct omap3isp_ccdc_lsc_config config;
	55	unsigned char enable;
d33186d0 LP	56
	57	struct {
	58	void *addr;
	59	dma_addr_t dma;
	60	struct sg_table sgt;
	61	} table;
de1135d4 LP	62	};
	63
	64	/*
	65	* ispccdc_lsc - CCDC LSC parameters
de1135d4 LP	66	*/
	67	struct ispccdc_lsc {
	68	enum ispccdc_lsc_state state;
	69	struct work_struct table_work;
	70
	71	/* LSC queue of configurations */
	72	spinlock_t req_lock;
	73	struct ispccdc_lsc_config_req request; / requested configuration */
	74	struct ispccdc_lsc_config_req active; / active configuration */
	75	struct list_head free_queue; /* configurations for freeing */
	76	};
	77
	78	#define CCDC_STOP_NOT_REQUESTED 0x00
	79	#define CCDC_STOP_REQUEST 0x01
	80	#define CCDC_STOP_EXECUTED (0x02 \| CCDC_STOP_REQUEST)
	81	#define CCDC_STOP_CCDC_FINISHED 0x04
	82	#define CCDC_STOP_LSC_FINISHED 0x08
	83	#define CCDC_STOP_FINISHED \
	84	(CCDC_STOP_EXECUTED \| CCDC_STOP_CCDC_FINISHED \| CCDC_STOP_LSC_FINISHED)
	85
	86	#define CCDC_EVENT_VD1 0x10
	87	#define CCDC_EVENT_VD0 0x20
	88	#define CCDC_EVENT_LSC_DONE 0x40
	89
	90	/* Sink and source CCDC pads */
	91	#define CCDC_PAD_SINK 0
	92	#define CCDC_PAD_SOURCE_OF 1
	93	#define CCDC_PAD_SOURCE_VP 2
	94	#define CCDC_PADS_NUM 3
	95
93d7badf LP	96	#define CCDC_FIELD_TOP 1
	97	#define CCDC_FIELD_BOTTOM 2
	98	#define CCDC_FIELD_BOTH 3
	99
de1135d4 LP	100	/*
	101	* struct isp_ccdc_device - Structure for the CCDC module to store its own
	102	* information
	103	* @subdev: V4L2 subdevice
	104	* @pads: Sink and source media entity pads
	105	* @formats: Active video formats
a64909b8	106	* @crop: Active crop rectangle on the OF source pad
de1135d4 LP	107	* @input: Active input
	108	* @output: Active outputs
	109	* @video_out: Output video node
de1135d4 LP	110	* @alaw: A-law compression enabled (1) or disabled (0)
	111	* @lpf: Low pass filter enabled (1) or disabled (0)
	112	* @obclamp: Optical-black clamp enabled (1) or disabled (0)
	113	* @fpc_en: Faulty pixels correction enabled (1) or disabled (0)
	114	* @blcomp: Black level compensation configuration
	115	* @clamp: Optical-black or digital clamp configuration
	116	* @fpc: Faulty pixels correction configuration
	117	* @lsc: Lens shading compensation configuration
	118	* @update: Bitmask of controls to update during the next interrupt
	119	* @shadow_update: Controls update in progress by userspace
9de7af4d	120	* @bt656: Whether the input interface uses BT.656 synchronization
93d7badf	121	* @fields: The fields (CCDC_FIELD_*) stored in the current buffer
25985edc	122	* @underrun: A buffer underrun occurred and a new buffer has been queued
de1135d4 LP	123	* @state: Streaming state
	124	* @lock: Serializes shadow_update with interrupt handler
	125	* @wait: Wait queue used to stop the module
	126	* @stopping: Stopping state
0b3fcd57	127	* @running: Is the CCDC hardware running
de1135d4 LP	128	* @ioctl_lock: Serializes ioctl calls and LSC requests freeing
	129	*/
	130	struct isp_ccdc_device {
	131	struct v4l2_subdev subdev;
	132	struct media_pad pads[CCDC_PADS_NUM];
	133	struct v4l2_mbus_framefmt formats[CCDC_PADS_NUM];
a64909b8	134	struct v4l2_rect crop;
de1135d4 LP	135
	136	enum ccdc_input_entity input;
	137	unsigned int output;
	138	struct isp_video video_out;
de1135d4 LP	139
	140	unsigned int alaw:1,
	141	lpf:1,
	142	obclamp:1,
	143	fpc_en:1;
	144	struct omap3isp_ccdc_blcomp blcomp;
	145	struct omap3isp_ccdc_bclamp clamp;
c60e153d	146	struct ispccdc_fpc fpc;
de1135d4 LP	147	struct ispccdc_lsc lsc;
	148	unsigned int update;
	149	unsigned int shadow_update;
	150
9de7af4d	151	bool bt656;
93d7badf LP	152	unsigned int fields;
93d7badf LP	153
de1135d4 LP	154	unsigned int underrun:1;
	155	enum isp_pipeline_stream_state state;
	156	spinlock_t lock;
	157	wait_queue_head_t wait;
	158	unsigned int stopping;
0b3fcd57	159	bool running;
de1135d4 LP	160	struct mutex ioctl_lock;
	161	};
	162
	163	struct isp_device;
	164
	165	int omap3isp_ccdc_init(struct isp_device *isp);
	166	void omap3isp_ccdc_cleanup(struct isp_device *isp);
	167	int omap3isp_ccdc_register_entities(struct isp_ccdc_device *ccdc,
	168	struct v4l2_device *vdev);
	169	void omap3isp_ccdc_unregister_entities(struct isp_ccdc_device *ccdc);
	170
	171	int omap3isp_ccdc_busy(struct isp_ccdc_device *isp_ccdc);
	172	int omap3isp_ccdc_isr(struct isp_ccdc_device *isp_ccdc, u32 events);
	173	void omap3isp_ccdc_restore_context(struct isp_device *isp);
	174	void omap3isp_ccdc_max_rate(struct isp_ccdc_device *ccdc,
	175	unsigned int *max_rate);
	176
	177	#endif /* OMAP3_ISP_CCDC_H */