Commit | Line | Data |
---|---|---|
fef1c8d0 TS |
1 | /* |
2 | * Samsung TV Mixer driver | |
3 | * | |
4 | * Copyright (c) 2010-2011 Samsung Electronics Co., Ltd. | |
5 | * | |
6 | * Tomasz Stanislawski, <t.stanislaws@samsung.com> | |
7 | * | |
8 | * This program is free software; you can redistribute it and/or modify | |
9 | * it under the terms of the GNU General Public License as published | |
10 | * by the Free Software Foundiation. either version 2 of the License, | |
11 | * or (at your option) any later version | |
12 | */ | |
13 | ||
14 | #ifndef SAMSUNG_MIXER_H | |
15 | #define SAMSUNG_MIXER_H | |
16 | ||
17 | #ifdef CONFIG_VIDEO_SAMSUNG_S5P_MIXER_DEBUG | |
18 | #define DEBUG | |
19 | #endif | |
20 | ||
21 | #include <linux/fb.h> | |
22 | #include <linux/kernel.h> | |
23 | #include <linux/spinlock.h> | |
24 | #include <linux/wait.h> | |
25 | #include <media/v4l2-device.h> | |
26 | #include <media/videobuf2-core.h> | |
27 | ||
28 | #include "regs-mixer.h" | |
29 | ||
30 | /** maximum number of output interfaces */ | |
31 | #define MXR_MAX_OUTPUTS 2 | |
32 | /** maximum number of input interfaces (layers) */ | |
33 | #define MXR_MAX_LAYERS 3 | |
34 | #define MXR_DRIVER_NAME "s5p-mixer" | |
35 | /** maximal number of planes for every layer */ | |
36 | #define MXR_MAX_PLANES 2 | |
37 | ||
38 | #define MXR_ENABLE 1 | |
39 | #define MXR_DISABLE 0 | |
40 | ||
41 | /** description of a macroblock for packed formats */ | |
42 | struct mxr_block { | |
43 | /** vertical number of pixels in macroblock */ | |
44 | unsigned int width; | |
45 | /** horizontal number of pixels in macroblock */ | |
46 | unsigned int height; | |
47 | /** size of block in bytes */ | |
48 | unsigned int size; | |
49 | }; | |
50 | ||
51 | /** description of supported format */ | |
52 | struct mxr_format { | |
53 | /** format name/mnemonic */ | |
54 | const char *name; | |
55 | /** fourcc identifier */ | |
56 | u32 fourcc; | |
57 | /** colorspace identifier */ | |
58 | enum v4l2_colorspace colorspace; | |
59 | /** number of planes in image data */ | |
60 | int num_planes; | |
61 | /** description of block for each plane */ | |
62 | struct mxr_block plane[MXR_MAX_PLANES]; | |
63 | /** number of subframes in image data */ | |
64 | int num_subframes; | |
65 | /** specifies to which subframe belong given plane */ | |
66 | int plane2subframe[MXR_MAX_PLANES]; | |
67 | /** internal code, driver dependant */ | |
68 | unsigned long cookie; | |
69 | }; | |
70 | ||
71 | /** description of crop configuration for image */ | |
72 | struct mxr_crop { | |
73 | /** width of layer in pixels */ | |
74 | unsigned int full_width; | |
75 | /** height of layer in pixels */ | |
76 | unsigned int full_height; | |
77 | /** horizontal offset of first pixel to be displayed */ | |
78 | unsigned int x_offset; | |
79 | /** vertical offset of first pixel to be displayed */ | |
80 | unsigned int y_offset; | |
81 | /** width of displayed data in pixels */ | |
82 | unsigned int width; | |
83 | /** height of displayed data in pixels */ | |
84 | unsigned int height; | |
85 | /** indicate which fields are present in buffer */ | |
86 | unsigned int field; | |
87 | }; | |
88 | ||
0d066d3f TS |
89 | /** stages of geometry operations */ |
90 | enum mxr_geometry_stage { | |
91 | MXR_GEOMETRY_SINK, | |
92 | MXR_GEOMETRY_COMPOSE, | |
93 | MXR_GEOMETRY_CROP, | |
94 | MXR_GEOMETRY_SOURCE, | |
95 | }; | |
96 | ||
97 | /* flag indicating that offset should be 0 */ | |
98 | #define MXR_NO_OFFSET 0x80000000 | |
99 | ||
fef1c8d0 TS |
100 | /** description of transformation from source to destination image */ |
101 | struct mxr_geometry { | |
102 | /** cropping for source image */ | |
103 | struct mxr_crop src; | |
104 | /** cropping for destination image */ | |
105 | struct mxr_crop dst; | |
106 | /** layer-dependant description of horizontal scaling */ | |
107 | unsigned int x_ratio; | |
108 | /** layer-dependant description of vertical scaling */ | |
109 | unsigned int y_ratio; | |
110 | }; | |
111 | ||
112 | /** instance of a buffer */ | |
113 | struct mxr_buffer { | |
114 | /** common v4l buffer stuff -- must be first */ | |
115 | struct vb2_buffer vb; | |
116 | /** node for layer's lists */ | |
117 | struct list_head list; | |
118 | }; | |
119 | ||
120 | ||
121 | /** internal states of layer */ | |
122 | enum mxr_layer_state { | |
123 | /** layers is not shown */ | |
124 | MXR_LAYER_IDLE = 0, | |
fef1c8d0 TS |
125 | /** layer is shown */ |
126 | MXR_LAYER_STREAMING, | |
127 | /** state before STREAMOFF is finished */ | |
128 | MXR_LAYER_STREAMING_FINISH, | |
129 | }; | |
130 | ||
131 | /** forward declarations */ | |
132 | struct mxr_device; | |
133 | struct mxr_layer; | |
134 | ||
135 | /** callback for layers operation */ | |
136 | struct mxr_layer_ops { | |
137 | /* TODO: try to port it to subdev API */ | |
138 | /** handler for resource release function */ | |
139 | void (*release)(struct mxr_layer *); | |
140 | /** setting buffer to HW */ | |
141 | void (*buffer_set)(struct mxr_layer *, struct mxr_buffer *); | |
142 | /** setting format and geometry in HW */ | |
143 | void (*format_set)(struct mxr_layer *); | |
144 | /** streaming stop/start */ | |
145 | void (*stream_set)(struct mxr_layer *, int); | |
146 | /** adjusting geometry */ | |
0d066d3f TS |
147 | void (*fix_geometry)(struct mxr_layer *, |
148 | enum mxr_geometry_stage, unsigned long); | |
fef1c8d0 TS |
149 | }; |
150 | ||
151 | /** layer instance, a single window and content displayed on output */ | |
152 | struct mxr_layer { | |
153 | /** parent mixer device */ | |
154 | struct mxr_device *mdev; | |
155 | /** layer index (unique identifier) */ | |
156 | int idx; | |
157 | /** callbacks for layer methods */ | |
158 | struct mxr_layer_ops ops; | |
159 | /** format array */ | |
160 | const struct mxr_format **fmt_array; | |
161 | /** size of format array */ | |
162 | unsigned long fmt_array_size; | |
163 | ||
164 | /** lock for protection of list and state fields */ | |
165 | spinlock_t enq_slock; | |
166 | /** list for enqueued buffers */ | |
167 | struct list_head enq_list; | |
168 | /** buffer currently owned by hardware in temporary registers */ | |
169 | struct mxr_buffer *update_buf; | |
170 | /** buffer currently owned by hardware in shadow registers */ | |
171 | struct mxr_buffer *shadow_buf; | |
172 | /** state of layer IDLE/STREAMING */ | |
173 | enum mxr_layer_state state; | |
174 | ||
175 | /** mutex for protection of fields below */ | |
176 | struct mutex mutex; | |
177 | /** handler for video node */ | |
178 | struct video_device vfd; | |
179 | /** queue for output buffers */ | |
180 | struct vb2_queue vb_queue; | |
181 | /** current image format */ | |
182 | const struct mxr_format *fmt; | |
183 | /** current geometry of image */ | |
184 | struct mxr_geometry geo; | |
185 | }; | |
186 | ||
187 | /** description of mixers output interface */ | |
188 | struct mxr_output { | |
189 | /** name of output */ | |
190 | char name[32]; | |
191 | /** output subdev */ | |
192 | struct v4l2_subdev *sd; | |
193 | /** cookie used for configuration of registers */ | |
194 | int cookie; | |
195 | }; | |
196 | ||
197 | /** specify source of output subdevs */ | |
198 | struct mxr_output_conf { | |
199 | /** name of output (connector) */ | |
200 | char *output_name; | |
201 | /** name of module that generates output subdev */ | |
202 | char *module_name; | |
203 | /** cookie need for mixer HW */ | |
204 | int cookie; | |
205 | }; | |
206 | ||
207 | struct clk; | |
208 | struct regulator; | |
209 | ||
210 | /** auxiliary resources used my mixer */ | |
211 | struct mxr_resources { | |
212 | /** interrupt index */ | |
213 | int irq; | |
214 | /** pointer to Mixer registers */ | |
215 | void __iomem *mxr_regs; | |
216 | /** pointer to Video Processor registers */ | |
217 | void __iomem *vp_regs; | |
218 | /** other resources, should used under mxr_device.mutex */ | |
219 | struct clk *mixer; | |
220 | struct clk *vp; | |
221 | struct clk *sclk_mixer; | |
222 | struct clk *sclk_hdmi; | |
223 | struct clk *sclk_dac; | |
224 | }; | |
225 | ||
226 | /* event flags used */ | |
227 | enum mxr_devide_flags { | |
228 | MXR_EVENT_VSYNC = 0, | |
229 | }; | |
230 | ||
231 | /** drivers instance */ | |
232 | struct mxr_device { | |
233 | /** master device */ | |
234 | struct device *dev; | |
235 | /** state of each layer */ | |
236 | struct mxr_layer *layer[MXR_MAX_LAYERS]; | |
237 | /** state of each output */ | |
238 | struct mxr_output *output[MXR_MAX_OUTPUTS]; | |
239 | /** number of registered outputs */ | |
240 | int output_cnt; | |
241 | ||
242 | /* video resources */ | |
243 | ||
244 | /** V4L2 device */ | |
245 | struct v4l2_device v4l2_dev; | |
246 | /** context of allocator */ | |
247 | void *alloc_ctx; | |
248 | /** event wait queue */ | |
249 | wait_queue_head_t event_queue; | |
250 | /** state flags */ | |
251 | unsigned long event_flags; | |
252 | ||
253 | /** spinlock for protection of registers */ | |
254 | spinlock_t reg_slock; | |
255 | ||
256 | /** mutex for protection of fields below */ | |
257 | struct mutex mutex; | |
258 | /** number of entities depndant on output configuration */ | |
259 | int n_output; | |
260 | /** number of users that do streaming */ | |
261 | int n_streamer; | |
262 | /** index of current output */ | |
263 | int current_output; | |
264 | /** auxiliary resources used my mixer */ | |
265 | struct mxr_resources res; | |
266 | }; | |
267 | ||
268 | /** transform device structure into mixer device */ | |
269 | static inline struct mxr_device *to_mdev(struct device *dev) | |
270 | { | |
271 | struct v4l2_device *vdev = dev_get_drvdata(dev); | |
272 | return container_of(vdev, struct mxr_device, v4l2_dev); | |
273 | } | |
274 | ||
275 | /** get current output data, should be called under mdev's mutex */ | |
276 | static inline struct mxr_output *to_output(struct mxr_device *mdev) | |
277 | { | |
278 | return mdev->output[mdev->current_output]; | |
279 | } | |
280 | ||
281 | /** get current output subdev, should be called under mdev's mutex */ | |
282 | static inline struct v4l2_subdev *to_outsd(struct mxr_device *mdev) | |
283 | { | |
284 | struct mxr_output *out = to_output(mdev); | |
285 | return out ? out->sd : NULL; | |
286 | } | |
287 | ||
288 | /** forward declaration for mixer platform data */ | |
289 | struct mxr_platform_data; | |
290 | ||
291 | /** acquiring common video resources */ | |
292 | int __devinit mxr_acquire_video(struct mxr_device *mdev, | |
293 | struct mxr_output_conf *output_cont, int output_count); | |
294 | ||
295 | /** releasing common video resources */ | |
296 | void __devexit mxr_release_video(struct mxr_device *mdev); | |
297 | ||
298 | struct mxr_layer *mxr_graph_layer_create(struct mxr_device *mdev, int idx); | |
299 | struct mxr_layer *mxr_vp_layer_create(struct mxr_device *mdev, int idx); | |
300 | struct mxr_layer *mxr_base_layer_create(struct mxr_device *mdev, | |
301 | int idx, char *name, struct mxr_layer_ops *ops); | |
302 | ||
303 | void mxr_base_layer_release(struct mxr_layer *layer); | |
304 | void mxr_layer_release(struct mxr_layer *layer); | |
305 | ||
306 | int mxr_base_layer_register(struct mxr_layer *layer); | |
307 | void mxr_base_layer_unregister(struct mxr_layer *layer); | |
308 | ||
309 | unsigned long mxr_get_plane_size(const struct mxr_block *blk, | |
310 | unsigned int width, unsigned int height); | |
311 | ||
312 | /** adds new consumer for mixer's power */ | |
313 | int __must_check mxr_power_get(struct mxr_device *mdev); | |
314 | /** removes consumer for mixer's power */ | |
315 | void mxr_power_put(struct mxr_device *mdev); | |
316 | /** add new client for output configuration */ | |
317 | void mxr_output_get(struct mxr_device *mdev); | |
318 | /** removes new client for output configuration */ | |
319 | void mxr_output_put(struct mxr_device *mdev); | |
320 | /** add new client for streaming */ | |
321 | void mxr_streamer_get(struct mxr_device *mdev); | |
322 | /** removes new client for streaming */ | |
323 | void mxr_streamer_put(struct mxr_device *mdev); | |
324 | /** returns format of data delivared to current output */ | |
325 | void mxr_get_mbus_fmt(struct mxr_device *mdev, | |
326 | struct v4l2_mbus_framefmt *mbus_fmt); | |
327 | ||
328 | /* Debug */ | |
329 | ||
330 | #define mxr_err(mdev, fmt, ...) dev_err(mdev->dev, fmt, ##__VA_ARGS__) | |
331 | #define mxr_warn(mdev, fmt, ...) dev_warn(mdev->dev, fmt, ##__VA_ARGS__) | |
332 | #define mxr_info(mdev, fmt, ...) dev_info(mdev->dev, fmt, ##__VA_ARGS__) | |
333 | ||
334 | #ifdef CONFIG_VIDEO_SAMSUNG_S5P_MIXER_DEBUG | |
335 | #define mxr_dbg(mdev, fmt, ...) dev_dbg(mdev->dev, fmt, ##__VA_ARGS__) | |
336 | #else | |
337 | #define mxr_dbg(mdev, fmt, ...) do { (void) mdev; } while (0) | |
338 | #endif | |
339 | ||
340 | /* accessing Mixer's and Video Processor's registers */ | |
341 | ||
342 | void mxr_vsync_set_update(struct mxr_device *mdev, int en); | |
343 | void mxr_reg_reset(struct mxr_device *mdev); | |
344 | irqreturn_t mxr_irq_handler(int irq, void *dev_data); | |
345 | void mxr_reg_s_output(struct mxr_device *mdev, int cookie); | |
346 | void mxr_reg_streamon(struct mxr_device *mdev); | |
347 | void mxr_reg_streamoff(struct mxr_device *mdev); | |
348 | int mxr_reg_wait4vsync(struct mxr_device *mdev); | |
349 | void mxr_reg_set_mbus_fmt(struct mxr_device *mdev, | |
350 | struct v4l2_mbus_framefmt *fmt); | |
351 | void mxr_reg_graph_layer_stream(struct mxr_device *mdev, int idx, int en); | |
352 | void mxr_reg_graph_buffer(struct mxr_device *mdev, int idx, dma_addr_t addr); | |
353 | void mxr_reg_graph_format(struct mxr_device *mdev, int idx, | |
354 | const struct mxr_format *fmt, const struct mxr_geometry *geo); | |
355 | ||
356 | void mxr_reg_vp_layer_stream(struct mxr_device *mdev, int en); | |
357 | void mxr_reg_vp_buffer(struct mxr_device *mdev, | |
358 | dma_addr_t luma_addr[2], dma_addr_t chroma_addr[2]); | |
359 | void mxr_reg_vp_format(struct mxr_device *mdev, | |
360 | const struct mxr_format *fmt, const struct mxr_geometry *geo); | |
361 | void mxr_reg_dump(struct mxr_device *mdev); | |
362 | ||
363 | #endif /* SAMSUNG_MIXER_H */ | |
364 |