xref: /linux-6.15/include/uapi/linux/videodev2.h (revision 36cf35b7)
1e2be04c7SGreg Kroah-Hartman /* SPDX-License-Identifier: ((GPL-2.0+ WITH Linux-syscall-note) OR BSD-3-Clause) */
2607ca46eSDavid Howells /*
3607ca46eSDavid Howells  *  Video for Linux Two header file
4607ca46eSDavid Howells  *
5607ca46eSDavid Howells  *  Copyright (C) 1999-2012 the contributors
6607ca46eSDavid Howells  *
7607ca46eSDavid Howells  *  This program is free software; you can redistribute it and/or modify
8607ca46eSDavid Howells  *  it under the terms of the GNU General Public License as published by
9607ca46eSDavid Howells  *  the Free Software Foundation; either version 2 of the License, or
10607ca46eSDavid Howells  *  (at your option) any later version.
11607ca46eSDavid Howells  *
12607ca46eSDavid Howells  *  This program is distributed in the hope that it will be useful,
13607ca46eSDavid Howells  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
14607ca46eSDavid Howells  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15607ca46eSDavid Howells  *  GNU General Public License for more details.
16607ca46eSDavid Howells  *
17607ca46eSDavid Howells  *  Alternatively you can redistribute this file under the terms of the
18607ca46eSDavid Howells  *  BSD license as stated below:
19607ca46eSDavid Howells  *
20607ca46eSDavid Howells  *  Redistribution and use in source and binary forms, with or without
21607ca46eSDavid Howells  *  modification, are permitted provided that the following conditions
22607ca46eSDavid Howells  *  are met:
23607ca46eSDavid Howells  *  1. Redistributions of source code must retain the above copyright
24607ca46eSDavid Howells  *     notice, this list of conditions and the following disclaimer.
25607ca46eSDavid Howells  *  2. Redistributions in binary form must reproduce the above copyright
26607ca46eSDavid Howells  *     notice, this list of conditions and the following disclaimer in
27607ca46eSDavid Howells  *     the documentation and/or other materials provided with the
28607ca46eSDavid Howells  *     distribution.
29607ca46eSDavid Howells  *  3. The names of its contributors may not be used to endorse or promote
30607ca46eSDavid Howells  *     products derived from this software without specific prior written
31607ca46eSDavid Howells  *     permission.
32607ca46eSDavid Howells  *
33607ca46eSDavid Howells  *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
34607ca46eSDavid Howells  *  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
35607ca46eSDavid Howells  *  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
36607ca46eSDavid Howells  *  A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
37607ca46eSDavid Howells  *  OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
38607ca46eSDavid Howells  *  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
39607ca46eSDavid Howells  *  TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
40607ca46eSDavid Howells  *  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
41607ca46eSDavid Howells  *  LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
42607ca46eSDavid Howells  *  NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
43607ca46eSDavid Howells  *  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
44607ca46eSDavid Howells  *
45607ca46eSDavid Howells  *	Header file for v4l or V4L2 drivers and applications
46607ca46eSDavid Howells  * with public API.
47607ca46eSDavid Howells  * All kernel-specific stuff were moved to media/v4l2-dev.h, so
48607ca46eSDavid Howells  * no #if __KERNEL tests are allowed here
49607ca46eSDavid Howells  *
50991ce92fSMauro Carvalho Chehab  *	See https://linuxtv.org for more info
51607ca46eSDavid Howells  *
52607ca46eSDavid Howells  *	Author: Bill Dirks <[email protected]>
53607ca46eSDavid Howells  *		Justin Schoeman
54607ca46eSDavid Howells  *              Hans Verkuil <[email protected]>
55607ca46eSDavid Howells  *		et al.
56607ca46eSDavid Howells  */
57607ca46eSDavid Howells #ifndef _UAPI__LINUX_VIDEODEV2_H
58607ca46eSDavid Howells #define _UAPI__LINUX_VIDEODEV2_H
59607ca46eSDavid Howells 
60607ca46eSDavid Howells #ifndef __KERNEL__
61607ca46eSDavid Howells #include <sys/time.h>
62607ca46eSDavid Howells #endif
63607ca46eSDavid Howells #include <linux/compiler.h>
64607ca46eSDavid Howells #include <linux/ioctl.h>
65607ca46eSDavid Howells #include <linux/types.h>
66607ca46eSDavid Howells #include <linux/v4l2-common.h>
67607ca46eSDavid Howells #include <linux/v4l2-controls.h>
68607ca46eSDavid Howells 
69607ca46eSDavid Howells /*
70607ca46eSDavid Howells  * Common stuff for both V4L1 and V4L2
71607ca46eSDavid Howells  * Moved from videodev.h
72607ca46eSDavid Howells  */
73607ca46eSDavid Howells #define VIDEO_MAX_FRAME               32
74607ca46eSDavid Howells #define VIDEO_MAX_PLANES               8
75607ca46eSDavid Howells 
76607ca46eSDavid Howells /*
77607ca46eSDavid Howells  *	M I S C E L L A N E O U S
78607ca46eSDavid Howells  */
79607ca46eSDavid Howells 
80607ca46eSDavid Howells /*  Four-character-code (FOURCC) */
81607ca46eSDavid Howells #define v4l2_fourcc(a, b, c, d)\
82607ca46eSDavid Howells 	((__u32)(a) | ((__u32)(b) << 8) | ((__u32)(c) << 16) | ((__u32)(d) << 24))
83fcc0d3dbSLaurent Pinchart #define v4l2_fourcc_be(a, b, c, d)	(v4l2_fourcc(a, b, c, d) | (1 << 31))
84607ca46eSDavid Howells 
85607ca46eSDavid Howells /*
86607ca46eSDavid Howells  *	E N U M S
87607ca46eSDavid Howells  */
88607ca46eSDavid Howells enum v4l2_field {
89607ca46eSDavid Howells 	V4L2_FIELD_ANY           = 0, /* driver can choose from none,
90607ca46eSDavid Howells 					 top, bottom, interlaced
91607ca46eSDavid Howells 					 depending on whatever it thinks
92607ca46eSDavid Howells 					 is approximate ... */
93607ca46eSDavid Howells 	V4L2_FIELD_NONE          = 1, /* this device has no fields ... */
94607ca46eSDavid Howells 	V4L2_FIELD_TOP           = 2, /* top field only */
95607ca46eSDavid Howells 	V4L2_FIELD_BOTTOM        = 3, /* bottom field only */
96607ca46eSDavid Howells 	V4L2_FIELD_INTERLACED    = 4, /* both fields interlaced */
97607ca46eSDavid Howells 	V4L2_FIELD_SEQ_TB        = 5, /* both fields sequential into one
98607ca46eSDavid Howells 					 buffer, top-bottom order */
99607ca46eSDavid Howells 	V4L2_FIELD_SEQ_BT        = 6, /* same as above + bottom-top order */
100607ca46eSDavid Howells 	V4L2_FIELD_ALTERNATE     = 7, /* both fields alternating into
101607ca46eSDavid Howells 					 separate buffers */
102607ca46eSDavid Howells 	V4L2_FIELD_INTERLACED_TB = 8, /* both fields interlaced, top field
103607ca46eSDavid Howells 					 first and the top field is
104607ca46eSDavid Howells 					 transmitted first */
105607ca46eSDavid Howells 	V4L2_FIELD_INTERLACED_BT = 9, /* both fields interlaced, top field
106607ca46eSDavid Howells 					 first and the bottom field is
107607ca46eSDavid Howells 					 transmitted first */
108607ca46eSDavid Howells };
109607ca46eSDavid Howells #define V4L2_FIELD_HAS_TOP(field)	\
110607ca46eSDavid Howells 	((field) == V4L2_FIELD_TOP	||\
111607ca46eSDavid Howells 	 (field) == V4L2_FIELD_INTERLACED ||\
112607ca46eSDavid Howells 	 (field) == V4L2_FIELD_INTERLACED_TB ||\
113607ca46eSDavid Howells 	 (field) == V4L2_FIELD_INTERLACED_BT ||\
114607ca46eSDavid Howells 	 (field) == V4L2_FIELD_SEQ_TB	||\
115607ca46eSDavid Howells 	 (field) == V4L2_FIELD_SEQ_BT)
116607ca46eSDavid Howells #define V4L2_FIELD_HAS_BOTTOM(field)	\
117607ca46eSDavid Howells 	((field) == V4L2_FIELD_BOTTOM	||\
118607ca46eSDavid Howells 	 (field) == V4L2_FIELD_INTERLACED ||\
119607ca46eSDavid Howells 	 (field) == V4L2_FIELD_INTERLACED_TB ||\
120607ca46eSDavid Howells 	 (field) == V4L2_FIELD_INTERLACED_BT ||\
121607ca46eSDavid Howells 	 (field) == V4L2_FIELD_SEQ_TB	||\
122607ca46eSDavid Howells 	 (field) == V4L2_FIELD_SEQ_BT)
123607ca46eSDavid Howells #define V4L2_FIELD_HAS_BOTH(field)	\
124607ca46eSDavid Howells 	((field) == V4L2_FIELD_INTERLACED ||\
125607ca46eSDavid Howells 	 (field) == V4L2_FIELD_INTERLACED_TB ||\
126607ca46eSDavid Howells 	 (field) == V4L2_FIELD_INTERLACED_BT ||\
127607ca46eSDavid Howells 	 (field) == V4L2_FIELD_SEQ_TB ||\
128607ca46eSDavid Howells 	 (field) == V4L2_FIELD_SEQ_BT)
129e34c4db8SHans Verkuil #define V4L2_FIELD_HAS_T_OR_B(field)	\
130e34c4db8SHans Verkuil 	((field) == V4L2_FIELD_BOTTOM ||\
131e34c4db8SHans Verkuil 	 (field) == V4L2_FIELD_TOP ||\
132e34c4db8SHans Verkuil 	 (field) == V4L2_FIELD_ALTERNATE)
133607ca46eSDavid Howells 
134607ca46eSDavid Howells enum v4l2_buf_type {
135607ca46eSDavid Howells 	V4L2_BUF_TYPE_VIDEO_CAPTURE        = 1,
136607ca46eSDavid Howells 	V4L2_BUF_TYPE_VIDEO_OUTPUT         = 2,
137607ca46eSDavid Howells 	V4L2_BUF_TYPE_VIDEO_OVERLAY        = 3,
138607ca46eSDavid Howells 	V4L2_BUF_TYPE_VBI_CAPTURE          = 4,
139607ca46eSDavid Howells 	V4L2_BUF_TYPE_VBI_OUTPUT           = 5,
140607ca46eSDavid Howells 	V4L2_BUF_TYPE_SLICED_VBI_CAPTURE   = 6,
141607ca46eSDavid Howells 	V4L2_BUF_TYPE_SLICED_VBI_OUTPUT    = 7,
142607ca46eSDavid Howells 	V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY = 8,
143607ca46eSDavid Howells 	V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE = 9,
144607ca46eSDavid Howells 	V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE  = 10,
1456f3073b8SAntti Palosaari 	V4L2_BUF_TYPE_SDR_CAPTURE          = 11,
1469effc72fSAntti Palosaari 	V4L2_BUF_TYPE_SDR_OUTPUT           = 12,
147fb9ffa6aSLaurent Pinchart 	V4L2_BUF_TYPE_META_CAPTURE         = 13,
148607ca46eSDavid Howells 	/* Deprecated, do not use */
149607ca46eSDavid Howells 	V4L2_BUF_TYPE_PRIVATE              = 0x80,
150607ca46eSDavid Howells };
151607ca46eSDavid Howells 
152607ca46eSDavid Howells #define V4L2_TYPE_IS_MULTIPLANAR(type)			\
153607ca46eSDavid Howells 	((type) == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE	\
154607ca46eSDavid Howells 	 || (type) == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE)
155607ca46eSDavid Howells 
156607ca46eSDavid Howells #define V4L2_TYPE_IS_OUTPUT(type)				\
157607ca46eSDavid Howells 	((type) == V4L2_BUF_TYPE_VIDEO_OUTPUT			\
158607ca46eSDavid Howells 	 || (type) == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE		\
159607ca46eSDavid Howells 	 || (type) == V4L2_BUF_TYPE_VIDEO_OVERLAY		\
160607ca46eSDavid Howells 	 || (type) == V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY	\
161607ca46eSDavid Howells 	 || (type) == V4L2_BUF_TYPE_VBI_OUTPUT			\
1629effc72fSAntti Palosaari 	 || (type) == V4L2_BUF_TYPE_SLICED_VBI_OUTPUT		\
1639effc72fSAntti Palosaari 	 || (type) == V4L2_BUF_TYPE_SDR_OUTPUT)
164607ca46eSDavid Howells 
165607ca46eSDavid Howells enum v4l2_tuner_type {
166607ca46eSDavid Howells 	V4L2_TUNER_RADIO	     = 1,
167607ca46eSDavid Howells 	V4L2_TUNER_ANALOG_TV	     = 2,
168607ca46eSDavid Howells 	V4L2_TUNER_DIGITAL_TV	     = 3,
169f3c3ececSAntti Palosaari 	V4L2_TUNER_SDR               = 4,
17084099a28SAntti Palosaari 	V4L2_TUNER_RF                = 5,
171607ca46eSDavid Howells };
172607ca46eSDavid Howells 
173f3c3ececSAntti Palosaari /* Deprecated, do not use */
174f3c3ececSAntti Palosaari #define V4L2_TUNER_ADC  V4L2_TUNER_SDR
175f3c3ececSAntti Palosaari 
176607ca46eSDavid Howells enum v4l2_memory {
177607ca46eSDavid Howells 	V4L2_MEMORY_MMAP             = 1,
178607ca46eSDavid Howells 	V4L2_MEMORY_USERPTR          = 2,
179607ca46eSDavid Howells 	V4L2_MEMORY_OVERLAY          = 3,
180051c7788SSumit Semwal 	V4L2_MEMORY_DMABUF           = 4,
181607ca46eSDavid Howells };
182607ca46eSDavid Howells 
183607ca46eSDavid Howells /* see also http://vektor.theorem.ca/graphics/ycbcr/ */
184607ca46eSDavid Howells enum v4l2_colorspace {
185e01dfc01SHans Verkuil 	/*
186e01dfc01SHans Verkuil 	 * Default colorspace, i.e. let the driver figure it out.
187e01dfc01SHans Verkuil 	 * Can only be used with video capture.
188e01dfc01SHans Verkuil 	 */
189e01dfc01SHans Verkuil 	V4L2_COLORSPACE_DEFAULT       = 0,
190e01dfc01SHans Verkuil 
191d5735d64SHans Verkuil 	/* SMPTE 170M: used for broadcast NTSC/PAL SDTV */
192607ca46eSDavid Howells 	V4L2_COLORSPACE_SMPTE170M     = 1,
193607ca46eSDavid Howells 
194d5735d64SHans Verkuil 	/* Obsolete pre-1998 SMPTE 240M HDTV standard, superseded by Rec 709 */
195607ca46eSDavid Howells 	V4L2_COLORSPACE_SMPTE240M     = 2,
196607ca46eSDavid Howells 
197d5735d64SHans Verkuil 	/* Rec.709: used for HDTV */
198607ca46eSDavid Howells 	V4L2_COLORSPACE_REC709        = 3,
199607ca46eSDavid Howells 
200d5735d64SHans Verkuil 	/*
201d5735d64SHans Verkuil 	 * Deprecated, do not use. No driver will ever return this. This was
202d5735d64SHans Verkuil 	 * based on a misunderstanding of the bt878 datasheet.
203d5735d64SHans Verkuil 	 */
204607ca46eSDavid Howells 	V4L2_COLORSPACE_BT878         = 4,
205607ca46eSDavid Howells 
206d5735d64SHans Verkuil 	/*
207d5735d64SHans Verkuil 	 * NTSC 1953 colorspace. This only makes sense when dealing with
208d5735d64SHans Verkuil 	 * really, really old NTSC recordings. Superseded by SMPTE 170M.
209d5735d64SHans Verkuil 	 */
210607ca46eSDavid Howells 	V4L2_COLORSPACE_470_SYSTEM_M  = 5,
211d5735d64SHans Verkuil 
212d5735d64SHans Verkuil 	/*
213d5735d64SHans Verkuil 	 * EBU Tech 3213 PAL/SECAM colorspace. This only makes sense when
214d5735d64SHans Verkuil 	 * dealing with really old PAL/SECAM recordings. Superseded by
215d5735d64SHans Verkuil 	 * SMPTE 170M.
216d5735d64SHans Verkuil 	 */
217607ca46eSDavid Howells 	V4L2_COLORSPACE_470_SYSTEM_BG = 6,
218607ca46eSDavid Howells 
219d5735d64SHans Verkuil 	/*
220d5735d64SHans Verkuil 	 * Effectively shorthand for V4L2_COLORSPACE_SRGB, V4L2_YCBCR_ENC_601
221d5735d64SHans Verkuil 	 * and V4L2_QUANTIZATION_FULL_RANGE. To be used for (Motion-)JPEG.
222607ca46eSDavid Howells 	 */
223607ca46eSDavid Howells 	V4L2_COLORSPACE_JPEG          = 7,
224607ca46eSDavid Howells 
225d5735d64SHans Verkuil 	/* For RGB colorspaces such as produces by most webcams. */
226607ca46eSDavid Howells 	V4L2_COLORSPACE_SRGB          = 8,
227d5735d64SHans Verkuil 
228d5735d64SHans Verkuil 	/* AdobeRGB colorspace */
229d5735d64SHans Verkuil 	V4L2_COLORSPACE_ADOBERGB      = 9,
230d5735d64SHans Verkuil 
231d5735d64SHans Verkuil 	/* BT.2020 colorspace, used for UHDTV. */
232d5735d64SHans Verkuil 	V4L2_COLORSPACE_BT2020        = 10,
233addad105SHans Verkuil 
234addad105SHans Verkuil 	/* Raw colorspace: for RAW unprocessed images */
235addad105SHans Verkuil 	V4L2_COLORSPACE_RAW           = 11,
236529a7960SHans Verkuil 
237529a7960SHans Verkuil 	/* DCI-P3 colorspace, used by cinema projectors */
238529a7960SHans Verkuil 	V4L2_COLORSPACE_DCI_P3        = 12,
239d5735d64SHans Verkuil };
240d5735d64SHans Verkuil 
2413818c4daSHans Verkuil /*
2423818c4daSHans Verkuil  * Determine how COLORSPACE_DEFAULT should map to a proper colorspace.
2433818c4daSHans Verkuil  * This depends on whether this is a SDTV image (use SMPTE 170M), an
2443818c4daSHans Verkuil  * HDTV image (use Rec. 709), or something else (use sRGB).
2453818c4daSHans Verkuil  */
2463818c4daSHans Verkuil #define V4L2_MAP_COLORSPACE_DEFAULT(is_sdtv, is_hdtv) \
2473818c4daSHans Verkuil 	((is_sdtv) ? V4L2_COLORSPACE_SMPTE170M : \
2483818c4daSHans Verkuil 	 ((is_hdtv) ? V4L2_COLORSPACE_REC709 : V4L2_COLORSPACE_SRGB))
2493818c4daSHans Verkuil 
25074fdcb2eSHans Verkuil enum v4l2_xfer_func {
25174fdcb2eSHans Verkuil 	/*
25274fdcb2eSHans Verkuil 	 * Mapping of V4L2_XFER_FUNC_DEFAULT to actual transfer functions
25374fdcb2eSHans Verkuil 	 * for the various colorspaces:
25474fdcb2eSHans Verkuil 	 *
25574fdcb2eSHans Verkuil 	 * V4L2_COLORSPACE_SMPTE170M, V4L2_COLORSPACE_470_SYSTEM_M,
25674fdcb2eSHans Verkuil 	 * V4L2_COLORSPACE_470_SYSTEM_BG, V4L2_COLORSPACE_REC709 and
25774fdcb2eSHans Verkuil 	 * V4L2_COLORSPACE_BT2020: V4L2_XFER_FUNC_709
25874fdcb2eSHans Verkuil 	 *
25974fdcb2eSHans Verkuil 	 * V4L2_COLORSPACE_SRGB, V4L2_COLORSPACE_JPEG: V4L2_XFER_FUNC_SRGB
26074fdcb2eSHans Verkuil 	 *
26174fdcb2eSHans Verkuil 	 * V4L2_COLORSPACE_ADOBERGB: V4L2_XFER_FUNC_ADOBERGB
26274fdcb2eSHans Verkuil 	 *
26374fdcb2eSHans Verkuil 	 * V4L2_COLORSPACE_SMPTE240M: V4L2_XFER_FUNC_SMPTE240M
26474fdcb2eSHans Verkuil 	 *
26574fdcb2eSHans Verkuil 	 * V4L2_COLORSPACE_RAW: V4L2_XFER_FUNC_NONE
266529a7960SHans Verkuil 	 *
267529a7960SHans Verkuil 	 * V4L2_COLORSPACE_DCI_P3: V4L2_XFER_FUNC_DCI_P3
26874fdcb2eSHans Verkuil 	 */
26974fdcb2eSHans Verkuil 	V4L2_XFER_FUNC_DEFAULT     = 0,
27074fdcb2eSHans Verkuil 	V4L2_XFER_FUNC_709         = 1,
27174fdcb2eSHans Verkuil 	V4L2_XFER_FUNC_SRGB        = 2,
27274fdcb2eSHans Verkuil 	V4L2_XFER_FUNC_ADOBERGB    = 3,
27374fdcb2eSHans Verkuil 	V4L2_XFER_FUNC_SMPTE240M   = 4,
27474fdcb2eSHans Verkuil 	V4L2_XFER_FUNC_NONE        = 5,
275529a7960SHans Verkuil 	V4L2_XFER_FUNC_DCI_P3      = 6,
2762bdd2801SHans Verkuil 	V4L2_XFER_FUNC_SMPTE2084   = 7,
27774fdcb2eSHans Verkuil };
27874fdcb2eSHans Verkuil 
27974fdcb2eSHans Verkuil /*
28074fdcb2eSHans Verkuil  * Determine how XFER_FUNC_DEFAULT should map to a proper transfer function.
28174fdcb2eSHans Verkuil  * This depends on the colorspace.
28274fdcb2eSHans Verkuil  */
28374fdcb2eSHans Verkuil #define V4L2_MAP_XFER_FUNC_DEFAULT(colsp) \
284f8d5556fSHans Verkuil 	((colsp) == V4L2_COLORSPACE_ADOBERGB ? V4L2_XFER_FUNC_ADOBERGB : \
28574fdcb2eSHans Verkuil 	 ((colsp) == V4L2_COLORSPACE_SMPTE240M ? V4L2_XFER_FUNC_SMPTE240M : \
286529a7960SHans Verkuil 	  ((colsp) == V4L2_COLORSPACE_DCI_P3 ? V4L2_XFER_FUNC_DCI_P3 : \
28774fdcb2eSHans Verkuil 	   ((colsp) == V4L2_COLORSPACE_RAW ? V4L2_XFER_FUNC_NONE : \
28874fdcb2eSHans Verkuil 	    ((colsp) == V4L2_COLORSPACE_SRGB || (colsp) == V4L2_COLORSPACE_JPEG ? \
289529a7960SHans Verkuil 	     V4L2_XFER_FUNC_SRGB : V4L2_XFER_FUNC_709)))))
29074fdcb2eSHans Verkuil 
291d5735d64SHans Verkuil enum v4l2_ycbcr_encoding {
292d5735d64SHans Verkuil 	/*
293d5735d64SHans Verkuil 	 * Mapping of V4L2_YCBCR_ENC_DEFAULT to actual encodings for the
294d5735d64SHans Verkuil 	 * various colorspaces:
295d5735d64SHans Verkuil 	 *
296d5735d64SHans Verkuil 	 * V4L2_COLORSPACE_SMPTE170M, V4L2_COLORSPACE_470_SYSTEM_M,
297adca8c8eSHans Verkuil 	 * V4L2_COLORSPACE_470_SYSTEM_BG, V4L2_COLORSPACE_SRGB,
298adca8c8eSHans Verkuil 	 * V4L2_COLORSPACE_ADOBERGB and V4L2_COLORSPACE_JPEG: V4L2_YCBCR_ENC_601
299d5735d64SHans Verkuil 	 *
300529a7960SHans Verkuil 	 * V4L2_COLORSPACE_REC709 and V4L2_COLORSPACE_DCI_P3: V4L2_YCBCR_ENC_709
301d5735d64SHans Verkuil 	 *
302d5735d64SHans Verkuil 	 * V4L2_COLORSPACE_BT2020: V4L2_YCBCR_ENC_BT2020
303d5735d64SHans Verkuil 	 *
304d5735d64SHans Verkuil 	 * V4L2_COLORSPACE_SMPTE240M: V4L2_YCBCR_ENC_SMPTE240M
305d5735d64SHans Verkuil 	 */
306d5735d64SHans Verkuil 	V4L2_YCBCR_ENC_DEFAULT        = 0,
307d5735d64SHans Verkuil 
308d5735d64SHans Verkuil 	/* ITU-R 601 -- SDTV */
309d5735d64SHans Verkuil 	V4L2_YCBCR_ENC_601            = 1,
310d5735d64SHans Verkuil 
311d5735d64SHans Verkuil 	/* Rec. 709 -- HDTV */
312d5735d64SHans Verkuil 	V4L2_YCBCR_ENC_709            = 2,
313d5735d64SHans Verkuil 
314d5735d64SHans Verkuil 	/* ITU-R 601/EN 61966-2-4 Extended Gamut -- SDTV */
315d5735d64SHans Verkuil 	V4L2_YCBCR_ENC_XV601          = 3,
316d5735d64SHans Verkuil 
317d5735d64SHans Verkuil 	/* Rec. 709/EN 61966-2-4 Extended Gamut -- HDTV */
318d5735d64SHans Verkuil 	V4L2_YCBCR_ENC_XV709          = 4,
319d5735d64SHans Verkuil 
320adca8c8eSHans Verkuil #ifndef __KERNEL__
321adca8c8eSHans Verkuil 	/*
322adca8c8eSHans Verkuil 	 * sYCC (Y'CbCr encoding of sRGB), identical to ENC_601. It was added
323adca8c8eSHans Verkuil 	 * originally due to a misunderstanding of the sYCC standard. It should
324adca8c8eSHans Verkuil 	 * not be used, instead use V4L2_YCBCR_ENC_601.
325adca8c8eSHans Verkuil 	 */
326d5735d64SHans Verkuil 	V4L2_YCBCR_ENC_SYCC           = 5,
327adca8c8eSHans Verkuil #endif
328d5735d64SHans Verkuil 
329d5735d64SHans Verkuil 	/* BT.2020 Non-constant Luminance Y'CbCr */
330d5735d64SHans Verkuil 	V4L2_YCBCR_ENC_BT2020         = 6,
331d5735d64SHans Verkuil 
332d5735d64SHans Verkuil 	/* BT.2020 Constant Luminance Y'CbcCrc */
333d5735d64SHans Verkuil 	V4L2_YCBCR_ENC_BT2020_CONST_LUM = 7,
334d5735d64SHans Verkuil 
335d5735d64SHans Verkuil 	/* SMPTE 240M -- Obsolete HDTV */
336d5735d64SHans Verkuil 	V4L2_YCBCR_ENC_SMPTE240M      = 8,
337d5735d64SHans Verkuil };
338d5735d64SHans Verkuil 
3393818c4daSHans Verkuil /*
3408a0d62afSRicardo Ribalda Delgado  * enum v4l2_hsv_encoding values should not collide with the ones from
3418a0d62afSRicardo Ribalda Delgado  * enum v4l2_ycbcr_encoding.
3428a0d62afSRicardo Ribalda Delgado  */
3438a0d62afSRicardo Ribalda Delgado enum v4l2_hsv_encoding {
3448a0d62afSRicardo Ribalda Delgado 
3458a0d62afSRicardo Ribalda Delgado 	/* Hue mapped to 0 - 179 */
3468a0d62afSRicardo Ribalda Delgado 	V4L2_HSV_ENC_180		= 128,
3478a0d62afSRicardo Ribalda Delgado 
3488a0d62afSRicardo Ribalda Delgado 	/* Hue mapped to 0-255 */
3498a0d62afSRicardo Ribalda Delgado 	V4L2_HSV_ENC_256		= 129,
3508a0d62afSRicardo Ribalda Delgado };
3518a0d62afSRicardo Ribalda Delgado 
3528a0d62afSRicardo Ribalda Delgado /*
3533818c4daSHans Verkuil  * Determine how YCBCR_ENC_DEFAULT should map to a proper Y'CbCr encoding.
3543818c4daSHans Verkuil  * This depends on the colorspace.
3553818c4daSHans Verkuil  */
3563818c4daSHans Verkuil #define V4L2_MAP_YCBCR_ENC_DEFAULT(colsp) \
357529a7960SHans Verkuil 	(((colsp) == V4L2_COLORSPACE_REC709 || \
358529a7960SHans Verkuil 	  (colsp) == V4L2_COLORSPACE_DCI_P3) ? V4L2_YCBCR_ENC_709 : \
3593818c4daSHans Verkuil 	 ((colsp) == V4L2_COLORSPACE_BT2020 ? V4L2_YCBCR_ENC_BT2020 : \
3603818c4daSHans Verkuil 	  ((colsp) == V4L2_COLORSPACE_SMPTE240M ? V4L2_YCBCR_ENC_SMPTE240M : \
3613818c4daSHans Verkuil 	   V4L2_YCBCR_ENC_601)))
3623818c4daSHans Verkuil 
363d5735d64SHans Verkuil enum v4l2_quantization {
364d5735d64SHans Verkuil 	/*
365aa05b979SHans Verkuil 	 * The default for R'G'B' quantization is always full range, except
366aa05b979SHans Verkuil 	 * for the BT2020 colorspace. For Y'CbCr the quantization is always
36786c7eb41SHans Verkuil 	 * limited range, except for COLORSPACE_JPEG: this is full range.
368d5735d64SHans Verkuil 	 */
369d5735d64SHans Verkuil 	V4L2_QUANTIZATION_DEFAULT     = 0,
370d5735d64SHans Verkuil 	V4L2_QUANTIZATION_FULL_RANGE  = 1,
371d5735d64SHans Verkuil 	V4L2_QUANTIZATION_LIM_RANGE   = 2,
372607ca46eSDavid Howells };
373607ca46eSDavid Howells 
3743818c4daSHans Verkuil /*
3753818c4daSHans Verkuil  * Determine how QUANTIZATION_DEFAULT should map to a proper quantization.
3763818c4daSHans Verkuil  * This depends on whether the image is RGB or not, the colorspace and the
3773818c4daSHans Verkuil  * Y'CbCr encoding.
3783818c4daSHans Verkuil  */
3798a0d62afSRicardo Ribalda Delgado #define V4L2_MAP_QUANTIZATION_DEFAULT(is_rgb_or_hsv, colsp, ycbcr_enc) \
3808a0d62afSRicardo Ribalda Delgado 	(((is_rgb_or_hsv) && (colsp) == V4L2_COLORSPACE_BT2020) ? \
3818a0d62afSRicardo Ribalda Delgado 	 V4L2_QUANTIZATION_LIM_RANGE : \
38279e92dc0SHans Verkuil 	 (((is_rgb_or_hsv) || (colsp) == V4L2_COLORSPACE_JPEG) ? \
3833818c4daSHans Verkuil 	 V4L2_QUANTIZATION_FULL_RANGE : V4L2_QUANTIZATION_LIM_RANGE))
3843818c4daSHans Verkuil 
385607ca46eSDavid Howells enum v4l2_priority {
386607ca46eSDavid Howells 	V4L2_PRIORITY_UNSET       = 0,  /* not initialized */
387607ca46eSDavid Howells 	V4L2_PRIORITY_BACKGROUND  = 1,
388607ca46eSDavid Howells 	V4L2_PRIORITY_INTERACTIVE = 2,
389607ca46eSDavid Howells 	V4L2_PRIORITY_RECORD      = 3,
390607ca46eSDavid Howells 	V4L2_PRIORITY_DEFAULT     = V4L2_PRIORITY_INTERACTIVE,
391607ca46eSDavid Howells };
392607ca46eSDavid Howells 
393607ca46eSDavid Howells struct v4l2_rect {
394607ca46eSDavid Howells 	__s32   left;
395607ca46eSDavid Howells 	__s32   top;
396f90580caSRicardo Ribalda 	__u32   width;
397f90580caSRicardo Ribalda 	__u32   height;
398607ca46eSDavid Howells };
399607ca46eSDavid Howells 
400607ca46eSDavid Howells struct v4l2_fract {
401607ca46eSDavid Howells 	__u32   numerator;
402607ca46eSDavid Howells 	__u32   denominator;
403607ca46eSDavid Howells };
404607ca46eSDavid Howells 
405607ca46eSDavid Howells /**
406607ca46eSDavid Howells   * struct v4l2_capability - Describes V4L2 device caps returned by VIDIOC_QUERYCAP
407607ca46eSDavid Howells   *
408607ca46eSDavid Howells   * @driver:	   name of the driver module (e.g. "bttv")
409607ca46eSDavid Howells   * @card:	   name of the card (e.g. "Hauppauge WinTV")
410607ca46eSDavid Howells   * @bus_info:	   name of the bus (e.g. "PCI:" + pci_name(pci_dev) )
411607ca46eSDavid Howells   * @version:	   KERNEL_VERSION
412607ca46eSDavid Howells   * @capabilities: capabilities of the physical device as a whole
413607ca46eSDavid Howells   * @device_caps:  capabilities accessed via this particular device (node)
414607ca46eSDavid Howells   * @reserved:	   reserved fields for future extensions
415607ca46eSDavid Howells   */
416607ca46eSDavid Howells struct v4l2_capability {
417607ca46eSDavid Howells 	__u8	driver[16];
418607ca46eSDavid Howells 	__u8	card[32];
419607ca46eSDavid Howells 	__u8	bus_info[32];
420607ca46eSDavid Howells 	__u32   version;
421607ca46eSDavid Howells 	__u32	capabilities;
422607ca46eSDavid Howells 	__u32	device_caps;
423607ca46eSDavid Howells 	__u32	reserved[3];
424607ca46eSDavid Howells };
425607ca46eSDavid Howells 
426607ca46eSDavid Howells /* Values for 'capabilities' field */
427607ca46eSDavid Howells #define V4L2_CAP_VIDEO_CAPTURE		0x00000001  /* Is a video capture device */
428607ca46eSDavid Howells #define V4L2_CAP_VIDEO_OUTPUT		0x00000002  /* Is a video output device */
429607ca46eSDavid Howells #define V4L2_CAP_VIDEO_OVERLAY		0x00000004  /* Can do video overlay */
430607ca46eSDavid Howells #define V4L2_CAP_VBI_CAPTURE		0x00000010  /* Is a raw VBI capture device */
431607ca46eSDavid Howells #define V4L2_CAP_VBI_OUTPUT		0x00000020  /* Is a raw VBI output device */
432607ca46eSDavid Howells #define V4L2_CAP_SLICED_VBI_CAPTURE	0x00000040  /* Is a sliced VBI capture device */
433607ca46eSDavid Howells #define V4L2_CAP_SLICED_VBI_OUTPUT	0x00000080  /* Is a sliced VBI output device */
434607ca46eSDavid Howells #define V4L2_CAP_RDS_CAPTURE		0x00000100  /* RDS data capture */
435607ca46eSDavid Howells #define V4L2_CAP_VIDEO_OUTPUT_OVERLAY	0x00000200  /* Can do video output overlay */
436607ca46eSDavid Howells #define V4L2_CAP_HW_FREQ_SEEK		0x00000400  /* Can do hardware frequency seek  */
437607ca46eSDavid Howells #define V4L2_CAP_RDS_OUTPUT		0x00000800  /* Is an RDS encoder */
438607ca46eSDavid Howells 
439607ca46eSDavid Howells /* Is a video capture device that supports multiplanar formats */
440607ca46eSDavid Howells #define V4L2_CAP_VIDEO_CAPTURE_MPLANE	0x00001000
441607ca46eSDavid Howells /* Is a video output device that supports multiplanar formats */
442607ca46eSDavid Howells #define V4L2_CAP_VIDEO_OUTPUT_MPLANE	0x00002000
443607ca46eSDavid Howells /* Is a video mem-to-mem device that supports multiplanar formats */
444607ca46eSDavid Howells #define V4L2_CAP_VIDEO_M2M_MPLANE	0x00004000
445607ca46eSDavid Howells /* Is a video mem-to-mem device */
446607ca46eSDavid Howells #define V4L2_CAP_VIDEO_M2M		0x00008000
447607ca46eSDavid Howells 
448607ca46eSDavid Howells #define V4L2_CAP_TUNER			0x00010000  /* has a tuner */
449607ca46eSDavid Howells #define V4L2_CAP_AUDIO			0x00020000  /* has audio support */
450607ca46eSDavid Howells #define V4L2_CAP_RADIO			0x00040000  /* is a radio device */
451607ca46eSDavid Howells #define V4L2_CAP_MODULATOR		0x00080000  /* has a modulator */
452607ca46eSDavid Howells 
453c9c54f72SAntti Palosaari #define V4L2_CAP_SDR_CAPTURE		0x00100000  /* Is a SDR capture device */
454d52e2381SLaurent Pinchart #define V4L2_CAP_EXT_PIX_FORMAT		0x00200000  /* Supports the extended pixel format */
4559effc72fSAntti Palosaari #define V4L2_CAP_SDR_OUTPUT		0x00400000  /* Is a SDR output device */
456fb9ffa6aSLaurent Pinchart #define V4L2_CAP_META_CAPTURE		0x00800000  /* Is a metadata capture device */
457c9c54f72SAntti Palosaari 
458607ca46eSDavid Howells #define V4L2_CAP_READWRITE              0x01000000  /* read/write systemcalls */
459607ca46eSDavid Howells #define V4L2_CAP_ASYNCIO                0x02000000  /* async I/O */
460607ca46eSDavid Howells #define V4L2_CAP_STREAMING              0x04000000  /* streaming I/O ioctls */
461607ca46eSDavid Howells 
462b2fe22d0SNick Dyer #define V4L2_CAP_TOUCH                  0x10000000  /* Is a touch device */
463b2fe22d0SNick Dyer 
464607ca46eSDavid Howells #define V4L2_CAP_DEVICE_CAPS            0x80000000  /* sets device capabilities field */
465607ca46eSDavid Howells 
466607ca46eSDavid Howells /*
467607ca46eSDavid Howells  *	V I D E O   I M A G E   F O R M A T
468607ca46eSDavid Howells  */
469607ca46eSDavid Howells struct v4l2_pix_format {
470607ca46eSDavid Howells 	__u32			width;
471607ca46eSDavid Howells 	__u32			height;
472607ca46eSDavid Howells 	__u32			pixelformat;
473607ca46eSDavid Howells 	__u32			field;		/* enum v4l2_field */
474607ca46eSDavid Howells 	__u32			bytesperline;	/* for padding, zero if unused */
475607ca46eSDavid Howells 	__u32			sizeimage;
476607ca46eSDavid Howells 	__u32			colorspace;	/* enum v4l2_colorspace */
477607ca46eSDavid Howells 	__u32			priv;		/* private data, depends on pixelformat */
478c96fd46aSLaurent Pinchart 	__u32			flags;		/* format flags (V4L2_PIX_FMT_FLAG_*) */
4798a0d62afSRicardo Ribalda Delgado 	union {
4808a0d62afSRicardo Ribalda Delgado 		/* enum v4l2_ycbcr_encoding */
4818a0d62afSRicardo Ribalda Delgado 		__u32			ycbcr_enc;
4828a0d62afSRicardo Ribalda Delgado 		/* enum v4l2_hsv_encoding */
4838a0d62afSRicardo Ribalda Delgado 		__u32			hsv_enc;
4848a0d62afSRicardo Ribalda Delgado 	};
485d5735d64SHans Verkuil 	__u32			quantization;	/* enum v4l2_quantization */
48674fdcb2eSHans Verkuil 	__u32			xfer_func;	/* enum v4l2_xfer_func */
487607ca46eSDavid Howells };
488607ca46eSDavid Howells 
489607ca46eSDavid Howells /*      Pixel format         FOURCC                          depth  Description  */
490607ca46eSDavid Howells 
491607ca46eSDavid Howells /* RGB formats */
492607ca46eSDavid Howells #define V4L2_PIX_FMT_RGB332  v4l2_fourcc('R', 'G', 'B', '1') /*  8  RGB-3-3-2     */
493607ca46eSDavid Howells #define V4L2_PIX_FMT_RGB444  v4l2_fourcc('R', '4', '4', '4') /* 16  xxxxrrrr ggggbbbb */
494977ff0e4SLaurent Pinchart #define V4L2_PIX_FMT_ARGB444 v4l2_fourcc('A', 'R', '1', '2') /* 16  aaaarrrr ggggbbbb */
495977ff0e4SLaurent Pinchart #define V4L2_PIX_FMT_XRGB444 v4l2_fourcc('X', 'R', '1', '2') /* 16  xxxxrrrr ggggbbbb */
496607ca46eSDavid Howells #define V4L2_PIX_FMT_RGB555  v4l2_fourcc('R', 'G', 'B', 'O') /* 16  RGB-5-5-5     */
497977ff0e4SLaurent Pinchart #define V4L2_PIX_FMT_ARGB555 v4l2_fourcc('A', 'R', '1', '5') /* 16  ARGB-1-5-5-5  */
498977ff0e4SLaurent Pinchart #define V4L2_PIX_FMT_XRGB555 v4l2_fourcc('X', 'R', '1', '5') /* 16  XRGB-1-5-5-5  */
499607ca46eSDavid Howells #define V4L2_PIX_FMT_RGB565  v4l2_fourcc('R', 'G', 'B', 'P') /* 16  RGB-5-6-5     */
500607ca46eSDavid Howells #define V4L2_PIX_FMT_RGB555X v4l2_fourcc('R', 'G', 'B', 'Q') /* 16  RGB-5-5-5 BE  */
501fcc0d3dbSLaurent Pinchart #define V4L2_PIX_FMT_ARGB555X v4l2_fourcc_be('A', 'R', '1', '5') /* 16  ARGB-5-5-5 BE */
502fcc0d3dbSLaurent Pinchart #define V4L2_PIX_FMT_XRGB555X v4l2_fourcc_be('X', 'R', '1', '5') /* 16  XRGB-5-5-5 BE */
503607ca46eSDavid Howells #define V4L2_PIX_FMT_RGB565X v4l2_fourcc('R', 'G', 'B', 'R') /* 16  RGB-5-6-5 BE  */
504607ca46eSDavid Howells #define V4L2_PIX_FMT_BGR666  v4l2_fourcc('B', 'G', 'R', 'H') /* 18  BGR-6-6-6	  */
505607ca46eSDavid Howells #define V4L2_PIX_FMT_BGR24   v4l2_fourcc('B', 'G', 'R', '3') /* 24  BGR-8-8-8     */
506607ca46eSDavid Howells #define V4L2_PIX_FMT_RGB24   v4l2_fourcc('R', 'G', 'B', '3') /* 24  RGB-8-8-8     */
507607ca46eSDavid Howells #define V4L2_PIX_FMT_BGR32   v4l2_fourcc('B', 'G', 'R', '4') /* 32  BGR-8-8-8-8   */
508977ff0e4SLaurent Pinchart #define V4L2_PIX_FMT_ABGR32  v4l2_fourcc('A', 'R', '2', '4') /* 32  BGRA-8-8-8-8  */
509977ff0e4SLaurent Pinchart #define V4L2_PIX_FMT_XBGR32  v4l2_fourcc('X', 'R', '2', '4') /* 32  BGRX-8-8-8-8  */
510607ca46eSDavid Howells #define V4L2_PIX_FMT_RGB32   v4l2_fourcc('R', 'G', 'B', '4') /* 32  RGB-8-8-8-8   */
511977ff0e4SLaurent Pinchart #define V4L2_PIX_FMT_ARGB32  v4l2_fourcc('B', 'A', '2', '4') /* 32  ARGB-8-8-8-8  */
512977ff0e4SLaurent Pinchart #define V4L2_PIX_FMT_XRGB32  v4l2_fourcc('B', 'X', '2', '4') /* 32  XRGB-8-8-8-8  */
513607ca46eSDavid Howells 
514607ca46eSDavid Howells /* Grey formats */
515607ca46eSDavid Howells #define V4L2_PIX_FMT_GREY    v4l2_fourcc('G', 'R', 'E', 'Y') /*  8  Greyscale     */
516607ca46eSDavid Howells #define V4L2_PIX_FMT_Y4      v4l2_fourcc('Y', '0', '4', ' ') /*  4  Greyscale     */
517607ca46eSDavid Howells #define V4L2_PIX_FMT_Y6      v4l2_fourcc('Y', '0', '6', ' ') /*  6  Greyscale     */
518607ca46eSDavid Howells #define V4L2_PIX_FMT_Y10     v4l2_fourcc('Y', '1', '0', ' ') /* 10  Greyscale     */
519607ca46eSDavid Howells #define V4L2_PIX_FMT_Y12     v4l2_fourcc('Y', '1', '2', ' ') /* 12  Greyscale     */
520607ca46eSDavid Howells #define V4L2_PIX_FMT_Y16     v4l2_fourcc('Y', '1', '6', ' ') /* 16  Greyscale     */
5212e5e435fSRicardo Ribalda #define V4L2_PIX_FMT_Y16_BE  v4l2_fourcc_be('Y', '1', '6', ' ') /* 16  Greyscale BE  */
522607ca46eSDavid Howells 
523607ca46eSDavid Howells /* Grey bit-packed formats */
524607ca46eSDavid Howells #define V4L2_PIX_FMT_Y10BPACK    v4l2_fourcc('Y', '1', '0', 'B') /* 10  Greyscale bit-packed */
5256e15bec4STodor Tomov #define V4L2_PIX_FMT_Y10P    v4l2_fourcc('Y', '1', '0', 'P') /* 10  Greyscale, MIPI RAW10 packed */
526607ca46eSDavid Howells 
527607ca46eSDavid Howells /* Palette formats */
528607ca46eSDavid Howells #define V4L2_PIX_FMT_PAL8    v4l2_fourcc('P', 'A', 'L', '8') /*  8  8-bit palette */
529607ca46eSDavid Howells 
53005ad6fc1SManjunath Hadli /* Chrominance formats */
53105ad6fc1SManjunath Hadli #define V4L2_PIX_FMT_UV8     v4l2_fourcc('U', 'V', '8', ' ') /*  8  UV 4:4 */
53205ad6fc1SManjunath Hadli 
533607ca46eSDavid Howells /* Luminance+Chrominance formats */
534607ca46eSDavid Howells #define V4L2_PIX_FMT_YUYV    v4l2_fourcc('Y', 'U', 'Y', 'V') /* 16  YUV 4:2:2     */
535607ca46eSDavid Howells #define V4L2_PIX_FMT_YYUV    v4l2_fourcc('Y', 'Y', 'U', 'V') /* 16  YUV 4:2:2     */
536607ca46eSDavid Howells #define V4L2_PIX_FMT_YVYU    v4l2_fourcc('Y', 'V', 'Y', 'U') /* 16 YVU 4:2:2 */
537607ca46eSDavid Howells #define V4L2_PIX_FMT_UYVY    v4l2_fourcc('U', 'Y', 'V', 'Y') /* 16  YUV 4:2:2     */
538607ca46eSDavid Howells #define V4L2_PIX_FMT_VYUY    v4l2_fourcc('V', 'Y', 'U', 'Y') /* 16  YUV 4:2:2     */
539607ca46eSDavid Howells #define V4L2_PIX_FMT_Y41P    v4l2_fourcc('Y', '4', '1', 'P') /* 12  YUV 4:1:1     */
540607ca46eSDavid Howells #define V4L2_PIX_FMT_YUV444  v4l2_fourcc('Y', '4', '4', '4') /* 16  xxxxyyyy uuuuvvvv */
541607ca46eSDavid Howells #define V4L2_PIX_FMT_YUV555  v4l2_fourcc('Y', 'U', 'V', 'O') /* 16  YUV-5-5-5     */
542607ca46eSDavid Howells #define V4L2_PIX_FMT_YUV565  v4l2_fourcc('Y', 'U', 'V', 'P') /* 16  YUV-5-6-5     */
543607ca46eSDavid Howells #define V4L2_PIX_FMT_YUV32   v4l2_fourcc('Y', 'U', 'V', '4') /* 32  YUV-8-8-8-8   */
544607ca46eSDavid Howells #define V4L2_PIX_FMT_HI240   v4l2_fourcc('H', 'I', '2', '4') /*  8  8-bit color   */
545607ca46eSDavid Howells #define V4L2_PIX_FMT_HM12    v4l2_fourcc('H', 'M', '1', '2') /*  8  YUV 4:2:0 16x16 macroblocks */
546607ca46eSDavid Howells #define V4L2_PIX_FMT_M420    v4l2_fourcc('M', '4', '2', '0') /* 12  YUV 4:2:0 2 lines y, 1 line uv interleaved */
547607ca46eSDavid Howells 
548607ca46eSDavid Howells /* two planes -- one Y, one Cr + Cb interleaved  */
549607ca46eSDavid Howells #define V4L2_PIX_FMT_NV12    v4l2_fourcc('N', 'V', '1', '2') /* 12  Y/CbCr 4:2:0  */
550607ca46eSDavid Howells #define V4L2_PIX_FMT_NV21    v4l2_fourcc('N', 'V', '2', '1') /* 12  Y/CrCb 4:2:0  */
551607ca46eSDavid Howells #define V4L2_PIX_FMT_NV16    v4l2_fourcc('N', 'V', '1', '6') /* 16  Y/CbCr 4:2:2  */
552607ca46eSDavid Howells #define V4L2_PIX_FMT_NV61    v4l2_fourcc('N', 'V', '6', '1') /* 16  Y/CrCb 4:2:2  */
553607ca46eSDavid Howells #define V4L2_PIX_FMT_NV24    v4l2_fourcc('N', 'V', '2', '4') /* 24  Y/CbCr 4:4:4  */
554607ca46eSDavid Howells #define V4L2_PIX_FMT_NV42    v4l2_fourcc('N', 'V', '4', '2') /* 24  Y/CrCb 4:4:4  */
555607ca46eSDavid Howells 
556607ca46eSDavid Howells /* two non contiguous planes - one Y, one Cr + Cb interleaved  */
557607ca46eSDavid Howells #define V4L2_PIX_FMT_NV12M   v4l2_fourcc('N', 'M', '1', '2') /* 12  Y/CbCr 4:2:0  */
558607ca46eSDavid Howells #define V4L2_PIX_FMT_NV21M   v4l2_fourcc('N', 'M', '2', '1') /* 21  Y/CrCb 4:2:0  */
55984930548SLaurent Pinchart #define V4L2_PIX_FMT_NV16M   v4l2_fourcc('N', 'M', '1', '6') /* 16  Y/CbCr 4:2:2  */
56084930548SLaurent Pinchart #define V4L2_PIX_FMT_NV61M   v4l2_fourcc('N', 'M', '6', '1') /* 16  Y/CrCb 4:2:2  */
561607ca46eSDavid Howells #define V4L2_PIX_FMT_NV12MT  v4l2_fourcc('T', 'M', '1', '2') /* 12  Y/CbCr 4:2:0 64x32 macroblocks */
562607ca46eSDavid Howells #define V4L2_PIX_FMT_NV12MT_16X16 v4l2_fourcc('V', 'M', '1', '2') /* 12  Y/CbCr 4:2:0 16x16 macroblocks */
563607ca46eSDavid Howells 
56479c8d083SLaurent Pinchart /* three planes - Y Cb, Cr */
56579c8d083SLaurent Pinchart #define V4L2_PIX_FMT_YUV410  v4l2_fourcc('Y', 'U', 'V', '9') /*  9  YUV 4:1:0     */
56679c8d083SLaurent Pinchart #define V4L2_PIX_FMT_YVU410  v4l2_fourcc('Y', 'V', 'U', '9') /*  9  YVU 4:1:0     */
567ab46f6d2SLaurent Pinchart #define V4L2_PIX_FMT_YUV411P v4l2_fourcc('4', '1', '1', 'P') /* 12  YVU411 planar */
56879c8d083SLaurent Pinchart #define V4L2_PIX_FMT_YUV420  v4l2_fourcc('Y', 'U', '1', '2') /* 12  YUV 4:2:0     */
56979c8d083SLaurent Pinchart #define V4L2_PIX_FMT_YVU420  v4l2_fourcc('Y', 'V', '1', '2') /* 12  YVU 4:2:0     */
57079c8d083SLaurent Pinchart #define V4L2_PIX_FMT_YUV422P v4l2_fourcc('4', '2', '2', 'P') /* 16  YVU422 planar */
57179c8d083SLaurent Pinchart 
572607ca46eSDavid Howells /* three non contiguous planes - Y, Cb, Cr */
573607ca46eSDavid Howells #define V4L2_PIX_FMT_YUV420M v4l2_fourcc('Y', 'M', '1', '2') /* 12  YUV420 planar */
574607ca46eSDavid Howells #define V4L2_PIX_FMT_YVU420M v4l2_fourcc('Y', 'M', '2', '1') /* 12  YVU420 planar */
575d65fae92SLaurent Pinchart #define V4L2_PIX_FMT_YUV422M v4l2_fourcc('Y', 'M', '1', '6') /* 16  YUV422 planar */
576d65fae92SLaurent Pinchart #define V4L2_PIX_FMT_YVU422M v4l2_fourcc('Y', 'M', '6', '1') /* 16  YVU422 planar */
577d65fae92SLaurent Pinchart #define V4L2_PIX_FMT_YUV444M v4l2_fourcc('Y', 'M', '2', '4') /* 24  YUV444 planar */
578d65fae92SLaurent Pinchart #define V4L2_PIX_FMT_YVU444M v4l2_fourcc('Y', 'M', '4', '2') /* 24  YVU444 planar */
579607ca46eSDavid Howells 
580607ca46eSDavid Howells /* Bayer formats - see http://www.siliconimaging.com/RGB%20Bayer.htm */
581607ca46eSDavid Howells #define V4L2_PIX_FMT_SBGGR8  v4l2_fourcc('B', 'A', '8', '1') /*  8  BGBG.. GRGR.. */
582607ca46eSDavid Howells #define V4L2_PIX_FMT_SGBRG8  v4l2_fourcc('G', 'B', 'R', 'G') /*  8  GBGB.. RGRG.. */
583607ca46eSDavid Howells #define V4L2_PIX_FMT_SGRBG8  v4l2_fourcc('G', 'R', 'B', 'G') /*  8  GRGR.. BGBG.. */
584607ca46eSDavid Howells #define V4L2_PIX_FMT_SRGGB8  v4l2_fourcc('R', 'G', 'G', 'B') /*  8  RGRG.. GBGB.. */
585607ca46eSDavid Howells #define V4L2_PIX_FMT_SBGGR10 v4l2_fourcc('B', 'G', '1', '0') /* 10  BGBG.. GRGR.. */
586607ca46eSDavid Howells #define V4L2_PIX_FMT_SGBRG10 v4l2_fourcc('G', 'B', '1', '0') /* 10  GBGB.. RGRG.. */
587607ca46eSDavid Howells #define V4L2_PIX_FMT_SGRBG10 v4l2_fourcc('B', 'A', '1', '0') /* 10  GRGR.. BGBG.. */
588607ca46eSDavid Howells #define V4L2_PIX_FMT_SRGGB10 v4l2_fourcc('R', 'G', '1', '0') /* 10  RGRG.. GBGB.. */
5894353e36eSAviv Greenberg 	/* 10bit raw bayer packed, 5 bytes for every 4 pixels */
5904353e36eSAviv Greenberg #define V4L2_PIX_FMT_SBGGR10P v4l2_fourcc('p', 'B', 'A', 'A')
5914353e36eSAviv Greenberg #define V4L2_PIX_FMT_SGBRG10P v4l2_fourcc('p', 'G', 'A', 'A')
5924353e36eSAviv Greenberg #define V4L2_PIX_FMT_SGRBG10P v4l2_fourcc('p', 'g', 'A', 'A')
5934353e36eSAviv Greenberg #define V4L2_PIX_FMT_SRGGB10P v4l2_fourcc('p', 'R', 'A', 'A')
59405ad6fc1SManjunath Hadli 	/* 10bit raw bayer a-law compressed to 8 bits */
59505ad6fc1SManjunath Hadli #define V4L2_PIX_FMT_SBGGR10ALAW8 v4l2_fourcc('a', 'B', 'A', '8')
59605ad6fc1SManjunath Hadli #define V4L2_PIX_FMT_SGBRG10ALAW8 v4l2_fourcc('a', 'G', 'A', '8')
59705ad6fc1SManjunath Hadli #define V4L2_PIX_FMT_SGRBG10ALAW8 v4l2_fourcc('a', 'g', 'A', '8')
59805ad6fc1SManjunath Hadli #define V4L2_PIX_FMT_SRGGB10ALAW8 v4l2_fourcc('a', 'R', 'A', '8')
599607ca46eSDavid Howells 	/* 10bit raw bayer DPCM compressed to 8 bits */
600607ca46eSDavid Howells #define V4L2_PIX_FMT_SBGGR10DPCM8 v4l2_fourcc('b', 'B', 'A', '8')
601607ca46eSDavid Howells #define V4L2_PIX_FMT_SGBRG10DPCM8 v4l2_fourcc('b', 'G', 'A', '8')
602607ca46eSDavid Howells #define V4L2_PIX_FMT_SGRBG10DPCM8 v4l2_fourcc('B', 'D', '1', '0')
603607ca46eSDavid Howells #define V4L2_PIX_FMT_SRGGB10DPCM8 v4l2_fourcc('b', 'R', 'A', '8')
604cbb77bc2SSakari Ailus #define V4L2_PIX_FMT_SBGGR12 v4l2_fourcc('B', 'G', '1', '2') /* 12  BGBG.. GRGR.. */
605cbb77bc2SSakari Ailus #define V4L2_PIX_FMT_SGBRG12 v4l2_fourcc('G', 'B', '1', '2') /* 12  GBGB.. RGRG.. */
606cbb77bc2SSakari Ailus #define V4L2_PIX_FMT_SGRBG12 v4l2_fourcc('B', 'A', '1', '2') /* 12  GRGR.. BGBG.. */
607cbb77bc2SSakari Ailus #define V4L2_PIX_FMT_SRGGB12 v4l2_fourcc('R', 'G', '1', '2') /* 12  RGRG.. GBGB.. */
608d1b3437eSSakari Ailus 	/* 12bit raw bayer packed, 6 bytes for every 4 pixels */
609d1b3437eSSakari Ailus #define V4L2_PIX_FMT_SBGGR12P v4l2_fourcc('p', 'B', 'C', 'C')
610d1b3437eSSakari Ailus #define V4L2_PIX_FMT_SGBRG12P v4l2_fourcc('p', 'G', 'C', 'C')
611d1b3437eSSakari Ailus #define V4L2_PIX_FMT_SGRBG12P v4l2_fourcc('p', 'g', 'C', 'C')
612d1b3437eSSakari Ailus #define V4L2_PIX_FMT_SRGGB12P v4l2_fourcc('p', 'R', 'C', 'C')
61383b15832SSakari Ailus 	/* 14bit raw bayer packed, 7 bytes for every 4 pixels */
61483b15832SSakari Ailus #define V4L2_PIX_FMT_SBGGR14P v4l2_fourcc('p', 'B', 'E', 'E')
61583b15832SSakari Ailus #define V4L2_PIX_FMT_SGBRG14P v4l2_fourcc('p', 'G', 'E', 'E')
61683b15832SSakari Ailus #define V4L2_PIX_FMT_SGRBG14P v4l2_fourcc('p', 'g', 'E', 'E')
61783b15832SSakari Ailus #define V4L2_PIX_FMT_SRGGB14P v4l2_fourcc('p', 'R', 'E', 'E')
618607ca46eSDavid Howells #define V4L2_PIX_FMT_SBGGR16 v4l2_fourcc('B', 'Y', 'R', '2') /* 16  BGBG.. GRGR.. */
619b9a4b13cSSakari Ailus #define V4L2_PIX_FMT_SGBRG16 v4l2_fourcc('G', 'B', '1', '6') /* 16  GBGB.. RGRG.. */
620b9a4b13cSSakari Ailus #define V4L2_PIX_FMT_SGRBG16 v4l2_fourcc('G', 'R', '1', '6') /* 16  GRGR.. BGBG.. */
621b9a4b13cSSakari Ailus #define V4L2_PIX_FMT_SRGGB16 v4l2_fourcc('R', 'G', '1', '6') /* 16  RGRG.. GBGB.. */
622607ca46eSDavid Howells 
62366b2ab27SRicardo Ribalda Delgado /* HSV formats */
62466b2ab27SRicardo Ribalda Delgado #define V4L2_PIX_FMT_HSV24 v4l2_fourcc('H', 'S', 'V', '3')
62566b2ab27SRicardo Ribalda Delgado #define V4L2_PIX_FMT_HSV32 v4l2_fourcc('H', 'S', 'V', '4')
62666b2ab27SRicardo Ribalda Delgado 
627607ca46eSDavid Howells /* compressed formats */
628607ca46eSDavid Howells #define V4L2_PIX_FMT_MJPEG    v4l2_fourcc('M', 'J', 'P', 'G') /* Motion-JPEG   */
629607ca46eSDavid Howells #define V4L2_PIX_FMT_JPEG     v4l2_fourcc('J', 'P', 'E', 'G') /* JFIF JPEG     */
630607ca46eSDavid Howells #define V4L2_PIX_FMT_DV       v4l2_fourcc('d', 'v', 's', 'd') /* 1394          */
631607ca46eSDavid Howells #define V4L2_PIX_FMT_MPEG     v4l2_fourcc('M', 'P', 'E', 'G') /* MPEG-1/2/4 Multiplexed */
632607ca46eSDavid Howells #define V4L2_PIX_FMT_H264     v4l2_fourcc('H', '2', '6', '4') /* H264 with start codes */
633607ca46eSDavid Howells #define V4L2_PIX_FMT_H264_NO_SC v4l2_fourcc('A', 'V', 'C', '1') /* H264 without start codes */
634607ca46eSDavid Howells #define V4L2_PIX_FMT_H264_MVC v4l2_fourcc('M', '2', '6', '4') /* H264 MVC */
635607ca46eSDavid Howells #define V4L2_PIX_FMT_H263     v4l2_fourcc('H', '2', '6', '3') /* H263          */
636607ca46eSDavid Howells #define V4L2_PIX_FMT_MPEG1    v4l2_fourcc('M', 'P', 'G', '1') /* MPEG-1 ES     */
637607ca46eSDavid Howells #define V4L2_PIX_FMT_MPEG2    v4l2_fourcc('M', 'P', 'G', '2') /* MPEG-2 ES     */
638c27bb30eSPaul Kocialkowski #define V4L2_PIX_FMT_MPEG2_SLICE v4l2_fourcc('M', 'G', '2', 'S') /* MPEG-2 parsed slice data */
639adf62712SIsmael Luceno #define V4L2_PIX_FMT_MPEG4    v4l2_fourcc('M', 'P', 'G', '4') /* MPEG-4 part 2 ES */
640607ca46eSDavid Howells #define V4L2_PIX_FMT_XVID     v4l2_fourcc('X', 'V', 'I', 'D') /* Xvid           */
641607ca46eSDavid Howells #define V4L2_PIX_FMT_VC1_ANNEX_G v4l2_fourcc('V', 'C', '1', 'G') /* SMPTE 421M Annex G compliant stream */
642607ca46eSDavid Howells #define V4L2_PIX_FMT_VC1_ANNEX_L v4l2_fourcc('V', 'C', '1', 'L') /* SMPTE 421M Annex L compliant stream */
643607ca46eSDavid Howells #define V4L2_PIX_FMT_VP8      v4l2_fourcc('V', 'P', '8', '0') /* VP8 */
644a8b4a1eaSWu-Cheng Li #define V4L2_PIX_FMT_VP9      v4l2_fourcc('V', 'P', '9', '0') /* VP9 */
64553b25345SSmitha T Murthy #define V4L2_PIX_FMT_HEVC     v4l2_fourcc('H', 'E', 'V', 'C') /* HEVC aka H.265 */
64662c3fce0SHans Verkuil #define V4L2_PIX_FMT_FWHT     v4l2_fourcc('F', 'W', 'H', 'T') /* Fast Walsh Hadamard Transform (vicodec) */
647607ca46eSDavid Howells 
648607ca46eSDavid Howells /*  Vendor-specific formats   */
649607ca46eSDavid Howells #define V4L2_PIX_FMT_CPIA1    v4l2_fourcc('C', 'P', 'I', 'A') /* cpia1 YUV */
650607ca46eSDavid Howells #define V4L2_PIX_FMT_WNVA     v4l2_fourcc('W', 'N', 'V', 'A') /* Winnov hw compress */
651607ca46eSDavid Howells #define V4L2_PIX_FMT_SN9C10X  v4l2_fourcc('S', '9', '1', '0') /* SN9C10x compression */
652607ca46eSDavid Howells #define V4L2_PIX_FMT_SN9C20X_I420 v4l2_fourcc('S', '9', '2', '0') /* SN9C20x YUV 4:2:0 */
653607ca46eSDavid Howells #define V4L2_PIX_FMT_PWC1     v4l2_fourcc('P', 'W', 'C', '1') /* pwc older webcam */
654607ca46eSDavid Howells #define V4L2_PIX_FMT_PWC2     v4l2_fourcc('P', 'W', 'C', '2') /* pwc newer webcam */
655607ca46eSDavid Howells #define V4L2_PIX_FMT_ET61X251 v4l2_fourcc('E', '6', '2', '5') /* ET61X251 compression */
656607ca46eSDavid Howells #define V4L2_PIX_FMT_SPCA501  v4l2_fourcc('S', '5', '0', '1') /* YUYV per line */
657607ca46eSDavid Howells #define V4L2_PIX_FMT_SPCA505  v4l2_fourcc('S', '5', '0', '5') /* YYUV per line */
658607ca46eSDavid Howells #define V4L2_PIX_FMT_SPCA508  v4l2_fourcc('S', '5', '0', '8') /* YUVY per line */
659607ca46eSDavid Howells #define V4L2_PIX_FMT_SPCA561  v4l2_fourcc('S', '5', '6', '1') /* compressed GBRG bayer */
660607ca46eSDavid Howells #define V4L2_PIX_FMT_PAC207   v4l2_fourcc('P', '2', '0', '7') /* compressed BGGR bayer */
661607ca46eSDavid Howells #define V4L2_PIX_FMT_MR97310A v4l2_fourcc('M', '3', '1', '0') /* compressed BGGR bayer */
662607ca46eSDavid Howells #define V4L2_PIX_FMT_JL2005BCD v4l2_fourcc('J', 'L', '2', '0') /* compressed RGGB bayer */
663607ca46eSDavid Howells #define V4L2_PIX_FMT_SN9C2028 v4l2_fourcc('S', 'O', 'N', 'X') /* compressed GBRG bayer */
664607ca46eSDavid Howells #define V4L2_PIX_FMT_SQ905C   v4l2_fourcc('9', '0', '5', 'C') /* compressed RGGB bayer */
665607ca46eSDavid Howells #define V4L2_PIX_FMT_PJPG     v4l2_fourcc('P', 'J', 'P', 'G') /* Pixart 73xx JPEG */
666607ca46eSDavid Howells #define V4L2_PIX_FMT_OV511    v4l2_fourcc('O', '5', '1', '1') /* ov511 JPEG */
667607ca46eSDavid Howells #define V4L2_PIX_FMT_OV518    v4l2_fourcc('O', '5', '1', '8') /* ov518 JPEG */
668607ca46eSDavid Howells #define V4L2_PIX_FMT_STV0680  v4l2_fourcc('S', '6', '8', '0') /* stv0680 bayer */
669607ca46eSDavid Howells #define V4L2_PIX_FMT_TM6000   v4l2_fourcc('T', 'M', '6', '0') /* tm5600/tm60x0 */
670607ca46eSDavid Howells #define V4L2_PIX_FMT_CIT_YYVYUY v4l2_fourcc('C', 'I', 'T', 'V') /* one line of Y then 1 line of VYUY */
671607ca46eSDavid Howells #define V4L2_PIX_FMT_KONICA420  v4l2_fourcc('K', 'O', 'N', 'I') /* YUV420 planar in blocks of 256 pixels */
672607ca46eSDavid Howells #define V4L2_PIX_FMT_JPGL	v4l2_fourcc('J', 'P', 'G', 'L') /* JPEG-Lite */
673607ca46eSDavid Howells #define V4L2_PIX_FMT_SE401      v4l2_fourcc('S', '4', '0', '1') /* se401 janggu compressed rgb */
674607ca46eSDavid Howells #define V4L2_PIX_FMT_S5C_UYVY_JPG v4l2_fourcc('S', '5', 'C', 'I') /* S5C73M3 interleaved UYVY/JPEG */
6755d8d8db8SAviv Greenberg #define V4L2_PIX_FMT_Y8I      v4l2_fourcc('Y', '8', 'I', ' ') /* Greyscale 8-bit L/R interleaved */
6765d8d8db8SAviv Greenberg #define V4L2_PIX_FMT_Y12I     v4l2_fourcc('Y', '1', '2', 'I') /* Greyscale 12-bit L/R interleaved */
6775d8d8db8SAviv Greenberg #define V4L2_PIX_FMT_Z16      v4l2_fourcc('Z', '1', '6', ' ') /* Depth data 16-bit */
678d4de6634STiffany Lin #define V4L2_PIX_FMT_MT21C    v4l2_fourcc('M', 'T', '2', '1') /* Mediatek compressed block mode  */
6795df082e2SEvgeni Raikhel #define V4L2_PIX_FMT_INZI     v4l2_fourcc('I', 'N', 'Z', 'I') /* Intel Planar Greyscale 10-bit and Depth 16-bit */
680*36cf35b7SPaul Kocialkowski #define V4L2_PIX_FMT_SUNXI_TILED_NV12 v4l2_fourcc('S', 'T', '1', '2') /* Sunxi Tiled NV12 Format */
681607ca46eSDavid Howells 
682e8391b76SYong Zhi /* 10bit raw bayer packed, 32 bytes for every 25 pixels, last LSB 6 bits unused */
683e8391b76SYong Zhi #define V4L2_PIX_FMT_IPU3_SBGGR10	v4l2_fourcc('i', 'p', '3', 'b') /* IPU3 packed 10-bit BGGR bayer */
684e8391b76SYong Zhi #define V4L2_PIX_FMT_IPU3_SGBRG10	v4l2_fourcc('i', 'p', '3', 'g') /* IPU3 packed 10-bit GBRG bayer */
685e8391b76SYong Zhi #define V4L2_PIX_FMT_IPU3_SGRBG10	v4l2_fourcc('i', 'p', '3', 'G') /* IPU3 packed 10-bit GRBG bayer */
686e8391b76SYong Zhi #define V4L2_PIX_FMT_IPU3_SRGGB10	v4l2_fourcc('i', 'p', '3', 'r') /* IPU3 packed 10-bit RGGB bayer */
687e8391b76SYong Zhi 
68800419a6aSAntti Palosaari /* SDR formats - used only for Software Defined Radio devices */
68900419a6aSAntti Palosaari #define V4L2_SDR_FMT_CU8          v4l2_fourcc('C', 'U', '0', '8') /* IQ u8 */
69000419a6aSAntti Palosaari #define V4L2_SDR_FMT_CU16LE       v4l2_fourcc('C', 'U', '1', '6') /* IQ u16le */
691c0c03886SAntti Palosaari #define V4L2_SDR_FMT_CS8          v4l2_fourcc('C', 'S', '0', '8') /* complex s8 */
6925c5be570SAntti Palosaari #define V4L2_SDR_FMT_CS14LE       v4l2_fourcc('C', 'S', '1', '4') /* complex s14le */
6939e9e3927SAntti Palosaari #define V4L2_SDR_FMT_RU12LE       v4l2_fourcc('R', 'U', '1', '2') /* real u12le */
694c28f2118SRamesh Shanmugasundaram #define V4L2_SDR_FMT_PCU16BE	  v4l2_fourcc('P', 'C', '1', '6') /* planar complex u16be */
695c28f2118SRamesh Shanmugasundaram #define V4L2_SDR_FMT_PCU18BE	  v4l2_fourcc('P', 'C', '1', '8') /* planar complex u18be */
696c28f2118SRamesh Shanmugasundaram #define V4L2_SDR_FMT_PCU20BE	  v4l2_fourcc('P', 'C', '2', '0') /* planar complex u20be */
69700419a6aSAntti Palosaari 
698b2fe22d0SNick Dyer /* Touch formats - used for Touch devices */
699b2fe22d0SNick Dyer #define V4L2_TCH_FMT_DELTA_TD16	v4l2_fourcc('T', 'D', '1', '6') /* 16-bit signed deltas */
700b2fe22d0SNick Dyer #define V4L2_TCH_FMT_DELTA_TD08	v4l2_fourcc('T', 'D', '0', '8') /* 8-bit signed deltas */
701b2fe22d0SNick Dyer #define V4L2_TCH_FMT_TU16	v4l2_fourcc('T', 'U', '1', '6') /* 16-bit unsigned touch data */
702b2fe22d0SNick Dyer #define V4L2_TCH_FMT_TU08	v4l2_fourcc('T', 'U', '0', '8') /* 8-bit unsigned touch data */
703b2fe22d0SNick Dyer 
70414d66538SLaurent Pinchart /* Meta-data formats */
7055deb1c04SNiklas Söderlund #define V4L2_META_FMT_VSP1_HGO    v4l2_fourcc('V', 'S', 'P', 'H') /* R-Car VSP1 1-D Histogram */
7065deb1c04SNiklas Söderlund #define V4L2_META_FMT_VSP1_HGT    v4l2_fourcc('V', 'S', 'P', 'T') /* R-Car VSP1 2-D Histogram */
707563a01e1SGuennadi Liakhovetski #define V4L2_META_FMT_UVC         v4l2_fourcc('U', 'V', 'C', 'H') /* UVC Payload Header metadata */
70814d66538SLaurent Pinchart 
709d52e2381SLaurent Pinchart /* priv field value to indicates that subsequent fields are valid. */
710d52e2381SLaurent Pinchart #define V4L2_PIX_FMT_PRIV_MAGIC		0xfeedcafe
711d52e2381SLaurent Pinchart 
712c96fd46aSLaurent Pinchart /* Flags */
713c96fd46aSLaurent Pinchart #define V4L2_PIX_FMT_FLAG_PREMUL_ALPHA	0x00000001
714c96fd46aSLaurent Pinchart 
715607ca46eSDavid Howells /*
716607ca46eSDavid Howells  *	F O R M A T   E N U M E R A T I O N
717607ca46eSDavid Howells  */
718607ca46eSDavid Howells struct v4l2_fmtdesc {
719607ca46eSDavid Howells 	__u32		    index;             /* Format number      */
720607ca46eSDavid Howells 	__u32		    type;              /* enum v4l2_buf_type */
721607ca46eSDavid Howells 	__u32               flags;
722607ca46eSDavid Howells 	__u8		    description[32];   /* Description string */
723607ca46eSDavid Howells 	__u32		    pixelformat;       /* Format fourcc      */
724607ca46eSDavid Howells 	__u32		    reserved[4];
725607ca46eSDavid Howells };
726607ca46eSDavid Howells 
727607ca46eSDavid Howells #define V4L2_FMT_FLAG_COMPRESSED 0x0001
728607ca46eSDavid Howells #define V4L2_FMT_FLAG_EMULATED   0x0002
729607ca46eSDavid Howells 
73057c75987SHans Verkuil 	/* Frame Size and frame rate enumeration */
731607ca46eSDavid Howells /*
732607ca46eSDavid Howells  *	F R A M E   S I Z E   E N U M E R A T I O N
733607ca46eSDavid Howells  */
734607ca46eSDavid Howells enum v4l2_frmsizetypes {
735607ca46eSDavid Howells 	V4L2_FRMSIZE_TYPE_DISCRETE	= 1,
736607ca46eSDavid Howells 	V4L2_FRMSIZE_TYPE_CONTINUOUS	= 2,
737607ca46eSDavid Howells 	V4L2_FRMSIZE_TYPE_STEPWISE	= 3,
738607ca46eSDavid Howells };
739607ca46eSDavid Howells 
740607ca46eSDavid Howells struct v4l2_frmsize_discrete {
741607ca46eSDavid Howells 	__u32			width;		/* Frame width [pixel] */
742607ca46eSDavid Howells 	__u32			height;		/* Frame height [pixel] */
743607ca46eSDavid Howells };
744607ca46eSDavid Howells 
745607ca46eSDavid Howells struct v4l2_frmsize_stepwise {
746607ca46eSDavid Howells 	__u32			min_width;	/* Minimum frame width [pixel] */
747607ca46eSDavid Howells 	__u32			max_width;	/* Maximum frame width [pixel] */
748607ca46eSDavid Howells 	__u32			step_width;	/* Frame width step size [pixel] */
749607ca46eSDavid Howells 	__u32			min_height;	/* Minimum frame height [pixel] */
750607ca46eSDavid Howells 	__u32			max_height;	/* Maximum frame height [pixel] */
751607ca46eSDavid Howells 	__u32			step_height;	/* Frame height step size [pixel] */
752607ca46eSDavid Howells };
753607ca46eSDavid Howells 
754607ca46eSDavid Howells struct v4l2_frmsizeenum {
755607ca46eSDavid Howells 	__u32			index;		/* Frame size number */
756607ca46eSDavid Howells 	__u32			pixel_format;	/* Pixel format */
757607ca46eSDavid Howells 	__u32			type;		/* Frame size type the device supports. */
758607ca46eSDavid Howells 
759607ca46eSDavid Howells 	union {					/* Frame size */
760607ca46eSDavid Howells 		struct v4l2_frmsize_discrete	discrete;
761607ca46eSDavid Howells 		struct v4l2_frmsize_stepwise	stepwise;
762607ca46eSDavid Howells 	};
763607ca46eSDavid Howells 
764607ca46eSDavid Howells 	__u32   reserved[2];			/* Reserved space for future use */
765607ca46eSDavid Howells };
766607ca46eSDavid Howells 
767607ca46eSDavid Howells /*
768607ca46eSDavid Howells  *	F R A M E   R A T E   E N U M E R A T I O N
769607ca46eSDavid Howells  */
770607ca46eSDavid Howells enum v4l2_frmivaltypes {
771607ca46eSDavid Howells 	V4L2_FRMIVAL_TYPE_DISCRETE	= 1,
772607ca46eSDavid Howells 	V4L2_FRMIVAL_TYPE_CONTINUOUS	= 2,
773607ca46eSDavid Howells 	V4L2_FRMIVAL_TYPE_STEPWISE	= 3,
774607ca46eSDavid Howells };
775607ca46eSDavid Howells 
776607ca46eSDavid Howells struct v4l2_frmival_stepwise {
777607ca46eSDavid Howells 	struct v4l2_fract	min;		/* Minimum frame interval [s] */
778607ca46eSDavid Howells 	struct v4l2_fract	max;		/* Maximum frame interval [s] */
779607ca46eSDavid Howells 	struct v4l2_fract	step;		/* Frame interval step size [s] */
780607ca46eSDavid Howells };
781607ca46eSDavid Howells 
782607ca46eSDavid Howells struct v4l2_frmivalenum {
783607ca46eSDavid Howells 	__u32			index;		/* Frame format index */
784607ca46eSDavid Howells 	__u32			pixel_format;	/* Pixel format */
785607ca46eSDavid Howells 	__u32			width;		/* Frame width */
786607ca46eSDavid Howells 	__u32			height;		/* Frame height */
787607ca46eSDavid Howells 	__u32			type;		/* Frame interval type the device supports. */
788607ca46eSDavid Howells 
789607ca46eSDavid Howells 	union {					/* Frame interval */
790607ca46eSDavid Howells 		struct v4l2_fract		discrete;
791607ca46eSDavid Howells 		struct v4l2_frmival_stepwise	stepwise;
792607ca46eSDavid Howells 	};
793607ca46eSDavid Howells 
794607ca46eSDavid Howells 	__u32	reserved[2];			/* Reserved space for future use */
795607ca46eSDavid Howells };
796607ca46eSDavid Howells 
797607ca46eSDavid Howells /*
798607ca46eSDavid Howells  *	T I M E C O D E
799607ca46eSDavid Howells  */
800607ca46eSDavid Howells struct v4l2_timecode {
801607ca46eSDavid Howells 	__u32	type;
802607ca46eSDavid Howells 	__u32	flags;
803607ca46eSDavid Howells 	__u8	frames;
804607ca46eSDavid Howells 	__u8	seconds;
805607ca46eSDavid Howells 	__u8	minutes;
806607ca46eSDavid Howells 	__u8	hours;
807607ca46eSDavid Howells 	__u8	userbits[4];
808607ca46eSDavid Howells };
809607ca46eSDavid Howells 
810607ca46eSDavid Howells /*  Type  */
811607ca46eSDavid Howells #define V4L2_TC_TYPE_24FPS		1
812607ca46eSDavid Howells #define V4L2_TC_TYPE_25FPS		2
813607ca46eSDavid Howells #define V4L2_TC_TYPE_30FPS		3
814607ca46eSDavid Howells #define V4L2_TC_TYPE_50FPS		4
815607ca46eSDavid Howells #define V4L2_TC_TYPE_60FPS		5
816607ca46eSDavid Howells 
817607ca46eSDavid Howells /*  Flags  */
818607ca46eSDavid Howells #define V4L2_TC_FLAG_DROPFRAME		0x0001 /* "drop-frame" mode */
819607ca46eSDavid Howells #define V4L2_TC_FLAG_COLORFRAME		0x0002
820607ca46eSDavid Howells #define V4L2_TC_USERBITS_field		0x000C
821607ca46eSDavid Howells #define V4L2_TC_USERBITS_USERDEFINED	0x0000
822607ca46eSDavid Howells #define V4L2_TC_USERBITS_8BITCHARS	0x0008
823607ca46eSDavid Howells /* The above is based on SMPTE timecodes */
824607ca46eSDavid Howells 
825607ca46eSDavid Howells struct v4l2_jpegcompression {
826607ca46eSDavid Howells 	int quality;
827607ca46eSDavid Howells 
828607ca46eSDavid Howells 	int  APPn;              /* Number of APP segment to be written,
829607ca46eSDavid Howells 				 * must be 0..15 */
830607ca46eSDavid Howells 	int  APP_len;           /* Length of data in JPEG APPn segment */
831607ca46eSDavid Howells 	char APP_data[60];      /* Data in the JPEG APPn segment. */
832607ca46eSDavid Howells 
833607ca46eSDavid Howells 	int  COM_len;           /* Length of data in JPEG COM segment */
834607ca46eSDavid Howells 	char COM_data[60];      /* Data in JPEG COM segment */
835607ca46eSDavid Howells 
836607ca46eSDavid Howells 	__u32 jpeg_markers;     /* Which markers should go into the JPEG
837607ca46eSDavid Howells 				 * output. Unless you exactly know what
838607ca46eSDavid Howells 				 * you do, leave them untouched.
839ff29feb9SLad, Prabhakar 				 * Including less markers will make the
840607ca46eSDavid Howells 				 * resulting code smaller, but there will
841607ca46eSDavid Howells 				 * be fewer applications which can read it.
842607ca46eSDavid Howells 				 * The presence of the APP and COM marker
843607ca46eSDavid Howells 				 * is influenced by APP_len and COM_len
844607ca46eSDavid Howells 				 * ONLY, not by this property! */
845607ca46eSDavid Howells 
846607ca46eSDavid Howells #define V4L2_JPEG_MARKER_DHT (1<<3)    /* Define Huffman Tables */
847607ca46eSDavid Howells #define V4L2_JPEG_MARKER_DQT (1<<4)    /* Define Quantization Tables */
848607ca46eSDavid Howells #define V4L2_JPEG_MARKER_DRI (1<<5)    /* Define Restart Interval */
849607ca46eSDavid Howells #define V4L2_JPEG_MARKER_COM (1<<6)    /* Comment segment */
850607ca46eSDavid Howells #define V4L2_JPEG_MARKER_APP (1<<7)    /* App segment, driver will
851ff29feb9SLad, Prabhakar 					* always use APP0 */
852607ca46eSDavid Howells };
853607ca46eSDavid Howells 
854607ca46eSDavid Howells /*
855607ca46eSDavid Howells  *	M E M O R Y - M A P P I N G   B U F F E R S
856607ca46eSDavid Howells  */
857607ca46eSDavid Howells struct v4l2_requestbuffers {
858607ca46eSDavid Howells 	__u32			count;
859607ca46eSDavid Howells 	__u32			type;		/* enum v4l2_buf_type */
860607ca46eSDavid Howells 	__u32			memory;		/* enum v4l2_memory */
861f35f5d72SHans Verkuil 	__u32			capabilities;
862f35f5d72SHans Verkuil 	__u32			reserved[1];
863607ca46eSDavid Howells };
864607ca46eSDavid Howells 
865f35f5d72SHans Verkuil /* capabilities for struct v4l2_requestbuffers and v4l2_create_buffers */
866f35f5d72SHans Verkuil #define V4L2_BUF_CAP_SUPPORTS_MMAP	(1 << 0)
867f35f5d72SHans Verkuil #define V4L2_BUF_CAP_SUPPORTS_USERPTR	(1 << 1)
868f35f5d72SHans Verkuil #define V4L2_BUF_CAP_SUPPORTS_DMABUF	(1 << 2)
869f35f5d72SHans Verkuil #define V4L2_BUF_CAP_SUPPORTS_REQUESTS	(1 << 3)
870f35f5d72SHans Verkuil 
871607ca46eSDavid Howells /**
872607ca46eSDavid Howells  * struct v4l2_plane - plane info for multi-planar buffers
873607ca46eSDavid Howells  * @bytesused:		number of bytes occupied by data in the plane (payload)
874607ca46eSDavid Howells  * @length:		size of this plane (NOT the payload) in bytes
875607ca46eSDavid Howells  * @mem_offset:		when memory in the associated struct v4l2_buffer is
876607ca46eSDavid Howells  *			V4L2_MEMORY_MMAP, equals the offset from the start of
877607ca46eSDavid Howells  *			the device memory for this plane (or is a "cookie" that
878607ca46eSDavid Howells  *			should be passed to mmap() called on the video node)
879607ca46eSDavid Howells  * @userptr:		when memory is V4L2_MEMORY_USERPTR, a userspace pointer
880607ca46eSDavid Howells  *			pointing to this plane
881051c7788SSumit Semwal  * @fd:			when memory is V4L2_MEMORY_DMABUF, a userspace file
882051c7788SSumit Semwal  *			descriptor associated with this plane
883607ca46eSDavid Howells  * @data_offset:	offset in the plane to the start of data; usually 0,
884607ca46eSDavid Howells  *			unless there is a header in front of the data
885607ca46eSDavid Howells  *
886607ca46eSDavid Howells  * Multi-planar buffers consist of one or more planes, e.g. an YCbCr buffer
887607ca46eSDavid Howells  * with two planes can have one plane for Y, and another for interleaved CbCr
888607ca46eSDavid Howells  * components. Each plane can reside in a separate memory buffer, or even in
889607ca46eSDavid Howells  * a completely separate memory node (e.g. in embedded devices).
890607ca46eSDavid Howells  */
891607ca46eSDavid Howells struct v4l2_plane {
892607ca46eSDavid Howells 	__u32			bytesused;
893607ca46eSDavid Howells 	__u32			length;
894607ca46eSDavid Howells 	union {
895607ca46eSDavid Howells 		__u32		mem_offset;
896607ca46eSDavid Howells 		unsigned long	userptr;
897051c7788SSumit Semwal 		__s32		fd;
898607ca46eSDavid Howells 	} m;
899607ca46eSDavid Howells 	__u32			data_offset;
900607ca46eSDavid Howells 	__u32			reserved[11];
901607ca46eSDavid Howells };
902607ca46eSDavid Howells 
903607ca46eSDavid Howells /**
904607ca46eSDavid Howells  * struct v4l2_buffer - video buffer info
905607ca46eSDavid Howells  * @index:	id number of the buffer
906607ca46eSDavid Howells  * @type:	enum v4l2_buf_type; buffer type (type == *_MPLANE for
907607ca46eSDavid Howells  *		multiplanar buffers);
908607ca46eSDavid Howells  * @bytesused:	number of bytes occupied by data in the buffer (payload);
909607ca46eSDavid Howells  *		unused (set to 0) for multiplanar buffers
910607ca46eSDavid Howells  * @flags:	buffer informational flags
911607ca46eSDavid Howells  * @field:	enum v4l2_field; field order of the image in the buffer
912607ca46eSDavid Howells  * @timestamp:	frame timestamp
913607ca46eSDavid Howells  * @timecode:	frame timecode
914607ca46eSDavid Howells  * @sequence:	sequence count of this frame
915607ca46eSDavid Howells  * @memory:	enum v4l2_memory; the method, in which the actual video data is
916607ca46eSDavid Howells  *		passed
917607ca46eSDavid Howells  * @offset:	for non-multiplanar buffers with memory == V4L2_MEMORY_MMAP;
918607ca46eSDavid Howells  *		offset from the start of the device memory for this plane,
919607ca46eSDavid Howells  *		(or a "cookie" that should be passed to mmap() as offset)
920607ca46eSDavid Howells  * @userptr:	for non-multiplanar buffers with memory == V4L2_MEMORY_USERPTR;
921607ca46eSDavid Howells  *		a userspace pointer pointing to this buffer
922051c7788SSumit Semwal  * @fd:		for non-multiplanar buffers with memory == V4L2_MEMORY_DMABUF;
923051c7788SSumit Semwal  *		a userspace file descriptor associated with this buffer
924607ca46eSDavid Howells  * @planes:	for multiplanar buffers; userspace pointer to the array of plane
925607ca46eSDavid Howells  *		info structs for this buffer
926607ca46eSDavid Howells  * @length:	size in bytes of the buffer (NOT its payload) for single-plane
927607ca46eSDavid Howells  *		buffers (when type != *_MPLANE); number of elements in the
928607ca46eSDavid Howells  *		planes array for multi-plane buffers
92962fed26fSHans Verkuil  * @request_fd: fd of the request that this buffer should use
930607ca46eSDavid Howells  *
931607ca46eSDavid Howells  * Contains data exchanged by application and driver using one of the Streaming
932607ca46eSDavid Howells  * I/O methods.
933607ca46eSDavid Howells  */
934607ca46eSDavid Howells struct v4l2_buffer {
935607ca46eSDavid Howells 	__u32			index;
936607ca46eSDavid Howells 	__u32			type;
937607ca46eSDavid Howells 	__u32			bytesused;
938607ca46eSDavid Howells 	__u32			flags;
939607ca46eSDavid Howells 	__u32			field;
940607ca46eSDavid Howells 	struct timeval		timestamp;
941607ca46eSDavid Howells 	struct v4l2_timecode	timecode;
942607ca46eSDavid Howells 	__u32			sequence;
943607ca46eSDavid Howells 
944607ca46eSDavid Howells 	/* memory location */
945607ca46eSDavid Howells 	__u32			memory;
946607ca46eSDavid Howells 	union {
947607ca46eSDavid Howells 		__u32           offset;
948607ca46eSDavid Howells 		unsigned long   userptr;
949607ca46eSDavid Howells 		struct v4l2_plane *planes;
950051c7788SSumit Semwal 		__s32		fd;
951607ca46eSDavid Howells 	} m;
952607ca46eSDavid Howells 	__u32			length;
953607ca46eSDavid Howells 	__u32			reserved2;
95462fed26fSHans Verkuil 	union {
95562fed26fSHans Verkuil 		__s32		request_fd;
956607ca46eSDavid Howells 		__u32		reserved;
957607ca46eSDavid Howells 	};
95862fed26fSHans Verkuil };
959607ca46eSDavid Howells 
960607ca46eSDavid Howells /*  Flags for 'flags' field */
961939f1377SSakari Ailus /* Buffer is mapped (flag) */
962939f1377SSakari Ailus #define V4L2_BUF_FLAG_MAPPED			0x00000001
963939f1377SSakari Ailus /* Buffer is queued for processing */
964939f1377SSakari Ailus #define V4L2_BUF_FLAG_QUEUED			0x00000002
965939f1377SSakari Ailus /* Buffer is ready */
966939f1377SSakari Ailus #define V4L2_BUF_FLAG_DONE			0x00000004
967939f1377SSakari Ailus /* Image is a keyframe (I-frame) */
968939f1377SSakari Ailus #define V4L2_BUF_FLAG_KEYFRAME			0x00000008
969939f1377SSakari Ailus /* Image is a P-frame */
970939f1377SSakari Ailus #define V4L2_BUF_FLAG_PFRAME			0x00000010
971939f1377SSakari Ailus /* Image is a B-frame */
972939f1377SSakari Ailus #define V4L2_BUF_FLAG_BFRAME			0x00000020
973607ca46eSDavid Howells /* Buffer is ready, but the data contained within is corrupted. */
974939f1377SSakari Ailus #define V4L2_BUF_FLAG_ERROR			0x00000040
97562fed26fSHans Verkuil /* Buffer is added to an unqueued request */
97662fed26fSHans Verkuil #define V4L2_BUF_FLAG_IN_REQUEST		0x00000080
977939f1377SSakari Ailus /* timecode field is valid */
978939f1377SSakari Ailus #define V4L2_BUF_FLAG_TIMECODE			0x00000100
979939f1377SSakari Ailus /* Buffer is prepared for queuing */
980939f1377SSakari Ailus #define V4L2_BUF_FLAG_PREPARED			0x00000400
981607ca46eSDavid Howells /* Cache handling flags */
982939f1377SSakari Ailus #define V4L2_BUF_FLAG_NO_CACHE_INVALIDATE	0x00000800
983939f1377SSakari Ailus #define V4L2_BUF_FLAG_NO_CACHE_CLEAN		0x00001000
9841202ecdcSSakari Ailus /* Timestamp type */
985939f1377SSakari Ailus #define V4L2_BUF_FLAG_TIMESTAMP_MASK		0x0000e000
986939f1377SSakari Ailus #define V4L2_BUF_FLAG_TIMESTAMP_UNKNOWN		0x00000000
987939f1377SSakari Ailus #define V4L2_BUF_FLAG_TIMESTAMP_MONOTONIC	0x00002000
988939f1377SSakari Ailus #define V4L2_BUF_FLAG_TIMESTAMP_COPY		0x00004000
989872484ceSSakari Ailus /* Timestamp sources. */
990872484ceSSakari Ailus #define V4L2_BUF_FLAG_TSTAMP_SRC_MASK		0x00070000
991872484ceSSakari Ailus #define V4L2_BUF_FLAG_TSTAMP_SRC_EOF		0x00000000
992872484ceSSakari Ailus #define V4L2_BUF_FLAG_TSTAMP_SRC_SOE		0x00010000
993dc199241SPeter Seiderer /* mem2mem encoder/decoder */
994dc199241SPeter Seiderer #define V4L2_BUF_FLAG_LAST			0x00100000
99562fed26fSHans Verkuil /* request_fd is valid */
99662fed26fSHans Verkuil #define V4L2_BUF_FLAG_REQUEST_FD		0x00800000
997607ca46eSDavid Howells 
998b799d09aSTomasz Stanislawski /**
999b799d09aSTomasz Stanislawski  * struct v4l2_exportbuffer - export of video buffer as DMABUF file descriptor
1000b799d09aSTomasz Stanislawski  *
1001b799d09aSTomasz Stanislawski  * @index:	id number of the buffer
1002b799d09aSTomasz Stanislawski  * @type:	enum v4l2_buf_type; buffer type (type == *_MPLANE for
1003b799d09aSTomasz Stanislawski  *		multiplanar buffers);
1004b799d09aSTomasz Stanislawski  * @plane:	index of the plane to be exported, 0 for single plane queues
1005b799d09aSTomasz Stanislawski  * @flags:	flags for newly created file, currently only O_CLOEXEC is
1006b799d09aSTomasz Stanislawski  *		supported, refer to manual of open syscall for more details
1007b799d09aSTomasz Stanislawski  * @fd:		file descriptor associated with DMABUF (set by driver)
1008b799d09aSTomasz Stanislawski  *
1009b799d09aSTomasz Stanislawski  * Contains data used for exporting a video buffer as DMABUF file descriptor.
1010b799d09aSTomasz Stanislawski  * The buffer is identified by a 'cookie' returned by VIDIOC_QUERYBUF
1011b799d09aSTomasz Stanislawski  * (identical to the cookie used to mmap() the buffer to userspace). All
1012b799d09aSTomasz Stanislawski  * reserved fields must be set to zero. The field reserved0 is expected to
1013b799d09aSTomasz Stanislawski  * become a structure 'type' allowing an alternative layout of the structure
1014b799d09aSTomasz Stanislawski  * content. Therefore this field should not be used for any other extensions.
1015b799d09aSTomasz Stanislawski  */
1016b799d09aSTomasz Stanislawski struct v4l2_exportbuffer {
1017b799d09aSTomasz Stanislawski 	__u32		type; /* enum v4l2_buf_type */
1018b799d09aSTomasz Stanislawski 	__u32		index;
1019b799d09aSTomasz Stanislawski 	__u32		plane;
1020b799d09aSTomasz Stanislawski 	__u32		flags;
1021b799d09aSTomasz Stanislawski 	__s32		fd;
1022b799d09aSTomasz Stanislawski 	__u32		reserved[11];
1023b799d09aSTomasz Stanislawski };
1024b799d09aSTomasz Stanislawski 
1025607ca46eSDavid Howells /*
1026607ca46eSDavid Howells  *	O V E R L A Y   P R E V I E W
1027607ca46eSDavid Howells  */
1028607ca46eSDavid Howells struct v4l2_framebuffer {
1029607ca46eSDavid Howells 	__u32			capability;
1030607ca46eSDavid Howells 	__u32			flags;
1031607ca46eSDavid Howells /* FIXME: in theory we should pass something like PCI device + memory
1032607ca46eSDavid Howells  * region + offset instead of some physical address */
1033607ca46eSDavid Howells 	void                    *base;
1034d52e2381SLaurent Pinchart 	struct {
1035d52e2381SLaurent Pinchart 		__u32		width;
1036d52e2381SLaurent Pinchart 		__u32		height;
1037d52e2381SLaurent Pinchart 		__u32		pixelformat;
1038d52e2381SLaurent Pinchart 		__u32		field;		/* enum v4l2_field */
1039d52e2381SLaurent Pinchart 		__u32		bytesperline;	/* for padding, zero if unused */
1040d52e2381SLaurent Pinchart 		__u32		sizeimage;
1041d52e2381SLaurent Pinchart 		__u32		colorspace;	/* enum v4l2_colorspace */
1042d52e2381SLaurent Pinchart 		__u32		priv;		/* reserved field, set to 0 */
1043d52e2381SLaurent Pinchart 	} fmt;
1044607ca46eSDavid Howells };
1045607ca46eSDavid Howells /*  Flags for the 'capability' field. Read only */
1046607ca46eSDavid Howells #define V4L2_FBUF_CAP_EXTERNOVERLAY	0x0001
1047607ca46eSDavid Howells #define V4L2_FBUF_CAP_CHROMAKEY		0x0002
1048607ca46eSDavid Howells #define V4L2_FBUF_CAP_LIST_CLIPPING     0x0004
1049607ca46eSDavid Howells #define V4L2_FBUF_CAP_BITMAP_CLIPPING	0x0008
1050607ca46eSDavid Howells #define V4L2_FBUF_CAP_LOCAL_ALPHA	0x0010
1051607ca46eSDavid Howells #define V4L2_FBUF_CAP_GLOBAL_ALPHA	0x0020
1052607ca46eSDavid Howells #define V4L2_FBUF_CAP_LOCAL_INV_ALPHA	0x0040
1053607ca46eSDavid Howells #define V4L2_FBUF_CAP_SRC_CHROMAKEY	0x0080
1054607ca46eSDavid Howells /*  Flags for the 'flags' field. */
1055607ca46eSDavid Howells #define V4L2_FBUF_FLAG_PRIMARY		0x0001
1056607ca46eSDavid Howells #define V4L2_FBUF_FLAG_OVERLAY		0x0002
1057607ca46eSDavid Howells #define V4L2_FBUF_FLAG_CHROMAKEY	0x0004
1058607ca46eSDavid Howells #define V4L2_FBUF_FLAG_LOCAL_ALPHA	0x0008
1059607ca46eSDavid Howells #define V4L2_FBUF_FLAG_GLOBAL_ALPHA	0x0010
1060607ca46eSDavid Howells #define V4L2_FBUF_FLAG_LOCAL_INV_ALPHA	0x0020
1061607ca46eSDavid Howells #define V4L2_FBUF_FLAG_SRC_CHROMAKEY	0x0040
1062607ca46eSDavid Howells 
1063607ca46eSDavid Howells struct v4l2_clip {
1064607ca46eSDavid Howells 	struct v4l2_rect        c;
1065607ca46eSDavid Howells 	struct v4l2_clip	__user *next;
1066607ca46eSDavid Howells };
1067607ca46eSDavid Howells 
1068607ca46eSDavid Howells struct v4l2_window {
1069607ca46eSDavid Howells 	struct v4l2_rect        w;
1070607ca46eSDavid Howells 	__u32			field;	 /* enum v4l2_field */
1071607ca46eSDavid Howells 	__u32			chromakey;
1072607ca46eSDavid Howells 	struct v4l2_clip	__user *clips;
1073607ca46eSDavid Howells 	__u32			clipcount;
1074607ca46eSDavid Howells 	void			__user *bitmap;
1075607ca46eSDavid Howells 	__u8                    global_alpha;
1076607ca46eSDavid Howells };
1077607ca46eSDavid Howells 
1078607ca46eSDavid Howells /*
1079607ca46eSDavid Howells  *	C A P T U R E   P A R A M E T E R S
1080607ca46eSDavid Howells  */
1081607ca46eSDavid Howells struct v4l2_captureparm {
1082607ca46eSDavid Howells 	__u32		   capability;	  /*  Supported modes */
1083607ca46eSDavid Howells 	__u32		   capturemode;	  /*  Current mode */
10842e74598dSKirill Smelkov 	struct v4l2_fract  timeperframe;  /*  Time per frame in seconds */
1085607ca46eSDavid Howells 	__u32		   extendedmode;  /*  Driver-specific extensions */
1086607ca46eSDavid Howells 	__u32              readbuffers;   /*  # of buffers for read */
1087607ca46eSDavid Howells 	__u32		   reserved[4];
1088607ca46eSDavid Howells };
1089607ca46eSDavid Howells 
1090607ca46eSDavid Howells /*  Flags for 'capability' and 'capturemode' fields */
1091607ca46eSDavid Howells #define V4L2_MODE_HIGHQUALITY	0x0001	/*  High quality imaging mode */
1092607ca46eSDavid Howells #define V4L2_CAP_TIMEPERFRAME	0x1000	/*  timeperframe field is supported */
1093607ca46eSDavid Howells 
1094607ca46eSDavid Howells struct v4l2_outputparm {
1095607ca46eSDavid Howells 	__u32		   capability;	 /*  Supported modes */
1096607ca46eSDavid Howells 	__u32		   outputmode;	 /*  Current mode */
1097607ca46eSDavid Howells 	struct v4l2_fract  timeperframe; /*  Time per frame in seconds */
1098607ca46eSDavid Howells 	__u32		   extendedmode; /*  Driver-specific extensions */
1099607ca46eSDavid Howells 	__u32              writebuffers; /*  # of buffers for write */
1100607ca46eSDavid Howells 	__u32		   reserved[4];
1101607ca46eSDavid Howells };
1102607ca46eSDavid Howells 
1103607ca46eSDavid Howells /*
1104607ca46eSDavid Howells  *	I N P U T   I M A G E   C R O P P I N G
1105607ca46eSDavid Howells  */
1106607ca46eSDavid Howells struct v4l2_cropcap {
1107607ca46eSDavid Howells 	__u32			type;	/* enum v4l2_buf_type */
1108607ca46eSDavid Howells 	struct v4l2_rect        bounds;
1109607ca46eSDavid Howells 	struct v4l2_rect        defrect;
1110607ca46eSDavid Howells 	struct v4l2_fract       pixelaspect;
1111607ca46eSDavid Howells };
1112607ca46eSDavid Howells 
1113607ca46eSDavid Howells struct v4l2_crop {
1114607ca46eSDavid Howells 	__u32			type;	/* enum v4l2_buf_type */
1115607ca46eSDavid Howells 	struct v4l2_rect        c;
1116607ca46eSDavid Howells };
1117607ca46eSDavid Howells 
1118607ca46eSDavid Howells /**
1119607ca46eSDavid Howells  * struct v4l2_selection - selection info
1120607ca46eSDavid Howells  * @type:	buffer type (do not use *_MPLANE types)
1121607ca46eSDavid Howells  * @target:	Selection target, used to choose one of possible rectangles;
1122607ca46eSDavid Howells  *		defined in v4l2-common.h; V4L2_SEL_TGT_* .
1123607ca46eSDavid Howells  * @flags:	constraints flags, defined in v4l2-common.h; V4L2_SEL_FLAG_*.
1124607ca46eSDavid Howells  * @r:		coordinates of selection window
1125607ca46eSDavid Howells  * @reserved:	for future use, rounds structure size to 64 bytes, set to zero
1126607ca46eSDavid Howells  *
1127607ca46eSDavid Howells  * Hardware may use multiple helper windows to process a video stream.
1128607ca46eSDavid Howells  * The structure is used to exchange this selection areas between
1129607ca46eSDavid Howells  * an application and a driver.
1130607ca46eSDavid Howells  */
1131607ca46eSDavid Howells struct v4l2_selection {
1132607ca46eSDavid Howells 	__u32			type;
1133607ca46eSDavid Howells 	__u32			target;
1134607ca46eSDavid Howells 	__u32                   flags;
1135607ca46eSDavid Howells 	struct v4l2_rect        r;
1136607ca46eSDavid Howells 	__u32                   reserved[9];
1137607ca46eSDavid Howells };
1138607ca46eSDavid Howells 
1139607ca46eSDavid Howells 
1140607ca46eSDavid Howells /*
1141607ca46eSDavid Howells  *      A N A L O G   V I D E O   S T A N D A R D
1142607ca46eSDavid Howells  */
1143607ca46eSDavid Howells 
1144607ca46eSDavid Howells typedef __u64 v4l2_std_id;
1145607ca46eSDavid Howells 
1146607ca46eSDavid Howells /* one bit for each */
1147607ca46eSDavid Howells #define V4L2_STD_PAL_B          ((v4l2_std_id)0x00000001)
1148607ca46eSDavid Howells #define V4L2_STD_PAL_B1         ((v4l2_std_id)0x00000002)
1149607ca46eSDavid Howells #define V4L2_STD_PAL_G          ((v4l2_std_id)0x00000004)
1150607ca46eSDavid Howells #define V4L2_STD_PAL_H          ((v4l2_std_id)0x00000008)
1151607ca46eSDavid Howells #define V4L2_STD_PAL_I          ((v4l2_std_id)0x00000010)
1152607ca46eSDavid Howells #define V4L2_STD_PAL_D          ((v4l2_std_id)0x00000020)
1153607ca46eSDavid Howells #define V4L2_STD_PAL_D1         ((v4l2_std_id)0x00000040)
1154607ca46eSDavid Howells #define V4L2_STD_PAL_K          ((v4l2_std_id)0x00000080)
1155607ca46eSDavid Howells 
1156607ca46eSDavid Howells #define V4L2_STD_PAL_M          ((v4l2_std_id)0x00000100)
1157607ca46eSDavid Howells #define V4L2_STD_PAL_N          ((v4l2_std_id)0x00000200)
1158607ca46eSDavid Howells #define V4L2_STD_PAL_Nc         ((v4l2_std_id)0x00000400)
1159607ca46eSDavid Howells #define V4L2_STD_PAL_60         ((v4l2_std_id)0x00000800)
1160607ca46eSDavid Howells 
1161607ca46eSDavid Howells #define V4L2_STD_NTSC_M         ((v4l2_std_id)0x00001000)	/* BTSC */
1162607ca46eSDavid Howells #define V4L2_STD_NTSC_M_JP      ((v4l2_std_id)0x00002000)	/* EIA-J */
1163607ca46eSDavid Howells #define V4L2_STD_NTSC_443       ((v4l2_std_id)0x00004000)
1164607ca46eSDavid Howells #define V4L2_STD_NTSC_M_KR      ((v4l2_std_id)0x00008000)	/* FM A2 */
1165607ca46eSDavid Howells 
1166607ca46eSDavid Howells #define V4L2_STD_SECAM_B        ((v4l2_std_id)0x00010000)
1167607ca46eSDavid Howells #define V4L2_STD_SECAM_D        ((v4l2_std_id)0x00020000)
1168607ca46eSDavid Howells #define V4L2_STD_SECAM_G        ((v4l2_std_id)0x00040000)
1169607ca46eSDavid Howells #define V4L2_STD_SECAM_H        ((v4l2_std_id)0x00080000)
1170607ca46eSDavid Howells #define V4L2_STD_SECAM_K        ((v4l2_std_id)0x00100000)
1171607ca46eSDavid Howells #define V4L2_STD_SECAM_K1       ((v4l2_std_id)0x00200000)
1172607ca46eSDavid Howells #define V4L2_STD_SECAM_L        ((v4l2_std_id)0x00400000)
1173607ca46eSDavid Howells #define V4L2_STD_SECAM_LC       ((v4l2_std_id)0x00800000)
1174607ca46eSDavid Howells 
1175607ca46eSDavid Howells /* ATSC/HDTV */
1176607ca46eSDavid Howells #define V4L2_STD_ATSC_8_VSB     ((v4l2_std_id)0x01000000)
1177607ca46eSDavid Howells #define V4L2_STD_ATSC_16_VSB    ((v4l2_std_id)0x02000000)
1178607ca46eSDavid Howells 
1179607ca46eSDavid Howells /* FIXME:
1180607ca46eSDavid Howells    Although std_id is 64 bits, there is an issue on PPC32 architecture that
1181607ca46eSDavid Howells    makes switch(__u64) to break. So, there's a hack on v4l2-common.c rounding
1182607ca46eSDavid Howells    this value to 32 bits.
1183607ca46eSDavid Howells    As, currently, the max value is for V4L2_STD_ATSC_16_VSB (30 bits wide),
1184607ca46eSDavid Howells    it should work fine. However, if needed to add more than two standards,
1185607ca46eSDavid Howells    v4l2-common.c should be fixed.
1186607ca46eSDavid Howells  */
1187607ca46eSDavid Howells 
1188607ca46eSDavid Howells /*
1189607ca46eSDavid Howells  * Some macros to merge video standards in order to make live easier for the
1190607ca46eSDavid Howells  * drivers and V4L2 applications
1191607ca46eSDavid Howells  */
1192607ca46eSDavid Howells 
1193607ca46eSDavid Howells /*
1194607ca46eSDavid Howells  * "Common" NTSC/M - It should be noticed that V4L2_STD_NTSC_443 is
1195607ca46eSDavid Howells  * Missing here.
1196607ca46eSDavid Howells  */
1197607ca46eSDavid Howells #define V4L2_STD_NTSC           (V4L2_STD_NTSC_M	|\
1198607ca46eSDavid Howells 				 V4L2_STD_NTSC_M_JP     |\
1199607ca46eSDavid Howells 				 V4L2_STD_NTSC_M_KR)
1200607ca46eSDavid Howells /* Secam macros */
1201607ca46eSDavid Howells #define V4L2_STD_SECAM_DK	(V4L2_STD_SECAM_D	|\
1202607ca46eSDavid Howells 				 V4L2_STD_SECAM_K	|\
1203607ca46eSDavid Howells 				 V4L2_STD_SECAM_K1)
1204607ca46eSDavid Howells /* All Secam Standards */
1205607ca46eSDavid Howells #define V4L2_STD_SECAM		(V4L2_STD_SECAM_B	|\
1206607ca46eSDavid Howells 				 V4L2_STD_SECAM_G	|\
1207607ca46eSDavid Howells 				 V4L2_STD_SECAM_H	|\
1208607ca46eSDavid Howells 				 V4L2_STD_SECAM_DK	|\
1209607ca46eSDavid Howells 				 V4L2_STD_SECAM_L       |\
1210607ca46eSDavid Howells 				 V4L2_STD_SECAM_LC)
1211607ca46eSDavid Howells /* PAL macros */
1212607ca46eSDavid Howells #define V4L2_STD_PAL_BG		(V4L2_STD_PAL_B		|\
1213607ca46eSDavid Howells 				 V4L2_STD_PAL_B1	|\
1214607ca46eSDavid Howells 				 V4L2_STD_PAL_G)
1215607ca46eSDavid Howells #define V4L2_STD_PAL_DK		(V4L2_STD_PAL_D		|\
1216607ca46eSDavid Howells 				 V4L2_STD_PAL_D1	|\
1217607ca46eSDavid Howells 				 V4L2_STD_PAL_K)
1218607ca46eSDavid Howells /*
1219607ca46eSDavid Howells  * "Common" PAL - This macro is there to be compatible with the old
1220607ca46eSDavid Howells  * V4L1 concept of "PAL": /BGDKHI.
1221ff29feb9SLad, Prabhakar  * Several PAL standards are missing here: /M, /N and /Nc
1222607ca46eSDavid Howells  */
1223607ca46eSDavid Howells #define V4L2_STD_PAL		(V4L2_STD_PAL_BG	|\
1224607ca46eSDavid Howells 				 V4L2_STD_PAL_DK	|\
1225607ca46eSDavid Howells 				 V4L2_STD_PAL_H		|\
1226607ca46eSDavid Howells 				 V4L2_STD_PAL_I)
1227607ca46eSDavid Howells /* Chroma "agnostic" standards */
1228607ca46eSDavid Howells #define V4L2_STD_B		(V4L2_STD_PAL_B		|\
1229607ca46eSDavid Howells 				 V4L2_STD_PAL_B1	|\
1230607ca46eSDavid Howells 				 V4L2_STD_SECAM_B)
1231607ca46eSDavid Howells #define V4L2_STD_G		(V4L2_STD_PAL_G		|\
1232607ca46eSDavid Howells 				 V4L2_STD_SECAM_G)
1233607ca46eSDavid Howells #define V4L2_STD_H		(V4L2_STD_PAL_H		|\
1234607ca46eSDavid Howells 				 V4L2_STD_SECAM_H)
1235607ca46eSDavid Howells #define V4L2_STD_L		(V4L2_STD_SECAM_L	|\
1236607ca46eSDavid Howells 				 V4L2_STD_SECAM_LC)
1237607ca46eSDavid Howells #define V4L2_STD_GH		(V4L2_STD_G		|\
1238607ca46eSDavid Howells 				 V4L2_STD_H)
1239607ca46eSDavid Howells #define V4L2_STD_DK		(V4L2_STD_PAL_DK	|\
1240607ca46eSDavid Howells 				 V4L2_STD_SECAM_DK)
1241607ca46eSDavid Howells #define V4L2_STD_BG		(V4L2_STD_B		|\
1242607ca46eSDavid Howells 				 V4L2_STD_G)
1243607ca46eSDavid Howells #define V4L2_STD_MN		(V4L2_STD_PAL_M		|\
1244607ca46eSDavid Howells 				 V4L2_STD_PAL_N		|\
1245607ca46eSDavid Howells 				 V4L2_STD_PAL_Nc	|\
1246607ca46eSDavid Howells 				 V4L2_STD_NTSC)
1247607ca46eSDavid Howells 
1248607ca46eSDavid Howells /* Standards where MTS/BTSC stereo could be found */
1249607ca46eSDavid Howells #define V4L2_STD_MTS		(V4L2_STD_NTSC_M	|\
1250607ca46eSDavid Howells 				 V4L2_STD_PAL_M		|\
1251607ca46eSDavid Howells 				 V4L2_STD_PAL_N		|\
1252607ca46eSDavid Howells 				 V4L2_STD_PAL_Nc)
1253607ca46eSDavid Howells 
1254607ca46eSDavid Howells /* Standards for Countries with 60Hz Line frequency */
1255607ca46eSDavid Howells #define V4L2_STD_525_60		(V4L2_STD_PAL_M		|\
1256607ca46eSDavid Howells 				 V4L2_STD_PAL_60	|\
1257607ca46eSDavid Howells 				 V4L2_STD_NTSC		|\
1258607ca46eSDavid Howells 				 V4L2_STD_NTSC_443)
1259607ca46eSDavid Howells /* Standards for Countries with 50Hz Line frequency */
1260607ca46eSDavid Howells #define V4L2_STD_625_50		(V4L2_STD_PAL		|\
1261607ca46eSDavid Howells 				 V4L2_STD_PAL_N		|\
1262607ca46eSDavid Howells 				 V4L2_STD_PAL_Nc	|\
1263607ca46eSDavid Howells 				 V4L2_STD_SECAM)
1264607ca46eSDavid Howells 
1265607ca46eSDavid Howells #define V4L2_STD_ATSC           (V4L2_STD_ATSC_8_VSB    |\
1266607ca46eSDavid Howells 				 V4L2_STD_ATSC_16_VSB)
1267607ca46eSDavid Howells /* Macros with none and all analog standards */
1268607ca46eSDavid Howells #define V4L2_STD_UNKNOWN        0
1269607ca46eSDavid Howells #define V4L2_STD_ALL            (V4L2_STD_525_60	|\
1270607ca46eSDavid Howells 				 V4L2_STD_625_50)
1271607ca46eSDavid Howells 
1272607ca46eSDavid Howells struct v4l2_standard {
1273607ca46eSDavid Howells 	__u32		     index;
1274607ca46eSDavid Howells 	v4l2_std_id          id;
1275607ca46eSDavid Howells 	__u8		     name[24];
1276607ca46eSDavid Howells 	struct v4l2_fract    frameperiod; /* Frames, not fields */
1277607ca46eSDavid Howells 	__u32		     framelines;
1278607ca46eSDavid Howells 	__u32		     reserved[4];
1279607ca46eSDavid Howells };
1280607ca46eSDavid Howells 
1281607ca46eSDavid Howells /*
1282607ca46eSDavid Howells  *	D V	B T	T I M I N G S
1283607ca46eSDavid Howells  */
1284607ca46eSDavid Howells 
1285607ca46eSDavid Howells /** struct v4l2_bt_timings - BT.656/BT.1120 timing data
1286607ca46eSDavid Howells  * @width:	total width of the active video in pixels
1287607ca46eSDavid Howells  * @height:	total height of the active video in lines
1288607ca46eSDavid Howells  * @interlaced:	Interlaced or progressive
1289607ca46eSDavid Howells  * @polarities:	Positive or negative polarities
1290607ca46eSDavid Howells  * @pixelclock:	Pixel clock in HZ. Ex. 74.25MHz->74250000
1291607ca46eSDavid Howells  * @hfrontporch:Horizontal front porch in pixels
1292607ca46eSDavid Howells  * @hsync:	Horizontal Sync length in pixels
1293607ca46eSDavid Howells  * @hbackporch:	Horizontal back porch in pixels
1294607ca46eSDavid Howells  * @vfrontporch:Vertical front porch in lines
1295607ca46eSDavid Howells  * @vsync:	Vertical Sync length in lines
1296607ca46eSDavid Howells  * @vbackporch:	Vertical back porch in lines
1297607ca46eSDavid Howells  * @il_vfrontporch:Vertical front porch for the even field
1298607ca46eSDavid Howells  *		(aka field 2) of interlaced field formats
1299607ca46eSDavid Howells  * @il_vsync:	Vertical Sync length for the even field
1300607ca46eSDavid Howells  *		(aka field 2) of interlaced field formats
1301607ca46eSDavid Howells  * @il_vbackporch:Vertical back porch for the even field
1302607ca46eSDavid Howells  *		(aka field 2) of interlaced field formats
1303607ca46eSDavid Howells  * @standards:	Standards the timing belongs to
1304607ca46eSDavid Howells  * @flags:	Flags
13054f100ff6SHans Verkuil  * @picture_aspect: The picture aspect ratio (hor/vert).
13064f100ff6SHans Verkuil  * @cea861_vic:	VIC code as per the CEA-861 standard.
13074f100ff6SHans Verkuil  * @hdmi_vic:	VIC code as per the HDMI standard.
1308607ca46eSDavid Howells  * @reserved:	Reserved fields, must be zeroed.
1309607ca46eSDavid Howells  *
1310607ca46eSDavid Howells  * A note regarding vertical interlaced timings: height refers to the total
1311607ca46eSDavid Howells  * height of the active video frame (= two fields). The blanking timings refer
1312607ca46eSDavid Howells  * to the blanking of each field. So the height of the total frame is
1313607ca46eSDavid Howells  * calculated as follows:
1314607ca46eSDavid Howells  *
1315607ca46eSDavid Howells  * tot_height = height + vfrontporch + vsync + vbackporch +
1316607ca46eSDavid Howells  *                       il_vfrontporch + il_vsync + il_vbackporch
1317607ca46eSDavid Howells  *
1318607ca46eSDavid Howells  * The active height of each field is height / 2.
1319607ca46eSDavid Howells  */
1320607ca46eSDavid Howells struct v4l2_bt_timings {
1321607ca46eSDavid Howells 	__u32	width;
1322607ca46eSDavid Howells 	__u32	height;
1323607ca46eSDavid Howells 	__u32	interlaced;
1324607ca46eSDavid Howells 	__u32	polarities;
1325607ca46eSDavid Howells 	__u64	pixelclock;
1326607ca46eSDavid Howells 	__u32	hfrontporch;
1327607ca46eSDavid Howells 	__u32	hsync;
1328607ca46eSDavid Howells 	__u32	hbackporch;
1329607ca46eSDavid Howells 	__u32	vfrontporch;
1330607ca46eSDavid Howells 	__u32	vsync;
1331607ca46eSDavid Howells 	__u32	vbackporch;
1332607ca46eSDavid Howells 	__u32	il_vfrontporch;
1333607ca46eSDavid Howells 	__u32	il_vsync;
1334607ca46eSDavid Howells 	__u32	il_vbackporch;
1335607ca46eSDavid Howells 	__u32	standards;
1336607ca46eSDavid Howells 	__u32	flags;
13374f100ff6SHans Verkuil 	struct v4l2_fract picture_aspect;
13384f100ff6SHans Verkuil 	__u8	cea861_vic;
13394f100ff6SHans Verkuil 	__u8	hdmi_vic;
13404f100ff6SHans Verkuil 	__u8	reserved[46];
1341607ca46eSDavid Howells } __attribute__ ((packed));
1342607ca46eSDavid Howells 
1343607ca46eSDavid Howells /* Interlaced or progressive format */
1344607ca46eSDavid Howells #define	V4L2_DV_PROGRESSIVE	0
1345607ca46eSDavid Howells #define	V4L2_DV_INTERLACED	1
1346607ca46eSDavid Howells 
1347607ca46eSDavid Howells /* Polarities. If bit is not set, it is assumed to be negative polarity */
1348607ca46eSDavid Howells #define V4L2_DV_VSYNC_POS_POL	0x00000001
1349607ca46eSDavid Howells #define V4L2_DV_HSYNC_POS_POL	0x00000002
1350607ca46eSDavid Howells 
1351607ca46eSDavid Howells /* Timings standards */
1352607ca46eSDavid Howells #define V4L2_DV_BT_STD_CEA861	(1 << 0)  /* CEA-861 Digital TV Profile */
1353607ca46eSDavid Howells #define V4L2_DV_BT_STD_DMT	(1 << 1)  /* VESA Discrete Monitor Timings */
1354607ca46eSDavid Howells #define V4L2_DV_BT_STD_CVT	(1 << 2)  /* VESA Coordinated Video Timings */
1355607ca46eSDavid Howells #define V4L2_DV_BT_STD_GTF	(1 << 3)  /* VESA Generalized Timings Formula */
13567389e6efSCharles-Antoine Couret #define V4L2_DV_BT_STD_SDI	(1 << 4)  /* SDI Timings */
1357607ca46eSDavid Howells 
1358607ca46eSDavid Howells /* Flags */
1359607ca46eSDavid Howells 
13608fbe91e7SHans Verkuil /*
13618fbe91e7SHans Verkuil  * CVT/GTF specific: timing uses reduced blanking (CVT) or the 'Secondary
13628fbe91e7SHans Verkuil  * GTF' curve (GTF). In both cases the horizontal and/or vertical blanking
13638fbe91e7SHans Verkuil  * intervals are reduced, allowing a higher resolution over the same
13648fbe91e7SHans Verkuil  * bandwidth. This is a read-only flag.
13658fbe91e7SHans Verkuil  */
1366607ca46eSDavid Howells #define V4L2_DV_FL_REDUCED_BLANKING		(1 << 0)
13678fbe91e7SHans Verkuil /*
13688fbe91e7SHans Verkuil  * CEA-861 specific: set for CEA-861 formats with a framerate of a multiple
13698fbe91e7SHans Verkuil  * of six. These formats can be optionally played at 1 / 1.001 speed.
13708fbe91e7SHans Verkuil  * This is a read-only flag.
13718fbe91e7SHans Verkuil  */
1372607ca46eSDavid Howells #define V4L2_DV_FL_CAN_REDUCE_FPS		(1 << 1)
13738fbe91e7SHans Verkuil /*
13748fbe91e7SHans Verkuil  * CEA-861 specific: only valid for video transmitters, the flag is cleared
13758fbe91e7SHans Verkuil  * by receivers.
13768fbe91e7SHans Verkuil  * If the framerate of the format is a multiple of six, then the pixelclock
13778fbe91e7SHans Verkuil  * used to set up the transmitter is divided by 1.001 to make it compatible
13788fbe91e7SHans Verkuil  * with 60 Hz based standards such as NTSC and PAL-M that use a framerate of
13798fbe91e7SHans Verkuil  * 29.97 Hz. Otherwise this flag is cleared. If the transmitter can't generate
13808fbe91e7SHans Verkuil  * such frequencies, then the flag will also be cleared.
13818fbe91e7SHans Verkuil  */
1382607ca46eSDavid Howells #define V4L2_DV_FL_REDUCED_FPS			(1 << 2)
13838fbe91e7SHans Verkuil /*
13848fbe91e7SHans Verkuil  * Specific to interlaced formats: if set, then field 1 is really one half-line
13858fbe91e7SHans Verkuil  * longer and field 2 is really one half-line shorter, so each field has
13868fbe91e7SHans Verkuil  * exactly the same number of half-lines. Whether half-lines can be detected
13878fbe91e7SHans Verkuil  * or used depends on the hardware.
13888fbe91e7SHans Verkuil  */
1389292a8787SHans Verkuil #define V4L2_DV_FL_HALF_LINE			(1 << 3)
13908fbe91e7SHans Verkuil /*
13918fbe91e7SHans Verkuil  * If set, then this is a Consumer Electronics (CE) video format. Such formats
13925ce65d1fSHans Verkuil  * differ from other formats (commonly called IT formats) in that if RGB
13935ce65d1fSHans Verkuil  * encoding is used then by default the RGB values use limited range (i.e.
13945ce65d1fSHans Verkuil  * use the range 16-235) as opposed to 0-255. All formats defined in CEA-861
13958fbe91e7SHans Verkuil  * except for the 640x480 format are CE formats.
13968fbe91e7SHans Verkuil  */
13975ce65d1fSHans Verkuil #define V4L2_DV_FL_IS_CE_VIDEO			(1 << 4)
13987389e6efSCharles-Antoine Couret /* Some formats like SMPTE-125M have an interlaced signal with a odd
13997389e6efSCharles-Antoine Couret  * total height. For these formats, if this flag is set, the first
14007389e6efSCharles-Antoine Couret  * field has the extra line. If not, it is the second field.
14017389e6efSCharles-Antoine Couret  */
14027389e6efSCharles-Antoine Couret #define V4L2_DV_FL_FIRST_FIELD_EXTRA_LINE	(1 << 5)
14034f100ff6SHans Verkuil /*
14044f100ff6SHans Verkuil  * If set, then the picture_aspect field is valid. Otherwise assume that the
14054f100ff6SHans Verkuil  * pixels are square, so the picture aspect ratio is the same as the width to
14064f100ff6SHans Verkuil  * height ratio.
14074f100ff6SHans Verkuil  */
14084f100ff6SHans Verkuil #define V4L2_DV_FL_HAS_PICTURE_ASPECT		(1 << 6)
14094f100ff6SHans Verkuil /*
14104f100ff6SHans Verkuil  * If set, then the cea861_vic field is valid and contains the Video
14114f100ff6SHans Verkuil  * Identification Code as per the CEA-861 standard.
14124f100ff6SHans Verkuil  */
14134f100ff6SHans Verkuil #define V4L2_DV_FL_HAS_CEA861_VIC		(1 << 7)
14144f100ff6SHans Verkuil /*
14154f100ff6SHans Verkuil  * If set, then the hdmi_vic field is valid and contains the Video
14164f100ff6SHans Verkuil  * Identification Code as per the HDMI standard (HDMI Vendor Specific
14174f100ff6SHans Verkuil  * InfoFrame).
14184f100ff6SHans Verkuil  */
14194f100ff6SHans Verkuil #define V4L2_DV_FL_HAS_HDMI_VIC			(1 << 8)
1420f992cee5SJose Abreu /*
1421f992cee5SJose Abreu  * CEA-861 specific: only valid for video receivers.
1422f992cee5SJose Abreu  * If set, then HW can detect the difference between regular FPS and
1423f992cee5SJose Abreu  * 1000/1001 FPS. Note: This flag is only valid for HDMI VIC codes with
1424f992cee5SJose Abreu  * the V4L2_DV_FL_CAN_REDUCE_FPS flag set.
1425f992cee5SJose Abreu  */
1426f992cee5SJose Abreu #define V4L2_DV_FL_CAN_DETECT_REDUCED_FPS	(1 << 9)
1427607ca46eSDavid Howells 
14287f68127fSHans Verkuil /* A few useful defines to calculate the total blanking and frame sizes */
14297f68127fSHans Verkuil #define V4L2_DV_BT_BLANKING_WIDTH(bt) \
1430aee786acSHans Verkuil 	((bt)->hfrontporch + (bt)->hsync + (bt)->hbackporch)
14317f68127fSHans Verkuil #define V4L2_DV_BT_FRAME_WIDTH(bt) \
1432aee786acSHans Verkuil 	((bt)->width + V4L2_DV_BT_BLANKING_WIDTH(bt))
14337f68127fSHans Verkuil #define V4L2_DV_BT_BLANKING_HEIGHT(bt) \
1434aee786acSHans Verkuil 	((bt)->vfrontporch + (bt)->vsync + (bt)->vbackporch + \
1435aee786acSHans Verkuil 	 (bt)->il_vfrontporch + (bt)->il_vsync + (bt)->il_vbackporch)
14367f68127fSHans Verkuil #define V4L2_DV_BT_FRAME_HEIGHT(bt) \
1437aee786acSHans Verkuil 	((bt)->height + V4L2_DV_BT_BLANKING_HEIGHT(bt))
1438607ca46eSDavid Howells 
1439607ca46eSDavid Howells /** struct v4l2_dv_timings - DV timings
1440607ca46eSDavid Howells  * @type:	the type of the timings
1441607ca46eSDavid Howells  * @bt:	BT656/1120 timings
1442607ca46eSDavid Howells  */
1443607ca46eSDavid Howells struct v4l2_dv_timings {
1444607ca46eSDavid Howells 	__u32 type;
1445607ca46eSDavid Howells 	union {
1446607ca46eSDavid Howells 		struct v4l2_bt_timings	bt;
1447607ca46eSDavid Howells 		__u32	reserved[32];
1448607ca46eSDavid Howells 	};
1449607ca46eSDavid Howells } __attribute__ ((packed));
1450607ca46eSDavid Howells 
1451607ca46eSDavid Howells /* Values for the type field */
1452607ca46eSDavid Howells #define V4L2_DV_BT_656_1120	0	/* BT.656/1120 timing type */
1453607ca46eSDavid Howells 
1454607ca46eSDavid Howells 
1455607ca46eSDavid Howells /** struct v4l2_enum_dv_timings - DV timings enumeration
1456607ca46eSDavid Howells  * @index:	enumeration index
14570349f6a5SLaurent Pinchart  * @pad:	the pad number for which to enumerate timings (used with
14580349f6a5SLaurent Pinchart  *		v4l-subdev nodes only)
1459607ca46eSDavid Howells  * @reserved:	must be zeroed
1460607ca46eSDavid Howells  * @timings:	the timings for the given index
1461607ca46eSDavid Howells  */
1462607ca46eSDavid Howells struct v4l2_enum_dv_timings {
1463607ca46eSDavid Howells 	__u32 index;
14640349f6a5SLaurent Pinchart 	__u32 pad;
14650349f6a5SLaurent Pinchart 	__u32 reserved[2];
1466607ca46eSDavid Howells 	struct v4l2_dv_timings timings;
1467607ca46eSDavid Howells };
1468607ca46eSDavid Howells 
1469607ca46eSDavid Howells /** struct v4l2_bt_timings_cap - BT.656/BT.1120 timing capabilities
1470607ca46eSDavid Howells  * @min_width:		width in pixels
1471607ca46eSDavid Howells  * @max_width:		width in pixels
1472607ca46eSDavid Howells  * @min_height:		height in lines
1473607ca46eSDavid Howells  * @max_height:		height in lines
1474607ca46eSDavid Howells  * @min_pixelclock:	Pixel clock in HZ. Ex. 74.25MHz->74250000
1475607ca46eSDavid Howells  * @max_pixelclock:	Pixel clock in HZ. Ex. 74.25MHz->74250000
1476607ca46eSDavid Howells  * @standards:		Supported standards
1477607ca46eSDavid Howells  * @capabilities:	Supported capabilities
1478607ca46eSDavid Howells  * @reserved:		Must be zeroed
1479607ca46eSDavid Howells  */
1480607ca46eSDavid Howells struct v4l2_bt_timings_cap {
1481607ca46eSDavid Howells 	__u32	min_width;
1482607ca46eSDavid Howells 	__u32	max_width;
1483607ca46eSDavid Howells 	__u32	min_height;
1484607ca46eSDavid Howells 	__u32	max_height;
1485607ca46eSDavid Howells 	__u64	min_pixelclock;
1486607ca46eSDavid Howells 	__u64	max_pixelclock;
1487607ca46eSDavid Howells 	__u32	standards;
1488607ca46eSDavid Howells 	__u32	capabilities;
1489607ca46eSDavid Howells 	__u32	reserved[16];
1490607ca46eSDavid Howells } __attribute__ ((packed));
1491607ca46eSDavid Howells 
1492607ca46eSDavid Howells /* Supports interlaced formats */
1493607ca46eSDavid Howells #define V4L2_DV_BT_CAP_INTERLACED	(1 << 0)
1494607ca46eSDavid Howells /* Supports progressive formats */
1495607ca46eSDavid Howells #define V4L2_DV_BT_CAP_PROGRESSIVE	(1 << 1)
1496607ca46eSDavid Howells /* Supports CVT/GTF reduced blanking */
1497607ca46eSDavid Howells #define V4L2_DV_BT_CAP_REDUCED_BLANKING	(1 << 2)
1498607ca46eSDavid Howells /* Supports custom formats */
1499607ca46eSDavid Howells #define V4L2_DV_BT_CAP_CUSTOM		(1 << 3)
1500607ca46eSDavid Howells 
1501607ca46eSDavid Howells /** struct v4l2_dv_timings_cap - DV timings capabilities
1502607ca46eSDavid Howells  * @type:	the type of the timings (same as in struct v4l2_dv_timings)
15030349f6a5SLaurent Pinchart  * @pad:	the pad number for which to query capabilities (used with
15040349f6a5SLaurent Pinchart  *		v4l-subdev nodes only)
1505607ca46eSDavid Howells  * @bt:		the BT656/1120 timings capabilities
1506607ca46eSDavid Howells  */
1507607ca46eSDavid Howells struct v4l2_dv_timings_cap {
1508607ca46eSDavid Howells 	__u32 type;
15090349f6a5SLaurent Pinchart 	__u32 pad;
15100349f6a5SLaurent Pinchart 	__u32 reserved[2];
1511607ca46eSDavid Howells 	union {
1512607ca46eSDavid Howells 		struct v4l2_bt_timings_cap bt;
1513607ca46eSDavid Howells 		__u32 raw_data[32];
1514607ca46eSDavid Howells 	};
1515607ca46eSDavid Howells };
1516607ca46eSDavid Howells 
1517607ca46eSDavid Howells 
1518607ca46eSDavid Howells /*
1519607ca46eSDavid Howells  *	V I D E O   I N P U T S
1520607ca46eSDavid Howells  */
1521607ca46eSDavid Howells struct v4l2_input {
1522607ca46eSDavid Howells 	__u32	     index;		/*  Which input */
1523607ca46eSDavid Howells 	__u8	     name[32];		/*  Label */
1524607ca46eSDavid Howells 	__u32	     type;		/*  Type of input */
1525607ca46eSDavid Howells 	__u32	     audioset;		/*  Associated audios (bitfield) */
1526607ca46eSDavid Howells 	__u32        tuner;             /*  enum v4l2_tuner_type */
1527607ca46eSDavid Howells 	v4l2_std_id  std;
1528607ca46eSDavid Howells 	__u32	     status;
1529607ca46eSDavid Howells 	__u32	     capabilities;
1530607ca46eSDavid Howells 	__u32	     reserved[3];
1531607ca46eSDavid Howells };
1532607ca46eSDavid Howells 
1533607ca46eSDavid Howells /*  Values for the 'type' field */
1534607ca46eSDavid Howells #define V4L2_INPUT_TYPE_TUNER		1
1535607ca46eSDavid Howells #define V4L2_INPUT_TYPE_CAMERA		2
1536b2fe22d0SNick Dyer #define V4L2_INPUT_TYPE_TOUCH		3
1537607ca46eSDavid Howells 
1538607ca46eSDavid Howells /* field 'status' - general */
1539607ca46eSDavid Howells #define V4L2_IN_ST_NO_POWER    0x00000001  /* Attached device is off */
1540607ca46eSDavid Howells #define V4L2_IN_ST_NO_SIGNAL   0x00000002
1541607ca46eSDavid Howells #define V4L2_IN_ST_NO_COLOR    0x00000004
1542607ca46eSDavid Howells 
1543607ca46eSDavid Howells /* field 'status' - sensor orientation */
1544607ca46eSDavid Howells /* If sensor is mounted upside down set both bits */
1545607ca46eSDavid Howells #define V4L2_IN_ST_HFLIP       0x00000010 /* Frames are flipped horizontally */
1546607ca46eSDavid Howells #define V4L2_IN_ST_VFLIP       0x00000020 /* Frames are flipped vertically */
1547607ca46eSDavid Howells 
1548607ca46eSDavid Howells /* field 'status' - analog */
1549607ca46eSDavid Howells #define V4L2_IN_ST_NO_H_LOCK   0x00000100  /* No horizontal sync lock */
1550607ca46eSDavid Howells #define V4L2_IN_ST_COLOR_KILL  0x00000200  /* Color killer is active */
15517389e6efSCharles-Antoine Couret #define V4L2_IN_ST_NO_V_LOCK   0x00000400  /* No vertical sync lock */
15527389e6efSCharles-Antoine Couret #define V4L2_IN_ST_NO_STD_LOCK 0x00000800  /* No standard format lock */
1553607ca46eSDavid Howells 
1554607ca46eSDavid Howells /* field 'status' - digital */
1555607ca46eSDavid Howells #define V4L2_IN_ST_NO_SYNC     0x00010000  /* No synchronization lock */
1556607ca46eSDavid Howells #define V4L2_IN_ST_NO_EQU      0x00020000  /* No equalizer lock */
1557607ca46eSDavid Howells #define V4L2_IN_ST_NO_CARRIER  0x00040000  /* Carrier recovery failed */
1558607ca46eSDavid Howells 
1559607ca46eSDavid Howells /* field 'status' - VCR and set-top box */
1560607ca46eSDavid Howells #define V4L2_IN_ST_MACROVISION 0x01000000  /* Macrovision detected */
1561607ca46eSDavid Howells #define V4L2_IN_ST_NO_ACCESS   0x02000000  /* Conditional access denied */
1562607ca46eSDavid Howells #define V4L2_IN_ST_VTR         0x04000000  /* VTR time constant */
1563607ca46eSDavid Howells 
1564607ca46eSDavid Howells /* capabilities flags */
1565607ca46eSDavid Howells #define V4L2_IN_CAP_DV_TIMINGS		0x00000002 /* Supports S_DV_TIMINGS */
1566607ca46eSDavid Howells #define V4L2_IN_CAP_CUSTOM_TIMINGS	V4L2_IN_CAP_DV_TIMINGS /* For compatibility */
1567607ca46eSDavid Howells #define V4L2_IN_CAP_STD			0x00000004 /* Supports S_STD */
15688af03459SSakari Ailus #define V4L2_IN_CAP_NATIVE_SIZE		0x00000008 /* Supports setting native size */
1569607ca46eSDavid Howells 
1570607ca46eSDavid Howells /*
1571607ca46eSDavid Howells  *	V I D E O   O U T P U T S
1572607ca46eSDavid Howells  */
1573607ca46eSDavid Howells struct v4l2_output {
1574607ca46eSDavid Howells 	__u32	     index;		/*  Which output */
1575607ca46eSDavid Howells 	__u8	     name[32];		/*  Label */
1576607ca46eSDavid Howells 	__u32	     type;		/*  Type of output */
1577607ca46eSDavid Howells 	__u32	     audioset;		/*  Associated audios (bitfield) */
1578607ca46eSDavid Howells 	__u32	     modulator;         /*  Associated modulator */
1579607ca46eSDavid Howells 	v4l2_std_id  std;
1580607ca46eSDavid Howells 	__u32	     capabilities;
1581607ca46eSDavid Howells 	__u32	     reserved[3];
1582607ca46eSDavid Howells };
1583607ca46eSDavid Howells /*  Values for the 'type' field */
1584607ca46eSDavid Howells #define V4L2_OUTPUT_TYPE_MODULATOR		1
1585607ca46eSDavid Howells #define V4L2_OUTPUT_TYPE_ANALOG			2
1586607ca46eSDavid Howells #define V4L2_OUTPUT_TYPE_ANALOGVGAOVERLAY	3
1587607ca46eSDavid Howells 
1588607ca46eSDavid Howells /* capabilities flags */
1589607ca46eSDavid Howells #define V4L2_OUT_CAP_DV_TIMINGS		0x00000002 /* Supports S_DV_TIMINGS */
1590607ca46eSDavid Howells #define V4L2_OUT_CAP_CUSTOM_TIMINGS	V4L2_OUT_CAP_DV_TIMINGS /* For compatibility */
1591607ca46eSDavid Howells #define V4L2_OUT_CAP_STD		0x00000004 /* Supports S_STD */
15928af03459SSakari Ailus #define V4L2_OUT_CAP_NATIVE_SIZE	0x00000008 /* Supports setting native size */
1593607ca46eSDavid Howells 
1594607ca46eSDavid Howells /*
1595607ca46eSDavid Howells  *	C O N T R O L S
1596607ca46eSDavid Howells  */
1597607ca46eSDavid Howells struct v4l2_control {
1598607ca46eSDavid Howells 	__u32		     id;
1599607ca46eSDavid Howells 	__s32		     value;
1600607ca46eSDavid Howells };
1601607ca46eSDavid Howells 
1602607ca46eSDavid Howells struct v4l2_ext_control {
1603607ca46eSDavid Howells 	__u32 id;
1604607ca46eSDavid Howells 	__u32 size;
1605607ca46eSDavid Howells 	__u32 reserved2[1];
1606607ca46eSDavid Howells 	union {
1607607ca46eSDavid Howells 		__s32 value;
1608607ca46eSDavid Howells 		__s64 value64;
1609eadf9e26SHans Verkuil 		char __user *string;
1610eadf9e26SHans Verkuil 		__u8 __user *p_u8;
1611eadf9e26SHans Verkuil 		__u16 __user *p_u16;
1612eadf9e26SHans Verkuil 		__u32 __user *p_u32;
1613c27bb30eSPaul Kocialkowski 		struct v4l2_ctrl_mpeg2_slice_params __user *p_mpeg2_slice_params;
1614c27bb30eSPaul Kocialkowski 		struct v4l2_ctrl_mpeg2_quantization __user *p_mpeg2_quantization;
1615eadf9e26SHans Verkuil 		void __user *ptr;
1616607ca46eSDavid Howells 	};
1617607ca46eSDavid Howells } __attribute__ ((packed));
1618607ca46eSDavid Howells 
1619607ca46eSDavid Howells struct v4l2_ext_controls {
162035ec2a2fSRicardo Ribalda 	union {
16210f8017beSRicardo Ribalda #ifndef __KERNEL__
1622607ca46eSDavid Howells 		__u32 ctrl_class;
16230f8017beSRicardo Ribalda #endif
162435ec2a2fSRicardo Ribalda 		__u32 which;
162535ec2a2fSRicardo Ribalda 	};
1626607ca46eSDavid Howells 	__u32 count;
1627607ca46eSDavid Howells 	__u32 error_idx;
1628f23317adSAlexandre Courbot 	__s32 request_fd;
1629f23317adSAlexandre Courbot 	__u32 reserved[1];
1630607ca46eSDavid Howells 	struct v4l2_ext_control *controls;
1631607ca46eSDavid Howells };
1632607ca46eSDavid Howells 
1633607ca46eSDavid Howells #define V4L2_CTRL_ID_MASK	  (0x0fffffff)
16340f8017beSRicardo Ribalda #ifndef __KERNEL__
1635607ca46eSDavid Howells #define V4L2_CTRL_ID2CLASS(id)    ((id) & 0x0fff0000UL)
16360f8017beSRicardo Ribalda #endif
16370f8017beSRicardo Ribalda #define V4L2_CTRL_ID2WHICH(id)    ((id) & 0x0fff0000UL)
1638607ca46eSDavid Howells #define V4L2_CTRL_DRIVER_PRIV(id) (((id) & 0xffff) >= 0x1000)
16395082c241SHans Verkuil #define V4L2_CTRL_MAX_DIMS	  (4)
164035ec2a2fSRicardo Ribalda #define V4L2_CTRL_WHICH_CUR_VAL   0
164135ec2a2fSRicardo Ribalda #define V4L2_CTRL_WHICH_DEF_VAL   0x0f000000
1642f23317adSAlexandre Courbot #define V4L2_CTRL_WHICH_REQUEST_VAL 0x0f010000
1643607ca46eSDavid Howells 
1644607ca46eSDavid Howells enum v4l2_ctrl_type {
1645607ca46eSDavid Howells 	V4L2_CTRL_TYPE_INTEGER	     = 1,
1646607ca46eSDavid Howells 	V4L2_CTRL_TYPE_BOOLEAN	     = 2,
1647607ca46eSDavid Howells 	V4L2_CTRL_TYPE_MENU	     = 3,
1648607ca46eSDavid Howells 	V4L2_CTRL_TYPE_BUTTON	     = 4,
1649607ca46eSDavid Howells 	V4L2_CTRL_TYPE_INTEGER64     = 5,
1650607ca46eSDavid Howells 	V4L2_CTRL_TYPE_CTRL_CLASS    = 6,
1651607ca46eSDavid Howells 	V4L2_CTRL_TYPE_STRING        = 7,
1652607ca46eSDavid Howells 	V4L2_CTRL_TYPE_BITMASK       = 8,
1653607ca46eSDavid Howells 	V4L2_CTRL_TYPE_INTEGER_MENU  = 9,
16547e6a6821SHans Verkuil 
16557e6a6821SHans Verkuil 	/* Compound types are >= 0x0100 */
16567e6a6821SHans Verkuil 	V4L2_CTRL_COMPOUND_TYPES     = 0x0100,
1657dda4a4d5SHans Verkuil 	V4L2_CTRL_TYPE_U8	     = 0x0100,
1658dda4a4d5SHans Verkuil 	V4L2_CTRL_TYPE_U16	     = 0x0101,
1659811c5081SHans Verkuil 	V4L2_CTRL_TYPE_U32	     = 0x0102,
1660c27bb30eSPaul Kocialkowski 	V4L2_CTRL_TYPE_MPEG2_SLICE_PARAMS = 0x0103,
1661c27bb30eSPaul Kocialkowski 	V4L2_CTRL_TYPE_MPEG2_QUANTIZATION = 0x0104,
1662607ca46eSDavid Howells };
1663607ca46eSDavid Howells 
1664607ca46eSDavid Howells /*  Used in the VIDIOC_QUERYCTRL ioctl for querying controls */
1665607ca46eSDavid Howells struct v4l2_queryctrl {
1666607ca46eSDavid Howells 	__u32		     id;
1667607ca46eSDavid Howells 	__u32		     type;	/* enum v4l2_ctrl_type */
1668607ca46eSDavid Howells 	__u8		     name[32];	/* Whatever */
1669607ca46eSDavid Howells 	__s32		     minimum;	/* Note signedness */
1670607ca46eSDavid Howells 	__s32		     maximum;
1671607ca46eSDavid Howells 	__s32		     step;
1672607ca46eSDavid Howells 	__s32		     default_value;
1673607ca46eSDavid Howells 	__u32                flags;
1674607ca46eSDavid Howells 	__u32		     reserved[2];
1675607ca46eSDavid Howells };
1676607ca46eSDavid Howells 
16775082c241SHans Verkuil /*  Used in the VIDIOC_QUERY_EXT_CTRL ioctl for querying extended controls */
16785082c241SHans Verkuil struct v4l2_query_ext_ctrl {
16795082c241SHans Verkuil 	__u32		     id;
16805082c241SHans Verkuil 	__u32		     type;
16815082c241SHans Verkuil 	char		     name[32];
16825082c241SHans Verkuil 	__s64		     minimum;
16835082c241SHans Verkuil 	__s64		     maximum;
16845082c241SHans Verkuil 	__u64		     step;
16855082c241SHans Verkuil 	__s64		     default_value;
16865082c241SHans Verkuil 	__u32                flags;
16875082c241SHans Verkuil 	__u32                elem_size;
16885082c241SHans Verkuil 	__u32                elems;
16895082c241SHans Verkuil 	__u32                nr_of_dims;
16905082c241SHans Verkuil 	__u32                dims[V4L2_CTRL_MAX_DIMS];
16915082c241SHans Verkuil 	__u32		     reserved[32];
16925082c241SHans Verkuil };
16935082c241SHans Verkuil 
1694607ca46eSDavid Howells /*  Used in the VIDIOC_QUERYMENU ioctl for querying menu items */
1695607ca46eSDavid Howells struct v4l2_querymenu {
1696607ca46eSDavid Howells 	__u32		id;
1697607ca46eSDavid Howells 	__u32		index;
1698607ca46eSDavid Howells 	union {
1699607ca46eSDavid Howells 		__u8	name[32];	/* Whatever */
1700607ca46eSDavid Howells 		__s64	value;
1701607ca46eSDavid Howells 	};
1702607ca46eSDavid Howells 	__u32		reserved;
1703607ca46eSDavid Howells } __attribute__ ((packed));
1704607ca46eSDavid Howells 
1705607ca46eSDavid Howells /*  Control flags  */
1706607ca46eSDavid Howells #define V4L2_CTRL_FLAG_DISABLED		0x0001
1707607ca46eSDavid Howells #define V4L2_CTRL_FLAG_GRABBED		0x0002
1708607ca46eSDavid Howells #define V4L2_CTRL_FLAG_READ_ONLY	0x0004
1709607ca46eSDavid Howells #define V4L2_CTRL_FLAG_UPDATE		0x0008
1710607ca46eSDavid Howells #define V4L2_CTRL_FLAG_INACTIVE		0x0010
1711607ca46eSDavid Howells #define V4L2_CTRL_FLAG_SLIDER		0x0020
1712607ca46eSDavid Howells #define V4L2_CTRL_FLAG_WRITE_ONLY	0x0040
1713607ca46eSDavid Howells #define V4L2_CTRL_FLAG_VOLATILE		0x0080
17147e6a6821SHans Verkuil #define V4L2_CTRL_FLAG_HAS_PAYLOAD	0x0100
1715b6e5b8f1SRicardo Ribalda #define V4L2_CTRL_FLAG_EXECUTE_ON_WRITE	0x0200
17166df8be76SHans Verkuil #define V4L2_CTRL_FLAG_MODIFY_LAYOUT	0x0400
1717607ca46eSDavid Howells 
17187e6a6821SHans Verkuil /*  Query flags, to be ORed with the control ID */
1719607ca46eSDavid Howells #define V4L2_CTRL_FLAG_NEXT_CTRL	0x80000000
17207e6a6821SHans Verkuil #define V4L2_CTRL_FLAG_NEXT_COMPOUND	0x40000000
1721607ca46eSDavid Howells 
1722607ca46eSDavid Howells /*  User-class control IDs defined by V4L2 */
1723607ca46eSDavid Howells #define V4L2_CID_MAX_CTRLS		1024
1724607ca46eSDavid Howells /*  IDs reserved for driver specific controls */
1725607ca46eSDavid Howells #define V4L2_CID_PRIVATE_BASE		0x08000000
1726607ca46eSDavid Howells 
1727607ca46eSDavid Howells 
1728607ca46eSDavid Howells /*
1729607ca46eSDavid Howells  *	T U N I N G
1730607ca46eSDavid Howells  */
1731607ca46eSDavid Howells struct v4l2_tuner {
1732607ca46eSDavid Howells 	__u32                   index;
1733607ca46eSDavid Howells 	__u8			name[32];
1734607ca46eSDavid Howells 	__u32			type;	/* enum v4l2_tuner_type */
1735607ca46eSDavid Howells 	__u32			capability;
1736607ca46eSDavid Howells 	__u32			rangelow;
1737607ca46eSDavid Howells 	__u32			rangehigh;
1738607ca46eSDavid Howells 	__u32			rxsubchans;
1739607ca46eSDavid Howells 	__u32			audmode;
1740607ca46eSDavid Howells 	__s32			signal;
1741607ca46eSDavid Howells 	__s32			afc;
1742607ca46eSDavid Howells 	__u32			reserved[4];
1743607ca46eSDavid Howells };
1744607ca46eSDavid Howells 
1745607ca46eSDavid Howells struct v4l2_modulator {
1746607ca46eSDavid Howells 	__u32			index;
1747607ca46eSDavid Howells 	__u8			name[32];
1748607ca46eSDavid Howells 	__u32			capability;
1749607ca46eSDavid Howells 	__u32			rangelow;
1750607ca46eSDavid Howells 	__u32			rangehigh;
1751607ca46eSDavid Howells 	__u32			txsubchans;
17524124a3c4SAntti Palosaari 	__u32			type;	/* enum v4l2_tuner_type */
17534124a3c4SAntti Palosaari 	__u32			reserved[3];
1754607ca46eSDavid Howells };
1755607ca46eSDavid Howells 
1756607ca46eSDavid Howells /*  Flags for the 'capability' field */
1757607ca46eSDavid Howells #define V4L2_TUNER_CAP_LOW		0x0001
1758607ca46eSDavid Howells #define V4L2_TUNER_CAP_NORM		0x0002
1759607ca46eSDavid Howells #define V4L2_TUNER_CAP_HWSEEK_BOUNDED	0x0004
1760607ca46eSDavid Howells #define V4L2_TUNER_CAP_HWSEEK_WRAP	0x0008
1761607ca46eSDavid Howells #define V4L2_TUNER_CAP_STEREO		0x0010
1762607ca46eSDavid Howells #define V4L2_TUNER_CAP_LANG2		0x0020
1763607ca46eSDavid Howells #define V4L2_TUNER_CAP_SAP		0x0020
1764607ca46eSDavid Howells #define V4L2_TUNER_CAP_LANG1		0x0040
1765607ca46eSDavid Howells #define V4L2_TUNER_CAP_RDS		0x0080
1766607ca46eSDavid Howells #define V4L2_TUNER_CAP_RDS_BLOCK_IO	0x0100
1767607ca46eSDavid Howells #define V4L2_TUNER_CAP_RDS_CONTROLS	0x0200
1768607ca46eSDavid Howells #define V4L2_TUNER_CAP_FREQ_BANDS	0x0400
1769607ca46eSDavid Howells #define V4L2_TUNER_CAP_HWSEEK_PROG_LIM	0x0800
177067f9a117SAntti Palosaari #define V4L2_TUNER_CAP_1HZ		0x1000
1771607ca46eSDavid Howells 
1772607ca46eSDavid Howells /*  Flags for the 'rxsubchans' field */
1773607ca46eSDavid Howells #define V4L2_TUNER_SUB_MONO		0x0001
1774607ca46eSDavid Howells #define V4L2_TUNER_SUB_STEREO		0x0002
1775607ca46eSDavid Howells #define V4L2_TUNER_SUB_LANG2		0x0004
1776607ca46eSDavid Howells #define V4L2_TUNER_SUB_SAP		0x0004
1777607ca46eSDavid Howells #define V4L2_TUNER_SUB_LANG1		0x0008
1778607ca46eSDavid Howells #define V4L2_TUNER_SUB_RDS		0x0010
1779607ca46eSDavid Howells 
1780607ca46eSDavid Howells /*  Values for the 'audmode' field */
1781607ca46eSDavid Howells #define V4L2_TUNER_MODE_MONO		0x0000
1782607ca46eSDavid Howells #define V4L2_TUNER_MODE_STEREO		0x0001
1783607ca46eSDavid Howells #define V4L2_TUNER_MODE_LANG2		0x0002
1784607ca46eSDavid Howells #define V4L2_TUNER_MODE_SAP		0x0002
1785607ca46eSDavid Howells #define V4L2_TUNER_MODE_LANG1		0x0003
1786607ca46eSDavid Howells #define V4L2_TUNER_MODE_LANG1_LANG2	0x0004
1787607ca46eSDavid Howells 
1788607ca46eSDavid Howells struct v4l2_frequency {
1789607ca46eSDavid Howells 	__u32	tuner;
1790607ca46eSDavid Howells 	__u32	type;	/* enum v4l2_tuner_type */
1791607ca46eSDavid Howells 	__u32	frequency;
1792607ca46eSDavid Howells 	__u32	reserved[8];
1793607ca46eSDavid Howells };
1794607ca46eSDavid Howells 
1795607ca46eSDavid Howells #define V4L2_BAND_MODULATION_VSB	(1 << 1)
1796607ca46eSDavid Howells #define V4L2_BAND_MODULATION_FM		(1 << 2)
1797607ca46eSDavid Howells #define V4L2_BAND_MODULATION_AM		(1 << 3)
1798607ca46eSDavid Howells 
1799607ca46eSDavid Howells struct v4l2_frequency_band {
1800607ca46eSDavid Howells 	__u32	tuner;
1801607ca46eSDavid Howells 	__u32	type;	/* enum v4l2_tuner_type */
1802607ca46eSDavid Howells 	__u32	index;
1803607ca46eSDavid Howells 	__u32	capability;
1804607ca46eSDavid Howells 	__u32	rangelow;
1805607ca46eSDavid Howells 	__u32	rangehigh;
1806607ca46eSDavid Howells 	__u32	modulation;
1807607ca46eSDavid Howells 	__u32	reserved[9];
1808607ca46eSDavid Howells };
1809607ca46eSDavid Howells 
1810607ca46eSDavid Howells struct v4l2_hw_freq_seek {
1811607ca46eSDavid Howells 	__u32	tuner;
1812607ca46eSDavid Howells 	__u32	type;	/* enum v4l2_tuner_type */
1813607ca46eSDavid Howells 	__u32	seek_upward;
1814607ca46eSDavid Howells 	__u32	wrap_around;
1815607ca46eSDavid Howells 	__u32	spacing;
1816607ca46eSDavid Howells 	__u32	rangelow;
1817607ca46eSDavid Howells 	__u32	rangehigh;
1818607ca46eSDavid Howells 	__u32	reserved[5];
1819607ca46eSDavid Howells };
1820607ca46eSDavid Howells 
1821607ca46eSDavid Howells /*
1822607ca46eSDavid Howells  *	R D S
1823607ca46eSDavid Howells  */
1824607ca46eSDavid Howells 
1825607ca46eSDavid Howells struct v4l2_rds_data {
1826607ca46eSDavid Howells 	__u8	lsb;
1827607ca46eSDavid Howells 	__u8	msb;
1828607ca46eSDavid Howells 	__u8	block;
1829607ca46eSDavid Howells } __attribute__ ((packed));
1830607ca46eSDavid Howells 
1831607ca46eSDavid Howells #define V4L2_RDS_BLOCK_MSK	 0x7
1832607ca46eSDavid Howells #define V4L2_RDS_BLOCK_A	 0
1833607ca46eSDavid Howells #define V4L2_RDS_BLOCK_B	 1
1834607ca46eSDavid Howells #define V4L2_RDS_BLOCK_C	 2
1835607ca46eSDavid Howells #define V4L2_RDS_BLOCK_D	 3
1836607ca46eSDavid Howells #define V4L2_RDS_BLOCK_C_ALT	 4
1837607ca46eSDavid Howells #define V4L2_RDS_BLOCK_INVALID	 7
1838607ca46eSDavid Howells 
1839607ca46eSDavid Howells #define V4L2_RDS_BLOCK_CORRECTED 0x40
1840607ca46eSDavid Howells #define V4L2_RDS_BLOCK_ERROR	 0x80
1841607ca46eSDavid Howells 
1842607ca46eSDavid Howells /*
1843607ca46eSDavid Howells  *	A U D I O
1844607ca46eSDavid Howells  */
1845607ca46eSDavid Howells struct v4l2_audio {
1846607ca46eSDavid Howells 	__u32	index;
1847607ca46eSDavid Howells 	__u8	name[32];
1848607ca46eSDavid Howells 	__u32	capability;
1849607ca46eSDavid Howells 	__u32	mode;
1850607ca46eSDavid Howells 	__u32	reserved[2];
1851607ca46eSDavid Howells };
1852607ca46eSDavid Howells 
1853607ca46eSDavid Howells /*  Flags for the 'capability' field */
1854607ca46eSDavid Howells #define V4L2_AUDCAP_STEREO		0x00001
1855607ca46eSDavid Howells #define V4L2_AUDCAP_AVL			0x00002
1856607ca46eSDavid Howells 
1857607ca46eSDavid Howells /*  Flags for the 'mode' field */
1858607ca46eSDavid Howells #define V4L2_AUDMODE_AVL		0x00001
1859607ca46eSDavid Howells 
1860607ca46eSDavid Howells struct v4l2_audioout {
1861607ca46eSDavid Howells 	__u32	index;
1862607ca46eSDavid Howells 	__u8	name[32];
1863607ca46eSDavid Howells 	__u32	capability;
1864607ca46eSDavid Howells 	__u32	mode;
1865607ca46eSDavid Howells 	__u32	reserved[2];
1866607ca46eSDavid Howells };
1867607ca46eSDavid Howells 
1868607ca46eSDavid Howells /*
1869607ca46eSDavid Howells  *	M P E G   S E R V I C E S
1870607ca46eSDavid Howells  */
1871607ca46eSDavid Howells #if 1
1872607ca46eSDavid Howells #define V4L2_ENC_IDX_FRAME_I    (0)
1873607ca46eSDavid Howells #define V4L2_ENC_IDX_FRAME_P    (1)
1874607ca46eSDavid Howells #define V4L2_ENC_IDX_FRAME_B    (2)
1875607ca46eSDavid Howells #define V4L2_ENC_IDX_FRAME_MASK (0xf)
1876607ca46eSDavid Howells 
1877607ca46eSDavid Howells struct v4l2_enc_idx_entry {
1878607ca46eSDavid Howells 	__u64 offset;
1879607ca46eSDavid Howells 	__u64 pts;
1880607ca46eSDavid Howells 	__u32 length;
1881607ca46eSDavid Howells 	__u32 flags;
1882607ca46eSDavid Howells 	__u32 reserved[2];
1883607ca46eSDavid Howells };
1884607ca46eSDavid Howells 
1885607ca46eSDavid Howells #define V4L2_ENC_IDX_ENTRIES (64)
1886607ca46eSDavid Howells struct v4l2_enc_idx {
1887607ca46eSDavid Howells 	__u32 entries;
1888607ca46eSDavid Howells 	__u32 entries_cap;
1889607ca46eSDavid Howells 	__u32 reserved[4];
1890607ca46eSDavid Howells 	struct v4l2_enc_idx_entry entry[V4L2_ENC_IDX_ENTRIES];
1891607ca46eSDavid Howells };
1892607ca46eSDavid Howells 
1893607ca46eSDavid Howells 
1894607ca46eSDavid Howells #define V4L2_ENC_CMD_START      (0)
1895607ca46eSDavid Howells #define V4L2_ENC_CMD_STOP       (1)
1896607ca46eSDavid Howells #define V4L2_ENC_CMD_PAUSE      (2)
1897607ca46eSDavid Howells #define V4L2_ENC_CMD_RESUME     (3)
1898607ca46eSDavid Howells 
1899607ca46eSDavid Howells /* Flags for V4L2_ENC_CMD_STOP */
1900607ca46eSDavid Howells #define V4L2_ENC_CMD_STOP_AT_GOP_END    (1 << 0)
1901607ca46eSDavid Howells 
1902607ca46eSDavid Howells struct v4l2_encoder_cmd {
1903607ca46eSDavid Howells 	__u32 cmd;
1904607ca46eSDavid Howells 	__u32 flags;
1905607ca46eSDavid Howells 	union {
1906607ca46eSDavid Howells 		struct {
1907607ca46eSDavid Howells 			__u32 data[8];
1908607ca46eSDavid Howells 		} raw;
1909607ca46eSDavid Howells 	};
1910607ca46eSDavid Howells };
1911607ca46eSDavid Howells 
1912607ca46eSDavid Howells /* Decoder commands */
1913607ca46eSDavid Howells #define V4L2_DEC_CMD_START       (0)
1914607ca46eSDavid Howells #define V4L2_DEC_CMD_STOP        (1)
1915607ca46eSDavid Howells #define V4L2_DEC_CMD_PAUSE       (2)
1916607ca46eSDavid Howells #define V4L2_DEC_CMD_RESUME      (3)
1917607ca46eSDavid Howells 
1918607ca46eSDavid Howells /* Flags for V4L2_DEC_CMD_START */
1919607ca46eSDavid Howells #define V4L2_DEC_CMD_START_MUTE_AUDIO	(1 << 0)
1920607ca46eSDavid Howells 
1921607ca46eSDavid Howells /* Flags for V4L2_DEC_CMD_PAUSE */
1922607ca46eSDavid Howells #define V4L2_DEC_CMD_PAUSE_TO_BLACK	(1 << 0)
1923607ca46eSDavid Howells 
1924607ca46eSDavid Howells /* Flags for V4L2_DEC_CMD_STOP */
1925607ca46eSDavid Howells #define V4L2_DEC_CMD_STOP_TO_BLACK	(1 << 0)
1926607ca46eSDavid Howells #define V4L2_DEC_CMD_STOP_IMMEDIATELY	(1 << 1)
1927607ca46eSDavid Howells 
1928607ca46eSDavid Howells /* Play format requirements (returned by the driver): */
1929607ca46eSDavid Howells 
1930607ca46eSDavid Howells /* The decoder has no special format requirements */
1931607ca46eSDavid Howells #define V4L2_DEC_START_FMT_NONE		(0)
1932607ca46eSDavid Howells /* The decoder requires full GOPs */
1933607ca46eSDavid Howells #define V4L2_DEC_START_FMT_GOP		(1)
1934607ca46eSDavid Howells 
1935607ca46eSDavid Howells /* The structure must be zeroed before use by the application
1936607ca46eSDavid Howells    This ensures it can be extended safely in the future. */
1937607ca46eSDavid Howells struct v4l2_decoder_cmd {
1938607ca46eSDavid Howells 	__u32 cmd;
1939607ca46eSDavid Howells 	__u32 flags;
1940607ca46eSDavid Howells 	union {
1941607ca46eSDavid Howells 		struct {
1942607ca46eSDavid Howells 			__u64 pts;
1943607ca46eSDavid Howells 		} stop;
1944607ca46eSDavid Howells 
1945607ca46eSDavid Howells 		struct {
1946607ca46eSDavid Howells 			/* 0 or 1000 specifies normal speed,
1947607ca46eSDavid Howells 			   1 specifies forward single stepping,
1948607ca46eSDavid Howells 			   -1 specifies backward single stepping,
1949607ca46eSDavid Howells 			   >1: playback at speed/1000 of the normal speed,
1950607ca46eSDavid Howells 			   <-1: reverse playback at (-speed/1000) of the normal speed. */
1951607ca46eSDavid Howells 			__s32 speed;
1952607ca46eSDavid Howells 			__u32 format;
1953607ca46eSDavid Howells 		} start;
1954607ca46eSDavid Howells 
1955607ca46eSDavid Howells 		struct {
1956607ca46eSDavid Howells 			__u32 data[16];
1957607ca46eSDavid Howells 		} raw;
1958607ca46eSDavid Howells 	};
1959607ca46eSDavid Howells };
1960607ca46eSDavid Howells #endif
1961607ca46eSDavid Howells 
1962607ca46eSDavid Howells 
1963607ca46eSDavid Howells /*
1964607ca46eSDavid Howells  *	D A T A   S E R V I C E S   ( V B I )
1965607ca46eSDavid Howells  *
1966607ca46eSDavid Howells  *	Data services API by Michael Schimek
1967607ca46eSDavid Howells  */
1968607ca46eSDavid Howells 
1969607ca46eSDavid Howells /* Raw VBI */
1970607ca46eSDavid Howells struct v4l2_vbi_format {
1971607ca46eSDavid Howells 	__u32	sampling_rate;		/* in 1 Hz */
1972607ca46eSDavid Howells 	__u32	offset;
1973607ca46eSDavid Howells 	__u32	samples_per_line;
1974607ca46eSDavid Howells 	__u32	sample_format;		/* V4L2_PIX_FMT_* */
1975607ca46eSDavid Howells 	__s32	start[2];
1976607ca46eSDavid Howells 	__u32	count[2];
1977607ca46eSDavid Howells 	__u32	flags;			/* V4L2_VBI_* */
1978607ca46eSDavid Howells 	__u32	reserved[2];		/* must be zero */
1979607ca46eSDavid Howells };
1980607ca46eSDavid Howells 
1981607ca46eSDavid Howells /*  VBI flags  */
1982607ca46eSDavid Howells #define V4L2_VBI_UNSYNC		(1 << 0)
1983607ca46eSDavid Howells #define V4L2_VBI_INTERLACED	(1 << 1)
1984607ca46eSDavid Howells 
1985273886b4SHans Verkuil /* ITU-R start lines for each field */
1986273886b4SHans Verkuil #define V4L2_VBI_ITU_525_F1_START (1)
1987273886b4SHans Verkuil #define V4L2_VBI_ITU_525_F2_START (264)
1988273886b4SHans Verkuil #define V4L2_VBI_ITU_625_F1_START (1)
1989273886b4SHans Verkuil #define V4L2_VBI_ITU_625_F2_START (314)
1990273886b4SHans Verkuil 
1991607ca46eSDavid Howells /* Sliced VBI
1992607ca46eSDavid Howells  *
1993607ca46eSDavid Howells  *    This implements is a proposal V4L2 API to allow SLICED VBI
1994607ca46eSDavid Howells  * required for some hardware encoders. It should change without
1995607ca46eSDavid Howells  * notice in the definitive implementation.
1996607ca46eSDavid Howells  */
1997607ca46eSDavid Howells 
1998607ca46eSDavid Howells struct v4l2_sliced_vbi_format {
1999607ca46eSDavid Howells 	__u16   service_set;
2000607ca46eSDavid Howells 	/* service_lines[0][...] specifies lines 0-23 (1-23 used) of the first field
2001607ca46eSDavid Howells 	   service_lines[1][...] specifies lines 0-23 (1-23 used) of the second field
2002607ca46eSDavid Howells 				 (equals frame lines 313-336 for 625 line video
2003607ca46eSDavid Howells 				  standards, 263-286 for 525 line standards) */
2004607ca46eSDavid Howells 	__u16   service_lines[2][24];
2005607ca46eSDavid Howells 	__u32   io_size;
2006607ca46eSDavid Howells 	__u32   reserved[2];            /* must be zero */
2007607ca46eSDavid Howells };
2008607ca46eSDavid Howells 
2009607ca46eSDavid Howells /* Teletext World System Teletext
2010607ca46eSDavid Howells    (WST), defined on ITU-R BT.653-2 */
2011607ca46eSDavid Howells #define V4L2_SLICED_TELETEXT_B          (0x0001)
2012607ca46eSDavid Howells /* Video Program System, defined on ETS 300 231*/
2013607ca46eSDavid Howells #define V4L2_SLICED_VPS                 (0x0400)
2014607ca46eSDavid Howells /* Closed Caption, defined on EIA-608 */
2015607ca46eSDavid Howells #define V4L2_SLICED_CAPTION_525         (0x1000)
2016607ca46eSDavid Howells /* Wide Screen System, defined on ITU-R BT1119.1 */
2017607ca46eSDavid Howells #define V4L2_SLICED_WSS_625             (0x4000)
2018607ca46eSDavid Howells 
2019607ca46eSDavid Howells #define V4L2_SLICED_VBI_525             (V4L2_SLICED_CAPTION_525)
2020607ca46eSDavid Howells #define V4L2_SLICED_VBI_625             (V4L2_SLICED_TELETEXT_B | V4L2_SLICED_VPS | V4L2_SLICED_WSS_625)
2021607ca46eSDavid Howells 
2022607ca46eSDavid Howells struct v4l2_sliced_vbi_cap {
2023607ca46eSDavid Howells 	__u16   service_set;
2024607ca46eSDavid Howells 	/* service_lines[0][...] specifies lines 0-23 (1-23 used) of the first field
2025607ca46eSDavid Howells 	   service_lines[1][...] specifies lines 0-23 (1-23 used) of the second field
2026607ca46eSDavid Howells 				 (equals frame lines 313-336 for 625 line video
2027607ca46eSDavid Howells 				  standards, 263-286 for 525 line standards) */
2028607ca46eSDavid Howells 	__u16   service_lines[2][24];
2029607ca46eSDavid Howells 	__u32	type;		/* enum v4l2_buf_type */
2030607ca46eSDavid Howells 	__u32   reserved[3];    /* must be 0 */
2031607ca46eSDavid Howells };
2032607ca46eSDavid Howells 
2033607ca46eSDavid Howells struct v4l2_sliced_vbi_data {
2034607ca46eSDavid Howells 	__u32   id;
2035607ca46eSDavid Howells 	__u32   field;          /* 0: first field, 1: second field */
2036607ca46eSDavid Howells 	__u32   line;           /* 1-23 */
2037607ca46eSDavid Howells 	__u32   reserved;       /* must be 0 */
2038607ca46eSDavid Howells 	__u8    data[48];
2039607ca46eSDavid Howells };
2040607ca46eSDavid Howells 
2041607ca46eSDavid Howells /*
2042607ca46eSDavid Howells  * Sliced VBI data inserted into MPEG Streams
2043607ca46eSDavid Howells  */
2044607ca46eSDavid Howells 
2045607ca46eSDavid Howells /*
2046607ca46eSDavid Howells  * V4L2_MPEG_STREAM_VBI_FMT_IVTV:
2047607ca46eSDavid Howells  *
2048607ca46eSDavid Howells  * Structure of payload contained in an MPEG 2 Private Stream 1 PES Packet in an
2049607ca46eSDavid Howells  * MPEG-2 Program Pack that contains V4L2_MPEG_STREAM_VBI_FMT_IVTV Sliced VBI
2050607ca46eSDavid Howells  * data
2051607ca46eSDavid Howells  *
2052607ca46eSDavid Howells  * Note, the MPEG-2 Program Pack and Private Stream 1 PES packet header
2053607ca46eSDavid Howells  * definitions are not included here.  See the MPEG-2 specifications for details
2054607ca46eSDavid Howells  * on these headers.
2055607ca46eSDavid Howells  */
2056607ca46eSDavid Howells 
2057607ca46eSDavid Howells /* Line type IDs */
2058607ca46eSDavid Howells #define V4L2_MPEG_VBI_IVTV_TELETEXT_B     (1)
2059607ca46eSDavid Howells #define V4L2_MPEG_VBI_IVTV_CAPTION_525    (4)
2060607ca46eSDavid Howells #define V4L2_MPEG_VBI_IVTV_WSS_625        (5)
2061607ca46eSDavid Howells #define V4L2_MPEG_VBI_IVTV_VPS            (7)
2062607ca46eSDavid Howells 
2063607ca46eSDavid Howells struct v4l2_mpeg_vbi_itv0_line {
2064607ca46eSDavid Howells 	__u8 id;	/* One of V4L2_MPEG_VBI_IVTV_* above */
2065607ca46eSDavid Howells 	__u8 data[42];	/* Sliced VBI data for the line */
2066607ca46eSDavid Howells } __attribute__ ((packed));
2067607ca46eSDavid Howells 
2068607ca46eSDavid Howells struct v4l2_mpeg_vbi_itv0 {
2069607ca46eSDavid Howells 	__le32 linemask[2]; /* Bitmasks of VBI service lines present */
2070607ca46eSDavid Howells 	struct v4l2_mpeg_vbi_itv0_line line[35];
2071607ca46eSDavid Howells } __attribute__ ((packed));
2072607ca46eSDavid Howells 
2073607ca46eSDavid Howells struct v4l2_mpeg_vbi_ITV0 {
2074607ca46eSDavid Howells 	struct v4l2_mpeg_vbi_itv0_line line[36];
2075607ca46eSDavid Howells } __attribute__ ((packed));
2076607ca46eSDavid Howells 
2077607ca46eSDavid Howells #define V4L2_MPEG_VBI_IVTV_MAGIC0	"itv0"
2078607ca46eSDavid Howells #define V4L2_MPEG_VBI_IVTV_MAGIC1	"ITV0"
2079607ca46eSDavid Howells 
2080607ca46eSDavid Howells struct v4l2_mpeg_vbi_fmt_ivtv {
2081607ca46eSDavid Howells 	__u8 magic[4];
2082607ca46eSDavid Howells 	union {
2083607ca46eSDavid Howells 		struct v4l2_mpeg_vbi_itv0 itv0;
2084607ca46eSDavid Howells 		struct v4l2_mpeg_vbi_ITV0 ITV0;
2085607ca46eSDavid Howells 	};
2086607ca46eSDavid Howells } __attribute__ ((packed));
2087607ca46eSDavid Howells 
2088607ca46eSDavid Howells /*
2089607ca46eSDavid Howells  *	A G G R E G A T E   S T R U C T U R E S
2090607ca46eSDavid Howells  */
2091607ca46eSDavid Howells 
2092607ca46eSDavid Howells /**
2093607ca46eSDavid Howells  * struct v4l2_plane_pix_format - additional, per-plane format definition
2094607ca46eSDavid Howells  * @sizeimage:		maximum size in bytes required for data, for which
2095607ca46eSDavid Howells  *			this plane will be used
2096607ca46eSDavid Howells  * @bytesperline:	distance in bytes between the leftmost pixels in two
2097607ca46eSDavid Howells  *			adjacent lines
2098607ca46eSDavid Howells  */
2099607ca46eSDavid Howells struct v4l2_plane_pix_format {
2100607ca46eSDavid Howells 	__u32		sizeimage;
2101cc7d2dfbSHans Verkuil 	__u32		bytesperline;
2102cc7d2dfbSHans Verkuil 	__u16		reserved[6];
2103607ca46eSDavid Howells } __attribute__ ((packed));
2104607ca46eSDavid Howells 
2105607ca46eSDavid Howells /**
2106607ca46eSDavid Howells  * struct v4l2_pix_format_mplane - multiplanar format definition
2107607ca46eSDavid Howells  * @width:		image width in pixels
2108607ca46eSDavid Howells  * @height:		image height in pixels
2109607ca46eSDavid Howells  * @pixelformat:	little endian four character code (fourcc)
2110607ca46eSDavid Howells  * @field:		enum v4l2_field; field order (for interlaced video)
2111607ca46eSDavid Howells  * @colorspace:		enum v4l2_colorspace; supplemental to pixelformat
2112607ca46eSDavid Howells  * @plane_fmt:		per-plane information
2113607ca46eSDavid Howells  * @num_planes:		number of planes for this format
2114c96fd46aSLaurent Pinchart  * @flags:		format flags (V4L2_PIX_FMT_FLAG_*)
2115d5735d64SHans Verkuil  * @ycbcr_enc:		enum v4l2_ycbcr_encoding, Y'CbCr encoding
2116d5735d64SHans Verkuil  * @quantization:	enum v4l2_quantization, colorspace quantization
211774fdcb2eSHans Verkuil  * @xfer_func:		enum v4l2_xfer_func, colorspace transfer function
2118607ca46eSDavid Howells  */
2119607ca46eSDavid Howells struct v4l2_pix_format_mplane {
2120607ca46eSDavid Howells 	__u32				width;
2121607ca46eSDavid Howells 	__u32				height;
2122607ca46eSDavid Howells 	__u32				pixelformat;
2123607ca46eSDavid Howells 	__u32				field;
2124607ca46eSDavid Howells 	__u32				colorspace;
2125607ca46eSDavid Howells 
2126607ca46eSDavid Howells 	struct v4l2_plane_pix_format	plane_fmt[VIDEO_MAX_PLANES];
2127607ca46eSDavid Howells 	__u8				num_planes;
2128c96fd46aSLaurent Pinchart 	__u8				flags;
21298a0d62afSRicardo Ribalda Delgado 	 union {
2130d5735d64SHans Verkuil 		__u8				ycbcr_enc;
21318a0d62afSRicardo Ribalda Delgado 		__u8				hsv_enc;
21328a0d62afSRicardo Ribalda Delgado 	};
2133d5735d64SHans Verkuil 	__u8				quantization;
213474fdcb2eSHans Verkuil 	__u8				xfer_func;
213574fdcb2eSHans Verkuil 	__u8				reserved[7];
2136607ca46eSDavid Howells } __attribute__ ((packed));
2137607ca46eSDavid Howells 
2138607ca46eSDavid Howells /**
213987185c95SAntti Palosaari  * struct v4l2_sdr_format - SDR format definition
21406f3073b8SAntti Palosaari  * @pixelformat:	little endian four character code (fourcc)
2141aaa968b6SAntti Palosaari  * @buffersize:		maximum size in bytes required for data
21426f3073b8SAntti Palosaari  */
214387185c95SAntti Palosaari struct v4l2_sdr_format {
21446f3073b8SAntti Palosaari 	__u32				pixelformat;
2145aaa968b6SAntti Palosaari 	__u32				buffersize;
2146aaa968b6SAntti Palosaari 	__u8				reserved[24];
21476f3073b8SAntti Palosaari } __attribute__ ((packed));
21486f3073b8SAntti Palosaari 
21496f3073b8SAntti Palosaari /**
2150fb9ffa6aSLaurent Pinchart  * struct v4l2_meta_format - metadata format definition
2151fb9ffa6aSLaurent Pinchart  * @dataformat:		little endian four character code (fourcc)
2152fb9ffa6aSLaurent Pinchart  * @buffersize:		maximum size in bytes required for data
2153fb9ffa6aSLaurent Pinchart  */
2154fb9ffa6aSLaurent Pinchart struct v4l2_meta_format {
2155fb9ffa6aSLaurent Pinchart 	__u32				dataformat;
2156fb9ffa6aSLaurent Pinchart 	__u32				buffersize;
2157fb9ffa6aSLaurent Pinchart } __attribute__ ((packed));
2158fb9ffa6aSLaurent Pinchart 
2159fb9ffa6aSLaurent Pinchart /**
2160607ca46eSDavid Howells  * struct v4l2_format - stream data format
2161607ca46eSDavid Howells  * @type:	enum v4l2_buf_type; type of the data stream
2162607ca46eSDavid Howells  * @pix:	definition of an image format
2163607ca46eSDavid Howells  * @pix_mp:	definition of a multiplanar image format
2164607ca46eSDavid Howells  * @win:	definition of an overlaid image
2165607ca46eSDavid Howells  * @vbi:	raw VBI capture or output parameters
2166607ca46eSDavid Howells  * @sliced:	sliced VBI capture or output parameters
2167607ca46eSDavid Howells  * @raw_data:	placeholder for future extensions and custom formats
2168607ca46eSDavid Howells  */
2169607ca46eSDavid Howells struct v4l2_format {
2170607ca46eSDavid Howells 	__u32	 type;
2171607ca46eSDavid Howells 	union {
2172607ca46eSDavid Howells 		struct v4l2_pix_format		pix;     /* V4L2_BUF_TYPE_VIDEO_CAPTURE */
2173607ca46eSDavid Howells 		struct v4l2_pix_format_mplane	pix_mp;  /* V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE */
2174607ca46eSDavid Howells 		struct v4l2_window		win;     /* V4L2_BUF_TYPE_VIDEO_OVERLAY */
2175607ca46eSDavid Howells 		struct v4l2_vbi_format		vbi;     /* V4L2_BUF_TYPE_VBI_CAPTURE */
2176607ca46eSDavid Howells 		struct v4l2_sliced_vbi_format	sliced;  /* V4L2_BUF_TYPE_SLICED_VBI_CAPTURE */
217787185c95SAntti Palosaari 		struct v4l2_sdr_format		sdr;     /* V4L2_BUF_TYPE_SDR_CAPTURE */
2178fb9ffa6aSLaurent Pinchart 		struct v4l2_meta_format		meta;    /* V4L2_BUF_TYPE_META_CAPTURE */
2179607ca46eSDavid Howells 		__u8	raw_data[200];                   /* user-defined */
2180607ca46eSDavid Howells 	} fmt;
2181607ca46eSDavid Howells };
2182607ca46eSDavid Howells 
2183607ca46eSDavid Howells /*	Stream type-dependent parameters
2184607ca46eSDavid Howells  */
2185607ca46eSDavid Howells struct v4l2_streamparm {
2186607ca46eSDavid Howells 	__u32	 type;			/* enum v4l2_buf_type */
2187607ca46eSDavid Howells 	union {
2188607ca46eSDavid Howells 		struct v4l2_captureparm	capture;
2189607ca46eSDavid Howells 		struct v4l2_outputparm	output;
2190607ca46eSDavid Howells 		__u8	raw_data[200];  /* user-defined */
2191607ca46eSDavid Howells 	} parm;
2192607ca46eSDavid Howells };
2193607ca46eSDavid Howells 
2194607ca46eSDavid Howells /*
2195607ca46eSDavid Howells  *	E V E N T S
2196607ca46eSDavid Howells  */
2197607ca46eSDavid Howells 
2198607ca46eSDavid Howells #define V4L2_EVENT_ALL				0
2199607ca46eSDavid Howells #define V4L2_EVENT_VSYNC			1
2200607ca46eSDavid Howells #define V4L2_EVENT_EOS				2
2201607ca46eSDavid Howells #define V4L2_EVENT_CTRL				3
2202607ca46eSDavid Howells #define V4L2_EVENT_FRAME_SYNC			4
22033cbe6e5bSArun Kumar K #define V4L2_EVENT_SOURCE_CHANGE		5
220478ea6113SHans Verkuil #define V4L2_EVENT_MOTION_DET			6
2205607ca46eSDavid Howells #define V4L2_EVENT_PRIVATE_START		0x08000000
2206607ca46eSDavid Howells 
2207607ca46eSDavid Howells /* Payload for V4L2_EVENT_VSYNC */
2208607ca46eSDavid Howells struct v4l2_event_vsync {
2209607ca46eSDavid Howells 	/* Can be V4L2_FIELD_ANY, _NONE, _TOP or _BOTTOM */
2210607ca46eSDavid Howells 	__u8 field;
2211607ca46eSDavid Howells } __attribute__ ((packed));
2212607ca46eSDavid Howells 
2213607ca46eSDavid Howells /* Payload for V4L2_EVENT_CTRL */
2214607ca46eSDavid Howells #define V4L2_EVENT_CTRL_CH_VALUE		(1 << 0)
2215607ca46eSDavid Howells #define V4L2_EVENT_CTRL_CH_FLAGS		(1 << 1)
22162ccbe779SSylwester Nawrocki #define V4L2_EVENT_CTRL_CH_RANGE		(1 << 2)
2217607ca46eSDavid Howells 
2218607ca46eSDavid Howells struct v4l2_event_ctrl {
2219607ca46eSDavid Howells 	__u32 changes;
2220607ca46eSDavid Howells 	__u32 type;
2221607ca46eSDavid Howells 	union {
2222607ca46eSDavid Howells 		__s32 value;
2223607ca46eSDavid Howells 		__s64 value64;
2224607ca46eSDavid Howells 	};
2225607ca46eSDavid Howells 	__u32 flags;
2226607ca46eSDavid Howells 	__s32 minimum;
2227607ca46eSDavid Howells 	__s32 maximum;
2228607ca46eSDavid Howells 	__s32 step;
2229607ca46eSDavid Howells 	__s32 default_value;
2230607ca46eSDavid Howells };
2231607ca46eSDavid Howells 
2232607ca46eSDavid Howells struct v4l2_event_frame_sync {
2233607ca46eSDavid Howells 	__u32 frame_sequence;
2234607ca46eSDavid Howells };
2235607ca46eSDavid Howells 
22363cbe6e5bSArun Kumar K #define V4L2_EVENT_SRC_CH_RESOLUTION		(1 << 0)
22373cbe6e5bSArun Kumar K 
22383cbe6e5bSArun Kumar K struct v4l2_event_src_change {
22393cbe6e5bSArun Kumar K 	__u32 changes;
22403cbe6e5bSArun Kumar K };
22413cbe6e5bSArun Kumar K 
224278ea6113SHans Verkuil #define V4L2_EVENT_MD_FL_HAVE_FRAME_SEQ	(1 << 0)
224378ea6113SHans Verkuil 
224478ea6113SHans Verkuil /**
224578ea6113SHans Verkuil  * struct v4l2_event_motion_det - motion detection event
224678ea6113SHans Verkuil  * @flags:             if V4L2_EVENT_MD_FL_HAVE_FRAME_SEQ is set, then the
224778ea6113SHans Verkuil  *                     frame_sequence field is valid.
224878ea6113SHans Verkuil  * @frame_sequence:    the frame sequence number associated with this event.
224978ea6113SHans Verkuil  * @region_mask:       which regions detected motion.
225078ea6113SHans Verkuil  */
225178ea6113SHans Verkuil struct v4l2_event_motion_det {
225278ea6113SHans Verkuil 	__u32 flags;
225378ea6113SHans Verkuil 	__u32 frame_sequence;
225478ea6113SHans Verkuil 	__u32 region_mask;
225578ea6113SHans Verkuil };
225678ea6113SHans Verkuil 
2257607ca46eSDavid Howells struct v4l2_event {
2258607ca46eSDavid Howells 	__u32				type;
2259607ca46eSDavid Howells 	union {
2260607ca46eSDavid Howells 		struct v4l2_event_vsync		vsync;
2261607ca46eSDavid Howells 		struct v4l2_event_ctrl		ctrl;
2262607ca46eSDavid Howells 		struct v4l2_event_frame_sync	frame_sync;
22633cbe6e5bSArun Kumar K 		struct v4l2_event_src_change	src_change;
226478ea6113SHans Verkuil 		struct v4l2_event_motion_det	motion_det;
2265607ca46eSDavid Howells 		__u8				data[64];
2266607ca46eSDavid Howells 	} u;
2267607ca46eSDavid Howells 	__u32				pending;
2268607ca46eSDavid Howells 	__u32				sequence;
2269607ca46eSDavid Howells 	struct timespec			timestamp;
2270607ca46eSDavid Howells 	__u32				id;
2271607ca46eSDavid Howells 	__u32				reserved[8];
2272607ca46eSDavid Howells };
2273607ca46eSDavid Howells 
2274607ca46eSDavid Howells #define V4L2_EVENT_SUB_FL_SEND_INITIAL		(1 << 0)
2275607ca46eSDavid Howells #define V4L2_EVENT_SUB_FL_ALLOW_FEEDBACK	(1 << 1)
2276607ca46eSDavid Howells 
2277607ca46eSDavid Howells struct v4l2_event_subscription {
2278607ca46eSDavid Howells 	__u32				type;
2279607ca46eSDavid Howells 	__u32				id;
2280607ca46eSDavid Howells 	__u32				flags;
2281607ca46eSDavid Howells 	__u32				reserved[5];
2282607ca46eSDavid Howells };
2283607ca46eSDavid Howells 
2284607ca46eSDavid Howells /*
2285607ca46eSDavid Howells  *	A D V A N C E D   D E B U G G I N G
2286607ca46eSDavid Howells  *
2287607ca46eSDavid Howells  *	NOTE: EXPERIMENTAL API, NEVER RELY ON THIS IN APPLICATIONS!
2288607ca46eSDavid Howells  *	FOR DEBUGGING, TESTING AND INTERNAL USE ONLY!
2289607ca46eSDavid Howells  */
2290607ca46eSDavid Howells 
2291607ca46eSDavid Howells /* VIDIOC_DBG_G_REGISTER and VIDIOC_DBG_S_REGISTER */
2292607ca46eSDavid Howells 
229379b0c640SHans Verkuil #define V4L2_CHIP_MATCH_BRIDGE      0  /* Match against chip ID on the bridge (0 for the bridge) */
2294b71c9980SHans Verkuil #define V4L2_CHIP_MATCH_SUBDEV      4  /* Match against subdev index */
2295b71c9980SHans Verkuil 
2296b71c9980SHans Verkuil /* The following four defines are no longer in use */
229779b0c640SHans Verkuil #define V4L2_CHIP_MATCH_HOST V4L2_CHIP_MATCH_BRIDGE
2298607ca46eSDavid Howells #define V4L2_CHIP_MATCH_I2C_DRIVER  1  /* Match against I2C driver name */
2299607ca46eSDavid Howells #define V4L2_CHIP_MATCH_I2C_ADDR    2  /* Match against I2C 7-bit address */
2300ff29feb9SLad, Prabhakar #define V4L2_CHIP_MATCH_AC97        3  /* Match against ancillary AC97 chip */
2301607ca46eSDavid Howells 
2302607ca46eSDavid Howells struct v4l2_dbg_match {
2303607ca46eSDavid Howells 	__u32 type; /* Match type */
2304607ca46eSDavid Howells 	union {     /* Match this chip, meaning determined by type */
2305607ca46eSDavid Howells 		__u32 addr;
2306607ca46eSDavid Howells 		char name[32];
2307607ca46eSDavid Howells 	};
2308607ca46eSDavid Howells } __attribute__ ((packed));
2309607ca46eSDavid Howells 
2310607ca46eSDavid Howells struct v4l2_dbg_register {
2311607ca46eSDavid Howells 	struct v4l2_dbg_match match;
2312607ca46eSDavid Howells 	__u32 size;	/* register size in bytes */
2313607ca46eSDavid Howells 	__u64 reg;
2314607ca46eSDavid Howells 	__u64 val;
2315607ca46eSDavid Howells } __attribute__ ((packed));
2316607ca46eSDavid Howells 
231779b0c640SHans Verkuil #define V4L2_CHIP_FL_READABLE (1 << 0)
231879b0c640SHans Verkuil #define V4L2_CHIP_FL_WRITABLE (1 << 1)
231979b0c640SHans Verkuil 
232096b03d2aSHans Verkuil /* VIDIOC_DBG_G_CHIP_INFO */
232196b03d2aSHans Verkuil struct v4l2_dbg_chip_info {
232279b0c640SHans Verkuil 	struct v4l2_dbg_match match;
232379b0c640SHans Verkuil 	char name[32];
232479b0c640SHans Verkuil 	__u32 flags;
2325b8399b83SHans Verkuil 	__u32 reserved[32];
232679b0c640SHans Verkuil } __attribute__ ((packed));
232779b0c640SHans Verkuil 
2328607ca46eSDavid Howells /**
2329607ca46eSDavid Howells  * struct v4l2_create_buffers - VIDIOC_CREATE_BUFS argument
2330607ca46eSDavid Howells  * @index:	on return, index of the first created buffer
2331607ca46eSDavid Howells  * @count:	entry: number of requested buffers,
2332607ca46eSDavid Howells  *		return: number of created buffers
2333607ca46eSDavid Howells  * @memory:	enum v4l2_memory; buffer memory type
2334607ca46eSDavid Howells  * @format:	frame format, for which buffers are requested
2335f35f5d72SHans Verkuil  * @capabilities: capabilities of this buffer type.
2336607ca46eSDavid Howells  * @reserved:	future extensions
2337607ca46eSDavid Howells  */
2338607ca46eSDavid Howells struct v4l2_create_buffers {
2339607ca46eSDavid Howells 	__u32			index;
2340607ca46eSDavid Howells 	__u32			count;
2341607ca46eSDavid Howells 	__u32			memory;
2342607ca46eSDavid Howells 	struct v4l2_format	format;
2343f35f5d72SHans Verkuil 	__u32			capabilities;
2344f35f5d72SHans Verkuil 	__u32			reserved[7];
2345607ca46eSDavid Howells };
2346607ca46eSDavid Howells 
2347607ca46eSDavid Howells /*
2348607ca46eSDavid Howells  *	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
2349607ca46eSDavid Howells  *
2350607ca46eSDavid Howells  */
2351607ca46eSDavid Howells #define VIDIOC_QUERYCAP		 _IOR('V',  0, struct v4l2_capability)
2352607ca46eSDavid Howells #define VIDIOC_ENUM_FMT         _IOWR('V',  2, struct v4l2_fmtdesc)
2353607ca46eSDavid Howells #define VIDIOC_G_FMT		_IOWR('V',  4, struct v4l2_format)
2354607ca46eSDavid Howells #define VIDIOC_S_FMT		_IOWR('V',  5, struct v4l2_format)
2355607ca46eSDavid Howells #define VIDIOC_REQBUFS		_IOWR('V',  8, struct v4l2_requestbuffers)
2356607ca46eSDavid Howells #define VIDIOC_QUERYBUF		_IOWR('V',  9, struct v4l2_buffer)
2357607ca46eSDavid Howells #define VIDIOC_G_FBUF		 _IOR('V', 10, struct v4l2_framebuffer)
2358607ca46eSDavid Howells #define VIDIOC_S_FBUF		 _IOW('V', 11, struct v4l2_framebuffer)
2359607ca46eSDavid Howells #define VIDIOC_OVERLAY		 _IOW('V', 14, int)
2360607ca46eSDavid Howells #define VIDIOC_QBUF		_IOWR('V', 15, struct v4l2_buffer)
2361b799d09aSTomasz Stanislawski #define VIDIOC_EXPBUF		_IOWR('V', 16, struct v4l2_exportbuffer)
2362607ca46eSDavid Howells #define VIDIOC_DQBUF		_IOWR('V', 17, struct v4l2_buffer)
2363607ca46eSDavid Howells #define VIDIOC_STREAMON		 _IOW('V', 18, int)
2364607ca46eSDavid Howells #define VIDIOC_STREAMOFF	 _IOW('V', 19, int)
2365607ca46eSDavid Howells #define VIDIOC_G_PARM		_IOWR('V', 21, struct v4l2_streamparm)
2366607ca46eSDavid Howells #define VIDIOC_S_PARM		_IOWR('V', 22, struct v4l2_streamparm)
2367607ca46eSDavid Howells #define VIDIOC_G_STD		 _IOR('V', 23, v4l2_std_id)
2368607ca46eSDavid Howells #define VIDIOC_S_STD		 _IOW('V', 24, v4l2_std_id)
2369607ca46eSDavid Howells #define VIDIOC_ENUMSTD		_IOWR('V', 25, struct v4l2_standard)
2370607ca46eSDavid Howells #define VIDIOC_ENUMINPUT	_IOWR('V', 26, struct v4l2_input)
2371607ca46eSDavid Howells #define VIDIOC_G_CTRL		_IOWR('V', 27, struct v4l2_control)
2372607ca46eSDavid Howells #define VIDIOC_S_CTRL		_IOWR('V', 28, struct v4l2_control)
2373607ca46eSDavid Howells #define VIDIOC_G_TUNER		_IOWR('V', 29, struct v4l2_tuner)
2374607ca46eSDavid Howells #define VIDIOC_S_TUNER		 _IOW('V', 30, struct v4l2_tuner)
2375607ca46eSDavid Howells #define VIDIOC_G_AUDIO		 _IOR('V', 33, struct v4l2_audio)
2376607ca46eSDavid Howells #define VIDIOC_S_AUDIO		 _IOW('V', 34, struct v4l2_audio)
2377607ca46eSDavid Howells #define VIDIOC_QUERYCTRL	_IOWR('V', 36, struct v4l2_queryctrl)
2378607ca46eSDavid Howells #define VIDIOC_QUERYMENU	_IOWR('V', 37, struct v4l2_querymenu)
2379607ca46eSDavid Howells #define VIDIOC_G_INPUT		 _IOR('V', 38, int)
2380607ca46eSDavid Howells #define VIDIOC_S_INPUT		_IOWR('V', 39, int)
2381254a4777SHans Verkuil #define VIDIOC_G_EDID		_IOWR('V', 40, struct v4l2_edid)
2382254a4777SHans Verkuil #define VIDIOC_S_EDID		_IOWR('V', 41, struct v4l2_edid)
2383607ca46eSDavid Howells #define VIDIOC_G_OUTPUT		 _IOR('V', 46, int)
2384607ca46eSDavid Howells #define VIDIOC_S_OUTPUT		_IOWR('V', 47, int)
2385607ca46eSDavid Howells #define VIDIOC_ENUMOUTPUT	_IOWR('V', 48, struct v4l2_output)
2386607ca46eSDavid Howells #define VIDIOC_G_AUDOUT		 _IOR('V', 49, struct v4l2_audioout)
2387607ca46eSDavid Howells #define VIDIOC_S_AUDOUT		 _IOW('V', 50, struct v4l2_audioout)
2388607ca46eSDavid Howells #define VIDIOC_G_MODULATOR	_IOWR('V', 54, struct v4l2_modulator)
2389607ca46eSDavid Howells #define VIDIOC_S_MODULATOR	 _IOW('V', 55, struct v4l2_modulator)
2390607ca46eSDavid Howells #define VIDIOC_G_FREQUENCY	_IOWR('V', 56, struct v4l2_frequency)
2391607ca46eSDavid Howells #define VIDIOC_S_FREQUENCY	 _IOW('V', 57, struct v4l2_frequency)
2392607ca46eSDavid Howells #define VIDIOC_CROPCAP		_IOWR('V', 58, struct v4l2_cropcap)
2393607ca46eSDavid Howells #define VIDIOC_G_CROP		_IOWR('V', 59, struct v4l2_crop)
2394607ca46eSDavid Howells #define VIDIOC_S_CROP		 _IOW('V', 60, struct v4l2_crop)
2395607ca46eSDavid Howells #define VIDIOC_G_JPEGCOMP	 _IOR('V', 61, struct v4l2_jpegcompression)
2396607ca46eSDavid Howells #define VIDIOC_S_JPEGCOMP	 _IOW('V', 62, struct v4l2_jpegcompression)
2397607ca46eSDavid Howells #define VIDIOC_QUERYSTD		 _IOR('V', 63, v4l2_std_id)
2398607ca46eSDavid Howells #define VIDIOC_TRY_FMT		_IOWR('V', 64, struct v4l2_format)
2399607ca46eSDavid Howells #define VIDIOC_ENUMAUDIO	_IOWR('V', 65, struct v4l2_audio)
2400607ca46eSDavid Howells #define VIDIOC_ENUMAUDOUT	_IOWR('V', 66, struct v4l2_audioout)
2401607ca46eSDavid Howells #define VIDIOC_G_PRIORITY	 _IOR('V', 67, __u32) /* enum v4l2_priority */
2402607ca46eSDavid Howells #define VIDIOC_S_PRIORITY	 _IOW('V', 68, __u32) /* enum v4l2_priority */
2403607ca46eSDavid Howells #define VIDIOC_G_SLICED_VBI_CAP _IOWR('V', 69, struct v4l2_sliced_vbi_cap)
2404607ca46eSDavid Howells #define VIDIOC_LOG_STATUS         _IO('V', 70)
2405607ca46eSDavid Howells #define VIDIOC_G_EXT_CTRLS	_IOWR('V', 71, struct v4l2_ext_controls)
2406607ca46eSDavid Howells #define VIDIOC_S_EXT_CTRLS	_IOWR('V', 72, struct v4l2_ext_controls)
2407607ca46eSDavid Howells #define VIDIOC_TRY_EXT_CTRLS	_IOWR('V', 73, struct v4l2_ext_controls)
2408607ca46eSDavid Howells #define VIDIOC_ENUM_FRAMESIZES	_IOWR('V', 74, struct v4l2_frmsizeenum)
2409607ca46eSDavid Howells #define VIDIOC_ENUM_FRAMEINTERVALS _IOWR('V', 75, struct v4l2_frmivalenum)
2410607ca46eSDavid Howells #define VIDIOC_G_ENC_INDEX       _IOR('V', 76, struct v4l2_enc_idx)
2411607ca46eSDavid Howells #define VIDIOC_ENCODER_CMD      _IOWR('V', 77, struct v4l2_encoder_cmd)
2412607ca46eSDavid Howells #define VIDIOC_TRY_ENCODER_CMD  _IOWR('V', 78, struct v4l2_encoder_cmd)
2413607ca46eSDavid Howells 
241457c75987SHans Verkuil /*
241557c75987SHans Verkuil  * Experimental, meant for debugging, testing and internal use.
241657c75987SHans Verkuil  * Only implemented if CONFIG_VIDEO_ADV_DEBUG is defined.
241757c75987SHans Verkuil  * You must be root to use these ioctls. Never use these in applications!
241857c75987SHans Verkuil  */
2419607ca46eSDavid Howells #define	VIDIOC_DBG_S_REGISTER	 _IOW('V', 79, struct v4l2_dbg_register)
2420607ca46eSDavid Howells #define	VIDIOC_DBG_G_REGISTER	_IOWR('V', 80, struct v4l2_dbg_register)
2421607ca46eSDavid Howells 
2422607ca46eSDavid Howells #define VIDIOC_S_HW_FREQ_SEEK	 _IOW('V', 82, struct v4l2_hw_freq_seek)
2423607ca46eSDavid Howells #define	VIDIOC_S_DV_TIMINGS	_IOWR('V', 87, struct v4l2_dv_timings)
2424607ca46eSDavid Howells #define	VIDIOC_G_DV_TIMINGS	_IOWR('V', 88, struct v4l2_dv_timings)
2425607ca46eSDavid Howells #define	VIDIOC_DQEVENT		 _IOR('V', 89, struct v4l2_event)
2426607ca46eSDavid Howells #define	VIDIOC_SUBSCRIBE_EVENT	 _IOW('V', 90, struct v4l2_event_subscription)
2427607ca46eSDavid Howells #define	VIDIOC_UNSUBSCRIBE_EVENT _IOW('V', 91, struct v4l2_event_subscription)
2428607ca46eSDavid Howells #define VIDIOC_CREATE_BUFS	_IOWR('V', 92, struct v4l2_create_buffers)
2429607ca46eSDavid Howells #define VIDIOC_PREPARE_BUF	_IOWR('V', 93, struct v4l2_buffer)
2430607ca46eSDavid Howells #define VIDIOC_G_SELECTION	_IOWR('V', 94, struct v4l2_selection)
2431607ca46eSDavid Howells #define VIDIOC_S_SELECTION	_IOWR('V', 95, struct v4l2_selection)
2432607ca46eSDavid Howells #define VIDIOC_DECODER_CMD	_IOWR('V', 96, struct v4l2_decoder_cmd)
2433607ca46eSDavid Howells #define VIDIOC_TRY_DECODER_CMD	_IOWR('V', 97, struct v4l2_decoder_cmd)
2434607ca46eSDavid Howells #define VIDIOC_ENUM_DV_TIMINGS  _IOWR('V', 98, struct v4l2_enum_dv_timings)
2435607ca46eSDavid Howells #define VIDIOC_QUERY_DV_TIMINGS  _IOR('V', 99, struct v4l2_dv_timings)
2436607ca46eSDavid Howells #define VIDIOC_DV_TIMINGS_CAP   _IOWR('V', 100, struct v4l2_dv_timings_cap)
2437607ca46eSDavid Howells #define VIDIOC_ENUM_FREQ_BANDS	_IOWR('V', 101, struct v4l2_frequency_band)
2438607ca46eSDavid Howells 
243957c75987SHans Verkuil /*
244057c75987SHans Verkuil  * Experimental, meant for debugging, testing and internal use.
244157c75987SHans Verkuil  * Never use this in applications!
244257c75987SHans Verkuil  */
244396b03d2aSHans Verkuil #define VIDIOC_DBG_G_CHIP_INFO  _IOWR('V', 102, struct v4l2_dbg_chip_info)
244479b0c640SHans Verkuil 
24455082c241SHans Verkuil #define VIDIOC_QUERY_EXT_CTRL	_IOWR('V', 103, struct v4l2_query_ext_ctrl)
24465082c241SHans Verkuil 
2447607ca46eSDavid Howells /* Reminder: when adding new ioctls please add support for them to
2448d9e7d228SRicardo Ribalda    drivers/media/v4l2-core/v4l2-compat-ioctl32.c as well! */
2449607ca46eSDavid Howells 
2450607ca46eSDavid Howells #define BASE_VIDIOC_PRIVATE	192		/* 192-255 are private */
2451607ca46eSDavid Howells 
2452607ca46eSDavid Howells #endif /* _UAPI__LINUX_VIDEODEV2_H */
2453