4 * A generic video device interface for the LINUX operating system
5 * using a set of device structures/vectors for low level operations.
7 * This file replaces the videodev.c file that comes with the
8 * regular kernel distribution.
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.
15 * Author: Bill Dirks <bill@thedirks.org>
16 * based on code by Alan Cox, <alan@cymru.net>
21 * Video capture interface for Linux
23 * A generic video device interface for the LINUX operating system
24 * using a set of device structures/vectors for low level operations.
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.
31 * Author: Alan Cox, <alan@redhat.com>
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)
47 #include <linux/module.h>
48 #include <linux/types.h>
49 #include <linux/kernel.h>
50 #include <linux/smp_lock.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>
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>
65 #include <linux/kmod.h>
68 #if defined(CONFIG_UST) || defined(CONFIG_UST_MODULE)
69 #include <linux/ust.h>
73 #include <linux/videodev.h>
75 MODULE_AUTHOR("Bill Dirks, Justin Schoeman, Gerd Knorr");
76 MODULE_DESCRIPTION("misc helper functions for v4l2 device drivers");
77 MODULE_LICENSE("GPL");
81 * V 4 L 2 D R I V E R H E L P E R A P I
86 * Video Standard Operations (contributed by Michael Schimek)
90 char *v4l2_norm_to_name(v4l2_std_id id)
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.
104 case V4L2_STD_PAL_BG:
105 name="PAL-BG"; break;
106 case V4L2_STD_PAL_DK:
107 name="PAL-DK"; break;
110 case V4L2_STD_PAL_B1:
111 name="PAL-B1"; break;
120 case V4L2_STD_PAL_D1:
121 name="PAL-D1"; break;
128 case V4L2_STD_PAL_Nc:
129 name="PAL-Nc"; break;
130 case V4L2_STD_PAL_60:
131 name="PAL-60"; 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;
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;
163 name="Unknown"; break;
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,
174 u32 index = vs->index;
176 memset(vs, 0, sizeof(struct v4l2_standard));
179 if (id & V4L2_STD_525_60) {
180 vs->frameperiod.numerator = 1001;
181 vs->frameperiod.denominator = 30000;
182 vs->framelines = 525;
184 vs->frameperiod.numerator = 1;
185 vs->frameperiod.denominator = 25;
186 vs->framelines = 625;
188 strlcpy(vs->name,name,sizeof(vs->name));
192 /* ----------------------------------------------------------------- */
193 /* priority handling */
195 #define V4L2_PRIO_VALID(val) (val == V4L2_PRIORITY_BACKGROUND || \
196 val == V4L2_PRIORITY_INTERACTIVE || \
197 val == V4L2_PRIORITY_RECORD)
199 int v4l2_prio_init(struct v4l2_prio_state *global)
201 memset(global,0,sizeof(*global));
205 int v4l2_prio_change(struct v4l2_prio_state *global, enum v4l2_priority *local,
206 enum v4l2_priority new)
208 if (!V4L2_PRIO_VALID(new))
213 atomic_inc(&global->prios[new]);
214 if (V4L2_PRIO_VALID(*local))
215 atomic_dec(&global->prios[*local]);
220 int v4l2_prio_open(struct v4l2_prio_state *global, enum v4l2_priority *local)
222 return v4l2_prio_change(global,local,V4L2_PRIORITY_DEFAULT);
225 int v4l2_prio_close(struct v4l2_prio_state *global, enum v4l2_priority *local)
227 if (V4L2_PRIO_VALID(*local))
228 atomic_dec(&global->prios[*local]);
232 enum v4l2_priority v4l2_prio_max(struct v4l2_prio_state *global)
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;
243 int v4l2_prio_check(struct v4l2_prio_state *global, enum v4l2_priority *local)
245 if (*local < v4l2_prio_max(global))
251 /* ----------------------------------------------------------------- */
252 /* some arrays for pretty-printing debug messages of enum types */
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",
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",
279 #define prt_names(a,arr) (((a)>=0)&&((a)<ARRAY_SIZE(arr)))?arr[a]:"unknown"
281 /* ------------------------------------------------------------------ */
282 /* debug help functions */
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"
316 #define V4L1_IOCTLS ARRAY_SIZE(v4l1_ioctls)
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",
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",
384 [_IOC_NR(VIDIOC_DBG_S_REGISTER)] = "VIDIOC_DBG_S_REGISTER",
385 [_IOC_NR(VIDIOC_DBG_G_REGISTER)] = "VIDIOC_DBG_G_REGISTER",
388 #define V4L2_IOCTLS ARRAY_SIZE(v4l2_ioctls)
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",
404 [_IOC_NR(AUDC_SET_RADIO)] = "AUDC_SET_RADIO",
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",
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"
425 #define V4L2_INT_IOCTLS ARRAY_SIZE(v4l2_int_ioctls)
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)
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;
441 switch (_IOC_TYPE(cmd)) {
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);
447 #ifdef CONFIG_VIDEO_V4L1_COMPAT
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);
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);
461 printk("unknown ioctl '%c', dir=%s, #%d (0x%08x)\n",
462 _IOC_TYPE(cmd), dir, _IOC_NR(cmd), cmd);
467 /* ----------------------------------------------------------------- */
469 /* Helper functions for control handling */
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)
477 if (qctrl->flags & V4L2_CTRL_FLAG_DISABLED)
479 if (qctrl->flags & V4L2_CTRL_FLAG_GRABBED)
481 if (qctrl->type == V4L2_CTRL_TYPE_BUTTON ||
482 qctrl->type == V4L2_CTRL_TYPE_INTEGER64 ||
483 qctrl->type == V4L2_CTRL_TYPE_CTRL_CLASS)
485 if (ctrl->value < qctrl->minimum || ctrl->value > qctrl->maximum)
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')
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)
501 static const char *mpeg_audio_sampling_freq[] = {
507 static const char *mpeg_audio_encoding[] = {
513 static const char *mpeg_audio_l1_bitrate[] = {
530 static const char *mpeg_audio_l2_bitrate[] = {
547 static const char *mpeg_audio_l3_bitrate[] = {
564 static const char *mpeg_audio_mode[] = {
571 static const char *mpeg_audio_mode_extension[] = {
578 static const char *mpeg_audio_emphasis[] = {
584 static const char *mpeg_audio_crc[] = {
589 static const char *mpeg_video_encoding[] = {
594 static const char *mpeg_video_aspect[] = {
601 static const char *mpeg_video_bitrate_mode[] = {
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",
615 static const char *mpeg_stream_vbi_fmt[] = {
617 "Private packet, IVTV format",
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;
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)
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;
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;
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;
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;
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;
745 qctrl->type = V4L2_CTRL_TYPE_INTEGER;
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;
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:
764 qctrl->flags |= V4L2_CTRL_FLAG_SLIDER;
767 qctrl->minimum = min;
768 qctrl->maximum = max;
770 qctrl->default_value = def;
771 qctrl->reserved[0] = qctrl->reserved[1] = 0;
772 snprintf(qctrl->name, sizeof(qctrl->name), name);
776 /* Fill in a struct v4l2_queryctrl with standard values based on
778 int v4l2_ctrl_query_fill_std(struct v4l2_queryctrl *qctrl)
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);
800 return v4l2_ctrl_query_fill(qctrl, -128, 127, 1, 0);
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);
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)
917 if (menu_items == NULL ||
918 (qctrl && (qmenu->index < qctrl->minimum || qmenu->index > qctrl->maximum)))
920 for (i = 0; i < qmenu->index && menu_items[i]; i++) ;
921 if (menu_items[i] == NULL || menu_items[i][0] == '\0')
923 snprintf(qmenu->name, sizeof(qmenu->name), menu_items[qmenu->index]);
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
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)
941 /* if no query is desired, then just return the control ID */
942 if ((id & V4L2_CTRL_FLAG_NEXT_CTRL) == 0)
944 if (ctrl_classes == NULL)
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
951 while (*ctrl_classes && V4L2_CTRL_ID2CLASS(**ctrl_classes) < ctrl_class)
953 /* no more classes */
954 if (*ctrl_classes == NULL)
956 pctrl = *ctrl_classes;
957 /* find first ctrl within the class that is >= ID */
958 while (*pctrl && *pctrl < id) pctrl++;
961 /* we are at the end of the controls of the current class. */
962 /* continue with next class if available */
964 if (*ctrl_classes == NULL)
966 return **ctrl_classes;
969 int v4l2_chip_match_i2c_client(struct i2c_client *c, u32 match_type, u32 match_chip)
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);
981 int v4l2_chip_match_host(u32 match_type, u32 match_chip)
983 switch (match_type) {
984 case V4L2_CHIP_MATCH_HOST:
985 return match_chip == 0;
991 /* ----------------------------------------------------------------- */
993 EXPORT_SYMBOL(v4l2_norm_to_name);
994 EXPORT_SYMBOL(v4l2_video_std_construct);
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);
1003 EXPORT_SYMBOL(v4l2_field_names);
1004 EXPORT_SYMBOL(v4l2_type_names);
1005 EXPORT_SYMBOL(v4l_printk_ioctl);
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);
1014 EXPORT_SYMBOL(v4l2_chip_match_i2c_client);
1015 EXPORT_SYMBOL(v4l2_chip_match_host);