Home | History | Annotate | Download | only in linux
      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 #define __user
     59 #include <sys/time.h>
     60 #include <linux/types.h>
     61 
     62 /*
     63  * Common stuff for both V4L1 and V4L2
     64  * Moved from videodev.h
     65  */
     66 #define VIDEO_MAX_FRAME               32
     67 
     68 #define VID_TYPE_CAPTURE	1	/* Can capture */
     69 #define VID_TYPE_TUNER		2	/* Can tune */
     70 #define VID_TYPE_TELETEXT	4	/* Does teletext */
     71 #define VID_TYPE_OVERLAY	8	/* Overlay onto frame buffer */
     72 #define VID_TYPE_CHROMAKEY	16	/* Overlay by chromakey */
     73 #define VID_TYPE_CLIPPING	32	/* Can clip */
     74 #define VID_TYPE_FRAMERAM	64	/* Uses the frame buffer memory */
     75 #define VID_TYPE_SCALES		128	/* Scalable */
     76 #define VID_TYPE_MONOCHROME	256	/* Monochrome only */
     77 #define VID_TYPE_SUBCAPTURE	512	/* Can capture subareas of the image */
     78 #define VID_TYPE_MPEG_DECODER	1024	/* Can decode MPEG streams */
     79 #define VID_TYPE_MPEG_ENCODER	2048	/* Can encode MPEG streams */
     80 #define VID_TYPE_MJPEG_DECODER	4096	/* Can decode MJPEG streams */
     81 #define VID_TYPE_MJPEG_ENCODER	8192	/* Can encode MJPEG streams */
     82 
     83 /*
     84  *	M I S C E L L A N E O U S
     85  */
     86 
     87 /*  Four-character-code (FOURCC) */
     88 #define v4l2_fourcc(a,b,c,d)\
     89 	(((__u32)(a)<<0)|((__u32)(b)<<8)|((__u32)(c)<<16)|((__u32)(d)<<24))
     90 
     91 /*
     92  *	E N U M S
     93  */
     94 enum v4l2_field {
     95 	V4L2_FIELD_ANY           = 0, /* driver can choose from none,
     96 					 top, bottom, interlaced
     97 					 depending on whatever it thinks
     98 					 is approximate ... */
     99 	V4L2_FIELD_NONE          = 1, /* this device has no fields ... */
    100 	V4L2_FIELD_TOP           = 2, /* top field only */
    101 	V4L2_FIELD_BOTTOM        = 3, /* bottom field only */
    102 	V4L2_FIELD_INTERLACED    = 4, /* both fields interlaced */
    103 	V4L2_FIELD_SEQ_TB        = 5, /* both fields sequential into one
    104 					 buffer, top-bottom order */
    105 	V4L2_FIELD_SEQ_BT        = 6, /* same as above + bottom-top order */
    106 	V4L2_FIELD_ALTERNATE     = 7, /* both fields alternating into
    107 					 separate buffers */
    108 	V4L2_FIELD_INTERLACED_TB = 8, /* both fields interlaced, top field
    109 					 first and the top field is
    110 					 transmitted first */
    111 	V4L2_FIELD_INTERLACED_BT = 9, /* both fields interlaced, top field
    112 					 first and the bottom field is
    113 					 transmitted first */
    114 };
    115 #define V4L2_FIELD_HAS_TOP(field)	\
    116 	((field) == V4L2_FIELD_TOP 	||\
    117 	 (field) == V4L2_FIELD_INTERLACED ||\
    118 	 (field) == V4L2_FIELD_INTERLACED_TB ||\
    119 	 (field) == V4L2_FIELD_INTERLACED_BT ||\
    120 	 (field) == V4L2_FIELD_SEQ_TB	||\
    121 	 (field) == V4L2_FIELD_SEQ_BT)
    122 #define V4L2_FIELD_HAS_BOTTOM(field)	\
    123 	((field) == V4L2_FIELD_BOTTOM 	||\
    124 	 (field) == V4L2_FIELD_INTERLACED ||\
    125 	 (field) == V4L2_FIELD_INTERLACED_TB ||\
    126 	 (field) == V4L2_FIELD_INTERLACED_BT ||\
    127 	 (field) == V4L2_FIELD_SEQ_TB	||\
    128 	 (field) == V4L2_FIELD_SEQ_BT)
    129 #define V4L2_FIELD_HAS_BOTH(field)	\
    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 
    136 enum v4l2_buf_type {
    137 	V4L2_BUF_TYPE_VIDEO_CAPTURE        = 1,
    138 	V4L2_BUF_TYPE_VIDEO_OUTPUT         = 2,
    139 	V4L2_BUF_TYPE_VIDEO_OVERLAY        = 3,
    140 	V4L2_BUF_TYPE_VBI_CAPTURE          = 4,
    141 	V4L2_BUF_TYPE_VBI_OUTPUT           = 5,
    142 	V4L2_BUF_TYPE_SLICED_VBI_CAPTURE   = 6,
    143 	V4L2_BUF_TYPE_SLICED_VBI_OUTPUT    = 7,
    144 #if 1
    145 	/* Experimental */
    146 	V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY = 8,
    147 #endif
    148 	V4L2_BUF_TYPE_PRIVATE              = 0x80,
    149 };
    150 
    151 enum v4l2_ctrl_type {
    152 	V4L2_CTRL_TYPE_INTEGER	     = 1,
    153 	V4L2_CTRL_TYPE_BOOLEAN	     = 2,
    154 	V4L2_CTRL_TYPE_MENU	     = 3,
    155 	V4L2_CTRL_TYPE_BUTTON	     = 4,
    156 	V4L2_CTRL_TYPE_INTEGER64     = 5,
    157 	V4L2_CTRL_TYPE_CTRL_CLASS    = 6,
    158 };
    159 
    160 enum v4l2_tuner_type {
    161 	V4L2_TUNER_RADIO	     = 1,
    162 	V4L2_TUNER_ANALOG_TV	     = 2,
    163 	V4L2_TUNER_DIGITAL_TV	     = 3,
    164 };
    165 
    166 enum v4l2_memory {
    167 	V4L2_MEMORY_MMAP             = 1,
    168 	V4L2_MEMORY_USERPTR          = 2,
    169 	V4L2_MEMORY_OVERLAY          = 3,
    170 };
    171 
    172 /* see also http://vektor.theorem.ca/graphics/ycbcr/ */
    173 enum v4l2_colorspace {
    174 	/* ITU-R 601 -- broadcast NTSC/PAL */
    175 	V4L2_COLORSPACE_SMPTE170M     = 1,
    176 
    177 	/* 1125-Line (US) HDTV */
    178 	V4L2_COLORSPACE_SMPTE240M     = 2,
    179 
    180 	/* HD and modern captures. */
    181 	V4L2_COLORSPACE_REC709        = 3,
    182 
    183 	/* broken BT878 extents (601, luma range 16-253 instead of 16-235) */
    184 	V4L2_COLORSPACE_BT878         = 4,
    185 
    186 	/* These should be useful.  Assume 601 extents. */
    187 	V4L2_COLORSPACE_470_SYSTEM_M  = 5,
    188 	V4L2_COLORSPACE_470_SYSTEM_BG = 6,
    189 
    190 	/* I know there will be cameras that send this.  So, this is
    191 	 * unspecified chromaticities and full 0-255 on each of the
    192 	 * Y'CbCr components
    193 	 */
    194 	V4L2_COLORSPACE_JPEG          = 7,
    195 
    196 	/* For RGB colourspaces, this is probably a good start. */
    197 	V4L2_COLORSPACE_SRGB          = 8,
    198 };
    199 
    200 enum v4l2_priority {
    201 	V4L2_PRIORITY_UNSET       = 0,  /* not initialized */
    202 	V4L2_PRIORITY_BACKGROUND  = 1,
    203 	V4L2_PRIORITY_INTERACTIVE = 2,
    204 	V4L2_PRIORITY_RECORD      = 3,
    205 	V4L2_PRIORITY_DEFAULT     = V4L2_PRIORITY_INTERACTIVE,
    206 };
    207 
    208 struct v4l2_rect {
    209 	__s32   left;
    210 	__s32   top;
    211 	__s32   width;
    212 	__s32   height;
    213 };
    214 
    215 struct v4l2_fract {
    216 	__u32   numerator;
    217 	__u32   denominator;
    218 };
    219 
    220 /*
    221  *	D R I V E R   C A P A B I L I T I E S
    222  */
    223 struct v4l2_capability
    224 {
    225 	__u8	driver[16];	/* i.e. "bttv" */
    226 	__u8	card[32];	/* i.e. "Hauppauge WinTV" */
    227 	__u8	bus_info[32];	/* "PCI:" + pci_name(pci_dev) */
    228 	__u32   version;        /* should use KERNEL_VERSION() */
    229 	__u32	capabilities;	/* Device capabilities */
    230 	__u32	reserved[4];
    231 };
    232 
    233 /* Values for 'capabilities' field */
    234 #define V4L2_CAP_VIDEO_CAPTURE		0x00000001  /* Is a video capture device */
    235 #define V4L2_CAP_VIDEO_OUTPUT		0x00000002  /* Is a video output device */
    236 #define V4L2_CAP_VIDEO_OVERLAY		0x00000004  /* Can do video overlay */
    237 #define V4L2_CAP_VBI_CAPTURE		0x00000010  /* Is a raw VBI capture device */
    238 #define V4L2_CAP_VBI_OUTPUT		0x00000020  /* Is a raw VBI output device */
    239 #define V4L2_CAP_SLICED_VBI_CAPTURE	0x00000040  /* Is a sliced VBI capture device */
    240 #define V4L2_CAP_SLICED_VBI_OUTPUT	0x00000080  /* Is a sliced VBI output device */
    241 #define V4L2_CAP_RDS_CAPTURE		0x00000100  /* RDS data capture */
    242 #define V4L2_CAP_VIDEO_OUTPUT_OVERLAY	0x00000200  /* Can do video output overlay */
    243 
    244 #define V4L2_CAP_TUNER			0x00010000  /* has a tuner */
    245 #define V4L2_CAP_AUDIO			0x00020000  /* has audio support */
    246 #define V4L2_CAP_RADIO			0x00040000  /* is a radio device */
    247 
    248 #define V4L2_CAP_READWRITE              0x01000000  /* read/write systemcalls */
    249 #define V4L2_CAP_ASYNCIO                0x02000000  /* async I/O */
    250 #define V4L2_CAP_STREAMING              0x04000000  /* streaming I/O ioctls */
    251 
    252 /*
    253  *	V I D E O   I M A G E   F O R M A T
    254  */
    255 struct v4l2_pix_format
    256 {
    257 	__u32         		width;
    258 	__u32			height;
    259 	__u32			pixelformat;
    260 	enum v4l2_field  	field;
    261 	__u32            	bytesperline;	/* for padding, zero if unused */
    262 	__u32          		sizeimage;
    263 	enum v4l2_colorspace	colorspace;
    264 	__u32			priv;		/* private data, depends on pixelformat */
    265 };
    266 
    267 /*      Pixel format         FOURCC                        depth  Description  */
    268 #define V4L2_PIX_FMT_RGB332  v4l2_fourcc('R','G','B','1') /*  8  RGB-3-3-2     */
    269 #define V4L2_PIX_FMT_RGB444  v4l2_fourcc('R','4','4','4') /* 16  xxxxrrrr ggggbbbb */
    270 #define V4L2_PIX_FMT_RGB555  v4l2_fourcc('R','G','B','O') /* 16  RGB-5-5-5     */
    271 #define V4L2_PIX_FMT_RGB565  v4l2_fourcc('R','G','B','P') /* 16  RGB-5-6-5     */
    272 #define V4L2_PIX_FMT_RGB555X v4l2_fourcc('R','G','B','Q') /* 16  RGB-5-5-5 BE  */
    273 #define V4L2_PIX_FMT_RGB565X v4l2_fourcc('R','G','B','R') /* 16  RGB-5-6-5 BE  */
    274 #define V4L2_PIX_FMT_BGR24   v4l2_fourcc('B','G','R','3') /* 24  BGR-8-8-8     */
    275 #define V4L2_PIX_FMT_RGB24   v4l2_fourcc('R','G','B','3') /* 24  RGB-8-8-8     */
    276 #define V4L2_PIX_FMT_BGR32   v4l2_fourcc('B','G','R','4') /* 32  BGR-8-8-8-8   */
    277 #define V4L2_PIX_FMT_RGB32   v4l2_fourcc('R','G','B','4') /* 32  RGB-8-8-8-8   */
    278 #define V4L2_PIX_FMT_GREY    v4l2_fourcc('G','R','E','Y') /*  8  Greyscale     */
    279 #define V4L2_PIX_FMT_PAL8    v4l2_fourcc('P','A','L','8') /*  8  8-bit palette */
    280 #define V4L2_PIX_FMT_YVU410  v4l2_fourcc('Y','V','U','9') /*  9  YVU 4:1:0     */
    281 #define V4L2_PIX_FMT_YVU420  v4l2_fourcc('Y','V','1','2') /* 12  YVU 4:2:0     */
    282 #define V4L2_PIX_FMT_YUYV    v4l2_fourcc('Y','U','Y','V') /* 16  YUV 4:2:2     */
    283 #define V4L2_PIX_FMT_UYVY    v4l2_fourcc('U','Y','V','Y') /* 16  YUV 4:2:2     */
    284 #define V4L2_PIX_FMT_YUV422P v4l2_fourcc('4','2','2','P') /* 16  YVU422 planar */
    285 #define V4L2_PIX_FMT_YUV411P v4l2_fourcc('4','1','1','P') /* 16  YVU411 planar */
    286 #define V4L2_PIX_FMT_Y41P    v4l2_fourcc('Y','4','1','P') /* 12  YUV 4:1:1     */
    287 #define V4L2_PIX_FMT_YUV444  v4l2_fourcc('Y','4','4','4') /* 16  xxxxyyyy uuuuvvvv */
    288 #define V4L2_PIX_FMT_YUV555  v4l2_fourcc('Y','U','V','O') /* 16  YUV-5-5-5     */
    289 #define V4L2_PIX_FMT_YUV565  v4l2_fourcc('Y','U','V','P') /* 16  YUV-5-6-5     */
    290 #define V4L2_PIX_FMT_YUV32   v4l2_fourcc('Y','U','V','4') /* 32  YUV-8-8-8-8   */
    291 
    292 /* two planes -- one Y, one Cr + Cb interleaved  */
    293 #define V4L2_PIX_FMT_NV12    v4l2_fourcc('N','V','1','2') /* 12  Y/CbCr 4:2:0  */
    294 #define V4L2_PIX_FMT_NV21    v4l2_fourcc('N','V','2','1') /* 12  Y/CrCb 4:2:0  */
    295 
    296 /*  The following formats are not defined in the V4L2 specification */
    297 #define V4L2_PIX_FMT_YUV410  v4l2_fourcc('Y','U','V','9') /*  9  YUV 4:1:0     */
    298 #define V4L2_PIX_FMT_YUV420  v4l2_fourcc('Y','U','1','2') /* 12  YUV 4:2:0     */
    299 #define V4L2_PIX_FMT_YYUV    v4l2_fourcc('Y','Y','U','V') /* 16  YUV 4:2:2     */
    300 #define V4L2_PIX_FMT_HI240   v4l2_fourcc('H','I','2','4') /*  8  8-bit color   */
    301 #define V4L2_PIX_FMT_HM12    v4l2_fourcc('H','M','1','2') /*  8  YUV 4:2:0 16x16 macroblocks */
    302 
    303 /* see http://www.siliconimaging.com/RGB%20Bayer.htm */
    304 #define V4L2_PIX_FMT_SBGGR8  v4l2_fourcc('B','A','8','1') /*  8  BGBG.. GRGR.. */
    305 
    306 /* compressed formats */
    307 #define V4L2_PIX_FMT_MJPEG    v4l2_fourcc('M','J','P','G') /* Motion-JPEG   */
    308 #define V4L2_PIX_FMT_JPEG     v4l2_fourcc('J','P','E','G') /* JFIF JPEG     */
    309 #define V4L2_PIX_FMT_DV       v4l2_fourcc('d','v','s','d') /* 1394          */
    310 #define V4L2_PIX_FMT_MPEG     v4l2_fourcc('M','P','E','G') /* MPEG-1/2/4    */
    311 
    312 /*  Vendor-specific formats   */
    313 #define V4L2_PIX_FMT_WNVA     v4l2_fourcc('W','N','V','A') /* Winnov hw compress */
    314 #define V4L2_PIX_FMT_SN9C10X  v4l2_fourcc('S','9','1','0') /* SN9C10x compression */
    315 #define V4L2_PIX_FMT_PWC1     v4l2_fourcc('P','W','C','1') /* pwc older webcam */
    316 #define V4L2_PIX_FMT_PWC2     v4l2_fourcc('P','W','C','2') /* pwc newer webcam */
    317 #define V4L2_PIX_FMT_ET61X251 v4l2_fourcc('E','6','2','5') /* ET61X251 compression */
    318 
    319 /*
    320  *	F O R M A T   E N U M E R A T I O N
    321  */
    322 struct v4l2_fmtdesc
    323 {
    324 	__u32		    index;             /* Format number      */
    325 	enum v4l2_buf_type  type;              /* buffer type        */
    326 	__u32               flags;
    327 	__u8		    description[32];   /* Description string */
    328 	__u32		    pixelformat;       /* Format fourcc      */
    329 	__u32		    reserved[4];
    330 };
    331 
    332 #define V4L2_FMT_FLAG_COMPRESSED 0x0001
    333 
    334 #if 1
    335 	/* Experimental Frame Size and frame rate enumeration */
    336 /*
    337  *	F R A M E   S I Z E   E N U M E R A T I O N
    338  */
    339 enum v4l2_frmsizetypes
    340 {
    341 	V4L2_FRMSIZE_TYPE_DISCRETE	= 1,
    342 	V4L2_FRMSIZE_TYPE_CONTINUOUS	= 2,
    343 	V4L2_FRMSIZE_TYPE_STEPWISE	= 3,
    344 };
    345 
    346 struct v4l2_frmsize_discrete
    347 {
    348 	__u32			width;		/* Frame width [pixel] */
    349 	__u32			height;		/* Frame height [pixel] */
    350 };
    351 
    352 struct v4l2_frmsize_stepwise
    353 {
    354 	__u32			min_width;	/* Minimum frame width [pixel] */
    355 	__u32			max_width;	/* Maximum frame width [pixel] */
    356 	__u32			step_width;	/* Frame width step size [pixel] */
    357 	__u32			min_height;	/* Minimum frame height [pixel] */
    358 	__u32			max_height;	/* Maximum frame height [pixel] */
    359 	__u32			step_height;	/* Frame height step size [pixel] */
    360 };
    361 
    362 struct v4l2_frmsizeenum
    363 {
    364 	__u32			index;		/* Frame size number */
    365 	__u32			pixel_format;	/* Pixel format */
    366 	__u32			type;		/* Frame size type the device supports. */
    367 
    368 	union {					/* Frame size */
    369 		struct v4l2_frmsize_discrete	discrete;
    370 		struct v4l2_frmsize_stepwise	stepwise;
    371 	};
    372 
    373 	__u32   reserved[2];			/* Reserved space for future use */
    374 };
    375 
    376 /*
    377  *	F R A M E   R A T E   E N U M E R A T I O N
    378  */
    379 enum v4l2_frmivaltypes
    380 {
    381 	V4L2_FRMIVAL_TYPE_DISCRETE	= 1,
    382 	V4L2_FRMIVAL_TYPE_CONTINUOUS	= 2,
    383 	V4L2_FRMIVAL_TYPE_STEPWISE	= 3,
    384 };
    385 
    386 struct v4l2_frmival_stepwise
    387 {
    388 	struct v4l2_fract	min;		/* Minimum frame interval [s] */
    389 	struct v4l2_fract	max;		/* Maximum frame interval [s] */
    390 	struct v4l2_fract	step;		/* Frame interval step size [s] */
    391 };
    392 
    393 struct v4l2_frmivalenum
    394 {
    395 	__u32			index;		/* Frame format index */
    396 	__u32			pixel_format;	/* Pixel format */
    397 	__u32			width;		/* Frame width */
    398 	__u32			height;		/* Frame height */
    399 	__u32			type;		/* Frame interval type the device supports. */
    400 
    401 	union {					/* Frame interval */
    402 		struct v4l2_fract		discrete;
    403 		struct v4l2_frmival_stepwise	stepwise;
    404 	};
    405 
    406 	__u32	reserved[2];			/* Reserved space for future use */
    407 };
    408 #endif
    409 
    410 /*
    411  *	T I M E C O D E
    412  */
    413 struct v4l2_timecode
    414 {
    415 	__u32	type;
    416 	__u32	flags;
    417 	__u8	frames;
    418 	__u8	seconds;
    419 	__u8	minutes;
    420 	__u8	hours;
    421 	__u8	userbits[4];
    422 };
    423 
    424 /*  Type  */
    425 #define V4L2_TC_TYPE_24FPS		1
    426 #define V4L2_TC_TYPE_25FPS		2
    427 #define V4L2_TC_TYPE_30FPS		3
    428 #define V4L2_TC_TYPE_50FPS		4
    429 #define V4L2_TC_TYPE_60FPS		5
    430 
    431 /*  Flags  */
    432 #define V4L2_TC_FLAG_DROPFRAME		0x0001 /* "drop-frame" mode */
    433 #define V4L2_TC_FLAG_COLORFRAME		0x0002
    434 #define V4L2_TC_USERBITS_field		0x000C
    435 #define V4L2_TC_USERBITS_USERDEFINED	0x0000
    436 #define V4L2_TC_USERBITS_8BITCHARS	0x0008
    437 /* The above is based on SMPTE timecodes */
    438 
    439 struct v4l2_jpegcompression
    440 {
    441 	int quality;
    442 
    443 	int  APPn;              /* Number of APP segment to be written,
    444 				 * must be 0..15 */
    445 	int  APP_len;           /* Length of data in JPEG APPn segment */
    446 	char APP_data[60];      /* Data in the JPEG APPn segment. */
    447 
    448 	int  COM_len;           /* Length of data in JPEG COM segment */
    449 	char COM_data[60];      /* Data in JPEG COM segment */
    450 
    451 	__u32 jpeg_markers;     /* Which markers should go into the JPEG
    452 				 * output. Unless you exactly know what
    453 				 * you do, leave them untouched.
    454 				 * Inluding less markers will make the
    455 				 * resulting code smaller, but there will
    456 				 * be fewer aplications which can read it.
    457 				 * The presence of the APP and COM marker
    458 				 * is influenced by APP_len and COM_len
    459 				 * ONLY, not by this property! */
    460 
    461 #define V4L2_JPEG_MARKER_DHT (1<<3)    /* Define Huffman Tables */
    462 #define V4L2_JPEG_MARKER_DQT (1<<4)    /* Define Quantization Tables */
    463 #define V4L2_JPEG_MARKER_DRI (1<<5)    /* Define Restart Interval */
    464 #define V4L2_JPEG_MARKER_COM (1<<6)    /* Comment segment */
    465 #define V4L2_JPEG_MARKER_APP (1<<7)    /* App segment, driver will
    466 					* allways use APP0 */
    467 };
    468 
    469 /*
    470  *	M E M O R Y - M A P P I N G   B U F F E R S
    471  */
    472 struct v4l2_requestbuffers
    473 {
    474 	__u32			count;
    475 	enum v4l2_buf_type      type;
    476 	enum v4l2_memory        memory;
    477 	__u32			reserved[2];
    478 };
    479 
    480 struct v4l2_buffer
    481 {
    482 	__u32			index;
    483 	enum v4l2_buf_type      type;
    484 	__u32			bytesused;
    485 	__u32			flags;
    486 	enum v4l2_field		field;
    487 	struct timeval		timestamp;
    488 	struct v4l2_timecode	timecode;
    489 	__u32			sequence;
    490 
    491 	/* memory location */
    492 	enum v4l2_memory        memory;
    493 	union {
    494 		__u32           offset;
    495 		unsigned long   userptr;
    496 	} m;
    497 	__u32			length;
    498 	__u32			input;
    499 	__u32			reserved;
    500 };
    501 
    502 /*  Flags for 'flags' field */
    503 #define V4L2_BUF_FLAG_MAPPED	0x0001  /* Buffer is mapped (flag) */
    504 #define V4L2_BUF_FLAG_QUEUED	0x0002	/* Buffer is queued for processing */
    505 #define V4L2_BUF_FLAG_DONE	0x0004	/* Buffer is ready */
    506 #define V4L2_BUF_FLAG_KEYFRAME	0x0008	/* Image is a keyframe (I-frame) */
    507 #define V4L2_BUF_FLAG_PFRAME	0x0010	/* Image is a P-frame */
    508 #define V4L2_BUF_FLAG_BFRAME	0x0020	/* Image is a B-frame */
    509 #define V4L2_BUF_FLAG_TIMECODE	0x0100	/* timecode field is valid */
    510 #define V4L2_BUF_FLAG_INPUT     0x0200  /* input field is valid */
    511 
    512 /*
    513  *	O V E R L A Y   P R E V I E W
    514  */
    515 struct v4l2_framebuffer
    516 {
    517 	__u32			capability;
    518 	__u32			flags;
    519 /* FIXME: in theory we should pass something like PCI device + memory
    520  * region + offset instead of some physical address */
    521 	void*                   base;
    522 	struct v4l2_pix_format	fmt;
    523 };
    524 /*  Flags for the 'capability' field. Read only */
    525 #define V4L2_FBUF_CAP_EXTERNOVERLAY	0x0001
    526 #define V4L2_FBUF_CAP_CHROMAKEY		0x0002
    527 #define V4L2_FBUF_CAP_LIST_CLIPPING     0x0004
    528 #define V4L2_FBUF_CAP_BITMAP_CLIPPING	0x0008
    529 #define V4L2_FBUF_CAP_LOCAL_ALPHA	0x0010
    530 #define V4L2_FBUF_CAP_GLOBAL_ALPHA	0x0020
    531 #define V4L2_FBUF_CAP_LOCAL_INV_ALPHA	0x0040
    532 /*  Flags for the 'flags' field. */
    533 #define V4L2_FBUF_FLAG_PRIMARY		0x0001
    534 #define V4L2_FBUF_FLAG_OVERLAY		0x0002
    535 #define V4L2_FBUF_FLAG_CHROMAKEY	0x0004
    536 #define V4L2_FBUF_FLAG_LOCAL_ALPHA	0x0008
    537 #define V4L2_FBUF_FLAG_GLOBAL_ALPHA	0x0010
    538 #define V4L2_FBUF_FLAG_LOCAL_INV_ALPHA	0x0020
    539 
    540 struct v4l2_clip
    541 {
    542 	struct v4l2_rect        c;
    543 	struct v4l2_clip *next;
    544 };
    545 
    546 struct v4l2_window
    547 {
    548 	struct v4l2_rect        w;
    549 	enum v4l2_field  	field;
    550 	__u32			chromakey;
    551 	struct v4l2_clip *clips;
    552 	__u32			clipcount;
    553 	void		 *bitmap;
    554 	__u8                    global_alpha;
    555 };
    556 
    557 /*
    558  *	C A P T U R E   P A R A M E T E R S
    559  */
    560 struct v4l2_captureparm
    561 {
    562 	__u32		   capability;	  /*  Supported modes */
    563 	__u32		   capturemode;	  /*  Current mode */
    564 	struct v4l2_fract  timeperframe;  /*  Time per frame in .1us units */
    565 	__u32		   extendedmode;  /*  Driver-specific extensions */
    566 	__u32              readbuffers;   /*  # of buffers for read */
    567 	__u32		   reserved[4];
    568 };
    569 
    570 /*  Flags for 'capability' and 'capturemode' fields */
    571 #define V4L2_MODE_HIGHQUALITY	0x0001	/*  High quality imaging mode */
    572 #define V4L2_CAP_TIMEPERFRAME	0x1000	/*  timeperframe field is supported */
    573 
    574 struct v4l2_outputparm
    575 {
    576 	__u32		   capability;	 /*  Supported modes */
    577 	__u32		   outputmode;	 /*  Current mode */
    578 	struct v4l2_fract  timeperframe; /*  Time per frame in seconds */
    579 	__u32		   extendedmode; /*  Driver-specific extensions */
    580 	__u32              writebuffers; /*  # of buffers for write */
    581 	__u32		   reserved[4];
    582 };
    583 
    584 /*
    585  *	I N P U T   I M A G E   C R O P P I N G
    586  */
    587 struct v4l2_cropcap {
    588 	enum v4l2_buf_type      type;
    589 	struct v4l2_rect        bounds;
    590 	struct v4l2_rect        defrect;
    591 	struct v4l2_fract       pixelaspect;
    592 };
    593 
    594 struct v4l2_crop {
    595 	enum v4l2_buf_type      type;
    596 	struct v4l2_rect        c;
    597 };
    598 
    599 /*
    600  *      A N A L O G   V I D E O   S T A N D A R D
    601  */
    602 
    603 typedef __u64 v4l2_std_id;
    604 
    605 /* one bit for each */
    606 #define V4L2_STD_PAL_B          ((v4l2_std_id)0x00000001)
    607 #define V4L2_STD_PAL_B1         ((v4l2_std_id)0x00000002)
    608 #define V4L2_STD_PAL_G          ((v4l2_std_id)0x00000004)
    609 #define V4L2_STD_PAL_H          ((v4l2_std_id)0x00000008)
    610 #define V4L2_STD_PAL_I          ((v4l2_std_id)0x00000010)
    611 #define V4L2_STD_PAL_D          ((v4l2_std_id)0x00000020)
    612 #define V4L2_STD_PAL_D1         ((v4l2_std_id)0x00000040)
    613 #define V4L2_STD_PAL_K          ((v4l2_std_id)0x00000080)
    614 
    615 #define V4L2_STD_PAL_M          ((v4l2_std_id)0x00000100)
    616 #define V4L2_STD_PAL_N          ((v4l2_std_id)0x00000200)
    617 #define V4L2_STD_PAL_Nc         ((v4l2_std_id)0x00000400)
    618 #define V4L2_STD_PAL_60         ((v4l2_std_id)0x00000800)
    619 
    620 #define V4L2_STD_NTSC_M         ((v4l2_std_id)0x00001000)
    621 #define V4L2_STD_NTSC_M_JP      ((v4l2_std_id)0x00002000)
    622 #define V4L2_STD_NTSC_443       ((v4l2_std_id)0x00004000)
    623 #define V4L2_STD_NTSC_M_KR      ((v4l2_std_id)0x00008000)
    624 
    625 #define V4L2_STD_SECAM_B        ((v4l2_std_id)0x00010000)
    626 #define V4L2_STD_SECAM_D        ((v4l2_std_id)0x00020000)
    627 #define V4L2_STD_SECAM_G        ((v4l2_std_id)0x00040000)
    628 #define V4L2_STD_SECAM_H        ((v4l2_std_id)0x00080000)
    629 #define V4L2_STD_SECAM_K        ((v4l2_std_id)0x00100000)
    630 #define V4L2_STD_SECAM_K1       ((v4l2_std_id)0x00200000)
    631 #define V4L2_STD_SECAM_L        ((v4l2_std_id)0x00400000)
    632 #define V4L2_STD_SECAM_LC       ((v4l2_std_id)0x00800000)
    633 
    634 /* ATSC/HDTV */
    635 #define V4L2_STD_ATSC_8_VSB     ((v4l2_std_id)0x01000000)
    636 #define V4L2_STD_ATSC_16_VSB    ((v4l2_std_id)0x02000000)
    637 
    638 /* FIXME:
    639    Although std_id is 64 bits, there is an issue on PPC32 architecture that
    640    makes switch(__u64) to break. So, there's a hack on v4l2-common.c rounding
    641    this value to 32 bits.
    642    As, currently, the max value is for V4L2_STD_ATSC_16_VSB (30 bits wide),
    643    it should work fine. However, if needed to add more than two standards,
    644    v4l2-common.c should be fixed.
    645  */
    646 
    647 /* some merged standards */
    648 #define V4L2_STD_MN	(V4L2_STD_PAL_M|V4L2_STD_PAL_N|V4L2_STD_PAL_Nc|V4L2_STD_NTSC)
    649 #define V4L2_STD_B	(V4L2_STD_PAL_B|V4L2_STD_PAL_B1|V4L2_STD_SECAM_B)
    650 #define V4L2_STD_GH	(V4L2_STD_PAL_G|V4L2_STD_PAL_H|V4L2_STD_SECAM_G|V4L2_STD_SECAM_H)
    651 #define V4L2_STD_DK	(V4L2_STD_PAL_DK|V4L2_STD_SECAM_DK)
    652 
    653 /* some common needed stuff */
    654 #define V4L2_STD_PAL_BG		(V4L2_STD_PAL_B		|\
    655 				 V4L2_STD_PAL_B1	|\
    656 				 V4L2_STD_PAL_G)
    657 #define V4L2_STD_PAL_DK		(V4L2_STD_PAL_D		|\
    658 				 V4L2_STD_PAL_D1	|\
    659 				 V4L2_STD_PAL_K)
    660 #define V4L2_STD_PAL		(V4L2_STD_PAL_BG	|\
    661 				 V4L2_STD_PAL_DK	|\
    662 				 V4L2_STD_PAL_H		|\
    663 				 V4L2_STD_PAL_I)
    664 #define V4L2_STD_NTSC           (V4L2_STD_NTSC_M	|\
    665 				 V4L2_STD_NTSC_M_JP     |\
    666 				 V4L2_STD_NTSC_M_KR)
    667 #define V4L2_STD_SECAM_DK      	(V4L2_STD_SECAM_D	|\
    668 				 V4L2_STD_SECAM_K	|\
    669 				 V4L2_STD_SECAM_K1)
    670 #define V4L2_STD_SECAM		(V4L2_STD_SECAM_B	|\
    671 				 V4L2_STD_SECAM_G	|\
    672 				 V4L2_STD_SECAM_H	|\
    673 				 V4L2_STD_SECAM_DK	|\
    674 				 V4L2_STD_SECAM_L       |\
    675 				 V4L2_STD_SECAM_LC)
    676 
    677 #define V4L2_STD_525_60		(V4L2_STD_PAL_M		|\
    678 				 V4L2_STD_PAL_60	|\
    679 				 V4L2_STD_NTSC		|\
    680 				 V4L2_STD_NTSC_443)
    681 #define V4L2_STD_625_50		(V4L2_STD_PAL		|\
    682 				 V4L2_STD_PAL_N		|\
    683 				 V4L2_STD_PAL_Nc	|\
    684 				 V4L2_STD_SECAM)
    685 #define V4L2_STD_ATSC           (V4L2_STD_ATSC_8_VSB    |\
    686 				 V4L2_STD_ATSC_16_VSB)
    687 
    688 #define V4L2_STD_UNKNOWN        0
    689 #define V4L2_STD_ALL            (V4L2_STD_525_60	|\
    690 				 V4L2_STD_625_50)
    691 
    692 struct v4l2_standard
    693 {
    694 	__u32		     index;
    695 	v4l2_std_id          id;
    696 	__u8		     name[24];
    697 	struct v4l2_fract    frameperiod; /* Frames, not fields */
    698 	__u32		     framelines;
    699 	__u32		     reserved[4];
    700 };
    701 
    702 /*
    703  *	V I D E O   I N P U T S
    704  */
    705 struct v4l2_input
    706 {
    707 	__u32	     index;		/*  Which input */
    708 	__u8	     name[32];		/*  Label */
    709 	__u32	     type;		/*  Type of input */
    710 	__u32	     audioset;		/*  Associated audios (bitfield) */
    711 	__u32        tuner;             /*  Associated tuner */
    712 	v4l2_std_id  std;
    713 	__u32	     status;
    714 	__u32	     reserved[4];
    715 };
    716 
    717 /*  Values for the 'type' field */
    718 #define V4L2_INPUT_TYPE_TUNER		1
    719 #define V4L2_INPUT_TYPE_CAMERA		2
    720 
    721 /* field 'status' - general */
    722 #define V4L2_IN_ST_NO_POWER    0x00000001  /* Attached device is off */
    723 #define V4L2_IN_ST_NO_SIGNAL   0x00000002
    724 #define V4L2_IN_ST_NO_COLOR    0x00000004
    725 
    726 /* field 'status' - analog */
    727 #define V4L2_IN_ST_NO_H_LOCK   0x00000100  /* No horizontal sync lock */
    728 #define V4L2_IN_ST_COLOR_KILL  0x00000200  /* Color killer is active */
    729 
    730 /* field 'status' - digital */
    731 #define V4L2_IN_ST_NO_SYNC     0x00010000  /* No synchronization lock */
    732 #define V4L2_IN_ST_NO_EQU      0x00020000  /* No equalizer lock */
    733 #define V4L2_IN_ST_NO_CARRIER  0x00040000  /* Carrier recovery failed */
    734 
    735 /* field 'status' - VCR and set-top box */
    736 #define V4L2_IN_ST_MACROVISION 0x01000000  /* Macrovision detected */
    737 #define V4L2_IN_ST_NO_ACCESS   0x02000000  /* Conditional access denied */
    738 #define V4L2_IN_ST_VTR         0x04000000  /* VTR time constant */
    739 
    740 /*
    741  *	V I D E O   O U T P U T S
    742  */
    743 struct v4l2_output
    744 {
    745 	__u32	     index;		/*  Which output */
    746 	__u8	     name[32];		/*  Label */
    747 	__u32	     type;		/*  Type of output */
    748 	__u32	     audioset;		/*  Associated audios (bitfield) */
    749 	__u32	     modulator;         /*  Associated modulator */
    750 	v4l2_std_id  std;
    751 	__u32	     reserved[4];
    752 };
    753 /*  Values for the 'type' field */
    754 #define V4L2_OUTPUT_TYPE_MODULATOR		1
    755 #define V4L2_OUTPUT_TYPE_ANALOG			2
    756 #define V4L2_OUTPUT_TYPE_ANALOGVGAOVERLAY	3
    757 
    758 /*
    759  *	C O N T R O L S
    760  */
    761 struct v4l2_control
    762 {
    763 	__u32		     id;
    764 	__s32		     value;
    765 };
    766 
    767 struct v4l2_ext_control
    768 {
    769 	__u32 id;
    770 	__u32 reserved2[2];
    771 	union {
    772 		__s32 value;
    773 		__s64 value64;
    774 		void *reserved;
    775 	};
    776 } __attribute__ ((packed));
    777 
    778 struct v4l2_ext_controls
    779 {
    780 	__u32 ctrl_class;
    781 	__u32 count;
    782 	__u32 error_idx;
    783 	__u32 reserved[2];
    784 	struct v4l2_ext_control *controls;
    785 };
    786 
    787 /*  Values for ctrl_class field */
    788 #define V4L2_CTRL_CLASS_USER 0x00980000	/* Old-style 'user' controls */
    789 #define V4L2_CTRL_CLASS_MPEG 0x00990000	/* MPEG-compression controls */
    790 
    791 #define V4L2_CTRL_ID_MASK      	  (0x0fffffff)
    792 #define V4L2_CTRL_ID2CLASS(id)    ((id) & 0x0fff0000UL)
    793 #define V4L2_CTRL_DRIVER_PRIV(id) (((id) & 0xffff) >= 0x1000)
    794 
    795 /*  Used in the VIDIOC_QUERYCTRL ioctl for querying controls */
    796 struct v4l2_queryctrl
    797 {
    798 	__u32		     id;
    799 	enum v4l2_ctrl_type  type;
    800 	__u8		     name[32];	/* Whatever */
    801 	__s32		     minimum;	/* Note signedness */
    802 	__s32		     maximum;
    803 	__s32		     step;
    804 	__s32		     default_value;
    805 	__u32                flags;
    806 	__u32		     reserved[2];
    807 };
    808 
    809 /*  Used in the VIDIOC_QUERYMENU ioctl for querying menu items */
    810 struct v4l2_querymenu
    811 {
    812 	__u32		id;
    813 	__u32		index;
    814 	__u8		name[32];	/* Whatever */
    815 	__u32		reserved;
    816 };
    817 
    818 /*  Control flags  */
    819 #define V4L2_CTRL_FLAG_DISABLED		0x0001
    820 #define V4L2_CTRL_FLAG_GRABBED		0x0002
    821 #define V4L2_CTRL_FLAG_READ_ONLY 	0x0004
    822 #define V4L2_CTRL_FLAG_UPDATE 		0x0008
    823 #define V4L2_CTRL_FLAG_INACTIVE 	0x0010
    824 #define V4L2_CTRL_FLAG_SLIDER 		0x0020
    825 
    826 /*  Query flag, to be ORed with the control ID */
    827 #define V4L2_CTRL_FLAG_NEXT_CTRL	0x80000000
    828 
    829 /*  User-class control IDs defined by V4L2 */
    830 #define V4L2_CID_BASE			(V4L2_CTRL_CLASS_USER | 0x900)
    831 #define V4L2_CID_USER_BASE 		V4L2_CID_BASE
    832 /*  IDs reserved for driver specific controls */
    833 #define V4L2_CID_PRIVATE_BASE		0x08000000
    834 
    835 #define V4L2_CID_USER_CLASS 		(V4L2_CTRL_CLASS_USER | 1)
    836 #define V4L2_CID_BRIGHTNESS		(V4L2_CID_BASE+0)
    837 #define V4L2_CID_CONTRAST		(V4L2_CID_BASE+1)
    838 #define V4L2_CID_SATURATION		(V4L2_CID_BASE+2)
    839 #define V4L2_CID_HUE			(V4L2_CID_BASE+3)
    840 #define V4L2_CID_AUDIO_VOLUME		(V4L2_CID_BASE+5)
    841 #define V4L2_CID_AUDIO_BALANCE		(V4L2_CID_BASE+6)
    842 #define V4L2_CID_AUDIO_BASS		(V4L2_CID_BASE+7)
    843 #define V4L2_CID_AUDIO_TREBLE		(V4L2_CID_BASE+8)
    844 #define V4L2_CID_AUDIO_MUTE		(V4L2_CID_BASE+9)
    845 #define V4L2_CID_AUDIO_LOUDNESS		(V4L2_CID_BASE+10)
    846 #define V4L2_CID_BLACK_LEVEL		(V4L2_CID_BASE+11)
    847 #define V4L2_CID_AUTO_WHITE_BALANCE	(V4L2_CID_BASE+12)
    848 #define V4L2_CID_DO_WHITE_BALANCE	(V4L2_CID_BASE+13)
    849 #define V4L2_CID_RED_BALANCE		(V4L2_CID_BASE+14)
    850 #define V4L2_CID_BLUE_BALANCE		(V4L2_CID_BASE+15)
    851 #define V4L2_CID_GAMMA			(V4L2_CID_BASE+16)
    852 #define V4L2_CID_WHITENESS		(V4L2_CID_GAMMA) /* ? Not sure */
    853 #define V4L2_CID_EXPOSURE		(V4L2_CID_BASE+17)
    854 #define V4L2_CID_AUTOGAIN		(V4L2_CID_BASE+18)
    855 #define V4L2_CID_GAIN			(V4L2_CID_BASE+19)
    856 #define V4L2_CID_HFLIP			(V4L2_CID_BASE+20)
    857 #define V4L2_CID_VFLIP			(V4L2_CID_BASE+21)
    858 #define V4L2_CID_HCENTER		(V4L2_CID_BASE+22)
    859 #define V4L2_CID_VCENTER		(V4L2_CID_BASE+23)
    860 #define V4L2_CID_LASTP1			(V4L2_CID_BASE+24) /* last CID + 1 */
    861 
    862 /*  MPEG-class control IDs defined by V4L2 */
    863 #define V4L2_CID_MPEG_BASE 			(V4L2_CTRL_CLASS_MPEG | 0x900)
    864 #define V4L2_CID_MPEG_CLASS 			(V4L2_CTRL_CLASS_MPEG | 1)
    865 
    866 /*  MPEG streams */
    867 #define V4L2_CID_MPEG_STREAM_TYPE 		(V4L2_CID_MPEG_BASE+0)
    868 enum v4l2_mpeg_stream_type {
    869 	V4L2_MPEG_STREAM_TYPE_MPEG2_PS   = 0, /* MPEG-2 program stream */
    870 	V4L2_MPEG_STREAM_TYPE_MPEG2_TS   = 1, /* MPEG-2 transport stream */
    871 	V4L2_MPEG_STREAM_TYPE_MPEG1_SS   = 2, /* MPEG-1 system stream */
    872 	V4L2_MPEG_STREAM_TYPE_MPEG2_DVD  = 3, /* MPEG-2 DVD-compatible stream */
    873 	V4L2_MPEG_STREAM_TYPE_MPEG1_VCD  = 4, /* MPEG-1 VCD-compatible stream */
    874 	V4L2_MPEG_STREAM_TYPE_MPEG2_SVCD = 5, /* MPEG-2 SVCD-compatible stream */
    875 };
    876 #define V4L2_CID_MPEG_STREAM_PID_PMT 		(V4L2_CID_MPEG_BASE+1)
    877 #define V4L2_CID_MPEG_STREAM_PID_AUDIO 		(V4L2_CID_MPEG_BASE+2)
    878 #define V4L2_CID_MPEG_STREAM_PID_VIDEO 		(V4L2_CID_MPEG_BASE+3)
    879 #define V4L2_CID_MPEG_STREAM_PID_PCR 		(V4L2_CID_MPEG_BASE+4)
    880 #define V4L2_CID_MPEG_STREAM_PES_ID_AUDIO 	(V4L2_CID_MPEG_BASE+5)
    881 #define V4L2_CID_MPEG_STREAM_PES_ID_VIDEO 	(V4L2_CID_MPEG_BASE+6)
    882 #define V4L2_CID_MPEG_STREAM_VBI_FMT 		(V4L2_CID_MPEG_BASE+7)
    883 enum v4l2_mpeg_stream_vbi_fmt {
    884 	V4L2_MPEG_STREAM_VBI_FMT_NONE = 0,  /* No VBI in the MPEG stream */
    885 	V4L2_MPEG_STREAM_VBI_FMT_IVTV = 1,  /* VBI in private packets, IVTV format */
    886 };
    887 
    888 /*  MPEG audio */
    889 #define V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ 	(V4L2_CID_MPEG_BASE+100)
    890 enum v4l2_mpeg_audio_sampling_freq {
    891 	V4L2_MPEG_AUDIO_SAMPLING_FREQ_44100 = 0,
    892 	V4L2_MPEG_AUDIO_SAMPLING_FREQ_48000 = 1,
    893 	V4L2_MPEG_AUDIO_SAMPLING_FREQ_32000 = 2,
    894 };
    895 #define V4L2_CID_MPEG_AUDIO_ENCODING 		(V4L2_CID_MPEG_BASE+101)
    896 enum v4l2_mpeg_audio_encoding {
    897 	V4L2_MPEG_AUDIO_ENCODING_LAYER_1 = 0,
    898 	V4L2_MPEG_AUDIO_ENCODING_LAYER_2 = 1,
    899 	V4L2_MPEG_AUDIO_ENCODING_LAYER_3 = 2,
    900 };
    901 #define V4L2_CID_MPEG_AUDIO_L1_BITRATE 		(V4L2_CID_MPEG_BASE+102)
    902 enum v4l2_mpeg_audio_l1_bitrate {
    903 	V4L2_MPEG_AUDIO_L1_BITRATE_32K  = 0,
    904 	V4L2_MPEG_AUDIO_L1_BITRATE_64K  = 1,
    905 	V4L2_MPEG_AUDIO_L1_BITRATE_96K  = 2,
    906 	V4L2_MPEG_AUDIO_L1_BITRATE_128K = 3,
    907 	V4L2_MPEG_AUDIO_L1_BITRATE_160K = 4,
    908 	V4L2_MPEG_AUDIO_L1_BITRATE_192K = 5,
    909 	V4L2_MPEG_AUDIO_L1_BITRATE_224K = 6,
    910 	V4L2_MPEG_AUDIO_L1_BITRATE_256K = 7,
    911 	V4L2_MPEG_AUDIO_L1_BITRATE_288K = 8,
    912 	V4L2_MPEG_AUDIO_L1_BITRATE_320K = 9,
    913 	V4L2_MPEG_AUDIO_L1_BITRATE_352K = 10,
    914 	V4L2_MPEG_AUDIO_L1_BITRATE_384K = 11,
    915 	V4L2_MPEG_AUDIO_L1_BITRATE_416K = 12,
    916 	V4L2_MPEG_AUDIO_L1_BITRATE_448K = 13,
    917 };
    918 #define V4L2_CID_MPEG_AUDIO_L2_BITRATE 		(V4L2_CID_MPEG_BASE+103)
    919 enum v4l2_mpeg_audio_l2_bitrate {
    920 	V4L2_MPEG_AUDIO_L2_BITRATE_32K  = 0,
    921 	V4L2_MPEG_AUDIO_L2_BITRATE_48K  = 1,
    922 	V4L2_MPEG_AUDIO_L2_BITRATE_56K  = 2,
    923 	V4L2_MPEG_AUDIO_L2_BITRATE_64K  = 3,
    924 	V4L2_MPEG_AUDIO_L2_BITRATE_80K  = 4,
    925 	V4L2_MPEG_AUDIO_L2_BITRATE_96K  = 5,
    926 	V4L2_MPEG_AUDIO_L2_BITRATE_112K = 6,
    927 	V4L2_MPEG_AUDIO_L2_BITRATE_128K = 7,
    928 	V4L2_MPEG_AUDIO_L2_BITRATE_160K = 8,
    929 	V4L2_MPEG_AUDIO_L2_BITRATE_192K = 9,
    930 	V4L2_MPEG_AUDIO_L2_BITRATE_224K = 10,
    931 	V4L2_MPEG_AUDIO_L2_BITRATE_256K = 11,
    932 	V4L2_MPEG_AUDIO_L2_BITRATE_320K = 12,
    933 	V4L2_MPEG_AUDIO_L2_BITRATE_384K = 13,
    934 };
    935 #define V4L2_CID_MPEG_AUDIO_L3_BITRATE 		(V4L2_CID_MPEG_BASE+104)
    936 enum v4l2_mpeg_audio_l3_bitrate {
    937 	V4L2_MPEG_AUDIO_L3_BITRATE_32K  = 0,
    938 	V4L2_MPEG_AUDIO_L3_BITRATE_40K  = 1,
    939 	V4L2_MPEG_AUDIO_L3_BITRATE_48K  = 2,
    940 	V4L2_MPEG_AUDIO_L3_BITRATE_56K  = 3,
    941 	V4L2_MPEG_AUDIO_L3_BITRATE_64K  = 4,
    942 	V4L2_MPEG_AUDIO_L3_BITRATE_80K  = 5,
    943 	V4L2_MPEG_AUDIO_L3_BITRATE_96K  = 6,
    944 	V4L2_MPEG_AUDIO_L3_BITRATE_112K = 7,
    945 	V4L2_MPEG_AUDIO_L3_BITRATE_128K = 8,
    946 	V4L2_MPEG_AUDIO_L3_BITRATE_160K = 9,
    947 	V4L2_MPEG_AUDIO_L3_BITRATE_192K = 10,
    948 	V4L2_MPEG_AUDIO_L3_BITRATE_224K = 11,
    949 	V4L2_MPEG_AUDIO_L3_BITRATE_256K = 12,
    950 	V4L2_MPEG_AUDIO_L3_BITRATE_320K = 13,
    951 };
    952 #define V4L2_CID_MPEG_AUDIO_MODE 		(V4L2_CID_MPEG_BASE+105)
    953 enum v4l2_mpeg_audio_mode {
    954 	V4L2_MPEG_AUDIO_MODE_STEREO       = 0,
    955 	V4L2_MPEG_AUDIO_MODE_JOINT_STEREO = 1,
    956 	V4L2_MPEG_AUDIO_MODE_DUAL         = 2,
    957 	V4L2_MPEG_AUDIO_MODE_MONO         = 3,
    958 };
    959 #define V4L2_CID_MPEG_AUDIO_MODE_EXTENSION 	(V4L2_CID_MPEG_BASE+106)
    960 enum v4l2_mpeg_audio_mode_extension {
    961 	V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_4  = 0,
    962 	V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_8  = 1,
    963 	V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_12 = 2,
    964 	V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_16 = 3,
    965 };
    966 #define V4L2_CID_MPEG_AUDIO_EMPHASIS 		(V4L2_CID_MPEG_BASE+107)
    967 enum v4l2_mpeg_audio_emphasis {
    968 	V4L2_MPEG_AUDIO_EMPHASIS_NONE         = 0,
    969 	V4L2_MPEG_AUDIO_EMPHASIS_50_DIV_15_uS = 1,
    970 	V4L2_MPEG_AUDIO_EMPHASIS_CCITT_J17    = 2,
    971 };
    972 #define V4L2_CID_MPEG_AUDIO_CRC 		(V4L2_CID_MPEG_BASE+108)
    973 enum v4l2_mpeg_audio_crc {
    974 	V4L2_MPEG_AUDIO_CRC_NONE  = 0,
    975 	V4L2_MPEG_AUDIO_CRC_CRC16 = 1,
    976 };
    977 #define V4L2_CID_MPEG_AUDIO_MUTE 		(V4L2_CID_MPEG_BASE+109)
    978 
    979 /*  MPEG video */
    980 #define V4L2_CID_MPEG_VIDEO_ENCODING 		(V4L2_CID_MPEG_BASE+200)
    981 enum v4l2_mpeg_video_encoding {
    982 	V4L2_MPEG_VIDEO_ENCODING_MPEG_1 = 0,
    983 	V4L2_MPEG_VIDEO_ENCODING_MPEG_2 = 1,
    984 };
    985 #define V4L2_CID_MPEG_VIDEO_ASPECT 		(V4L2_CID_MPEG_BASE+201)
    986 enum v4l2_mpeg_video_aspect {
    987 	V4L2_MPEG_VIDEO_ASPECT_1x1     = 0,
    988 	V4L2_MPEG_VIDEO_ASPECT_4x3     = 1,
    989 	V4L2_MPEG_VIDEO_ASPECT_16x9    = 2,
    990 	V4L2_MPEG_VIDEO_ASPECT_221x100 = 3,
    991 };
    992 #define V4L2_CID_MPEG_VIDEO_B_FRAMES 		(V4L2_CID_MPEG_BASE+202)
    993 #define V4L2_CID_MPEG_VIDEO_GOP_SIZE 		(V4L2_CID_MPEG_BASE+203)
    994 #define V4L2_CID_MPEG_VIDEO_GOP_CLOSURE 	(V4L2_CID_MPEG_BASE+204)
    995 #define V4L2_CID_MPEG_VIDEO_PULLDOWN 		(V4L2_CID_MPEG_BASE+205)
    996 #define V4L2_CID_MPEG_VIDEO_BITRATE_MODE 	(V4L2_CID_MPEG_BASE+206)
    997 enum v4l2_mpeg_video_bitrate_mode {
    998 	V4L2_MPEG_VIDEO_BITRATE_MODE_VBR = 0,
    999 	V4L2_MPEG_VIDEO_BITRATE_MODE_CBR = 1,
   1000 };
   1001 #define V4L2_CID_MPEG_VIDEO_BITRATE 		(V4L2_CID_MPEG_BASE+207)
   1002 #define V4L2_CID_MPEG_VIDEO_BITRATE_PEAK 	(V4L2_CID_MPEG_BASE+208)
   1003 #define V4L2_CID_MPEG_VIDEO_TEMPORAL_DECIMATION (V4L2_CID_MPEG_BASE+209)
   1004 #define V4L2_CID_MPEG_VIDEO_MUTE 		(V4L2_CID_MPEG_BASE+210)
   1005 #define V4L2_CID_MPEG_VIDEO_MUTE_YUV 		(V4L2_CID_MPEG_BASE+211)
   1006 
   1007 /*  MPEG-class control IDs specific to the CX2584x driver as defined by V4L2 */
   1008 #define V4L2_CID_MPEG_CX2341X_BASE 				(V4L2_CTRL_CLASS_MPEG | 0x1000)
   1009 #define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE 	(V4L2_CID_MPEG_CX2341X_BASE+0)
   1010 enum v4l2_mpeg_cx2341x_video_spatial_filter_mode {
   1011 	V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_MANUAL = 0,
   1012 	V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_AUTO   = 1,
   1013 };
   1014 #define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER 		(V4L2_CID_MPEG_CX2341X_BASE+1)
   1015 #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE 	(V4L2_CID_MPEG_CX2341X_BASE+2)
   1016 enum v4l2_mpeg_cx2341x_video_luma_spatial_filter_type {
   1017 	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_OFF                  = 0,
   1018 	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_HOR               = 1,
   1019 	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_VERT              = 2,
   1020 	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_HV_SEPARABLE      = 3,
   1021 	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_SYM_NON_SEPARABLE = 4,
   1022 };
   1023 #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE 	(V4L2_CID_MPEG_CX2341X_BASE+3)
   1024 enum v4l2_mpeg_cx2341x_video_chroma_spatial_filter_type {
   1025 	V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_OFF    = 0,
   1026 	V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_1D_HOR = 1,
   1027 };
   1028 #define V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE 	(V4L2_CID_MPEG_CX2341X_BASE+4)
   1029 enum v4l2_mpeg_cx2341x_video_temporal_filter_mode {
   1030 	V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_MANUAL = 0,
   1031 	V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_AUTO   = 1,
   1032 };
   1033 #define V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER 		(V4L2_CID_MPEG_CX2341X_BASE+5)
   1034 #define V4L2_CID_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE 		(V4L2_CID_MPEG_CX2341X_BASE+6)
   1035 enum v4l2_mpeg_cx2341x_video_median_filter_type {
   1036 	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_OFF      = 0,
   1037 	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR      = 1,
   1038 	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_VERT     = 2,
   1039 	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR_VERT = 3,
   1040 	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_DIAG     = 4,
   1041 };
   1042 #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_BOTTOM 	(V4L2_CID_MPEG_CX2341X_BASE+7)
   1043 #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_TOP 	(V4L2_CID_MPEG_CX2341X_BASE+8)
   1044 #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_BOTTOM	(V4L2_CID_MPEG_CX2341X_BASE+9)
   1045 #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_TOP 	(V4L2_CID_MPEG_CX2341X_BASE+10)
   1046 #define V4L2_CID_MPEG_CX2341X_STREAM_INSERT_NAV_PACKETS 	(V4L2_CID_MPEG_CX2341X_BASE+11)
   1047 
   1048 /*
   1049  *	T U N I N G
   1050  */
   1051 struct v4l2_tuner
   1052 {
   1053 	__u32                   index;
   1054 	__u8			name[32];
   1055 	enum v4l2_tuner_type    type;
   1056 	__u32			capability;
   1057 	__u32			rangelow;
   1058 	__u32			rangehigh;
   1059 	__u32			rxsubchans;
   1060 	__u32			audmode;
   1061 	__s32			signal;
   1062 	__s32			afc;
   1063 	__u32			reserved[4];
   1064 };
   1065 
   1066 struct v4l2_modulator
   1067 {
   1068 	__u32			index;
   1069 	__u8			name[32];
   1070 	__u32			capability;
   1071 	__u32			rangelow;
   1072 	__u32			rangehigh;
   1073 	__u32			txsubchans;
   1074 	__u32			reserved[4];
   1075 };
   1076 
   1077 /*  Flags for the 'capability' field */
   1078 #define V4L2_TUNER_CAP_LOW		0x0001
   1079 #define V4L2_TUNER_CAP_NORM		0x0002
   1080 #define V4L2_TUNER_CAP_STEREO		0x0010
   1081 #define V4L2_TUNER_CAP_LANG2		0x0020
   1082 #define V4L2_TUNER_CAP_SAP		0x0020
   1083 #define V4L2_TUNER_CAP_LANG1		0x0040
   1084 
   1085 /*  Flags for the 'rxsubchans' field */
   1086 #define V4L2_TUNER_SUB_MONO		0x0001
   1087 #define V4L2_TUNER_SUB_STEREO		0x0002
   1088 #define V4L2_TUNER_SUB_LANG2		0x0004
   1089 #define V4L2_TUNER_SUB_SAP		0x0004
   1090 #define V4L2_TUNER_SUB_LANG1		0x0008
   1091 
   1092 /*  Values for the 'audmode' field */
   1093 #define V4L2_TUNER_MODE_MONO		0x0000
   1094 #define V4L2_TUNER_MODE_STEREO		0x0001
   1095 #define V4L2_TUNER_MODE_LANG2		0x0002
   1096 #define V4L2_TUNER_MODE_SAP		0x0002
   1097 #define V4L2_TUNER_MODE_LANG1		0x0003
   1098 #define V4L2_TUNER_MODE_LANG1_LANG2	0x0004
   1099 
   1100 struct v4l2_frequency
   1101 {
   1102 	__u32		      tuner;
   1103 	enum v4l2_tuner_type  type;
   1104 	__u32		      frequency;
   1105 	__u32		      reserved[8];
   1106 };
   1107 
   1108 /*
   1109  *	A U D I O
   1110  */
   1111 struct v4l2_audio
   1112 {
   1113 	__u32	index;
   1114 	__u8	name[32];
   1115 	__u32	capability;
   1116 	__u32	mode;
   1117 	__u32	reserved[2];
   1118 };
   1119 
   1120 /*  Flags for the 'capability' field */
   1121 #define V4L2_AUDCAP_STEREO		0x00001
   1122 #define V4L2_AUDCAP_AVL			0x00002
   1123 
   1124 /*  Flags for the 'mode' field */
   1125 #define V4L2_AUDMODE_AVL		0x00001
   1126 
   1127 struct v4l2_audioout
   1128 {
   1129 	__u32	index;
   1130 	__u8	name[32];
   1131 	__u32	capability;
   1132 	__u32	mode;
   1133 	__u32	reserved[2];
   1134 };
   1135 
   1136 /*
   1137  *	M P E G   S E R V I C E S
   1138  *
   1139  *	NOTE: EXPERIMENTAL API
   1140  */
   1141 #if 1
   1142 #define V4L2_ENC_IDX_FRAME_I    (0)
   1143 #define V4L2_ENC_IDX_FRAME_P    (1)
   1144 #define V4L2_ENC_IDX_FRAME_B    (2)
   1145 #define V4L2_ENC_IDX_FRAME_MASK (0xf)
   1146 
   1147 struct v4l2_enc_idx_entry {
   1148 	__u64 offset;
   1149 	__u64 pts;
   1150 	__u32 length;
   1151 	__u32 flags;
   1152 	__u32 reserved[2];
   1153 };
   1154 
   1155 #define V4L2_ENC_IDX_ENTRIES (64)
   1156 struct v4l2_enc_idx {
   1157 	__u32 entries;
   1158 	__u32 entries_cap;
   1159 	__u32 reserved[4];
   1160 	struct v4l2_enc_idx_entry entry[V4L2_ENC_IDX_ENTRIES];
   1161 };
   1162 
   1163 
   1164 #define V4L2_ENC_CMD_START      (0)
   1165 #define V4L2_ENC_CMD_STOP       (1)
   1166 #define V4L2_ENC_CMD_PAUSE      (2)
   1167 #define V4L2_ENC_CMD_RESUME     (3)
   1168 
   1169 /* Flags for V4L2_ENC_CMD_STOP */
   1170 #define V4L2_ENC_CMD_STOP_AT_GOP_END    (1 << 0)
   1171 
   1172 struct v4l2_encoder_cmd {
   1173 	__u32 cmd;
   1174 	__u32 flags;
   1175 	union {
   1176 		struct {
   1177 			__u32 data[8];
   1178 		} raw;
   1179 	};
   1180 };
   1181 
   1182 #endif
   1183 
   1184 
   1185 /*
   1186  *	D A T A   S E R V I C E S   ( V B I )
   1187  *
   1188  *	Data services API by Michael Schimek
   1189  */
   1190 
   1191 /* Raw VBI */
   1192 struct v4l2_vbi_format
   1193 {
   1194 	__u32	sampling_rate;		/* in 1 Hz */
   1195 	__u32	offset;
   1196 	__u32	samples_per_line;
   1197 	__u32	sample_format;		/* V4L2_PIX_FMT_* */
   1198 	__s32	start[2];
   1199 	__u32	count[2];
   1200 	__u32	flags;			/* V4L2_VBI_* */
   1201 	__u32	reserved[2];		/* must be zero */
   1202 };
   1203 
   1204 /*  VBI flags  */
   1205 #define V4L2_VBI_UNSYNC		(1<< 0)
   1206 #define V4L2_VBI_INTERLACED	(1<< 1)
   1207 
   1208 /* Sliced VBI
   1209  *
   1210  *    This implements is a proposal V4L2 API to allow SLICED VBI
   1211  * required for some hardware encoders. It should change without
   1212  * notice in the definitive implementation.
   1213  */
   1214 
   1215 struct v4l2_sliced_vbi_format
   1216 {
   1217 	__u16   service_set;
   1218 	/* service_lines[0][...] specifies lines 0-23 (1-23 used) of the first field
   1219 	   service_lines[1][...] specifies lines 0-23 (1-23 used) of the second field
   1220 				 (equals frame lines 313-336 for 625 line video
   1221 				  standards, 263-286 for 525 line standards) */
   1222 	__u16   service_lines[2][24];
   1223 	__u32   io_size;
   1224 	__u32   reserved[2];            /* must be zero */
   1225 };
   1226 
   1227 /* Teletext World System Teletext
   1228    (WST), defined on ITU-R BT.653-2 */
   1229 #define V4L2_SLICED_TELETEXT_B          (0x0001)
   1230 /* Video Program System, defined on ETS 300 231*/
   1231 #define V4L2_SLICED_VPS                 (0x0400)
   1232 /* Closed Caption, defined on EIA-608 */
   1233 #define V4L2_SLICED_CAPTION_525         (0x1000)
   1234 /* Wide Screen System, defined on ITU-R BT1119.1 */
   1235 #define V4L2_SLICED_WSS_625             (0x4000)
   1236 
   1237 #define V4L2_SLICED_VBI_525             (V4L2_SLICED_CAPTION_525)
   1238 #define V4L2_SLICED_VBI_625             (V4L2_SLICED_TELETEXT_B | V4L2_SLICED_VPS | V4L2_SLICED_WSS_625)
   1239 
   1240 struct v4l2_sliced_vbi_cap
   1241 {
   1242 	__u16   service_set;
   1243 	/* service_lines[0][...] specifies lines 0-23 (1-23 used) of the first field
   1244 	   service_lines[1][...] specifies lines 0-23 (1-23 used) of the second field
   1245 				 (equals frame lines 313-336 for 625 line video
   1246 				  standards, 263-286 for 525 line standards) */
   1247 	__u16   service_lines[2][24];
   1248 	enum v4l2_buf_type type;
   1249 	__u32   reserved[3];    /* must be 0 */
   1250 };
   1251 
   1252 struct v4l2_sliced_vbi_data
   1253 {
   1254 	__u32   id;
   1255 	__u32   field;          /* 0: first field, 1: second field */
   1256 	__u32   line;           /* 1-23 */
   1257 	__u32   reserved;       /* must be 0 */
   1258 	__u8    data[48];
   1259 };
   1260 
   1261 /*
   1262  *	A G G R E G A T E   S T R U C T U R E S
   1263  */
   1264 
   1265 /*	Stream data format
   1266  */
   1267 struct v4l2_format
   1268 {
   1269 	enum v4l2_buf_type type;
   1270 	union
   1271 	{
   1272 		struct v4l2_pix_format		pix;     // V4L2_BUF_TYPE_VIDEO_CAPTURE
   1273 		struct v4l2_window		win;     // V4L2_BUF_TYPE_VIDEO_OVERLAY
   1274 		struct v4l2_vbi_format		vbi;     // V4L2_BUF_TYPE_VBI_CAPTURE
   1275 		struct v4l2_sliced_vbi_format	sliced;  // V4L2_BUF_TYPE_SLICED_VBI_CAPTURE
   1276 		__u8	raw_data[200];                   // user-defined
   1277 	} fmt;
   1278 };
   1279 
   1280 
   1281 /*	Stream type-dependent parameters
   1282  */
   1283 struct v4l2_streamparm
   1284 {
   1285 	enum v4l2_buf_type type;
   1286 	union
   1287 	{
   1288 		struct v4l2_captureparm	capture;
   1289 		struct v4l2_outputparm	output;
   1290 		__u8	raw_data[200];  /* user-defined */
   1291 	} parm;
   1292 };
   1293 
   1294 /*
   1295  *	A D V A N C E D   D E B U G G I N G
   1296  *
   1297  *	NOTE: EXPERIMENTAL API
   1298  */
   1299 
   1300 /* VIDIOC_DBG_G_REGISTER and VIDIOC_DBG_S_REGISTER */
   1301 
   1302 #define V4L2_CHIP_MATCH_HOST       0  /* Match against chip ID on host (0 for the host) */
   1303 #define V4L2_CHIP_MATCH_I2C_DRIVER 1  /* Match against I2C driver ID */
   1304 #define V4L2_CHIP_MATCH_I2C_ADDR   2  /* Match against I2C 7-bit address */
   1305 
   1306 struct v4l2_register {
   1307 	__u32 match_type; /* Match type */
   1308 	__u32 match_chip; /* Match this chip, meaning determined by match_type */
   1309 	__u64 reg;
   1310 	__u64 val;
   1311 };
   1312 
   1313 /* VIDIOC_G_CHIP_IDENT */
   1314 struct v4l2_chip_ident {
   1315 	__u32 match_type;  /* Match type */
   1316 	__u32 match_chip;  /* Match this chip, meaning determined by match_type */
   1317 	__u32 ident;       /* chip identifier as specified in <media/v4l2-chip-ident.h> */
   1318 	__u32 revision;    /* chip revision, chip specific */
   1319 };
   1320 
   1321 /*
   1322  *	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
   1323  *
   1324  */
   1325 #define VIDIOC_QUERYCAP		_IOR  ('V',  0, struct v4l2_capability)
   1326 #define VIDIOC_RESERVED		_IO   ('V',  1)
   1327 #define VIDIOC_ENUM_FMT         _IOWR ('V',  2, struct v4l2_fmtdesc)
   1328 #define VIDIOC_G_FMT		_IOWR ('V',  4, struct v4l2_format)
   1329 #define VIDIOC_S_FMT		_IOWR ('V',  5, struct v4l2_format)
   1330 #define VIDIOC_REQBUFS		_IOWR ('V',  8, struct v4l2_requestbuffers)
   1331 #define VIDIOC_QUERYBUF		_IOWR ('V',  9, struct v4l2_buffer)
   1332 #define VIDIOC_G_FBUF		_IOR  ('V', 10, struct v4l2_framebuffer)
   1333 #define VIDIOC_S_FBUF		_IOW  ('V', 11, struct v4l2_framebuffer)
   1334 #define VIDIOC_OVERLAY		_IOW  ('V', 14, int)
   1335 #define VIDIOC_QBUF		_IOWR ('V', 15, struct v4l2_buffer)
   1336 #define VIDIOC_DQBUF		_IOWR ('V', 17, struct v4l2_buffer)
   1337 #define VIDIOC_STREAMON		_IOW  ('V', 18, int)
   1338 #define VIDIOC_STREAMOFF	_IOW  ('V', 19, int)
   1339 #define VIDIOC_G_PARM		_IOWR ('V', 21, struct v4l2_streamparm)
   1340 #define VIDIOC_S_PARM		_IOWR ('V', 22, struct v4l2_streamparm)
   1341 #define VIDIOC_G_STD		_IOR  ('V', 23, v4l2_std_id)
   1342 #define VIDIOC_S_STD		_IOW  ('V', 24, v4l2_std_id)
   1343 #define VIDIOC_ENUMSTD		_IOWR ('V', 25, struct v4l2_standard)
   1344 #define VIDIOC_ENUMINPUT	_IOWR ('V', 26, struct v4l2_input)
   1345 #define VIDIOC_G_CTRL		_IOWR ('V', 27, struct v4l2_control)
   1346 #define VIDIOC_S_CTRL		_IOWR ('V', 28, struct v4l2_control)
   1347 #define VIDIOC_G_TUNER		_IOWR ('V', 29, struct v4l2_tuner)
   1348 #define VIDIOC_S_TUNER		_IOW  ('V', 30, struct v4l2_tuner)
   1349 #define VIDIOC_G_AUDIO		_IOR  ('V', 33, struct v4l2_audio)
   1350 #define VIDIOC_S_AUDIO		_IOW  ('V', 34, struct v4l2_audio)
   1351 #define VIDIOC_QUERYCTRL	_IOWR ('V', 36, struct v4l2_queryctrl)
   1352 #define VIDIOC_QUERYMENU	_IOWR ('V', 37, struct v4l2_querymenu)
   1353 #define VIDIOC_G_INPUT		_IOR  ('V', 38, int)
   1354 #define VIDIOC_S_INPUT		_IOWR ('V', 39, int)
   1355 #define VIDIOC_G_OUTPUT		_IOR  ('V', 46, int)
   1356 #define VIDIOC_S_OUTPUT		_IOWR ('V', 47, int)
   1357 #define VIDIOC_ENUMOUTPUT	_IOWR ('V', 48, struct v4l2_output)
   1358 #define VIDIOC_G_AUDOUT		_IOR  ('V', 49, struct v4l2_audioout)
   1359 #define VIDIOC_S_AUDOUT		_IOW  ('V', 50, struct v4l2_audioout)
   1360 #define VIDIOC_G_MODULATOR	_IOWR ('V', 54, struct v4l2_modulator)
   1361 #define VIDIOC_S_MODULATOR	_IOW  ('V', 55, struct v4l2_modulator)
   1362 #define VIDIOC_G_FREQUENCY	_IOWR ('V', 56, struct v4l2_frequency)
   1363 #define VIDIOC_S_FREQUENCY	_IOW  ('V', 57, struct v4l2_frequency)
   1364 #define VIDIOC_CROPCAP		_IOWR ('V', 58, struct v4l2_cropcap)
   1365 #define VIDIOC_G_CROP		_IOWR ('V', 59, struct v4l2_crop)
   1366 #define VIDIOC_S_CROP		_IOW  ('V', 60, struct v4l2_crop)
   1367 #define VIDIOC_G_JPEGCOMP	_IOR  ('V', 61, struct v4l2_jpegcompression)
   1368 #define VIDIOC_S_JPEGCOMP	_IOW  ('V', 62, struct v4l2_jpegcompression)
   1369 #define VIDIOC_QUERYSTD      	_IOR  ('V', 63, v4l2_std_id)
   1370 #define VIDIOC_TRY_FMT      	_IOWR ('V', 64, struct v4l2_format)
   1371 #define VIDIOC_ENUMAUDIO	_IOWR ('V', 65, struct v4l2_audio)
   1372 #define VIDIOC_ENUMAUDOUT	_IOWR ('V', 66, struct v4l2_audioout)
   1373 #define VIDIOC_G_PRIORITY       _IOR  ('V', 67, enum v4l2_priority)
   1374 #define VIDIOC_S_PRIORITY       _IOW  ('V', 68, enum v4l2_priority)
   1375 #define VIDIOC_G_SLICED_VBI_CAP _IOWR ('V', 69, struct v4l2_sliced_vbi_cap)
   1376 #define VIDIOC_LOG_STATUS       _IO   ('V', 70)
   1377 #define VIDIOC_G_EXT_CTRLS	_IOWR ('V', 71, struct v4l2_ext_controls)
   1378 #define VIDIOC_S_EXT_CTRLS	_IOWR ('V', 72, struct v4l2_ext_controls)
   1379 #define VIDIOC_TRY_EXT_CTRLS	_IOWR ('V', 73, struct v4l2_ext_controls)
   1380 #if 1
   1381 #define VIDIOC_ENUM_FRAMESIZES	_IOWR ('V', 74, struct v4l2_frmsizeenum)
   1382 #define VIDIOC_ENUM_FRAMEINTERVALS	_IOWR ('V', 75, struct v4l2_frmivalenum)
   1383 #define VIDIOC_G_ENC_INDEX      _IOR  ('V', 76, struct v4l2_enc_idx)
   1384 #define VIDIOC_ENCODER_CMD      _IOWR ('V', 77, struct v4l2_encoder_cmd)
   1385 #define VIDIOC_TRY_ENCODER_CMD  _IOWR ('V', 78, struct v4l2_encoder_cmd)
   1386 
   1387 /* Experimental, only implemented if CONFIG_VIDEO_ADV_DEBUG is defined */
   1388 #define	VIDIOC_DBG_S_REGISTER 	_IOW  ('V', 79, struct v4l2_register)
   1389 #define	VIDIOC_DBG_G_REGISTER 	_IOWR ('V', 80, struct v4l2_register)
   1390 
   1391 #define VIDIOC_G_CHIP_IDENT     _IOWR ('V', 81, struct v4l2_chip_ident)
   1392 #endif
   1393 
   1394 #ifdef __OLD_VIDIOC_
   1395 /* for compatibility, will go away some day */
   1396 #define VIDIOC_OVERLAY_OLD     	_IOWR ('V', 14, int)
   1397 #define VIDIOC_S_PARM_OLD      	_IOW  ('V', 22, struct v4l2_streamparm)
   1398 #define VIDIOC_S_CTRL_OLD      	_IOW  ('V', 28, struct v4l2_control)
   1399 #define VIDIOC_G_AUDIO_OLD     	_IOWR ('V', 33, struct v4l2_audio)
   1400 #define VIDIOC_G_AUDOUT_OLD    	_IOWR ('V', 49, struct v4l2_audioout)
   1401 #define VIDIOC_CROPCAP_OLD     	_IOR  ('V', 58, struct v4l2_cropcap)
   1402 #endif
   1403 
   1404 #define BASE_VIDIOC_PRIVATE	192		/* 192-255 are private */
   1405 
   1406 #endif /* __LINUX_VIDEODEV2_H */
   1407 
   1408 /*
   1409  * Local variables:
   1410  * c-basic-offset: 8
   1411  * End:
   1412  */
   1413