• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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.
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 
39 struct ispccdc_fpc {
40 	void *addr;
41 	dma_addr_t dma;
42 	unsigned int fpnum;
43 };
44 
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;
56 
57 	struct {
58 		void *addr;
59 		dma_addr_t dma;
60 		struct sg_table sgt;
61 	} table;
62 };
63 
64 /*
65  * ispccdc_lsc - CCDC LSC parameters
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 
96 #define CCDC_FIELD_TOP			1
97 #define CCDC_FIELD_BOTTOM		2
98 #define CCDC_FIELD_BOTH			3
99 
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
106  * @crop: Active crop rectangle on the OF source pad
107  * @input: Active input
108  * @output: Active outputs
109  * @video_out: Output video node
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
120  * @bt656: Whether the input interface uses BT.656 synchronization
121  * @fields: The fields (CCDC_FIELD_*) stored in the current buffer
122  * @underrun: A buffer underrun occurred and a new buffer has been queued
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
127  * @running: Is the CCDC hardware running
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];
134 	struct v4l2_rect crop;
135 
136 	enum ccdc_input_entity input;
137 	unsigned int output;
138 	struct isp_video video_out;
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;
146 	struct ispccdc_fpc fpc;
147 	struct ispccdc_lsc lsc;
148 	unsigned int update;
149 	unsigned int shadow_update;
150 
151 	bool bt656;
152 	unsigned int fields;
153 
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;
159 	bool running;
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 */
178