SAFE public projects git trees. - safe/jmp/linux-2.6/blob - 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 };
 264
 265 char *v4l2_type_names[] = {
 266         [V4L2_BUF_TYPE_VIDEO_CAPTURE]      = "video-cap",
 267         [V4L2_BUF_TYPE_VIDEO_OVERLAY]      = "video-over",
 268         [V4L2_BUF_TYPE_VIDEO_OUTPUT]       = "video-out",
 269         [V4L2_BUF_TYPE_VBI_CAPTURE]        = "vbi-cap",
 270         [V4L2_BUF_TYPE_VBI_OUTPUT]         = "vbi-out",
 271         [V4L2_BUF_TYPE_SLICED_VBI_CAPTURE] = "sliced-vbi-cap",
 272         [V4L2_BUF_TYPE_SLICED_VBI_OUTPUT]  = "slicec-vbi-out",
 273 };
 274
 275
 276 #define prt_names(a,arr) (((a)>=0)&&((a)<ARRAY_SIZE(arr)))?arr[a]:"unknown"
 277
 278 /* ------------------------------------------------------------------ */
 279 /* debug help functions                                               */
 280
 281 #ifdef CONFIG_VIDEO_V4L1_COMPAT
 282 static const char *v4l1_ioctls[] = {
 283         [_IOC_NR(VIDIOCGCAP)]       = "VIDIOCGCAP",
 284         [_IOC_NR(VIDIOCGCHAN)]      = "VIDIOCGCHAN",
 285         [_IOC_NR(VIDIOCSCHAN)]      = "VIDIOCSCHAN",
 286         [_IOC_NR(VIDIOCGTUNER)]     = "VIDIOCGTUNER",
 287         [_IOC_NR(VIDIOCSTUNER)]     = "VIDIOCSTUNER",
 288         [_IOC_NR(VIDIOCGPICT)]      = "VIDIOCGPICT",
 289         [_IOC_NR(VIDIOCSPICT)]      = "VIDIOCSPICT",
 290         [_IOC_NR(VIDIOCCAPTURE)]    = "VIDIOCCAPTURE",
 291         [_IOC_NR(VIDIOCGWIN)]       = "VIDIOCGWIN",
 292         [_IOC_NR(VIDIOCSWIN)]       = "VIDIOCSWIN",
 293         [_IOC_NR(VIDIOCGFBUF)]      = "VIDIOCGFBUF",
 294         [_IOC_NR(VIDIOCSFBUF)]      = "VIDIOCSFBUF",
 295         [_IOC_NR(VIDIOCKEY)]        = "VIDIOCKEY",
 296         [_IOC_NR(VIDIOCGFREQ)]      = "VIDIOCGFREQ",
 297         [_IOC_NR(VIDIOCSFREQ)]      = "VIDIOCSFREQ",
 298         [_IOC_NR(VIDIOCGAUDIO)]     = "VIDIOCGAUDIO",
 299         [_IOC_NR(VIDIOCSAUDIO)]     = "VIDIOCSAUDIO",
 300         [_IOC_NR(VIDIOCSYNC)]       = "VIDIOCSYNC",
 301         [_IOC_NR(VIDIOCMCAPTURE)]   = "VIDIOCMCAPTURE",
 302         [_IOC_NR(VIDIOCGMBUF)]      = "VIDIOCGMBUF",
 303         [_IOC_NR(VIDIOCGUNIT)]      = "VIDIOCGUNIT",
 304         [_IOC_NR(VIDIOCGCAPTURE)]   = "VIDIOCGCAPTURE",
 305         [_IOC_NR(VIDIOCSCAPTURE)]   = "VIDIOCSCAPTURE",
 306         [_IOC_NR(VIDIOCSPLAYMODE)]  = "VIDIOCSPLAYMODE",
 307         [_IOC_NR(VIDIOCSWRITEMODE)] = "VIDIOCSWRITEMODE",
 308         [_IOC_NR(VIDIOCGPLAYINFO)]  = "VIDIOCGPLAYINFO",
 309         [_IOC_NR(VIDIOCSMICROCODE)] = "VIDIOCSMICROCODE",
 310         [_IOC_NR(VIDIOCGVBIFMT)]    = "VIDIOCGVBIFMT",
 311         [_IOC_NR(VIDIOCSVBIFMT)]    = "VIDIOCSVBIFMT"
 312 };
 313 #define V4L1_IOCTLS ARRAY_SIZE(v4l1_ioctls)
 314 #endif
 315
 316 static const char *v4l2_ioctls[] = {
 317         [_IOC_NR(VIDIOC_QUERYCAP)]         = "VIDIOC_QUERYCAP",
 318         [_IOC_NR(VIDIOC_RESERVED)]         = "VIDIOC_RESERVED",
 319         [_IOC_NR(VIDIOC_ENUM_FMT)]         = "VIDIOC_ENUM_FMT",
 320         [_IOC_NR(VIDIOC_G_FMT)]            = "VIDIOC_G_FMT",
 321         [_IOC_NR(VIDIOC_S_FMT)]            = "VIDIOC_S_FMT",
 322         [_IOC_NR(VIDIOC_G_MPEGCOMP)]       = "VIDIOC_G_MPEGCOMP",
 323         [_IOC_NR(VIDIOC_S_MPEGCOMP)]       = "VIDIOC_S_MPEGCOMP",
 324         [_IOC_NR(VIDIOC_REQBUFS)]          = "VIDIOC_REQBUFS",
 325         [_IOC_NR(VIDIOC_QUERYBUF)]         = "VIDIOC_QUERYBUF",
 326         [_IOC_NR(VIDIOC_G_FBUF)]           = "VIDIOC_G_FBUF",
 327         [_IOC_NR(VIDIOC_S_FBUF)]           = "VIDIOC_S_FBUF",
 328         [_IOC_NR(VIDIOC_OVERLAY)]          = "VIDIOC_OVERLAY",
 329         [_IOC_NR(VIDIOC_QBUF)]             = "VIDIOC_QBUF",
 330         [_IOC_NR(VIDIOC_DQBUF)]            = "VIDIOC_DQBUF",
 331         [_IOC_NR(VIDIOC_STREAMON)]         = "VIDIOC_STREAMON",
 332         [_IOC_NR(VIDIOC_STREAMOFF)]        = "VIDIOC_STREAMOFF",
 333         [_IOC_NR(VIDIOC_G_PARM)]           = "VIDIOC_G_PARM",
 334         [_IOC_NR(VIDIOC_S_PARM)]           = "VIDIOC_S_PARM",
 335         [_IOC_NR(VIDIOC_G_STD)]            = "VIDIOC_G_STD",
 336         [_IOC_NR(VIDIOC_S_STD)]            = "VIDIOC_S_STD",
 337         [_IOC_NR(VIDIOC_ENUMSTD)]          = "VIDIOC_ENUMSTD",
 338         [_IOC_NR(VIDIOC_ENUMINPUT)]        = "VIDIOC_ENUMINPUT",
 339         [_IOC_NR(VIDIOC_G_CTRL)]           = "VIDIOC_G_CTRL",
 340         [_IOC_NR(VIDIOC_S_CTRL)]           = "VIDIOC_S_CTRL",
 341         [_IOC_NR(VIDIOC_G_TUNER)]          = "VIDIOC_G_TUNER",
 342         [_IOC_NR(VIDIOC_S_TUNER)]          = "VIDIOC_S_TUNER",
 343         [_IOC_NR(VIDIOC_G_AUDIO)]          = "VIDIOC_G_AUDIO",
 344         [_IOC_NR(VIDIOC_S_AUDIO)]          = "VIDIOC_S_AUDIO",
 345         [_IOC_NR(VIDIOC_QUERYCTRL)]        = "VIDIOC_QUERYCTRL",
 346         [_IOC_NR(VIDIOC_QUERYMENU)]        = "VIDIOC_QUERYMENU",
 347         [_IOC_NR(VIDIOC_G_INPUT)]          = "VIDIOC_G_INPUT",
 348         [_IOC_NR(VIDIOC_S_INPUT)]          = "VIDIOC_S_INPUT",
 349         [_IOC_NR(VIDIOC_G_OUTPUT)]         = "VIDIOC_G_OUTPUT",
 350         [_IOC_NR(VIDIOC_S_OUTPUT)]         = "VIDIOC_S_OUTPUT",
 351         [_IOC_NR(VIDIOC_ENUMOUTPUT)]       = "VIDIOC_ENUMOUTPUT",
 352         [_IOC_NR(VIDIOC_G_AUDOUT)]         = "VIDIOC_G_AUDOUT",
 353         [_IOC_NR(VIDIOC_S_AUDOUT)]         = "VIDIOC_S_AUDOUT",
 354         [_IOC_NR(VIDIOC_G_MODULATOR)]      = "VIDIOC_G_MODULATOR",
 355         [_IOC_NR(VIDIOC_S_MODULATOR)]      = "VIDIOC_S_MODULATOR",
 356         [_IOC_NR(VIDIOC_G_FREQUENCY)]      = "VIDIOC_G_FREQUENCY",
 357         [_IOC_NR(VIDIOC_S_FREQUENCY)]      = "VIDIOC_S_FREQUENCY",
 358         [_IOC_NR(VIDIOC_CROPCAP)]          = "VIDIOC_CROPCAP",
 359         [_IOC_NR(VIDIOC_G_CROP)]           = "VIDIOC_G_CROP",
 360         [_IOC_NR(VIDIOC_S_CROP)]           = "VIDIOC_S_CROP",
 361         [_IOC_NR(VIDIOC_G_JPEGCOMP)]       = "VIDIOC_G_JPEGCOMP",
 362         [_IOC_NR(VIDIOC_S_JPEGCOMP)]       = "VIDIOC_S_JPEGCOMP",
 363         [_IOC_NR(VIDIOC_QUERYSTD)]         = "VIDIOC_QUERYSTD",
 364         [_IOC_NR(VIDIOC_TRY_FMT)]          = "VIDIOC_TRY_FMT",
 365         [_IOC_NR(VIDIOC_ENUMAUDIO)]        = "VIDIOC_ENUMAUDIO",
 366         [_IOC_NR(VIDIOC_ENUMAUDOUT)]       = "VIDIOC_ENUMAUDOUT",
 367         [_IOC_NR(VIDIOC_G_PRIORITY)]       = "VIDIOC_G_PRIORITY",
 368         [_IOC_NR(VIDIOC_S_PRIORITY)]       = "VIDIOC_S_PRIORITY",
 369 #if 1
 370         [_IOC_NR(VIDIOC_G_SLICED_VBI_CAP)] = "VIDIOC_G_SLICED_VBI_CAP",
 371 #endif
 372         [_IOC_NR(VIDIOC_LOG_STATUS)]       = "VIDIOC_LOG_STATUS",
 373         [_IOC_NR(VIDIOC_G_EXT_CTRLS)]      = "VIDIOC_G_EXT_CTRLS",
 374         [_IOC_NR(VIDIOC_S_EXT_CTRLS)]      = "VIDIOC_S_EXT_CTRLS",
 375         [_IOC_NR(VIDIOC_TRY_EXT_CTRLS)]    = "VIDIOC_TRY_EXT_CTRLS"
 376 };
 377 #define V4L2_IOCTLS ARRAY_SIZE(v4l2_ioctls)
 378
 379 static const char *v4l2_int_ioctls[] = {
 380 #ifdef CONFIG_VIDEO_V4L1_COMPAT
 381         [_IOC_NR(DECODER_GET_CAPABILITIES)]    = "DECODER_GET_CAPABILITIES",
 382         [_IOC_NR(DECODER_GET_STATUS)]          = "DECODER_GET_STATUS",
 383         [_IOC_NR(DECODER_SET_NORM)]            = "DECODER_SET_NORM",
 384         [_IOC_NR(DECODER_SET_INPUT)]           = "DECODER_SET_INPUT",
 385         [_IOC_NR(DECODER_SET_OUTPUT)]          = "DECODER_SET_OUTPUT",
 386         [_IOC_NR(DECODER_ENABLE_OUTPUT)]       = "DECODER_ENABLE_OUTPUT",
 387         [_IOC_NR(DECODER_SET_PICTURE)]         = "DECODER_SET_PICTURE",
 388         [_IOC_NR(DECODER_SET_GPIO)]            = "DECODER_SET_GPIO",
 389         [_IOC_NR(DECODER_INIT)]                = "DECODER_INIT",
 390         [_IOC_NR(DECODER_SET_VBI_BYPASS)]      = "DECODER_SET_VBI_BYPASS",
 391         [_IOC_NR(DECODER_DUMP)]                = "DECODER_DUMP",
 392 #endif
 393         [_IOC_NR(AUDC_SET_RADIO)]              = "AUDC_SET_RADIO",
 394
 395         [_IOC_NR(TUNER_SET_TYPE_ADDR)]         = "TUNER_SET_TYPE_ADDR",
 396         [_IOC_NR(TUNER_SET_STANDBY)]           = "TUNER_SET_STANDBY",
 397         [_IOC_NR(TDA9887_SET_CONFIG)]          = "TDA9887_SET_CONFIG",
 398
 399         [_IOC_NR(VIDIOC_DBG_S_REGISTER)]       = "VIDIOC_DBG_S_REGISTER",
 400         [_IOC_NR(VIDIOC_DBG_G_REGISTER)]       = "VIDIOC_DBG_G_REGISTER",
 401
 402         [_IOC_NR(VIDIOC_INT_S_TUNER_MODE)]     = "VIDIOC_INT_S_TUNER_MODE",
 403         [_IOC_NR(VIDIOC_INT_RESET)]            = "VIDIOC_INT_RESET",
 404         [_IOC_NR(VIDIOC_INT_AUDIO_CLOCK_FREQ)] = "VIDIOC_INT_AUDIO_CLOCK_FREQ",
 405         [_IOC_NR(VIDIOC_INT_DECODE_VBI_LINE)]  = "VIDIOC_INT_DECODE_VBI_LINE",
 406         [_IOC_NR(VIDIOC_INT_S_VBI_DATA)]       = "VIDIOC_INT_S_VBI_DATA",
 407         [_IOC_NR(VIDIOC_INT_G_VBI_DATA)]       = "VIDIOC_INT_G_VBI_DATA",
 408         [_IOC_NR(VIDIOC_INT_G_CHIP_IDENT)]     = "VIDIOC_INT_G_CHIP_IDENT",
 409         [_IOC_NR(VIDIOC_INT_I2S_CLOCK_FREQ)]   = "VIDIOC_INT_I2S_CLOCK_FREQ",
 410         [_IOC_NR(VIDIOC_INT_S_STANDBY)]        = "VIDIOC_INT_S_STANDBY",
 411         [_IOC_NR(VIDIOC_INT_S_AUDIO_ROUTING)]  = "VIDIOC_INT_S_AUDIO_ROUTING",
 412         [_IOC_NR(VIDIOC_INT_G_AUDIO_ROUTING)]  = "VIDIOC_INT_G_AUDIO_ROUTING",
 413         [_IOC_NR(VIDIOC_INT_S_VIDEO_ROUTING)]  = "VIDIOC_INT_S_VIDEO_ROUTING",
 414         [_IOC_NR(VIDIOC_INT_G_VIDEO_ROUTING)]  = "VIDIOC_INT_G_VIDEO_ROUTING",
 415         [_IOC_NR(VIDIOC_INT_S_CRYSTAL_FREQ)]   = "VIDIOC_INT_S_CRYSTAL_FREQ"
 416 };
 417 #define V4L2_INT_IOCTLS ARRAY_SIZE(v4l2_int_ioctls)
 418
 419
 420 /* Common ioctl debug function. This function can be used by
 421    external ioctl messages as well as internal V4L ioctl */
 422 void v4l_printk_ioctl(unsigned int cmd)
 423 {
 424         char *dir;
 425
 426         switch (_IOC_DIR(cmd)) {
 427         case _IOC_NONE:              dir = "--"; break;
 428         case _IOC_READ:              dir = "r-"; break;
 429         case _IOC_WRITE:             dir = "-w"; break;
 430         case _IOC_READ | _IOC_WRITE: dir = "rw"; break;
 431         default:                     dir = "*ERR*"; break;
 432         }
 433         switch (_IOC_TYPE(cmd)) {
 434         case 'd':
 435                 printk("v4l2_int ioctl %s, dir=%s (0x%08x)\n",
 436                        (_IOC_NR(cmd) < V4L2_INT_IOCTLS) ?
 437                        v4l2_int_ioctls[_IOC_NR(cmd)] : "UNKNOWN", dir, cmd);
 438                 break;
 439 #ifdef CONFIG_VIDEO_V4L1_COMPAT
 440         case 'v':
 441                 printk("v4l1 ioctl %s, dir=%s (0x%08x)\n",
 442                        (_IOC_NR(cmd) < V4L1_IOCTLS) ?
 443                        v4l1_ioctls[_IOC_NR(cmd)] : "UNKNOWN", dir, cmd);
 444                 break;
 445 #endif
 446         case 'V':
 447                 printk("v4l2 ioctl %s, dir=%s (0x%08x)\n",
 448                        (_IOC_NR(cmd) < V4L2_IOCTLS) ?
 449                        v4l2_ioctls[_IOC_NR(cmd)] : "UNKNOWN", dir, cmd);
 450                 break;
 451
 452         default:
 453                 printk("unknown ioctl '%c', dir=%s, #%d (0x%08x)\n",
 454                        _IOC_TYPE(cmd), dir, _IOC_NR(cmd), cmd);
 455         }
 456 }
 457
 458
 459 /* ----------------------------------------------------------------- */
 460
 461 /* Helper functions for control handling                             */
 462
 463 /* Check for correctness of the ctrl's value based on the data from
 464    struct v4l2_queryctrl and the available menu items. Note that
 465    menu_items may be NULL, in that case it is ignored. */
 466 int v4l2_ctrl_check(struct v4l2_ext_control *ctrl, struct v4l2_queryctrl *qctrl,
 467                 const char **menu_items)
 468 {
 469         if (qctrl->flags & V4L2_CTRL_FLAG_DISABLED)
 470                 return -EINVAL;
 471         if (qctrl->flags & V4L2_CTRL_FLAG_GRABBED)
 472                 return -EBUSY;
 473         if (qctrl->type == V4L2_CTRL_TYPE_BUTTON ||
 474             qctrl->type == V4L2_CTRL_TYPE_INTEGER64 ||
 475             qctrl->type == V4L2_CTRL_TYPE_CTRL_CLASS)
 476                 return 0;
 477         if (ctrl->value < qctrl->minimum || ctrl->value > qctrl->maximum)
 478                 return -ERANGE;
 479         if (qctrl->type == V4L2_CTRL_TYPE_MENU && menu_items != NULL) {
 480                 if (menu_items[ctrl->value] == NULL ||
 481                     menu_items[ctrl->value][0] == '\0')
 482                         return -EINVAL;
 483         }
 484         return 0;
 485 }
 486
 487 /* Returns NULL or a character pointer array containing the menu for
 488    the given control ID. The pointer array ends with a NULL pointer.
 489    An empty string signifies a menu entry that is invalid. This allows
 490    drivers to disable certain options if it is not supported. */
 491 const char **v4l2_ctrl_get_menu(u32 id)
 492 {
 493         static const char *mpeg_audio_sampling_freq[] = {
 494                 "44.1 kHz",
 495                 "48 kHz",
 496                 "32 kHz",
 497                 NULL
 498         };
 499         static const char *mpeg_audio_encoding[] = {
 500                 "Layer I",
 501                 "Layer II",
 502                 "Layer III",
 503                 NULL
 504         };
 505         static const char *mpeg_audio_l1_bitrate[] = {
 506                 "32 kbps",
 507                 "64 kbps",
 508                 "96 kbps",
 509                 "128 kbps",
 510                 "160 kbps",
 511                 "192 kbps",
 512                 "224 kbps",
 513                 "256 kbps",
 514                 "288 kbps",
 515                 "320 kbps",
 516                 "352 kbps",
 517                 "384 kbps",
 518                 "416 kbps",
 519                 "448 kbps",
 520                 NULL
 521         };
 522         static const char *mpeg_audio_l2_bitrate[] = {
 523                 "32 kbps",
 524                 "48 kbps",
 525                 "56 kbps",
 526                 "64 kbps",
 527                 "80 kbps",
 528                 "96 kbps",
 529                 "112 kbps",
 530                 "128 kbps",
 531                 "160 kbps",
 532                 "192 kbps",
 533                 "224 kbps",
 534                 "256 kbps",
 535                 "320 kbps",
 536                 "384 kbps",
 537                 NULL
 538         };
 539         static const char *mpeg_audio_l3_bitrate[] = {
 540                 "32 kbps",
 541                 "40 kbps",
 542                 "48 kbps",
 543                 "56 kbps",
 544                 "64 kbps",
 545                 "80 kbps",
 546                 "96 kbps",
 547                 "112 kbps",
 548                 "128 kbps",
 549                 "160 kbps",
 550                 "192 kbps",
 551                 "224 kbps",
 552                 "256 kbps",
 553                 "320 kbps",
 554                 NULL
 555         };
 556         static const char *mpeg_audio_mode[] = {
 557                 "Stereo",
 558                 "Joint Stereo",
 559                 "Dual",
 560                 "Mono",
 561                 NULL
 562         };
 563         static const char *mpeg_audio_mode_extension[] = {
 564                 "Bound 4",
 565                 "Bound 8",
 566                 "Bound 12",
 567                 "Bound 16",
 568                 NULL
 569         };
 570         static const char *mpeg_audio_emphasis[] = {
 571                 "No Emphasis",
 572                 "50/15 us",
 573                 "CCITT J17",
 574                 NULL
 575         };
 576         static const char *mpeg_audio_crc[] = {
 577                 "No CRC",
 578                 "16-bit CRC",
 579                 NULL
 580         };
 581         static const char *mpeg_video_encoding[] = {
 582                 "MPEG-1",
 583                 "MPEG-2",
 584                 NULL
 585         };
 586         static const char *mpeg_video_aspect[] = {
 587                 "1x1",
 588                 "4x3",
 589                 "16x9",
 590                 "2.21x1",
 591                 NULL
 592         };
 593         static const char *mpeg_video_bitrate_mode[] = {
 594                 "Variable Bitrate",
 595                 "Constant Bitrate",
 596                 NULL
 597         };
 598         static const char *mpeg_stream_type[] = {
 599                 "MPEG-2 Program Stream",
 600                 "MPEG-2 Transport Stream",
 601                 "MPEG-1 System Stream",
 602                 "MPEG-2 DVD-compatible Stream",
 603                 "MPEG-1 VCD-compatible Stream",
 604                 "MPEG-2 SVCD-compatible Stream",
 605                 NULL
 606         };
 607         static const char *mpeg_stream_vbi_fmt[] = {
 608                 "No VBI",
 609                 "Private packet, IVTV format",
 610                 NULL
 611         };
 612
 613         switch (id) {
 614                 case V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ:
 615                         return mpeg_audio_sampling_freq;
 616                 case V4L2_CID_MPEG_AUDIO_ENCODING:
 617                         return mpeg_audio_encoding;
 618                 case V4L2_CID_MPEG_AUDIO_L1_BITRATE:
 619                         return mpeg_audio_l1_bitrate;
 620                 case V4L2_CID_MPEG_AUDIO_L2_BITRATE:
 621                         return mpeg_audio_l2_bitrate;
 622                 case V4L2_CID_MPEG_AUDIO_L3_BITRATE:
 623                         return mpeg_audio_l3_bitrate;
 624                 case V4L2_CID_MPEG_AUDIO_MODE:
 625                         return mpeg_audio_mode;
 626                 case V4L2_CID_MPEG_AUDIO_MODE_EXTENSION:
 627                         return mpeg_audio_mode_extension;
 628                 case V4L2_CID_MPEG_AUDIO_EMPHASIS:
 629                         return mpeg_audio_emphasis;
 630                 case V4L2_CID_MPEG_AUDIO_CRC:
 631                         return mpeg_audio_crc;
 632                 case V4L2_CID_MPEG_VIDEO_ENCODING:
 633                         return mpeg_video_encoding;
 634                 case V4L2_CID_MPEG_VIDEO_ASPECT:
 635                         return mpeg_video_aspect;
 636                 case V4L2_CID_MPEG_VIDEO_BITRATE_MODE:
 637                         return mpeg_video_bitrate_mode;
 638                 case V4L2_CID_MPEG_STREAM_TYPE:
 639                         return mpeg_stream_type;
 640                 case V4L2_CID_MPEG_STREAM_VBI_FMT:
 641                         return mpeg_stream_vbi_fmt;
 642                 default:
 643                         return NULL;
 644         }
 645 }
 646
 647 /* Fill in a struct v4l2_queryctrl */
 648 int v4l2_ctrl_query_fill(struct v4l2_queryctrl *qctrl, s32 min, s32 max, s32 step, s32 def)
 649 {
 650         const char *name;
 651
 652         qctrl->flags = 0;
 653         switch (qctrl->id) {
 654         /* USER controls */
 655         case V4L2_CID_USER_CLASS:       name = "User Controls"; break;
 656         case V4L2_CID_AUDIO_VOLUME:     name = "Volume"; break;
 657         case V4L2_CID_AUDIO_MUTE:       name = "Mute"; break;
 658         case V4L2_CID_AUDIO_BALANCE:    name = "Balance"; break;
 659         case V4L2_CID_AUDIO_BASS:       name = "Bass"; break;
 660         case V4L2_CID_AUDIO_TREBLE:     name = "Treble"; break;
 661         case V4L2_CID_AUDIO_LOUDNESS:   name = "Loudness"; break;
 662         case V4L2_CID_BRIGHTNESS:       name = "Brightness"; break;
 663         case V4L2_CID_CONTRAST:         name = "Contrast"; break;
 664         case V4L2_CID_SATURATION:       name = "Saturation"; break;
 665         case V4L2_CID_HUE:              name = "Hue"; break;
 666
 667         /* MPEG controls */
 668         case V4L2_CID_MPEG_CLASS:               name = "MPEG Encoder Controls"; break;
 669         case V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ: name = "Audio Sampling Frequency"; break;
 670         case V4L2_CID_MPEG_AUDIO_ENCODING:      name = "Audio Encoding Layer"; break;
 671         case V4L2_CID_MPEG_AUDIO_L1_BITRATE:    name = "Audio Layer I Bitrate"; break;
 672         case V4L2_CID_MPEG_AUDIO_L2_BITRATE:    name = "Audio Layer II Bitrate"; break;
 673         case V4L2_CID_MPEG_AUDIO_L3_BITRATE:    name = "Audio Layer III Bitrate"; break;
 674         case V4L2_CID_MPEG_AUDIO_MODE:          name = "Audio Stereo Mode"; break;
 675         case V4L2_CID_MPEG_AUDIO_MODE_EXTENSION: name = "Audio Stereo Mode Extension"; break;
 676         case V4L2_CID_MPEG_AUDIO_EMPHASIS:      name = "Audio Emphasis"; break;
 677         case V4L2_CID_MPEG_AUDIO_CRC:           name = "Audio CRC"; break;
 678         case V4L2_CID_MPEG_VIDEO_ENCODING:      name = "Video Encoding"; break;
 679         case V4L2_CID_MPEG_VIDEO_ASPECT:        name = "Video Aspect"; break;
 680         case V4L2_CID_MPEG_VIDEO_B_FRAMES:      name = "Video B Frames"; break;
 681         case V4L2_CID_MPEG_VIDEO_GOP_SIZE:      name = "Video GOP Size"; break;
 682         case V4L2_CID_MPEG_VIDEO_GOP_CLOSURE:   name = "Video GOP Closure"; break;
 683         case V4L2_CID_MPEG_VIDEO_PULLDOWN:      name = "Video Pulldown"; break;
 684         case V4L2_CID_MPEG_VIDEO_BITRATE_MODE:  name = "Video Bitrate Mode"; break;
 685         case V4L2_CID_MPEG_VIDEO_BITRATE:       name = "Video Bitrate"; break;
 686         case V4L2_CID_MPEG_VIDEO_BITRATE_PEAK:  name = "Video Peak Bitrate"; break;
 687         case V4L2_CID_MPEG_VIDEO_TEMPORAL_DECIMATION: name = "Video Temporal Decimation"; break;
 688         case V4L2_CID_MPEG_STREAM_TYPE:         name = "Stream Type"; break;
 689         case V4L2_CID_MPEG_STREAM_PID_PMT:      name = "Stream PMT Program ID"; break;
 690         case V4L2_CID_MPEG_STREAM_PID_AUDIO:    name = "Stream Audio Program ID"; break;
 691         case V4L2_CID_MPEG_STREAM_PID_VIDEO:    name = "Stream Video Program ID"; break;
 692         case V4L2_CID_MPEG_STREAM_PID_PCR:      name = "Stream PCR Program ID"; break;
 693         case V4L2_CID_MPEG_STREAM_PES_ID_AUDIO: name = "Stream PES Audio ID"; break;
 694         case V4L2_CID_MPEG_STREAM_PES_ID_VIDEO: name = "Stream PES Video ID"; break;
 695         case V4L2_CID_MPEG_STREAM_VBI_FMT:      name = "Stream VBI Format"; break;
 696
 697         default:
 698                 return -EINVAL;
 699         }
 700         switch (qctrl->id) {
 701         case V4L2_CID_AUDIO_MUTE:
 702         case V4L2_CID_AUDIO_LOUDNESS:
 703         case V4L2_CID_MPEG_VIDEO_GOP_CLOSURE:
 704         case V4L2_CID_MPEG_VIDEO_PULLDOWN:
 705                 qctrl->type = V4L2_CTRL_TYPE_BOOLEAN;
 706                 min = 0;
 707                 max = step = 1;
 708                 break;
 709         case V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ:
 710         case V4L2_CID_MPEG_AUDIO_ENCODING:
 711         case V4L2_CID_MPEG_AUDIO_L1_BITRATE:
 712         case V4L2_CID_MPEG_AUDIO_L2_BITRATE:
 713         case V4L2_CID_MPEG_AUDIO_L3_BITRATE:
 714         case V4L2_CID_MPEG_AUDIO_MODE:
 715         case V4L2_CID_MPEG_AUDIO_MODE_EXTENSION:
 716         case V4L2_CID_MPEG_AUDIO_EMPHASIS:
 717         case V4L2_CID_MPEG_AUDIO_CRC:
 718         case V4L2_CID_MPEG_VIDEO_ENCODING:
 719         case V4L2_CID_MPEG_VIDEO_ASPECT:
 720         case V4L2_CID_MPEG_VIDEO_BITRATE_MODE:
 721         case V4L2_CID_MPEG_STREAM_TYPE:
 722         case V4L2_CID_MPEG_STREAM_VBI_FMT:
 723                 qctrl->type = V4L2_CTRL_TYPE_MENU;
 724                 step = 1;
 725                 break;
 726         case V4L2_CID_USER_CLASS:
 727         case V4L2_CID_MPEG_CLASS:
 728                 qctrl->type = V4L2_CTRL_TYPE_CTRL_CLASS;
 729                 qctrl->flags |= V4L2_CTRL_FLAG_READ_ONLY;
 730                 min = max = step = def = 0;
 731                 break;
 732         default:
 733                 qctrl->type = V4L2_CTRL_TYPE_INTEGER;
 734                 break;
 735         }
 736         switch (qctrl->id) {
 737         case V4L2_CID_MPEG_AUDIO_ENCODING:
 738         case V4L2_CID_MPEG_AUDIO_MODE:
 739         case V4L2_CID_MPEG_VIDEO_BITRATE_MODE:
 740         case V4L2_CID_MPEG_VIDEO_B_FRAMES:
 741         case V4L2_CID_MPEG_STREAM_TYPE:
 742                 qctrl->flags |= V4L2_CTRL_FLAG_UPDATE;
 743                 break;
 744         case V4L2_CID_AUDIO_VOLUME:
 745         case V4L2_CID_AUDIO_BALANCE:
 746         case V4L2_CID_AUDIO_BASS:
 747         case V4L2_CID_AUDIO_TREBLE:
 748         case V4L2_CID_BRIGHTNESS:
 749         case V4L2_CID_CONTRAST:
 750         case V4L2_CID_SATURATION:
 751         case V4L2_CID_HUE:
 752                 qctrl->flags |= V4L2_CTRL_FLAG_SLIDER;
 753                 break;
 754         }
 755         qctrl->minimum = min;
 756         qctrl->maximum = max;
 757         qctrl->step = step;
 758         qctrl->default_value = def;
 759         qctrl->reserved[0] = qctrl->reserved[1] = 0;
 760         snprintf(qctrl->name, sizeof(qctrl->name), name);
 761         return 0;
 762 }
 763
 764 /* Fill in a struct v4l2_queryctrl with standard values based on
 765    the control ID. */
 766 int v4l2_ctrl_query_fill_std(struct v4l2_queryctrl *qctrl)
 767 {
 768         switch (qctrl->id) {
 769         /* USER controls */
 770         case V4L2_CID_USER_CLASS:
 771         case V4L2_CID_MPEG_CLASS:
 772                 return v4l2_ctrl_query_fill(qctrl, 0, 0, 0, 0);
 773         case V4L2_CID_AUDIO_VOLUME:
 774                 return v4l2_ctrl_query_fill(qctrl, 0, 65535, 65535 / 100, 58880);
 775         case V4L2_CID_AUDIO_MUTE:
 776         case V4L2_CID_AUDIO_LOUDNESS:
 777                 return v4l2_ctrl_query_fill(qctrl, 0, 1, 1, 0);
 778         case V4L2_CID_AUDIO_BALANCE:
 779         case V4L2_CID_AUDIO_BASS:
 780         case V4L2_CID_AUDIO_TREBLE:
 781                 return v4l2_ctrl_query_fill(qctrl, 0, 65535, 65535 / 100, 32768);
 782         case V4L2_CID_BRIGHTNESS:
 783                 return v4l2_ctrl_query_fill(qctrl, 0, 255, 1, 128);
 784         case V4L2_CID_CONTRAST:
 785         case V4L2_CID_SATURATION:
 786                 return v4l2_ctrl_query_fill(qctrl, 0, 127, 1, 64);
 787         case V4L2_CID_HUE:
 788                 return v4l2_ctrl_query_fill(qctrl, -128, 127, 1, 0);
 789
 790         /* MPEG controls */
 791         case V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ:
 792                 return v4l2_ctrl_query_fill(qctrl,
 793                                 V4L2_MPEG_AUDIO_SAMPLING_FREQ_44100,
 794                                 V4L2_MPEG_AUDIO_SAMPLING_FREQ_32000, 1,
 795                                 V4L2_MPEG_AUDIO_SAMPLING_FREQ_48000);
 796         case V4L2_CID_MPEG_AUDIO_ENCODING:
 797                 return v4l2_ctrl_query_fill(qctrl,
 798                                 V4L2_MPEG_AUDIO_ENCODING_LAYER_1,
 799                                 V4L2_MPEG_AUDIO_ENCODING_LAYER_3, 1,
 800                                 V4L2_MPEG_AUDIO_ENCODING_LAYER_2);
 801         case V4L2_CID_MPEG_AUDIO_L1_BITRATE:
 802                 return v4l2_ctrl_query_fill(qctrl,
 803                                 V4L2_MPEG_AUDIO_L1_BITRATE_32K,
 804                                 V4L2_MPEG_AUDIO_L1_BITRATE_448K, 1,
 805                                 V4L2_MPEG_AUDIO_L1_BITRATE_256K);
 806         case V4L2_CID_MPEG_AUDIO_L2_BITRATE:
 807                 return v4l2_ctrl_query_fill(qctrl,
 808                                 V4L2_MPEG_AUDIO_L2_BITRATE_32K,
 809                                 V4L2_MPEG_AUDIO_L2_BITRATE_384K, 1,
 810                                 V4L2_MPEG_AUDIO_L2_BITRATE_224K);
 811         case V4L2_CID_MPEG_AUDIO_L3_BITRATE:
 812                 return v4l2_ctrl_query_fill(qctrl,
 813                                 V4L2_MPEG_AUDIO_L3_BITRATE_32K,
 814                                 V4L2_MPEG_AUDIO_L3_BITRATE_320K, 1,
 815                                 V4L2_MPEG_AUDIO_L3_BITRATE_192K);
 816         case V4L2_CID_MPEG_AUDIO_MODE:
 817                 return v4l2_ctrl_query_fill(qctrl,
 818                                 V4L2_MPEG_AUDIO_MODE_STEREO,
 819                                 V4L2_MPEG_AUDIO_MODE_MONO, 1,
 820                                 V4L2_MPEG_AUDIO_MODE_STEREO);
 821         case V4L2_CID_MPEG_AUDIO_MODE_EXTENSION:
 822                 return v4l2_ctrl_query_fill(qctrl,
 823                                 V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_4,
 824                                 V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_16, 1,
 825                                 V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_4);
 826         case V4L2_CID_MPEG_AUDIO_EMPHASIS:
 827                 return v4l2_ctrl_query_fill(qctrl,
 828                                 V4L2_MPEG_AUDIO_EMPHASIS_NONE,
 829                                 V4L2_MPEG_AUDIO_EMPHASIS_CCITT_J17, 1,
 830                                 V4L2_MPEG_AUDIO_EMPHASIS_NONE);
 831         case V4L2_CID_MPEG_AUDIO_CRC:
 832                 return v4l2_ctrl_query_fill(qctrl,
 833                                 V4L2_MPEG_AUDIO_CRC_NONE,
 834                                 V4L2_MPEG_AUDIO_CRC_CRC16, 1,
 835                                 V4L2_MPEG_AUDIO_CRC_NONE);
 836         case V4L2_CID_MPEG_VIDEO_ENCODING:
 837                 return v4l2_ctrl_query_fill(qctrl,
 838                                 V4L2_MPEG_VIDEO_ENCODING_MPEG_1,
 839                                 V4L2_MPEG_VIDEO_ENCODING_MPEG_2, 1,
 840                                 V4L2_MPEG_VIDEO_ENCODING_MPEG_2);
 841         case V4L2_CID_MPEG_VIDEO_ASPECT:
 842                 return v4l2_ctrl_query_fill(qctrl,
 843                                 V4L2_MPEG_VIDEO_ASPECT_1x1,
 844                                 V4L2_MPEG_VIDEO_ASPECT_221x100, 1,
 845                                 V4L2_MPEG_VIDEO_ASPECT_4x3);
 846         case V4L2_CID_MPEG_VIDEO_B_FRAMES:
 847                 return v4l2_ctrl_query_fill(qctrl, 0, 33, 1, 2);
 848         case V4L2_CID_MPEG_VIDEO_GOP_SIZE:
 849                 return v4l2_ctrl_query_fill(qctrl, 1, 34, 1, 12);
 850         case V4L2_CID_MPEG_VIDEO_GOP_CLOSURE:
 851                 return v4l2_ctrl_query_fill(qctrl, 0, 1, 1, 1);
 852         case V4L2_CID_MPEG_VIDEO_PULLDOWN:
 853                 return v4l2_ctrl_query_fill(qctrl, 0, 1, 1, 0);
 854         case V4L2_CID_MPEG_VIDEO_BITRATE_MODE:
 855                 return v4l2_ctrl_query_fill(qctrl,
 856                                 V4L2_MPEG_VIDEO_BITRATE_MODE_VBR,
 857                                 V4L2_MPEG_VIDEO_BITRATE_MODE_CBR, 1,
 858                                 V4L2_MPEG_VIDEO_BITRATE_MODE_VBR);
 859         case V4L2_CID_MPEG_VIDEO_BITRATE:
 860                 return v4l2_ctrl_query_fill(qctrl, 0, 27000000, 1, 6000000);
 861         case V4L2_CID_MPEG_VIDEO_BITRATE_PEAK:
 862                 return v4l2_ctrl_query_fill(qctrl, 0, 27000000, 1, 8000000);
 863         case V4L2_CID_MPEG_VIDEO_TEMPORAL_DECIMATION:
 864                 return v4l2_ctrl_query_fill(qctrl, 0, 255, 1, 0);
 865         case V4L2_CID_MPEG_STREAM_TYPE:
 866                 return v4l2_ctrl_query_fill(qctrl,
 867                                 V4L2_MPEG_STREAM_TYPE_MPEG2_PS,
 868                                 V4L2_MPEG_STREAM_TYPE_MPEG2_SVCD, 1,
 869                                 V4L2_MPEG_STREAM_TYPE_MPEG2_PS);
 870         case V4L2_CID_MPEG_STREAM_PID_PMT:
 871                 return v4l2_ctrl_query_fill(qctrl, 0, (1 << 14) - 1, 1, 16);
 872         case V4L2_CID_MPEG_STREAM_PID_AUDIO:
 873                 return v4l2_ctrl_query_fill(qctrl, 0, (1 << 14) - 1, 1, 260);
 874         case V4L2_CID_MPEG_STREAM_PID_VIDEO:
 875                 return v4l2_ctrl_query_fill(qctrl, 0, (1 << 14) - 1, 1, 256);
 876         case V4L2_CID_MPEG_STREAM_PID_PCR:
 877                 return v4l2_ctrl_query_fill(qctrl, 0, (1 << 14) - 1, 1, 259);
 878         case V4L2_CID_MPEG_STREAM_PES_ID_AUDIO:
 879                 return v4l2_ctrl_query_fill(qctrl, 0, 255, 1, 0);
 880         case V4L2_CID_MPEG_STREAM_PES_ID_VIDEO:
 881                 return v4l2_ctrl_query_fill(qctrl, 0, 255, 1, 0);
 882         case V4L2_CID_MPEG_STREAM_VBI_FMT:
 883                 return v4l2_ctrl_query_fill(qctrl,
 884                                 V4L2_MPEG_STREAM_VBI_FMT_NONE,
 885                                 V4L2_MPEG_STREAM_VBI_FMT_IVTV, 1,
 886                                 V4L2_MPEG_STREAM_VBI_FMT_NONE);
 887         default:
 888                 return -EINVAL;
 889         }
 890 }
 891
 892 /* Fill in a struct v4l2_querymenu based on the struct v4l2_queryctrl and
 893    the menu. The qctrl pointer may be NULL, in which case it is ignored. */
 894 int v4l2_ctrl_query_menu(struct v4l2_querymenu *qmenu, struct v4l2_queryctrl *qctrl,
 895                const char **menu_items)
 896 {
 897         int i;
 898
 899         if (menu_items == NULL ||
 900             (qctrl && (qmenu->index < qctrl->minimum || qmenu->index > qctrl->maximum)))
 901                 return -EINVAL;
 902         for (i = 0; i < qmenu->index && menu_items[i]; i++) ;
 903         if (menu_items[i] == NULL || menu_items[i][0] == '\0')
 904                 return -EINVAL;
 905         snprintf(qmenu->name, sizeof(qmenu->name), menu_items[qmenu->index]);
 906         qmenu->reserved = 0;
 907         return 0;
 908 }
 909
 910 /* ctrl_classes points to an array of u32 pointers, the last element is
 911    a NULL pointer. Each u32 array is a 0-terminated array of control IDs.
 912    Each array must be sorted low to high and belong to the same control
 913    class. The array of u32 pointer must also be sorted, from low class IDs
 914    to high class IDs.
 915
 916    This function returns the first ID that follows after the given ID.
 917    When no more controls are available 0 is returned. */
 918 u32 v4l2_ctrl_next(const u32 * const * ctrl_classes, u32 id)
 919 {
 920         u32 ctrl_class;
 921         const u32 *pctrl;
 922
 923         /* if no query is desired, then just return the control ID */
 924         if ((id & V4L2_CTRL_FLAG_NEXT_CTRL) == 0)
 925                 return id;
 926         if (ctrl_classes == NULL)
 927                 return 0;
 928         id &= V4L2_CTRL_ID_MASK;
 929         ctrl_class = V4L2_CTRL_ID2CLASS(id);
 930         id++;   /* select next control */
 931         /* find first class that matches (or is greater than) the class of
 932            the ID */
 933         while (*ctrl_classes && V4L2_CTRL_ID2CLASS(**ctrl_classes) < ctrl_class)
 934                 ctrl_classes++;
 935         /* no more classes */
 936         if (*ctrl_classes == NULL)
 937                 return 0;
 938         pctrl = *ctrl_classes;
 939         /* find first ctrl within the class that is >= ID */
 940         while (*pctrl && *pctrl < id) pctrl++;
 941         if (*pctrl)
 942                 return *pctrl;
 943         /* we are at the end of the controls of the current class. */
 944         /* continue with next class if available */
 945         ctrl_classes++;
 946         if (*ctrl_classes == NULL)
 947                 return 0;
 948         return **ctrl_classes;
 949 }
 950
 951 int v4l2_chip_match_i2c_client(struct i2c_client *c, u32 match_type, u32 match_chip)
 952 {
 953         switch (match_type) {
 954         case V4L2_CHIP_MATCH_ALWAYS:
 955                 return 1;
 956         case V4L2_CHIP_MATCH_I2C_DRIVER:
 957                 return (c != NULL && c->driver != NULL && c->driver->id == match_chip);
 958         case V4L2_CHIP_MATCH_I2C_ADDR:
 959                 return (c != NULL && c->addr == match_chip);
 960         default:
 961                 return 0;
 962         }
 963 }
 964
 965 int v4l2_chip_match_host(u32 match_type, u32 match_chip)
 966 {
 967         switch (match_type) {
 968         case V4L2_CHIP_MATCH_ALWAYS:
 969                 return 1;
 970         case V4L2_CHIP_MATCH_HOST:
 971                 return match_chip == 0;
 972         default:
 973                 return 0;
 974         }
 975 }
 976
 977 /* ----------------------------------------------------------------- */
 978
 979 EXPORT_SYMBOL(v4l2_norm_to_name);
 980 EXPORT_SYMBOL(v4l2_video_std_construct);
 981
 982 EXPORT_SYMBOL(v4l2_prio_init);
 983 EXPORT_SYMBOL(v4l2_prio_change);
 984 EXPORT_SYMBOL(v4l2_prio_open);
 985 EXPORT_SYMBOL(v4l2_prio_close);
 986 EXPORT_SYMBOL(v4l2_prio_max);
 987 EXPORT_SYMBOL(v4l2_prio_check);
 988
 989 EXPORT_SYMBOL(v4l2_field_names);
 990 EXPORT_SYMBOL(v4l2_type_names);
 991 EXPORT_SYMBOL(v4l_printk_ioctl);
 992
 993 EXPORT_SYMBOL(v4l2_ctrl_next);
 994 EXPORT_SYMBOL(v4l2_ctrl_check);
 995 EXPORT_SYMBOL(v4l2_ctrl_get_menu);
 996 EXPORT_SYMBOL(v4l2_ctrl_query_menu);
 997 EXPORT_SYMBOL(v4l2_ctrl_query_fill);
 998 EXPORT_SYMBOL(v4l2_ctrl_query_fill_std);
 999
1000 EXPORT_SYMBOL(v4l2_chip_match_i2c_client);
1001 EXPORT_SYMBOL(v4l2_chip_match_host);
1002
1003 /*
1004  * Local variables:
1005  * c-basic-offset: 8
1006  * End:
1007  */