740ea5a9202f3d2e59262ef6a77c755711329d40
[linux-2.6.git] / drivers / media / video / v4l2-common.c
1 /*
2  *      Video for Linux Two
3  *
4  *      A generic video device interface for the LINUX operating system
5  *      using a set of device structures/vectors for low level operations.
6  *
7  *      This file replaces the videodev.c file that comes with the
8  *      regular kernel distribution.
9  *
10  *      This program is free software; you can redistribute it and/or
11  *      modify it under the terms of the GNU General Public License
12  *      as published by the Free Software Foundation; either version
13  *      2 of the License, or (at your option) any later version.
14  *
15  * Author:      Bill Dirks <bill@thedirks.org>
16  *              based on code by Alan Cox, <alan@cymru.net>
17  *
18  */
19
20 /*
21  * Video capture interface for Linux
22  *
23  *      A generic video device interface for the LINUX operating system
24  *      using a set of device structures/vectors for low level operations.
25  *
26  *              This program is free software; you can redistribute it and/or
27  *              modify it under the terms of the GNU General Public License
28  *              as published by the Free Software Foundation; either version
29  *              2 of the License, or (at your option) any later version.
30  *
31  * Author:      Alan Cox, <alan@redhat.com>
32  *
33  * Fixes:
34  */
35
36 /*
37  * Video4linux 1/2 integration by Justin Schoeman
38  * <justin@suntiger.ee.up.ac.za>
39  * 2.4 PROCFS support ported from 2.4 kernels by
40  *  Iñaki García Etxebarria <garetxe@euskalnet.net>
41  * Makefile fix by "W. Michael Petullo" <mike@flyn.org>
42  * 2.4 devfs support ported from 2.4 kernels by
43  *  Dan Merillat <dan@merillat.org>
44  * Added Gerd Knorrs v4l1 enhancements (Justin Schoeman)
45  */
46
47 #include <linux/module.h>
48 #include <linux/types.h>
49 #include <linux/kernel.h>
50 #include <linux/smp_lock.h>
51 #include <linux/mm.h>
52 #include <linux/string.h>
53 #include <linux/errno.h>
54 #include <linux/i2c.h>
55 #include <asm/uaccess.h>
56 #include <asm/system.h>
57 #include <asm/pgtable.h>
58 #include <asm/io.h>
59 #include <asm/div64.h>
60 #include <linux/video_decoder.h>
61 #define __OLD_VIDIOC_ /* To allow fixing old calls*/
62 #include <media/v4l2-common.h>
63
64 #ifdef CONFIG_KMOD
65 #include <linux/kmod.h>
66 #endif
67
68 #if defined(CONFIG_UST) || defined(CONFIG_UST_MODULE)
69 #include <linux/ust.h>
70 #endif
71
72
73 #include <linux/videodev.h>
74
75 MODULE_AUTHOR("Bill Dirks, Justin Schoeman, Gerd Knorr");
76 MODULE_DESCRIPTION("misc helper functions for v4l2 device drivers");
77 MODULE_LICENSE("GPL");
78
79 /*
80  *
81  *      V 4 L 2   D R I V E R   H E L P E R   A P I
82  *
83  */
84
85 /*
86  *  Video Standard Operations (contributed by Michael Schimek)
87  */
88
89
90 char *v4l2_norm_to_name(v4l2_std_id id)
91 {
92         char *name;
93         u32 myid = id;
94
95         /* HACK: ppc32 architecture doesn't have __ucmpdi2 function to handle
96            64 bit comparations. So, on that architecture, with some gcc variants,
97            compilation fails. Currently, the max value is 30bit wide.
98          */
99         BUG_ON(myid != id);
100
101         switch (myid) {
102         case V4L2_STD_PAL:
103                 name="PAL";             break;
104         case V4L2_STD_PAL_BG:
105                 name="PAL-BG";          break;
106         case V4L2_STD_PAL_DK:
107                 name="PAL-DK";          break;
108         case V4L2_STD_PAL_B:
109                 name="PAL-B";           break;
110         case V4L2_STD_PAL_B1:
111                 name="PAL-B1";          break;
112         case V4L2_STD_PAL_G:
113                 name="PAL-G";           break;
114         case V4L2_STD_PAL_H:
115                 name="PAL-H";           break;
116         case V4L2_STD_PAL_I:
117                 name="PAL-I";           break;
118         case V4L2_STD_PAL_D:
119                 name="PAL-D";           break;
120         case V4L2_STD_PAL_D1:
121                 name="PAL-D1";          break;
122         case V4L2_STD_PAL_K:
123                 name="PAL-K";           break;
124         case V4L2_STD_PAL_M:
125                 name="PAL-M";           break;
126         case V4L2_STD_PAL_N:
127                 name="PAL-N";           break;
128         case V4L2_STD_PAL_Nc:
129                 name="PAL-Nc";          break;
130         case V4L2_STD_PAL_60:
131                 name="PAL-60";          break;
132         case V4L2_STD_NTSC:
133                 name="NTSC";            break;
134         case V4L2_STD_NTSC_M:
135                 name="NTSC-M";          break;
136         case V4L2_STD_NTSC_M_JP:
137                 name="NTSC-M-JP";       break;
138         case V4L2_STD_NTSC_443:
139                 name="NTSC-443";        break;
140         case V4L2_STD_NTSC_M_KR:
141                 name="NTSC-M-KR";       break;
142         case V4L2_STD_SECAM:
143                 name="SECAM";           break;
144         case V4L2_STD_SECAM_DK:
145                 name="SECAM-DK";        break;
146         case V4L2_STD_SECAM_B:
147                 name="SECAM-B";         break;
148         case V4L2_STD_SECAM_D:
149                 name="SECAM-D";         break;
150         case V4L2_STD_SECAM_G:
151                 name="SECAM-G";         break;
152         case V4L2_STD_SECAM_H:
153                 name="SECAM-H";         break;
154         case V4L2_STD_SECAM_K:
155                 name="SECAM-K";         break;
156         case V4L2_STD_SECAM_K1:
157                 name="SECAM-K1";        break;
158         case V4L2_STD_SECAM_L:
159                 name="SECAM-L";         break;
160         case V4L2_STD_SECAM_LC:
161                 name="SECAM-LC";        break;
162         default:
163                 name="Unknown";         break;
164         }
165
166         return name;
167 }
168
169 /* Fill in the fields of a v4l2_standard structure according to the
170    'id' and 'transmission' parameters.  Returns negative on error.  */
171 int v4l2_video_std_construct(struct v4l2_standard *vs,
172                              int id, char *name)
173 {
174         u32 index = vs->index;
175
176         memset(vs, 0, sizeof(struct v4l2_standard));
177         vs->index = index;
178         vs->id    = id;
179         if (id & V4L2_STD_525_60) {
180                 vs->frameperiod.numerator = 1001;
181                 vs->frameperiod.denominator = 30000;
182                 vs->framelines = 525;
183         } else {
184                 vs->frameperiod.numerator = 1;
185                 vs->frameperiod.denominator = 25;
186                 vs->framelines = 625;
187         }
188         strlcpy(vs->name,name,sizeof(vs->name));
189         return 0;
190 }
191
192 /* ----------------------------------------------------------------- */
193 /* priority handling                                                 */
194
195 #define V4L2_PRIO_VALID(val) (val == V4L2_PRIORITY_BACKGROUND   || \
196                               val == V4L2_PRIORITY_INTERACTIVE  || \
197                               val == V4L2_PRIORITY_RECORD)
198
199 int v4l2_prio_init(struct v4l2_prio_state *global)
200 {
201         memset(global,0,sizeof(*global));
202         return 0;
203 }
204
205 int v4l2_prio_change(struct v4l2_prio_state *global, enum v4l2_priority *local,
206                      enum v4l2_priority new)
207 {
208         if (!V4L2_PRIO_VALID(new))
209                 return -EINVAL;
210         if (*local == new)
211                 return 0;
212
213         atomic_inc(&global->prios[new]);
214         if (V4L2_PRIO_VALID(*local))
215                 atomic_dec(&global->prios[*local]);
216         *local = new;
217         return 0;
218 }
219
220 int v4l2_prio_open(struct v4l2_prio_state *global, enum v4l2_priority *local)
221 {
222         return v4l2_prio_change(global,local,V4L2_PRIORITY_DEFAULT);
223 }
224
225 int v4l2_prio_close(struct v4l2_prio_state *global, enum v4l2_priority *local)
226 {
227         if (V4L2_PRIO_VALID(*local))
228                 atomic_dec(&global->prios[*local]);
229         return 0;
230 }
231
232 enum v4l2_priority v4l2_prio_max(struct v4l2_prio_state *global)
233 {
234         if (atomic_read(&global->prios[V4L2_PRIORITY_RECORD]) > 0)
235                 return V4L2_PRIORITY_RECORD;
236         if (atomic_read(&global->prios[V4L2_PRIORITY_INTERACTIVE]) > 0)
237                 return V4L2_PRIORITY_INTERACTIVE;
238         if (atomic_read(&global->prios[V4L2_PRIORITY_BACKGROUND]) > 0)
239                 return V4L2_PRIORITY_BACKGROUND;
240         return V4L2_PRIORITY_UNSET;
241 }
242
243 int v4l2_prio_check(struct v4l2_prio_state *global, enum v4l2_priority *local)
244 {
245         if (*local < v4l2_prio_max(global))
246                 return -EBUSY;
247         return 0;
248 }
249
250
251 /* ----------------------------------------------------------------- */
252 /* some arrays for pretty-printing debug messages of enum types      */
253
254 char *v4l2_field_names[] = {
255         [V4L2_FIELD_ANY]        = "any",
256         [V4L2_FIELD_NONE]       = "none",
257         [V4L2_FIELD_TOP]        = "top",
258         [V4L2_FIELD_BOTTOM]     = "bottom",
259         [V4L2_FIELD_INTERLACED] = "interlaced",
260         [V4L2_FIELD_SEQ_TB]     = "seq-tb",
261         [V4L2_FIELD_SEQ_BT]     = "seq-bt",
262         [V4L2_FIELD_ALTERNATE]  = "alternate",
263         [V4L2_FIELD_INTERLACED_TB] = "interlaced-tb",
264         [V4L2_FIELD_INTERLACED_BT] = "interlaced-bt",
265 };
266
267 char *v4l2_type_names[] = {
268         [V4L2_BUF_TYPE_VIDEO_CAPTURE]      = "video-cap",
269         [V4L2_BUF_TYPE_VIDEO_OVERLAY]      = "video-over",
270         [V4L2_BUF_TYPE_VIDEO_OUTPUT]       = "video-out",
271         [V4L2_BUF_TYPE_VBI_CAPTURE]        = "vbi-cap",
272         [V4L2_BUF_TYPE_VBI_OUTPUT]         = "vbi-out",
273         [V4L2_BUF_TYPE_SLICED_VBI_CAPTURE] = "sliced-vbi-cap",
274         [V4L2_BUF_TYPE_SLICED_VBI_OUTPUT]  = "sliced-vbi-out",
275         [V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY] = "video-out-over",
276 };
277
278
279 #define prt_names(a,arr) (((a)>=0)&&((a)<ARRAY_SIZE(arr)))?arr[a]:"unknown"
280
281 /* ------------------------------------------------------------------ */
282 /* debug help functions                                               */
283
284 #ifdef CONFIG_VIDEO_V4L1_COMPAT
285 static const char *v4l1_ioctls[] = {
286         [_IOC_NR(VIDIOCGCAP)]       = "VIDIOCGCAP",
287         [_IOC_NR(VIDIOCGCHAN)]      = "VIDIOCGCHAN",
288         [_IOC_NR(VIDIOCSCHAN)]      = "VIDIOCSCHAN",
289         [_IOC_NR(VIDIOCGTUNER)]     = "VIDIOCGTUNER",
290         [_IOC_NR(VIDIOCSTUNER)]     = "VIDIOCSTUNER",
291         [_IOC_NR(VIDIOCGPICT)]      = "VIDIOCGPICT",
292         [_IOC_NR(VIDIOCSPICT)]      = "VIDIOCSPICT",
293         [_IOC_NR(VIDIOCCAPTURE)]    = "VIDIOCCAPTURE",
294         [_IOC_NR(VIDIOCGWIN)]       = "VIDIOCGWIN",
295         [_IOC_NR(VIDIOCSWIN)]       = "VIDIOCSWIN",
296         [_IOC_NR(VIDIOCGFBUF)]      = "VIDIOCGFBUF",
297         [_IOC_NR(VIDIOCSFBUF)]      = "VIDIOCSFBUF",
298         [_IOC_NR(VIDIOCKEY)]        = "VIDIOCKEY",
299         [_IOC_NR(VIDIOCGFREQ)]      = "VIDIOCGFREQ",
300         [_IOC_NR(VIDIOCSFREQ)]      = "VIDIOCSFREQ",
301         [_IOC_NR(VIDIOCGAUDIO)]     = "VIDIOCGAUDIO",
302         [_IOC_NR(VIDIOCSAUDIO)]     = "VIDIOCSAUDIO",
303         [_IOC_NR(VIDIOCSYNC)]       = "VIDIOCSYNC",
304         [_IOC_NR(VIDIOCMCAPTURE)]   = "VIDIOCMCAPTURE",
305         [_IOC_NR(VIDIOCGMBUF)]      = "VIDIOCGMBUF",
306         [_IOC_NR(VIDIOCGUNIT)]      = "VIDIOCGUNIT",
307         [_IOC_NR(VIDIOCGCAPTURE)]   = "VIDIOCGCAPTURE",
308         [_IOC_NR(VIDIOCSCAPTURE)]   = "VIDIOCSCAPTURE",
309         [_IOC_NR(VIDIOCSPLAYMODE)]  = "VIDIOCSPLAYMODE",
310         [_IOC_NR(VIDIOCSWRITEMODE)] = "VIDIOCSWRITEMODE",
311         [_IOC_NR(VIDIOCGPLAYINFO)]  = "VIDIOCGPLAYINFO",
312         [_IOC_NR(VIDIOCSMICROCODE)] = "VIDIOCSMICROCODE",
313         [_IOC_NR(VIDIOCGVBIFMT)]    = "VIDIOCGVBIFMT",
314         [_IOC_NR(VIDIOCSVBIFMT)]    = "VIDIOCSVBIFMT"
315 };
316 #define V4L1_IOCTLS ARRAY_SIZE(v4l1_ioctls)
317 #endif
318
319 static const char *v4l2_ioctls[] = {
320         [_IOC_NR(VIDIOC_QUERYCAP)]         = "VIDIOC_QUERYCAP",
321         [_IOC_NR(VIDIOC_RESERVED)]         = "VIDIOC_RESERVED",
322         [_IOC_NR(VIDIOC_ENUM_FMT)]         = "VIDIOC_ENUM_FMT",
323         [_IOC_NR(VIDIOC_G_FMT)]            = "VIDIOC_G_FMT",
324         [_IOC_NR(VIDIOC_S_FMT)]            = "VIDIOC_S_FMT",
325         [_IOC_NR(VIDIOC_G_MPEGCOMP)]       = "VIDIOC_G_MPEGCOMP",
326         [_IOC_NR(VIDIOC_S_MPEGCOMP)]       = "VIDIOC_S_MPEGCOMP",
327         [_IOC_NR(VIDIOC_REQBUFS)]          = "VIDIOC_REQBUFS",
328         [_IOC_NR(VIDIOC_QUERYBUF)]         = "VIDIOC_QUERYBUF",
329         [_IOC_NR(VIDIOC_G_FBUF)]           = "VIDIOC_G_FBUF",
330         [_IOC_NR(VIDIOC_S_FBUF)]           = "VIDIOC_S_FBUF",
331         [_IOC_NR(VIDIOC_OVERLAY)]          = "VIDIOC_OVERLAY",
332         [_IOC_NR(VIDIOC_QBUF)]             = "VIDIOC_QBUF",
333         [_IOC_NR(VIDIOC_DQBUF)]            = "VIDIOC_DQBUF",
334         [_IOC_NR(VIDIOC_STREAMON)]         = "VIDIOC_STREAMON",
335         [_IOC_NR(VIDIOC_STREAMOFF)]        = "VIDIOC_STREAMOFF",
336         [_IOC_NR(VIDIOC_G_PARM)]           = "VIDIOC_G_PARM",
337         [_IOC_NR(VIDIOC_S_PARM)]           = "VIDIOC_S_PARM",
338         [_IOC_NR(VIDIOC_G_STD)]            = "VIDIOC_G_STD",
339         [_IOC_NR(VIDIOC_S_STD)]            = "VIDIOC_S_STD",
340         [_IOC_NR(VIDIOC_ENUMSTD)]          = "VIDIOC_ENUMSTD",
341         [_IOC_NR(VIDIOC_ENUMINPUT)]        = "VIDIOC_ENUMINPUT",
342         [_IOC_NR(VIDIOC_G_CTRL)]           = "VIDIOC_G_CTRL",
343         [_IOC_NR(VIDIOC_S_CTRL)]           = "VIDIOC_S_CTRL",
344         [_IOC_NR(VIDIOC_G_TUNER)]          = "VIDIOC_G_TUNER",
345         [_IOC_NR(VIDIOC_S_TUNER)]          = "VIDIOC_S_TUNER",
346         [_IOC_NR(VIDIOC_G_AUDIO)]          = "VIDIOC_G_AUDIO",
347         [_IOC_NR(VIDIOC_S_AUDIO)]          = "VIDIOC_S_AUDIO",
348         [_IOC_NR(VIDIOC_QUERYCTRL)]        = "VIDIOC_QUERYCTRL",
349         [_IOC_NR(VIDIOC_QUERYMENU)]        = "VIDIOC_QUERYMENU",
350         [_IOC_NR(VIDIOC_G_INPUT)]          = "VIDIOC_G_INPUT",
351         [_IOC_NR(VIDIOC_S_INPUT)]          = "VIDIOC_S_INPUT",
352         [_IOC_NR(VIDIOC_G_OUTPUT)]         = "VIDIOC_G_OUTPUT",
353         [_IOC_NR(VIDIOC_S_OUTPUT)]         = "VIDIOC_S_OUTPUT",
354         [_IOC_NR(VIDIOC_ENUMOUTPUT)]       = "VIDIOC_ENUMOUTPUT",
355         [_IOC_NR(VIDIOC_G_AUDOUT)]         = "VIDIOC_G_AUDOUT",
356         [_IOC_NR(VIDIOC_S_AUDOUT)]         = "VIDIOC_S_AUDOUT",
357         [_IOC_NR(VIDIOC_G_MODULATOR)]      = "VIDIOC_G_MODULATOR",
358         [_IOC_NR(VIDIOC_S_MODULATOR)]      = "VIDIOC_S_MODULATOR",
359         [_IOC_NR(VIDIOC_G_FREQUENCY)]      = "VIDIOC_G_FREQUENCY",
360         [_IOC_NR(VIDIOC_S_FREQUENCY)]      = "VIDIOC_S_FREQUENCY",
361         [_IOC_NR(VIDIOC_CROPCAP)]          = "VIDIOC_CROPCAP",
362         [_IOC_NR(VIDIOC_G_CROP)]           = "VIDIOC_G_CROP",
363         [_IOC_NR(VIDIOC_S_CROP)]           = "VIDIOC_S_CROP",
364         [_IOC_NR(VIDIOC_G_JPEGCOMP)]       = "VIDIOC_G_JPEGCOMP",
365         [_IOC_NR(VIDIOC_S_JPEGCOMP)]       = "VIDIOC_S_JPEGCOMP",
366         [_IOC_NR(VIDIOC_QUERYSTD)]         = "VIDIOC_QUERYSTD",
367         [_IOC_NR(VIDIOC_TRY_FMT)]          = "VIDIOC_TRY_FMT",
368         [_IOC_NR(VIDIOC_ENUMAUDIO)]        = "VIDIOC_ENUMAUDIO",
369         [_IOC_NR(VIDIOC_ENUMAUDOUT)]       = "VIDIOC_ENUMAUDOUT",
370         [_IOC_NR(VIDIOC_G_PRIORITY)]       = "VIDIOC_G_PRIORITY",
371         [_IOC_NR(VIDIOC_S_PRIORITY)]       = "VIDIOC_S_PRIORITY",
372         [_IOC_NR(VIDIOC_G_SLICED_VBI_CAP)] = "VIDIOC_G_SLICED_VBI_CAP",
373         [_IOC_NR(VIDIOC_LOG_STATUS)]       = "VIDIOC_LOG_STATUS",
374         [_IOC_NR(VIDIOC_G_EXT_CTRLS)]      = "VIDIOC_G_EXT_CTRLS",
375         [_IOC_NR(VIDIOC_S_EXT_CTRLS)]      = "VIDIOC_S_EXT_CTRLS",
376         [_IOC_NR(VIDIOC_TRY_EXT_CTRLS)]    = "VIDIOC_TRY_EXT_CTRLS",
377 #if 1
378         [_IOC_NR(VIDIOC_ENUM_FRAMESIZES)]  = "VIDIOC_ENUM_FRAMESIZES",
379         [_IOC_NR(VIDIOC_ENUM_FRAMEINTERVALS)] = "VIDIOC_ENUM_FRAMEINTERVALS",
380         [_IOC_NR(VIDIOC_G_ENC_INDEX)]      = "VIDIOC_G_ENC_INDEX",
381         [_IOC_NR(VIDIOC_ENCODER_CMD)]      = "VIDIOC_ENCODER_CMD",
382         [_IOC_NR(VIDIOC_TRY_ENCODER_CMD)]  = "VIDIOC_TRY_ENCODER_CMD",
383
384         [_IOC_NR(VIDIOC_DBG_S_REGISTER)]   = "VIDIOC_DBG_S_REGISTER",
385         [_IOC_NR(VIDIOC_DBG_G_REGISTER)]   = "VIDIOC_DBG_G_REGISTER",
386 #endif
387 };
388 #define V4L2_IOCTLS ARRAY_SIZE(v4l2_ioctls)
389
390 static const char *v4l2_int_ioctls[] = {
391 #ifdef CONFIG_VIDEO_V4L1_COMPAT
392         [_IOC_NR(DECODER_GET_CAPABILITIES)]    = "DECODER_GET_CAPABILITIES",
393         [_IOC_NR(DECODER_GET_STATUS)]          = "DECODER_GET_STATUS",
394         [_IOC_NR(DECODER_SET_NORM)]            = "DECODER_SET_NORM",
395         [_IOC_NR(DECODER_SET_INPUT)]           = "DECODER_SET_INPUT",
396         [_IOC_NR(DECODER_SET_OUTPUT)]          = "DECODER_SET_OUTPUT",
397         [_IOC_NR(DECODER_ENABLE_OUTPUT)]       = "DECODER_ENABLE_OUTPUT",
398         [_IOC_NR(DECODER_SET_PICTURE)]         = "DECODER_SET_PICTURE",
399         [_IOC_NR(DECODER_SET_GPIO)]            = "DECODER_SET_GPIO",
400         [_IOC_NR(DECODER_INIT)]                = "DECODER_INIT",
401         [_IOC_NR(DECODER_SET_VBI_BYPASS)]      = "DECODER_SET_VBI_BYPASS",
402         [_IOC_NR(DECODER_DUMP)]                = "DECODER_DUMP",
403 #endif
404         [_IOC_NR(AUDC_SET_RADIO)]              = "AUDC_SET_RADIO",
405
406         [_IOC_NR(TUNER_SET_TYPE_ADDR)]         = "TUNER_SET_TYPE_ADDR",
407         [_IOC_NR(TUNER_SET_STANDBY)]           = "TUNER_SET_STANDBY",
408         [_IOC_NR(TDA9887_SET_CONFIG)]          = "TDA9887_SET_CONFIG",
409
410         [_IOC_NR(VIDIOC_INT_S_TUNER_MODE)]     = "VIDIOC_INT_S_TUNER_MODE",
411         [_IOC_NR(VIDIOC_INT_RESET)]            = "VIDIOC_INT_RESET",
412         [_IOC_NR(VIDIOC_INT_AUDIO_CLOCK_FREQ)] = "VIDIOC_INT_AUDIO_CLOCK_FREQ",
413         [_IOC_NR(VIDIOC_INT_DECODE_VBI_LINE)]  = "VIDIOC_INT_DECODE_VBI_LINE",
414         [_IOC_NR(VIDIOC_INT_S_VBI_DATA)]       = "VIDIOC_INT_S_VBI_DATA",
415         [_IOC_NR(VIDIOC_INT_G_VBI_DATA)]       = "VIDIOC_INT_G_VBI_DATA",
416         [_IOC_NR(VIDIOC_INT_G_CHIP_IDENT)]     = "VIDIOC_INT_G_CHIP_IDENT",
417         [_IOC_NR(VIDIOC_INT_I2S_CLOCK_FREQ)]   = "VIDIOC_INT_I2S_CLOCK_FREQ",
418         [_IOC_NR(VIDIOC_INT_S_STANDBY)]        = "VIDIOC_INT_S_STANDBY",
419         [_IOC_NR(VIDIOC_INT_S_AUDIO_ROUTING)]  = "VIDIOC_INT_S_AUDIO_ROUTING",
420         [_IOC_NR(VIDIOC_INT_G_AUDIO_ROUTING)]  = "VIDIOC_INT_G_AUDIO_ROUTING",
421         [_IOC_NR(VIDIOC_INT_S_VIDEO_ROUTING)]  = "VIDIOC_INT_S_VIDEO_ROUTING",
422         [_IOC_NR(VIDIOC_INT_G_VIDEO_ROUTING)]  = "VIDIOC_INT_G_VIDEO_ROUTING",
423         [_IOC_NR(VIDIOC_INT_S_CRYSTAL_FREQ)]   = "VIDIOC_INT_S_CRYSTAL_FREQ"
424 };
425 #define V4L2_INT_IOCTLS ARRAY_SIZE(v4l2_int_ioctls)
426
427
428 /* Common ioctl debug function. This function can be used by
429    external ioctl messages as well as internal V4L ioctl */
430 void v4l_printk_ioctl(unsigned int cmd)
431 {
432         char *dir;
433
434         switch (_IOC_DIR(cmd)) {
435         case _IOC_NONE:              dir = "--"; break;
436         case _IOC_READ:              dir = "r-"; break;
437         case _IOC_WRITE:             dir = "-w"; break;
438         case _IOC_READ | _IOC_WRITE: dir = "rw"; break;
439         default:                     dir = "*ERR*"; break;
440         }
441         switch (_IOC_TYPE(cmd)) {
442         case 'd':
443                 printk("v4l2_int ioctl %s, dir=%s (0x%08x)\n",
444                        (_IOC_NR(cmd) < V4L2_INT_IOCTLS) ?
445                        v4l2_int_ioctls[_IOC_NR(cmd)] : "UNKNOWN", dir, cmd);
446                 break;
447 #ifdef CONFIG_VIDEO_V4L1_COMPAT
448         case 'v':
449                 printk("v4l1 ioctl %s, dir=%s (0x%08x)\n",
450                        (_IOC_NR(cmd) < V4L1_IOCTLS) ?
451                        v4l1_ioctls[_IOC_NR(cmd)] : "UNKNOWN", dir, cmd);
452                 break;
453 #endif
454         case 'V':
455                 printk("v4l2 ioctl %s, dir=%s (0x%08x)\n",
456                        (_IOC_NR(cmd) < V4L2_IOCTLS) ?
457                        v4l2_ioctls[_IOC_NR(cmd)] : "UNKNOWN", dir, cmd);
458                 break;
459
460         default:
461                 printk("unknown ioctl '%c', dir=%s, #%d (0x%08x)\n",
462                        _IOC_TYPE(cmd), dir, _IOC_NR(cmd), cmd);
463         }
464 }
465
466
467 /* ----------------------------------------------------------------- */
468
469 /* Helper functions for control handling                             */
470
471 /* Check for correctness of the ctrl's value based on the data from
472    struct v4l2_queryctrl and the available menu items. Note that
473    menu_items may be NULL, in that case it is ignored. */
474 int v4l2_ctrl_check(struct v4l2_ext_control *ctrl, struct v4l2_queryctrl *qctrl,
475                 const char **menu_items)
476 {
477         if (qctrl->flags & V4L2_CTRL_FLAG_DISABLED)
478                 return -EINVAL;
479         if (qctrl->flags & V4L2_CTRL_FLAG_GRABBED)
480                 return -EBUSY;
481         if (qctrl->type == V4L2_CTRL_TYPE_BUTTON ||
482             qctrl->type == V4L2_CTRL_TYPE_INTEGER64 ||
483             qctrl->type == V4L2_CTRL_TYPE_CTRL_CLASS)
484                 return 0;
485         if (ctrl->value < qctrl->minimum || ctrl->value > qctrl->maximum)
486                 return -ERANGE;
487         if (qctrl->type == V4L2_CTRL_TYPE_MENU && menu_items != NULL) {
488                 if (menu_items[ctrl->value] == NULL ||
489                     menu_items[ctrl->value][0] == '\0')
490                         return -EINVAL;
491         }
492         return 0;
493 }
494
495 /* Returns NULL or a character pointer array containing the menu for
496    the given control ID. The pointer array ends with a NULL pointer.
497    An empty string signifies a menu entry that is invalid. This allows
498    drivers to disable certain options if it is not supported. */
499 const char **v4l2_ctrl_get_menu(u32 id)
500 {
501         static const char *mpeg_audio_sampling_freq[] = {
502                 "44.1 kHz",
503                 "48 kHz",
504                 "32 kHz",
505                 NULL
506         };
507         static const char *mpeg_audio_encoding[] = {
508                 "Layer I",
509                 "Layer II",
510                 "Layer III",
511                 NULL
512         };
513         static const char *mpeg_audio_l1_bitrate[] = {
514                 "32 kbps",
515                 "64 kbps",
516                 "96 kbps",
517                 "128 kbps",
518                 "160 kbps",
519                 "192 kbps",
520                 "224 kbps",
521                 "256 kbps",
522                 "288 kbps",
523                 "320 kbps",
524                 "352 kbps",
525                 "384 kbps",
526                 "416 kbps",
527                 "448 kbps",
528                 NULL
529         };
530         static const char *mpeg_audio_l2_bitrate[] = {
531                 "32 kbps",
532                 "48 kbps",
533                 "56 kbps",
534                 "64 kbps",
535                 "80 kbps",
536                 "96 kbps",
537                 "112 kbps",
538                 "128 kbps",
539                 "160 kbps",
540                 "192 kbps",
541                 "224 kbps",
542                 "256 kbps",
543                 "320 kbps",
544                 "384 kbps",
545                 NULL
546         };
547         static const char *mpeg_audio_l3_bitrate[] = {
548                 "32 kbps",
549                 "40 kbps",
550                 "48 kbps",
551                 "56 kbps",
552                 "64 kbps",
553                 "80 kbps",
554                 "96 kbps",
555                 "112 kbps",
556                 "128 kbps",
557                 "160 kbps",
558                 "192 kbps",
559                 "224 kbps",
560                 "256 kbps",
561                 "320 kbps",
562                 NULL
563         };
564         static const char *mpeg_audio_mode[] = {
565                 "Stereo",
566                 "Joint Stereo",
567                 "Dual",
568                 "Mono",
569                 NULL
570         };
571         static const char *mpeg_audio_mode_extension[] = {
572                 "Bound 4",
573                 "Bound 8",
574                 "Bound 12",
575                 "Bound 16",
576                 NULL
577         };
578         static const char *mpeg_audio_emphasis[] = {
579                 "No Emphasis",
580                 "50/15 us",
581                 "CCITT J17",
582                 NULL
583         };
584         static const char *mpeg_audio_crc[] = {
585                 "No CRC",
586                 "16-bit CRC",
587                 NULL
588         };
589         static const char *mpeg_video_encoding[] = {
590                 "MPEG-1",
591                 "MPEG-2",
592                 NULL
593         };
594         static const char *mpeg_video_aspect[] = {
595                 "1x1",
596                 "4x3",
597                 "16x9",
598                 "2.21x1",
599                 NULL
600         };
601         static const char *mpeg_video_bitrate_mode[] = {
602                 "Variable Bitrate",
603                 "Constant Bitrate",
604                 NULL
605         };
606         static const char *mpeg_stream_type[] = {
607                 "MPEG-2 Program Stream",
608                 "MPEG-2 Transport Stream",
609                 "MPEG-1 System Stream",
610                 "MPEG-2 DVD-compatible Stream",
611                 "MPEG-1 VCD-compatible Stream",
612                 "MPEG-2 SVCD-compatible Stream",
613                 NULL
614         };
615         static const char *mpeg_stream_vbi_fmt[] = {
616                 "No VBI",
617                 "Private packet, IVTV format",
618                 NULL
619         };
620
621         switch (id) {
622                 case V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ:
623                         return mpeg_audio_sampling_freq;
624                 case V4L2_CID_MPEG_AUDIO_ENCODING:
625                         return mpeg_audio_encoding;
626                 case V4L2_CID_MPEG_AUDIO_L1_BITRATE:
627                         return mpeg_audio_l1_bitrate;
628                 case V4L2_CID_MPEG_AUDIO_L2_BITRATE:
629                         return mpeg_audio_l2_bitrate;
630                 case V4L2_CID_MPEG_AUDIO_L3_BITRATE:
631                         return mpeg_audio_l3_bitrate;
632                 case V4L2_CID_MPEG_AUDIO_MODE:
633                         return mpeg_audio_mode;
634                 case V4L2_CID_MPEG_AUDIO_MODE_EXTENSION:
635                         return mpeg_audio_mode_extension;
636                 case V4L2_CID_MPEG_AUDIO_EMPHASIS:
637                         return mpeg_audio_emphasis;
638                 case V4L2_CID_MPEG_AUDIO_CRC:
639                         return mpeg_audio_crc;
640                 case V4L2_CID_MPEG_VIDEO_ENCODING:
641                         return mpeg_video_encoding;
642                 case V4L2_CID_MPEG_VIDEO_ASPECT:
643                         return mpeg_video_aspect;
644                 case V4L2_CID_MPEG_VIDEO_BITRATE_MODE:
645                         return mpeg_video_bitrate_mode;
646                 case V4L2_CID_MPEG_STREAM_TYPE:
647                         return mpeg_stream_type;
648                 case V4L2_CID_MPEG_STREAM_VBI_FMT:
649                         return mpeg_stream_vbi_fmt;
650                 default:
651                         return NULL;
652         }
653 }
654
655 /* Fill in a struct v4l2_queryctrl */
656 int v4l2_ctrl_query_fill(struct v4l2_queryctrl *qctrl, s32 min, s32 max, s32 step, s32 def)
657 {
658         const char *name;
659
660         qctrl->flags = 0;
661         switch (qctrl->id) {
662         /* USER controls */
663         case V4L2_CID_USER_CLASS:       name = "User Controls"; break;
664         case V4L2_CID_AUDIO_VOLUME:     name = "Volume"; break;
665         case V4L2_CID_AUDIO_MUTE:       name = "Mute"; break;
666         case V4L2_CID_AUDIO_BALANCE:    name = "Balance"; break;
667         case V4L2_CID_AUDIO_BASS:       name = "Bass"; break;
668         case V4L2_CID_AUDIO_TREBLE:     name = "Treble"; break;
669         case V4L2_CID_AUDIO_LOUDNESS:   name = "Loudness"; break;
670         case V4L2_CID_BRIGHTNESS:       name = "Brightness"; break;
671         case V4L2_CID_CONTRAST:         name = "Contrast"; break;
672         case V4L2_CID_SATURATION:       name = "Saturation"; break;
673         case V4L2_CID_HUE:              name = "Hue"; break;
674
675         /* MPEG controls */
676         case V4L2_CID_MPEG_CLASS:               name = "MPEG Encoder Controls"; break;
677         case V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ: name = "Audio Sampling Frequency"; break;
678         case V4L2_CID_MPEG_AUDIO_ENCODING:      name = "Audio Encoding Layer"; break;
679         case V4L2_CID_MPEG_AUDIO_L1_BITRATE:    name = "Audio Layer I Bitrate"; break;
680         case V4L2_CID_MPEG_AUDIO_L2_BITRATE:    name = "Audio Layer II Bitrate"; break;
681         case V4L2_CID_MPEG_AUDIO_L3_BITRATE:    name = "Audio Layer III Bitrate"; break;
682         case V4L2_CID_MPEG_AUDIO_MODE:          name = "Audio Stereo Mode"; break;
683         case V4L2_CID_MPEG_AUDIO_MODE_EXTENSION: name = "Audio Stereo Mode Extension"; break;
684         case V4L2_CID_MPEG_AUDIO_EMPHASIS:      name = "Audio Emphasis"; break;
685         case V4L2_CID_MPEG_AUDIO_CRC:           name = "Audio CRC"; break;
686         case V4L2_CID_MPEG_AUDIO_MUTE:          name = "Audio Mute"; break;
687         case V4L2_CID_MPEG_VIDEO_ENCODING:      name = "Video Encoding"; break;
688         case V4L2_CID_MPEG_VIDEO_ASPECT:        name = "Video Aspect"; break;
689         case V4L2_CID_MPEG_VIDEO_B_FRAMES:      name = "Video B Frames"; break;
690         case V4L2_CID_MPEG_VIDEO_GOP_SIZE:      name = "Video GOP Size"; break;
691         case V4L2_CID_MPEG_VIDEO_GOP_CLOSURE:   name = "Video GOP Closure"; break;
692         case V4L2_CID_MPEG_VIDEO_PULLDOWN:      name = "Video Pulldown"; break;
693         case V4L2_CID_MPEG_VIDEO_BITRATE_MODE:  name = "Video Bitrate Mode"; break;
694         case V4L2_CID_MPEG_VIDEO_BITRATE:       name = "Video Bitrate"; break;
695         case V4L2_CID_MPEG_VIDEO_BITRATE_PEAK:  name = "Video Peak Bitrate"; break;
696         case V4L2_CID_MPEG_VIDEO_TEMPORAL_DECIMATION: name = "Video Temporal Decimation"; break;
697         case V4L2_CID_MPEG_VIDEO_MUTE:          name = "Video Mute"; break;
698         case V4L2_CID_MPEG_VIDEO_MUTE_YUV:      name = "Video Mute YUV"; break;
699         case V4L2_CID_MPEG_STREAM_TYPE:         name = "Stream Type"; break;
700         case V4L2_CID_MPEG_STREAM_PID_PMT:      name = "Stream PMT Program ID"; break;
701         case V4L2_CID_MPEG_STREAM_PID_AUDIO:    name = "Stream Audio Program ID"; break;
702         case V4L2_CID_MPEG_STREAM_PID_VIDEO:    name = "Stream Video Program ID"; break;
703         case V4L2_CID_MPEG_STREAM_PID_PCR:      name = "Stream PCR Program ID"; break;
704         case V4L2_CID_MPEG_STREAM_PES_ID_AUDIO: name = "Stream PES Audio ID"; break;
705         case V4L2_CID_MPEG_STREAM_PES_ID_VIDEO: name = "Stream PES Video ID"; break;
706         case V4L2_CID_MPEG_STREAM_VBI_FMT:      name = "Stream VBI Format"; break;
707
708         default:
709                 return -EINVAL;
710         }
711         switch (qctrl->id) {
712         case V4L2_CID_AUDIO_MUTE:
713         case V4L2_CID_AUDIO_LOUDNESS:
714         case V4L2_CID_MPEG_AUDIO_MUTE:
715         case V4L2_CID_MPEG_VIDEO_GOP_CLOSURE:
716         case V4L2_CID_MPEG_VIDEO_PULLDOWN:
717                 qctrl->type = V4L2_CTRL_TYPE_BOOLEAN;
718                 min = 0;
719                 max = step = 1;
720                 break;
721         case V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ:
722         case V4L2_CID_MPEG_AUDIO_ENCODING:
723         case V4L2_CID_MPEG_AUDIO_L1_BITRATE:
724         case V4L2_CID_MPEG_AUDIO_L2_BITRATE:
725         case V4L2_CID_MPEG_AUDIO_L3_BITRATE:
726         case V4L2_CID_MPEG_AUDIO_MODE:
727         case V4L2_CID_MPEG_AUDIO_MODE_EXTENSION:
728         case V4L2_CID_MPEG_AUDIO_EMPHASIS:
729         case V4L2_CID_MPEG_AUDIO_CRC:
730         case V4L2_CID_MPEG_VIDEO_ENCODING:
731         case V4L2_CID_MPEG_VIDEO_ASPECT:
732         case V4L2_CID_MPEG_VIDEO_BITRATE_MODE:
733         case V4L2_CID_MPEG_STREAM_TYPE:
734         case V4L2_CID_MPEG_STREAM_VBI_FMT:
735                 qctrl->type = V4L2_CTRL_TYPE_MENU;
736                 step = 1;
737                 break;
738         case V4L2_CID_USER_CLASS:
739         case V4L2_CID_MPEG_CLASS:
740                 qctrl->type = V4L2_CTRL_TYPE_CTRL_CLASS;
741                 qctrl->flags |= V4L2_CTRL_FLAG_READ_ONLY;
742                 min = max = step = def = 0;
743                 break;
744         default:
745                 qctrl->type = V4L2_CTRL_TYPE_INTEGER;
746                 break;
747         }
748         switch (qctrl->id) {
749         case V4L2_CID_MPEG_AUDIO_ENCODING:
750         case V4L2_CID_MPEG_AUDIO_MODE:
751         case V4L2_CID_MPEG_VIDEO_BITRATE_MODE:
752         case V4L2_CID_MPEG_VIDEO_B_FRAMES:
753         case V4L2_CID_MPEG_STREAM_TYPE:
754                 qctrl->flags |= V4L2_CTRL_FLAG_UPDATE;
755                 break;
756         case V4L2_CID_AUDIO_VOLUME:
757         case V4L2_CID_AUDIO_BALANCE:
758         case V4L2_CID_AUDIO_BASS:
759         case V4L2_CID_AUDIO_TREBLE:
760         case V4L2_CID_BRIGHTNESS:
761         case V4L2_CID_CONTRAST:
762         case V4L2_CID_SATURATION:
763         case V4L2_CID_HUE:
764                 qctrl->flags |= V4L2_CTRL_FLAG_SLIDER;
765                 break;
766         }
767         qctrl->minimum = min;
768         qctrl->maximum = max;
769         qctrl->step = step;
770         qctrl->default_value = def;
771         qctrl->reserved[0] = qctrl->reserved[1] = 0;
772         snprintf(qctrl->name, sizeof(qctrl->name), name);
773         return 0;
774 }
775
776 /* Fill in a struct v4l2_queryctrl with standard values based on
777    the control ID. */
778 int v4l2_ctrl_query_fill_std(struct v4l2_queryctrl *qctrl)
779 {
780         switch (qctrl->id) {
781         /* USER controls */
782         case V4L2_CID_USER_CLASS:
783         case V4L2_CID_MPEG_CLASS:
784                 return v4l2_ctrl_query_fill(qctrl, 0, 0, 0, 0);
785         case V4L2_CID_AUDIO_VOLUME:
786                 return v4l2_ctrl_query_fill(qctrl, 0, 65535, 65535 / 100, 58880);
787         case V4L2_CID_AUDIO_MUTE:
788         case V4L2_CID_AUDIO_LOUDNESS:
789                 return v4l2_ctrl_query_fill(qctrl, 0, 1, 1, 0);
790         case V4L2_CID_AUDIO_BALANCE:
791         case V4L2_CID_AUDIO_BASS:
792         case V4L2_CID_AUDIO_TREBLE:
793                 return v4l2_ctrl_query_fill(qctrl, 0, 65535, 65535 / 100, 32768);
794         case V4L2_CID_BRIGHTNESS:
795                 return v4l2_ctrl_query_fill(qctrl, 0, 255, 1, 128);
796         case V4L2_CID_CONTRAST:
797         case V4L2_CID_SATURATION:
798                 return v4l2_ctrl_query_fill(qctrl, 0, 127, 1, 64);
799         case V4L2_CID_HUE:
800                 return v4l2_ctrl_query_fill(qctrl, -128, 127, 1, 0);
801
802         /* MPEG controls */
803         case V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ:
804                 return v4l2_ctrl_query_fill(qctrl,
805                                 V4L2_MPEG_AUDIO_SAMPLING_FREQ_44100,
806                                 V4L2_MPEG_AUDIO_SAMPLING_FREQ_32000, 1,
807                                 V4L2_MPEG_AUDIO_SAMPLING_FREQ_48000);
808         case V4L2_CID_MPEG_AUDIO_ENCODING:
809                 return v4l2_ctrl_query_fill(qctrl,
810                                 V4L2_MPEG_AUDIO_ENCODING_LAYER_1,
811                                 V4L2_MPEG_AUDIO_ENCODING_LAYER_3, 1,
812                                 V4L2_MPEG_AUDIO_ENCODING_LAYER_2);
813         case V4L2_CID_MPEG_AUDIO_L1_BITRATE:
814                 return v4l2_ctrl_query_fill(qctrl,
815                                 V4L2_MPEG_AUDIO_L1_BITRATE_32K,
816                                 V4L2_MPEG_AUDIO_L1_BITRATE_448K, 1,
817                                 V4L2_MPEG_AUDIO_L1_BITRATE_256K);
818         case V4L2_CID_MPEG_AUDIO_L2_BITRATE:
819                 return v4l2_ctrl_query_fill(qctrl,
820                                 V4L2_MPEG_AUDIO_L2_BITRATE_32K,
821                                 V4L2_MPEG_AUDIO_L2_BITRATE_384K, 1,
822                                 V4L2_MPEG_AUDIO_L2_BITRATE_224K);
823         case V4L2_CID_MPEG_AUDIO_L3_BITRATE:
824                 return v4l2_ctrl_query_fill(qctrl,
825                                 V4L2_MPEG_AUDIO_L3_BITRATE_32K,
826                                 V4L2_MPEG_AUDIO_L3_BITRATE_320K, 1,
827                                 V4L2_MPEG_AUDIO_L3_BITRATE_192K);
828         case V4L2_CID_MPEG_AUDIO_MODE:
829                 return v4l2_ctrl_query_fill(qctrl,
830                                 V4L2_MPEG_AUDIO_MODE_STEREO,
831                                 V4L2_MPEG_AUDIO_MODE_MONO, 1,
832                                 V4L2_MPEG_AUDIO_MODE_STEREO);
833         case V4L2_CID_MPEG_AUDIO_MODE_EXTENSION:
834                 return v4l2_ctrl_query_fill(qctrl,
835                                 V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_4,
836                                 V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_16, 1,
837                                 V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_4);
838         case V4L2_CID_MPEG_AUDIO_EMPHASIS:
839                 return v4l2_ctrl_query_fill(qctrl,
840                                 V4L2_MPEG_AUDIO_EMPHASIS_NONE,
841                                 V4L2_MPEG_AUDIO_EMPHASIS_CCITT_J17, 1,
842                                 V4L2_MPEG_AUDIO_EMPHASIS_NONE);
843         case V4L2_CID_MPEG_AUDIO_CRC:
844                 return v4l2_ctrl_query_fill(qctrl,
845                                 V4L2_MPEG_AUDIO_CRC_NONE,
846                                 V4L2_MPEG_AUDIO_CRC_CRC16, 1,
847                                 V4L2_MPEG_AUDIO_CRC_NONE);
848         case V4L2_CID_MPEG_AUDIO_MUTE:
849                 return v4l2_ctrl_query_fill(qctrl, 0, 1, 1, 0);
850         case V4L2_CID_MPEG_VIDEO_ENCODING:
851                 return v4l2_ctrl_query_fill(qctrl,
852                                 V4L2_MPEG_VIDEO_ENCODING_MPEG_1,
853                                 V4L2_MPEG_VIDEO_ENCODING_MPEG_2, 1,
854                                 V4L2_MPEG_VIDEO_ENCODING_MPEG_2);
855         case V4L2_CID_MPEG_VIDEO_ASPECT:
856                 return v4l2_ctrl_query_fill(qctrl,
857                                 V4L2_MPEG_VIDEO_ASPECT_1x1,
858                                 V4L2_MPEG_VIDEO_ASPECT_221x100, 1,
859                                 V4L2_MPEG_VIDEO_ASPECT_4x3);
860         case V4L2_CID_MPEG_VIDEO_B_FRAMES:
861                 return v4l2_ctrl_query_fill(qctrl, 0, 33, 1, 2);
862         case V4L2_CID_MPEG_VIDEO_GOP_SIZE:
863                 return v4l2_ctrl_query_fill(qctrl, 1, 34, 1, 12);
864         case V4L2_CID_MPEG_VIDEO_GOP_CLOSURE:
865                 return v4l2_ctrl_query_fill(qctrl, 0, 1, 1, 1);
866         case V4L2_CID_MPEG_VIDEO_PULLDOWN:
867                 return v4l2_ctrl_query_fill(qctrl, 0, 1, 1, 0);
868         case V4L2_CID_MPEG_VIDEO_BITRATE_MODE:
869                 return v4l2_ctrl_query_fill(qctrl,
870                                 V4L2_MPEG_VIDEO_BITRATE_MODE_VBR,
871                                 V4L2_MPEG_VIDEO_BITRATE_MODE_CBR, 1,
872                                 V4L2_MPEG_VIDEO_BITRATE_MODE_VBR);
873         case V4L2_CID_MPEG_VIDEO_BITRATE:
874                 return v4l2_ctrl_query_fill(qctrl, 0, 27000000, 1, 6000000);
875         case V4L2_CID_MPEG_VIDEO_BITRATE_PEAK:
876                 return v4l2_ctrl_query_fill(qctrl, 0, 27000000, 1, 8000000);
877         case V4L2_CID_MPEG_VIDEO_TEMPORAL_DECIMATION:
878                 return v4l2_ctrl_query_fill(qctrl, 0, 255, 1, 0);
879         case V4L2_CID_MPEG_VIDEO_MUTE:
880                 return v4l2_ctrl_query_fill(qctrl, 0, 1, 1, 0);
881         case V4L2_CID_MPEG_VIDEO_MUTE_YUV:  /* Init YUV (really YCbCr) to black */
882                 return v4l2_ctrl_query_fill(qctrl, 0, 0xffffff, 1, 0x008080);
883         case V4L2_CID_MPEG_STREAM_TYPE:
884                 return v4l2_ctrl_query_fill(qctrl,
885                                 V4L2_MPEG_STREAM_TYPE_MPEG2_PS,
886                                 V4L2_MPEG_STREAM_TYPE_MPEG2_SVCD, 1,
887                                 V4L2_MPEG_STREAM_TYPE_MPEG2_PS);
888         case V4L2_CID_MPEG_STREAM_PID_PMT:
889                 return v4l2_ctrl_query_fill(qctrl, 0, (1 << 14) - 1, 1, 16);
890         case V4L2_CID_MPEG_STREAM_PID_AUDIO:
891                 return v4l2_ctrl_query_fill(qctrl, 0, (1 << 14) - 1, 1, 260);
892         case V4L2_CID_MPEG_STREAM_PID_VIDEO:
893                 return v4l2_ctrl_query_fill(qctrl, 0, (1 << 14) - 1, 1, 256);
894         case V4L2_CID_MPEG_STREAM_PID_PCR:
895                 return v4l2_ctrl_query_fill(qctrl, 0, (1 << 14) - 1, 1, 259);
896         case V4L2_CID_MPEG_STREAM_PES_ID_AUDIO:
897                 return v4l2_ctrl_query_fill(qctrl, 0, 255, 1, 0);
898         case V4L2_CID_MPEG_STREAM_PES_ID_VIDEO:
899                 return v4l2_ctrl_query_fill(qctrl, 0, 255, 1, 0);
900         case V4L2_CID_MPEG_STREAM_VBI_FMT:
901                 return v4l2_ctrl_query_fill(qctrl,
902                                 V4L2_MPEG_STREAM_VBI_FMT_NONE,
903                                 V4L2_MPEG_STREAM_VBI_FMT_IVTV, 1,
904                                 V4L2_MPEG_STREAM_VBI_FMT_NONE);
905         default:
906                 return -EINVAL;
907         }
908 }
909
910 /* Fill in a struct v4l2_querymenu based on the struct v4l2_queryctrl and
911    the menu. The qctrl pointer may be NULL, in which case it is ignored. */
912 int v4l2_ctrl_query_menu(struct v4l2_querymenu *qmenu, struct v4l2_queryctrl *qctrl,
913                const char **menu_items)
914 {
915         int i;
916
917         if (menu_items == NULL ||
918             (qctrl && (qmenu->index < qctrl->minimum || qmenu->index > qctrl->maximum)))
919                 return -EINVAL;
920         for (i = 0; i < qmenu->index && menu_items[i]; i++) ;
921         if (menu_items[i] == NULL || menu_items[i][0] == '\0')
922                 return -EINVAL;
923         snprintf(qmenu->name, sizeof(qmenu->name), menu_items[qmenu->index]);
924         qmenu->reserved = 0;
925         return 0;
926 }
927
928 /* ctrl_classes points to an array of u32 pointers, the last element is
929    a NULL pointer. Each u32 array is a 0-terminated array of control IDs.
930    Each array must be sorted low to high and belong to the same control
931    class. The array of u32 pointer must also be sorted, from low class IDs
932    to high class IDs.
933
934    This function returns the first ID that follows after the given ID.
935    When no more controls are available 0 is returned. */
936 u32 v4l2_ctrl_next(const u32 * const * ctrl_classes, u32 id)
937 {
938         u32 ctrl_class;
939         const u32 *pctrl;
940
941         /* if no query is desired, then just return the control ID */
942         if ((id & V4L2_CTRL_FLAG_NEXT_CTRL) == 0)
943                 return id;
944         if (ctrl_classes == NULL)
945                 return 0;
946         id &= V4L2_CTRL_ID_MASK;
947         ctrl_class = V4L2_CTRL_ID2CLASS(id);
948         id++;   /* select next control */
949         /* find first class that matches (or is greater than) the class of
950            the ID */
951         while (*ctrl_classes && V4L2_CTRL_ID2CLASS(**ctrl_classes) < ctrl_class)
952                 ctrl_classes++;
953         /* no more classes */
954         if (*ctrl_classes == NULL)
955                 return 0;
956         pctrl = *ctrl_classes;
957         /* find first ctrl within the class that is >= ID */
958         while (*pctrl && *pctrl < id) pctrl++;
959         if (*pctrl)
960                 return *pctrl;
961         /* we are at the end of the controls of the current class. */
962         /* continue with next class if available */
963         ctrl_classes++;
964         if (*ctrl_classes == NULL)
965                 return 0;
966         return **ctrl_classes;
967 }
968
969 int v4l2_chip_match_i2c_client(struct i2c_client *c, u32 match_type, u32 match_chip)
970 {
971         switch (match_type) {
972         case V4L2_CHIP_MATCH_I2C_DRIVER:
973                 return (c != NULL && c->driver != NULL && c->driver->id == match_chip);
974         case V4L2_CHIP_MATCH_I2C_ADDR:
975                 return (c != NULL && c->addr == match_chip);
976         default:
977                 return 0;
978         }
979 }
980
981 int v4l2_chip_match_host(u32 match_type, u32 match_chip)
982 {
983         switch (match_type) {
984         case V4L2_CHIP_MATCH_HOST:
985                 return match_chip == 0;
986         default:
987                 return 0;
988         }
989 }
990
991 /* ----------------------------------------------------------------- */
992
993 EXPORT_SYMBOL(v4l2_norm_to_name);
994 EXPORT_SYMBOL(v4l2_video_std_construct);
995
996 EXPORT_SYMBOL(v4l2_prio_init);
997 EXPORT_SYMBOL(v4l2_prio_change);
998 EXPORT_SYMBOL(v4l2_prio_open);
999 EXPORT_SYMBOL(v4l2_prio_close);
1000 EXPORT_SYMBOL(v4l2_prio_max);
1001 EXPORT_SYMBOL(v4l2_prio_check);
1002
1003 EXPORT_SYMBOL(v4l2_field_names);
1004 EXPORT_SYMBOL(v4l2_type_names);
1005 EXPORT_SYMBOL(v4l_printk_ioctl);
1006
1007 EXPORT_SYMBOL(v4l2_ctrl_next);
1008 EXPORT_SYMBOL(v4l2_ctrl_check);
1009 EXPORT_SYMBOL(v4l2_ctrl_get_menu);
1010 EXPORT_SYMBOL(v4l2_ctrl_query_menu);
1011 EXPORT_SYMBOL(v4l2_ctrl_query_fill);
1012 EXPORT_SYMBOL(v4l2_ctrl_query_fill_std);
1013
1014 EXPORT_SYMBOL(v4l2_chip_match_i2c_client);
1015 EXPORT_SYMBOL(v4l2_chip_match_host);
1016
1017 /*
1018  * Local variables:
1019  * c-basic-offset: 8
1020  * End:
1021  */