Home | History | Annotate | Download | only in include
      1 /*
      2  *  Video for Linux Two header file
      3  *
      4  *  Copyright (C) 1999-2007 the contributors
      5  *
      6  *  This program is free software; you can redistribute it and/or modify
      7  *  it under the terms of the GNU General Public License as published by
      8  *  the Free Software Foundation; either version 2 of the License, or
      9  *  (at your option) any later version.
     10  *
     11  *  This program is distributed in the hope that it will be useful,
     12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
     13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     14  *  GNU General Public License for more details.
     15  *
     16  *  Alternatively you can redistribute this file under the terms of the
     17  *  BSD license as stated below:
     18  *
     19  *  Redistribution and use in source and binary forms, with or without
     20  *  modification, are permitted provided that the following conditions
     21  *  are met:
     22  *  1. Redistributions of source code must retain the above copyright
     23  *     notice, this list of conditions and the following disclaimer.
     24  *  2. Redistributions in binary form must reproduce the above copyright
     25  *     notice, this list of conditions and the following disclaimer in
     26  *     the documentation and/or other materials provided with the
     27  *     distribution.
     28  *  3. The names of its contributors may not be used to endorse or promote
     29  *     products derived from this software without specific prior written
     30  *     permission.
     31  *
     32  *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     33  *  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     34  *  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
     35  *  A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     36  *  OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
     37  *  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
     38  *  TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
     39  *  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
     40  *  LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
     41  *  NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
     42  *  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     43  *
     44  *	Header file for v4l or V4L2 drivers and applications
     45  * with public API.
     46  * All kernel-specific stuff were moved to media/v4l2-dev.h, so
     47  * no #if __KERNEL tests are allowed here
     48  *
     49  *	See http://linuxtv.org for more info
     50  *
     51  *	Author: Bill Dirks <bill (at) thedirks.org>
     52  *		Justin Schoeman
     53  *              Hans Verkuil <hverkuil (at) xs4all.nl>
     54  *		et al.
     55  */
     56 #ifndef __LINUX_VIDEODEV2_H
     57 #define __LINUX_VIDEODEV2_H
     58 
     59 #ifdef __KERNEL__
     60 #include <linux/time.h>     /* need struct timeval */
     61 #else
     62 #include <sys/time.h>
     63 #endif
     64 #include <linux/compiler.h>
     65 #include <linux/ioctl.h>
     66 #include <linux/types.h>
     67 
     68 /*
     69  * Common stuff for both V4L1 and V4L2
     70  * Moved from videodev.h
     71  */
     72 #define VIDEO_MAX_FRAME               32
     73 #define VIDEO_MAX_PLANES               8
     74 
     75 #ifndef __KERNEL__
     76 
     77 /* These defines are V4L1 specific and should not be used with the V4L2 API!
     78    They will be removed from this header in the future. */
     79 
     80 #define VID_TYPE_CAPTURE	1	/* Can capture */
     81 #define VID_TYPE_TUNER		2	/* Can tune */
     82 #define VID_TYPE_TELETEXT	4	/* Does teletext */
     83 #define VID_TYPE_OVERLAY	8	/* Overlay onto frame buffer */
     84 #define VID_TYPE_CHROMAKEY	16	/* Overlay by chromakey */
     85 #define VID_TYPE_CLIPPING	32	/* Can clip */
     86 #define VID_TYPE_FRAMERAM	64	/* Uses the frame buffer memory */
     87 #define VID_TYPE_SCALES		128	/* Scalable */
     88 #define VID_TYPE_MONOCHROME	256	/* Monochrome only */
     89 #define VID_TYPE_SUBCAPTURE	512	/* Can capture subareas of the image */
     90 #define VID_TYPE_MPEG_DECODER	1024	/* Can decode MPEG streams */
     91 #define VID_TYPE_MPEG_ENCODER	2048	/* Can encode MPEG streams */
     92 #define VID_TYPE_MJPEG_DECODER	4096	/* Can decode MJPEG streams */
     93 #define VID_TYPE_MJPEG_ENCODER	8192	/* Can encode MJPEG streams */
     94 #endif
     95 
     96 /*
     97  *	M I S C E L L A N E O U S
     98  */
     99 
    100 /*  Four-character-code (FOURCC) */
    101 #define v4l2_fourcc(a, b, c, d)\
    102 	((__u32)(a) | ((__u32)(b) << 8) | ((__u32)(c) << 16) | ((__u32)(d) << 24))
    103 
    104 /*
    105  *	E N U M S
    106  */
    107 enum v4l2_field {
    108 	V4L2_FIELD_ANY           = 0, /* driver can choose from none,
    109 					 top, bottom, interlaced
    110 					 depending on whatever it thinks
    111 					 is approximate ... */
    112 	V4L2_FIELD_NONE          = 1, /* this device has no fields ... */
    113 	V4L2_FIELD_TOP           = 2, /* top field only */
    114 	V4L2_FIELD_BOTTOM        = 3, /* bottom field only */
    115 	V4L2_FIELD_INTERLACED    = 4, /* both fields interlaced */
    116 	V4L2_FIELD_SEQ_TB        = 5, /* both fields sequential into one
    117 					 buffer, top-bottom order */
    118 	V4L2_FIELD_SEQ_BT        = 6, /* same as above + bottom-top order */
    119 	V4L2_FIELD_ALTERNATE     = 7, /* both fields alternating into
    120 					 separate buffers */
    121 	V4L2_FIELD_INTERLACED_TB = 8, /* both fields interlaced, top field
    122 					 first and the top field is
    123 					 transmitted first */
    124 	V4L2_FIELD_INTERLACED_BT = 9, /* both fields interlaced, top field
    125 					 first and the bottom field is
    126 					 transmitted first */
    127 };
    128 #define V4L2_FIELD_HAS_TOP(field)	\
    129 	((field) == V4L2_FIELD_TOP 	||\
    130 	 (field) == V4L2_FIELD_INTERLACED ||\
    131 	 (field) == V4L2_FIELD_INTERLACED_TB ||\
    132 	 (field) == V4L2_FIELD_INTERLACED_BT ||\
    133 	 (field) == V4L2_FIELD_SEQ_TB	||\
    134 	 (field) == V4L2_FIELD_SEQ_BT)
    135 #define V4L2_FIELD_HAS_BOTTOM(field)	\
    136 	((field) == V4L2_FIELD_BOTTOM 	||\
    137 	 (field) == V4L2_FIELD_INTERLACED ||\
    138 	 (field) == V4L2_FIELD_INTERLACED_TB ||\
    139 	 (field) == V4L2_FIELD_INTERLACED_BT ||\
    140 	 (field) == V4L2_FIELD_SEQ_TB	||\
    141 	 (field) == V4L2_FIELD_SEQ_BT)
    142 #define V4L2_FIELD_HAS_BOTH(field)	\
    143 	((field) == V4L2_FIELD_INTERLACED ||\
    144 	 (field) == V4L2_FIELD_INTERLACED_TB ||\
    145 	 (field) == V4L2_FIELD_INTERLACED_BT ||\
    146 	 (field) == V4L2_FIELD_SEQ_TB ||\
    147 	 (field) == V4L2_FIELD_SEQ_BT)
    148 
    149 enum v4l2_buf_type {
    150 	V4L2_BUF_TYPE_VIDEO_CAPTURE        = 1,
    151 	V4L2_BUF_TYPE_VIDEO_OUTPUT         = 2,
    152 	V4L2_BUF_TYPE_VIDEO_OVERLAY        = 3,
    153 	V4L2_BUF_TYPE_VBI_CAPTURE          = 4,
    154 	V4L2_BUF_TYPE_VBI_OUTPUT           = 5,
    155 	V4L2_BUF_TYPE_SLICED_VBI_CAPTURE   = 6,
    156 	V4L2_BUF_TYPE_SLICED_VBI_OUTPUT    = 7,
    157 #if 1
    158 	/* Experimental */
    159 	V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY = 8,
    160 #endif
    161 	V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE = 9,
    162 	V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE  = 10,
    163 	V4L2_BUF_TYPE_PRIVATE              = 0x80,
    164 };
    165 
    166 #define V4L2_TYPE_IS_MULTIPLANAR(type)			\
    167 	((type) == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE	\
    168 	 || (type) == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE)
    169 
    170 #define V4L2_TYPE_IS_OUTPUT(type)				\
    171 	((type) == V4L2_BUF_TYPE_VIDEO_OUTPUT			\
    172 	 || (type) == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE		\
    173 	 || (type) == V4L2_BUF_TYPE_VIDEO_OVERLAY		\
    174 	 || (type) == V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY	\
    175 	 || (type) == V4L2_BUF_TYPE_VBI_OUTPUT			\
    176 	 || (type) == V4L2_BUF_TYPE_SLICED_VBI_OUTPUT)
    177 
    178 enum v4l2_tuner_type {
    179 	V4L2_TUNER_RADIO	     = 1,
    180 	V4L2_TUNER_ANALOG_TV	     = 2,
    181 	V4L2_TUNER_DIGITAL_TV	     = 3,
    182 };
    183 
    184 enum v4l2_memory {
    185 	V4L2_MEMORY_MMAP             = 1,
    186 	V4L2_MEMORY_USERPTR          = 2,
    187 	V4L2_MEMORY_OVERLAY          = 3,
    188 	V4L2_MEMORY_DMABUF           = 4,
    189 };
    190 
    191 /* see also http://vektor.theorem.ca/graphics/ycbcr/ */
    192 enum v4l2_colorspace {
    193 	/* ITU-R 601 -- broadcast NTSC/PAL */
    194 	V4L2_COLORSPACE_SMPTE170M     = 1,
    195 
    196 	/* 1125-Line (US) HDTV */
    197 	V4L2_COLORSPACE_SMPTE240M     = 2,
    198 
    199 	/* HD and modern captures. */
    200 	V4L2_COLORSPACE_REC709        = 3,
    201 
    202 	/* broken BT878 extents (601, luma range 16-253 instead of 16-235) */
    203 	V4L2_COLORSPACE_BT878         = 4,
    204 
    205 	/* These should be useful.  Assume 601 extents. */
    206 	V4L2_COLORSPACE_470_SYSTEM_M  = 5,
    207 	V4L2_COLORSPACE_470_SYSTEM_BG = 6,
    208 
    209 	/* I know there will be cameras that send this.  So, this is
    210 	 * unspecified chromaticities and full 0-255 on each of the
    211 	 * Y'CbCr components
    212 	 */
    213 	V4L2_COLORSPACE_JPEG          = 7,
    214 
    215 	/* For RGB colourspaces, this is probably a good start. */
    216 	V4L2_COLORSPACE_SRGB          = 8,
    217 };
    218 
    219 enum v4l2_priority {
    220 	V4L2_PRIORITY_UNSET       = 0,  /* not initialized */
    221 	V4L2_PRIORITY_BACKGROUND  = 1,
    222 	V4L2_PRIORITY_INTERACTIVE = 2,
    223 	V4L2_PRIORITY_RECORD      = 3,
    224 	V4L2_PRIORITY_DEFAULT     = V4L2_PRIORITY_INTERACTIVE,
    225 };
    226 
    227 struct v4l2_rect {
    228 	__s32   left;
    229 	__s32   top;
    230 	__s32   width;
    231 	__s32   height;
    232 };
    233 
    234 struct v4l2_fract {
    235 	__u32   numerator;
    236 	__u32   denominator;
    237 };
    238 
    239 /**
    240   * struct v4l2_capability - Describes V4L2 device caps returned by VIDIOC_QUERYCAP
    241   *
    242   * @driver:	   name of the driver module (e.g. "bttv")
    243   * @card:	   name of the card (e.g. "Hauppauge WinTV")
    244   * @bus_info:	   name of the bus (e.g. "PCI:" + pci_name(pci_dev) )
    245   * @version:	   KERNEL_VERSION
    246   * @capabilities: capabilities of the physical device as a whole
    247   * @device_caps:  capabilities accessed via this particular device (node)
    248   * @reserved:	   reserved fields for future extensions
    249   */
    250 struct v4l2_capability {
    251 	__u8	driver[16];
    252 	__u8	card[32];
    253 	__u8	bus_info[32];
    254 	__u32   version;
    255 	__u32	capabilities;
    256 	__u32	device_caps;
    257 	__u32	reserved[3];
    258 };
    259 
    260 /* Values for 'capabilities' field */
    261 #define V4L2_CAP_VIDEO_CAPTURE		0x00000001  /* Is a video capture device */
    262 #define V4L2_CAP_VIDEO_OUTPUT		0x00000002  /* Is a video output device */
    263 #define V4L2_CAP_VIDEO_OVERLAY		0x00000004  /* Can do video overlay */
    264 #define V4L2_CAP_VBI_CAPTURE		0x00000010  /* Is a raw VBI capture device */
    265 #define V4L2_CAP_VBI_OUTPUT		0x00000020  /* Is a raw VBI output device */
    266 #define V4L2_CAP_SLICED_VBI_CAPTURE	0x00000040  /* Is a sliced VBI capture device */
    267 #define V4L2_CAP_SLICED_VBI_OUTPUT	0x00000080  /* Is a sliced VBI output device */
    268 #define V4L2_CAP_RDS_CAPTURE		0x00000100  /* RDS data capture */
    269 #define V4L2_CAP_VIDEO_OUTPUT_OVERLAY	0x00000200  /* Can do video output overlay */
    270 #define V4L2_CAP_HW_FREQ_SEEK		0x00000400  /* Can do hardware frequency seek  */
    271 #define V4L2_CAP_RDS_OUTPUT		0x00000800  /* Is an RDS encoder */
    272 
    273 /* Is a video capture device that supports multiplanar formats */
    274 #define V4L2_CAP_VIDEO_CAPTURE_MPLANE	0x00001000
    275 /* Is a video output device that supports multiplanar formats */
    276 #define V4L2_CAP_VIDEO_OUTPUT_MPLANE	0x00002000
    277 
    278 #define V4L2_CAP_TUNER			0x00010000  /* has a tuner */
    279 #define V4L2_CAP_AUDIO			0x00020000  /* has audio support */
    280 #define V4L2_CAP_RADIO			0x00040000  /* is a radio device */
    281 #define V4L2_CAP_MODULATOR		0x00080000  /* has a modulator */
    282 
    283 #define V4L2_CAP_READWRITE              0x01000000  /* read/write systemcalls */
    284 #define V4L2_CAP_ASYNCIO                0x02000000  /* async I/O */
    285 #define V4L2_CAP_STREAMING              0x04000000  /* streaming I/O ioctls */
    286 
    287 #define V4L2_CAP_DEVICE_CAPS            0x80000000  /* sets device capabilities field */
    288 
    289 /*
    290  *	V I D E O   I M A G E   F O R M A T
    291  */
    292 struct v4l2_pix_format {
    293 	__u32         		width;
    294 	__u32			height;
    295 	__u32			pixelformat;
    296 	enum v4l2_field  	field;
    297 	__u32            	bytesperline;	/* for padding, zero if unused */
    298 	__u32          		sizeimage;
    299 	enum v4l2_colorspace	colorspace;
    300 	__u32			priv;		/* private data, depends on pixelformat */
    301 };
    302 
    303 /*      Pixel format         FOURCC                          depth  Description  */
    304 
    305 /* RGB formats */
    306 #define V4L2_PIX_FMT_RGB332  v4l2_fourcc('R', 'G', 'B', '1') /*  8  RGB-3-3-2     */
    307 #define V4L2_PIX_FMT_RGB444  v4l2_fourcc('R', '4', '4', '4') /* 16  xxxxrrrr ggggbbbb */
    308 #define V4L2_PIX_FMT_RGB555  v4l2_fourcc('R', 'G', 'B', 'O') /* 16  RGB-5-5-5     */
    309 #define V4L2_PIX_FMT_RGB565  v4l2_fourcc('R', 'G', 'B', 'P') /* 16  RGB-5-6-5     */
    310 #define V4L2_PIX_FMT_RGB555X v4l2_fourcc('R', 'G', 'B', 'Q') /* 16  RGB-5-5-5 BE  */
    311 #define V4L2_PIX_FMT_RGB565X v4l2_fourcc('R', 'G', 'B', 'R') /* 16  RGB-5-6-5 BE  */
    312 #define V4L2_PIX_FMT_BGR666  v4l2_fourcc('B', 'G', 'R', 'H') /* 18  BGR-6-6-6	  */
    313 #define V4L2_PIX_FMT_BGR24   v4l2_fourcc('B', 'G', 'R', '3') /* 24  BGR-8-8-8     */
    314 #define V4L2_PIX_FMT_RGB24   v4l2_fourcc('R', 'G', 'B', '3') /* 24  RGB-8-8-8     */
    315 #define V4L2_PIX_FMT_BGR32   v4l2_fourcc('B', 'G', 'R', '4') /* 32  BGR-8-8-8-8   */
    316 #define V4L2_PIX_FMT_RGB32   v4l2_fourcc('R', 'G', 'B', '4') /* 32  RGB-8-8-8-8   */
    317 
    318 /* Grey formats */
    319 #define V4L2_PIX_FMT_GREY    v4l2_fourcc('G', 'R', 'E', 'Y') /*  8  Greyscale     */
    320 #define V4L2_PIX_FMT_Y4      v4l2_fourcc('Y', '0', '4', ' ') /*  4  Greyscale     */
    321 #define V4L2_PIX_FMT_Y6      v4l2_fourcc('Y', '0', '6', ' ') /*  6  Greyscale     */
    322 #define V4L2_PIX_FMT_Y10     v4l2_fourcc('Y', '1', '0', ' ') /* 10  Greyscale     */
    323 #define V4L2_PIX_FMT_Y12     v4l2_fourcc('Y', '1', '2', ' ') /* 12  Greyscale     */
    324 #define V4L2_PIX_FMT_Y16     v4l2_fourcc('Y', '1', '6', ' ') /* 16  Greyscale     */
    325 
    326 /* Grey bit-packed formats */
    327 #define V4L2_PIX_FMT_Y10BPACK    v4l2_fourcc('Y', '1', '0', 'B') /* 10  Greyscale bit-packed */
    328 
    329 /* Palette formats */
    330 #define V4L2_PIX_FMT_PAL8    v4l2_fourcc('P', 'A', 'L', '8') /*  8  8-bit palette */
    331 
    332 /* Luminance+Chrominance formats */
    333 #define V4L2_PIX_FMT_YVU410  v4l2_fourcc('Y', 'V', 'U', '9') /*  9  YVU 4:1:0     */
    334 #define V4L2_PIX_FMT_YVU420  v4l2_fourcc('Y', 'V', '1', '2') /* 12  YVU 4:2:0     */
    335 #define V4L2_PIX_FMT_YUYV    v4l2_fourcc('Y', 'U', 'Y', 'V') /* 16  YUV 4:2:2     */
    336 #define V4L2_PIX_FMT_YYUV    v4l2_fourcc('Y', 'Y', 'U', 'V') /* 16  YUV 4:2:2     */
    337 #define V4L2_PIX_FMT_YVYU    v4l2_fourcc('Y', 'V', 'Y', 'U') /* 16 YVU 4:2:2 */
    338 #define V4L2_PIX_FMT_UYVY    v4l2_fourcc('U', 'Y', 'V', 'Y') /* 16  YUV 4:2:2     */
    339 #define V4L2_PIX_FMT_VYUY    v4l2_fourcc('V', 'Y', 'U', 'Y') /* 16  YUV 4:2:2     */
    340 #define V4L2_PIX_FMT_YUV422P v4l2_fourcc('4', '2', '2', 'P') /* 16  YVU422 planar */
    341 #define V4L2_PIX_FMT_YUV411P v4l2_fourcc('4', '1', '1', 'P') /* 16  YVU411 planar */
    342 #define V4L2_PIX_FMT_Y41P    v4l2_fourcc('Y', '4', '1', 'P') /* 12  YUV 4:1:1     */
    343 #define V4L2_PIX_FMT_YUV444  v4l2_fourcc('Y', '4', '4', '4') /* 16  xxxxyyyy uuuuvvvv */
    344 #define V4L2_PIX_FMT_YUV555  v4l2_fourcc('Y', 'U', 'V', 'O') /* 16  YUV-5-5-5     */
    345 #define V4L2_PIX_FMT_YUV565  v4l2_fourcc('Y', 'U', 'V', 'P') /* 16  YUV-5-6-5     */
    346 #define V4L2_PIX_FMT_YUV32   v4l2_fourcc('Y', 'U', 'V', '4') /* 32  YUV-8-8-8-8   */
    347 #define V4L2_PIX_FMT_YUV410  v4l2_fourcc('Y', 'U', 'V', '9') /*  9  YUV 4:1:0     */
    348 #define V4L2_PIX_FMT_YUV420  v4l2_fourcc('Y', 'U', '1', '2') /* 12  YUV 4:2:0     */
    349 #define V4L2_PIX_FMT_HI240   v4l2_fourcc('H', 'I', '2', '4') /*  8  8-bit color   */
    350 #define V4L2_PIX_FMT_HM12    v4l2_fourcc('H', 'M', '1', '2') /*  8  YUV 4:2:0 16x16 macroblocks */
    351 #define V4L2_PIX_FMT_M420    v4l2_fourcc('M', '4', '2', '0') /* 12  YUV 4:2:0 2 lines y, 1 line uv interleaved */
    352 
    353 /* two planes -- one Y, one Cr + Cb interleaved  */
    354 #define V4L2_PIX_FMT_NV12    v4l2_fourcc('N', 'V', '1', '2') /* 12  Y/CbCr 4:2:0  */
    355 #define V4L2_PIX_FMT_NV21    v4l2_fourcc('N', 'V', '2', '1') /* 12  Y/CrCb 4:2:0  */
    356 #define V4L2_PIX_FMT_NV16    v4l2_fourcc('N', 'V', '1', '6') /* 16  Y/CbCr 4:2:2  */
    357 #define V4L2_PIX_FMT_NV61    v4l2_fourcc('N', 'V', '6', '1') /* 16  Y/CrCb 4:2:2  */
    358 #define V4L2_PIX_FMT_NV24    v4l2_fourcc('N', 'V', '2', '4') /* 24  Y/CbCr 4:4:4  */
    359 #define V4L2_PIX_FMT_NV42    v4l2_fourcc('N', 'V', '4', '2') /* 24  Y/CrCb 4:4:4  */
    360 
    361 /* two non contiguous planes - one Y, one Cr + Cb interleaved  */
    362 #define V4L2_PIX_FMT_NV12M   v4l2_fourcc('N', 'M', '1', '2') /* 12  Y/CbCr 4:2:0  */
    363 #define V4L2_PIX_FMT_NV12MT  v4l2_fourcc('T', 'M', '1', '2') /* 12  Y/CbCr 4:2:0 64x32 macroblocks */
    364 
    365 /* three non contiguous planes - Y, Cb, Cr */
    366 #define V4L2_PIX_FMT_YUV420M v4l2_fourcc('Y', 'M', '1', '2') /* 12  YUV420 planar */
    367 
    368 /* Bayer formats - see http://www.siliconimaging.com/RGB%20Bayer.htm */
    369 #define V4L2_PIX_FMT_SBGGR8  v4l2_fourcc('B', 'A', '8', '1') /*  8  BGBG.. GRGR.. */
    370 #define V4L2_PIX_FMT_SGBRG8  v4l2_fourcc('G', 'B', 'R', 'G') /*  8  GBGB.. RGRG.. */
    371 #define V4L2_PIX_FMT_SGRBG8  v4l2_fourcc('G', 'R', 'B', 'G') /*  8  GRGR.. BGBG.. */
    372 #define V4L2_PIX_FMT_SRGGB8  v4l2_fourcc('R', 'G', 'G', 'B') /*  8  RGRG.. GBGB.. */
    373 #define V4L2_PIX_FMT_SBGGR10 v4l2_fourcc('B', 'G', '1', '0') /* 10  BGBG.. GRGR.. */
    374 #define V4L2_PIX_FMT_SGBRG10 v4l2_fourcc('G', 'B', '1', '0') /* 10  GBGB.. RGRG.. */
    375 #define V4L2_PIX_FMT_SGRBG10 v4l2_fourcc('B', 'A', '1', '0') /* 10  GRGR.. BGBG.. */
    376 #define V4L2_PIX_FMT_SRGGB10 v4l2_fourcc('R', 'G', '1', '0') /* 10  RGRG.. GBGB.. */
    377 #define V4L2_PIX_FMT_SBGGR12 v4l2_fourcc('B', 'G', '1', '2') /* 12  BGBG.. GRGR.. */
    378 #define V4L2_PIX_FMT_SGBRG12 v4l2_fourcc('G', 'B', '1', '2') /* 12  GBGB.. RGRG.. */
    379 #define V4L2_PIX_FMT_SGRBG12 v4l2_fourcc('B', 'A', '1', '2') /* 12  GRGR.. BGBG.. */
    380 #define V4L2_PIX_FMT_SRGGB12 v4l2_fourcc('R', 'G', '1', '2') /* 12  RGRG.. GBGB.. */
    381 	/* 10bit raw bayer DPCM compressed to 8 bits */
    382 #define V4L2_PIX_FMT_SGRBG10DPCM8 v4l2_fourcc('B', 'D', '1', '0')
    383 	/*
    384 	 * 10bit raw bayer, expanded to 16 bits
    385 	 * xxxxrrrrrrrrrrxxxxgggggggggg xxxxggggggggggxxxxbbbbbbbbbb...
    386 	 */
    387 #define V4L2_PIX_FMT_SBGGR16 v4l2_fourcc('B', 'Y', 'R', '2') /* 16  BGBG.. GRGR.. */
    388 
    389 /* compressed formats */
    390 #define V4L2_PIX_FMT_MJPEG    v4l2_fourcc('M', 'J', 'P', 'G') /* Motion-JPEG   */
    391 #define V4L2_PIX_FMT_JPEG     v4l2_fourcc('J', 'P', 'E', 'G') /* JFIF JPEG     */
    392 #define V4L2_PIX_FMT_DV       v4l2_fourcc('d', 'v', 's', 'd') /* 1394          */
    393 #define V4L2_PIX_FMT_MPEG     v4l2_fourcc('M', 'P', 'E', 'G') /* MPEG-1/2/4 Multiplexed */
    394 #define V4L2_PIX_FMT_H264     v4l2_fourcc('H', '2', '6', '4') /* H264 with start codes */
    395 #define V4L2_PIX_FMT_H264_NO_SC v4l2_fourcc('A', 'V', 'C', '1') /* H264 without start codes */
    396 #define V4L2_PIX_FMT_H263     v4l2_fourcc('H', '2', '6', '3') /* H263          */
    397 #define V4L2_PIX_FMT_MPEG1    v4l2_fourcc('M', 'P', 'G', '1') /* MPEG-1 ES     */
    398 #define V4L2_PIX_FMT_MPEG2    v4l2_fourcc('M', 'P', 'G', '2') /* MPEG-2 ES     */
    399 #define V4L2_PIX_FMT_MPEG4    v4l2_fourcc('M', 'P', 'G', '4') /* MPEG-4 ES     */
    400 #define V4L2_PIX_FMT_XVID     v4l2_fourcc('X', 'V', 'I', 'D') /* Xvid           */
    401 #define V4L2_PIX_FMT_VC1_ANNEX_G v4l2_fourcc('V', 'C', '1', 'G') /* SMPTE 421M Annex G compliant stream */
    402 #define V4L2_PIX_FMT_VC1_ANNEX_L v4l2_fourcc('V', 'C', '1', 'L') /* SMPTE 421M Annex L compliant stream */
    403 
    404 /*  Vendor-specific formats   */
    405 #define V4L2_PIX_FMT_CPIA1    v4l2_fourcc('C', 'P', 'I', 'A') /* cpia1 YUV */
    406 #define V4L2_PIX_FMT_WNVA     v4l2_fourcc('W', 'N', 'V', 'A') /* Winnov hw compress */
    407 #define V4L2_PIX_FMT_SN9C10X  v4l2_fourcc('S', '9', '1', '0') /* SN9C10x compression */
    408 #define V4L2_PIX_FMT_SN9C20X_I420 v4l2_fourcc('S', '9', '2', '0') /* SN9C20x YUV 4:2:0 */
    409 #define V4L2_PIX_FMT_PWC1     v4l2_fourcc('P', 'W', 'C', '1') /* pwc older webcam */
    410 #define V4L2_PIX_FMT_PWC2     v4l2_fourcc('P', 'W', 'C', '2') /* pwc newer webcam */
    411 #define V4L2_PIX_FMT_ET61X251 v4l2_fourcc('E', '6', '2', '5') /* ET61X251 compression */
    412 #define V4L2_PIX_FMT_SPCA501  v4l2_fourcc('S', '5', '0', '1') /* YUYV per line */
    413 #define V4L2_PIX_FMT_SPCA505  v4l2_fourcc('S', '5', '0', '5') /* YYUV per line */
    414 #define V4L2_PIX_FMT_SPCA508  v4l2_fourcc('S', '5', '0', '8') /* YUVY per line */
    415 #define V4L2_PIX_FMT_SPCA561  v4l2_fourcc('S', '5', '6', '1') /* compressed GBRG bayer */
    416 #define V4L2_PIX_FMT_PAC207   v4l2_fourcc('P', '2', '0', '7') /* compressed BGGR bayer */
    417 #define V4L2_PIX_FMT_MR97310A v4l2_fourcc('M', '3', '1', '0') /* compressed BGGR bayer */
    418 #define V4L2_PIX_FMT_JL2005BCD v4l2_fourcc('J', 'L', '2', '0') /* compressed RGGB bayer */
    419 #define V4L2_PIX_FMT_SN9C2028 v4l2_fourcc('S', 'O', 'N', 'X') /* compressed GBRG bayer */
    420 #define V4L2_PIX_FMT_SQ905C   v4l2_fourcc('9', '0', '5', 'C') /* compressed RGGB bayer */
    421 #define V4L2_PIX_FMT_PJPG     v4l2_fourcc('P', 'J', 'P', 'G') /* Pixart 73xx JPEG */
    422 #define V4L2_PIX_FMT_OV511    v4l2_fourcc('O', '5', '1', '1') /* ov511 JPEG */
    423 #define V4L2_PIX_FMT_OV518    v4l2_fourcc('O', '5', '1', '8') /* ov518 JPEG */
    424 #define V4L2_PIX_FMT_STV0680  v4l2_fourcc('S', '6', '8', '0') /* stv0680 bayer */
    425 #define V4L2_PIX_FMT_TM6000   v4l2_fourcc('T', 'M', '6', '0') /* tm5600/tm60x0 */
    426 #define V4L2_PIX_FMT_CIT_YYVYUY v4l2_fourcc('C', 'I', 'T', 'V') /* one line of Y then 1 line of VYUY */
    427 #define V4L2_PIX_FMT_KONICA420  v4l2_fourcc('K', 'O', 'N', 'I') /* YUV420 planar in blocks of 256 pixels */
    428 #define V4L2_PIX_FMT_JPGL	v4l2_fourcc('J', 'P', 'G', 'L') /* JPEG-Lite */
    429 #define V4L2_PIX_FMT_SE401      v4l2_fourcc('S', '4', '0', '1') /* se401 janggu compressed rgb */
    430 
    431 /*
    432  *	F O R M A T   E N U M E R A T I O N
    433  */
    434 struct v4l2_fmtdesc {
    435 	__u32		    index;             /* Format number      */
    436 	enum v4l2_buf_type  type;              /* buffer type        */
    437 	__u32               flags;
    438 	__u8		    description[32];   /* Description string */
    439 	__u32		    pixelformat;       /* Format fourcc      */
    440 	__u32		    reserved[4];
    441 };
    442 
    443 #define V4L2_FMT_FLAG_COMPRESSED 0x0001
    444 #define V4L2_FMT_FLAG_EMULATED   0x0002
    445 
    446 #if 1
    447 	/* Experimental Frame Size and frame rate enumeration */
    448 /*
    449  *	F R A M E   S I Z E   E N U M E R A T I O N
    450  */
    451 enum v4l2_frmsizetypes {
    452 	V4L2_FRMSIZE_TYPE_DISCRETE	= 1,
    453 	V4L2_FRMSIZE_TYPE_CONTINUOUS	= 2,
    454 	V4L2_FRMSIZE_TYPE_STEPWISE	= 3,
    455 };
    456 
    457 struct v4l2_frmsize_discrete {
    458 	__u32			width;		/* Frame width [pixel] */
    459 	__u32			height;		/* Frame height [pixel] */
    460 };
    461 
    462 struct v4l2_frmsize_stepwise {
    463 	__u32			min_width;	/* Minimum frame width [pixel] */
    464 	__u32			max_width;	/* Maximum frame width [pixel] */
    465 	__u32			step_width;	/* Frame width step size [pixel] */
    466 	__u32			min_height;	/* Minimum frame height [pixel] */
    467 	__u32			max_height;	/* Maximum frame height [pixel] */
    468 	__u32			step_height;	/* Frame height step size [pixel] */
    469 };
    470 
    471 struct v4l2_frmsizeenum {
    472 	__u32			index;		/* Frame size number */
    473 	__u32			pixel_format;	/* Pixel format */
    474 	__u32			type;		/* Frame size type the device supports. */
    475 
    476 	union {					/* Frame size */
    477 		struct v4l2_frmsize_discrete	discrete;
    478 		struct v4l2_frmsize_stepwise	stepwise;
    479 	};
    480 
    481 	__u32   reserved[2];			/* Reserved space for future use */
    482 };
    483 
    484 /*
    485  *	F R A M E   R A T E   E N U M E R A T I O N
    486  */
    487 enum v4l2_frmivaltypes {
    488 	V4L2_FRMIVAL_TYPE_DISCRETE	= 1,
    489 	V4L2_FRMIVAL_TYPE_CONTINUOUS	= 2,
    490 	V4L2_FRMIVAL_TYPE_STEPWISE	= 3,
    491 };
    492 
    493 struct v4l2_frmival_stepwise {
    494 	struct v4l2_fract	min;		/* Minimum frame interval [s] */
    495 	struct v4l2_fract	max;		/* Maximum frame interval [s] */
    496 	struct v4l2_fract	step;		/* Frame interval step size [s] */
    497 };
    498 
    499 struct v4l2_frmivalenum {
    500 	__u32			index;		/* Frame format index */
    501 	__u32			pixel_format;	/* Pixel format */
    502 	__u32			width;		/* Frame width */
    503 	__u32			height;		/* Frame height */
    504 	__u32			type;		/* Frame interval type the device supports. */
    505 
    506 	union {					/* Frame interval */
    507 		struct v4l2_fract		discrete;
    508 		struct v4l2_frmival_stepwise	stepwise;
    509 	};
    510 
    511 	__u32	reserved[2];			/* Reserved space for future use */
    512 };
    513 #endif
    514 
    515 /*
    516  *	T I M E C O D E
    517  */
    518 struct v4l2_timecode {
    519 	__u32	type;
    520 	__u32	flags;
    521 	__u8	frames;
    522 	__u8	seconds;
    523 	__u8	minutes;
    524 	__u8	hours;
    525 	__u8	userbits[4];
    526 };
    527 
    528 /*  Type  */
    529 #define V4L2_TC_TYPE_24FPS		1
    530 #define V4L2_TC_TYPE_25FPS		2
    531 #define V4L2_TC_TYPE_30FPS		3
    532 #define V4L2_TC_TYPE_50FPS		4
    533 #define V4L2_TC_TYPE_60FPS		5
    534 
    535 /*  Flags  */
    536 #define V4L2_TC_FLAG_DROPFRAME		0x0001 /* "drop-frame" mode */
    537 #define V4L2_TC_FLAG_COLORFRAME		0x0002
    538 #define V4L2_TC_USERBITS_field		0x000C
    539 #define V4L2_TC_USERBITS_USERDEFINED	0x0000
    540 #define V4L2_TC_USERBITS_8BITCHARS	0x0008
    541 /* The above is based on SMPTE timecodes */
    542 
    543 struct v4l2_jpegcompression {
    544 	int quality;
    545 
    546 	int  APPn;              /* Number of APP segment to be written,
    547 				 * must be 0..15 */
    548 	int  APP_len;           /* Length of data in JPEG APPn segment */
    549 	char APP_data[60];      /* Data in the JPEG APPn segment. */
    550 
    551 	int  COM_len;           /* Length of data in JPEG COM segment */
    552 	char COM_data[60];      /* Data in JPEG COM segment */
    553 
    554 	__u32 jpeg_markers;     /* Which markers should go into the JPEG
    555 				 * output. Unless you exactly know what
    556 				 * you do, leave them untouched.
    557 				 * Inluding less markers will make the
    558 				 * resulting code smaller, but there will
    559 				 * be fewer applications which can read it.
    560 				 * The presence of the APP and COM marker
    561 				 * is influenced by APP_len and COM_len
    562 				 * ONLY, not by this property! */
    563 
    564 #define V4L2_JPEG_MARKER_DHT (1<<3)    /* Define Huffman Tables */
    565 #define V4L2_JPEG_MARKER_DQT (1<<4)    /* Define Quantization Tables */
    566 #define V4L2_JPEG_MARKER_DRI (1<<5)    /* Define Restart Interval */
    567 #define V4L2_JPEG_MARKER_COM (1<<6)    /* Comment segment */
    568 #define V4L2_JPEG_MARKER_APP (1<<7)    /* App segment, driver will
    569 					* allways use APP0 */
    570 };
    571 
    572 /*
    573  *	M E M O R Y - M A P P I N G   B U F F E R S
    574  */
    575 struct v4l2_requestbuffers {
    576 	__u32			count;
    577 	enum v4l2_buf_type      type;
    578 	enum v4l2_memory        memory;
    579 	__u32			reserved[2];
    580 };
    581 
    582 /**
    583  * struct v4l2_plane - plane info for multi-planar buffers
    584  * @bytesused:		number of bytes occupied by data in the plane (payload)
    585  * @length:		size of this plane (NOT the payload) in bytes
    586  * @mem_offset:		when memory in the associated struct v4l2_buffer is
    587  *			V4L2_MEMORY_MMAP, equals the offset from the start of
    588  *			the device memory for this plane (or is a "cookie" that
    589  *			should be passed to mmap() called on the video node)
    590  * @userptr:		when memory is V4L2_MEMORY_USERPTR, a userspace pointer
    591  *			pointing to this plane
    592  * @fd:			when memory is V4L2_MEMORY_DMABUF, a userspace file
    593  *			descriptor associated with this plane
    594  * @data_offset:	offset in the plane to the start of data; usually 0,
    595  *			unless there is a header in front of the data
    596  *
    597  * Multi-planar buffers consist of one or more planes, e.g. an YCbCr buffer
    598  * with two planes can have one plane for Y, and another for interleaved CbCr
    599  * components. Each plane can reside in a separate memory buffer, or even in
    600  * a completely separate memory node (e.g. in embedded devices).
    601  */
    602 struct v4l2_plane {
    603 	__u32			bytesused;
    604 	__u32			length;
    605 	union {
    606 		__u32		mem_offset;
    607 		unsigned long	userptr;
    608 		int		fd;
    609 	} m;
    610 	__u32			data_offset;
    611 	__u32			reserved[11];
    612 };
    613 
    614 /**
    615  * struct v4l2_buffer - video buffer info
    616  * @index:	id number of the buffer
    617  * @type:	buffer type (type == *_MPLANE for multiplanar buffers)
    618  * @bytesused:	number of bytes occupied by data in the buffer (payload);
    619  *		unused (set to 0) for multiplanar buffers
    620  * @flags:	buffer informational flags
    621  * @field:	field order of the image in the buffer
    622  * @timestamp:	frame timestamp
    623  * @timecode:	frame timecode
    624  * @sequence:	sequence count of this frame
    625  * @memory:	the method, in which the actual video data is passed
    626  * @offset:	for non-multiplanar buffers with memory == V4L2_MEMORY_MMAP;
    627  *		offset from the start of the device memory for this plane,
    628  *		(or a "cookie" that should be passed to mmap() as offset)
    629  * @userptr:	for non-multiplanar buffers with memory == V4L2_MEMORY_USERPTR;
    630  *		a userspace pointer pointing to this buffer
    631  * @fd:		for non-multiplanar buffers with memory == V4L2_MEMORY_DMABUF;
    632  *		a userspace file descriptor associated with this buffer
    633  * @planes:	for multiplanar buffers; userspace pointer to the array of plane
    634  *		info structs for this buffer
    635  * @length:	size in bytes of the buffer (NOT its payload) for single-plane
    636  *		buffers (when type != *_MPLANE); number of elements in the
    637  *		planes array for multi-plane buffers
    638  * @input:	input number from which the video data has has been captured
    639  *
    640  * Contains data exchanged by application and driver using one of the Streaming
    641  * I/O methods.
    642  */
    643 struct v4l2_buffer {
    644 	__u32			index;
    645 	enum v4l2_buf_type      type;
    646 	__u32			bytesused;
    647 	__u32			flags;
    648 	enum v4l2_field		field;
    649 	struct timeval		timestamp;
    650 	struct v4l2_timecode	timecode;
    651 	__u32			sequence;
    652 
    653 	/* memory location */
    654 	enum v4l2_memory        memory;
    655 	union {
    656 		__u32           offset;
    657 		unsigned long   userptr;
    658 		struct v4l2_plane *planes;
    659 		int		fd;
    660 	} m;
    661 	__u32			length;
    662 	__u32			input;
    663 	__u32			reserved;
    664 };
    665 
    666 /*  Flags for 'flags' field */
    667 #define V4L2_BUF_FLAG_MAPPED	0x0001  /* Buffer is mapped (flag) */
    668 #define V4L2_BUF_FLAG_QUEUED	0x0002	/* Buffer is queued for processing */
    669 #define V4L2_BUF_FLAG_DONE	0x0004	/* Buffer is ready */
    670 #define V4L2_BUF_FLAG_KEYFRAME	0x0008	/* Image is a keyframe (I-frame) */
    671 #define V4L2_BUF_FLAG_PFRAME	0x0010	/* Image is a P-frame */
    672 #define V4L2_BUF_FLAG_BFRAME	0x0020	/* Image is a B-frame */
    673 /* Buffer is ready, but the data contained within is corrupted. */
    674 #define V4L2_BUF_FLAG_ERROR	0x0040
    675 #define V4L2_BUF_FLAG_TIMECODE	0x0100	/* timecode field is valid */
    676 #define V4L2_BUF_FLAG_INPUT     0x0200  /* input field is valid */
    677 #define V4L2_BUF_FLAG_PREPARED	0x0400	/* Buffer is prepared for queuing */
    678 /* Cache handling flags */
    679 #define V4L2_BUF_FLAG_NO_CACHE_INVALIDATE	0x0800
    680 #define V4L2_BUF_FLAG_NO_CACHE_CLEAN		0x1000
    681 /* Expects and returns a sync fence */
    682 #define V4L2_BUF_FLAG_USE_SYNC	0x2000
    683 /* Buffer is end of stream */
    684 #define V4L2_BUF_FLAG_LAST_FRAME	0x4000
    685 
    686 /*
    687  *	O V E R L A Y   P R E V I E W
    688  */
    689 struct v4l2_framebuffer {
    690 	__u32			capability;
    691 	__u32			flags;
    692 /* FIXME: in theory we should pass something like PCI device + memory
    693  * region + offset instead of some physical address */
    694 	void                    *base;
    695 	struct v4l2_pix_format	fmt;
    696 };
    697 /*  Flags for the 'capability' field. Read only */
    698 #define V4L2_FBUF_CAP_EXTERNOVERLAY	0x0001
    699 #define V4L2_FBUF_CAP_CHROMAKEY		0x0002
    700 #define V4L2_FBUF_CAP_LIST_CLIPPING     0x0004
    701 #define V4L2_FBUF_CAP_BITMAP_CLIPPING	0x0008
    702 #define V4L2_FBUF_CAP_LOCAL_ALPHA	0x0010
    703 #define V4L2_FBUF_CAP_GLOBAL_ALPHA	0x0020
    704 #define V4L2_FBUF_CAP_LOCAL_INV_ALPHA	0x0040
    705 #define V4L2_FBUF_CAP_SRC_CHROMAKEY	0x0080
    706 /*  Flags for the 'flags' field. */
    707 #define V4L2_FBUF_FLAG_PRIMARY		0x0001
    708 #define V4L2_FBUF_FLAG_OVERLAY		0x0002
    709 #define V4L2_FBUF_FLAG_CHROMAKEY	0x0004
    710 #define V4L2_FBUF_FLAG_LOCAL_ALPHA	0x0008
    711 #define V4L2_FBUF_FLAG_GLOBAL_ALPHA	0x0010
    712 #define V4L2_FBUF_FLAG_LOCAL_INV_ALPHA	0x0020
    713 #define V4L2_FBUF_FLAG_SRC_CHROMAKEY	0x0040
    714 
    715 struct v4l2_clip {
    716 	struct v4l2_rect        c;
    717 	struct v4l2_clip	__user *next;
    718 };
    719 
    720 struct v4l2_window {
    721 	struct v4l2_rect        w;
    722 	enum v4l2_field  	field;
    723 	__u32			chromakey;
    724 	struct v4l2_clip	__user *clips;
    725 	__u32			clipcount;
    726 	void			__user *bitmap;
    727 	__u8                    global_alpha;
    728 };
    729 
    730 /*
    731  *	C A P T U R E   P A R A M E T E R S
    732  */
    733 struct v4l2_captureparm {
    734 	__u32		   capability;	  /*  Supported modes */
    735 	__u32		   capturemode;	  /*  Current mode */
    736 	struct v4l2_fract  timeperframe;  /*  Time per frame in .1us units */
    737 	__u32		   extendedmode;  /*  Driver-specific extensions */
    738 	__u32              readbuffers;   /*  # of buffers for read */
    739 	__u32		   reserved[4];
    740 };
    741 
    742 /*  Flags for 'capability' and 'capturemode' fields */
    743 #define V4L2_MODE_HIGHQUALITY	0x0001	/*  High quality imaging mode */
    744 #define V4L2_CAP_TIMEPERFRAME	0x1000	/*  timeperframe field is supported */
    745 
    746 struct v4l2_outputparm {
    747 	__u32		   capability;	 /*  Supported modes */
    748 	__u32		   outputmode;	 /*  Current mode */
    749 	struct v4l2_fract  timeperframe; /*  Time per frame in seconds */
    750 	__u32		   extendedmode; /*  Driver-specific extensions */
    751 	__u32              writebuffers; /*  # of buffers for write */
    752 	__u32		   reserved[4];
    753 };
    754 
    755 /*
    756  *	I N P U T   I M A G E   C R O P P I N G
    757  */
    758 struct v4l2_cropcap {
    759 	enum v4l2_buf_type      type;
    760 	struct v4l2_rect        bounds;
    761 	struct v4l2_rect        defrect;
    762 	struct v4l2_fract       pixelaspect;
    763 };
    764 
    765 struct v4l2_crop {
    766 	enum v4l2_buf_type      type;
    767 	struct v4l2_rect        c;
    768 };
    769 
    770 /* Hints for adjustments of selection rectangle */
    771 #define V4L2_SEL_FLAG_GE	0x00000001
    772 #define V4L2_SEL_FLAG_LE	0x00000002
    773 
    774 /* Selection targets */
    775 
    776 /* Current cropping area */
    777 #define V4L2_SEL_TGT_CROP_ACTIVE	0x0000
    778 /* Default cropping area */
    779 #define V4L2_SEL_TGT_CROP_DEFAULT	0x0001
    780 /* Cropping bounds */
    781 #define V4L2_SEL_TGT_CROP_BOUNDS	0x0002
    782 /* Current composing area */
    783 #define V4L2_SEL_TGT_COMPOSE_ACTIVE	0x0100
    784 /* Default composing area */
    785 #define V4L2_SEL_TGT_COMPOSE_DEFAULT	0x0101
    786 /* Composing bounds */
    787 #define V4L2_SEL_TGT_COMPOSE_BOUNDS	0x0102
    788 /* Current composing area plus all padding pixels */
    789 #define V4L2_SEL_TGT_COMPOSE_PADDED	0x0103
    790 
    791 /**
    792  * struct v4l2_selection - selection info
    793  * @type:	buffer type (do not use *_MPLANE types)
    794  * @target:	selection target, used to choose one of possible rectangles
    795  * @flags:	constraints flags
    796  * @r:		coordinates of selection window
    797  * @reserved:	for future use, rounds structure size to 64 bytes, set to zero
    798  *
    799  * Hardware may use multiple helper windows to process a video stream.
    800  * The structure is used to exchange this selection areas between
    801  * an application and a driver.
    802  */
    803 struct v4l2_selection {
    804 	__u32			type;
    805 	__u32			target;
    806 	__u32                   flags;
    807 	struct v4l2_rect        r;
    808 	__u32                   reserved[9];
    809 };
    810 
    811 
    812 /*
    813  *      A N A L O G   V I D E O   S T A N D A R D
    814  */
    815 
    816 typedef __u64 v4l2_std_id;
    817 
    818 /* one bit for each */
    819 #define V4L2_STD_PAL_B          ((v4l2_std_id)0x00000001)
    820 #define V4L2_STD_PAL_B1         ((v4l2_std_id)0x00000002)
    821 #define V4L2_STD_PAL_G          ((v4l2_std_id)0x00000004)
    822 #define V4L2_STD_PAL_H          ((v4l2_std_id)0x00000008)
    823 #define V4L2_STD_PAL_I          ((v4l2_std_id)0x00000010)
    824 #define V4L2_STD_PAL_D          ((v4l2_std_id)0x00000020)
    825 #define V4L2_STD_PAL_D1         ((v4l2_std_id)0x00000040)
    826 #define V4L2_STD_PAL_K          ((v4l2_std_id)0x00000080)
    827 
    828 #define V4L2_STD_PAL_M          ((v4l2_std_id)0x00000100)
    829 #define V4L2_STD_PAL_N          ((v4l2_std_id)0x00000200)
    830 #define V4L2_STD_PAL_Nc         ((v4l2_std_id)0x00000400)
    831 #define V4L2_STD_PAL_60         ((v4l2_std_id)0x00000800)
    832 
    833 #define V4L2_STD_NTSC_M         ((v4l2_std_id)0x00001000)	/* BTSC */
    834 #define V4L2_STD_NTSC_M_JP      ((v4l2_std_id)0x00002000)	/* EIA-J */
    835 #define V4L2_STD_NTSC_443       ((v4l2_std_id)0x00004000)
    836 #define V4L2_STD_NTSC_M_KR      ((v4l2_std_id)0x00008000)	/* FM A2 */
    837 
    838 #define V4L2_STD_SECAM_B        ((v4l2_std_id)0x00010000)
    839 #define V4L2_STD_SECAM_D        ((v4l2_std_id)0x00020000)
    840 #define V4L2_STD_SECAM_G        ((v4l2_std_id)0x00040000)
    841 #define V4L2_STD_SECAM_H        ((v4l2_std_id)0x00080000)
    842 #define V4L2_STD_SECAM_K        ((v4l2_std_id)0x00100000)
    843 #define V4L2_STD_SECAM_K1       ((v4l2_std_id)0x00200000)
    844 #define V4L2_STD_SECAM_L        ((v4l2_std_id)0x00400000)
    845 #define V4L2_STD_SECAM_LC       ((v4l2_std_id)0x00800000)
    846 
    847 /* ATSC/HDTV */
    848 #define V4L2_STD_ATSC_8_VSB     ((v4l2_std_id)0x01000000)
    849 #define V4L2_STD_ATSC_16_VSB    ((v4l2_std_id)0x02000000)
    850 
    851 /* FIXME:
    852    Although std_id is 64 bits, there is an issue on PPC32 architecture that
    853    makes switch(__u64) to break. So, there's a hack on v4l2-common.c rounding
    854    this value to 32 bits.
    855    As, currently, the max value is for V4L2_STD_ATSC_16_VSB (30 bits wide),
    856    it should work fine. However, if needed to add more than two standards,
    857    v4l2-common.c should be fixed.
    858  */
    859 
    860 /*
    861  * Some macros to merge video standards in order to make live easier for the
    862  * drivers and V4L2 applications
    863  */
    864 
    865 /*
    866  * "Common" NTSC/M - It should be noticed that V4L2_STD_NTSC_443 is
    867  * Missing here.
    868  */
    869 #define V4L2_STD_NTSC           (V4L2_STD_NTSC_M	|\
    870 				 V4L2_STD_NTSC_M_JP     |\
    871 				 V4L2_STD_NTSC_M_KR)
    872 /* Secam macros */
    873 #define V4L2_STD_SECAM_DK      	(V4L2_STD_SECAM_D	|\
    874 				 V4L2_STD_SECAM_K	|\
    875 				 V4L2_STD_SECAM_K1)
    876 /* All Secam Standards */
    877 #define V4L2_STD_SECAM		(V4L2_STD_SECAM_B	|\
    878 				 V4L2_STD_SECAM_G	|\
    879 				 V4L2_STD_SECAM_H	|\
    880 				 V4L2_STD_SECAM_DK	|\
    881 				 V4L2_STD_SECAM_L       |\
    882 				 V4L2_STD_SECAM_LC)
    883 /* PAL macros */
    884 #define V4L2_STD_PAL_BG		(V4L2_STD_PAL_B		|\
    885 				 V4L2_STD_PAL_B1	|\
    886 				 V4L2_STD_PAL_G)
    887 #define V4L2_STD_PAL_DK		(V4L2_STD_PAL_D		|\
    888 				 V4L2_STD_PAL_D1	|\
    889 				 V4L2_STD_PAL_K)
    890 /*
    891  * "Common" PAL - This macro is there to be compatible with the old
    892  * V4L1 concept of "PAL": /BGDKHI.
    893  * Several PAL standards are mising here: /M, /N and /Nc
    894  */
    895 #define V4L2_STD_PAL		(V4L2_STD_PAL_BG	|\
    896 				 V4L2_STD_PAL_DK	|\
    897 				 V4L2_STD_PAL_H		|\
    898 				 V4L2_STD_PAL_I)
    899 /* Chroma "agnostic" standards */
    900 #define V4L2_STD_B		(V4L2_STD_PAL_B		|\
    901 				 V4L2_STD_PAL_B1	|\
    902 				 V4L2_STD_SECAM_B)
    903 #define V4L2_STD_G		(V4L2_STD_PAL_G		|\
    904 				 V4L2_STD_SECAM_G)
    905 #define V4L2_STD_H		(V4L2_STD_PAL_H		|\
    906 				 V4L2_STD_SECAM_H)
    907 #define V4L2_STD_L		(V4L2_STD_SECAM_L	|\
    908 				 V4L2_STD_SECAM_LC)
    909 #define V4L2_STD_GH		(V4L2_STD_G		|\
    910 				 V4L2_STD_H)
    911 #define V4L2_STD_DK		(V4L2_STD_PAL_DK	|\
    912 				 V4L2_STD_SECAM_DK)
    913 #define V4L2_STD_BG		(V4L2_STD_B		|\
    914 				 V4L2_STD_G)
    915 #define V4L2_STD_MN		(V4L2_STD_PAL_M		|\
    916 				 V4L2_STD_PAL_N		|\
    917 				 V4L2_STD_PAL_Nc	|\
    918 				 V4L2_STD_NTSC)
    919 
    920 /* Standards where MTS/BTSC stereo could be found */
    921 #define V4L2_STD_MTS		(V4L2_STD_NTSC_M	|\
    922 				 V4L2_STD_PAL_M		|\
    923 				 V4L2_STD_PAL_N		|\
    924 				 V4L2_STD_PAL_Nc)
    925 
    926 /* Standards for Countries with 60Hz Line frequency */
    927 #define V4L2_STD_525_60		(V4L2_STD_PAL_M		|\
    928 				 V4L2_STD_PAL_60	|\
    929 				 V4L2_STD_NTSC		|\
    930 				 V4L2_STD_NTSC_443)
    931 /* Standards for Countries with 50Hz Line frequency */
    932 #define V4L2_STD_625_50		(V4L2_STD_PAL		|\
    933 				 V4L2_STD_PAL_N		|\
    934 				 V4L2_STD_PAL_Nc	|\
    935 				 V4L2_STD_SECAM)
    936 
    937 #define V4L2_STD_ATSC           (V4L2_STD_ATSC_8_VSB    |\
    938 				 V4L2_STD_ATSC_16_VSB)
    939 /* Macros with none and all analog standards */
    940 #define V4L2_STD_UNKNOWN        0
    941 #define V4L2_STD_ALL            (V4L2_STD_525_60	|\
    942 				 V4L2_STD_625_50)
    943 
    944 struct v4l2_standard {
    945 	__u32		     index;
    946 	v4l2_std_id          id;
    947 	__u8		     name[24];
    948 	struct v4l2_fract    frameperiod; /* Frames, not fields */
    949 	__u32		     framelines;
    950 	__u32		     reserved[4];
    951 };
    952 
    953 /*
    954  *	V I D E O	T I M I N G S	D V	P R E S E T
    955  */
    956 struct v4l2_dv_preset {
    957 	__u32	preset;
    958 	__u32	reserved[4];
    959 };
    960 
    961 /*
    962  *	D V	P R E S E T S	E N U M E R A T I O N
    963  */
    964 struct v4l2_dv_enum_preset {
    965 	__u32	index;
    966 	__u32	preset;
    967 	__u8	name[32]; /* Name of the preset timing */
    968 	__u32	width;
    969 	__u32	height;
    970 	__u32	reserved[4];
    971 };
    972 
    973 /*
    974  * 	D V	P R E S E T	V A L U E S
    975  */
    976 #define		V4L2_DV_INVALID		0
    977 #define		V4L2_DV_480P59_94	1 /* BT.1362 */
    978 #define		V4L2_DV_576P50		2 /* BT.1362 */
    979 #define		V4L2_DV_720P24		3 /* SMPTE 296M */
    980 #define		V4L2_DV_720P25		4 /* SMPTE 296M */
    981 #define		V4L2_DV_720P30		5 /* SMPTE 296M */
    982 #define		V4L2_DV_720P50		6 /* SMPTE 296M */
    983 #define		V4L2_DV_720P59_94	7 /* SMPTE 274M */
    984 #define		V4L2_DV_720P60		8 /* SMPTE 274M/296M */
    985 #define		V4L2_DV_1080I29_97	9 /* BT.1120/ SMPTE 274M */
    986 #define		V4L2_DV_1080I30		10 /* BT.1120/ SMPTE 274M */
    987 #define		V4L2_DV_1080I25		11 /* BT.1120 */
    988 #define		V4L2_DV_1080I50		12 /* SMPTE 296M */
    989 #define		V4L2_DV_1080I60		13 /* SMPTE 296M */
    990 #define		V4L2_DV_1080P24		14 /* SMPTE 296M */
    991 #define		V4L2_DV_1080P25		15 /* SMPTE 296M */
    992 #define		V4L2_DV_1080P30		16 /* SMPTE 296M */
    993 #define		V4L2_DV_1080P50		17 /* BT.1120 */
    994 #define		V4L2_DV_1080P60		18 /* BT.1120 */
    995 
    996 #define		V4L2_DV_480P60			19
    997 #define		V4L2_DV_1080I59_94		20
    998 #define		V4L2_DV_1080P59_94		21
    999 
   1000 #define		V4L2_DV_720P60_FP		22
   1001 #define		V4L2_DV_720P60_SB_HALF		23
   1002 #define		V4L2_DV_720P60_TB		24
   1003 #define		V4L2_DV_720P59_94_FP		25
   1004 #define		V4L2_DV_720P59_94_SB_HALF	26
   1005 #define		V4L2_DV_720P59_94_TB		27
   1006 #define		V4L2_DV_720P50_FP		28
   1007 #define		V4L2_DV_720P50_SB_HALF		29
   1008 #define		V4L2_DV_720P50_TB		30
   1009 #define		V4L2_DV_1080P24_FP		31
   1010 #define		V4L2_DV_1080P24_SB_HALF		32
   1011 #define		V4L2_DV_1080P24_TB		33
   1012 #define		V4L2_DV_1080P23_98_FP		34
   1013 #define		V4L2_DV_1080P23_98_SB_HALF	35
   1014 #define		V4L2_DV_1080P23_98_TB		36
   1015 #define		V4L2_DV_1080I60_SB_HALF		37
   1016 #define		V4L2_DV_1080I59_94_SB_HALF	38
   1017 #define		V4L2_DV_1080I50_SB_HALF		39
   1018 #define		V4L2_DV_1080P60_SB_HALF		40
   1019 #define		V4L2_DV_1080P60_TB		41
   1020 #define		V4L2_DV_1080P30_FP		42
   1021 #define		V4L2_DV_1080P30_SB_HALF		43
   1022 #define		V4L2_DV_1080P30_TB		44
   1023 
   1024 /*
   1025  *	D V 	B T	T I M I N G S
   1026  */
   1027 
   1028 /* BT.656/BT.1120 timing data */
   1029 struct v4l2_bt_timings {
   1030 	__u32	width;		/* width in pixels */
   1031 	__u32	height;		/* height in lines */
   1032 	__u32	interlaced;	/* Interlaced or progressive */
   1033 	__u32	polarities;	/* Positive or negative polarity */
   1034 	__u64	pixelclock;	/* Pixel clock in HZ. Ex. 74.25MHz->74250000 */
   1035 	__u32	hfrontporch;	/* Horizpontal front porch in pixels */
   1036 	__u32	hsync;		/* Horizontal Sync length in pixels */
   1037 	__u32	hbackporch;	/* Horizontal back porch in pixels */
   1038 	__u32	vfrontporch;	/* Vertical front porch in pixels */
   1039 	__u32	vsync;		/* Vertical Sync length in lines */
   1040 	__u32	vbackporch;	/* Vertical back porch in lines */
   1041 	__u32	il_vfrontporch;	/* Vertical front porch for bottom field of
   1042 				 * interlaced field formats
   1043 				 */
   1044 	__u32	il_vsync;	/* Vertical sync length for bottom field of
   1045 				 * interlaced field formats
   1046 				 */
   1047 	__u32	il_vbackporch;	/* Vertical back porch for bottom field of
   1048 				 * interlaced field formats
   1049 				 */
   1050 	__u32	reserved[16];
   1051 } __attribute__ ((packed));
   1052 
   1053 /* Interlaced or progressive format */
   1054 #define	V4L2_DV_PROGRESSIVE	0
   1055 #define	V4L2_DV_INTERLACED	1
   1056 
   1057 /* Polarities. If bit is not set, it is assumed to be negative polarity */
   1058 #define V4L2_DV_VSYNC_POS_POL	0x00000001
   1059 #define V4L2_DV_HSYNC_POS_POL	0x00000002
   1060 
   1061 
   1062 /* DV timings */
   1063 struct v4l2_dv_timings {
   1064 	__u32 type;
   1065 	union {
   1066 		struct v4l2_bt_timings	bt;
   1067 		__u32	reserved[32];
   1068 	};
   1069 } __attribute__ ((packed));
   1070 
   1071 /* Values for the type field */
   1072 #define V4L2_DV_BT_656_1120	0	/* BT.656/1120 timing type */
   1073 
   1074 /*
   1075  *	V I D E O   I N P U T S
   1076  */
   1077 struct v4l2_input {
   1078 	__u32	     index;		/*  Which input */
   1079 	__u8	     name[32];		/*  Label */
   1080 	__u32	     type;		/*  Type of input */
   1081 	__u32	     audioset;		/*  Associated audios (bitfield) */
   1082 	__u32        tuner;             /*  Associated tuner */
   1083 	v4l2_std_id  std;
   1084 	__u32	     status;
   1085 	__u32	     capabilities;
   1086 	__u32	     reserved[3];
   1087 };
   1088 
   1089 /*  Values for the 'type' field */
   1090 #define V4L2_INPUT_TYPE_TUNER		1
   1091 #define V4L2_INPUT_TYPE_CAMERA		2
   1092 
   1093 /* field 'status' - general */
   1094 #define V4L2_IN_ST_NO_POWER    0x00000001  /* Attached device is off */
   1095 #define V4L2_IN_ST_NO_SIGNAL   0x00000002
   1096 #define V4L2_IN_ST_NO_COLOR    0x00000004
   1097 
   1098 /* field 'status' - sensor orientation */
   1099 /* If sensor is mounted upside down set both bits */
   1100 #define V4L2_IN_ST_HFLIP       0x00000010 /* Frames are flipped horizontally */
   1101 #define V4L2_IN_ST_VFLIP       0x00000020 /* Frames are flipped vertically */
   1102 
   1103 /* field 'status' - analog */
   1104 #define V4L2_IN_ST_NO_H_LOCK   0x00000100  /* No horizontal sync lock */
   1105 #define V4L2_IN_ST_COLOR_KILL  0x00000200  /* Color killer is active */
   1106 
   1107 /* field 'status' - digital */
   1108 #define V4L2_IN_ST_NO_SYNC     0x00010000  /* No synchronization lock */
   1109 #define V4L2_IN_ST_NO_EQU      0x00020000  /* No equalizer lock */
   1110 #define V4L2_IN_ST_NO_CARRIER  0x00040000  /* Carrier recovery failed */
   1111 
   1112 /* field 'status' - VCR and set-top box */
   1113 #define V4L2_IN_ST_MACROVISION 0x01000000  /* Macrovision detected */
   1114 #define V4L2_IN_ST_NO_ACCESS   0x02000000  /* Conditional access denied */
   1115 #define V4L2_IN_ST_VTR         0x04000000  /* VTR time constant */
   1116 
   1117 /* capabilities flags */
   1118 #define V4L2_IN_CAP_PRESETS		0x00000001 /* Supports S_DV_PRESET */
   1119 #define V4L2_IN_CAP_CUSTOM_TIMINGS	0x00000002 /* Supports S_DV_TIMINGS */
   1120 #define V4L2_IN_CAP_STD			0x00000004 /* Supports S_STD */
   1121 
   1122 /*
   1123  *	V I D E O   O U T P U T S
   1124  */
   1125 struct v4l2_output {
   1126 	__u32	     index;		/*  Which output */
   1127 	__u8	     name[32];		/*  Label */
   1128 	__u32	     type;		/*  Type of output */
   1129 	__u32	     audioset;		/*  Associated audios (bitfield) */
   1130 	__u32	     modulator;         /*  Associated modulator */
   1131 	v4l2_std_id  std;
   1132 	__u32	     capabilities;
   1133 	__u32	     reserved[3];
   1134 };
   1135 /*  Values for the 'type' field */
   1136 #define V4L2_OUTPUT_TYPE_MODULATOR		1
   1137 #define V4L2_OUTPUT_TYPE_ANALOG			2
   1138 #define V4L2_OUTPUT_TYPE_ANALOGVGAOVERLAY	3
   1139 
   1140 /* capabilities flags */
   1141 #define V4L2_OUT_CAP_PRESETS		0x00000001 /* Supports S_DV_PRESET */
   1142 #define V4L2_OUT_CAP_CUSTOM_TIMINGS	0x00000002 /* Supports S_DV_TIMINGS */
   1143 #define V4L2_OUT_CAP_STD		0x00000004 /* Supports S_STD */
   1144 
   1145 /*
   1146  *	C O N T R O L S
   1147  */
   1148 struct v4l2_control {
   1149 	__u32		     id;
   1150 	__s32		     value;
   1151 };
   1152 
   1153 struct v4l2_ext_control {
   1154 	__u32 id;
   1155 	__u32 size;
   1156 	__u32 reserved2[1];
   1157 	union {
   1158 		__s32 value;
   1159 		__s64 value64;
   1160 		char *string;
   1161 	};
   1162 } __attribute__ ((packed));
   1163 
   1164 struct v4l2_ext_controls {
   1165 	__u32 ctrl_class;
   1166 	__u32 count;
   1167 	__u32 error_idx;
   1168 	__u32 reserved[2];
   1169 	struct v4l2_ext_control *controls;
   1170 };
   1171 
   1172 /*  Values for ctrl_class field */
   1173 #define V4L2_CTRL_CLASS_USER 0x00980000	/* Old-style 'user' controls */
   1174 #define V4L2_CTRL_CLASS_MPEG 0x00990000	/* MPEG-compression controls */
   1175 #define V4L2_CTRL_CLASS_CAMERA 0x009a0000	/* Camera class controls */
   1176 #define V4L2_CTRL_CLASS_FM_TX 0x009b0000	/* FM Modulator control class */
   1177 #define V4L2_CTRL_CLASS_FLASH 0x009c0000	/* Camera flash controls */
   1178 #define V4L2_CTRL_CLASS_JPEG 0x009d0000		/* JPEG-compression controls */
   1179 #define V4L2_CTRL_CLASS_CODEC 0x009e0000	/* Codec control class */
   1180 
   1181 #define V4L2_CTRL_ID_MASK      	  (0x0fffffff)
   1182 #define V4L2_CTRL_ID2CLASS(id)    ((id) & 0x0fff0000UL)
   1183 #define V4L2_CTRL_DRIVER_PRIV(id) (((id) & 0xffff) >= 0x1000)
   1184 
   1185 enum v4l2_ctrl_type {
   1186 	V4L2_CTRL_TYPE_INTEGER	     = 1,
   1187 	V4L2_CTRL_TYPE_BOOLEAN	     = 2,
   1188 	V4L2_CTRL_TYPE_MENU	     = 3,
   1189 	V4L2_CTRL_TYPE_BUTTON	     = 4,
   1190 	V4L2_CTRL_TYPE_INTEGER64     = 5,
   1191 	V4L2_CTRL_TYPE_CTRL_CLASS    = 6,
   1192 	V4L2_CTRL_TYPE_STRING        = 7,
   1193 	V4L2_CTRL_TYPE_BITMASK       = 8,
   1194 };
   1195 
   1196 /*  Used in the VIDIOC_QUERYCTRL ioctl for querying controls */
   1197 struct v4l2_queryctrl {
   1198 	__u32		     id;
   1199 	enum v4l2_ctrl_type  type;
   1200 	__u8		     name[32];	/* Whatever */
   1201 	__s32		     minimum;	/* Note signedness */
   1202 	__s32		     maximum;
   1203 	__s32		     step;
   1204 	__s32		     default_value;
   1205 	__u32                flags;
   1206 	__u32		     reserved[2];
   1207 };
   1208 
   1209 /*  Used in the VIDIOC_QUERYMENU ioctl for querying menu items */
   1210 struct v4l2_querymenu {
   1211 	__u32		id;
   1212 	__u32		index;
   1213 	__u8		name[32];	/* Whatever */
   1214 	__u32		reserved;
   1215 };
   1216 
   1217 /*  Control flags  */
   1218 #define V4L2_CTRL_FLAG_DISABLED		0x0001
   1219 #define V4L2_CTRL_FLAG_GRABBED		0x0002
   1220 #define V4L2_CTRL_FLAG_READ_ONLY 	0x0004
   1221 #define V4L2_CTRL_FLAG_UPDATE 		0x0008
   1222 #define V4L2_CTRL_FLAG_INACTIVE 	0x0010
   1223 #define V4L2_CTRL_FLAG_SLIDER 		0x0020
   1224 #define V4L2_CTRL_FLAG_WRITE_ONLY 	0x0040
   1225 #define V4L2_CTRL_FLAG_VOLATILE		0x0080
   1226 
   1227 /*  Query flag, to be ORed with the control ID */
   1228 #define V4L2_CTRL_FLAG_NEXT_CTRL	0x80000000
   1229 
   1230 /*  User-class control IDs defined by V4L2 */
   1231 #define V4L2_CID_MAX_CTRLS		1024
   1232 #define V4L2_CID_BASE			(V4L2_CTRL_CLASS_USER | 0x900)
   1233 #define V4L2_CID_USER_BASE 		V4L2_CID_BASE
   1234 /*  IDs reserved for driver specific controls */
   1235 #define V4L2_CID_PRIVATE_BASE		0x08000000
   1236 
   1237 #define V4L2_CID_USER_CLASS 		(V4L2_CTRL_CLASS_USER | 1)
   1238 #define V4L2_CID_BRIGHTNESS		(V4L2_CID_BASE+0)
   1239 #define V4L2_CID_CONTRAST		(V4L2_CID_BASE+1)
   1240 #define V4L2_CID_SATURATION		(V4L2_CID_BASE+2)
   1241 #define V4L2_CID_HUE			(V4L2_CID_BASE+3)
   1242 #define V4L2_CID_AUDIO_VOLUME		(V4L2_CID_BASE+5)
   1243 #define V4L2_CID_AUDIO_BALANCE		(V4L2_CID_BASE+6)
   1244 #define V4L2_CID_AUDIO_BASS		(V4L2_CID_BASE+7)
   1245 #define V4L2_CID_AUDIO_TREBLE		(V4L2_CID_BASE+8)
   1246 #define V4L2_CID_AUDIO_MUTE		(V4L2_CID_BASE+9)
   1247 #define V4L2_CID_AUDIO_LOUDNESS		(V4L2_CID_BASE+10)
   1248 #define V4L2_CID_BLACK_LEVEL		(V4L2_CID_BASE+11) /* Deprecated */
   1249 #define V4L2_CID_AUTO_WHITE_BALANCE	(V4L2_CID_BASE+12)
   1250 #define V4L2_CID_DO_WHITE_BALANCE	(V4L2_CID_BASE+13)
   1251 #define V4L2_CID_RED_BALANCE		(V4L2_CID_BASE+14)
   1252 #define V4L2_CID_BLUE_BALANCE		(V4L2_CID_BASE+15)
   1253 #define V4L2_CID_GAMMA			(V4L2_CID_BASE+16)
   1254 #define V4L2_CID_WHITENESS		(V4L2_CID_GAMMA) /* Deprecated */
   1255 #define V4L2_CID_EXPOSURE		(V4L2_CID_BASE+17)
   1256 #define V4L2_CID_AUTOGAIN		(V4L2_CID_BASE+18)
   1257 #define V4L2_CID_GAIN			(V4L2_CID_BASE+19)
   1258 #define V4L2_CID_HFLIP			(V4L2_CID_BASE+20)
   1259 #define V4L2_CID_VFLIP			(V4L2_CID_BASE+21)
   1260 
   1261 /* Deprecated; use V4L2_CID_PAN_RESET and V4L2_CID_TILT_RESET */
   1262 #define V4L2_CID_HCENTER		(V4L2_CID_BASE+22)
   1263 #define V4L2_CID_VCENTER		(V4L2_CID_BASE+23)
   1264 
   1265 #define V4L2_CID_POWER_LINE_FREQUENCY	(V4L2_CID_BASE+24)
   1266 enum v4l2_power_line_frequency {
   1267 	V4L2_CID_POWER_LINE_FREQUENCY_DISABLED	= 0,
   1268 	V4L2_CID_POWER_LINE_FREQUENCY_50HZ	= 1,
   1269 	V4L2_CID_POWER_LINE_FREQUENCY_60HZ	= 2,
   1270 	V4L2_CID_POWER_LINE_FREQUENCY_AUTO	= 3,
   1271 };
   1272 #define V4L2_CID_HUE_AUTO			(V4L2_CID_BASE+25)
   1273 #define V4L2_CID_WHITE_BALANCE_TEMPERATURE	(V4L2_CID_BASE+26)
   1274 #define V4L2_CID_SHARPNESS			(V4L2_CID_BASE+27)
   1275 #define V4L2_CID_BACKLIGHT_COMPENSATION 	(V4L2_CID_BASE+28)
   1276 #define V4L2_CID_CHROMA_AGC                     (V4L2_CID_BASE+29)
   1277 #define V4L2_CID_COLOR_KILLER                   (V4L2_CID_BASE+30)
   1278 #define V4L2_CID_COLORFX			(V4L2_CID_BASE+31)
   1279 enum v4l2_colorfx {
   1280 	V4L2_COLORFX_NONE	= 0,
   1281 	V4L2_COLORFX_BW		= 1,
   1282 	V4L2_COLORFX_SEPIA	= 2,
   1283 	V4L2_COLORFX_NEGATIVE = 3,
   1284 	V4L2_COLORFX_EMBOSS = 4,
   1285 	V4L2_COLORFX_SKETCH = 5,
   1286 	V4L2_COLORFX_SKY_BLUE = 6,
   1287 	V4L2_COLORFX_GRASS_GREEN = 7,
   1288 	V4L2_COLORFX_SKIN_WHITEN = 8,
   1289 	V4L2_COLORFX_VIVID = 9,
   1290 };
   1291 #define V4L2_CID_AUTOBRIGHTNESS			(V4L2_CID_BASE+32)
   1292 #define V4L2_CID_BAND_STOP_FILTER		(V4L2_CID_BASE+33)
   1293 
   1294 #define V4L2_CID_ROTATE				(V4L2_CID_BASE+34)
   1295 #define V4L2_CID_BG_COLOR			(V4L2_CID_BASE+35)
   1296 
   1297 #define V4L2_CID_CHROMA_GAIN                    (V4L2_CID_BASE+36)
   1298 
   1299 #define V4L2_CID_ILLUMINATORS_1			(V4L2_CID_BASE+37)
   1300 #define V4L2_CID_ILLUMINATORS_2			(V4L2_CID_BASE+38)
   1301 
   1302 #define V4L2_CID_MIN_BUFFERS_FOR_CAPTURE	(V4L2_CID_BASE+39)
   1303 #define V4L2_CID_MIN_BUFFERS_FOR_OUTPUT		(V4L2_CID_BASE+40)
   1304 
   1305 #define V4L2_CID_ALPHA_COMPONENT		(V4L2_CID_BASE+41)
   1306 
   1307 /* last CID + 1 */
   1308 #define V4L2_CID_LASTP1                         (V4L2_CID_BASE+42)
   1309 
   1310 /*  MPEG-class control IDs defined by V4L2 */
   1311 #define V4L2_CID_MPEG_BASE 			(V4L2_CTRL_CLASS_MPEG | 0x900)
   1312 #define V4L2_CID_MPEG_CLASS 			(V4L2_CTRL_CLASS_MPEG | 1)
   1313 
   1314 /*  MPEG streams, specific to multiplexed streams */
   1315 #define V4L2_CID_MPEG_STREAM_TYPE 		(V4L2_CID_MPEG_BASE+0)
   1316 enum v4l2_mpeg_stream_type {
   1317 	V4L2_MPEG_STREAM_TYPE_MPEG2_PS   = 0, /* MPEG-2 program stream */
   1318 	V4L2_MPEG_STREAM_TYPE_MPEG2_TS   = 1, /* MPEG-2 transport stream */
   1319 	V4L2_MPEG_STREAM_TYPE_MPEG1_SS   = 2, /* MPEG-1 system stream */
   1320 	V4L2_MPEG_STREAM_TYPE_MPEG2_DVD  = 3, /* MPEG-2 DVD-compatible stream */
   1321 	V4L2_MPEG_STREAM_TYPE_MPEG1_VCD  = 4, /* MPEG-1 VCD-compatible stream */
   1322 	V4L2_MPEG_STREAM_TYPE_MPEG2_SVCD = 5, /* MPEG-2 SVCD-compatible stream */
   1323 };
   1324 #define V4L2_CID_MPEG_STREAM_PID_PMT 		(V4L2_CID_MPEG_BASE+1)
   1325 #define V4L2_CID_MPEG_STREAM_PID_AUDIO 		(V4L2_CID_MPEG_BASE+2)
   1326 #define V4L2_CID_MPEG_STREAM_PID_VIDEO 		(V4L2_CID_MPEG_BASE+3)
   1327 #define V4L2_CID_MPEG_STREAM_PID_PCR 		(V4L2_CID_MPEG_BASE+4)
   1328 #define V4L2_CID_MPEG_STREAM_PES_ID_AUDIO 	(V4L2_CID_MPEG_BASE+5)
   1329 #define V4L2_CID_MPEG_STREAM_PES_ID_VIDEO 	(V4L2_CID_MPEG_BASE+6)
   1330 #define V4L2_CID_MPEG_STREAM_VBI_FMT 		(V4L2_CID_MPEG_BASE+7)
   1331 enum v4l2_mpeg_stream_vbi_fmt {
   1332 	V4L2_MPEG_STREAM_VBI_FMT_NONE = 0,  /* No VBI in the MPEG stream */
   1333 	V4L2_MPEG_STREAM_VBI_FMT_IVTV = 1,  /* VBI in private packets, IVTV format */
   1334 };
   1335 
   1336 /*  MPEG audio controls specific to multiplexed streams  */
   1337 #define V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ 	(V4L2_CID_MPEG_BASE+100)
   1338 enum v4l2_mpeg_audio_sampling_freq {
   1339 	V4L2_MPEG_AUDIO_SAMPLING_FREQ_44100 = 0,
   1340 	V4L2_MPEG_AUDIO_SAMPLING_FREQ_48000 = 1,
   1341 	V4L2_MPEG_AUDIO_SAMPLING_FREQ_32000 = 2,
   1342 };
   1343 #define V4L2_CID_MPEG_AUDIO_ENCODING 		(V4L2_CID_MPEG_BASE+101)
   1344 enum v4l2_mpeg_audio_encoding {
   1345 	V4L2_MPEG_AUDIO_ENCODING_LAYER_1 = 0,
   1346 	V4L2_MPEG_AUDIO_ENCODING_LAYER_2 = 1,
   1347 	V4L2_MPEG_AUDIO_ENCODING_LAYER_3 = 2,
   1348 	V4L2_MPEG_AUDIO_ENCODING_AAC     = 3,
   1349 	V4L2_MPEG_AUDIO_ENCODING_AC3     = 4,
   1350 };
   1351 #define V4L2_CID_MPEG_AUDIO_L1_BITRATE 		(V4L2_CID_MPEG_BASE+102)
   1352 enum v4l2_mpeg_audio_l1_bitrate {
   1353 	V4L2_MPEG_AUDIO_L1_BITRATE_32K  = 0,
   1354 	V4L2_MPEG_AUDIO_L1_BITRATE_64K  = 1,
   1355 	V4L2_MPEG_AUDIO_L1_BITRATE_96K  = 2,
   1356 	V4L2_MPEG_AUDIO_L1_BITRATE_128K = 3,
   1357 	V4L2_MPEG_AUDIO_L1_BITRATE_160K = 4,
   1358 	V4L2_MPEG_AUDIO_L1_BITRATE_192K = 5,
   1359 	V4L2_MPEG_AUDIO_L1_BITRATE_224K = 6,
   1360 	V4L2_MPEG_AUDIO_L1_BITRATE_256K = 7,
   1361 	V4L2_MPEG_AUDIO_L1_BITRATE_288K = 8,
   1362 	V4L2_MPEG_AUDIO_L1_BITRATE_320K = 9,
   1363 	V4L2_MPEG_AUDIO_L1_BITRATE_352K = 10,
   1364 	V4L2_MPEG_AUDIO_L1_BITRATE_384K = 11,
   1365 	V4L2_MPEG_AUDIO_L1_BITRATE_416K = 12,
   1366 	V4L2_MPEG_AUDIO_L1_BITRATE_448K = 13,
   1367 };
   1368 #define V4L2_CID_MPEG_AUDIO_L2_BITRATE 		(V4L2_CID_MPEG_BASE+103)
   1369 enum v4l2_mpeg_audio_l2_bitrate {
   1370 	V4L2_MPEG_AUDIO_L2_BITRATE_32K  = 0,
   1371 	V4L2_MPEG_AUDIO_L2_BITRATE_48K  = 1,
   1372 	V4L2_MPEG_AUDIO_L2_BITRATE_56K  = 2,
   1373 	V4L2_MPEG_AUDIO_L2_BITRATE_64K  = 3,
   1374 	V4L2_MPEG_AUDIO_L2_BITRATE_80K  = 4,
   1375 	V4L2_MPEG_AUDIO_L2_BITRATE_96K  = 5,
   1376 	V4L2_MPEG_AUDIO_L2_BITRATE_112K = 6,
   1377 	V4L2_MPEG_AUDIO_L2_BITRATE_128K = 7,
   1378 	V4L2_MPEG_AUDIO_L2_BITRATE_160K = 8,
   1379 	V4L2_MPEG_AUDIO_L2_BITRATE_192K = 9,
   1380 	V4L2_MPEG_AUDIO_L2_BITRATE_224K = 10,
   1381 	V4L2_MPEG_AUDIO_L2_BITRATE_256K = 11,
   1382 	V4L2_MPEG_AUDIO_L2_BITRATE_320K = 12,
   1383 	V4L2_MPEG_AUDIO_L2_BITRATE_384K = 13,
   1384 };
   1385 #define V4L2_CID_MPEG_AUDIO_L3_BITRATE 		(V4L2_CID_MPEG_BASE+104)
   1386 enum v4l2_mpeg_audio_l3_bitrate {
   1387 	V4L2_MPEG_AUDIO_L3_BITRATE_32K  = 0,
   1388 	V4L2_MPEG_AUDIO_L3_BITRATE_40K  = 1,
   1389 	V4L2_MPEG_AUDIO_L3_BITRATE_48K  = 2,
   1390 	V4L2_MPEG_AUDIO_L3_BITRATE_56K  = 3,
   1391 	V4L2_MPEG_AUDIO_L3_BITRATE_64K  = 4,
   1392 	V4L2_MPEG_AUDIO_L3_BITRATE_80K  = 5,
   1393 	V4L2_MPEG_AUDIO_L3_BITRATE_96K  = 6,
   1394 	V4L2_MPEG_AUDIO_L3_BITRATE_112K = 7,
   1395 	V4L2_MPEG_AUDIO_L3_BITRATE_128K = 8,
   1396 	V4L2_MPEG_AUDIO_L3_BITRATE_160K = 9,
   1397 	V4L2_MPEG_AUDIO_L3_BITRATE_192K = 10,
   1398 	V4L2_MPEG_AUDIO_L3_BITRATE_224K = 11,
   1399 	V4L2_MPEG_AUDIO_L3_BITRATE_256K = 12,
   1400 	V4L2_MPEG_AUDIO_L3_BITRATE_320K = 13,
   1401 };
   1402 #define V4L2_CID_MPEG_AUDIO_MODE 		(V4L2_CID_MPEG_BASE+105)
   1403 enum v4l2_mpeg_audio_mode {
   1404 	V4L2_MPEG_AUDIO_MODE_STEREO       = 0,
   1405 	V4L2_MPEG_AUDIO_MODE_JOINT_STEREO = 1,
   1406 	V4L2_MPEG_AUDIO_MODE_DUAL         = 2,
   1407 	V4L2_MPEG_AUDIO_MODE_MONO         = 3,
   1408 };
   1409 #define V4L2_CID_MPEG_AUDIO_MODE_EXTENSION 	(V4L2_CID_MPEG_BASE+106)
   1410 enum v4l2_mpeg_audio_mode_extension {
   1411 	V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_4  = 0,
   1412 	V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_8  = 1,
   1413 	V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_12 = 2,
   1414 	V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_16 = 3,
   1415 };
   1416 #define V4L2_CID_MPEG_AUDIO_EMPHASIS 		(V4L2_CID_MPEG_BASE+107)
   1417 enum v4l2_mpeg_audio_emphasis {
   1418 	V4L2_MPEG_AUDIO_EMPHASIS_NONE         = 0,
   1419 	V4L2_MPEG_AUDIO_EMPHASIS_50_DIV_15_uS = 1,
   1420 	V4L2_MPEG_AUDIO_EMPHASIS_CCITT_J17    = 2,
   1421 };
   1422 #define V4L2_CID_MPEG_AUDIO_CRC 		(V4L2_CID_MPEG_BASE+108)
   1423 enum v4l2_mpeg_audio_crc {
   1424 	V4L2_MPEG_AUDIO_CRC_NONE  = 0,
   1425 	V4L2_MPEG_AUDIO_CRC_CRC16 = 1,
   1426 };
   1427 #define V4L2_CID_MPEG_AUDIO_MUTE 		(V4L2_CID_MPEG_BASE+109)
   1428 #define V4L2_CID_MPEG_AUDIO_AAC_BITRATE		(V4L2_CID_MPEG_BASE+110)
   1429 #define V4L2_CID_MPEG_AUDIO_AC3_BITRATE		(V4L2_CID_MPEG_BASE+111)
   1430 enum v4l2_mpeg_audio_ac3_bitrate {
   1431 	V4L2_MPEG_AUDIO_AC3_BITRATE_32K  = 0,
   1432 	V4L2_MPEG_AUDIO_AC3_BITRATE_40K  = 1,
   1433 	V4L2_MPEG_AUDIO_AC3_BITRATE_48K  = 2,
   1434 	V4L2_MPEG_AUDIO_AC3_BITRATE_56K  = 3,
   1435 	V4L2_MPEG_AUDIO_AC3_BITRATE_64K  = 4,
   1436 	V4L2_MPEG_AUDIO_AC3_BITRATE_80K  = 5,
   1437 	V4L2_MPEG_AUDIO_AC3_BITRATE_96K  = 6,
   1438 	V4L2_MPEG_AUDIO_AC3_BITRATE_112K = 7,
   1439 	V4L2_MPEG_AUDIO_AC3_BITRATE_128K = 8,
   1440 	V4L2_MPEG_AUDIO_AC3_BITRATE_160K = 9,
   1441 	V4L2_MPEG_AUDIO_AC3_BITRATE_192K = 10,
   1442 	V4L2_MPEG_AUDIO_AC3_BITRATE_224K = 11,
   1443 	V4L2_MPEG_AUDIO_AC3_BITRATE_256K = 12,
   1444 	V4L2_MPEG_AUDIO_AC3_BITRATE_320K = 13,
   1445 	V4L2_MPEG_AUDIO_AC3_BITRATE_384K = 14,
   1446 	V4L2_MPEG_AUDIO_AC3_BITRATE_448K = 15,
   1447 	V4L2_MPEG_AUDIO_AC3_BITRATE_512K = 16,
   1448 	V4L2_MPEG_AUDIO_AC3_BITRATE_576K = 17,
   1449 	V4L2_MPEG_AUDIO_AC3_BITRATE_640K = 18,
   1450 };
   1451 #define V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK	(V4L2_CID_MPEG_BASE+112)
   1452 enum v4l2_mpeg_audio_dec_playback {
   1453 	V4L2_MPEG_AUDIO_DEC_PLAYBACK_AUTO	    = 0,
   1454 	V4L2_MPEG_AUDIO_DEC_PLAYBACK_STEREO	    = 1,
   1455 	V4L2_MPEG_AUDIO_DEC_PLAYBACK_LEFT	    = 2,
   1456 	V4L2_MPEG_AUDIO_DEC_PLAYBACK_RIGHT	    = 3,
   1457 	V4L2_MPEG_AUDIO_DEC_PLAYBACK_MONO	    = 4,
   1458 	V4L2_MPEG_AUDIO_DEC_PLAYBACK_SWAPPED_STEREO = 5,
   1459 };
   1460 #define V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK (V4L2_CID_MPEG_BASE+113)
   1461 
   1462 /*  MPEG video controls specific to multiplexed streams */
   1463 #define V4L2_CID_MPEG_VIDEO_ENCODING 		(V4L2_CID_MPEG_BASE+200)
   1464 enum v4l2_mpeg_video_encoding {
   1465 	V4L2_MPEG_VIDEO_ENCODING_MPEG_1     = 0,
   1466 	V4L2_MPEG_VIDEO_ENCODING_MPEG_2     = 1,
   1467 	V4L2_MPEG_VIDEO_ENCODING_MPEG_4_AVC = 2,
   1468 };
   1469 #define V4L2_CID_MPEG_VIDEO_ASPECT 		(V4L2_CID_MPEG_BASE+201)
   1470 enum v4l2_mpeg_video_aspect {
   1471 	V4L2_MPEG_VIDEO_ASPECT_1x1     = 0,
   1472 	V4L2_MPEG_VIDEO_ASPECT_4x3     = 1,
   1473 	V4L2_MPEG_VIDEO_ASPECT_16x9    = 2,
   1474 	V4L2_MPEG_VIDEO_ASPECT_221x100 = 3,
   1475 };
   1476 #define V4L2_CID_MPEG_VIDEO_B_FRAMES 		(V4L2_CID_MPEG_BASE+202)
   1477 #define V4L2_CID_MPEG_VIDEO_GOP_SIZE 		(V4L2_CID_MPEG_BASE+203)
   1478 #define V4L2_CID_MPEG_VIDEO_GOP_CLOSURE 	(V4L2_CID_MPEG_BASE+204)
   1479 #define V4L2_CID_MPEG_VIDEO_PULLDOWN 		(V4L2_CID_MPEG_BASE+205)
   1480 #define V4L2_CID_MPEG_VIDEO_BITRATE_MODE 	(V4L2_CID_MPEG_BASE+206)
   1481 enum v4l2_mpeg_video_bitrate_mode {
   1482 	V4L2_MPEG_VIDEO_BITRATE_MODE_VBR = 0,
   1483 	V4L2_MPEG_VIDEO_BITRATE_MODE_CBR = 1,
   1484 };
   1485 #define V4L2_CID_MPEG_VIDEO_BITRATE 		(V4L2_CID_MPEG_BASE+207)
   1486 #define V4L2_CID_MPEG_VIDEO_BITRATE_PEAK 	(V4L2_CID_MPEG_BASE+208)
   1487 #define V4L2_CID_MPEG_VIDEO_TEMPORAL_DECIMATION (V4L2_CID_MPEG_BASE+209)
   1488 #define V4L2_CID_MPEG_VIDEO_MUTE 		(V4L2_CID_MPEG_BASE+210)
   1489 #define V4L2_CID_MPEG_VIDEO_MUTE_YUV 		(V4L2_CID_MPEG_BASE+211)
   1490 #define V4L2_CID_MPEG_VIDEO_DECODER_SLICE_INTERFACE		(V4L2_CID_MPEG_BASE+212)
   1491 #define V4L2_CID_MPEG_VIDEO_DECODER_MPEG4_DEBLOCK_FILTER	(V4L2_CID_MPEG_BASE+213)
   1492 #define V4L2_CID_MPEG_VIDEO_CYCLIC_INTRA_REFRESH_MB		(V4L2_CID_MPEG_BASE+214)
   1493 #define V4L2_CID_MPEG_VIDEO_FRAME_RC_ENABLE			(V4L2_CID_MPEG_BASE+215)
   1494 #define V4L2_CID_MPEG_VIDEO_HEADER_MODE				(V4L2_CID_MPEG_BASE+216)
   1495 enum v4l2_mpeg_video_header_mode {
   1496 	V4L2_MPEG_VIDEO_HEADER_MODE_SEPARATE			= 0,
   1497 	V4L2_MPEG_VIDEO_HEADER_MODE_JOINED_WITH_1ST_FRAME	= 1,
   1498 
   1499 };
   1500 #define V4L2_CID_MPEG_VIDEO_MAX_REF_PIC			(V4L2_CID_MPEG_BASE+217)
   1501 #define V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE		(V4L2_CID_MPEG_BASE+218)
   1502 #define V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_BYTES	(V4L2_CID_MPEG_BASE+219)
   1503 #define V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_MB		(V4L2_CID_MPEG_BASE+220)
   1504 #define V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE		(V4L2_CID_MPEG_BASE+221)
   1505 enum v4l2_mpeg_video_multi_slice_mode {
   1506 	V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_SINGLE		= 0,
   1507 	V4L2_MPEG_VIDEO_MULTI_SICE_MODE_MAX_MB		= 1,
   1508 	V4L2_MPEG_VIDEO_MULTI_SICE_MODE_MAX_BYTES	= 2,
   1509 };
   1510 #define V4L2_CID_MPEG_VIDEO_VBV_SIZE			(V4L2_CID_MPEG_BASE+222)
   1511 #define V4L2_CID_MPEG_VIDEO_DEC_PTS			(V4L2_CID_MPEG_BASE+223)
   1512 #define V4L2_CID_MPEG_VIDEO_DEC_FRAME			(V4L2_CID_MPEG_BASE+224)
   1513 
   1514 #define V4L2_CID_MPEG_VIDEO_H263_I_FRAME_QP		(V4L2_CID_MPEG_BASE+300)
   1515 #define V4L2_CID_MPEG_VIDEO_H263_P_FRAME_QP		(V4L2_CID_MPEG_BASE+301)
   1516 #define V4L2_CID_MPEG_VIDEO_H263_B_FRAME_QP		(V4L2_CID_MPEG_BASE+302)
   1517 #define V4L2_CID_MPEG_VIDEO_H263_MIN_QP			(V4L2_CID_MPEG_BASE+303)
   1518 #define V4L2_CID_MPEG_VIDEO_H263_MAX_QP			(V4L2_CID_MPEG_BASE+304)
   1519 #define V4L2_CID_MPEG_VIDEO_H264_I_FRAME_QP		(V4L2_CID_MPEG_BASE+350)
   1520 #define V4L2_CID_MPEG_VIDEO_H264_P_FRAME_QP		(V4L2_CID_MPEG_BASE+351)
   1521 #define V4L2_CID_MPEG_VIDEO_H264_B_FRAME_QP		(V4L2_CID_MPEG_BASE+352)
   1522 #define V4L2_CID_MPEG_VIDEO_H264_MIN_QP			(V4L2_CID_MPEG_BASE+353)
   1523 #define V4L2_CID_MPEG_VIDEO_H264_MAX_QP			(V4L2_CID_MPEG_BASE+354)
   1524 #define V4L2_CID_MPEG_VIDEO_H264_8X8_TRANSFORM		(V4L2_CID_MPEG_BASE+355)
   1525 #define V4L2_CID_MPEG_VIDEO_H264_CPB_SIZE		(V4L2_CID_MPEG_BASE+356)
   1526 #define V4L2_CID_MPEG_VIDEO_H264_ENTROPY_MODE		(V4L2_CID_MPEG_BASE+357)
   1527 enum v4l2_mpeg_video_h264_entropy_mode {
   1528 	V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CAVLC	= 0,
   1529 	V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CABAC	= 1,
   1530 };
   1531 #define V4L2_CID_MPEG_VIDEO_H264_I_PERIOD		(V4L2_CID_MPEG_BASE+358)
   1532 #define V4L2_CID_MPEG_VIDEO_H264_LEVEL			(V4L2_CID_MPEG_BASE+359)
   1533 enum v4l2_mpeg_video_h264_level {
   1534 	V4L2_MPEG_VIDEO_H264_LEVEL_1_0	= 0,
   1535 	V4L2_MPEG_VIDEO_H264_LEVEL_1B	= 1,
   1536 	V4L2_MPEG_VIDEO_H264_LEVEL_1_1	= 2,
   1537 	V4L2_MPEG_VIDEO_H264_LEVEL_1_2	= 3,
   1538 	V4L2_MPEG_VIDEO_H264_LEVEL_1_3	= 4,
   1539 	V4L2_MPEG_VIDEO_H264_LEVEL_2_0	= 5,
   1540 	V4L2_MPEG_VIDEO_H264_LEVEL_2_1	= 6,
   1541 	V4L2_MPEG_VIDEO_H264_LEVEL_2_2	= 7,
   1542 	V4L2_MPEG_VIDEO_H264_LEVEL_3_0	= 8,
   1543 	V4L2_MPEG_VIDEO_H264_LEVEL_3_1	= 9,
   1544 	V4L2_MPEG_VIDEO_H264_LEVEL_3_2	= 10,
   1545 	V4L2_MPEG_VIDEO_H264_LEVEL_4_0	= 11,
   1546 	V4L2_MPEG_VIDEO_H264_LEVEL_4_1	= 12,
   1547 	V4L2_MPEG_VIDEO_H264_LEVEL_4_2	= 13,
   1548 	V4L2_MPEG_VIDEO_H264_LEVEL_5_0	= 14,
   1549 	V4L2_MPEG_VIDEO_H264_LEVEL_5_1	= 15,
   1550 };
   1551 #define V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_ALPHA	(V4L2_CID_MPEG_BASE+360)
   1552 #define V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_BETA	(V4L2_CID_MPEG_BASE+361)
   1553 #define V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_MODE	(V4L2_CID_MPEG_BASE+362)
   1554 enum v4l2_mpeg_video_h264_loop_filter_mode {
   1555 	V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_ENABLED				= 0,
   1556 	V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED				= 1,
   1557 	V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED_AT_SLICE_BOUNDARY	= 2,
   1558 };
   1559 #define V4L2_CID_MPEG_VIDEO_H264_PROFILE		(V4L2_CID_MPEG_BASE+363)
   1560 enum v4l2_mpeg_video_h264_profile {
   1561 	V4L2_MPEG_VIDEO_H264_PROFILE_BASELINE			= 0,
   1562 	V4L2_MPEG_VIDEO_H264_PROFILE_CONSTRAINED_BASELINE	= 1,
   1563 	V4L2_MPEG_VIDEO_H264_PROFILE_MAIN			= 2,
   1564 	V4L2_MPEG_VIDEO_H264_PROFILE_EXTENDED			= 3,
   1565 	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH			= 4,
   1566 	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10			= 5,
   1567 	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422			= 6,
   1568 	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_PREDICTIVE	= 7,
   1569 	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10_INTRA		= 8,
   1570 	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422_INTRA		= 9,
   1571 	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_INTRA		= 10,
   1572 	V4L2_MPEG_VIDEO_H264_PROFILE_CAVLC_444_INTRA		= 11,
   1573 	V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_BASELINE		= 12,
   1574 	V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH		= 13,
   1575 	V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH_INTRA	= 14,
   1576 	V4L2_MPEG_VIDEO_H264_PROFILE_STEREO_HIGH		= 15,
   1577 	V4L2_MPEG_VIDEO_H264_PROFILE_MULTIVIEW_HIGH		= 16,
   1578 };
   1579 #define V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_HEIGHT	(V4L2_CID_MPEG_BASE+364)
   1580 #define V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_WIDTH	(V4L2_CID_MPEG_BASE+365)
   1581 #define V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_ENABLE		(V4L2_CID_MPEG_BASE+366)
   1582 #define V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_IDC		(V4L2_CID_MPEG_BASE+367)
   1583 enum v4l2_mpeg_video_h264_vui_sar_idc {
   1584 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_UNSPECIFIED	= 0,
   1585 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_1x1		= 1,
   1586 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_12x11		= 2,
   1587 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_10x11		= 3,
   1588 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_16x11		= 4,
   1589 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_40x33		= 5,
   1590 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_24x11		= 6,
   1591 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_20x11		= 7,
   1592 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_32x11		= 8,
   1593 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_80x33		= 9,
   1594 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_18x11		= 10,
   1595 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_15x11		= 11,
   1596 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_64x33		= 12,
   1597 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_160x99		= 13,
   1598 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_4x3		= 14,
   1599 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_3x2		= 15,
   1600 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_2x1		= 16,
   1601 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_EXTENDED	= 17,
   1602 };
   1603 #define V4L2_CID_MPEG_VIDEO_MPEG4_I_FRAME_QP	(V4L2_CID_MPEG_BASE+400)
   1604 #define V4L2_CID_MPEG_VIDEO_MPEG4_P_FRAME_QP	(V4L2_CID_MPEG_BASE+401)
   1605 #define V4L2_CID_MPEG_VIDEO_MPEG4_B_FRAME_QP	(V4L2_CID_MPEG_BASE+402)
   1606 #define V4L2_CID_MPEG_VIDEO_MPEG4_MIN_QP	(V4L2_CID_MPEG_BASE+403)
   1607 #define V4L2_CID_MPEG_VIDEO_MPEG4_MAX_QP	(V4L2_CID_MPEG_BASE+404)
   1608 #define V4L2_CID_MPEG_VIDEO_MPEG4_LEVEL		(V4L2_CID_MPEG_BASE+405)
   1609 enum v4l2_mpeg_video_mpeg4_level {
   1610 	V4L2_MPEG_VIDEO_MPEG4_LEVEL_0	= 0,
   1611 	V4L2_MPEG_VIDEO_MPEG4_LEVEL_0B	= 1,
   1612 	V4L2_MPEG_VIDEO_MPEG4_LEVEL_1	= 2,
   1613 	V4L2_MPEG_VIDEO_MPEG4_LEVEL_2	= 3,
   1614 	V4L2_MPEG_VIDEO_MPEG4_LEVEL_3	= 4,
   1615 	V4L2_MPEG_VIDEO_MPEG4_LEVEL_3B	= 5,
   1616 	V4L2_MPEG_VIDEO_MPEG4_LEVEL_4	= 6,
   1617 	V4L2_MPEG_VIDEO_MPEG4_LEVEL_5	= 7,
   1618 };
   1619 #define V4L2_CID_MPEG_VIDEO_MPEG4_PROFILE	(V4L2_CID_MPEG_BASE+406)
   1620 enum v4l2_mpeg_video_mpeg4_profile {
   1621 	V4L2_MPEG_VIDEO_MPEG4_PROFILE_SIMPLE				= 0,
   1622 	V4L2_MPEG_VIDEO_MPEG4_PROFILE_ADVANCED_SIMPLE			= 1,
   1623 	V4L2_MPEG_VIDEO_MPEG4_PROFILE_CORE				= 2,
   1624 	V4L2_MPEG_VIDEO_MPEG4_PROFILE_SIMPLE_SCALABLE			= 3,
   1625 	V4L2_MPEG_VIDEO_MPEG4_PROFILE_ADVANCED_CODING_EFFICIENCY	= 4,
   1626 };
   1627 #define V4L2_CID_MPEG_VIDEO_MPEG4_QPEL		(V4L2_CID_MPEG_BASE+407)
   1628 
   1629 /*  MPEG-class control IDs specific to the CX2341x driver as defined by V4L2 */
   1630 #define V4L2_CID_MPEG_CX2341X_BASE 				(V4L2_CTRL_CLASS_MPEG | 0x1000)
   1631 #define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE 	(V4L2_CID_MPEG_CX2341X_BASE+0)
   1632 enum v4l2_mpeg_cx2341x_video_spatial_filter_mode {
   1633 	V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_MANUAL = 0,
   1634 	V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_AUTO   = 1,
   1635 };
   1636 #define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER 		(V4L2_CID_MPEG_CX2341X_BASE+1)
   1637 #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE 	(V4L2_CID_MPEG_CX2341X_BASE+2)
   1638 enum v4l2_mpeg_cx2341x_video_luma_spatial_filter_type {
   1639 	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_OFF                  = 0,
   1640 	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_HOR               = 1,
   1641 	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_VERT              = 2,
   1642 	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_HV_SEPARABLE      = 3,
   1643 	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_SYM_NON_SEPARABLE = 4,
   1644 };
   1645 #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE 	(V4L2_CID_MPEG_CX2341X_BASE+3)
   1646 enum v4l2_mpeg_cx2341x_video_chroma_spatial_filter_type {
   1647 	V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_OFF    = 0,
   1648 	V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_1D_HOR = 1,
   1649 };
   1650 #define V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE 	(V4L2_CID_MPEG_CX2341X_BASE+4)
   1651 enum v4l2_mpeg_cx2341x_video_temporal_filter_mode {
   1652 	V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_MANUAL = 0,
   1653 	V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_AUTO   = 1,
   1654 };
   1655 #define V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER 		(V4L2_CID_MPEG_CX2341X_BASE+5)
   1656 #define V4L2_CID_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE 		(V4L2_CID_MPEG_CX2341X_BASE+6)
   1657 enum v4l2_mpeg_cx2341x_video_median_filter_type {
   1658 	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_OFF      = 0,
   1659 	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR      = 1,
   1660 	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_VERT     = 2,
   1661 	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR_VERT = 3,
   1662 	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_DIAG     = 4,
   1663 };
   1664 #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_BOTTOM 	(V4L2_CID_MPEG_CX2341X_BASE+7)
   1665 #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_TOP 	(V4L2_CID_MPEG_CX2341X_BASE+8)
   1666 #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_BOTTOM	(V4L2_CID_MPEG_CX2341X_BASE+9)
   1667 #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_TOP 	(V4L2_CID_MPEG_CX2341X_BASE+10)
   1668 #define V4L2_CID_MPEG_CX2341X_STREAM_INSERT_NAV_PACKETS 	(V4L2_CID_MPEG_CX2341X_BASE+11)
   1669 
   1670 /*  MPEG-class control IDs specific to the Samsung MFC 5.1 driver as defined by V4L2 */
   1671 #define V4L2_CID_MPEG_MFC51_BASE				(V4L2_CTRL_CLASS_MPEG | 0x1100)
   1672 
   1673 #define V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY		(V4L2_CID_MPEG_MFC51_BASE+0)
   1674 #define V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY_ENABLE	(V4L2_CID_MPEG_MFC51_BASE+1)
   1675 #define V4L2_CID_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE			(V4L2_CID_MPEG_MFC51_BASE+2)
   1676 enum v4l2_mpeg_mfc51_video_frame_skip_mode {
   1677 	V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_DISABLED		= 0,
   1678 	V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_LEVEL_LIMIT	= 1,
   1679 	V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_BUF_LIMIT		= 2,
   1680 };
   1681 #define V4L2_CID_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE			(V4L2_CID_MPEG_MFC51_BASE+3)
   1682 enum v4l2_mpeg_mfc51_video_force_frame_type {
   1683 	V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_DISABLED		= 0,
   1684 	V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_I_FRAME		= 1,
   1685 	V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_NOT_CODED	= 2,
   1686 };
   1687 #define V4L2_CID_MPEG_MFC51_VIDEO_PADDING				(V4L2_CID_MPEG_MFC51_BASE+4)
   1688 #define V4L2_CID_MPEG_MFC51_VIDEO_PADDING_YUV				(V4L2_CID_MPEG_MFC51_BASE+5)
   1689 #define V4L2_CID_MPEG_MFC51_VIDEO_RC_FIXED_TARGET_BIT			(V4L2_CID_MPEG_MFC51_BASE+6)
   1690 #define V4L2_CID_MPEG_MFC51_VIDEO_RC_REACTION_COEFF			(V4L2_CID_MPEG_MFC51_BASE+7)
   1691 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_ACTIVITY		(V4L2_CID_MPEG_MFC51_BASE+50)
   1692 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_DARK			(V4L2_CID_MPEG_MFC51_BASE+51)
   1693 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_SMOOTH		(V4L2_CID_MPEG_MFC51_BASE+52)
   1694 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_STATIC		(V4L2_CID_MPEG_MFC51_BASE+53)
   1695 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_NUM_REF_PIC_FOR_P		(V4L2_CID_MPEG_MFC51_BASE+54)
   1696 
   1697 /*  Camera class control IDs */
   1698 #define V4L2_CID_CAMERA_CLASS_BASE 	(V4L2_CTRL_CLASS_CAMERA | 0x900)
   1699 #define V4L2_CID_CAMERA_CLASS 		(V4L2_CTRL_CLASS_CAMERA | 1)
   1700 
   1701 #define V4L2_CID_EXPOSURE_AUTO			(V4L2_CID_CAMERA_CLASS_BASE+1)
   1702 enum  v4l2_exposure_auto_type {
   1703 	V4L2_EXPOSURE_AUTO = 0,
   1704 	V4L2_EXPOSURE_MANUAL = 1,
   1705 	V4L2_EXPOSURE_SHUTTER_PRIORITY = 2,
   1706 	V4L2_EXPOSURE_APERTURE_PRIORITY = 3
   1707 };
   1708 #define V4L2_CID_EXPOSURE_ABSOLUTE		(V4L2_CID_CAMERA_CLASS_BASE+2)
   1709 #define V4L2_CID_EXPOSURE_AUTO_PRIORITY		(V4L2_CID_CAMERA_CLASS_BASE+3)
   1710 
   1711 #define V4L2_CID_PAN_RELATIVE			(V4L2_CID_CAMERA_CLASS_BASE+4)
   1712 #define V4L2_CID_TILT_RELATIVE			(V4L2_CID_CAMERA_CLASS_BASE+5)
   1713 #define V4L2_CID_PAN_RESET			(V4L2_CID_CAMERA_CLASS_BASE+6)
   1714 #define V4L2_CID_TILT_RESET			(V4L2_CID_CAMERA_CLASS_BASE+7)
   1715 
   1716 #define V4L2_CID_PAN_ABSOLUTE			(V4L2_CID_CAMERA_CLASS_BASE+8)
   1717 #define V4L2_CID_TILT_ABSOLUTE			(V4L2_CID_CAMERA_CLASS_BASE+9)
   1718 
   1719 #define V4L2_CID_FOCUS_ABSOLUTE			(V4L2_CID_CAMERA_CLASS_BASE+10)
   1720 #define V4L2_CID_FOCUS_RELATIVE			(V4L2_CID_CAMERA_CLASS_BASE+11)
   1721 #define V4L2_CID_FOCUS_AUTO			(V4L2_CID_CAMERA_CLASS_BASE+12)
   1722 
   1723 #define V4L2_CID_ZOOM_ABSOLUTE			(V4L2_CID_CAMERA_CLASS_BASE+13)
   1724 #define V4L2_CID_ZOOM_RELATIVE			(V4L2_CID_CAMERA_CLASS_BASE+14)
   1725 #define V4L2_CID_ZOOM_CONTINUOUS		(V4L2_CID_CAMERA_CLASS_BASE+15)
   1726 
   1727 #define V4L2_CID_PRIVACY			(V4L2_CID_CAMERA_CLASS_BASE+16)
   1728 
   1729 #define V4L2_CID_IRIS_ABSOLUTE			(V4L2_CID_CAMERA_CLASS_BASE+17)
   1730 #define V4L2_CID_IRIS_RELATIVE			(V4L2_CID_CAMERA_CLASS_BASE+18)
   1731 
   1732 /* FM Modulator class control IDs */
   1733 #define V4L2_CID_FM_TX_CLASS_BASE		(V4L2_CTRL_CLASS_FM_TX | 0x900)
   1734 #define V4L2_CID_FM_TX_CLASS			(V4L2_CTRL_CLASS_FM_TX | 1)
   1735 
   1736 #define V4L2_CID_RDS_TX_DEVIATION		(V4L2_CID_FM_TX_CLASS_BASE + 1)
   1737 #define V4L2_CID_RDS_TX_PI			(V4L2_CID_FM_TX_CLASS_BASE + 2)
   1738 #define V4L2_CID_RDS_TX_PTY			(V4L2_CID_FM_TX_CLASS_BASE + 3)
   1739 #define V4L2_CID_RDS_TX_PS_NAME			(V4L2_CID_FM_TX_CLASS_BASE + 5)
   1740 #define V4L2_CID_RDS_TX_RADIO_TEXT		(V4L2_CID_FM_TX_CLASS_BASE + 6)
   1741 
   1742 #define V4L2_CID_AUDIO_LIMITER_ENABLED		(V4L2_CID_FM_TX_CLASS_BASE + 64)
   1743 #define V4L2_CID_AUDIO_LIMITER_RELEASE_TIME	(V4L2_CID_FM_TX_CLASS_BASE + 65)
   1744 #define V4L2_CID_AUDIO_LIMITER_DEVIATION	(V4L2_CID_FM_TX_CLASS_BASE + 66)
   1745 
   1746 #define V4L2_CID_AUDIO_COMPRESSION_ENABLED	(V4L2_CID_FM_TX_CLASS_BASE + 80)
   1747 #define V4L2_CID_AUDIO_COMPRESSION_GAIN		(V4L2_CID_FM_TX_CLASS_BASE + 81)
   1748 #define V4L2_CID_AUDIO_COMPRESSION_THRESHOLD	(V4L2_CID_FM_TX_CLASS_BASE + 82)
   1749 #define V4L2_CID_AUDIO_COMPRESSION_ATTACK_TIME	(V4L2_CID_FM_TX_CLASS_BASE + 83)
   1750 #define V4L2_CID_AUDIO_COMPRESSION_RELEASE_TIME	(V4L2_CID_FM_TX_CLASS_BASE + 84)
   1751 
   1752 #define V4L2_CID_PILOT_TONE_ENABLED		(V4L2_CID_FM_TX_CLASS_BASE + 96)
   1753 #define V4L2_CID_PILOT_TONE_DEVIATION		(V4L2_CID_FM_TX_CLASS_BASE + 97)
   1754 #define V4L2_CID_PILOT_TONE_FREQUENCY		(V4L2_CID_FM_TX_CLASS_BASE + 98)
   1755 
   1756 #define V4L2_CID_TUNE_PREEMPHASIS		(V4L2_CID_FM_TX_CLASS_BASE + 112)
   1757 enum v4l2_preemphasis {
   1758 	V4L2_PREEMPHASIS_DISABLED	= 0,
   1759 	V4L2_PREEMPHASIS_50_uS		= 1,
   1760 	V4L2_PREEMPHASIS_75_uS		= 2,
   1761 };
   1762 #define V4L2_CID_TUNE_POWER_LEVEL		(V4L2_CID_FM_TX_CLASS_BASE + 113)
   1763 #define V4L2_CID_TUNE_ANTENNA_CAPACITOR		(V4L2_CID_FM_TX_CLASS_BASE + 114)
   1764 
   1765 /* Flash and privacy (indicator) light controls */
   1766 #define V4L2_CID_FLASH_CLASS_BASE		(V4L2_CTRL_CLASS_FLASH | 0x900)
   1767 #define V4L2_CID_FLASH_CLASS			(V4L2_CTRL_CLASS_FLASH | 1)
   1768 
   1769 #define V4L2_CID_FLASH_LED_MODE			(V4L2_CID_FLASH_CLASS_BASE + 1)
   1770 enum v4l2_flash_led_mode {
   1771 	V4L2_FLASH_LED_MODE_NONE,
   1772 	V4L2_FLASH_LED_MODE_FLASH,
   1773 	V4L2_FLASH_LED_MODE_TORCH,
   1774 };
   1775 
   1776 #define V4L2_CID_FLASH_STROBE_SOURCE		(V4L2_CID_FLASH_CLASS_BASE + 2)
   1777 enum v4l2_flash_strobe_source {
   1778 	V4L2_FLASH_STROBE_SOURCE_SOFTWARE,
   1779 	V4L2_FLASH_STROBE_SOURCE_EXTERNAL,
   1780 };
   1781 
   1782 #define V4L2_CID_FLASH_STROBE			(V4L2_CID_FLASH_CLASS_BASE + 3)
   1783 #define V4L2_CID_FLASH_STROBE_STOP		(V4L2_CID_FLASH_CLASS_BASE + 4)
   1784 #define V4L2_CID_FLASH_STROBE_STATUS		(V4L2_CID_FLASH_CLASS_BASE + 5)
   1785 
   1786 #define V4L2_CID_FLASH_TIMEOUT			(V4L2_CID_FLASH_CLASS_BASE + 6)
   1787 #define V4L2_CID_FLASH_INTENSITY		(V4L2_CID_FLASH_CLASS_BASE + 7)
   1788 #define V4L2_CID_FLASH_TORCH_INTENSITY		(V4L2_CID_FLASH_CLASS_BASE + 8)
   1789 #define V4L2_CID_FLASH_INDICATOR_INTENSITY	(V4L2_CID_FLASH_CLASS_BASE + 9)
   1790 
   1791 #define V4L2_CID_FLASH_FAULT			(V4L2_CID_FLASH_CLASS_BASE + 10)
   1792 #define V4L2_FLASH_FAULT_OVER_VOLTAGE		(1 << 0)
   1793 #define V4L2_FLASH_FAULT_TIMEOUT		(1 << 1)
   1794 #define V4L2_FLASH_FAULT_OVER_TEMPERATURE	(1 << 2)
   1795 #define V4L2_FLASH_FAULT_SHORT_CIRCUIT		(1 << 3)
   1796 #define V4L2_FLASH_FAULT_OVER_CURRENT		(1 << 4)
   1797 #define V4L2_FLASH_FAULT_INDICATOR		(1 << 5)
   1798 
   1799 #define V4L2_CID_FLASH_CHARGE			(V4L2_CID_FLASH_CLASS_BASE + 11)
   1800 #define V4L2_CID_FLASH_READY			(V4L2_CID_FLASH_CLASS_BASE + 12)
   1801 
   1802 /*  JPEG-class control IDs defined by V4L2 */
   1803 #define V4L2_CID_JPEG_CLASS_BASE		(V4L2_CTRL_CLASS_JPEG | 0x900)
   1804 #define V4L2_CID_JPEG_CLASS			(V4L2_CTRL_CLASS_JPEG | 1)
   1805 
   1806 #define	V4L2_CID_JPEG_CHROMA_SUBSAMPLING	(V4L2_CID_JPEG_CLASS_BASE + 1)
   1807 enum v4l2_jpeg_chroma_subsampling {
   1808 	V4L2_JPEG_CHROMA_SUBSAMPLING_444	= 0,
   1809 	V4L2_JPEG_CHROMA_SUBSAMPLING_422	= 1,
   1810 	V4L2_JPEG_CHROMA_SUBSAMPLING_420	= 2,
   1811 	V4L2_JPEG_CHROMA_SUBSAMPLING_411	= 3,
   1812 	V4L2_JPEG_CHROMA_SUBSAMPLING_410	= 4,
   1813 	V4L2_JPEG_CHROMA_SUBSAMPLING_GRAY	= 5,
   1814 };
   1815 #define	V4L2_CID_JPEG_RESTART_INTERVAL		(V4L2_CID_JPEG_CLASS_BASE + 2)
   1816 #define	V4L2_CID_JPEG_COMPRESSION_QUALITY	(V4L2_CID_JPEG_CLASS_BASE + 3)
   1817 
   1818 #define	V4L2_CID_JPEG_ACTIVE_MARKER		(V4L2_CID_JPEG_CLASS_BASE + 4)
   1819 #define	V4L2_JPEG_ACTIVE_MARKER_APP0		(1 << 0)
   1820 #define	V4L2_JPEG_ACTIVE_MARKER_APP1		(1 << 1)
   1821 #define	V4L2_JPEG_ACTIVE_MARKER_COM		(1 << 16)
   1822 #define	V4L2_JPEG_ACTIVE_MARKER_DQT		(1 << 17)
   1823 #define	V4L2_JPEG_ACTIVE_MARKER_DHT		(1 << 18)
   1824 
   1825 /*
   1826  *	T U N I N G
   1827  */
   1828 struct v4l2_tuner {
   1829 	__u32                   index;
   1830 	__u8			name[32];
   1831 	enum v4l2_tuner_type    type;
   1832 	__u32			capability;
   1833 	__u32			rangelow;
   1834 	__u32			rangehigh;
   1835 	__u32			rxsubchans;
   1836 	__u32			audmode;
   1837 	__s32			signal;
   1838 	__s32			afc;
   1839 	__u32			reserved[4];
   1840 };
   1841 
   1842 struct v4l2_modulator {
   1843 	__u32			index;
   1844 	__u8			name[32];
   1845 	__u32			capability;
   1846 	__u32			rangelow;
   1847 	__u32			rangehigh;
   1848 	__u32			txsubchans;
   1849 	__u32			reserved[4];
   1850 };
   1851 
   1852 /*  Flags for the 'capability' field */
   1853 #define V4L2_TUNER_CAP_LOW		0x0001
   1854 #define V4L2_TUNER_CAP_NORM		0x0002
   1855 #define V4L2_TUNER_CAP_STEREO		0x0010
   1856 #define V4L2_TUNER_CAP_LANG2		0x0020
   1857 #define V4L2_TUNER_CAP_SAP		0x0020
   1858 #define V4L2_TUNER_CAP_LANG1		0x0040
   1859 #define V4L2_TUNER_CAP_RDS		0x0080
   1860 #define V4L2_TUNER_CAP_RDS_BLOCK_IO	0x0100
   1861 #define V4L2_TUNER_CAP_RDS_CONTROLS	0x0200
   1862 
   1863 /*  Flags for the 'rxsubchans' field */
   1864 #define V4L2_TUNER_SUB_MONO		0x0001
   1865 #define V4L2_TUNER_SUB_STEREO		0x0002
   1866 #define V4L2_TUNER_SUB_LANG2		0x0004
   1867 #define V4L2_TUNER_SUB_SAP		0x0004
   1868 #define V4L2_TUNER_SUB_LANG1		0x0008
   1869 #define V4L2_TUNER_SUB_RDS		0x0010
   1870 
   1871 /*  Values for the 'audmode' field */
   1872 #define V4L2_TUNER_MODE_MONO		0x0000
   1873 #define V4L2_TUNER_MODE_STEREO		0x0001
   1874 #define V4L2_TUNER_MODE_LANG2		0x0002
   1875 #define V4L2_TUNER_MODE_SAP		0x0002
   1876 #define V4L2_TUNER_MODE_LANG1		0x0003
   1877 #define V4L2_TUNER_MODE_LANG1_LANG2	0x0004
   1878 
   1879 struct v4l2_frequency {
   1880 	__u32		      tuner;
   1881 	enum v4l2_tuner_type  type;
   1882 	__u32		      frequency;
   1883 	__u32		      reserved[8];
   1884 };
   1885 
   1886 struct v4l2_hw_freq_seek {
   1887 	__u32		      tuner;
   1888 	enum v4l2_tuner_type  type;
   1889 	__u32		      seek_upward;
   1890 	__u32		      wrap_around;
   1891 	__u32		      spacing;
   1892 	__u32		      reserved[7];
   1893 };
   1894 
   1895 /*
   1896  *	R D S
   1897  */
   1898 
   1899 struct v4l2_rds_data {
   1900 	__u8 	lsb;
   1901 	__u8 	msb;
   1902 	__u8 	block;
   1903 } __attribute__ ((packed));
   1904 
   1905 #define V4L2_RDS_BLOCK_MSK 	 0x7
   1906 #define V4L2_RDS_BLOCK_A 	 0
   1907 #define V4L2_RDS_BLOCK_B 	 1
   1908 #define V4L2_RDS_BLOCK_C 	 2
   1909 #define V4L2_RDS_BLOCK_D 	 3
   1910 #define V4L2_RDS_BLOCK_C_ALT 	 4
   1911 #define V4L2_RDS_BLOCK_INVALID 	 7
   1912 
   1913 #define V4L2_RDS_BLOCK_CORRECTED 0x40
   1914 #define V4L2_RDS_BLOCK_ERROR 	 0x80
   1915 
   1916 /*
   1917  *	A U D I O
   1918  */
   1919 struct v4l2_audio {
   1920 	__u32	index;
   1921 	__u8	name[32];
   1922 	__u32	capability;
   1923 	__u32	mode;
   1924 	__u32	reserved[2];
   1925 };
   1926 
   1927 /*  Flags for the 'capability' field */
   1928 #define V4L2_AUDCAP_STEREO		0x00001
   1929 #define V4L2_AUDCAP_AVL			0x00002
   1930 
   1931 /*  Flags for the 'mode' field */
   1932 #define V4L2_AUDMODE_AVL		0x00001
   1933 
   1934 struct v4l2_audioout {
   1935 	__u32	index;
   1936 	__u8	name[32];
   1937 	__u32	capability;
   1938 	__u32	mode;
   1939 	__u32	reserved[2];
   1940 };
   1941 
   1942 /*
   1943  *	M P E G   S E R V I C E S
   1944  *
   1945  *	NOTE: EXPERIMENTAL API
   1946  */
   1947 #if 1
   1948 #define V4L2_ENC_IDX_FRAME_I    (0)
   1949 #define V4L2_ENC_IDX_FRAME_P    (1)
   1950 #define V4L2_ENC_IDX_FRAME_B    (2)
   1951 #define V4L2_ENC_IDX_FRAME_MASK (0xf)
   1952 
   1953 struct v4l2_enc_idx_entry {
   1954 	__u64 offset;
   1955 	__u64 pts;
   1956 	__u32 length;
   1957 	__u32 flags;
   1958 	__u32 reserved[2];
   1959 };
   1960 
   1961 #define V4L2_ENC_IDX_ENTRIES (64)
   1962 struct v4l2_enc_idx {
   1963 	__u32 entries;
   1964 	__u32 entries_cap;
   1965 	__u32 reserved[4];
   1966 	struct v4l2_enc_idx_entry entry[V4L2_ENC_IDX_ENTRIES];
   1967 };
   1968 
   1969 
   1970 #define V4L2_ENC_CMD_START      (0)
   1971 #define V4L2_ENC_CMD_STOP       (1)
   1972 #define V4L2_ENC_CMD_PAUSE      (2)
   1973 #define V4L2_ENC_CMD_RESUME     (3)
   1974 
   1975 /* Flags for V4L2_ENC_CMD_STOP */
   1976 #define V4L2_ENC_CMD_STOP_AT_GOP_END    (1 << 0)
   1977 
   1978 struct v4l2_encoder_cmd {
   1979 	__u32 cmd;
   1980 	__u32 flags;
   1981 	union {
   1982 		struct {
   1983 			__u32 data[8];
   1984 		} raw;
   1985 	};
   1986 };
   1987 
   1988 /* Decoder commands */
   1989 #define V4L2_DEC_CMD_START       (0)
   1990 #define V4L2_DEC_CMD_STOP        (1)
   1991 #define V4L2_DEC_CMD_PAUSE       (2)
   1992 #define V4L2_DEC_CMD_RESUME      (3)
   1993 
   1994 /* Flags for V4L2_DEC_CMD_START */
   1995 #define V4L2_DEC_CMD_START_MUTE_AUDIO	(1 << 0)
   1996 
   1997 /* Flags for V4L2_DEC_CMD_PAUSE */
   1998 #define V4L2_DEC_CMD_PAUSE_TO_BLACK	(1 << 0)
   1999 
   2000 /* Flags for V4L2_DEC_CMD_STOP */
   2001 #define V4L2_DEC_CMD_STOP_TO_BLACK	(1 << 0)
   2002 #define V4L2_DEC_CMD_STOP_IMMEDIATELY	(1 << 1)
   2003 
   2004 /* Play format requirements (returned by the driver): */
   2005 
   2006 /* The decoder has no special format requirements */
   2007 #define V4L2_DEC_START_FMT_NONE		(0)
   2008 /* The decoder requires full GOPs */
   2009 #define V4L2_DEC_START_FMT_GOP		(1)
   2010 
   2011 /* The structure must be zeroed before use by the application
   2012    This ensures it can be extended safely in the future. */
   2013 struct v4l2_decoder_cmd {
   2014 	__u32 cmd;
   2015 	__u32 flags;
   2016 	union {
   2017 		struct {
   2018 			__u64 pts;
   2019 		} stop;
   2020 
   2021 		struct {
   2022 			/* 0 or 1000 specifies normal speed,
   2023 			   1 specifies forward single stepping,
   2024 			   -1 specifies backward single stepping,
   2025 			   >1: playback at speed/1000 of the normal speed,
   2026 			   <-1: reverse playback at (-speed/1000) of the normal speed. */
   2027 			__s32 speed;
   2028 			__u32 format;
   2029 		} start;
   2030 
   2031 		struct {
   2032 			__u32 data[16];
   2033 		} raw;
   2034 	};
   2035 };
   2036 #endif
   2037 
   2038 
   2039 /*
   2040  *	D A T A   S E R V I C E S   ( V B I )
   2041  *
   2042  *	Data services API by Michael Schimek
   2043  */
   2044 
   2045 /* Raw VBI */
   2046 struct v4l2_vbi_format {
   2047 	__u32	sampling_rate;		/* in 1 Hz */
   2048 	__u32	offset;
   2049 	__u32	samples_per_line;
   2050 	__u32	sample_format;		/* V4L2_PIX_FMT_* */
   2051 	__s32	start[2];
   2052 	__u32	count[2];
   2053 	__u32	flags;			/* V4L2_VBI_* */
   2054 	__u32	reserved[2];		/* must be zero */
   2055 };
   2056 
   2057 /*  VBI flags  */
   2058 #define V4L2_VBI_UNSYNC		(1 << 0)
   2059 #define V4L2_VBI_INTERLACED	(1 << 1)
   2060 
   2061 /* Sliced VBI
   2062  *
   2063  *    This implements is a proposal V4L2 API to allow SLICED VBI
   2064  * required for some hardware encoders. It should change without
   2065  * notice in the definitive implementation.
   2066  */
   2067 
   2068 struct v4l2_sliced_vbi_format {
   2069 	__u16   service_set;
   2070 	/* service_lines[0][...] specifies lines 0-23 (1-23 used) of the first field
   2071 	   service_lines[1][...] specifies lines 0-23 (1-23 used) of the second field
   2072 				 (equals frame lines 313-336 for 625 line video
   2073 				  standards, 263-286 for 525 line standards) */
   2074 	__u16   service_lines[2][24];
   2075 	__u32   io_size;
   2076 	__u32   reserved[2];            /* must be zero */
   2077 };
   2078 
   2079 /* Teletext World System Teletext
   2080    (WST), defined on ITU-R BT.653-2 */
   2081 #define V4L2_SLICED_TELETEXT_B          (0x0001)
   2082 /* Video Program System, defined on ETS 300 231*/
   2083 #define V4L2_SLICED_VPS                 (0x0400)
   2084 /* Closed Caption, defined on EIA-608 */
   2085 #define V4L2_SLICED_CAPTION_525         (0x1000)
   2086 /* Wide Screen System, defined on ITU-R BT1119.1 */
   2087 #define V4L2_SLICED_WSS_625             (0x4000)
   2088 
   2089 #define V4L2_SLICED_VBI_525             (V4L2_SLICED_CAPTION_525)
   2090 #define V4L2_SLICED_VBI_625             (V4L2_SLICED_TELETEXT_B | V4L2_SLICED_VPS | V4L2_SLICED_WSS_625)
   2091 
   2092 struct v4l2_sliced_vbi_cap {
   2093 	__u16   service_set;
   2094 	/* service_lines[0][...] specifies lines 0-23 (1-23 used) of the first field
   2095 	   service_lines[1][...] specifies lines 0-23 (1-23 used) of the second field
   2096 				 (equals frame lines 313-336 for 625 line video
   2097 				  standards, 263-286 for 525 line standards) */
   2098 	__u16   service_lines[2][24];
   2099 	enum v4l2_buf_type type;
   2100 	__u32   reserved[3];    /* must be 0 */
   2101 };
   2102 
   2103 struct v4l2_sliced_vbi_data {
   2104 	__u32   id;
   2105 	__u32   field;          /* 0: first field, 1: second field */
   2106 	__u32   line;           /* 1-23 */
   2107 	__u32   reserved;       /* must be 0 */
   2108 	__u8    data[48];
   2109 };
   2110 
   2111 /*
   2112  * Sliced VBI data inserted into MPEG Streams
   2113  */
   2114 
   2115 /*
   2116  * V4L2_MPEG_STREAM_VBI_FMT_IVTV:
   2117  *
   2118  * Structure of payload contained in an MPEG 2 Private Stream 1 PES Packet in an
   2119  * MPEG-2 Program Pack that contains V4L2_MPEG_STREAM_VBI_FMT_IVTV Sliced VBI
   2120  * data
   2121  *
   2122  * Note, the MPEG-2 Program Pack and Private Stream 1 PES packet header
   2123  * definitions are not included here.  See the MPEG-2 specifications for details
   2124  * on these headers.
   2125  */
   2126 
   2127 /* Line type IDs */
   2128 #define V4L2_MPEG_VBI_IVTV_TELETEXT_B     (1)
   2129 #define V4L2_MPEG_VBI_IVTV_CAPTION_525    (4)
   2130 #define V4L2_MPEG_VBI_IVTV_WSS_625        (5)
   2131 #define V4L2_MPEG_VBI_IVTV_VPS            (7)
   2132 
   2133 struct v4l2_mpeg_vbi_itv0_line {
   2134 	__u8 id;	/* One of V4L2_MPEG_VBI_IVTV_* above */
   2135 	__u8 data[42];	/* Sliced VBI data for the line */
   2136 } __attribute__ ((packed));
   2137 
   2138 struct v4l2_mpeg_vbi_itv0 {
   2139 	__le32 linemask[2]; /* Bitmasks of VBI service lines present */
   2140 	struct v4l2_mpeg_vbi_itv0_line line[35];
   2141 } __attribute__ ((packed));
   2142 
   2143 struct v4l2_mpeg_vbi_ITV0 {
   2144 	struct v4l2_mpeg_vbi_itv0_line line[36];
   2145 } __attribute__ ((packed));
   2146 
   2147 #define V4L2_MPEG_VBI_IVTV_MAGIC0	"itv0"
   2148 #define V4L2_MPEG_VBI_IVTV_MAGIC1	"ITV0"
   2149 
   2150 struct v4l2_mpeg_vbi_fmt_ivtv {
   2151 	__u8 magic[4];
   2152 	union {
   2153 		struct v4l2_mpeg_vbi_itv0 itv0;
   2154 		struct v4l2_mpeg_vbi_ITV0 ITV0;
   2155 	};
   2156 } __attribute__ ((packed));
   2157 
   2158 /*
   2159  *	A G G R E G A T E   S T R U C T U R E S
   2160  */
   2161 
   2162 /**
   2163  * struct v4l2_plane_pix_format - additional, per-plane format definition
   2164  * @sizeimage:		maximum size in bytes required for data, for which
   2165  *			this plane will be used
   2166  * @bytesperline:	distance in bytes between the leftmost pixels in two
   2167  *			adjacent lines
   2168  */
   2169 struct v4l2_plane_pix_format {
   2170 	__u32		sizeimage;
   2171 	__u16		bytesperline;
   2172 	__u16		reserved[7];
   2173 } __attribute__ ((packed));
   2174 
   2175 /**
   2176  * struct v4l2_pix_format_mplane - multiplanar format definition
   2177  * @width:		image width in pixels
   2178  * @height:		image height in pixels
   2179  * @pixelformat:	little endian four character code (fourcc)
   2180  * @field:		field order (for interlaced video)
   2181  * @colorspace:		supplemental to pixelformat
   2182  * @plane_fmt:		per-plane information
   2183  * @num_planes:		number of planes for this format
   2184  */
   2185 struct v4l2_pix_format_mplane {
   2186 	__u32				width;
   2187 	__u32				height;
   2188 	__u32				pixelformat;
   2189 	enum v4l2_field			field;
   2190 	enum v4l2_colorspace		colorspace;
   2191 
   2192 	struct v4l2_plane_pix_format	plane_fmt[VIDEO_MAX_PLANES];
   2193 	__u8				num_planes;
   2194 	__u8				reserved[11];
   2195 } __attribute__ ((packed));
   2196 
   2197 /**
   2198  * struct v4l2_format - stream data format
   2199  * @type:	type of the data stream
   2200  * @pix:	definition of an image format
   2201  * @pix_mp:	definition of a multiplanar image format
   2202  * @win:	definition of an overlaid image
   2203  * @vbi:	raw VBI capture or output parameters
   2204  * @sliced:	sliced VBI capture or output parameters
   2205  * @raw_data:	placeholder for future extensions and custom formats
   2206  */
   2207 struct v4l2_format {
   2208 	enum v4l2_buf_type type;
   2209 	union {
   2210 		struct v4l2_pix_format		pix;     /* V4L2_BUF_TYPE_VIDEO_CAPTURE */
   2211 		struct v4l2_pix_format_mplane	pix_mp;  /* V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE */
   2212 		struct v4l2_window		win;     /* V4L2_BUF_TYPE_VIDEO_OVERLAY */
   2213 		struct v4l2_vbi_format		vbi;     /* V4L2_BUF_TYPE_VBI_CAPTURE */
   2214 		struct v4l2_sliced_vbi_format	sliced;  /* V4L2_BUF_TYPE_SLICED_VBI_CAPTURE */
   2215 		__u8	raw_data[200];                   /* user-defined */
   2216 	} fmt;
   2217 };
   2218 
   2219 /*	Stream type-dependent parameters
   2220  */
   2221 struct v4l2_streamparm {
   2222 	enum v4l2_buf_type type;
   2223 	union {
   2224 		struct v4l2_captureparm	capture;
   2225 		struct v4l2_outputparm	output;
   2226 		__u8	raw_data[200];  /* user-defined */
   2227 	} parm;
   2228 };
   2229 
   2230 /*
   2231  *	E V E N T S
   2232  */
   2233 
   2234 #define V4L2_EVENT_ALL				0
   2235 #define V4L2_EVENT_VSYNC			1
   2236 #define V4L2_EVENT_EOS				2
   2237 #define V4L2_EVENT_CTRL				3
   2238 #define V4L2_EVENT_FRAME_SYNC			4
   2239 #define V4L2_EVENT_PRIVATE_START		0x08000000
   2240 
   2241 /* Payload for V4L2_EVENT_VSYNC */
   2242 struct v4l2_event_vsync {
   2243 	/* Can be V4L2_FIELD_ANY, _NONE, _TOP or _BOTTOM */
   2244 	__u8 field;
   2245 } __attribute__ ((packed));
   2246 
   2247 /* Payload for V4L2_EVENT_CTRL */
   2248 #define V4L2_EVENT_CTRL_CH_VALUE		(1 << 0)
   2249 #define V4L2_EVENT_CTRL_CH_FLAGS		(1 << 1)
   2250 
   2251 struct v4l2_event_ctrl {
   2252 	__u32 changes;
   2253 	__u32 type;
   2254 	union {
   2255 		__s32 value;
   2256 		__s64 value64;
   2257 	};
   2258 	__u32 flags;
   2259 	__s32 minimum;
   2260 	__s32 maximum;
   2261 	__s32 step;
   2262 	__s32 default_value;
   2263 };
   2264 
   2265 struct v4l2_event_frame_sync {
   2266 	__u32 frame_sequence;
   2267 };
   2268 
   2269 struct v4l2_event {
   2270 	__u32				type;
   2271 	union {
   2272 		struct v4l2_event_vsync		vsync;
   2273 		struct v4l2_event_ctrl		ctrl;
   2274 		struct v4l2_event_frame_sync	frame_sync;
   2275 		__u8				data[64];
   2276 	} u;
   2277 	__u32				pending;
   2278 	__u32				sequence;
   2279 	struct timespec			timestamp;
   2280 	__u32				id;
   2281 	__u32				reserved[8];
   2282 };
   2283 
   2284 #define V4L2_EVENT_SUB_FL_SEND_INITIAL		(1 << 0)
   2285 #define V4L2_EVENT_SUB_FL_ALLOW_FEEDBACK	(1 << 1)
   2286 
   2287 struct v4l2_event_subscription {
   2288 	__u32				type;
   2289 	__u32				id;
   2290 	__u32				flags;
   2291 	__u32				reserved[5];
   2292 };
   2293 
   2294 /*
   2295  *	A D V A N C E D   D E B U G G I N G
   2296  *
   2297  *	NOTE: EXPERIMENTAL API, NEVER RELY ON THIS IN APPLICATIONS!
   2298  *	FOR DEBUGGING, TESTING AND INTERNAL USE ONLY!
   2299  */
   2300 
   2301 /* VIDIOC_DBG_G_REGISTER and VIDIOC_DBG_S_REGISTER */
   2302 
   2303 #define V4L2_CHIP_MATCH_HOST       0  /* Match against chip ID on host (0 for the host) */
   2304 #define V4L2_CHIP_MATCH_I2C_DRIVER 1  /* Match against I2C driver name */
   2305 #define V4L2_CHIP_MATCH_I2C_ADDR   2  /* Match against I2C 7-bit address */
   2306 #define V4L2_CHIP_MATCH_AC97       3  /* Match against anciliary AC97 chip */
   2307 
   2308 struct v4l2_dbg_match {
   2309 	__u32 type; /* Match type */
   2310 	union {     /* Match this chip, meaning determined by type */
   2311 		__u32 addr;
   2312 		char name[32];
   2313 	};
   2314 } __attribute__ ((packed));
   2315 
   2316 struct v4l2_dbg_register {
   2317 	struct v4l2_dbg_match match;
   2318 	__u32 size;	/* register size in bytes */
   2319 	__u64 reg;
   2320 	__u64 val;
   2321 } __attribute__ ((packed));
   2322 
   2323 /* VIDIOC_DBG_G_CHIP_IDENT */
   2324 struct v4l2_dbg_chip_ident {
   2325 	struct v4l2_dbg_match match;
   2326 	__u32 ident;       /* chip identifier as specified in <media/v4l2-chip-ident.h> */
   2327 	__u32 revision;    /* chip revision, chip specific */
   2328 } __attribute__ ((packed));
   2329 
   2330 /**
   2331  * struct v4l2_create_buffers - VIDIOC_CREATE_BUFS argument
   2332  * @index:	on return, index of the first created buffer
   2333  * @count:	entry: number of requested buffers,
   2334  *		return: number of created buffers
   2335  * @memory:	buffer memory type
   2336  * @format:	frame format, for which buffers are requested
   2337  * @reserved:	future extensions
   2338  */
   2339 struct v4l2_create_buffers {
   2340 	__u32			index;
   2341 	__u32			count;
   2342 	enum v4l2_memory        memory;
   2343 	struct v4l2_format	format;
   2344 	__u32			reserved[8];
   2345 };
   2346 
   2347 /*
   2348  *	I O C T L   C O D E S   F O R   V I D E O   D E V I C E S
   2349  *
   2350  */
   2351 #define VIDIOC_QUERYCAP		 _IOR('V',  0, struct v4l2_capability)
   2352 #define VIDIOC_RESERVED		  _IO('V',  1)
   2353 #define VIDIOC_ENUM_FMT         _IOWR('V',  2, struct v4l2_fmtdesc)
   2354 #define VIDIOC_G_FMT		_IOWR('V',  4, struct v4l2_format)
   2355 #define VIDIOC_S_FMT		_IOWR('V',  5, struct v4l2_format)
   2356 #define VIDIOC_REQBUFS		_IOWR('V',  8, struct v4l2_requestbuffers)
   2357 #define VIDIOC_QUERYBUF		_IOWR('V',  9, struct v4l2_buffer)
   2358 #define VIDIOC_G_FBUF		 _IOR('V', 10, struct v4l2_framebuffer)
   2359 #define VIDIOC_S_FBUF		 _IOW('V', 11, struct v4l2_framebuffer)
   2360 #define VIDIOC_OVERLAY		 _IOW('V', 14, int)
   2361 #define VIDIOC_QBUF		_IOWR('V', 15, struct v4l2_buffer)
   2362 #define VIDIOC_DQBUF		_IOWR('V', 17, struct v4l2_buffer)
   2363 #define VIDIOC_STREAMON		 _IOW('V', 18, int)
   2364 #define VIDIOC_STREAMOFF	 _IOW('V', 19, int)
   2365 #define VIDIOC_G_PARM		_IOWR('V', 21, struct v4l2_streamparm)
   2366 #define VIDIOC_S_PARM		_IOWR('V', 22, struct v4l2_streamparm)
   2367 #define VIDIOC_G_STD		 _IOR('V', 23, v4l2_std_id)
   2368 #define VIDIOC_S_STD		 _IOW('V', 24, v4l2_std_id)
   2369 #define VIDIOC_ENUMSTD		_IOWR('V', 25, struct v4l2_standard)
   2370 #define VIDIOC_ENUMINPUT	_IOWR('V', 26, struct v4l2_input)
   2371 #define VIDIOC_G_CTRL		_IOWR('V', 27, struct v4l2_control)
   2372 #define VIDIOC_S_CTRL		_IOWR('V', 28, struct v4l2_control)
   2373 #define VIDIOC_G_TUNER		_IOWR('V', 29, struct v4l2_tuner)
   2374 #define VIDIOC_S_TUNER		 _IOW('V', 30, struct v4l2_tuner)
   2375 #define VIDIOC_G_AUDIO		 _IOR('V', 33, struct v4l2_audio)
   2376 #define VIDIOC_S_AUDIO		 _IOW('V', 34, struct v4l2_audio)
   2377 #define VIDIOC_QUERYCTRL	_IOWR('V', 36, struct v4l2_queryctrl)
   2378 #define VIDIOC_QUERYMENU	_IOWR('V', 37, struct v4l2_querymenu)
   2379 #define VIDIOC_G_INPUT		 _IOR('V', 38, int)
   2380 #define VIDIOC_S_INPUT		_IOWR('V', 39, int)
   2381 #define VIDIOC_G_OUTPUT		 _IOR('V', 46, int)
   2382 #define VIDIOC_S_OUTPUT		_IOWR('V', 47, int)
   2383 #define VIDIOC_ENUMOUTPUT	_IOWR('V', 48, struct v4l2_output)
   2384 #define VIDIOC_G_AUDOUT		 _IOR('V', 49, struct v4l2_audioout)
   2385 #define VIDIOC_S_AUDOUT		 _IOW('V', 50, struct v4l2_audioout)
   2386 #define VIDIOC_G_MODULATOR	_IOWR('V', 54, struct v4l2_modulator)
   2387 #define VIDIOC_S_MODULATOR	 _IOW('V', 55, struct v4l2_modulator)
   2388 #define VIDIOC_G_FREQUENCY	_IOWR('V', 56, struct v4l2_frequency)
   2389 #define VIDIOC_S_FREQUENCY	 _IOW('V', 57, struct v4l2_frequency)
   2390 #define VIDIOC_CROPCAP		_IOWR('V', 58, struct v4l2_cropcap)
   2391 #define VIDIOC_G_CROP		_IOWR('V', 59, struct v4l2_crop)
   2392 #define VIDIOC_S_CROP		 _IOW('V', 60, struct v4l2_crop)
   2393 #define VIDIOC_G_JPEGCOMP	 _IOR('V', 61, struct v4l2_jpegcompression)
   2394 #define VIDIOC_S_JPEGCOMP	 _IOW('V', 62, struct v4l2_jpegcompression)
   2395 #define VIDIOC_QUERYSTD      	 _IOR('V', 63, v4l2_std_id)
   2396 #define VIDIOC_TRY_FMT      	_IOWR('V', 64, struct v4l2_format)
   2397 #define VIDIOC_ENUMAUDIO	_IOWR('V', 65, struct v4l2_audio)
   2398 #define VIDIOC_ENUMAUDOUT	_IOWR('V', 66, struct v4l2_audioout)
   2399 #define VIDIOC_G_PRIORITY        _IOR('V', 67, enum v4l2_priority)
   2400 #define VIDIOC_S_PRIORITY        _IOW('V', 68, enum v4l2_priority)
   2401 #define VIDIOC_G_SLICED_VBI_CAP _IOWR('V', 69, struct v4l2_sliced_vbi_cap)
   2402 #define VIDIOC_LOG_STATUS         _IO('V', 70)
   2403 #define VIDIOC_G_EXT_CTRLS	_IOWR('V', 71, struct v4l2_ext_controls)
   2404 #define VIDIOC_S_EXT_CTRLS	_IOWR('V', 72, struct v4l2_ext_controls)
   2405 #define VIDIOC_TRY_EXT_CTRLS	_IOWR('V', 73, struct v4l2_ext_controls)
   2406 #if 1
   2407 #define VIDIOC_ENUM_FRAMESIZES	_IOWR('V', 74, struct v4l2_frmsizeenum)
   2408 #define VIDIOC_ENUM_FRAMEINTERVALS _IOWR('V', 75, struct v4l2_frmivalenum)
   2409 #define VIDIOC_G_ENC_INDEX       _IOR('V', 76, struct v4l2_enc_idx)
   2410 #define VIDIOC_ENCODER_CMD      _IOWR('V', 77, struct v4l2_encoder_cmd)
   2411 #define VIDIOC_TRY_ENCODER_CMD  _IOWR('V', 78, struct v4l2_encoder_cmd)
   2412 #endif
   2413 
   2414 #if 1
   2415 /* Experimental, meant for debugging, testing and internal use.
   2416    Only implemented if CONFIG_VIDEO_ADV_DEBUG is defined.
   2417    You must be root to use these ioctls. Never use these in applications! */
   2418 #define	VIDIOC_DBG_S_REGISTER 	 _IOW('V', 79, struct v4l2_dbg_register)
   2419 #define	VIDIOC_DBG_G_REGISTER 	_IOWR('V', 80, struct v4l2_dbg_register)
   2420 
   2421 /* Experimental, meant for debugging, testing and internal use.
   2422    Never use this ioctl in applications! */
   2423 #define VIDIOC_DBG_G_CHIP_IDENT _IOWR('V', 81, struct v4l2_dbg_chip_ident)
   2424 #endif
   2425 
   2426 #define VIDIOC_S_HW_FREQ_SEEK	 _IOW('V', 82, struct v4l2_hw_freq_seek)
   2427 #define	VIDIOC_ENUM_DV_PRESETS	_IOWR('V', 83, struct v4l2_dv_enum_preset)
   2428 #define	VIDIOC_S_DV_PRESET	_IOWR('V', 84, struct v4l2_dv_preset)
   2429 #define	VIDIOC_G_DV_PRESET	_IOWR('V', 85, struct v4l2_dv_preset)
   2430 #define	VIDIOC_QUERY_DV_PRESET	_IOR('V',  86, struct v4l2_dv_preset)
   2431 #define	VIDIOC_S_DV_TIMINGS	_IOWR('V', 87, struct v4l2_dv_timings)
   2432 #define	VIDIOC_G_DV_TIMINGS	_IOWR('V', 88, struct v4l2_dv_timings)
   2433 #define	VIDIOC_DQEVENT		 _IOR('V', 89, struct v4l2_event)
   2434 #define	VIDIOC_SUBSCRIBE_EVENT	 _IOW('V', 90, struct v4l2_event_subscription)
   2435 #define	VIDIOC_UNSUBSCRIBE_EVENT _IOW('V', 91, struct v4l2_event_subscription)
   2436 
   2437 /* Experimental, the below two ioctls may change over the next couple of kernel
   2438    versions */
   2439 #define VIDIOC_CREATE_BUFS	_IOWR('V', 92, struct v4l2_create_buffers)
   2440 #define VIDIOC_PREPARE_BUF	_IOWR('V', 93, struct v4l2_buffer)
   2441 
   2442 /* Experimental selection API */
   2443 #define VIDIOC_G_SELECTION	_IOWR('V', 94, struct v4l2_selection)
   2444 #define VIDIOC_S_SELECTION	_IOWR('V', 95, struct v4l2_selection)
   2445 
   2446 /* Experimental, these two ioctls may change over the next couple of kernel
   2447    versions. */
   2448 #define VIDIOC_DECODER_CMD	_IOWR('V', 96, struct v4l2_decoder_cmd)
   2449 #define VIDIOC_TRY_DECODER_CMD	_IOWR('V', 97, struct v4l2_decoder_cmd)
   2450 
   2451 /* Reminder: when adding new ioctls please add support for them to
   2452    drivers/media/video/v4l2-compat-ioctl32.c as well! */
   2453 
   2454 #define BASE_VIDIOC_PRIVATE	192		/* 192-255 are private */
   2455 
   2456 #endif /* __LINUX_VIDEODEV2_H */
   2457