[media] omap3isp: Remove boilerplate disclaimer and FSF address
[cascardo/linux.git] / drivers / media / platform / omap3isp / ispccdc.h
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 /*
97  * struct isp_ccdc_device - Structure for the CCDC module to store its own
98  *                          information
99  * @subdev: V4L2 subdevice
100  * @pads: Sink and source media entity pads
101  * @formats: Active video formats
102  * @crop: Active crop rectangle on the OF source pad
103  * @input: Active input
104  * @output: Active outputs
105  * @video_out: Output video node
106  * @alaw: A-law compression enabled (1) or disabled (0)
107  * @lpf: Low pass filter enabled (1) or disabled (0)
108  * @obclamp: Optical-black clamp enabled (1) or disabled (0)
109  * @fpc_en: Faulty pixels correction enabled (1) or disabled (0)
110  * @blcomp: Black level compensation configuration
111  * @clamp: Optical-black or digital clamp configuration
112  * @fpc: Faulty pixels correction configuration
113  * @lsc: Lens shading compensation configuration
114  * @update: Bitmask of controls to update during the next interrupt
115  * @shadow_update: Controls update in progress by userspace
116  * @underrun: A buffer underrun occurred and a new buffer has been queued
117  * @state: Streaming state
118  * @lock: Serializes shadow_update with interrupt handler
119  * @wait: Wait queue used to stop the module
120  * @stopping: Stopping state
121  * @ioctl_lock: Serializes ioctl calls and LSC requests freeing
122  */
123 struct isp_ccdc_device {
124         struct v4l2_subdev subdev;
125         struct media_pad pads[CCDC_PADS_NUM];
126         struct v4l2_mbus_framefmt formats[CCDC_PADS_NUM];
127         struct v4l2_rect crop;
128
129         enum ccdc_input_entity input;
130         unsigned int output;
131         struct isp_video video_out;
132
133         unsigned int alaw:1,
134                      lpf:1,
135                      obclamp:1,
136                      fpc_en:1;
137         struct omap3isp_ccdc_blcomp blcomp;
138         struct omap3isp_ccdc_bclamp clamp;
139         struct ispccdc_fpc fpc;
140         struct ispccdc_lsc lsc;
141         unsigned int update;
142         unsigned int shadow_update;
143
144         unsigned int underrun:1;
145         enum isp_pipeline_stream_state state;
146         spinlock_t lock;
147         wait_queue_head_t wait;
148         unsigned int stopping;
149         struct mutex ioctl_lock;
150 };
151
152 struct isp_device;
153
154 int omap3isp_ccdc_init(struct isp_device *isp);
155 void omap3isp_ccdc_cleanup(struct isp_device *isp);
156 int omap3isp_ccdc_register_entities(struct isp_ccdc_device *ccdc,
157         struct v4l2_device *vdev);
158 void omap3isp_ccdc_unregister_entities(struct isp_ccdc_device *ccdc);
159
160 int omap3isp_ccdc_busy(struct isp_ccdc_device *isp_ccdc);
161 int omap3isp_ccdc_isr(struct isp_ccdc_device *isp_ccdc, u32 events);
162 void omap3isp_ccdc_restore_context(struct isp_device *isp);
163 void omap3isp_ccdc_max_rate(struct isp_ccdc_device *ccdc,
164         unsigned int *max_rate);
165
166 #endif  /* OMAP3_ISP_CCDC_H */