1 /* $OpenBSD: videoio.h,v 1.21 2025/01/18 19:50:55 kirill Exp $ */
2
3 /*
4 * Video for Linux Two header file
5 *
6 * Copyright (C) 1999-2012 the contributors
7 * Copyright (C) 2012 Nokia Corporation
8 * Contact: Sakari Ailus <sakari.ailus@iki.fi>
9 *
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
14 *
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
19 *
20 * Alternatively you can redistribute this file under the terms of the
21 * BSD license as stated below:
22 *
23 * Redistribution and use in source and binary forms, with or without
24 * modification, are permitted provided that the following conditions
25 * are met:
26 * 1. Redistributions of source code must retain the above copyright
27 * notice, this list of conditions and the following disclaimer.
28 * 2. Redistributions in binary form must reproduce the above copyright
29 * notice, this list of conditions and the following disclaimer in
30 * the documentation and/or other materials provided with the
31 * distribution.
32 * 3. The names of its contributors may not be used to endorse or promote
33 * products derived from this software without specific prior written
34 * permission.
35 *
36 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
37 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
38 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
39 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
40 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
41 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
42 * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
43 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
44 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
45 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
46 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
47 *
48 * Header file for v4l or V4L2 drivers and applications
49 * with public API.
50 * All kernel-specific stuff were moved to media/v4l2-dev.h, so
51 * no #if __KERNEL tests are allowed here
52 *
53 * See https://linuxtv.org for more info
54 *
55 * Author: Bill Dirks <bill@thedirks.org>
56 * Justin Schoeman
57 * Hans Verkuil <hverkuil@xs4all.nl>
58 * et al.
59 */
60
61 #ifndef _SYS_VIDEOIO_H_
62 #define _SYS_VIDEOIO_H_
63 #include <sys/time.h>
64 #include <sys/types.h>
65 #include <sys/ioccom.h>
66 /* Inline #include <linux/v4l2-common.h>
67 * (v4l2-common.h was split off from videodev2.h and has the same BSD license.)
68 *
69 * Begin of v4l2-common.h
70 */
71 /*
72 *
73 * Selection interface definitions
74 *
75 */
76
77 /* Current cropping area */
78 #define V4L2_SEL_TGT_CROP 0x0000
79 /* Default cropping area */
80 #define V4L2_SEL_TGT_CROP_DEFAULT 0x0001
81 /* Cropping bounds */
82 #define V4L2_SEL_TGT_CROP_BOUNDS 0x0002
83 /* Native frame size */
84 #define V4L2_SEL_TGT_NATIVE_SIZE 0x0003
85 /* Current composing area */
86 #define V4L2_SEL_TGT_COMPOSE 0x0100
87 /* Default composing area */
88 #define V4L2_SEL_TGT_COMPOSE_DEFAULT 0x0101
89 /* Composing bounds */
90 #define V4L2_SEL_TGT_COMPOSE_BOUNDS 0x0102
91 /* Current composing area plus all padding pixels */
92 #define V4L2_SEL_TGT_COMPOSE_PADDED 0x0103
93
94 /* Backward compatibility target definitions --- to be removed. */
95 #define V4L2_SEL_TGT_CROP_ACTIVE V4L2_SEL_TGT_CROP
96 #define V4L2_SEL_TGT_COMPOSE_ACTIVE V4L2_SEL_TGT_COMPOSE
97 #define V4L2_SUBDEV_SEL_TGT_CROP_ACTUAL V4L2_SEL_TGT_CROP
98 #define V4L2_SUBDEV_SEL_TGT_COMPOSE_ACTUAL V4L2_SEL_TGT_COMPOSE
99 #define V4L2_SUBDEV_SEL_TGT_CROP_BOUNDS V4L2_SEL_TGT_CROP_BOUNDS
100 #define V4L2_SUBDEV_SEL_TGT_COMPOSE_BOUNDS V4L2_SEL_TGT_COMPOSE_BOUNDS
101
102 /* Selection flags */
103 #define V4L2_SEL_FLAG_GE (1 << 0)
104 #define V4L2_SEL_FLAG_LE (1 << 1)
105 #define V4L2_SEL_FLAG_KEEP_CONFIG (1 << 2)
106
107 struct v4l2_edid {
108 u_int32_t pad;
109 u_int32_t start_block;
110 u_int32_t blocks;
111 u_int32_t reserved[5];
112 u_int8_t *edid;
113 };
114
115 /* Backward compatibility target definitions --- to be removed. */
116 #define V4L2_SEL_TGT_CROP_ACTIVE V4L2_SEL_TGT_CROP
117 #define V4L2_SEL_TGT_COMPOSE_ACTIVE V4L2_SEL_TGT_COMPOSE
118 #define V4L2_SUBDEV_SEL_TGT_CROP_ACTUAL V4L2_SEL_TGT_CROP
119 #define V4L2_SUBDEV_SEL_TGT_COMPOSE_ACTUAL V4L2_SEL_TGT_COMPOSE
120 #define V4L2_SUBDEV_SEL_TGT_CROP_BOUNDS V4L2_SEL_TGT_CROP_BOUNDS
121 #define V4L2_SUBDEV_SEL_TGT_COMPOSE_BOUNDS V4L2_SEL_TGT_COMPOSE_BOUNDS
122
123 /* Backward compatibility flag definitions --- to be removed. */
124 #define V4L2_SUBDEV_SEL_FLAG_SIZE_GE V4L2_SEL_FLAG_GE
125 #define V4L2_SUBDEV_SEL_FLAG_SIZE_LE V4L2_SEL_FLAG_LE
126 #define V4L2_SUBDEV_SEL_FLAG_KEEP_CONFIG V4L2_SEL_FLAG_KEEP_CONFIG
127 /*
128 * End of v4l2-common.h
129 */
130 /* Inline #include <linux/v4l2-controls.h>
131 * (v4l2-controls.h was split off from videodev2.h and has the same BSD license.)
132 *
133 * Begin of v4l2-controls.h
134 */
135 /* Control classes */
136 #define V4L2_CTRL_CLASS_USER 0x00980000 /* Old-style 'user' controls */
137 #define V4L2_CTRL_CLASS_CODEC 0x00990000 /* Stateful codec controls */
138 #define V4L2_CTRL_CLASS_CAMERA 0x009a0000 /* Camera class controls */
139 #define V4L2_CTRL_CLASS_FM_TX 0x009b0000 /* FM Modulator controls */
140 #define V4L2_CTRL_CLASS_FLASH 0x009c0000 /* Camera flash controls */
141 #define V4L2_CTRL_CLASS_JPEG 0x009d0000 /* JPEG-compression controls */
142 #define V4L2_CTRL_CLASS_IMAGE_SOURCE 0x009e0000 /* Image source controls */
143 #define V4L2_CTRL_CLASS_IMAGE_PROC 0x009f0000 /* Image processing controls */
144 #define V4L2_CTRL_CLASS_DV 0x00a00000 /* Digital Video controls */
145 #define V4L2_CTRL_CLASS_FM_RX 0x00a10000 /* FM Receiver controls */
146 #define V4L2_CTRL_CLASS_RF_TUNER 0x00a20000 /* RF tuner controls */
147 #define V4L2_CTRL_CLASS_DETECT 0x00a30000 /* Detection controls */
148 #define V4L2_CTRL_CLASS_CODEC_STATELESS 0x00a40000 /* Stateless codecs controls */
149 #define V4L2_CTRL_CLASS_COLORIMETRY 0x00a50000 /* Colorimetry controls */
150
151 /* User-class control IDs */
152
153 #define V4L2_CID_BASE (V4L2_CTRL_CLASS_USER | 0x900)
154 #define V4L2_CID_USER_BASE V4L2_CID_BASE
155 #define V4L2_CID_USER_CLASS (V4L2_CTRL_CLASS_USER | 1)
156 #define V4L2_CID_BRIGHTNESS (V4L2_CID_BASE+0)
157 #define V4L2_CID_CONTRAST (V4L2_CID_BASE+1)
158 #define V4L2_CID_SATURATION (V4L2_CID_BASE+2)
159 #define V4L2_CID_HUE (V4L2_CID_BASE+3)
160 #define V4L2_CID_AUDIO_VOLUME (V4L2_CID_BASE+5)
161 #define V4L2_CID_AUDIO_BALANCE (V4L2_CID_BASE+6)
162 #define V4L2_CID_AUDIO_BASS (V4L2_CID_BASE+7)
163 #define V4L2_CID_AUDIO_TREBLE (V4L2_CID_BASE+8)
164 #define V4L2_CID_AUDIO_MUTE (V4L2_CID_BASE+9)
165 #define V4L2_CID_AUDIO_LOUDNESS (V4L2_CID_BASE+10)
166 #define V4L2_CID_BLACK_LEVEL (V4L2_CID_BASE+11) /* Deprecated */
167 #define V4L2_CID_AUTO_WHITE_BALANCE (V4L2_CID_BASE+12)
168 #define V4L2_CID_DO_WHITE_BALANCE (V4L2_CID_BASE+13)
169 #define V4L2_CID_RED_BALANCE (V4L2_CID_BASE+14)
170 #define V4L2_CID_BLUE_BALANCE (V4L2_CID_BASE+15)
171 #define V4L2_CID_GAMMA (V4L2_CID_BASE+16)
172 #define V4L2_CID_WHITENESS (V4L2_CID_GAMMA) /* Deprecated */
173 #define V4L2_CID_EXPOSURE (V4L2_CID_BASE+17)
174 #define V4L2_CID_AUTOGAIN (V4L2_CID_BASE+18)
175 #define V4L2_CID_GAIN (V4L2_CID_BASE+19)
176 #define V4L2_CID_HFLIP (V4L2_CID_BASE+20)
177 #define V4L2_CID_VFLIP (V4L2_CID_BASE+21)
178
179 #define V4L2_CID_POWER_LINE_FREQUENCY (V4L2_CID_BASE+24)
180 enum v4l2_power_line_frequency {
181 V4L2_CID_POWER_LINE_FREQUENCY_DISABLED = 0,
182 V4L2_CID_POWER_LINE_FREQUENCY_50HZ = 1,
183 V4L2_CID_POWER_LINE_FREQUENCY_60HZ = 2,
184 V4L2_CID_POWER_LINE_FREQUENCY_AUTO = 3,
185 };
186 #define V4L2_CID_HUE_AUTO (V4L2_CID_BASE+25)
187 #define V4L2_CID_WHITE_BALANCE_TEMPERATURE (V4L2_CID_BASE+26)
188 #define V4L2_CID_SHARPNESS (V4L2_CID_BASE+27)
189 #define V4L2_CID_BACKLIGHT_COMPENSATION (V4L2_CID_BASE+28)
190 #define V4L2_CID_CHROMA_AGC (V4L2_CID_BASE+29)
191 #define V4L2_CID_COLOR_KILLER (V4L2_CID_BASE+30)
192 #define V4L2_CID_COLORFX (V4L2_CID_BASE+31)
193 enum v4l2_colorfx {
194 V4L2_COLORFX_NONE = 0,
195 V4L2_COLORFX_BW = 1,
196 V4L2_COLORFX_SEPIA = 2,
197 V4L2_COLORFX_NEGATIVE = 3,
198 V4L2_COLORFX_EMBOSS = 4,
199 V4L2_COLORFX_SKETCH = 5,
200 V4L2_COLORFX_SKY_BLUE = 6,
201 V4L2_COLORFX_GRASS_GREEN = 7,
202 V4L2_COLORFX_SKIN_WHITEN = 8,
203 V4L2_COLORFX_VIVID = 9,
204 V4L2_COLORFX_AQUA = 10,
205 V4L2_COLORFX_ART_FREEZE = 11,
206 V4L2_COLORFX_SILHOUETTE = 12,
207 V4L2_COLORFX_SOLARIZATION = 13,
208 V4L2_COLORFX_ANTIQUE = 14,
209 V4L2_COLORFX_SET_CBCR = 15,
210 V4L2_COLORFX_SET_RGB = 16,
211 };
212 #define V4L2_CID_AUTOBRIGHTNESS (V4L2_CID_BASE+32)
213 #define V4L2_CID_BAND_STOP_FILTER (V4L2_CID_BASE+33)
214
215 #define V4L2_CID_ROTATE (V4L2_CID_BASE+34)
216 #define V4L2_CID_BG_COLOR (V4L2_CID_BASE+35)
217
218 #define V4L2_CID_CHROMA_GAIN (V4L2_CID_BASE+36)
219
220 #define V4L2_CID_ILLUMINATORS_1 (V4L2_CID_BASE+37)
221 #define V4L2_CID_ILLUMINATORS_2 (V4L2_CID_BASE+38)
222
223 #define V4L2_CID_MIN_BUFFERS_FOR_CAPTURE (V4L2_CID_BASE+39)
224 #define V4L2_CID_MIN_BUFFERS_FOR_OUTPUT (V4L2_CID_BASE+40)
225
226 #define V4L2_CID_ALPHA_COMPONENT (V4L2_CID_BASE+41)
227 #define V4L2_CID_COLORFX_CBCR (V4L2_CID_BASE+42)
228 #define V4L2_CID_COLORFX_RGB (V4L2_CID_BASE+43)
229
230 /* last CID + 1 */
231 #define V4L2_CID_LASTP1 (V4L2_CID_BASE+44)
232
233 /* USER-class private control IDs */
234
235 /*
236 * The base for the meye driver controls. This driver was removed, but
237 * we keep this define in case any software still uses it.
238 */
239 #define V4L2_CID_USER_MEYE_BASE (V4L2_CID_USER_BASE + 0x1000)
240
241 /* The base for the bttv driver controls.
242 * We reserve 32 controls for this driver. */
243 #define V4L2_CID_USER_BTTV_BASE (V4L2_CID_USER_BASE + 0x1010)
244
245
246 /* The base for the s2255 driver controls.
247 * We reserve 16 controls for this driver. */
248 #define V4L2_CID_USER_S2255_BASE (V4L2_CID_USER_BASE + 0x1030)
249
250 /*
251 * The base for the si476x driver controls. See include/media/drv-intf/si476x.h
252 * for the list of controls. Total of 16 controls is reserved for this driver
253 */
254 #define V4L2_CID_USER_SI476X_BASE (V4L2_CID_USER_BASE + 0x1040)
255
256 /* The base for the TI VPE driver controls. Total of 16 controls is reserved for
257 * this driver */
258 #define V4L2_CID_USER_TI_VPE_BASE (V4L2_CID_USER_BASE + 0x1050)
259
260 /* The base for the saa7134 driver controls.
261 * We reserve 16 controls for this driver. */
262 #define V4L2_CID_USER_SAA7134_BASE (V4L2_CID_USER_BASE + 0x1060)
263
264 /* The base for the adv7180 driver controls.
265 * We reserve 16 controls for this driver. */
266 #define V4L2_CID_USER_ADV7180_BASE (V4L2_CID_USER_BASE + 0x1070)
267
268 /* The base for the tc358743 driver controls.
269 * We reserve 16 controls for this driver. */
270 #define V4L2_CID_USER_TC358743_BASE (V4L2_CID_USER_BASE + 0x1080)
271
272 /* The base for the max217x driver controls.
273 * We reserve 32 controls for this driver
274 */
275 #define V4L2_CID_USER_MAX217X_BASE (V4L2_CID_USER_BASE + 0x1090)
276
277 /* The base for the imx driver controls.
278 * We reserve 16 controls for this driver. */
279 #define V4L2_CID_USER_IMX_BASE (V4L2_CID_USER_BASE + 0x10b0)
280
281 /*
282 * The base for the atmel isc driver controls.
283 * We reserve 32 controls for this driver.
284 */
285 #define V4L2_CID_USER_ATMEL_ISC_BASE (V4L2_CID_USER_BASE + 0x10c0)
286
287 /*
288 * The base for the CODA driver controls.
289 * We reserve 16 controls for this driver.
290 */
291 #define V4L2_CID_USER_CODA_BASE (V4L2_CID_USER_BASE + 0x10e0)
292 /*
293 * The base for MIPI CCS driver controls.
294 * We reserve 128 controls for this driver.
295 */
296 #define V4L2_CID_USER_CCS_BASE (V4L2_CID_USER_BASE + 0x10f0)
297 /*
298 * The base for Allegro driver controls.
299 * We reserve 16 controls for this driver.
300 */
301 #define V4L2_CID_USER_ALLEGRO_BASE (V4L2_CID_USER_BASE + 0x1170)
302
303 /*
304 * The base for the isl7998x driver controls.
305 * We reserve 16 controls for this driver.
306 */
307 #define V4L2_CID_USER_ISL7998X_BASE (V4L2_CID_USER_BASE + 0x1180)
308
309 /*
310 * The base for DW100 driver controls.
311 * We reserve 16 controls for this driver.
312 */
313 #define V4L2_CID_USER_DW100_BASE (V4L2_CID_USER_BASE + 0x1190)
314
315 /*
316 * The base for Aspeed driver controls.
317 * We reserve 16 controls for this driver.
318 */
319 #define V4L2_CID_USER_ASPEED_BASE (V4L2_CID_USER_BASE + 0x11a0)
320
321 /*
322 * The base for Nuvoton NPCM driver controls.
323 * We reserve 16 controls for this driver.
324 */
325 #define V4L2_CID_USER_NPCM_BASE (V4L2_CID_USER_BASE + 0x11b0)
326
327 /*
328 * The base for THine THP7312 driver controls.
329 * We reserve 32 controls for this driver.
330 */
331 #define V4L2_CID_USER_THP7312_BASE (V4L2_CID_USER_BASE + 0x11c0)
332
333 /* MPEG-class control IDs */
334 /* The MPEG controls are applicable to all codec controls
335 * and the 'MPEG' part of the define is historical */
336
337 #define V4L2_CID_CODEC_BASE (V4L2_CTRL_CLASS_CODEC | 0x900)
338 #define V4L2_CID_CODEC_CLASS (V4L2_CTRL_CLASS_CODEC | 1)
339
340 /* MPEG streams, specific to multiplexed streams */
341 #define V4L2_CID_MPEG_STREAM_TYPE (V4L2_CID_CODEC_BASE+0)
342 enum v4l2_mpeg_stream_type {
343 V4L2_MPEG_STREAM_TYPE_MPEG2_PS = 0, /* MPEG-2 program stream */
344 V4L2_MPEG_STREAM_TYPE_MPEG2_TS = 1, /* MPEG-2 transport stream */
345 V4L2_MPEG_STREAM_TYPE_MPEG1_SS = 2, /* MPEG-1 system stream */
346 V4L2_MPEG_STREAM_TYPE_MPEG2_DVD = 3, /* MPEG-2 DVD-compatible stream */
347 V4L2_MPEG_STREAM_TYPE_MPEG1_VCD = 4, /* MPEG-1 VCD-compatible stream */
348 V4L2_MPEG_STREAM_TYPE_MPEG2_SVCD = 5, /* MPEG-2 SVCD-compatible stream */
349 };
350 #define V4L2_CID_MPEG_STREAM_PID_PMT (V4L2_CID_CODEC_BASE+1)
351 #define V4L2_CID_MPEG_STREAM_PID_AUDIO (V4L2_CID_CODEC_BASE+2)
352 #define V4L2_CID_MPEG_STREAM_PID_VIDEO (V4L2_CID_CODEC_BASE+3)
353 #define V4L2_CID_MPEG_STREAM_PID_PCR (V4L2_CID_CODEC_BASE+4)
354 #define V4L2_CID_MPEG_STREAM_PES_ID_AUDIO (V4L2_CID_CODEC_BASE+5)
355 #define V4L2_CID_MPEG_STREAM_PES_ID_VIDEO (V4L2_CID_CODEC_BASE+6)
356 #define V4L2_CID_MPEG_STREAM_VBI_FMT (V4L2_CID_CODEC_BASE+7)
357 enum v4l2_mpeg_stream_vbi_fmt {
358 V4L2_MPEG_STREAM_VBI_FMT_NONE = 0, /* No VBI in the MPEG stream */
359 V4L2_MPEG_STREAM_VBI_FMT_IVTV = 1, /* VBI in private packets, IVTV format */
360 };
361
362 /* MPEG audio controls specific to multiplexed streams */
363 #define V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ (V4L2_CID_CODEC_BASE+100)
364 enum v4l2_mpeg_audio_sampling_freq {
365 V4L2_MPEG_AUDIO_SAMPLING_FREQ_44100 = 0,
366 V4L2_MPEG_AUDIO_SAMPLING_FREQ_48000 = 1,
367 V4L2_MPEG_AUDIO_SAMPLING_FREQ_32000 = 2,
368 };
369 #define V4L2_CID_MPEG_AUDIO_ENCODING (V4L2_CID_CODEC_BASE+101)
370 enum v4l2_mpeg_audio_encoding {
371 V4L2_MPEG_AUDIO_ENCODING_LAYER_1 = 0,
372 V4L2_MPEG_AUDIO_ENCODING_LAYER_2 = 1,
373 V4L2_MPEG_AUDIO_ENCODING_LAYER_3 = 2,
374 V4L2_MPEG_AUDIO_ENCODING_AAC = 3,
375 V4L2_MPEG_AUDIO_ENCODING_AC3 = 4,
376 };
377 #define V4L2_CID_MPEG_AUDIO_L1_BITRATE (V4L2_CID_CODEC_BASE+102)
378 enum v4l2_mpeg_audio_l1_bitrate {
379 V4L2_MPEG_AUDIO_L1_BITRATE_32K = 0,
380 V4L2_MPEG_AUDIO_L1_BITRATE_64K = 1,
381 V4L2_MPEG_AUDIO_L1_BITRATE_96K = 2,
382 V4L2_MPEG_AUDIO_L1_BITRATE_128K = 3,
383 V4L2_MPEG_AUDIO_L1_BITRATE_160K = 4,
384 V4L2_MPEG_AUDIO_L1_BITRATE_192K = 5,
385 V4L2_MPEG_AUDIO_L1_BITRATE_224K = 6,
386 V4L2_MPEG_AUDIO_L1_BITRATE_256K = 7,
387 V4L2_MPEG_AUDIO_L1_BITRATE_288K = 8,
388 V4L2_MPEG_AUDIO_L1_BITRATE_320K = 9,
389 V4L2_MPEG_AUDIO_L1_BITRATE_352K = 10,
390 V4L2_MPEG_AUDIO_L1_BITRATE_384K = 11,
391 V4L2_MPEG_AUDIO_L1_BITRATE_416K = 12,
392 V4L2_MPEG_AUDIO_L1_BITRATE_448K = 13,
393 };
394 #define V4L2_CID_MPEG_AUDIO_L2_BITRATE (V4L2_CID_CODEC_BASE+103)
395 enum v4l2_mpeg_audio_l2_bitrate {
396 V4L2_MPEG_AUDIO_L2_BITRATE_32K = 0,
397 V4L2_MPEG_AUDIO_L2_BITRATE_48K = 1,
398 V4L2_MPEG_AUDIO_L2_BITRATE_56K = 2,
399 V4L2_MPEG_AUDIO_L2_BITRATE_64K = 3,
400 V4L2_MPEG_AUDIO_L2_BITRATE_80K = 4,
401 V4L2_MPEG_AUDIO_L2_BITRATE_96K = 5,
402 V4L2_MPEG_AUDIO_L2_BITRATE_112K = 6,
403 V4L2_MPEG_AUDIO_L2_BITRATE_128K = 7,
404 V4L2_MPEG_AUDIO_L2_BITRATE_160K = 8,
405 V4L2_MPEG_AUDIO_L2_BITRATE_192K = 9,
406 V4L2_MPEG_AUDIO_L2_BITRATE_224K = 10,
407 V4L2_MPEG_AUDIO_L2_BITRATE_256K = 11,
408 V4L2_MPEG_AUDIO_L2_BITRATE_320K = 12,
409 V4L2_MPEG_AUDIO_L2_BITRATE_384K = 13,
410 };
411 #define V4L2_CID_MPEG_AUDIO_L3_BITRATE (V4L2_CID_CODEC_BASE+104)
412 enum v4l2_mpeg_audio_l3_bitrate {
413 V4L2_MPEG_AUDIO_L3_BITRATE_32K = 0,
414 V4L2_MPEG_AUDIO_L3_BITRATE_40K = 1,
415 V4L2_MPEG_AUDIO_L3_BITRATE_48K = 2,
416 V4L2_MPEG_AUDIO_L3_BITRATE_56K = 3,
417 V4L2_MPEG_AUDIO_L3_BITRATE_64K = 4,
418 V4L2_MPEG_AUDIO_L3_BITRATE_80K = 5,
419 V4L2_MPEG_AUDIO_L3_BITRATE_96K = 6,
420 V4L2_MPEG_AUDIO_L3_BITRATE_112K = 7,
421 V4L2_MPEG_AUDIO_L3_BITRATE_128K = 8,
422 V4L2_MPEG_AUDIO_L3_BITRATE_160K = 9,
423 V4L2_MPEG_AUDIO_L3_BITRATE_192K = 10,
424 V4L2_MPEG_AUDIO_L3_BITRATE_224K = 11,
425 V4L2_MPEG_AUDIO_L3_BITRATE_256K = 12,
426 V4L2_MPEG_AUDIO_L3_BITRATE_320K = 13,
427 };
428 #define V4L2_CID_MPEG_AUDIO_MODE (V4L2_CID_CODEC_BASE+105)
429 enum v4l2_mpeg_audio_mode {
430 V4L2_MPEG_AUDIO_MODE_STEREO = 0,
431 V4L2_MPEG_AUDIO_MODE_JOINT_STEREO = 1,
432 V4L2_MPEG_AUDIO_MODE_DUAL = 2,
433 V4L2_MPEG_AUDIO_MODE_MONO = 3,
434 };
435 #define V4L2_CID_MPEG_AUDIO_MODE_EXTENSION (V4L2_CID_CODEC_BASE+106)
436 enum v4l2_mpeg_audio_mode_extension {
437 V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_4 = 0,
438 V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_8 = 1,
439 V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_12 = 2,
440 V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_16 = 3,
441 };
442 #define V4L2_CID_MPEG_AUDIO_EMPHASIS (V4L2_CID_CODEC_BASE+107)
443 enum v4l2_mpeg_audio_emphasis {
444 V4L2_MPEG_AUDIO_EMPHASIS_NONE = 0,
445 V4L2_MPEG_AUDIO_EMPHASIS_50_DIV_15_uS = 1,
446 V4L2_MPEG_AUDIO_EMPHASIS_CCITT_J17 = 2,
447 };
448 #define V4L2_CID_MPEG_AUDIO_CRC (V4L2_CID_CODEC_BASE+108)
449 enum v4l2_mpeg_audio_crc {
450 V4L2_MPEG_AUDIO_CRC_NONE = 0,
451 V4L2_MPEG_AUDIO_CRC_CRC16 = 1,
452 };
453 #define V4L2_CID_MPEG_AUDIO_MUTE (V4L2_CID_CODEC_BASE+109)
454 #define V4L2_CID_MPEG_AUDIO_AAC_BITRATE (V4L2_CID_CODEC_BASE+110)
455 #define V4L2_CID_MPEG_AUDIO_AC3_BITRATE (V4L2_CID_CODEC_BASE+111)
456 enum v4l2_mpeg_audio_ac3_bitrate {
457 V4L2_MPEG_AUDIO_AC3_BITRATE_32K = 0,
458 V4L2_MPEG_AUDIO_AC3_BITRATE_40K = 1,
459 V4L2_MPEG_AUDIO_AC3_BITRATE_48K = 2,
460 V4L2_MPEG_AUDIO_AC3_BITRATE_56K = 3,
461 V4L2_MPEG_AUDIO_AC3_BITRATE_64K = 4,
462 V4L2_MPEG_AUDIO_AC3_BITRATE_80K = 5,
463 V4L2_MPEG_AUDIO_AC3_BITRATE_96K = 6,
464 V4L2_MPEG_AUDIO_AC3_BITRATE_112K = 7,
465 V4L2_MPEG_AUDIO_AC3_BITRATE_128K = 8,
466 V4L2_MPEG_AUDIO_AC3_BITRATE_160K = 9,
467 V4L2_MPEG_AUDIO_AC3_BITRATE_192K = 10,
468 V4L2_MPEG_AUDIO_AC3_BITRATE_224K = 11,
469 V4L2_MPEG_AUDIO_AC3_BITRATE_256K = 12,
470 V4L2_MPEG_AUDIO_AC3_BITRATE_320K = 13,
471 V4L2_MPEG_AUDIO_AC3_BITRATE_384K = 14,
472 V4L2_MPEG_AUDIO_AC3_BITRATE_448K = 15,
473 V4L2_MPEG_AUDIO_AC3_BITRATE_512K = 16,
474 V4L2_MPEG_AUDIO_AC3_BITRATE_576K = 17,
475 V4L2_MPEG_AUDIO_AC3_BITRATE_640K = 18,
476 };
477 #define V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK (V4L2_CID_CODEC_BASE+112)
478 enum v4l2_mpeg_audio_dec_playback {
479 V4L2_MPEG_AUDIO_DEC_PLAYBACK_AUTO = 0,
480 V4L2_MPEG_AUDIO_DEC_PLAYBACK_STEREO = 1,
481 V4L2_MPEG_AUDIO_DEC_PLAYBACK_LEFT = 2,
482 V4L2_MPEG_AUDIO_DEC_PLAYBACK_RIGHT = 3,
483 V4L2_MPEG_AUDIO_DEC_PLAYBACK_MONO = 4,
484 V4L2_MPEG_AUDIO_DEC_PLAYBACK_SWAPPED_STEREO = 5,
485 };
486 #define V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK (V4L2_CID_CODEC_BASE+113)
487
488 /* MPEG video controls specific to multiplexed streams */
489 #define V4L2_CID_MPEG_VIDEO_ENCODING (V4L2_CID_CODEC_BASE+200)
490 enum v4l2_mpeg_video_encoding {
491 V4L2_MPEG_VIDEO_ENCODING_MPEG_1 = 0,
492 V4L2_MPEG_VIDEO_ENCODING_MPEG_2 = 1,
493 V4L2_MPEG_VIDEO_ENCODING_MPEG_4_AVC = 2,
494 };
495 #define V4L2_CID_MPEG_VIDEO_ASPECT (V4L2_CID_CODEC_BASE+201)
496 enum v4l2_mpeg_video_aspect {
497 V4L2_MPEG_VIDEO_ASPECT_1x1 = 0,
498 V4L2_MPEG_VIDEO_ASPECT_4x3 = 1,
499 V4L2_MPEG_VIDEO_ASPECT_16x9 = 2,
500 V4L2_MPEG_VIDEO_ASPECT_221x100 = 3,
501 };
502 #define V4L2_CID_MPEG_VIDEO_B_FRAMES (V4L2_CID_CODEC_BASE+202)
503 #define V4L2_CID_MPEG_VIDEO_GOP_SIZE (V4L2_CID_CODEC_BASE+203)
504 #define V4L2_CID_MPEG_VIDEO_GOP_CLOSURE (V4L2_CID_CODEC_BASE+204)
505 #define V4L2_CID_MPEG_VIDEO_PULLDOWN (V4L2_CID_CODEC_BASE+205)
506 #define V4L2_CID_MPEG_VIDEO_BITRATE_MODE (V4L2_CID_CODEC_BASE+206)
507 enum v4l2_mpeg_video_bitrate_mode {
508 V4L2_MPEG_VIDEO_BITRATE_MODE_VBR = 0,
509 V4L2_MPEG_VIDEO_BITRATE_MODE_CBR = 1,
510 V4L2_MPEG_VIDEO_BITRATE_MODE_CQ = 2,
511 };
512 #define V4L2_CID_MPEG_VIDEO_BITRATE (V4L2_CID_CODEC_BASE+207)
513 #define V4L2_CID_MPEG_VIDEO_BITRATE_PEAK (V4L2_CID_CODEC_BASE+208)
514 #define V4L2_CID_MPEG_VIDEO_TEMPORAL_DECIMATION (V4L2_CID_CODEC_BASE+209)
515 #define V4L2_CID_MPEG_VIDEO_MUTE (V4L2_CID_CODEC_BASE+210)
516 #define V4L2_CID_MPEG_VIDEO_MUTE_YUV (V4L2_CID_CODEC_BASE+211)
517 #define V4L2_CID_MPEG_VIDEO_DECODER_SLICE_INTERFACE (V4L2_CID_CODEC_BASE+212)
518 #define V4L2_CID_MPEG_VIDEO_DECODER_MPEG4_DEBLOCK_FILTER (V4L2_CID_CODEC_BASE+213)
519 #define V4L2_CID_MPEG_VIDEO_CYCLIC_INTRA_REFRESH_MB (V4L2_CID_CODEC_BASE+214)
520 #define V4L2_CID_MPEG_VIDEO_FRAME_RC_ENABLE (V4L2_CID_CODEC_BASE+215)
521 #define V4L2_CID_MPEG_VIDEO_HEADER_MODE (V4L2_CID_CODEC_BASE+216)
522 enum v4l2_mpeg_video_header_mode {
523 V4L2_MPEG_VIDEO_HEADER_MODE_SEPARATE = 0,
524 V4L2_MPEG_VIDEO_HEADER_MODE_JOINED_WITH_1ST_FRAME = 1,
525
526 };
527 #define V4L2_CID_MPEG_VIDEO_MAX_REF_PIC (V4L2_CID_CODEC_BASE+217)
528 #define V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE (V4L2_CID_CODEC_BASE+218)
529 #define V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_BYTES (V4L2_CID_CODEC_BASE+219)
530 #define V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_MB (V4L2_CID_CODEC_BASE+220)
531 #define V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE (V4L2_CID_CODEC_BASE+221)
532 enum v4l2_mpeg_video_multi_slice_mode {
533 V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_SINGLE = 0,
534 V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_MB = 1,
535 V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_BYTES = 2,
536 /* Kept for backwards compatibility reasons. Stupid typo... */
537 V4L2_MPEG_VIDEO_MULTI_SICE_MODE_MAX_MB = 1,
538 V4L2_MPEG_VIDEO_MULTI_SICE_MODE_MAX_BYTES = 2,
539 };
540 #define V4L2_CID_MPEG_VIDEO_VBV_SIZE (V4L2_CID_CODEC_BASE+222)
541 #define V4L2_CID_MPEG_VIDEO_DEC_PTS (V4L2_CID_CODEC_BASE+223)
542 #define V4L2_CID_MPEG_VIDEO_DEC_FRAME (V4L2_CID_CODEC_BASE+224)
543 #define V4L2_CID_MPEG_VIDEO_VBV_DELAY (V4L2_CID_CODEC_BASE+225)
544 #define V4L2_CID_MPEG_VIDEO_REPEAT_SEQ_HEADER (V4L2_CID_CODEC_BASE+226)
545 #define V4L2_CID_MPEG_VIDEO_MV_H_SEARCH_RANGE (V4L2_CID_CODEC_BASE+227)
546 #define V4L2_CID_MPEG_VIDEO_MV_V_SEARCH_RANGE (V4L2_CID_CODEC_BASE+228)
547 #define V4L2_CID_MPEG_VIDEO_FORCE_KEY_FRAME (V4L2_CID_CODEC_BASE+229)
548 #define V4L2_CID_MPEG_VIDEO_BASELAYER_PRIORITY_ID (V4L2_CID_CODEC_BASE+230)
549 #define V4L2_CID_MPEG_VIDEO_AU_DELIMITER (V4L2_CID_CODEC_BASE+231)
550 #define V4L2_CID_MPEG_VIDEO_LTR_COUNT (V4L2_CID_CODEC_BASE+232)
551 #define V4L2_CID_MPEG_VIDEO_FRAME_LTR_INDEX (V4L2_CID_CODEC_BASE+233)
552 #define V4L2_CID_MPEG_VIDEO_USE_LTR_FRAMES (V4L2_CID_CODEC_BASE+234)
553 #define V4L2_CID_MPEG_VIDEO_DEC_CONCEAL_COLOR (V4L2_CID_CODEC_BASE+235)
554 #define V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD (V4L2_CID_CODEC_BASE+236)
555 #define V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE (V4L2_CID_CODEC_BASE+237)
556 enum v4l2_mpeg_video_intra_refresh_period_type {
557 V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE_RANDOM = 0,
558 V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE_CYCLIC = 1,
559 };
560
561 /* CIDs for the MPEG-2 Part 2 (H.262) codec */
562 #define V4L2_CID_MPEG_VIDEO_MPEG2_LEVEL (V4L2_CID_CODEC_BASE+270)
563 enum v4l2_mpeg_video_mpeg2_level {
564 V4L2_MPEG_VIDEO_MPEG2_LEVEL_LOW = 0,
565 V4L2_MPEG_VIDEO_MPEG2_LEVEL_MAIN = 1,
566 V4L2_MPEG_VIDEO_MPEG2_LEVEL_HIGH_1440 = 2,
567 V4L2_MPEG_VIDEO_MPEG2_LEVEL_HIGH = 3,
568 };
569 #define V4L2_CID_MPEG_VIDEO_MPEG2_PROFILE (V4L2_CID_CODEC_BASE+271)
570 enum v4l2_mpeg_video_mpeg2_profile {
571 V4L2_MPEG_VIDEO_MPEG2_PROFILE_SIMPLE = 0,
572 V4L2_MPEG_VIDEO_MPEG2_PROFILE_MAIN = 1,
573 V4L2_MPEG_VIDEO_MPEG2_PROFILE_SNR_SCALABLE = 2,
574 V4L2_MPEG_VIDEO_MPEG2_PROFILE_SPATIALLY_SCALABLE = 3,
575 V4L2_MPEG_VIDEO_MPEG2_PROFILE_HIGH = 4,
576 V4L2_MPEG_VIDEO_MPEG2_PROFILE_MULTIVIEW = 5,
577 };
578
579 /* CIDs for the FWHT codec as used by the vicodec driver. */
580 #define V4L2_CID_FWHT_I_FRAME_QP (V4L2_CID_CODEC_BASE + 290)
581 #define V4L2_CID_FWHT_P_FRAME_QP (V4L2_CID_CODEC_BASE + 291)
582
583 #define V4L2_CID_MPEG_VIDEO_H263_I_FRAME_QP (V4L2_CID_CODEC_BASE+300)
584 #define V4L2_CID_MPEG_VIDEO_H263_P_FRAME_QP (V4L2_CID_CODEC_BASE+301)
585 #define V4L2_CID_MPEG_VIDEO_H263_B_FRAME_QP (V4L2_CID_CODEC_BASE+302)
586 #define V4L2_CID_MPEG_VIDEO_H263_MIN_QP (V4L2_CID_CODEC_BASE+303)
587 #define V4L2_CID_MPEG_VIDEO_H263_MAX_QP (V4L2_CID_CODEC_BASE+304)
588 #define V4L2_CID_MPEG_VIDEO_H264_I_FRAME_QP (V4L2_CID_CODEC_BASE+350)
589 #define V4L2_CID_MPEG_VIDEO_H264_P_FRAME_QP (V4L2_CID_CODEC_BASE+351)
590 #define V4L2_CID_MPEG_VIDEO_H264_B_FRAME_QP (V4L2_CID_CODEC_BASE+352)
591 #define V4L2_CID_MPEG_VIDEO_H264_MIN_QP (V4L2_CID_CODEC_BASE+353)
592 #define V4L2_CID_MPEG_VIDEO_H264_MAX_QP (V4L2_CID_CODEC_BASE+354)
593 #define V4L2_CID_MPEG_VIDEO_H264_8X8_TRANSFORM (V4L2_CID_CODEC_BASE+355)
594 #define V4L2_CID_MPEG_VIDEO_H264_CPB_SIZE (V4L2_CID_CODEC_BASE+356)
595 #define V4L2_CID_MPEG_VIDEO_H264_ENTROPY_MODE (V4L2_CID_CODEC_BASE+357)
596 enum v4l2_mpeg_video_h264_entropy_mode {
597 V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CAVLC = 0,
598 V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CABAC = 1,
599 };
600 #define V4L2_CID_MPEG_VIDEO_H264_I_PERIOD (V4L2_CID_CODEC_BASE+358)
601 #define V4L2_CID_MPEG_VIDEO_H264_LEVEL (V4L2_CID_CODEC_BASE+359)
602 enum v4l2_mpeg_video_h264_level {
603 V4L2_MPEG_VIDEO_H264_LEVEL_1_0 = 0,
604 V4L2_MPEG_VIDEO_H264_LEVEL_1B = 1,
605 V4L2_MPEG_VIDEO_H264_LEVEL_1_1 = 2,
606 V4L2_MPEG_VIDEO_H264_LEVEL_1_2 = 3,
607 V4L2_MPEG_VIDEO_H264_LEVEL_1_3 = 4,
608 V4L2_MPEG_VIDEO_H264_LEVEL_2_0 = 5,
609 V4L2_MPEG_VIDEO_H264_LEVEL_2_1 = 6,
610 V4L2_MPEG_VIDEO_H264_LEVEL_2_2 = 7,
611 V4L2_MPEG_VIDEO_H264_LEVEL_3_0 = 8,
612 V4L2_MPEG_VIDEO_H264_LEVEL_3_1 = 9,
613 V4L2_MPEG_VIDEO_H264_LEVEL_3_2 = 10,
614 V4L2_MPEG_VIDEO_H264_LEVEL_4_0 = 11,
615 V4L2_MPEG_VIDEO_H264_LEVEL_4_1 = 12,
616 V4L2_MPEG_VIDEO_H264_LEVEL_4_2 = 13,
617 V4L2_MPEG_VIDEO_H264_LEVEL_5_0 = 14,
618 V4L2_MPEG_VIDEO_H264_LEVEL_5_1 = 15,
619 V4L2_MPEG_VIDEO_H264_LEVEL_5_2 = 16,
620 V4L2_MPEG_VIDEO_H264_LEVEL_6_0 = 17,
621 V4L2_MPEG_VIDEO_H264_LEVEL_6_1 = 18,
622 V4L2_MPEG_VIDEO_H264_LEVEL_6_2 = 19,
623 };
624 #define V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_ALPHA (V4L2_CID_CODEC_BASE+360)
625 #define V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_BETA (V4L2_CID_CODEC_BASE+361)
626 #define V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_MODE (V4L2_CID_CODEC_BASE+362)
627 enum v4l2_mpeg_video_h264_loop_filter_mode {
628 V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_ENABLED = 0,
629 V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED = 1,
630 V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED_AT_SLICE_BOUNDARY = 2,
631 };
632 #define V4L2_CID_MPEG_VIDEO_H264_PROFILE (V4L2_CID_CODEC_BASE+363)
633 enum v4l2_mpeg_video_h264_profile {
634 V4L2_MPEG_VIDEO_H264_PROFILE_BASELINE = 0,
635 V4L2_MPEG_VIDEO_H264_PROFILE_CONSTRAINED_BASELINE = 1,
636 V4L2_MPEG_VIDEO_H264_PROFILE_MAIN = 2,
637 V4L2_MPEG_VIDEO_H264_PROFILE_EXTENDED = 3,
638 V4L2_MPEG_VIDEO_H264_PROFILE_HIGH = 4,
639 V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10 = 5,
640 V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422 = 6,
641 V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_PREDICTIVE = 7,
642 V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10_INTRA = 8,
643 V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422_INTRA = 9,
644 V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_INTRA = 10,
645 V4L2_MPEG_VIDEO_H264_PROFILE_CAVLC_444_INTRA = 11,
646 V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_BASELINE = 12,
647 V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH = 13,
648 V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH_INTRA = 14,
649 V4L2_MPEG_VIDEO_H264_PROFILE_STEREO_HIGH = 15,
650 V4L2_MPEG_VIDEO_H264_PROFILE_MULTIVIEW_HIGH = 16,
651 V4L2_MPEG_VIDEO_H264_PROFILE_CONSTRAINED_HIGH = 17,
652 };
653 #define V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_HEIGHT (V4L2_CID_CODEC_BASE+364)
654 #define V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_WIDTH (V4L2_CID_CODEC_BASE+365)
655 #define V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_ENABLE (V4L2_CID_CODEC_BASE+366)
656 #define V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_IDC (V4L2_CID_CODEC_BASE+367)
657 enum v4l2_mpeg_video_h264_vui_sar_idc {
658 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_UNSPECIFIED = 0,
659 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_1x1 = 1,
660 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_12x11 = 2,
661 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_10x11 = 3,
662 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_16x11 = 4,
663 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_40x33 = 5,
664 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_24x11 = 6,
665 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_20x11 = 7,
666 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_32x11 = 8,
667 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_80x33 = 9,
668 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_18x11 = 10,
669 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_15x11 = 11,
670 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_64x33 = 12,
671 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_160x99 = 13,
672 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_4x3 = 14,
673 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_3x2 = 15,
674 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_2x1 = 16,
675 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_EXTENDED = 17,
676 };
677 #define V4L2_CID_MPEG_VIDEO_H264_SEI_FRAME_PACKING (V4L2_CID_CODEC_BASE+368)
678 #define V4L2_CID_MPEG_VIDEO_H264_SEI_FP_CURRENT_FRAME_0 (V4L2_CID_CODEC_BASE+369)
679 #define V4L2_CID_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE (V4L2_CID_CODEC_BASE+370)
680 enum v4l2_mpeg_video_h264_sei_fp_arrangement_type {
681 V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_CHECKERBOARD = 0,
682 V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_COLUMN = 1,
683 V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_ROW = 2,
684 V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_SIDE_BY_SIDE = 3,
685 V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_TOP_BOTTOM = 4,
686 V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_TEMPORAL = 5,
687 };
688 #define V4L2_CID_MPEG_VIDEO_H264_FMO (V4L2_CID_CODEC_BASE+371)
689 #define V4L2_CID_MPEG_VIDEO_H264_FMO_MAP_TYPE (V4L2_CID_CODEC_BASE+372)
690 enum v4l2_mpeg_video_h264_fmo_map_type {
691 V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_INTERLEAVED_SLICES = 0,
692 V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_SCATTERED_SLICES = 1,
693 V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_FOREGROUND_WITH_LEFT_OVER = 2,
694 V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_BOX_OUT = 3,
695 V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_RASTER_SCAN = 4,
696 V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_WIPE_SCAN = 5,
697 V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_EXPLICIT = 6,
698 };
699 #define V4L2_CID_MPEG_VIDEO_H264_FMO_SLICE_GROUP (V4L2_CID_CODEC_BASE+373)
700 #define V4L2_CID_MPEG_VIDEO_H264_FMO_CHANGE_DIRECTION (V4L2_CID_CODEC_BASE+374)
701 enum v4l2_mpeg_video_h264_fmo_change_dir {
702 V4L2_MPEG_VIDEO_H264_FMO_CHANGE_DIR_RIGHT = 0,
703 V4L2_MPEG_VIDEO_H264_FMO_CHANGE_DIR_LEFT = 1,
704 };
705 #define V4L2_CID_MPEG_VIDEO_H264_FMO_CHANGE_RATE (V4L2_CID_CODEC_BASE+375)
706 #define V4L2_CID_MPEG_VIDEO_H264_FMO_RUN_LENGTH (V4L2_CID_CODEC_BASE+376)
707 #define V4L2_CID_MPEG_VIDEO_H264_ASO (V4L2_CID_CODEC_BASE+377)
708 #define V4L2_CID_MPEG_VIDEO_H264_ASO_SLICE_ORDER (V4L2_CID_CODEC_BASE+378)
709 #define V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING (V4L2_CID_CODEC_BASE+379)
710 #define V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_TYPE (V4L2_CID_CODEC_BASE+380)
711 enum v4l2_mpeg_video_h264_hierarchical_coding_type {
712 V4L2_MPEG_VIDEO_H264_HIERARCHICAL_CODING_B = 0,
713 V4L2_MPEG_VIDEO_H264_HIERARCHICAL_CODING_P = 1,
714 };
715 #define V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_LAYER (V4L2_CID_CODEC_BASE+381)
716 #define V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_LAYER_QP (V4L2_CID_CODEC_BASE+382)
717 #define V4L2_CID_MPEG_VIDEO_H264_CONSTRAINED_INTRA_PREDICTION (V4L2_CID_CODEC_BASE+383)
718 #define V4L2_CID_MPEG_VIDEO_H264_CHROMA_QP_INDEX_OFFSET (V4L2_CID_CODEC_BASE+384)
719 #define V4L2_CID_MPEG_VIDEO_H264_I_FRAME_MIN_QP (V4L2_CID_CODEC_BASE+385)
720 #define V4L2_CID_MPEG_VIDEO_H264_I_FRAME_MAX_QP (V4L2_CID_CODEC_BASE+386)
721 #define V4L2_CID_MPEG_VIDEO_H264_P_FRAME_MIN_QP (V4L2_CID_CODEC_BASE+387)
722 #define V4L2_CID_MPEG_VIDEO_H264_P_FRAME_MAX_QP (V4L2_CID_CODEC_BASE+388)
723 #define V4L2_CID_MPEG_VIDEO_H264_B_FRAME_MIN_QP (V4L2_CID_CODEC_BASE+389)
724 #define V4L2_CID_MPEG_VIDEO_H264_B_FRAME_MAX_QP (V4L2_CID_CODEC_BASE+390)
725 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L0_BR (V4L2_CID_CODEC_BASE+391)
726 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L1_BR (V4L2_CID_CODEC_BASE+392)
727 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L2_BR (V4L2_CID_CODEC_BASE+393)
728 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L3_BR (V4L2_CID_CODEC_BASE+394)
729 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L4_BR (V4L2_CID_CODEC_BASE+395)
730 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L5_BR (V4L2_CID_CODEC_BASE+396)
731 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L6_BR (V4L2_CID_CODEC_BASE+397)
732 #define V4L2_CID_MPEG_VIDEO_MPEG4_I_FRAME_QP (V4L2_CID_CODEC_BASE+400)
733 #define V4L2_CID_MPEG_VIDEO_MPEG4_P_FRAME_QP (V4L2_CID_CODEC_BASE+401)
734 #define V4L2_CID_MPEG_VIDEO_MPEG4_B_FRAME_QP (V4L2_CID_CODEC_BASE+402)
735 #define V4L2_CID_MPEG_VIDEO_MPEG4_MIN_QP (V4L2_CID_CODEC_BASE+403)
736 #define V4L2_CID_MPEG_VIDEO_MPEG4_MAX_QP (V4L2_CID_CODEC_BASE+404)
737 #define V4L2_CID_MPEG_VIDEO_MPEG4_LEVEL (V4L2_CID_CODEC_BASE+405)
738 enum v4l2_mpeg_video_mpeg4_level {
739 V4L2_MPEG_VIDEO_MPEG4_LEVEL_0 = 0,
740 V4L2_MPEG_VIDEO_MPEG4_LEVEL_0B = 1,
741 V4L2_MPEG_VIDEO_MPEG4_LEVEL_1 = 2,
742 V4L2_MPEG_VIDEO_MPEG4_LEVEL_2 = 3,
743 V4L2_MPEG_VIDEO_MPEG4_LEVEL_3 = 4,
744 V4L2_MPEG_VIDEO_MPEG4_LEVEL_3B = 5,
745 V4L2_MPEG_VIDEO_MPEG4_LEVEL_4 = 6,
746 V4L2_MPEG_VIDEO_MPEG4_LEVEL_5 = 7,
747 };
748 #define V4L2_CID_MPEG_VIDEO_MPEG4_PROFILE (V4L2_CID_CODEC_BASE+406)
749 enum v4l2_mpeg_video_mpeg4_profile {
750 V4L2_MPEG_VIDEO_MPEG4_PROFILE_SIMPLE = 0,
751 V4L2_MPEG_VIDEO_MPEG4_PROFILE_ADVANCED_SIMPLE = 1,
752 V4L2_MPEG_VIDEO_MPEG4_PROFILE_CORE = 2,
753 V4L2_MPEG_VIDEO_MPEG4_PROFILE_SIMPLE_SCALABLE = 3,
754 V4L2_MPEG_VIDEO_MPEG4_PROFILE_ADVANCED_CODING_EFFICIENCY = 4,
755 };
756 #define V4L2_CID_MPEG_VIDEO_MPEG4_QPEL (V4L2_CID_CODEC_BASE+407)
757
758 /* Control IDs for VP8 streams
759 * Although VP8 is not part of MPEG we add these controls to the MPEG class
760 * as that class is already handling other video compression standards
761 */
762 #define V4L2_CID_MPEG_VIDEO_VPX_NUM_PARTITIONS (V4L2_CID_CODEC_BASE+500)
763 enum v4l2_vp8_num_partitions {
764 V4L2_CID_MPEG_VIDEO_VPX_1_PARTITION = 0,
765 V4L2_CID_MPEG_VIDEO_VPX_2_PARTITIONS = 1,
766 V4L2_CID_MPEG_VIDEO_VPX_4_PARTITIONS = 2,
767 V4L2_CID_MPEG_VIDEO_VPX_8_PARTITIONS = 3,
768 };
769 #define V4L2_CID_MPEG_VIDEO_VPX_IMD_DISABLE_4X4 (V4L2_CID_CODEC_BASE+501)
770 #define V4L2_CID_MPEG_VIDEO_VPX_NUM_REF_FRAMES (V4L2_CID_CODEC_BASE+502)
771 enum v4l2_vp8_num_ref_frames {
772 V4L2_CID_MPEG_VIDEO_VPX_1_REF_FRAME = 0,
773 V4L2_CID_MPEG_VIDEO_VPX_2_REF_FRAME = 1,
774 V4L2_CID_MPEG_VIDEO_VPX_3_REF_FRAME = 2,
775 };
776 #define V4L2_CID_MPEG_VIDEO_VPX_FILTER_LEVEL (V4L2_CID_CODEC_BASE+503)
777 #define V4L2_CID_MPEG_VIDEO_VPX_FILTER_SHARPNESS (V4L2_CID_CODEC_BASE+504)
778 #define V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_REF_PERIOD (V4L2_CID_CODEC_BASE+505)
779 #define V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_SEL (V4L2_CID_CODEC_BASE+506)
780 enum v4l2_vp8_golden_frame_sel {
781 V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_USE_PREV = 0,
782 V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_USE_REF_PERIOD = 1,
783 };
784 #define V4L2_CID_MPEG_VIDEO_VPX_MIN_QP (V4L2_CID_CODEC_BASE+507)
785 #define V4L2_CID_MPEG_VIDEO_VPX_MAX_QP (V4L2_CID_CODEC_BASE+508)
786 #define V4L2_CID_MPEG_VIDEO_VPX_I_FRAME_QP (V4L2_CID_CODEC_BASE+509)
787 #define V4L2_CID_MPEG_VIDEO_VPX_P_FRAME_QP (V4L2_CID_CODEC_BASE+510)
788
789 #define V4L2_CID_MPEG_VIDEO_VP8_PROFILE (V4L2_CID_CODEC_BASE+511)
790 enum v4l2_mpeg_video_vp8_profile {
791 V4L2_MPEG_VIDEO_VP8_PROFILE_0 = 0,
792 V4L2_MPEG_VIDEO_VP8_PROFILE_1 = 1,
793 V4L2_MPEG_VIDEO_VP8_PROFILE_2 = 2,
794 V4L2_MPEG_VIDEO_VP8_PROFILE_3 = 3,
795 };
796 /* Deprecated alias for compatibility reasons. */
797 #define V4L2_CID_MPEG_VIDEO_VPX_PROFILE V4L2_CID_MPEG_VIDEO_VP8_PROFILE
798 #define V4L2_CID_MPEG_VIDEO_VP9_PROFILE (V4L2_CID_CODEC_BASE+512)
799 enum v4l2_mpeg_video_vp9_profile {
800 V4L2_MPEG_VIDEO_VP9_PROFILE_0 = 0,
801 V4L2_MPEG_VIDEO_VP9_PROFILE_1 = 1,
802 V4L2_MPEG_VIDEO_VP9_PROFILE_2 = 2,
803 V4L2_MPEG_VIDEO_VP9_PROFILE_3 = 3,
804 };
805 #define V4L2_CID_MPEG_VIDEO_VP9_LEVEL (V4L2_CID_CODEC_BASE+513)
806 enum v4l2_mpeg_video_vp9_level {
807 V4L2_MPEG_VIDEO_VP9_LEVEL_1_0 = 0,
808 V4L2_MPEG_VIDEO_VP9_LEVEL_1_1 = 1,
809 V4L2_MPEG_VIDEO_VP9_LEVEL_2_0 = 2,
810 V4L2_MPEG_VIDEO_VP9_LEVEL_2_1 = 3,
811 V4L2_MPEG_VIDEO_VP9_LEVEL_3_0 = 4,
812 V4L2_MPEG_VIDEO_VP9_LEVEL_3_1 = 5,
813 V4L2_MPEG_VIDEO_VP9_LEVEL_4_0 = 6,
814 V4L2_MPEG_VIDEO_VP9_LEVEL_4_1 = 7,
815 V4L2_MPEG_VIDEO_VP9_LEVEL_5_0 = 8,
816 V4L2_MPEG_VIDEO_VP9_LEVEL_5_1 = 9,
817 V4L2_MPEG_VIDEO_VP9_LEVEL_5_2 = 10,
818 V4L2_MPEG_VIDEO_VP9_LEVEL_6_0 = 11,
819 V4L2_MPEG_VIDEO_VP9_LEVEL_6_1 = 12,
820 V4L2_MPEG_VIDEO_VP9_LEVEL_6_2 = 13,
821 };
822
823 /* CIDs for HEVC encoding. */
824
825 #define V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP (V4L2_CID_CODEC_BASE + 600)
826 #define V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP (V4L2_CID_CODEC_BASE + 601)
827 #define V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_QP (V4L2_CID_CODEC_BASE + 602)
828 #define V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_QP (V4L2_CID_CODEC_BASE + 603)
829 #define V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_QP (V4L2_CID_CODEC_BASE + 604)
830 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_QP (V4L2_CID_CODEC_BASE + 605)
831 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_TYPE (V4L2_CID_CODEC_BASE + 606)
832 enum v4l2_mpeg_video_hevc_hier_coding_type {
833 V4L2_MPEG_VIDEO_HEVC_HIERARCHICAL_CODING_B = 0,
834 V4L2_MPEG_VIDEO_HEVC_HIERARCHICAL_CODING_P = 1,
835 };
836 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_LAYER (V4L2_CID_CODEC_BASE + 607)
837 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L0_QP (V4L2_CID_CODEC_BASE + 608)
838 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L1_QP (V4L2_CID_CODEC_BASE + 609)
839 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L2_QP (V4L2_CID_CODEC_BASE + 610)
840 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L3_QP (V4L2_CID_CODEC_BASE + 611)
841 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L4_QP (V4L2_CID_CODEC_BASE + 612)
842 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L5_QP (V4L2_CID_CODEC_BASE + 613)
843 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L6_QP (V4L2_CID_CODEC_BASE + 614)
844 #define V4L2_CID_MPEG_VIDEO_HEVC_PROFILE (V4L2_CID_CODEC_BASE + 615)
845 enum v4l2_mpeg_video_hevc_profile {
846 V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN = 0,
847 V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN_STILL_PICTURE = 1,
848 V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN_10 = 2,
849 };
850 #define V4L2_CID_MPEG_VIDEO_HEVC_LEVEL (V4L2_CID_CODEC_BASE + 616)
851 enum v4l2_mpeg_video_hevc_level {
852 V4L2_MPEG_VIDEO_HEVC_LEVEL_1 = 0,
853 V4L2_MPEG_VIDEO_HEVC_LEVEL_2 = 1,
854 V4L2_MPEG_VIDEO_HEVC_LEVEL_2_1 = 2,
855 V4L2_MPEG_VIDEO_HEVC_LEVEL_3 = 3,
856 V4L2_MPEG_VIDEO_HEVC_LEVEL_3_1 = 4,
857 V4L2_MPEG_VIDEO_HEVC_LEVEL_4 = 5,
858 V4L2_MPEG_VIDEO_HEVC_LEVEL_4_1 = 6,
859 V4L2_MPEG_VIDEO_HEVC_LEVEL_5 = 7,
860 V4L2_MPEG_VIDEO_HEVC_LEVEL_5_1 = 8,
861 V4L2_MPEG_VIDEO_HEVC_LEVEL_5_2 = 9,
862 V4L2_MPEG_VIDEO_HEVC_LEVEL_6 = 10,
863 V4L2_MPEG_VIDEO_HEVC_LEVEL_6_1 = 11,
864 V4L2_MPEG_VIDEO_HEVC_LEVEL_6_2 = 12,
865 };
866 #define V4L2_CID_MPEG_VIDEO_HEVC_FRAME_RATE_RESOLUTION (V4L2_CID_CODEC_BASE + 617)
867 #define V4L2_CID_MPEG_VIDEO_HEVC_TIER (V4L2_CID_CODEC_BASE + 618)
868 enum v4l2_mpeg_video_hevc_tier {
869 V4L2_MPEG_VIDEO_HEVC_TIER_MAIN = 0,
870 V4L2_MPEG_VIDEO_HEVC_TIER_HIGH = 1,
871 };
872 #define V4L2_CID_MPEG_VIDEO_HEVC_MAX_PARTITION_DEPTH (V4L2_CID_CODEC_BASE + 619)
873 #define V4L2_CID_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE (V4L2_CID_CODEC_BASE + 620)
874 enum v4l2_cid_mpeg_video_hevc_loop_filter_mode {
875 V4L2_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE_DISABLED = 0,
876 V4L2_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE_ENABLED = 1,
877 V4L2_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE_DISABLED_AT_SLICE_BOUNDARY = 2,
878 };
879 #define V4L2_CID_MPEG_VIDEO_HEVC_LF_BETA_OFFSET_DIV2 (V4L2_CID_CODEC_BASE + 621)
880 #define V4L2_CID_MPEG_VIDEO_HEVC_LF_TC_OFFSET_DIV2 (V4L2_CID_CODEC_BASE + 622)
881 #define V4L2_CID_MPEG_VIDEO_HEVC_REFRESH_TYPE (V4L2_CID_CODEC_BASE + 623)
882 enum v4l2_cid_mpeg_video_hevc_refresh_type {
883 V4L2_MPEG_VIDEO_HEVC_REFRESH_NONE = 0,
884 V4L2_MPEG_VIDEO_HEVC_REFRESH_CRA = 1,
885 V4L2_MPEG_VIDEO_HEVC_REFRESH_IDR = 2,
886 };
887 #define V4L2_CID_MPEG_VIDEO_HEVC_REFRESH_PERIOD (V4L2_CID_CODEC_BASE + 624)
888 #define V4L2_CID_MPEG_VIDEO_HEVC_LOSSLESS_CU (V4L2_CID_CODEC_BASE + 625)
889 #define V4L2_CID_MPEG_VIDEO_HEVC_CONST_INTRA_PRED (V4L2_CID_CODEC_BASE + 626)
890 #define V4L2_CID_MPEG_VIDEO_HEVC_WAVEFRONT (V4L2_CID_CODEC_BASE + 627)
891 #define V4L2_CID_MPEG_VIDEO_HEVC_GENERAL_PB (V4L2_CID_CODEC_BASE + 628)
892 #define V4L2_CID_MPEG_VIDEO_HEVC_TEMPORAL_ID (V4L2_CID_CODEC_BASE + 629)
893 #define V4L2_CID_MPEG_VIDEO_HEVC_STRONG_SMOOTHING (V4L2_CID_CODEC_BASE + 630)
894 #define V4L2_CID_MPEG_VIDEO_HEVC_MAX_NUM_MERGE_MV_MINUS1 (V4L2_CID_CODEC_BASE + 631)
895 #define V4L2_CID_MPEG_VIDEO_HEVC_INTRA_PU_SPLIT (V4L2_CID_CODEC_BASE + 632)
896 #define V4L2_CID_MPEG_VIDEO_HEVC_TMV_PREDICTION (V4L2_CID_CODEC_BASE + 633)
897 #define V4L2_CID_MPEG_VIDEO_HEVC_WITHOUT_STARTCODE (V4L2_CID_CODEC_BASE + 634)
898 #define V4L2_CID_MPEG_VIDEO_HEVC_SIZE_OF_LENGTH_FIELD (V4L2_CID_CODEC_BASE + 635)
899 enum v4l2_cid_mpeg_video_hevc_size_of_length_field {
900 V4L2_MPEG_VIDEO_HEVC_SIZE_0 = 0,
901 V4L2_MPEG_VIDEO_HEVC_SIZE_1 = 1,
902 V4L2_MPEG_VIDEO_HEVC_SIZE_2 = 2,
903 V4L2_MPEG_VIDEO_HEVC_SIZE_4 = 3,
904 };
905 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L0_BR (V4L2_CID_CODEC_BASE + 636)
906 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L1_BR (V4L2_CID_CODEC_BASE + 637)
907 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L2_BR (V4L2_CID_CODEC_BASE + 638)
908 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L3_BR (V4L2_CID_CODEC_BASE + 639)
909 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L4_BR (V4L2_CID_CODEC_BASE + 640)
910 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L5_BR (V4L2_CID_CODEC_BASE + 641)
911 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L6_BR (V4L2_CID_CODEC_BASE + 642)
912 #define V4L2_CID_MPEG_VIDEO_REF_NUMBER_FOR_PFRAMES (V4L2_CID_CODEC_BASE + 643)
913 #define V4L2_CID_MPEG_VIDEO_PREPEND_SPSPPS_TO_IDR (V4L2_CID_CODEC_BASE + 644)
914 #define V4L2_CID_MPEG_VIDEO_CONSTANT_QUALITY (V4L2_CID_CODEC_BASE + 645)
915 #define V4L2_CID_MPEG_VIDEO_FRAME_SKIP_MODE (V4L2_CID_CODEC_BASE + 646)
916 enum v4l2_mpeg_video_frame_skip_mode {
917 V4L2_MPEG_VIDEO_FRAME_SKIP_MODE_DISABLED = 0,
918 V4L2_MPEG_VIDEO_FRAME_SKIP_MODE_LEVEL_LIMIT = 1,
919 V4L2_MPEG_VIDEO_FRAME_SKIP_MODE_BUF_LIMIT = 2,
920 };
921
922 #define V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_MIN_QP (V4L2_CID_CODEC_BASE + 647)
923 #define V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_MAX_QP (V4L2_CID_CODEC_BASE + 648)
924 #define V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_MIN_QP (V4L2_CID_CODEC_BASE + 649)
925 #define V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_MAX_QP (V4L2_CID_CODEC_BASE + 650)
926 #define V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_MIN_QP (V4L2_CID_CODEC_BASE + 651)
927 #define V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_MAX_QP (V4L2_CID_CODEC_BASE + 652)
928
929 #define V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY (V4L2_CID_CODEC_BASE + 653)
930 #define V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY_ENABLE (V4L2_CID_CODEC_BASE + 654)
931
932 #define V4L2_CID_MPEG_VIDEO_AV1_PROFILE (V4L2_CID_CODEC_BASE + 655)
933 /**
934 * enum v4l2_mpeg_video_av1_profile - AV1 profiles
935 *
936 * @V4L2_MPEG_VIDEO_AV1_PROFILE_MAIN: compliant decoders must be able to decode
937 * streams with seq_profile equal to 0.
938 * @V4L2_MPEG_VIDEO_AV1_PROFILE_HIGH: compliant decoders must be able to decode
939 * streams with seq_profile equal less than or equal to 1.
940 * @V4L2_MPEG_VIDEO_AV1_PROFILE_PROFESSIONAL: compliant decoders must be able to
941 * decode streams with seq_profile less than or equal to 2.
942 *
943 * Conveys the highest profile a decoder can work with.
944 */
945 enum v4l2_mpeg_video_av1_profile {
946 V4L2_MPEG_VIDEO_AV1_PROFILE_MAIN = 0,
947 V4L2_MPEG_VIDEO_AV1_PROFILE_HIGH = 1,
948 V4L2_MPEG_VIDEO_AV1_PROFILE_PROFESSIONAL = 2,
949 };
950
951 #define V4L2_CID_MPEG_VIDEO_AV1_LEVEL (V4L2_CID_CODEC_BASE + 656)
952 /**
953 * enum v4l2_mpeg_video_av1_level - AV1 levels
954 *
955 * @V4L2_MPEG_VIDEO_AV1_LEVEL_2_0: Level 2.0.
956 * @V4L2_MPEG_VIDEO_AV1_LEVEL_2_1: Level 2.1.
957 * @V4L2_MPEG_VIDEO_AV1_LEVEL_2_2: Level 2.2.
958 * @V4L2_MPEG_VIDEO_AV1_LEVEL_2_3: Level 2.3.
959 * @V4L2_MPEG_VIDEO_AV1_LEVEL_3_0: Level 3.0.
960 * @V4L2_MPEG_VIDEO_AV1_LEVEL_3_1: Level 3.1.
961 * @V4L2_MPEG_VIDEO_AV1_LEVEL_3_2: Level 3.2.
962 * @V4L2_MPEG_VIDEO_AV1_LEVEL_3_3: Level 3.3.
963 * @V4L2_MPEG_VIDEO_AV1_LEVEL_4_0: Level 4.0.
964 * @V4L2_MPEG_VIDEO_AV1_LEVEL_4_1: Level 4.1.
965 * @V4L2_MPEG_VIDEO_AV1_LEVEL_4_2: Level 4.2.
966 * @V4L2_MPEG_VIDEO_AV1_LEVEL_4_3: Level 4.3.
967 * @V4L2_MPEG_VIDEO_AV1_LEVEL_5_0: Level 5.0.
968 * @V4L2_MPEG_VIDEO_AV1_LEVEL_5_1: Level 5.1.
969 * @V4L2_MPEG_VIDEO_AV1_LEVEL_5_2: Level 5.2.
970 * @V4L2_MPEG_VIDEO_AV1_LEVEL_5_3: Level 5.3.
971 * @V4L2_MPEG_VIDEO_AV1_LEVEL_6_0: Level 6.0.
972 * @V4L2_MPEG_VIDEO_AV1_LEVEL_6_1: Level 6.1.
973 * @V4L2_MPEG_VIDEO_AV1_LEVEL_6_2: Level 6.2.
974 * @V4L2_MPEG_VIDEO_AV1_LEVEL_6_3: Level 6.3.
975 * @V4L2_MPEG_VIDEO_AV1_LEVEL_7_0: Level 7.0.
976 * @V4L2_MPEG_VIDEO_AV1_LEVEL_7_1: Level 7.1.
977 * @V4L2_MPEG_VIDEO_AV1_LEVEL_7_2: Level 7.2.
978 * @V4L2_MPEG_VIDEO_AV1_LEVEL_7_3: Level 7.3.
979 *
980 * Conveys the highest level a decoder can work with.
981 */
982 enum v4l2_mpeg_video_av1_level {
983 V4L2_MPEG_VIDEO_AV1_LEVEL_2_0 = 0,
984 V4L2_MPEG_VIDEO_AV1_LEVEL_2_1 = 1,
985 V4L2_MPEG_VIDEO_AV1_LEVEL_2_2 = 2,
986 V4L2_MPEG_VIDEO_AV1_LEVEL_2_3 = 3,
987
988 V4L2_MPEG_VIDEO_AV1_LEVEL_3_0 = 4,
989 V4L2_MPEG_VIDEO_AV1_LEVEL_3_1 = 5,
990 V4L2_MPEG_VIDEO_AV1_LEVEL_3_2 = 6,
991 V4L2_MPEG_VIDEO_AV1_LEVEL_3_3 = 7,
992
993 V4L2_MPEG_VIDEO_AV1_LEVEL_4_0 = 8,
994 V4L2_MPEG_VIDEO_AV1_LEVEL_4_1 = 9,
995 V4L2_MPEG_VIDEO_AV1_LEVEL_4_2 = 10,
996 V4L2_MPEG_VIDEO_AV1_LEVEL_4_3 = 11,
997
998 V4L2_MPEG_VIDEO_AV1_LEVEL_5_0 = 12,
999 V4L2_MPEG_VIDEO_AV1_LEVEL_5_1 = 13,
1000 V4L2_MPEG_VIDEO_AV1_LEVEL_5_2 = 14,
1001 V4L2_MPEG_VIDEO_AV1_LEVEL_5_3 = 15,
1002
1003 V4L2_MPEG_VIDEO_AV1_LEVEL_6_0 = 16,
1004 V4L2_MPEG_VIDEO_AV1_LEVEL_6_1 = 17,
1005 V4L2_MPEG_VIDEO_AV1_LEVEL_6_2 = 18,
1006 V4L2_MPEG_VIDEO_AV1_LEVEL_6_3 = 19,
1007
1008 V4L2_MPEG_VIDEO_AV1_LEVEL_7_0 = 20,
1009 V4L2_MPEG_VIDEO_AV1_LEVEL_7_1 = 21,
1010 V4L2_MPEG_VIDEO_AV1_LEVEL_7_2 = 22,
1011 V4L2_MPEG_VIDEO_AV1_LEVEL_7_3 = 23
1012 };
1013
1014 #define V4L2_CID_MPEG_VIDEO_AVERAGE_QP (V4L2_CID_CODEC_BASE + 657)
1015
1016 /* MPEG-class control IDs specific to the CX2341x driver as defined by V4L2 */
1017 #define V4L2_CID_CODEC_CX2341X_BASE (V4L2_CTRL_CLASS_CODEC | 0x1000)
1018 #define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE (V4L2_CID_CODEC_CX2341X_BASE+0)
1019 enum v4l2_mpeg_cx2341x_video_spatial_filter_mode {
1020 V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_MANUAL = 0,
1021 V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_AUTO = 1,
1022 };
1023 #define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER (V4L2_CID_CODEC_CX2341X_BASE+1)
1024 #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE (V4L2_CID_CODEC_CX2341X_BASE+2)
1025 enum v4l2_mpeg_cx2341x_video_luma_spatial_filter_type {
1026 V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_OFF = 0,
1027 V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_HOR = 1,
1028 V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_VERT = 2,
1029 V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_HV_SEPARABLE = 3,
1030 V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_SYM_NON_SEPARABLE = 4,
1031 };
1032 #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE (V4L2_CID_CODEC_CX2341X_BASE+3)
1033 enum v4l2_mpeg_cx2341x_video_chroma_spatial_filter_type {
1034 V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_OFF = 0,
1035 V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_1D_HOR = 1,
1036 };
1037 #define V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE (V4L2_CID_CODEC_CX2341X_BASE+4)
1038 enum v4l2_mpeg_cx2341x_video_temporal_filter_mode {
1039 V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_MANUAL = 0,
1040 V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_AUTO = 1,
1041 };
1042 #define V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER (V4L2_CID_CODEC_CX2341X_BASE+5)
1043 #define V4L2_CID_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE (V4L2_CID_CODEC_CX2341X_BASE+6)
1044 enum v4l2_mpeg_cx2341x_video_median_filter_type {
1045 V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_OFF = 0,
1046 V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR = 1,
1047 V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_VERT = 2,
1048 V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR_VERT = 3,
1049 V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_DIAG = 4,
1050 };
1051 #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_BOTTOM (V4L2_CID_CODEC_CX2341X_BASE+7)
1052 #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_TOP (V4L2_CID_CODEC_CX2341X_BASE+8)
1053 #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_BOTTOM (V4L2_CID_CODEC_CX2341X_BASE+9)
1054 #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_TOP (V4L2_CID_CODEC_CX2341X_BASE+10)
1055 #define V4L2_CID_MPEG_CX2341X_STREAM_INSERT_NAV_PACKETS (V4L2_CID_CODEC_CX2341X_BASE+11)
1056
1057 /* MPEG-class control IDs specific to the Samsung MFC 5.1 driver as defined by V4L2 */
1058 #define V4L2_CID_CODEC_MFC51_BASE (V4L2_CTRL_CLASS_CODEC | 0x1100)
1059
1060 #define V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY (V4L2_CID_CODEC_MFC51_BASE+0)
1061 #define V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY_ENABLE (V4L2_CID_CODEC_MFC51_BASE+1)
1062 #define V4L2_CID_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE (V4L2_CID_CODEC_MFC51_BASE+2)
1063 enum v4l2_mpeg_mfc51_video_frame_skip_mode {
1064 V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_DISABLED = 0,
1065 V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_LEVEL_LIMIT = 1,
1066 V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_BUF_LIMIT = 2,
1067 };
1068 #define V4L2_CID_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE (V4L2_CID_CODEC_MFC51_BASE+3)
1069 enum v4l2_mpeg_mfc51_video_force_frame_type {
1070 V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_DISABLED = 0,
1071 V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_I_FRAME = 1,
1072 V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_NOT_CODED = 2,
1073 };
1074 #define V4L2_CID_MPEG_MFC51_VIDEO_PADDING (V4L2_CID_CODEC_MFC51_BASE+4)
1075 #define V4L2_CID_MPEG_MFC51_VIDEO_PADDING_YUV (V4L2_CID_CODEC_MFC51_BASE+5)
1076 #define V4L2_CID_MPEG_MFC51_VIDEO_RC_FIXED_TARGET_BIT (V4L2_CID_CODEC_MFC51_BASE+6)
1077 #define V4L2_CID_MPEG_MFC51_VIDEO_RC_REACTION_COEFF (V4L2_CID_CODEC_MFC51_BASE+7)
1078 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_ACTIVITY (V4L2_CID_CODEC_MFC51_BASE+50)
1079 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_DARK (V4L2_CID_CODEC_MFC51_BASE+51)
1080 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_SMOOTH (V4L2_CID_CODEC_MFC51_BASE+52)
1081 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_STATIC (V4L2_CID_CODEC_MFC51_BASE+53)
1082 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_NUM_REF_PIC_FOR_P (V4L2_CID_CODEC_MFC51_BASE+54)
1083
1084 /* Camera class control IDs */
1085
1086 #define V4L2_CID_CAMERA_CLASS_BASE (V4L2_CTRL_CLASS_CAMERA | 0x900)
1087 #define V4L2_CID_CAMERA_CLASS (V4L2_CTRL_CLASS_CAMERA | 1)
1088
1089 #define V4L2_CID_EXPOSURE_AUTO (V4L2_CID_CAMERA_CLASS_BASE+1)
1090 enum v4l2_exposure_auto_type {
1091 V4L2_EXPOSURE_AUTO = 0,
1092 V4L2_EXPOSURE_MANUAL = 1,
1093 V4L2_EXPOSURE_SHUTTER_PRIORITY = 2,
1094 V4L2_EXPOSURE_APERTURE_PRIORITY = 3
1095 };
1096 #define V4L2_CID_EXPOSURE_ABSOLUTE (V4L2_CID_CAMERA_CLASS_BASE+2)
1097 #define V4L2_CID_EXPOSURE_AUTO_PRIORITY (V4L2_CID_CAMERA_CLASS_BASE+3)
1098
1099 #define V4L2_CID_PAN_RELATIVE (V4L2_CID_CAMERA_CLASS_BASE+4)
1100 #define V4L2_CID_TILT_RELATIVE (V4L2_CID_CAMERA_CLASS_BASE+5)
1101 #define V4L2_CID_PAN_RESET (V4L2_CID_CAMERA_CLASS_BASE+6)
1102 #define V4L2_CID_TILT_RESET (V4L2_CID_CAMERA_CLASS_BASE+7)
1103
1104 #define V4L2_CID_PAN_ABSOLUTE (V4L2_CID_CAMERA_CLASS_BASE+8)
1105 #define V4L2_CID_TILT_ABSOLUTE (V4L2_CID_CAMERA_CLASS_BASE+9)
1106
1107 #define V4L2_CID_FOCUS_ABSOLUTE (V4L2_CID_CAMERA_CLASS_BASE+10)
1108 #define V4L2_CID_FOCUS_RELATIVE (V4L2_CID_CAMERA_CLASS_BASE+11)
1109 #define V4L2_CID_FOCUS_AUTO (V4L2_CID_CAMERA_CLASS_BASE+12)
1110
1111 #define V4L2_CID_ZOOM_ABSOLUTE (V4L2_CID_CAMERA_CLASS_BASE+13)
1112 #define V4L2_CID_ZOOM_RELATIVE (V4L2_CID_CAMERA_CLASS_BASE+14)
1113 #define V4L2_CID_ZOOM_CONTINUOUS (V4L2_CID_CAMERA_CLASS_BASE+15)
1114
1115 #define V4L2_CID_PRIVACY (V4L2_CID_CAMERA_CLASS_BASE+16)
1116
1117 #define V4L2_CID_IRIS_ABSOLUTE (V4L2_CID_CAMERA_CLASS_BASE+17)
1118 #define V4L2_CID_IRIS_RELATIVE (V4L2_CID_CAMERA_CLASS_BASE+18)
1119
1120 #define V4L2_CID_AUTO_EXPOSURE_BIAS (V4L2_CID_CAMERA_CLASS_BASE+19)
1121
1122 #define V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE (V4L2_CID_CAMERA_CLASS_BASE+20)
1123 enum v4l2_auto_n_preset_white_balance {
1124 V4L2_WHITE_BALANCE_MANUAL = 0,
1125 V4L2_WHITE_BALANCE_AUTO = 1,
1126 V4L2_WHITE_BALANCE_INCANDESCENT = 2,
1127 V4L2_WHITE_BALANCE_FLUORESCENT = 3,
1128 V4L2_WHITE_BALANCE_FLUORESCENT_H = 4,
1129 V4L2_WHITE_BALANCE_HORIZON = 5,
1130 V4L2_WHITE_BALANCE_DAYLIGHT = 6,
1131 V4L2_WHITE_BALANCE_FLASH = 7,
1132 V4L2_WHITE_BALANCE_CLOUDY = 8,
1133 V4L2_WHITE_BALANCE_SHADE = 9,
1134 };
1135
1136 #define V4L2_CID_WIDE_DYNAMIC_RANGE (V4L2_CID_CAMERA_CLASS_BASE+21)
1137 #define V4L2_CID_IMAGE_STABILIZATION (V4L2_CID_CAMERA_CLASS_BASE+22)
1138
1139 #define V4L2_CID_ISO_SENSITIVITY (V4L2_CID_CAMERA_CLASS_BASE+23)
1140 #define V4L2_CID_ISO_SENSITIVITY_AUTO (V4L2_CID_CAMERA_CLASS_BASE+24)
1141 enum v4l2_iso_sensitivity_auto_type {
1142 V4L2_ISO_SENSITIVITY_MANUAL = 0,
1143 V4L2_ISO_SENSITIVITY_AUTO = 1,
1144 };
1145
1146 #define V4L2_CID_EXPOSURE_METERING (V4L2_CID_CAMERA_CLASS_BASE+25)
1147 enum v4l2_exposure_metering {
1148 V4L2_EXPOSURE_METERING_AVERAGE = 0,
1149 V4L2_EXPOSURE_METERING_CENTER_WEIGHTED = 1,
1150 V4L2_EXPOSURE_METERING_SPOT = 2,
1151 V4L2_EXPOSURE_METERING_MATRIX = 3,
1152 };
1153
1154 #define V4L2_CID_SCENE_MODE (V4L2_CID_CAMERA_CLASS_BASE+26)
1155 enum v4l2_scene_mode {
1156 V4L2_SCENE_MODE_NONE = 0,
1157 V4L2_SCENE_MODE_BACKLIGHT = 1,
1158 V4L2_SCENE_MODE_BEACH_SNOW = 2,
1159 V4L2_SCENE_MODE_CANDLE_LIGHT = 3,
1160 V4L2_SCENE_MODE_DAWN_DUSK = 4,
1161 V4L2_SCENE_MODE_FALL_COLORS = 5,
1162 V4L2_SCENE_MODE_FIREWORKS = 6,
1163 V4L2_SCENE_MODE_LANDSCAPE = 7,
1164 V4L2_SCENE_MODE_NIGHT = 8,
1165 V4L2_SCENE_MODE_PARTY_INDOOR = 9,
1166 V4L2_SCENE_MODE_PORTRAIT = 10,
1167 V4L2_SCENE_MODE_SPORTS = 11,
1168 V4L2_SCENE_MODE_SUNSET = 12,
1169 V4L2_SCENE_MODE_TEXT = 13,
1170 };
1171
1172 #define V4L2_CID_3A_LOCK (V4L2_CID_CAMERA_CLASS_BASE+27)
1173 #define V4L2_LOCK_EXPOSURE (1 << 0)
1174 #define V4L2_LOCK_WHITE_BALANCE (1 << 1)
1175 #define V4L2_LOCK_FOCUS (1 << 2)
1176
1177 #define V4L2_CID_AUTO_FOCUS_START (V4L2_CID_CAMERA_CLASS_BASE+28)
1178 #define V4L2_CID_AUTO_FOCUS_STOP (V4L2_CID_CAMERA_CLASS_BASE+29)
1179 #define V4L2_CID_AUTO_FOCUS_STATUS (V4L2_CID_CAMERA_CLASS_BASE+30)
1180 #define V4L2_AUTO_FOCUS_STATUS_IDLE (0 << 0)
1181 #define V4L2_AUTO_FOCUS_STATUS_BUSY (1 << 0)
1182 #define V4L2_AUTO_FOCUS_STATUS_REACHED (1 << 1)
1183 #define V4L2_AUTO_FOCUS_STATUS_FAILED (1 << 2)
1184
1185 #define V4L2_CID_AUTO_FOCUS_RANGE (V4L2_CID_CAMERA_CLASS_BASE+31)
1186 enum v4l2_auto_focus_range {
1187 V4L2_AUTO_FOCUS_RANGE_AUTO = 0,
1188 V4L2_AUTO_FOCUS_RANGE_NORMAL = 1,
1189 V4L2_AUTO_FOCUS_RANGE_MACRO = 2,
1190 V4L2_AUTO_FOCUS_RANGE_INFINITY = 3,
1191 };
1192
1193 #define V4L2_CID_PAN_SPEED (V4L2_CID_CAMERA_CLASS_BASE+32)
1194 #define V4L2_CID_TILT_SPEED (V4L2_CID_CAMERA_CLASS_BASE+33)
1195
1196 #define V4L2_CID_CAMERA_ORIENTATION (V4L2_CID_CAMERA_CLASS_BASE+34)
1197 #define V4L2_CAMERA_ORIENTATION_FRONT 0
1198 #define V4L2_CAMERA_ORIENTATION_BACK 1
1199 #define V4L2_CAMERA_ORIENTATION_EXTERNAL 2
1200
1201 #define V4L2_CID_CAMERA_SENSOR_ROTATION (V4L2_CID_CAMERA_CLASS_BASE+35)
1202
1203 #define V4L2_CID_HDR_SENSOR_MODE (V4L2_CID_CAMERA_CLASS_BASE+36)
1204
1205 /* FM Modulator class control IDs */
1206
1207 #define V4L2_CID_FM_TX_CLASS_BASE (V4L2_CTRL_CLASS_FM_TX | 0x900)
1208 #define V4L2_CID_FM_TX_CLASS (V4L2_CTRL_CLASS_FM_TX | 1)
1209
1210 #define V4L2_CID_RDS_TX_DEVIATION (V4L2_CID_FM_TX_CLASS_BASE + 1)
1211 #define V4L2_CID_RDS_TX_PI (V4L2_CID_FM_TX_CLASS_BASE + 2)
1212 #define V4L2_CID_RDS_TX_PTY (V4L2_CID_FM_TX_CLASS_BASE + 3)
1213 #define V4L2_CID_RDS_TX_PS_NAME (V4L2_CID_FM_TX_CLASS_BASE + 5)
1214 #define V4L2_CID_RDS_TX_RADIO_TEXT (V4L2_CID_FM_TX_CLASS_BASE + 6)
1215 #define V4L2_CID_RDS_TX_MONO_STEREO (V4L2_CID_FM_TX_CLASS_BASE + 7)
1216 #define V4L2_CID_RDS_TX_ARTIFICIAL_HEAD (V4L2_CID_FM_TX_CLASS_BASE + 8)
1217 #define V4L2_CID_RDS_TX_COMPRESSED (V4L2_CID_FM_TX_CLASS_BASE + 9)
1218 #define V4L2_CID_RDS_TX_DYNAMIC_PTY (V4L2_CID_FM_TX_CLASS_BASE + 10)
1219 #define V4L2_CID_RDS_TX_TRAFFIC_ANNOUNCEMENT (V4L2_CID_FM_TX_CLASS_BASE + 11)
1220 #define V4L2_CID_RDS_TX_TRAFFIC_PROGRAM (V4L2_CID_FM_TX_CLASS_BASE + 12)
1221 #define V4L2_CID_RDS_TX_MUSIC_SPEECH (V4L2_CID_FM_TX_CLASS_BASE + 13)
1222 #define V4L2_CID_RDS_TX_ALT_FREQS_ENABLE (V4L2_CID_FM_TX_CLASS_BASE + 14)
1223 #define V4L2_CID_RDS_TX_ALT_FREQS (V4L2_CID_FM_TX_CLASS_BASE + 15)
1224
1225 #define V4L2_CID_AUDIO_LIMITER_ENABLED (V4L2_CID_FM_TX_CLASS_BASE + 64)
1226 #define V4L2_CID_AUDIO_LIMITER_RELEASE_TIME (V4L2_CID_FM_TX_CLASS_BASE + 65)
1227 #define V4L2_CID_AUDIO_LIMITER_DEVIATION (V4L2_CID_FM_TX_CLASS_BASE + 66)
1228
1229 #define V4L2_CID_AUDIO_COMPRESSION_ENABLED (V4L2_CID_FM_TX_CLASS_BASE + 80)
1230 #define V4L2_CID_AUDIO_COMPRESSION_GAIN (V4L2_CID_FM_TX_CLASS_BASE + 81)
1231 #define V4L2_CID_AUDIO_COMPRESSION_THRESHOLD (V4L2_CID_FM_TX_CLASS_BASE + 82)
1232 #define V4L2_CID_AUDIO_COMPRESSION_ATTACK_TIME (V4L2_CID_FM_TX_CLASS_BASE + 83)
1233 #define V4L2_CID_AUDIO_COMPRESSION_RELEASE_TIME (V4L2_CID_FM_TX_CLASS_BASE + 84)
1234
1235 #define V4L2_CID_PILOT_TONE_ENABLED (V4L2_CID_FM_TX_CLASS_BASE + 96)
1236 #define V4L2_CID_PILOT_TONE_DEVIATION (V4L2_CID_FM_TX_CLASS_BASE + 97)
1237 #define V4L2_CID_PILOT_TONE_FREQUENCY (V4L2_CID_FM_TX_CLASS_BASE + 98)
1238
1239 #define V4L2_CID_TUNE_PREEMPHASIS (V4L2_CID_FM_TX_CLASS_BASE + 112)
1240 enum v4l2_preemphasis {
1241 V4L2_PREEMPHASIS_DISABLED = 0,
1242 V4L2_PREEMPHASIS_50_uS = 1,
1243 V4L2_PREEMPHASIS_75_uS = 2,
1244 };
1245 #define V4L2_CID_TUNE_POWER_LEVEL (V4L2_CID_FM_TX_CLASS_BASE + 113)
1246 #define V4L2_CID_TUNE_ANTENNA_CAPACITOR (V4L2_CID_FM_TX_CLASS_BASE + 114)
1247
1248
1249 /* Flash and privacy (indicator) light controls */
1250
1251 #define V4L2_CID_FLASH_CLASS_BASE (V4L2_CTRL_CLASS_FLASH | 0x900)
1252 #define V4L2_CID_FLASH_CLASS (V4L2_CTRL_CLASS_FLASH | 1)
1253
1254 #define V4L2_CID_FLASH_LED_MODE (V4L2_CID_FLASH_CLASS_BASE + 1)
1255 enum v4l2_flash_led_mode {
1256 V4L2_FLASH_LED_MODE_NONE,
1257 V4L2_FLASH_LED_MODE_FLASH,
1258 V4L2_FLASH_LED_MODE_TORCH,
1259 };
1260
1261 #define V4L2_CID_FLASH_STROBE_SOURCE (V4L2_CID_FLASH_CLASS_BASE + 2)
1262 enum v4l2_flash_strobe_source {
1263 V4L2_FLASH_STROBE_SOURCE_SOFTWARE,
1264 V4L2_FLASH_STROBE_SOURCE_EXTERNAL,
1265 };
1266
1267 #define V4L2_CID_FLASH_STROBE (V4L2_CID_FLASH_CLASS_BASE + 3)
1268 #define V4L2_CID_FLASH_STROBE_STOP (V4L2_CID_FLASH_CLASS_BASE + 4)
1269 #define V4L2_CID_FLASH_STROBE_STATUS (V4L2_CID_FLASH_CLASS_BASE + 5)
1270
1271 #define V4L2_CID_FLASH_TIMEOUT (V4L2_CID_FLASH_CLASS_BASE + 6)
1272 #define V4L2_CID_FLASH_INTENSITY (V4L2_CID_FLASH_CLASS_BASE + 7)
1273 #define V4L2_CID_FLASH_TORCH_INTENSITY (V4L2_CID_FLASH_CLASS_BASE + 8)
1274 #define V4L2_CID_FLASH_INDICATOR_INTENSITY (V4L2_CID_FLASH_CLASS_BASE + 9)
1275
1276 #define V4L2_CID_FLASH_FAULT (V4L2_CID_FLASH_CLASS_BASE + 10)
1277 #define V4L2_FLASH_FAULT_OVER_VOLTAGE (1 << 0)
1278 #define V4L2_FLASH_FAULT_TIMEOUT (1 << 1)
1279 #define V4L2_FLASH_FAULT_OVER_TEMPERATURE (1 << 2)
1280 #define V4L2_FLASH_FAULT_SHORT_CIRCUIT (1 << 3)
1281 #define V4L2_FLASH_FAULT_OVER_CURRENT (1 << 4)
1282 #define V4L2_FLASH_FAULT_INDICATOR (1 << 5)
1283 #define V4L2_FLASH_FAULT_UNDER_VOLTAGE (1 << 6)
1284 #define V4L2_FLASH_FAULT_INPUT_VOLTAGE (1 << 7)
1285 #define V4L2_FLASH_FAULT_LED_OVER_TEMPERATURE (1 << 8)
1286
1287 #define V4L2_CID_FLASH_CHARGE (V4L2_CID_FLASH_CLASS_BASE + 11)
1288 #define V4L2_CID_FLASH_READY (V4L2_CID_FLASH_CLASS_BASE + 12)
1289
1290
1291 /* JPEG-class control IDs */
1292
1293 #define V4L2_CID_JPEG_CLASS_BASE (V4L2_CTRL_CLASS_JPEG | 0x900)
1294 #define V4L2_CID_JPEG_CLASS (V4L2_CTRL_CLASS_JPEG | 1)
1295
1296 #define V4L2_CID_JPEG_CHROMA_SUBSAMPLING (V4L2_CID_JPEG_CLASS_BASE + 1)
1297 enum v4l2_jpeg_chroma_subsampling {
1298 V4L2_JPEG_CHROMA_SUBSAMPLING_444 = 0,
1299 V4L2_JPEG_CHROMA_SUBSAMPLING_422 = 1,
1300 V4L2_JPEG_CHROMA_SUBSAMPLING_420 = 2,
1301 V4L2_JPEG_CHROMA_SUBSAMPLING_411 = 3,
1302 V4L2_JPEG_CHROMA_SUBSAMPLING_410 = 4,
1303 V4L2_JPEG_CHROMA_SUBSAMPLING_GRAY = 5,
1304 };
1305 #define V4L2_CID_JPEG_RESTART_INTERVAL (V4L2_CID_JPEG_CLASS_BASE + 2)
1306 #define V4L2_CID_JPEG_COMPRESSION_QUALITY (V4L2_CID_JPEG_CLASS_BASE + 3)
1307
1308 #define V4L2_CID_JPEG_ACTIVE_MARKER (V4L2_CID_JPEG_CLASS_BASE + 4)
1309 #define V4L2_JPEG_ACTIVE_MARKER_APP0 (1 << 0)
1310 #define V4L2_JPEG_ACTIVE_MARKER_APP1 (1 << 1)
1311 #define V4L2_JPEG_ACTIVE_MARKER_COM (1 << 16)
1312 #define V4L2_JPEG_ACTIVE_MARKER_DQT (1 << 17)
1313 #define V4L2_JPEG_ACTIVE_MARKER_DHT (1 << 18)
1314
1315
1316 /* Image source controls */
1317 #define V4L2_CID_IMAGE_SOURCE_CLASS_BASE (V4L2_CTRL_CLASS_IMAGE_SOURCE | 0x900)
1318 #define V4L2_CID_IMAGE_SOURCE_CLASS (V4L2_CTRL_CLASS_IMAGE_SOURCE | 1)
1319
1320 #define V4L2_CID_VBLANK (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 1)
1321 #define V4L2_CID_HBLANK (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 2)
1322 #define V4L2_CID_ANALOGUE_GAIN (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 3)
1323 #define V4L2_CID_TEST_PATTERN_RED (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 4)
1324 #define V4L2_CID_TEST_PATTERN_GREENR (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 5)
1325 #define V4L2_CID_TEST_PATTERN_BLUE (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 6)
1326 #define V4L2_CID_TEST_PATTERN_GREENB (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 7)
1327 #define V4L2_CID_UNIT_CELL_SIZE (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 8)
1328 #define V4L2_CID_NOTIFY_GAINS (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 9)
1329
1330
1331 /* Image processing controls */
1332
1333 #define V4L2_CID_IMAGE_PROC_CLASS_BASE (V4L2_CTRL_CLASS_IMAGE_PROC | 0x900)
1334 #define V4L2_CID_IMAGE_PROC_CLASS (V4L2_CTRL_CLASS_IMAGE_PROC | 1)
1335
1336 #define V4L2_CID_LINK_FREQ (V4L2_CID_IMAGE_PROC_CLASS_BASE + 1)
1337 #define V4L2_CID_PIXEL_RATE (V4L2_CID_IMAGE_PROC_CLASS_BASE + 2)
1338 #define V4L2_CID_TEST_PATTERN (V4L2_CID_IMAGE_PROC_CLASS_BASE + 3)
1339 #define V4L2_CID_DEINTERLACING_MODE (V4L2_CID_IMAGE_PROC_CLASS_BASE + 4)
1340 #define V4L2_CID_DIGITAL_GAIN (V4L2_CID_IMAGE_PROC_CLASS_BASE + 5)
1341
1342 /* DV-class control IDs defined by V4L2 */
1343 #define V4L2_CID_DV_CLASS_BASE (V4L2_CTRL_CLASS_DV | 0x900)
1344 #define V4L2_CID_DV_CLASS (V4L2_CTRL_CLASS_DV | 1)
1345
1346 #define V4L2_CID_DV_TX_HOTPLUG (V4L2_CID_DV_CLASS_BASE + 1)
1347 #define V4L2_CID_DV_TX_RXSENSE (V4L2_CID_DV_CLASS_BASE + 2)
1348 #define V4L2_CID_DV_TX_EDID_PRESENT (V4L2_CID_DV_CLASS_BASE + 3)
1349 #define V4L2_CID_DV_TX_MODE (V4L2_CID_DV_CLASS_BASE + 4)
1350 enum v4l2_dv_tx_mode {
1351 V4L2_DV_TX_MODE_DVI_D = 0,
1352 V4L2_DV_TX_MODE_HDMI = 1,
1353 };
1354 #define V4L2_CID_DV_TX_RGB_RANGE (V4L2_CID_DV_CLASS_BASE + 5)
1355 enum v4l2_dv_rgb_range {
1356 V4L2_DV_RGB_RANGE_AUTO = 0,
1357 V4L2_DV_RGB_RANGE_LIMITED = 1,
1358 V4L2_DV_RGB_RANGE_FULL = 2,
1359 };
1360
1361 #define V4L2_CID_DV_TX_IT_CONTENT_TYPE (V4L2_CID_DV_CLASS_BASE + 6)
1362 enum v4l2_dv_it_content_type {
1363 V4L2_DV_IT_CONTENT_TYPE_GRAPHICS = 0,
1364 V4L2_DV_IT_CONTENT_TYPE_PHOTO = 1,
1365 V4L2_DV_IT_CONTENT_TYPE_CINEMA = 2,
1366 V4L2_DV_IT_CONTENT_TYPE_GAME = 3,
1367 V4L2_DV_IT_CONTENT_TYPE_NO_ITC = 4,
1368 };
1369
1370 #define V4L2_CID_DV_RX_POWER_PRESENT (V4L2_CID_DV_CLASS_BASE + 100)
1371 #define V4L2_CID_DV_RX_RGB_RANGE (V4L2_CID_DV_CLASS_BASE + 101)
1372 #define V4L2_CID_DV_RX_IT_CONTENT_TYPE (V4L2_CID_DV_CLASS_BASE + 102)
1373
1374 #define V4L2_CID_FM_RX_CLASS_BASE (V4L2_CTRL_CLASS_FM_RX | 0x900)
1375 #define V4L2_CID_FM_RX_CLASS (V4L2_CTRL_CLASS_FM_RX | 1)
1376
1377 #define V4L2_CID_TUNE_DEEMPHASIS (V4L2_CID_FM_RX_CLASS_BASE + 1)
1378 enum v4l2_deemphasis {
1379 V4L2_DEEMPHASIS_DISABLED = V4L2_PREEMPHASIS_DISABLED,
1380 V4L2_DEEMPHASIS_50_uS = V4L2_PREEMPHASIS_50_uS,
1381 V4L2_DEEMPHASIS_75_uS = V4L2_PREEMPHASIS_75_uS,
1382 };
1383
1384 #define V4L2_CID_RDS_RECEPTION (V4L2_CID_FM_RX_CLASS_BASE + 2)
1385 #define V4L2_CID_RDS_RX_PTY (V4L2_CID_FM_RX_CLASS_BASE + 3)
1386 #define V4L2_CID_RDS_RX_PS_NAME (V4L2_CID_FM_RX_CLASS_BASE + 4)
1387 #define V4L2_CID_RDS_RX_RADIO_TEXT (V4L2_CID_FM_RX_CLASS_BASE + 5)
1388 #define V4L2_CID_RDS_RX_TRAFFIC_ANNOUNCEMENT (V4L2_CID_FM_RX_CLASS_BASE + 6)
1389 #define V4L2_CID_RDS_RX_TRAFFIC_PROGRAM (V4L2_CID_FM_RX_CLASS_BASE + 7)
1390 #define V4L2_CID_RDS_RX_MUSIC_SPEECH (V4L2_CID_FM_RX_CLASS_BASE + 8)
1391
1392 #define V4L2_CID_RF_TUNER_CLASS_BASE (V4L2_CTRL_CLASS_RF_TUNER | 0x900)
1393 #define V4L2_CID_RF_TUNER_CLASS (V4L2_CTRL_CLASS_RF_TUNER | 1)
1394
1395 #define V4L2_CID_RF_TUNER_BANDWIDTH_AUTO (V4L2_CID_RF_TUNER_CLASS_BASE + 11)
1396 #define V4L2_CID_RF_TUNER_BANDWIDTH (V4L2_CID_RF_TUNER_CLASS_BASE + 12)
1397 #define V4L2_CID_RF_TUNER_RF_GAIN (V4L2_CID_RF_TUNER_CLASS_BASE + 32)
1398 #define V4L2_CID_RF_TUNER_LNA_GAIN_AUTO (V4L2_CID_RF_TUNER_CLASS_BASE + 41)
1399 #define V4L2_CID_RF_TUNER_LNA_GAIN (V4L2_CID_RF_TUNER_CLASS_BASE + 42)
1400 #define V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO (V4L2_CID_RF_TUNER_CLASS_BASE + 51)
1401 #define V4L2_CID_RF_TUNER_MIXER_GAIN (V4L2_CID_RF_TUNER_CLASS_BASE + 52)
1402 #define V4L2_CID_RF_TUNER_IF_GAIN_AUTO (V4L2_CID_RF_TUNER_CLASS_BASE + 61)
1403 #define V4L2_CID_RF_TUNER_IF_GAIN (V4L2_CID_RF_TUNER_CLASS_BASE + 62)
1404 #define V4L2_CID_RF_TUNER_PLL_LOCK (V4L2_CID_RF_TUNER_CLASS_BASE + 91)
1405
1406
1407 /* Detection-class control IDs defined by V4L2 */
1408 #define V4L2_CID_DETECT_CLASS_BASE (V4L2_CTRL_CLASS_DETECT | 0x900)
1409 #define V4L2_CID_DETECT_CLASS (V4L2_CTRL_CLASS_DETECT | 1)
1410
1411 #define V4L2_CID_DETECT_MD_MODE (V4L2_CID_DETECT_CLASS_BASE + 1)
1412 enum v4l2_detect_md_mode {
1413 V4L2_DETECT_MD_MODE_DISABLED = 0,
1414 V4L2_DETECT_MD_MODE_GLOBAL = 1,
1415 V4L2_DETECT_MD_MODE_THRESHOLD_GRID = 2,
1416 V4L2_DETECT_MD_MODE_REGION_GRID = 3,
1417 };
1418 #define V4L2_CID_DETECT_MD_GLOBAL_THRESHOLD (V4L2_CID_DETECT_CLASS_BASE + 2)
1419 #define V4L2_CID_DETECT_MD_THRESHOLD_GRID (V4L2_CID_DETECT_CLASS_BASE + 3)
1420 #define V4L2_CID_DETECT_MD_REGION_GRID (V4L2_CID_DETECT_CLASS_BASE + 4)
1421
1422
1423 /* Stateless CODECs controls */
1424 #define V4L2_CID_CODEC_STATELESS_BASE (V4L2_CTRL_CLASS_CODEC_STATELESS | 0x900)
1425 #define V4L2_CID_CODEC_STATELESS_CLASS (V4L2_CTRL_CLASS_CODEC_STATELESS | 1)
1426
1427 #define V4L2_CID_STATELESS_H264_DECODE_MODE (V4L2_CID_CODEC_STATELESS_BASE + 0)
1428 /**
1429 * enum v4l2_stateless_h264_decode_mode - Decoding mode
1430 *
1431 * @V4L2_STATELESS_H264_DECODE_MODE_SLICE_BASED: indicates that decoding
1432 * is performed one slice at a time. In this mode,
1433 * V4L2_CID_STATELESS_H264_SLICE_PARAMS must contain the parsed slice
1434 * parameters and the OUTPUT buffer must contain a single slice.
1435 * V4L2_BUF_CAP_SUPPORTS_M2M_HOLD_CAPTURE_BUF feature is used
1436 * in order to support multislice frames.
1437 * @V4L2_STATELESS_H264_DECODE_MODE_FRAME_BASED: indicates that
1438 * decoding is performed per frame. The OUTPUT buffer must contain
1439 * all slices and also both fields. This mode is typically supported
1440 * by device drivers that are able to parse the slice(s) header(s)
1441 * in hardware. When this mode is selected,
1442 * V4L2_CID_STATELESS_H264_SLICE_PARAMS is not used.
1443 */
1444 enum v4l2_stateless_h264_decode_mode {
1445 V4L2_STATELESS_H264_DECODE_MODE_SLICE_BASED,
1446 V4L2_STATELESS_H264_DECODE_MODE_FRAME_BASED,
1447 };
1448
1449 #define V4L2_CID_STATELESS_H264_START_CODE (V4L2_CID_CODEC_STATELESS_BASE + 1)
1450 /**
1451 * enum v4l2_stateless_h264_start_code - Start code
1452 *
1453 * @V4L2_STATELESS_H264_START_CODE_NONE: slices are passed
1454 * to the driver without any start code.
1455 * @V4L2_STATELESS_H264_START_CODE_ANNEX_B: slices are passed
1456 * to the driver with an Annex B start code prefix
1457 * (legal start codes can be 3-bytes 0x000001 or 4-bytes 0x00000001).
1458 * This mode is typically supported by device drivers that parse
1459 * the start code in hardware.
1460 */
1461 enum v4l2_stateless_h264_start_code {
1462 V4L2_STATELESS_H264_START_CODE_NONE,
1463 V4L2_STATELESS_H264_START_CODE_ANNEX_B,
1464 };
1465
1466 #define V4L2_H264_SPS_CONSTRAINT_SET0_FLAG 0x01
1467 #define V4L2_H264_SPS_CONSTRAINT_SET1_FLAG 0x02
1468 #define V4L2_H264_SPS_CONSTRAINT_SET2_FLAG 0x04
1469 #define V4L2_H264_SPS_CONSTRAINT_SET3_FLAG 0x08
1470 #define V4L2_H264_SPS_CONSTRAINT_SET4_FLAG 0x10
1471 #define V4L2_H264_SPS_CONSTRAINT_SET5_FLAG 0x20
1472
1473 #define V4L2_H264_SPS_FLAG_SEPARATE_COLOUR_PLANE 0x01
1474 #define V4L2_H264_SPS_FLAG_QPPRIME_Y_ZERO_TRANSFORM_BYPASS 0x02
1475 #define V4L2_H264_SPS_FLAG_DELTA_PIC_ORDER_ALWAYS_ZERO 0x04
1476 #define V4L2_H264_SPS_FLAG_GAPS_IN_FRAME_NUM_VALUE_ALLOWED 0x08
1477 #define V4L2_H264_SPS_FLAG_FRAME_MBS_ONLY 0x10
1478 #define V4L2_H264_SPS_FLAG_MB_ADAPTIVE_FRAME_FIELD 0x20
1479 #define V4L2_H264_SPS_FLAG_DIRECT_8X8_INFERENCE 0x40
1480
1481 #define V4L2_H264_SPS_HAS_CHROMA_FORMAT(sps) \
1482 ((sps)->profile_idc == 100 || (sps)->profile_idc == 110 || \
1483 (sps)->profile_idc == 122 || (sps)->profile_idc == 244 || \
1484 (sps)->profile_idc == 44 || (sps)->profile_idc == 83 || \
1485 (sps)->profile_idc == 86 || (sps)->profile_idc == 118 || \
1486 (sps)->profile_idc == 128 || (sps)->profile_idc == 138 || \
1487 (sps)->profile_idc == 139 || (sps)->profile_idc == 134 || \
1488 (sps)->profile_idc == 135)
1489
1490 #define V4L2_CID_STATELESS_H264_SPS (V4L2_CID_CODEC_STATELESS_BASE + 2)
1491 /**
1492 * struct v4l2_ctrl_h264_sps - H264 sequence parameter set
1493 *
1494 * All the members on this sequence parameter set structure match the
1495 * sequence parameter set syntax as specified by the H264 specification.
1496 *
1497 * @profile_idc: see H264 specification.
1498 * @constraint_set_flags: see H264 specification.
1499 * @level_idc: see H264 specification.
1500 * @seq_parameter_set_id: see H264 specification.
1501 * @chroma_format_idc: see H264 specification.
1502 * @bit_depth_luma_minus8: see H264 specification.
1503 * @bit_depth_chroma_minus8: see H264 specification.
1504 * @log2_max_frame_num_minus4: see H264 specification.
1505 * @pic_order_cnt_type: see H264 specification.
1506 * @log2_max_pic_order_cnt_lsb_minus4: see H264 specification.
1507 * @max_num_ref_frames: see H264 specification.
1508 * @num_ref_frames_in_pic_order_cnt_cycle: see H264 specification.
1509 * @offset_for_ref_frame: see H264 specification.
1510 * @offset_for_non_ref_pic: see H264 specification.
1511 * @offset_for_top_to_bottom_field: see H264 specification.
1512 * @pic_width_in_mbs_minus1: see H264 specification.
1513 * @pic_height_in_map_units_minus1: see H264 specification.
1514 * @flags: see V4L2_H264_SPS_FLAG_{}.
1515 */
1516 struct v4l2_ctrl_h264_sps {
1517 u_int8_t profile_idc;
1518 u_int8_t constraint_set_flags;
1519 u_int8_t level_idc;
1520 u_int8_t seq_parameter_set_id;
1521 u_int8_t chroma_format_idc;
1522 u_int8_t bit_depth_luma_minus8;
1523 u_int8_t bit_depth_chroma_minus8;
1524 u_int8_t log2_max_frame_num_minus4;
1525 u_int8_t pic_order_cnt_type;
1526 u_int8_t log2_max_pic_order_cnt_lsb_minus4;
1527 u_int8_t max_num_ref_frames;
1528 u_int8_t num_ref_frames_in_pic_order_cnt_cycle;
1529 int32_t offset_for_ref_frame[255];
1530 int32_t offset_for_non_ref_pic;
1531 int32_t offset_for_top_to_bottom_field;
1532 u_int16_t pic_width_in_mbs_minus1;
1533 u_int16_t pic_height_in_map_units_minus1;
1534 u_int32_t flags;
1535 };
1536
1537 #define V4L2_H264_PPS_FLAG_ENTROPY_CODING_MODE 0x0001
1538 #define V4L2_H264_PPS_FLAG_BOTTOM_FIELD_PIC_ORDER_IN_FRAME_PRESENT 0x0002
1539 #define V4L2_H264_PPS_FLAG_WEIGHTED_PRED 0x0004
1540 #define V4L2_H264_PPS_FLAG_DEBLOCKING_FILTER_CONTROL_PRESENT 0x0008
1541 #define V4L2_H264_PPS_FLAG_CONSTRAINED_INTRA_PRED 0x0010
1542 #define V4L2_H264_PPS_FLAG_REDUNDANT_PIC_CNT_PRESENT 0x0020
1543 #define V4L2_H264_PPS_FLAG_TRANSFORM_8X8_MODE 0x0040
1544 #define V4L2_H264_PPS_FLAG_SCALING_MATRIX_PRESENT 0x0080
1545
1546 #define V4L2_CID_STATELESS_H264_PPS (V4L2_CID_CODEC_STATELESS_BASE + 3)
1547 /**
1548 * struct v4l2_ctrl_h264_pps - H264 picture parameter set
1549 *
1550 * Except where noted, all the members on this picture parameter set
1551 * structure match the picture parameter set syntax as specified
1552 * by the H264 specification.
1553 *
1554 * In particular, V4L2_H264_PPS_FLAG_SCALING_MATRIX_PRESENT flag
1555 * has a specific meaning. This flag should be set if a non-flat
1556 * scaling matrix applies to the picture. In this case, applications
1557 * are expected to use V4L2_CID_STATELESS_H264_SCALING_MATRIX,
1558 * to pass the values of the non-flat matrices.
1559 *
1560 * @pic_parameter_set_id: see H264 specification.
1561 * @seq_parameter_set_id: see H264 specification.
1562 * @num_slice_groups_minus1: see H264 specification.
1563 * @num_ref_idx_l0_default_active_minus1: see H264 specification.
1564 * @num_ref_idx_l1_default_active_minus1: see H264 specification.
1565 * @weighted_bipred_idc: see H264 specification.
1566 * @pic_init_qp_minus26: see H264 specification.
1567 * @pic_init_qs_minus26: see H264 specification.
1568 * @chroma_qp_index_offset: see H264 specification.
1569 * @second_chroma_qp_index_offset: see H264 specification.
1570 * @flags: see V4L2_H264_PPS_FLAG_{}.
1571 */
1572 struct v4l2_ctrl_h264_pps {
1573 u_int8_t pic_parameter_set_id;
1574 u_int8_t seq_parameter_set_id;
1575 u_int8_t num_slice_groups_minus1;
1576 u_int8_t num_ref_idx_l0_default_active_minus1;
1577 u_int8_t num_ref_idx_l1_default_active_minus1;
1578 u_int8_t weighted_bipred_idc;
1579 int8_t pic_init_qp_minus26;
1580 int8_t pic_init_qs_minus26;
1581 int8_t chroma_qp_index_offset;
1582 int8_t second_chroma_qp_index_offset;
1583 u_int16_t flags;
1584 };
1585
1586 #define V4L2_CID_STATELESS_H264_SCALING_MATRIX (V4L2_CID_CODEC_STATELESS_BASE + 4)
1587 /**
1588 * struct v4l2_ctrl_h264_scaling_matrix - H264 scaling matrices
1589 *
1590 * @scaling_list_4x4: scaling matrix after applying the inverse
1591 * scanning process. Expected list order is Intra Y, Intra Cb,
1592 * Intra Cr, Inter Y, Inter Cb, Inter Cr. The values on each
1593 * scaling list are expected in raster scan order.
1594 * @scaling_list_8x8: scaling matrix after applying the inverse
1595 * scanning process. Expected list order is Intra Y, Inter Y,
1596 * Intra Cb, Inter Cb, Intra Cr, Inter Cr. The values on each
1597 * scaling list are expected in raster scan order.
1598 *
1599 * Note that the list order is different for the 4x4 and 8x8
1600 * matrices as per the H264 specification, see table 7-2 "Assignment
1601 * of mnemonic names to scaling list indices and specification of
1602 * fall-back rule".
1603 */
1604 struct v4l2_ctrl_h264_scaling_matrix {
1605 u_int8_t scaling_list_4x4[6][16];
1606 u_int8_t scaling_list_8x8[6][64];
1607 };
1608
1609 struct v4l2_h264_weight_factors {
1610 int16_t luma_weight[32];
1611 int16_t luma_offset[32];
1612 int16_t chroma_weight[32][2];
1613 int16_t chroma_offset[32][2];
1614 };
1615
1616 #define V4L2_H264_CTRL_PRED_WEIGHTS_REQUIRED(pps, slice) \
1617 ((((pps)->flags & V4L2_H264_PPS_FLAG_WEIGHTED_PRED) && \
1618 ((slice)->slice_type == V4L2_H264_SLICE_TYPE_P || \
1619 (slice)->slice_type == V4L2_H264_SLICE_TYPE_SP)) || \
1620 ((pps)->weighted_bipred_idc == 1 && \
1621 (slice)->slice_type == V4L2_H264_SLICE_TYPE_B))
1622
1623 #define V4L2_CID_STATELESS_H264_PRED_WEIGHTS (V4L2_CID_CODEC_STATELESS_BASE + 5)
1624 /**
1625 * struct v4l2_ctrl_h264_pred_weights - Prediction weight table
1626 *
1627 * Prediction weight table, which matches the syntax specified
1628 * by the H264 specification.
1629 *
1630 * @luma_log2_weight_denom: see H264 specification.
1631 * @chroma_log2_weight_denom: see H264 specification.
1632 * @weight_factors: luma and chroma weight factors.
1633 */
1634 struct v4l2_ctrl_h264_pred_weights {
1635 u_int16_t luma_log2_weight_denom;
1636 u_int16_t chroma_log2_weight_denom;
1637 struct v4l2_h264_weight_factors weight_factors[2];
1638 };
1639
1640 #define V4L2_H264_SLICE_TYPE_P 0
1641 #define V4L2_H264_SLICE_TYPE_B 1
1642 #define V4L2_H264_SLICE_TYPE_I 2
1643 #define V4L2_H264_SLICE_TYPE_SP 3
1644 #define V4L2_H264_SLICE_TYPE_SI 4
1645
1646 #define V4L2_H264_SLICE_FLAG_DIRECT_SPATIAL_MV_PRED 0x01
1647 #define V4L2_H264_SLICE_FLAG_SP_FOR_SWITCH 0x02
1648
1649 #define V4L2_H264_TOP_FIELD_REF 0x1
1650 #define V4L2_H264_BOTTOM_FIELD_REF 0x2
1651 #define V4L2_H264_FRAME_REF 0x3
1652
1653 /**
1654 * struct v4l2_h264_reference - H264 picture reference
1655 *
1656 * @fields: indicates how the picture is referenced.
1657 * Valid values are V4L2_H264_{}_REF.
1658 * @index: index into v4l2_ctrl_h264_decode_params.dpb[].
1659 */
1660 struct v4l2_h264_reference {
1661 u_int8_t fields;
1662 u_int8_t index;
1663 };
1664
1665 /*
1666 * Maximum DPB size, as specified by section 'A.3.1 Level limits
1667 * common to the Baseline, Main, and Extended profiles'.
1668 */
1669 #define V4L2_H264_NUM_DPB_ENTRIES 16
1670 #define V4L2_H264_REF_LIST_LEN (2 * V4L2_H264_NUM_DPB_ENTRIES)
1671
1672 #define V4L2_CID_STATELESS_H264_SLICE_PARAMS (V4L2_CID_CODEC_STATELESS_BASE + 6)
1673 /**
1674 * struct v4l2_ctrl_h264_slice_params - H264 slice parameters
1675 *
1676 * This structure holds the H264 syntax elements that are specified
1677 * as non-invariant for the slices in a given frame.
1678 *
1679 * Slice invariant syntax elements are contained in struct
1680 * v4l2_ctrl_h264_decode_params. This is done to reduce the API surface
1681 * on frame-based decoders, where slice header parsing is done by the
1682 * hardware.
1683 *
1684 * Slice invariant syntax elements are specified in specification section
1685 * "7.4.3 Slice header semantics".
1686 *
1687 * Except where noted, the members on this struct match the slice header syntax.
1688 *
1689 * @header_bit_size: offset in bits to slice_data() from the beginning of this slice.
1690 * @first_mb_in_slice: see H264 specification.
1691 * @slice_type: see H264 specification.
1692 * @colour_plane_id: see H264 specification.
1693 * @redundant_pic_cnt: see H264 specification.
1694 * @cabac_init_idc: see H264 specification.
1695 * @slice_qp_delta: see H264 specification.
1696 * @slice_qs_delta: see H264 specification.
1697 * @disable_deblocking_filter_idc: see H264 specification.
1698 * @slice_alpha_c0_offset_div2: see H264 specification.
1699 * @slice_beta_offset_div2: see H264 specification.
1700 * @num_ref_idx_l0_active_minus1: see H264 specification.
1701 * @num_ref_idx_l1_active_minus1: see H264 specification.
1702 * @reserved: padding field. Should be zeroed by applications.
1703 * @ref_pic_list0: reference picture list 0 after applying the per-slice modifications.
1704 * @ref_pic_list1: reference picture list 1 after applying the per-slice modifications.
1705 * @flags: see V4L2_H264_SLICE_FLAG_{}.
1706 */
1707 struct v4l2_ctrl_h264_slice_params {
1708 u_int32_t header_bit_size;
1709 u_int32_t first_mb_in_slice;
1710 u_int8_t slice_type;
1711 u_int8_t colour_plane_id;
1712 u_int8_t redundant_pic_cnt;
1713 u_int8_t cabac_init_idc;
1714 int8_t slice_qp_delta;
1715 int8_t slice_qs_delta;
1716 u_int8_t disable_deblocking_filter_idc;
1717 int8_t slice_alpha_c0_offset_div2;
1718 int8_t slice_beta_offset_div2;
1719 u_int8_t num_ref_idx_l0_active_minus1;
1720 u_int8_t num_ref_idx_l1_active_minus1;
1721
1722 u_int8_t reserved;
1723
1724 struct v4l2_h264_reference ref_pic_list0[V4L2_H264_REF_LIST_LEN];
1725 struct v4l2_h264_reference ref_pic_list1[V4L2_H264_REF_LIST_LEN];
1726
1727 u_int32_t flags;
1728 };
1729
1730 #define V4L2_H264_DPB_ENTRY_FLAG_VALID 0x01
1731 #define V4L2_H264_DPB_ENTRY_FLAG_ACTIVE 0x02
1732 #define V4L2_H264_DPB_ENTRY_FLAG_LONG_TERM 0x04
1733 #define V4L2_H264_DPB_ENTRY_FLAG_FIELD 0x08
1734
1735 /**
1736 * struct v4l2_h264_dpb_entry - H264 decoded picture buffer entry
1737 *
1738 * @reference_ts: timestamp of the V4L2 capture buffer to use as reference.
1739 * The timestamp refers to the timestamp field in struct v4l2_buffer.
1740 * Use v4l2_timeval_to_ns() to convert the struct timeval to a u_int64_t.
1741 * @pic_num: matches PicNum variable assigned during the reference
1742 * picture lists construction process.
1743 * @frame_num: frame identifier which matches frame_num syntax element.
1744 * @fields: indicates how the DPB entry is referenced. Valid values are
1745 * V4L2_H264_{}_REF.
1746 * @reserved: padding field. Should be zeroed by applications.
1747 * @top_field_order_cnt: matches TopFieldOrderCnt picture value.
1748 * @bottom_field_order_cnt: matches BottomFieldOrderCnt picture value.
1749 * Note that picture field is indicated by v4l2_buffer.field.
1750 * @flags: see V4L2_H264_DPB_ENTRY_FLAG_{}.
1751 */
1752 struct v4l2_h264_dpb_entry {
1753 u_int64_t reference_ts;
1754 u_int32_t pic_num;
1755 u_int16_t frame_num;
1756 u_int8_t fields;
1757 u_int8_t reserved[5];
1758 int32_t top_field_order_cnt;
1759 int32_t bottom_field_order_cnt;
1760 u_int32_t flags;
1761 };
1762
1763 #define V4L2_H264_DECODE_PARAM_FLAG_IDR_PIC 0x01
1764 #define V4L2_H264_DECODE_PARAM_FLAG_FIELD_PIC 0x02
1765 #define V4L2_H264_DECODE_PARAM_FLAG_BOTTOM_FIELD 0x04
1766 #define V4L2_H264_DECODE_PARAM_FLAG_PFRAME 0x08
1767 #define V4L2_H264_DECODE_PARAM_FLAG_BFRAME 0x10
1768
1769 #define V4L2_CID_STATELESS_H264_DECODE_PARAMS (V4L2_CID_CODEC_STATELESS_BASE + 7)
1770 /**
1771 * struct v4l2_ctrl_h264_decode_params - H264 decoding parameters
1772 *
1773 * @dpb: decoded picture buffer.
1774 * @nal_ref_idc: slice header syntax element.
1775 * @frame_num: slice header syntax element.
1776 * @top_field_order_cnt: matches TopFieldOrderCnt picture value.
1777 * @bottom_field_order_cnt: matches BottomFieldOrderCnt picture value.
1778 * Note that picture field is indicated by v4l2_buffer.field.
1779 * @idr_pic_id: slice header syntax element.
1780 * @pic_order_cnt_lsb: slice header syntax element.
1781 * @delta_pic_order_cnt_bottom: slice header syntax element.
1782 * @delta_pic_order_cnt0: slice header syntax element.
1783 * @delta_pic_order_cnt1: slice header syntax element.
1784 * @dec_ref_pic_marking_bit_size: size in bits of dec_ref_pic_marking()
1785 * syntax element.
1786 * @pic_order_cnt_bit_size: size in bits of pic order count syntax.
1787 * @slice_group_change_cycle: slice header syntax element.
1788 * @reserved: padding field. Should be zeroed by applications.
1789 * @flags: see V4L2_H264_DECODE_PARAM_FLAG_{}.
1790 */
1791 struct v4l2_ctrl_h264_decode_params {
1792 struct v4l2_h264_dpb_entry dpb[V4L2_H264_NUM_DPB_ENTRIES];
1793 u_int16_t nal_ref_idc;
1794 u_int16_t frame_num;
1795 int32_t top_field_order_cnt;
1796 int32_t bottom_field_order_cnt;
1797 u_int16_t idr_pic_id;
1798 u_int16_t pic_order_cnt_lsb;
1799 int32_t delta_pic_order_cnt_bottom;
1800 int32_t delta_pic_order_cnt0;
1801 int32_t delta_pic_order_cnt1;
1802 u_int32_t dec_ref_pic_marking_bit_size;
1803 u_int32_t pic_order_cnt_bit_size;
1804 u_int32_t slice_group_change_cycle;
1805
1806 u_int32_t reserved;
1807 u_int32_t flags;
1808 };
1809
1810
1811 /* Stateless FWHT control, used by the vicodec driver */
1812
1813 /* Current FWHT version */
1814 #define V4L2_FWHT_VERSION 3
1815
1816 /* Set if this is an interlaced format */
1817 #define V4L2_FWHT_FL_IS_INTERLACED _BITUL(0)
1818 /* Set if this is a bottom-first (NTSC) interlaced format */
1819 #define V4L2_FWHT_FL_IS_BOTTOM_FIRST _BITUL(1)
1820 /* Set if each 'frame' contains just one field */
1821 #define V4L2_FWHT_FL_IS_ALTERNATE _BITUL(2)
1822 /*
1823 * If V4L2_FWHT_FL_IS_ALTERNATE was set, then this is set if this
1824 * 'frame' is the bottom field, else it is the top field.
1825 */
1826 #define V4L2_FWHT_FL_IS_BOTTOM_FIELD _BITUL(3)
1827 /* Set if the Y' plane is uncompressed */
1828 #define V4L2_FWHT_FL_LUMA_IS_UNCOMPRESSED _BITUL(4)
1829 /* Set if the Cb plane is uncompressed */
1830 #define V4L2_FWHT_FL_CB_IS_UNCOMPRESSED _BITUL(5)
1831 /* Set if the Cr plane is uncompressed */
1832 #define V4L2_FWHT_FL_CR_IS_UNCOMPRESSED _BITUL(6)
1833 /* Set if the chroma plane is full height, if cleared it is half height */
1834 #define V4L2_FWHT_FL_CHROMA_FULL_HEIGHT _BITUL(7)
1835 /* Set if the chroma plane is full width, if cleared it is half width */
1836 #define V4L2_FWHT_FL_CHROMA_FULL_WIDTH _BITUL(8)
1837 /* Set if the alpha plane is uncompressed */
1838 #define V4L2_FWHT_FL_ALPHA_IS_UNCOMPRESSED _BITUL(9)
1839 /* Set if this is an I Frame */
1840 #define V4L2_FWHT_FL_I_FRAME _BITUL(10)
1841
1842 /* A 4-values flag - the number of components - 1 */
1843 #define V4L2_FWHT_FL_COMPONENTS_NUM_MSK GENMASK(18, 16)
1844 #define V4L2_FWHT_FL_COMPONENTS_NUM_OFFSET 16
1845
1846 /* A 4-values flag - the pixel encoding type */
1847 #define V4L2_FWHT_FL_PIXENC_MSK GENMASK(20, 19)
1848 #define V4L2_FWHT_FL_PIXENC_OFFSET 19
1849 #define V4L2_FWHT_FL_PIXENC_YUV (1 << V4L2_FWHT_FL_PIXENC_OFFSET)
1850 #define V4L2_FWHT_FL_PIXENC_RGB (2 << V4L2_FWHT_FL_PIXENC_OFFSET)
1851 #define V4L2_FWHT_FL_PIXENC_HSV (3 << V4L2_FWHT_FL_PIXENC_OFFSET)
1852
1853 #define V4L2_CID_STATELESS_FWHT_PARAMS (V4L2_CID_CODEC_STATELESS_BASE + 100)
1854 /**
1855 * struct v4l2_ctrl_fwht_params - FWHT parameters
1856 *
1857 * @backward_ref_ts: timestamp of the V4L2 capture buffer to use as reference.
1858 * The timestamp refers to the timestamp field in struct v4l2_buffer.
1859 * Use v4l2_timeval_to_ns() to convert the struct timeval to a u_int64_t.
1860 * @version: must be V4L2_FWHT_VERSION.
1861 * @width: width of frame.
1862 * @height: height of frame.
1863 * @flags: FWHT flags (see V4L2_FWHT_FL_*).
1864 * @colorspace: the colorspace (enum v4l2_colorspace).
1865 * @xfer_func: the transfer function (enum v4l2_xfer_func).
1866 * @ycbcr_enc: the Y'CbCr encoding (enum v4l2_ycbcr_encoding).
1867 * @quantization: the quantization (enum v4l2_quantization).
1868 */
1869 struct v4l2_ctrl_fwht_params {
1870 u_int64_t backward_ref_ts;
1871 u_int32_t version;
1872 u_int32_t width;
1873 u_int32_t height;
1874 u_int32_t flags;
1875 u_int32_t colorspace;
1876 u_int32_t xfer_func;
1877 u_int32_t ycbcr_enc;
1878 u_int32_t quantization;
1879 };
1880
1881 /* Stateless VP8 control */
1882
1883 #define V4L2_VP8_SEGMENT_FLAG_ENABLED 0x01
1884 #define V4L2_VP8_SEGMENT_FLAG_UPDATE_MAP 0x02
1885 #define V4L2_VP8_SEGMENT_FLAG_UPDATE_FEATURE_DATA 0x04
1886 #define V4L2_VP8_SEGMENT_FLAG_DELTA_VALUE_MODE 0x08
1887
1888 /**
1889 * struct v4l2_vp8_segment - VP8 segment-based adjustments parameters
1890 *
1891 * @quant_update: update values for the segment quantizer.
1892 * @lf_update: update values for the loop filter level.
1893 * @segment_probs: branch probabilities of the segment_id decoding tree.
1894 * @padding: padding field. Should be zeroed by applications.
1895 * @flags: see V4L2_VP8_SEGMENT_FLAG_{}.
1896 *
1897 * This structure contains segment-based adjustments related parameters.
1898 * See the 'update_segmentation()' part of the frame header syntax,
1899 * and section '9.3. Segment-Based Adjustments' of the VP8 specification
1900 * for more details.
1901 */
1902 struct v4l2_vp8_segment {
1903 int8_t quant_update[4];
1904 int8_t lf_update[4];
1905 u_int8_t segment_probs[3];
1906 u_int8_t padding;
1907 u_int32_t flags;
1908 };
1909
1910 #define V4L2_VP8_LF_ADJ_ENABLE 0x01
1911 #define V4L2_VP8_LF_DELTA_UPDATE 0x02
1912 #define V4L2_VP8_LF_FILTER_TYPE_SIMPLE 0x04
1913
1914 /**
1915 * struct v4l2_vp8_loop_filter - VP8 loop filter parameters
1916 *
1917 * @ref_frm_delta: Reference frame signed delta values.
1918 * @mb_mode_delta: MB prediction mode signed delta values.
1919 * @sharpness_level: matches sharpness_level syntax element.
1920 * @level: matches loop_filter_level syntax element.
1921 * @padding: padding field. Should be zeroed by applications.
1922 * @flags: see V4L2_VP8_LF_{}.
1923 *
1924 * This structure contains loop filter related parameters.
1925 * See the 'mb_lf_adjustments()' part of the frame header syntax,
1926 * and section '9.4. Loop Filter Type and Levels' of the VP8 specification
1927 * for more details.
1928 */
1929 struct v4l2_vp8_loop_filter {
1930 int8_t ref_frm_delta[4];
1931 int8_t mb_mode_delta[4];
1932 u_int8_t sharpness_level;
1933 u_int8_t level;
1934 u_int16_t padding;
1935 u_int32_t flags;
1936 };
1937
1938 /**
1939 * struct v4l2_vp8_quantization - VP8 quantizattion indices
1940 *
1941 * @y_ac_qi: luma AC coefficient table index.
1942 * @y_dc_delta: luma DC delta vaue.
1943 * @y2_dc_delta: y2 block DC delta value.
1944 * @y2_ac_delta: y2 block AC delta value.
1945 * @uv_dc_delta: chroma DC delta value.
1946 * @uv_ac_delta: chroma AC delta value.
1947 * @padding: padding field. Should be zeroed by applications.
1948 *
1949 * This structure contains the quantization indices present
1950 * in 'quant_indices()' part of the frame header syntax.
1951 * See section '9.6. Dequantization Indices' of the VP8 specification
1952 * for more details.
1953 */
1954 struct v4l2_vp8_quantization {
1955 u_int8_t y_ac_qi;
1956 int8_t y_dc_delta;
1957 int8_t y2_dc_delta;
1958 int8_t y2_ac_delta;
1959 int8_t uv_dc_delta;
1960 int8_t uv_ac_delta;
1961 u_int16_t padding;
1962 };
1963
1964 #define V4L2_VP8_COEFF_PROB_CNT 11
1965 #define V4L2_VP8_MV_PROB_CNT 19
1966
1967 /**
1968 * struct v4l2_vp8_entropy - VP8 update probabilities
1969 *
1970 * @coeff_probs: coefficient probability update values.
1971 * @y_mode_probs: luma intra-prediction probabilities.
1972 * @uv_mode_probs: chroma intra-prediction probabilities.
1973 * @mv_probs: mv decoding probability.
1974 * @padding: padding field. Should be zeroed by applications.
1975 *
1976 * This structure contains the update probabilities present in
1977 * 'token_prob_update()' and 'mv_prob_update()' part of the frame header.
1978 * See section '17.2. Probability Updates' of the VP8 specification
1979 * for more details.
1980 */
1981 struct v4l2_vp8_entropy {
1982 u_int8_t coeff_probs[4][8][3][V4L2_VP8_COEFF_PROB_CNT];
1983 u_int8_t y_mode_probs[4];
1984 u_int8_t uv_mode_probs[3];
1985 u_int8_t mv_probs[2][V4L2_VP8_MV_PROB_CNT];
1986 u_int8_t padding[3];
1987 };
1988
1989 /**
1990 * struct v4l2_vp8_entropy_coder_state - VP8 boolean coder state
1991 *
1992 * @range: coder state value for "Range"
1993 * @value: coder state value for "Value"
1994 * @bit_count: number of bits left in range "Value".
1995 * @padding: padding field. Should be zeroed by applications.
1996 *
1997 * This structure contains the state for the boolean coder, as
1998 * explained in section '7. Boolean Entropy Decoder' of the VP8 specification.
1999 */
2000 struct v4l2_vp8_entropy_coder_state {
2001 u_int8_t range;
2002 u_int8_t value;
2003 u_int8_t bit_count;
2004 u_int8_t padding;
2005 };
2006
2007 #define V4L2_VP8_FRAME_FLAG_KEY_FRAME 0x01
2008 #define V4L2_VP8_FRAME_FLAG_EXPERIMENTAL 0x02
2009 #define V4L2_VP8_FRAME_FLAG_SHOW_FRAME 0x04
2010 #define V4L2_VP8_FRAME_FLAG_MB_NO_SKIP_COEFF 0x08
2011 #define V4L2_VP8_FRAME_FLAG_SIGN_BIAS_GOLDEN 0x10
2012 #define V4L2_VP8_FRAME_FLAG_SIGN_BIAS_ALT 0x20
2013
2014 #define V4L2_VP8_FRAME_IS_KEY_FRAME(hdr) \
2015 (!!((hdr)->flags & V4L2_VP8_FRAME_FLAG_KEY_FRAME))
2016
2017 #define V4L2_CID_STATELESS_VP8_FRAME (V4L2_CID_CODEC_STATELESS_BASE + 200)
2018 /**
2019 * struct v4l2_ctrl_vp8_frame - VP8 frame parameters
2020 *
2021 * @segment: segmentation parameters. See &v4l2_vp8_segment for more details
2022 * @lf: loop filter parameters. See &v4l2_vp8_loop_filter for more details
2023 * @quant: quantization parameters. See &v4l2_vp8_quantization for more details
2024 * @entropy: update probabilities. See &v4l2_vp8_entropy for more details
2025 * @coder_state: boolean coder state. See &v4l2_vp8_entropy_coder_state for more details
2026 * @width: frame width.
2027 * @height: frame height.
2028 * @horizontal_scale: horizontal scaling factor.
2029 * @vertical_scale: vertical scaling factor.
2030 * @version: bitstream version.
2031 * @prob_skip_false: frame header syntax element.
2032 * @prob_intra: frame header syntax element.
2033 * @prob_last: frame header syntax element.
2034 * @prob_gf: frame header syntax element.
2035 * @num_dct_parts: number of DCT coefficients partitions.
2036 * @first_part_size: size of the first partition, i.e. the control partition.
2037 * @first_part_header_bits: size in bits of the first partition header portion.
2038 * @dct_part_sizes: DCT coefficients sizes.
2039 * @last_frame_ts: "last" reference buffer timestamp.
2040 * The timestamp refers to the timestamp field in struct v4l2_buffer.
2041 * Use v4l2_timeval_to_ns() to convert the struct timeval to a u_int64_t.
2042 * @golden_frame_ts: "golden" reference buffer timestamp.
2043 * @alt_frame_ts: "alt" reference buffer timestamp.
2044 * @flags: see V4L2_VP8_FRAME_FLAG_{}.
2045 */
2046 struct v4l2_ctrl_vp8_frame {
2047 struct v4l2_vp8_segment segment;
2048 struct v4l2_vp8_loop_filter lf;
2049 struct v4l2_vp8_quantization quant;
2050 struct v4l2_vp8_entropy entropy;
2051 struct v4l2_vp8_entropy_coder_state coder_state;
2052
2053 u_int16_t width;
2054 u_int16_t height;
2055
2056 u_int8_t horizontal_scale;
2057 u_int8_t vertical_scale;
2058
2059 u_int8_t version;
2060 u_int8_t prob_skip_false;
2061 u_int8_t prob_intra;
2062 u_int8_t prob_last;
2063 u_int8_t prob_gf;
2064 u_int8_t num_dct_parts;
2065
2066 u_int32_t first_part_size;
2067 u_int32_t first_part_header_bits;
2068 u_int32_t dct_part_sizes[8];
2069
2070 u_int64_t last_frame_ts;
2071 u_int64_t golden_frame_ts;
2072 u_int64_t alt_frame_ts;
2073
2074 u_int64_t flags;
2075 };
2076
2077 /* Stateless MPEG-2 controls */
2078
2079 #define V4L2_MPEG2_SEQ_FLAG_PROGRESSIVE 0x01
2080
2081 #define V4L2_CID_STATELESS_MPEG2_SEQUENCE (V4L2_CID_CODEC_STATELESS_BASE+220)
2082 /**
2083 * struct v4l2_ctrl_mpeg2_sequence - MPEG-2 sequence header
2084 *
2085 * All the members on this structure match the sequence header and sequence
2086 * extension syntaxes as specified by the MPEG-2 specification.
2087 *
2088 * Fields horizontal_size, vertical_size and vbv_buffer_size are a
2089 * combination of respective _value and extension syntax elements,
2090 * as described in section 6.3.3 "Sequence header".
2091 *
2092 * @horizontal_size: combination of elements horizontal_size_value and
2093 * horizontal_size_extension.
2094 * @vertical_size: combination of elements vertical_size_value and
2095 * vertical_size_extension.
2096 * @vbv_buffer_size: combination of elements vbv_buffer_size_value and
2097 * vbv_buffer_size_extension.
2098 * @profile_and_level_indication: see MPEG-2 specification.
2099 * @chroma_format: see MPEG-2 specification.
2100 * @flags: see V4L2_MPEG2_SEQ_FLAG_{}.
2101 */
2102 struct v4l2_ctrl_mpeg2_sequence {
2103 u_int16_t horizontal_size;
2104 u_int16_t vertical_size;
2105 u_int32_t vbv_buffer_size;
2106 u_int16_t profile_and_level_indication;
2107 u_int8_t chroma_format;
2108 u_int8_t flags;
2109 };
2110
2111 #define V4L2_MPEG2_PIC_CODING_TYPE_I 1
2112 #define V4L2_MPEG2_PIC_CODING_TYPE_P 2
2113 #define V4L2_MPEG2_PIC_CODING_TYPE_B 3
2114 #define V4L2_MPEG2_PIC_CODING_TYPE_D 4
2115
2116 #define V4L2_MPEG2_PIC_TOP_FIELD 0x1
2117 #define V4L2_MPEG2_PIC_BOTTOM_FIELD 0x2
2118 #define V4L2_MPEG2_PIC_FRAME 0x3
2119
2120 #define V4L2_MPEG2_PIC_FLAG_TOP_FIELD_FIRST 0x0001
2121 #define V4L2_MPEG2_PIC_FLAG_FRAME_PRED_DCT 0x0002
2122 #define V4L2_MPEG2_PIC_FLAG_CONCEALMENT_MV 0x0004
2123 #define V4L2_MPEG2_PIC_FLAG_Q_SCALE_TYPE 0x0008
2124 #define V4L2_MPEG2_PIC_FLAG_INTRA_VLC 0x0010
2125 #define V4L2_MPEG2_PIC_FLAG_ALT_SCAN 0x0020
2126 #define V4L2_MPEG2_PIC_FLAG_REPEAT_FIRST 0x0040
2127 #define V4L2_MPEG2_PIC_FLAG_PROGRESSIVE 0x0080
2128
2129 #define V4L2_CID_STATELESS_MPEG2_PICTURE (V4L2_CID_CODEC_STATELESS_BASE+221)
2130 /**
2131 * struct v4l2_ctrl_mpeg2_picture - MPEG-2 picture header
2132 *
2133 * All the members on this structure match the picture header and picture
2134 * coding extension syntaxes as specified by the MPEG-2 specification.
2135 *
2136 * @backward_ref_ts: timestamp of the V4L2 capture buffer to use as
2137 * reference for backward prediction.
2138 * @forward_ref_ts: timestamp of the V4L2 capture buffer to use as
2139 * reference for forward prediction. These timestamp refers to the
2140 * timestamp field in struct v4l2_buffer. Use v4l2_timeval_to_ns()
2141 * to convert the struct timeval to a u_int64_t.
2142 * @flags: see V4L2_MPEG2_PIC_FLAG_{}.
2143 * @f_code: see MPEG-2 specification.
2144 * @picture_coding_type: see MPEG-2 specification.
2145 * @picture_structure: see V4L2_MPEG2_PIC_{}_FIELD.
2146 * @intra_dc_precision: see MPEG-2 specification.
2147 * @reserved: padding field. Should be zeroed by applications.
2148 */
2149 struct v4l2_ctrl_mpeg2_picture {
2150 u_int64_t backward_ref_ts;
2151 u_int64_t forward_ref_ts;
2152 u_int32_t flags;
2153 u_int8_t f_code[2][2];
2154 u_int8_t picture_coding_type;
2155 u_int8_t picture_structure;
2156 u_int8_t intra_dc_precision;
2157 u_int8_t reserved[5];
2158 };
2159
2160 #define V4L2_CID_STATELESS_MPEG2_QUANTISATION (V4L2_CID_CODEC_STATELESS_BASE+222)
2161 /**
2162 * struct v4l2_ctrl_mpeg2_quantisation - MPEG-2 quantisation
2163 *
2164 * Quantisation matrices as specified by section 6.3.7
2165 * "Quant matrix extension".
2166 *
2167 * @intra_quantiser_matrix: The quantisation matrix coefficients
2168 * for intra-coded frames, in zigzag scanning order. It is relevant
2169 * for both luma and chroma components, although it can be superseded
2170 * by the chroma-specific matrix for non-4:2:0 YUV formats.
2171 * @non_intra_quantiser_matrix: The quantisation matrix coefficients
2172 * for non-intra-coded frames, in zigzag scanning order. It is relevant
2173 * for both luma and chroma components, although it can be superseded
2174 * by the chroma-specific matrix for non-4:2:0 YUV formats.
2175 * @chroma_intra_quantiser_matrix: The quantisation matrix coefficients
2176 * for the chominance component of intra-coded frames, in zigzag scanning
2177 * order. Only relevant for 4:2:2 and 4:4:4 YUV formats.
2178 * @chroma_non_intra_quantiser_matrix: The quantisation matrix coefficients
2179 * for the chrominance component of non-intra-coded frames, in zigzag scanning
2180 * order. Only relevant for 4:2:2 and 4:4:4 YUV formats.
2181 */
2182 struct v4l2_ctrl_mpeg2_quantisation {
2183 u_int8_t intra_quantiser_matrix[64];
2184 u_int8_t non_intra_quantiser_matrix[64];
2185 u_int8_t chroma_intra_quantiser_matrix[64];
2186 u_int8_t chroma_non_intra_quantiser_matrix[64];
2187 };
2188
2189 #define V4L2_CID_STATELESS_HEVC_SPS (V4L2_CID_CODEC_STATELESS_BASE + 400)
2190 #define V4L2_CID_STATELESS_HEVC_PPS (V4L2_CID_CODEC_STATELESS_BASE + 401)
2191 #define V4L2_CID_STATELESS_HEVC_SLICE_PARAMS (V4L2_CID_CODEC_STATELESS_BASE + 402)
2192 #define V4L2_CID_STATELESS_HEVC_SCALING_MATRIX (V4L2_CID_CODEC_STATELESS_BASE + 403)
2193 #define V4L2_CID_STATELESS_HEVC_DECODE_PARAMS (V4L2_CID_CODEC_STATELESS_BASE + 404)
2194 #define V4L2_CID_STATELESS_HEVC_DECODE_MODE (V4L2_CID_CODEC_STATELESS_BASE + 405)
2195 #define V4L2_CID_STATELESS_HEVC_START_CODE (V4L2_CID_CODEC_STATELESS_BASE + 406)
2196 #define V4L2_CID_STATELESS_HEVC_ENTRY_POINT_OFFSETS (V4L2_CID_CODEC_STATELESS_BASE + 407)
2197
2198 enum v4l2_stateless_hevc_decode_mode {
2199 V4L2_STATELESS_HEVC_DECODE_MODE_SLICE_BASED,
2200 V4L2_STATELESS_HEVC_DECODE_MODE_FRAME_BASED,
2201 };
2202
2203 enum v4l2_stateless_hevc_start_code {
2204 V4L2_STATELESS_HEVC_START_CODE_NONE,
2205 V4L2_STATELESS_HEVC_START_CODE_ANNEX_B,
2206 };
2207
2208 #define V4L2_HEVC_SLICE_TYPE_B 0
2209 #define V4L2_HEVC_SLICE_TYPE_P 1
2210 #define V4L2_HEVC_SLICE_TYPE_I 2
2211
2212 #define V4L2_HEVC_SPS_FLAG_SEPARATE_COLOUR_PLANE (1ULL << 0)
2213 #define V4L2_HEVC_SPS_FLAG_SCALING_LIST_ENABLED (1ULL << 1)
2214 #define V4L2_HEVC_SPS_FLAG_AMP_ENABLED (1ULL << 2)
2215 #define V4L2_HEVC_SPS_FLAG_SAMPLE_ADAPTIVE_OFFSET (1ULL << 3)
2216 #define V4L2_HEVC_SPS_FLAG_PCM_ENABLED (1ULL << 4)
2217 #define V4L2_HEVC_SPS_FLAG_PCM_LOOP_FILTER_DISABLED (1ULL << 5)
2218 #define V4L2_HEVC_SPS_FLAG_LONG_TERM_REF_PICS_PRESENT (1ULL << 6)
2219 #define V4L2_HEVC_SPS_FLAG_SPS_TEMPORAL_MVP_ENABLED (1ULL << 7)
2220 #define V4L2_HEVC_SPS_FLAG_STRONG_INTRA_SMOOTHING_ENABLED (1ULL << 8)
2221
2222 /**
2223 * struct v4l2_ctrl_hevc_sps - ITU-T Rec. H.265: Sequence parameter set
2224 *
2225 * @video_parameter_set_id: specifies the value of the
2226 * vps_video_parameter_set_id of the active VPS
2227 * @seq_parameter_set_id: provides an identifier for the SPS for
2228 * reference by other syntax elements
2229 * @pic_width_in_luma_samples: specifies the width of each decoded picture
2230 * in units of luma samples
2231 * @pic_height_in_luma_samples: specifies the height of each decoded picture
2232 * in units of luma samples
2233 * @bit_depth_luma_minus8: this value plus 8specifies the bit depth of the
2234 * samples of the luma array
2235 * @bit_depth_chroma_minus8: this value plus 8 specifies the bit depth of the
2236 * samples of the chroma arrays
2237 * @log2_max_pic_order_cnt_lsb_minus4: this value plus 4 specifies the value of
2238 * the variable MaxPicOrderCntLsb
2239 * @sps_max_dec_pic_buffering_minus1: this value plus 1 specifies the maximum
2240 * required size of the decoded picture
2241 * buffer for the codec video sequence
2242 * @sps_max_num_reorder_pics: indicates the maximum allowed number of pictures
2243 * @sps_max_latency_increase_plus1: not equal to 0 is used to compute the
2244 * value of SpsMaxLatencyPictures array
2245 * @log2_min_luma_coding_block_size_minus3: plus 3 specifies the minimum
2246 * luma coding block size
2247 * @log2_diff_max_min_luma_coding_block_size: specifies the difference between
2248 * the maximum and minimum luma
2249 * coding block size
2250 * @log2_min_luma_transform_block_size_minus2: plus 2 specifies the minimum luma
2251 * transform block size
2252 * @log2_diff_max_min_luma_transform_block_size: specifies the difference between
2253 * the maximum and minimum luma
2254 * transform block size
2255 * @max_transform_hierarchy_depth_inter: specifies the maximum hierarchy
2256 * depth for transform units of
2257 * coding units coded in inter
2258 * prediction mode
2259 * @max_transform_hierarchy_depth_intra: specifies the maximum hierarchy
2260 * depth for transform units of
2261 * coding units coded in intra
2262 * prediction mode
2263 * @pcm_sample_bit_depth_luma_minus1: this value plus 1 specifies the number of
2264 * bits used to represent each of PCM sample
2265 * values of the luma component
2266 * @pcm_sample_bit_depth_chroma_minus1: this value plus 1 specifies the number
2267 * of bits used to represent each of PCM
2268 * sample values of the chroma components
2269 * @log2_min_pcm_luma_coding_block_size_minus3: this value plus 3 specifies the
2270 * minimum size of coding blocks
2271 * @log2_diff_max_min_pcm_luma_coding_block_size: specifies the difference between
2272 * the maximum and minimum size of
2273 * coding blocks
2274 * @num_short_term_ref_pic_sets: specifies the number of st_ref_pic_set()
2275 * syntax structures included in the SPS
2276 * @num_long_term_ref_pics_sps: specifies the number of candidate long-term
2277 * reference pictures that are specified in the SPS
2278 * @chroma_format_idc: specifies the chroma sampling
2279 * @sps_max_sub_layers_minus1: this value plus 1 specifies the maximum number
2280 * of temporal sub-layers
2281 * @reserved: padding field. Should be zeroed by applications.
2282 * @flags: see V4L2_HEVC_SPS_FLAG_{}
2283 */
2284 struct v4l2_ctrl_hevc_sps {
2285 u_int8_t video_parameter_set_id;
2286 u_int8_t seq_parameter_set_id;
2287 u_int16_t pic_width_in_luma_samples;
2288 u_int16_t pic_height_in_luma_samples;
2289 u_int8_t bit_depth_luma_minus8;
2290 u_int8_t bit_depth_chroma_minus8;
2291 u_int8_t log2_max_pic_order_cnt_lsb_minus4;
2292 u_int8_t sps_max_dec_pic_buffering_minus1;
2293 u_int8_t sps_max_num_reorder_pics;
2294 u_int8_t sps_max_latency_increase_plus1;
2295 u_int8_t log2_min_luma_coding_block_size_minus3;
2296 u_int8_t log2_diff_max_min_luma_coding_block_size;
2297 u_int8_t log2_min_luma_transform_block_size_minus2;
2298 u_int8_t log2_diff_max_min_luma_transform_block_size;
2299 u_int8_t max_transform_hierarchy_depth_inter;
2300 u_int8_t max_transform_hierarchy_depth_intra;
2301 u_int8_t pcm_sample_bit_depth_luma_minus1;
2302 u_int8_t pcm_sample_bit_depth_chroma_minus1;
2303 u_int8_t log2_min_pcm_luma_coding_block_size_minus3;
2304 u_int8_t log2_diff_max_min_pcm_luma_coding_block_size;
2305 u_int8_t num_short_term_ref_pic_sets;
2306 u_int8_t num_long_term_ref_pics_sps;
2307 u_int8_t chroma_format_idc;
2308 u_int8_t sps_max_sub_layers_minus1;
2309
2310 u_int8_t reserved[6];
2311 u_int64_t flags;
2312 };
2313
2314 #define V4L2_HEVC_PPS_FLAG_DEPENDENT_SLICE_SEGMENT_ENABLED (1ULL << 0)
2315 #define V4L2_HEVC_PPS_FLAG_OUTPUT_FLAG_PRESENT (1ULL << 1)
2316 #define V4L2_HEVC_PPS_FLAG_SIGN_DATA_HIDING_ENABLED (1ULL << 2)
2317 #define V4L2_HEVC_PPS_FLAG_CABAC_INIT_PRESENT (1ULL << 3)
2318 #define V4L2_HEVC_PPS_FLAG_CONSTRAINED_INTRA_PRED (1ULL << 4)
2319 #define V4L2_HEVC_PPS_FLAG_TRANSFORM_SKIP_ENABLED (1ULL << 5)
2320 #define V4L2_HEVC_PPS_FLAG_CU_QP_DELTA_ENABLED (1ULL << 6)
2321 #define V4L2_HEVC_PPS_FLAG_PPS_SLICE_CHROMA_QP_OFFSETS_PRESENT (1ULL << 7)
2322 #define V4L2_HEVC_PPS_FLAG_WEIGHTED_PRED (1ULL << 8)
2323 #define V4L2_HEVC_PPS_FLAG_WEIGHTED_BIPRED (1ULL << 9)
2324 #define V4L2_HEVC_PPS_FLAG_TRANSQUANT_BYPASS_ENABLED (1ULL << 10)
2325 #define V4L2_HEVC_PPS_FLAG_TILES_ENABLED (1ULL << 11)
2326 #define V4L2_HEVC_PPS_FLAG_ENTROPY_CODING_SYNC_ENABLED (1ULL << 12)
2327 #define V4L2_HEVC_PPS_FLAG_LOOP_FILTER_ACROSS_TILES_ENABLED (1ULL << 13)
2328 #define V4L2_HEVC_PPS_FLAG_PPS_LOOP_FILTER_ACROSS_SLICES_ENABLED (1ULL << 14)
2329 #define V4L2_HEVC_PPS_FLAG_DEBLOCKING_FILTER_OVERRIDE_ENABLED (1ULL << 15)
2330 #define V4L2_HEVC_PPS_FLAG_PPS_DISABLE_DEBLOCKING_FILTER (1ULL << 16)
2331 #define V4L2_HEVC_PPS_FLAG_LISTS_MODIFICATION_PRESENT (1ULL << 17)
2332 #define V4L2_HEVC_PPS_FLAG_SLICE_SEGMENT_HEADER_EXTENSION_PRESENT (1ULL << 18)
2333 #define V4L2_HEVC_PPS_FLAG_DEBLOCKING_FILTER_CONTROL_PRESENT (1ULL << 19)
2334 #define V4L2_HEVC_PPS_FLAG_UNIFORM_SPACING (1ULL << 20)
2335
2336 /**
2337 * struct v4l2_ctrl_hevc_pps - ITU-T Rec. H.265: Picture parameter set
2338 *
2339 * @pic_parameter_set_id: identifies the PPS for reference by other
2340 * syntax elements
2341 * @num_extra_slice_header_bits: specifies the number of extra slice header
2342 * bits that are present in the slice header RBSP
2343 * for coded pictures referring to the PPS.
2344 * @num_ref_idx_l0_default_active_minus1: this value plus 1 specifies the
2345 * inferred value of num_ref_idx_l0_active_minus1
2346 * @num_ref_idx_l1_default_active_minus1: this value plus 1 specifies the
2347 * inferred value of num_ref_idx_l1_active_minus1
2348 * @init_qp_minus26: this value plus 26 specifies the initial value of SliceQp Y for
2349 * each slice referring to the PPS
2350 * @diff_cu_qp_delta_depth: specifies the difference between the luma coding
2351 * tree block size and the minimum luma coding block
2352 * size of coding units that convey cu_qp_delta_abs
2353 * and cu_qp_delta_sign_flag
2354 * @pps_cb_qp_offset: specify the offsets to the luma quantization parameter Cb
2355 * @pps_cr_qp_offset: specify the offsets to the luma quantization parameter Cr
2356 * @num_tile_columns_minus1: this value plus 1 specifies the number of tile columns
2357 * partitioning the picture
2358 * @num_tile_rows_minus1: this value plus 1 specifies the number of tile rows partitioning
2359 * the picture
2360 * @column_width_minus1: this value plus 1 specifies the width of the each tile column in
2361 * units of coding tree blocks
2362 * @row_height_minus1: this value plus 1 specifies the height of the each tile row in
2363 * units of coding tree blocks
2364 * @pps_beta_offset_div2: specify the default deblocking parameter offsets for
2365 * beta divided by 2
2366 * @pps_tc_offset_div2: specify the default deblocking parameter offsets for tC
2367 * divided by 2
2368 * @log2_parallel_merge_level_minus2: this value plus 2 specifies the value of
2369 * the variable Log2ParMrgLevel
2370 * @reserved: padding field. Should be zeroed by applications.
2371 * @flags: see V4L2_HEVC_PPS_FLAG_{}
2372 */
2373 struct v4l2_ctrl_hevc_pps {
2374 u_int8_t pic_parameter_set_id;
2375 u_int8_t num_extra_slice_header_bits;
2376 u_int8_t num_ref_idx_l0_default_active_minus1;
2377 u_int8_t num_ref_idx_l1_default_active_minus1;
2378 int8_t init_qp_minus26;
2379 u_int8_t diff_cu_qp_delta_depth;
2380 int8_t pps_cb_qp_offset;
2381 int8_t pps_cr_qp_offset;
2382 u_int8_t num_tile_columns_minus1;
2383 u_int8_t num_tile_rows_minus1;
2384 u_int8_t column_width_minus1[20];
2385 u_int8_t row_height_minus1[22];
2386 int8_t pps_beta_offset_div2;
2387 int8_t pps_tc_offset_div2;
2388 u_int8_t log2_parallel_merge_level_minus2;
2389 u_int8_t reserved;
2390 u_int64_t flags;
2391 };
2392
2393 #define V4L2_HEVC_DPB_ENTRY_LONG_TERM_REFERENCE 0x01
2394
2395 #define V4L2_HEVC_SEI_PIC_STRUCT_FRAME 0
2396 #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_FIELD 1
2397 #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_FIELD 2
2398 #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_BOTTOM 3
2399 #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_TOP 4
2400 #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_BOTTOM_TOP 5
2401 #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_TOP_BOTTOM 6
2402 #define V4L2_HEVC_SEI_PIC_STRUCT_FRAME_DOUBLING 7
2403 #define V4L2_HEVC_SEI_PIC_STRUCT_FRAME_TRIPLING 8
2404 #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_PAIRED_PREVIOUS_BOTTOM 9
2405 #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_PAIRED_PREVIOUS_TOP 10
2406 #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_PAIRED_NEXT_BOTTOM 11
2407 #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_PAIRED_NEXT_TOP 12
2408
2409 #define V4L2_HEVC_DPB_ENTRIES_NUM_MAX 16
2410
2411 /**
2412 * struct v4l2_hevc_dpb_entry - HEVC decoded picture buffer entry
2413 *
2414 * @timestamp: timestamp of the V4L2 capture buffer to use as reference.
2415 * @flags: long term flag for the reference frame
2416 * @field_pic: whether the reference is a field picture or a frame.
2417 * @reserved: padding field. Should be zeroed by applications.
2418 * @pic_order_cnt_val: the picture order count of the current picture.
2419 */
2420 struct v4l2_hevc_dpb_entry {
2421 u_int64_t timestamp;
2422 u_int8_t flags;
2423 u_int8_t field_pic;
2424 u_int16_t reserved;
2425 int32_t pic_order_cnt_val;
2426 };
2427
2428 /**
2429 * struct v4l2_hevc_pred_weight_table - HEVC weighted prediction parameters
2430 *
2431 * @delta_luma_weight_l0: the difference of the weighting factor applied
2432 * to the luma prediction value for list 0
2433 * @luma_offset_l0: the additive offset applied to the luma prediction value
2434 * for list 0
2435 * @delta_chroma_weight_l0: the difference of the weighting factor applied
2436 * to the chroma prediction values for list 0
2437 * @chroma_offset_l0: the difference of the additive offset applied to
2438 * the chroma prediction values for list 0
2439 * @delta_luma_weight_l1: the difference of the weighting factor applied
2440 * to the luma prediction value for list 1
2441 * @luma_offset_l1: the additive offset applied to the luma prediction value
2442 * for list 1
2443 * @delta_chroma_weight_l1: the difference of the weighting factor applied
2444 * to the chroma prediction values for list 1
2445 * @chroma_offset_l1: the difference of the additive offset applied to
2446 * the chroma prediction values for list 1
2447 * @luma_log2_weight_denom: the base 2 logarithm of the denominator for
2448 * all luma weighting factors
2449 * @delta_chroma_log2_weight_denom: the difference of the base 2 logarithm
2450 * of the denominator for all chroma
2451 * weighting factors
2452 */
2453 struct v4l2_hevc_pred_weight_table {
2454 int8_t delta_luma_weight_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2455 int8_t luma_offset_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2456 int8_t delta_chroma_weight_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2];
2457 int8_t chroma_offset_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2];
2458
2459 int8_t delta_luma_weight_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2460 int8_t luma_offset_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2461 int8_t delta_chroma_weight_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2];
2462 int8_t chroma_offset_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2];
2463
2464 u_int8_t luma_log2_weight_denom;
2465 int8_t delta_chroma_log2_weight_denom;
2466 };
2467
2468 #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_SAO_LUMA (1ULL << 0)
2469 #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_SAO_CHROMA (1ULL << 1)
2470 #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_TEMPORAL_MVP_ENABLED (1ULL << 2)
2471 #define V4L2_HEVC_SLICE_PARAMS_FLAG_MVD_L1_ZERO (1ULL << 3)
2472 #define V4L2_HEVC_SLICE_PARAMS_FLAG_CABAC_INIT (1ULL << 4)
2473 #define V4L2_HEVC_SLICE_PARAMS_FLAG_COLLOCATED_FROM_L0 (1ULL << 5)
2474 #define V4L2_HEVC_SLICE_PARAMS_FLAG_USE_INTEGER_MV (1ULL << 6)
2475 #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_DEBLOCKING_FILTER_DISABLED (1ULL << 7)
2476 #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_LOOP_FILTER_ACROSS_SLICES_ENABLED (1ULL << 8)
2477 #define V4L2_HEVC_SLICE_PARAMS_FLAG_DEPENDENT_SLICE_SEGMENT (1ULL << 9)
2478
2479 /**
2480 * struct v4l2_ctrl_hevc_slice_params - HEVC slice parameters
2481 *
2482 * This control is a dynamically sized 1-dimensional array,
2483 * V4L2_CTRL_FLAG_DYNAMIC_ARRAY flag must be set when using it.
2484 *
2485 * @bit_size: size (in bits) of the current slice data
2486 * @data_byte_offset: offset (in bytes) to the video data in the current slice data
2487 * @num_entry_point_offsets: specifies the number of entry point offset syntax
2488 * elements in the slice header.
2489 * @nal_unit_type: specifies the coding type of the slice (B, P or I)
2490 * @nuh_temporal_id_plus1: minus 1 specifies a temporal identifier for the NAL unit
2491 * @slice_type: see V4L2_HEVC_SLICE_TYPE_{}
2492 * @colour_plane_id: specifies the colour plane associated with the current slice
2493 * @slice_pic_order_cnt: specifies the picture order count
2494 * @num_ref_idx_l0_active_minus1: this value plus 1 specifies the maximum
2495 * reference index for reference picture list 0
2496 * that may be used to decode the slice
2497 * @num_ref_idx_l1_active_minus1: this value plus 1 specifies the maximum
2498 * reference index for reference picture list 1
2499 * that may be used to decode the slice
2500 * @collocated_ref_idx: specifies the reference index of the collocated picture used
2501 * for temporal motion vector prediction
2502 * @five_minus_max_num_merge_cand: specifies the maximum number of merging
2503 * motion vector prediction candidates supported in
2504 * the slice subtracted from 5
2505 * @slice_qp_delta: specifies the initial value of QpY to be used for the coding
2506 * blocks in the slice
2507 * @slice_cb_qp_offset: specifies a difference to be added to the value of pps_cb_qp_offset
2508 * @slice_cr_qp_offset: specifies a difference to be added to the value of pps_cr_qp_offset
2509 * @slice_act_y_qp_offset: screen content extension parameters
2510 * @slice_act_cb_qp_offset: screen content extension parameters
2511 * @slice_act_cr_qp_offset: screen content extension parameters
2512 * @slice_beta_offset_div2: specify the deblocking parameter offsets for beta divided by 2
2513 * @slice_tc_offset_div2: specify the deblocking parameter offsets for tC divided by 2
2514 * @pic_struct: indicates whether a picture should be displayed as a frame or as one or
2515 * more fields
2516 * @reserved0: padding field. Should be zeroed by applications.
2517 * @slice_segment_addr: specifies the address of the first coding tree block in
2518 * the slice segment
2519 * @ref_idx_l0: the list of L0 reference elements as indices in the DPB
2520 * @ref_idx_l1: the list of L1 reference elements as indices in the DPB
2521 * @short_term_ref_pic_set_size: specifies the size of short-term reference
2522 * pictures set included in the SPS
2523 * @long_term_ref_pic_set_size: specifies the size of long-term reference
2524 * pictures set include in the SPS
2525 * @pred_weight_table: the prediction weight coefficients for inter-picture
2526 * prediction
2527 * @reserved1: padding field. Should be zeroed by applications.
2528 * @flags: see V4L2_HEVC_SLICE_PARAMS_FLAG_{}
2529 */
2530 struct v4l2_ctrl_hevc_slice_params {
2531 u_int32_t bit_size;
2532 u_int32_t data_byte_offset;
2533 u_int32_t num_entry_point_offsets;
2534
2535 /* ISO/IEC 23008-2, ITU-T Rec. H.265: NAL unit header */
2536 u_int8_t nal_unit_type;
2537 u_int8_t nuh_temporal_id_plus1;
2538
2539 /* ISO/IEC 23008-2, ITU-T Rec. H.265: General slice segment header */
2540 u_int8_t slice_type;
2541 u_int8_t colour_plane_id;
2542 int32_t slice_pic_order_cnt;
2543 u_int8_t num_ref_idx_l0_active_minus1;
2544 u_int8_t num_ref_idx_l1_active_minus1;
2545 u_int8_t collocated_ref_idx;
2546 u_int8_t five_minus_max_num_merge_cand;
2547 int8_t slice_qp_delta;
2548 int8_t slice_cb_qp_offset;
2549 int8_t slice_cr_qp_offset;
2550 int8_t slice_act_y_qp_offset;
2551 int8_t slice_act_cb_qp_offset;
2552 int8_t slice_act_cr_qp_offset;
2553 int8_t slice_beta_offset_div2;
2554 int8_t slice_tc_offset_div2;
2555
2556 /* ISO/IEC 23008-2, ITU-T Rec. H.265: Picture timing SEI message */
2557 u_int8_t pic_struct;
2558
2559 u_int8_t reserved0[3];
2560 /* ISO/IEC 23008-2, ITU-T Rec. H.265: General slice segment header */
2561 u_int32_t slice_segment_addr;
2562 u_int8_t ref_idx_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2563 u_int8_t ref_idx_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2564 u_int16_t short_term_ref_pic_set_size;
2565 u_int16_t long_term_ref_pic_set_size;
2566
2567 /* ISO/IEC 23008-2, ITU-T Rec. H.265: Weighted prediction parameter */
2568 struct v4l2_hevc_pred_weight_table pred_weight_table;
2569
2570 u_int8_t reserved1[2];
2571 u_int64_t flags;
2572 };
2573
2574 #define V4L2_HEVC_DECODE_PARAM_FLAG_IRAP_PIC 0x1
2575 #define V4L2_HEVC_DECODE_PARAM_FLAG_IDR_PIC 0x2
2576 #define V4L2_HEVC_DECODE_PARAM_FLAG_NO_OUTPUT_OF_PRIOR 0x4
2577
2578 /**
2579 * struct v4l2_ctrl_hevc_decode_params - HEVC decode parameters
2580 *
2581 * @pic_order_cnt_val: picture order count
2582 * @short_term_ref_pic_set_size: specifies the size of short-term reference
2583 * pictures set included in the SPS of the first slice
2584 * @long_term_ref_pic_set_size: specifies the size of long-term reference
2585 * pictures set include in the SPS of the first slice
2586 * @num_active_dpb_entries: the number of entries in dpb
2587 * @num_poc_st_curr_before: the number of reference pictures in the short-term
2588 * set that come before the current frame
2589 * @num_poc_st_curr_after: the number of reference pictures in the short-term
2590 * set that come after the current frame
2591 * @num_poc_lt_curr: the number of reference pictures in the long-term set
2592 * @poc_st_curr_before: provides the index of the short term before references
2593 * in DPB array
2594 * @poc_st_curr_after: provides the index of the short term after references
2595 * in DPB array
2596 * @poc_lt_curr: provides the index of the long term references in DPB array
2597 * @num_delta_pocs_of_ref_rps_idx: same as the derived value NumDeltaPocs[RefRpsIdx],
2598 * can be used to parse the RPS data in slice headers
2599 * instead of skipping it with @short_term_ref_pic_set_size.
2600 * @reserved: padding field. Should be zeroed by applications.
2601 * @dpb: the decoded picture buffer, for meta-data about reference frames
2602 * @flags: see V4L2_HEVC_DECODE_PARAM_FLAG_{}
2603 */
2604 struct v4l2_ctrl_hevc_decode_params {
2605 int32_t pic_order_cnt_val;
2606 u_int16_t short_term_ref_pic_set_size;
2607 u_int16_t long_term_ref_pic_set_size;
2608 u_int8_t num_active_dpb_entries;
2609 u_int8_t num_poc_st_curr_before;
2610 u_int8_t num_poc_st_curr_after;
2611 u_int8_t num_poc_lt_curr;
2612 u_int8_t poc_st_curr_before[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2613 u_int8_t poc_st_curr_after[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2614 u_int8_t poc_lt_curr[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2615 u_int8_t num_delta_pocs_of_ref_rps_idx;
2616 u_int8_t reserved[3];
2617 struct v4l2_hevc_dpb_entry dpb[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2618 u_int64_t flags;
2619 };
2620
2621 /**
2622 * struct v4l2_ctrl_hevc_scaling_matrix - HEVC scaling lists parameters
2623 *
2624 * @scaling_list_4x4: scaling list is used for the scaling process for
2625 * transform coefficients. The values on each scaling
2626 * list are expected in raster scan order
2627 * @scaling_list_8x8: scaling list is used for the scaling process for
2628 * transform coefficients. The values on each scaling
2629 * list are expected in raster scan order
2630 * @scaling_list_16x16: scaling list is used for the scaling process for
2631 * transform coefficients. The values on each scaling
2632 * list are expected in raster scan order
2633 * @scaling_list_32x32: scaling list is used for the scaling process for
2634 * transform coefficients. The values on each scaling
2635 * list are expected in raster scan order
2636 * @scaling_list_dc_coef_16x16: scaling list is used for the scaling process
2637 * for transform coefficients. The values on each
2638 * scaling list are expected in raster scan order.
2639 * @scaling_list_dc_coef_32x32: scaling list is used for the scaling process
2640 * for transform coefficients. The values on each
2641 * scaling list are expected in raster scan order.
2642 */
2643 struct v4l2_ctrl_hevc_scaling_matrix {
2644 u_int8_t scaling_list_4x4[6][16];
2645 u_int8_t scaling_list_8x8[6][64];
2646 u_int8_t scaling_list_16x16[6][64];
2647 u_int8_t scaling_list_32x32[2][64];
2648 u_int8_t scaling_list_dc_coef_16x16[6];
2649 u_int8_t scaling_list_dc_coef_32x32[2];
2650 };
2651
2652 #define V4L2_CID_COLORIMETRY_CLASS_BASE (V4L2_CTRL_CLASS_COLORIMETRY | 0x900)
2653 #define V4L2_CID_COLORIMETRY_CLASS (V4L2_CTRL_CLASS_COLORIMETRY | 1)
2654
2655 #define V4L2_CID_COLORIMETRY_HDR10_CLL_INFO (V4L2_CID_COLORIMETRY_CLASS_BASE + 0)
2656
2657 struct v4l2_ctrl_hdr10_cll_info {
2658 u_int16_t max_content_light_level;
2659 u_int16_t max_pic_average_light_level;
2660 };
2661
2662 #define V4L2_CID_COLORIMETRY_HDR10_MASTERING_DISPLAY (V4L2_CID_COLORIMETRY_CLASS_BASE + 1)
2663
2664 #define V4L2_HDR10_MASTERING_PRIMARIES_X_LOW 5
2665 #define V4L2_HDR10_MASTERING_PRIMARIES_X_HIGH 37000
2666 #define V4L2_HDR10_MASTERING_PRIMARIES_Y_LOW 5
2667 #define V4L2_HDR10_MASTERING_PRIMARIES_Y_HIGH 42000
2668 #define V4L2_HDR10_MASTERING_WHITE_POINT_X_LOW 5
2669 #define V4L2_HDR10_MASTERING_WHITE_POINT_X_HIGH 37000
2670 #define V4L2_HDR10_MASTERING_WHITE_POINT_Y_LOW 5
2671 #define V4L2_HDR10_MASTERING_WHITE_POINT_Y_HIGH 42000
2672 #define V4L2_HDR10_MASTERING_MAX_LUMA_LOW 50000
2673 #define V4L2_HDR10_MASTERING_MAX_LUMA_HIGH 100000000
2674 #define V4L2_HDR10_MASTERING_MIN_LUMA_LOW 1
2675 #define V4L2_HDR10_MASTERING_MIN_LUMA_HIGH 50000
2676
2677 struct v4l2_ctrl_hdr10_mastering_display {
2678 u_int16_t display_primaries_x[3];
2679 u_int16_t display_primaries_y[3];
2680 u_int16_t white_point_x;
2681 u_int16_t white_point_y;
2682 u_int32_t max_display_mastering_luminance;
2683 u_int32_t min_display_mastering_luminance;
2684 };
2685
2686 /* Stateless VP9 controls */
2687
2688 #define V4L2_VP9_LOOP_FILTER_FLAG_DELTA_ENABLED 0x1
2689 #define V4L2_VP9_LOOP_FILTER_FLAG_DELTA_UPDATE 0x2
2690
2691 /**
2692 * struct v4l2_vp9_loop_filter - VP9 loop filter parameters
2693 *
2694 * @ref_deltas: contains the adjustment needed for the filter level based on the
2695 * chosen reference frame. If this syntax element is not present in the bitstream,
2696 * users should pass its last value.
2697 * @mode_deltas: contains the adjustment needed for the filter level based on the
2698 * chosen mode. If this syntax element is not present in the bitstream, users should
2699 * pass its last value.
2700 * @level: indicates the loop filter strength.
2701 * @sharpness: indicates the sharpness level.
2702 * @flags: combination of V4L2_VP9_LOOP_FILTER_FLAG_{} flags.
2703 * @reserved: padding field. Should be zeroed by applications.
2704 *
2705 * This structure contains all loop filter related parameters. See sections
2706 * '7.2.8 Loop filter semantics' of the VP9 specification for more details.
2707 */
2708 struct v4l2_vp9_loop_filter {
2709 int8_t ref_deltas[4];
2710 int8_t mode_deltas[2];
2711 u_int8_t level;
2712 u_int8_t sharpness;
2713 u_int8_t flags;
2714 u_int8_t reserved[7];
2715 };
2716
2717 /**
2718 * struct v4l2_vp9_quantization - VP9 quantization parameters
2719 *
2720 * @base_q_idx: indicates the base frame qindex.
2721 * @delta_q_y_dc: indicates the Y DC quantizer relative to base_q_idx.
2722 * @delta_q_uv_dc: indicates the UV DC quantizer relative to base_q_idx.
2723 * @delta_q_uv_ac: indicates the UV AC quantizer relative to base_q_idx.
2724 * @reserved: padding field. Should be zeroed by applications.
2725 *
2726 * Encodes the quantization parameters. See section '7.2.9 Quantization params
2727 * syntax' of the VP9 specification for more details.
2728 */
2729 struct v4l2_vp9_quantization {
2730 u_int8_t base_q_idx;
2731 int8_t delta_q_y_dc;
2732 int8_t delta_q_uv_dc;
2733 int8_t delta_q_uv_ac;
2734 u_int8_t reserved[4];
2735 };
2736
2737 #define V4L2_VP9_SEGMENTATION_FLAG_ENABLED 0x01
2738 #define V4L2_VP9_SEGMENTATION_FLAG_UPDATE_MAP 0x02
2739 #define V4L2_VP9_SEGMENTATION_FLAG_TEMPORAL_UPDATE 0x04
2740 #define V4L2_VP9_SEGMENTATION_FLAG_UPDATE_DATA 0x08
2741 #define V4L2_VP9_SEGMENTATION_FLAG_ABS_OR_DELTA_UPDATE 0x10
2742
2743 #define V4L2_VP9_SEG_LVL_ALT_Q 0
2744 #define V4L2_VP9_SEG_LVL_ALT_L 1
2745 #define V4L2_VP9_SEG_LVL_REF_FRAME 2
2746 #define V4L2_VP9_SEG_LVL_SKIP 3
2747 #define V4L2_VP9_SEG_LVL_MAX 4
2748
2749 #define V4L2_VP9_SEGMENT_FEATURE_ENABLED(id) (1 << (id))
2750 #define V4L2_VP9_SEGMENT_FEATURE_ENABLED_MASK 0xf
2751
2752 /**
2753 * struct v4l2_vp9_segmentation - VP9 segmentation parameters
2754 *
2755 * @feature_data: data attached to each feature. Data entry is only valid if
2756 * the feature is enabled. The array shall be indexed with segment number as
2757 * the first dimension (0..7) and one of V4L2_VP9_SEG_{} as the second dimension.
2758 * @feature_enabled: bitmask defining which features are enabled in each segment.
2759 * The value for each segment is a combination of V4L2_VP9_SEGMENT_FEATURE_ENABLED(id)
2760 * values where id is one of V4L2_VP9_SEG_LVL_{}.
2761 * @tree_probs: specifies the probability values to be used when decoding a
2762 * Segment-ID. See '5.15. Segmentation map' section of the VP9 specification
2763 * for more details.
2764 * @pred_probs: specifies the probability values to be used when decoding a
2765 * Predicted-Segment-ID. See '6.4.14. Get segment id syntax' section of :ref:`vp9`
2766 * for more details.
2767 * @flags: combination of V4L2_VP9_SEGMENTATION_FLAG_{} flags.
2768 * @reserved: padding field. Should be zeroed by applications.
2769 *
2770 * Encodes the quantization parameters. See section '7.2.10 Segmentation params syntax' of
2771 * the VP9 specification for more details.
2772 */
2773 struct v4l2_vp9_segmentation {
2774 int16_t feature_data[8][4];
2775 u_int8_t feature_enabled[8];
2776 u_int8_t tree_probs[7];
2777 u_int8_t pred_probs[3];
2778 u_int8_t flags;
2779 u_int8_t reserved[5];
2780 };
2781
2782 #define V4L2_VP9_FRAME_FLAG_KEY_FRAME 0x001
2783 #define V4L2_VP9_FRAME_FLAG_SHOW_FRAME 0x002
2784 #define V4L2_VP9_FRAME_FLAG_ERROR_RESILIENT 0x004
2785 #define V4L2_VP9_FRAME_FLAG_INTRA_ONLY 0x008
2786 #define V4L2_VP9_FRAME_FLAG_ALLOW_HIGH_PREC_MV 0x010
2787 #define V4L2_VP9_FRAME_FLAG_REFRESH_FRAME_CTX 0x020
2788 #define V4L2_VP9_FRAME_FLAG_PARALLEL_DEC_MODE 0x040
2789 #define V4L2_VP9_FRAME_FLAG_X_SUBSAMPLING 0x080
2790 #define V4L2_VP9_FRAME_FLAG_Y_SUBSAMPLING 0x100
2791 #define V4L2_VP9_FRAME_FLAG_COLOR_RANGE_FULL_SWING 0x200
2792
2793 #define V4L2_VP9_SIGN_BIAS_LAST 0x1
2794 #define V4L2_VP9_SIGN_BIAS_GOLDEN 0x2
2795 #define V4L2_VP9_SIGN_BIAS_ALT 0x4
2796
2797 #define V4L2_VP9_RESET_FRAME_CTX_NONE 0
2798 #define V4L2_VP9_RESET_FRAME_CTX_SPEC 1
2799 #define V4L2_VP9_RESET_FRAME_CTX_ALL 2
2800
2801 #define V4L2_VP9_INTERP_FILTER_EIGHTTAP 0
2802 #define V4L2_VP9_INTERP_FILTER_EIGHTTAP_SMOOTH 1
2803 #define V4L2_VP9_INTERP_FILTER_EIGHTTAP_SHARP 2
2804 #define V4L2_VP9_INTERP_FILTER_BILINEAR 3
2805 #define V4L2_VP9_INTERP_FILTER_SWITCHABLE 4
2806
2807 #define V4L2_VP9_REFERENCE_MODE_SINGLE_REFERENCE 0
2808 #define V4L2_VP9_REFERENCE_MODE_COMPOUND_REFERENCE 1
2809 #define V4L2_VP9_REFERENCE_MODE_SELECT 2
2810
2811 #define V4L2_VP9_PROFILE_MAX 3
2812
2813 #define V4L2_CID_STATELESS_VP9_FRAME (V4L2_CID_CODEC_STATELESS_BASE + 300)
2814 /**
2815 * struct v4l2_ctrl_vp9_frame - VP9 frame decoding control
2816 *
2817 * @lf: loop filter parameters. See &v4l2_vp9_loop_filter for more details.
2818 * @quant: quantization parameters. See &v4l2_vp9_quantization for more details.
2819 * @seg: segmentation parameters. See &v4l2_vp9_segmentation for more details.
2820 * @flags: combination of V4L2_VP9_FRAME_FLAG_{} flags.
2821 * @compressed_header_size: compressed header size in bytes.
2822 * @uncompressed_header_size: uncompressed header size in bytes.
2823 * @frame_width_minus_1: add 1 to it and you'll get the frame width expressed in pixels.
2824 * @frame_height_minus_1: add 1 to it and you'll get the frame height expressed in pixels.
2825 * @render_width_minus_1: add 1 to it and you'll get the expected render width expressed in
2826 * pixels. This is not used during the decoding process but might be used by HW scalers
2827 * to prepare a frame that's ready for scanout.
2828 * @render_height_minus_1: add 1 to it and you'll get the expected render height expressed in
2829 * pixels. This is not used during the decoding process but might be used by HW scalers
2830 * to prepare a frame that's ready for scanout.
2831 * @last_frame_ts: "last" reference buffer timestamp.
2832 * The timestamp refers to the timestamp field in struct v4l2_buffer.
2833 * Use v4l2_timeval_to_ns() to convert the struct timeval to a u_int64_t.
2834 * @golden_frame_ts: "golden" reference buffer timestamp.
2835 * The timestamp refers to the timestamp field in struct v4l2_buffer.
2836 * Use v4l2_timeval_to_ns() to convert the struct timeval to a u_int64_t.
2837 * @alt_frame_ts: "alt" reference buffer timestamp.
2838 * The timestamp refers to the timestamp field in struct v4l2_buffer.
2839 * Use v4l2_timeval_to_ns() to convert the struct timeval to a u_int64_t.
2840 * @ref_frame_sign_bias: a bitfield specifying whether the sign bias is set for a given
2841 * reference frame. Either of V4L2_VP9_SIGN_BIAS_{}.
2842 * @reset_frame_context: specifies whether the frame context should be reset to default values.
2843 * Either of V4L2_VP9_RESET_FRAME_CTX_{}.
2844 * @frame_context_idx: frame context that should be used/updated.
2845 * @profile: VP9 profile. Can be 0, 1, 2 or 3.
2846 * @bit_depth: bits per components. Can be 8, 10 or 12. Note that not all profiles support
2847 * 10 and/or 12 bits depths.
2848 * @interpolation_filter: specifies the filter selection used for performing inter prediction.
2849 * Set to one of V4L2_VP9_INTERP_FILTER_{}.
2850 * @tile_cols_log2: specifies the base 2 logarithm of the width of each tile (where the width
2851 * is measured in units of 8x8 blocks). Shall be less than or equal to 6.
2852 * @tile_rows_log2: specifies the base 2 logarithm of the height of each tile (where the height
2853 * is measured in units of 8x8 blocks).
2854 * @reference_mode: specifies the type of inter prediction to be used.
2855 * Set to one of V4L2_VP9_REFERENCE_MODE_{}.
2856 * @reserved: padding field. Should be zeroed by applications.
2857 */
2858 struct v4l2_ctrl_vp9_frame {
2859 struct v4l2_vp9_loop_filter lf;
2860 struct v4l2_vp9_quantization quant;
2861 struct v4l2_vp9_segmentation seg;
2862 u_int32_t flags;
2863 u_int16_t compressed_header_size;
2864 u_int16_t uncompressed_header_size;
2865 u_int16_t frame_width_minus_1;
2866 u_int16_t frame_height_minus_1;
2867 u_int16_t render_width_minus_1;
2868 u_int16_t render_height_minus_1;
2869 u_int64_t last_frame_ts;
2870 u_int64_t golden_frame_ts;
2871 u_int64_t alt_frame_ts;
2872 u_int8_t ref_frame_sign_bias;
2873 u_int8_t reset_frame_context;
2874 u_int8_t frame_context_idx;
2875 u_int8_t profile;
2876 u_int8_t bit_depth;
2877 u_int8_t interpolation_filter;
2878 u_int8_t tile_cols_log2;
2879 u_int8_t tile_rows_log2;
2880 u_int8_t reference_mode;
2881 u_int8_t reserved[7];
2882 };
2883
2884 #define V4L2_VP9_NUM_FRAME_CTX 4
2885
2886 /**
2887 * struct v4l2_vp9_mv_probs - VP9 Motion vector probability updates
2888 * @joint: motion vector joint probability updates.
2889 * @sign: motion vector sign probability updates.
2890 * @classes: motion vector class probability updates.
2891 * @class0_bit: motion vector class0 bit probability updates.
2892 * @bits: motion vector bits probability updates.
2893 * @class0_fr: motion vector class0 fractional bit probability updates.
2894 * @fr: motion vector fractional bit probability updates.
2895 * @class0_hp: motion vector class0 high precision fractional bit probability updates.
2896 * @hp: motion vector high precision fractional bit probability updates.
2897 *
2898 * This structure contains new values of motion vector probabilities.
2899 * A value of zero in an array element means there is no update of the relevant probability.
2900 * See `struct v4l2_vp9_prob_updates` for details.
2901 */
2902 struct v4l2_vp9_mv_probs {
2903 u_int8_t joint[3];
2904 u_int8_t sign[2];
2905 u_int8_t classes[2][10];
2906 u_int8_t class0_bit[2];
2907 u_int8_t bits[2][10];
2908 u_int8_t class0_fr[2][2][3];
2909 u_int8_t fr[2][3];
2910 u_int8_t class0_hp[2];
2911 u_int8_t hp[2];
2912 };
2913
2914 #define V4L2_CID_STATELESS_VP9_COMPRESSED_HDR (V4L2_CID_CODEC_STATELESS_BASE + 301)
2915
2916 #define V4L2_VP9_TX_MODE_ONLY_4X4 0
2917 #define V4L2_VP9_TX_MODE_ALLOW_8X8 1
2918 #define V4L2_VP9_TX_MODE_ALLOW_16X16 2
2919 #define V4L2_VP9_TX_MODE_ALLOW_32X32 3
2920 #define V4L2_VP9_TX_MODE_SELECT 4
2921
2922 /**
2923 * struct v4l2_ctrl_vp9_compressed_hdr - VP9 probability updates control
2924 * @tx_mode: specifies the TX mode. Set to one of V4L2_VP9_TX_MODE_{}.
2925 * @tx8: TX 8x8 probability updates.
2926 * @tx16: TX 16x16 probability updates.
2927 * @tx32: TX 32x32 probability updates.
2928 * @coef: coefficient probability updates.
2929 * @skip: skip probability updates.
2930 * @inter_mode: inter mode probability updates.
2931 * @interp_filter: interpolation filter probability updates.
2932 * @is_inter: is inter-block probability updates.
2933 * @comp_mode: compound prediction mode probability updates.
2934 * @single_ref: single ref probability updates.
2935 * @comp_ref: compound ref probability updates.
2936 * @y_mode: Y prediction mode probability updates.
2937 * @uv_mode: UV prediction mode probability updates.
2938 * @partition: partition probability updates.
2939 * @mv: motion vector probability updates.
2940 *
2941 * This structure holds the probabilities update as parsed in the compressed
2942 * header (Spec 6.3). These values represent the value of probability update after
2943 * being translated with inv_map_table[] (see 6.3.5). A value of zero in an array element
2944 * means that there is no update of the relevant probability.
2945 *
2946 * This control is optional and needs to be used when dealing with the hardware which is
2947 * not capable of parsing the compressed header itself. Only drivers which need it will
2948 * implement it.
2949 */
2950 struct v4l2_ctrl_vp9_compressed_hdr {
2951 u_int8_t tx_mode;
2952 u_int8_t tx8[2][1];
2953 u_int8_t tx16[2][2];
2954 u_int8_t tx32[2][3];
2955 u_int8_t coef[4][2][2][6][6][3];
2956 u_int8_t skip[3];
2957 u_int8_t inter_mode[7][3];
2958 u_int8_t interp_filter[4][2];
2959 u_int8_t is_inter[4];
2960 u_int8_t comp_mode[5];
2961 u_int8_t single_ref[5][2];
2962 u_int8_t comp_ref[5];
2963 u_int8_t y_mode[4][9];
2964 u_int8_t uv_mode[10][9];
2965 u_int8_t partition[16][3];
2966
2967 struct v4l2_vp9_mv_probs mv;
2968 };
2969
2970 /* Stateless AV1 controls */
2971
2972 #define V4L2_AV1_TOTAL_REFS_PER_FRAME 8
2973 #define V4L2_AV1_CDEF_MAX 8
2974 #define V4L2_AV1_NUM_PLANES_MAX 3 /* 1 if monochrome, 3 otherwise */
2975 #define V4L2_AV1_MAX_SEGMENTS 8
2976 #define V4L2_AV1_MAX_OPERATING_POINTS (1 << 5) /* 5 bits to encode */
2977 #define V4L2_AV1_REFS_PER_FRAME 7
2978 #define V4L2_AV1_MAX_NUM_Y_POINTS (1 << 4) /* 4 bits to encode */
2979 #define V4L2_AV1_MAX_NUM_CB_POINTS (1 << 4) /* 4 bits to encode */
2980 #define V4L2_AV1_MAX_NUM_CR_POINTS (1 << 4) /* 4 bits to encode */
2981 #define V4L2_AV1_AR_COEFFS_SIZE 25 /* (2 * 3 * (3 + 1)) + 1 */
2982 #define V4L2_AV1_MAX_NUM_PLANES 3
2983 #define V4L2_AV1_MAX_TILE_COLS 64
2984 #define V4L2_AV1_MAX_TILE_ROWS 64
2985 #define V4L2_AV1_MAX_TILE_COUNT 512
2986
2987 #define V4L2_AV1_SEQUENCE_FLAG_STILL_PICTURE 0x00000001
2988 #define V4L2_AV1_SEQUENCE_FLAG_USE_128X128_SUPERBLOCK 0x00000002
2989 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_FILTER_INTRA 0x00000004
2990 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_INTRA_EDGE_FILTER 0x00000008
2991 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_INTERINTRA_COMPOUND 0x00000010
2992 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_MASKED_COMPOUND 0x00000020
2993 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_WARPED_MOTION 0x00000040
2994 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_DUAL_FILTER 0x00000080
2995 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_ORDER_HINT 0x00000100
2996 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_JNT_COMP 0x00000200
2997 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_REF_FRAME_MVS 0x00000400
2998 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_SUPERRES 0x00000800
2999 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_CDEF 0x00001000
3000 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_RESTORATION 0x00002000
3001 #define V4L2_AV1_SEQUENCE_FLAG_MONO_CHROME 0x00004000
3002 #define V4L2_AV1_SEQUENCE_FLAG_COLOR_RANGE 0x00008000
3003 #define V4L2_AV1_SEQUENCE_FLAG_SUBSAMPLING_X 0x00010000
3004 #define V4L2_AV1_SEQUENCE_FLAG_SUBSAMPLING_Y 0x00020000
3005 #define V4L2_AV1_SEQUENCE_FLAG_FILM_GRAIN_PARAMS_PRESENT 0x00040000
3006 #define V4L2_AV1_SEQUENCE_FLAG_SEPARATE_UV_DELTA_Q 0x00080000
3007
3008 #define V4L2_CID_STATELESS_AV1_SEQUENCE (V4L2_CID_CODEC_STATELESS_BASE + 500)
3009 /**
3010 * struct v4l2_ctrl_av1_sequence - AV1 Sequence
3011 *
3012 * Represents an AV1 Sequence OBU. See section 5.5 "Sequence header OBU syntax"
3013 * for more details.
3014 *
3015 * @flags: See V4L2_AV1_SEQUENCE_FLAG_{}.
3016 * @seq_profile: specifies the features that can be used in the coded video
3017 * sequence.
3018 * @order_hint_bits: specifies the number of bits used for the order_hint field
3019 * at each frame.
3020 * @bit_depth: the bitdepth to use for the sequence as described in section
3021 * 5.5.2 "Color config syntax".
3022 * @reserved: padding field. Should be zeroed by applications.
3023 * @max_frame_width_minus_1: specifies the maximum frame width minus 1 for the
3024 * frames represented by this sequence header.
3025 * @max_frame_height_minus_1: specifies the maximum frame height minus 1 for the
3026 * frames represented by this sequence header.
3027 */
3028 struct v4l2_ctrl_av1_sequence {
3029 u_int32_t flags;
3030 u_int8_t seq_profile;
3031 u_int8_t order_hint_bits;
3032 u_int8_t bit_depth;
3033 u_int8_t reserved;
3034 u_int16_t max_frame_width_minus_1;
3035 u_int16_t max_frame_height_minus_1;
3036 };
3037
3038 #define V4L2_CID_STATELESS_AV1_TILE_GROUP_ENTRY (V4L2_CID_CODEC_STATELESS_BASE + 501)
3039 /**
3040 * struct v4l2_ctrl_av1_tile_group_entry - AV1 Tile Group entry
3041 *
3042 * Represents a single AV1 tile inside an AV1 Tile Group. Note that MiRowStart,
3043 * MiRowEnd, MiColStart and MiColEnd can be retrieved from struct
3044 * v4l2_av1_tile_info in struct v4l2_ctrl_av1_frame using tile_row and
3045 * tile_col. See section 6.10.1 "General tile group OBU semantics" for more
3046 * details.
3047 *
3048 * @tile_offset: offset from the OBU data, i.e. where the coded tile data
3049 * actually starts.
3050 * @tile_size: specifies the size in bytes of the coded tile. Equivalent to
3051 * "TileSize" in the AV1 Specification.
3052 * @tile_row: specifies the row of the current tile. Equivalent to "TileRow" in
3053 * the AV1 Specification.
3054 * @tile_col: specifies the col of the current tile. Equivalent to "TileCol" in
3055 * the AV1 Specification.
3056 */
3057 struct v4l2_ctrl_av1_tile_group_entry {
3058 u_int32_t tile_offset;
3059 u_int32_t tile_size;
3060 u_int32_t tile_row;
3061 u_int32_t tile_col;
3062 };
3063
3064 /**
3065 * enum v4l2_av1_warp_model - AV1 Warp Model as described in section 3
3066 * "Symbols and abbreviated terms" of the AV1 Specification.
3067 *
3068 * @V4L2_AV1_WARP_MODEL_IDENTITY: Warp model is just an identity transform.
3069 * @V4L2_AV1_WARP_MODEL_TRANSLATION: Warp model is a pure translation.
3070 * @V4L2_AV1_WARP_MODEL_ROTZOOM: Warp model is a rotation + symmetric zoom +
3071 * translation.
3072 * @V4L2_AV1_WARP_MODEL_AFFINE: Warp model is a general affine transform.
3073 */
3074 enum v4l2_av1_warp_model {
3075 V4L2_AV1_WARP_MODEL_IDENTITY = 0,
3076 V4L2_AV1_WARP_MODEL_TRANSLATION = 1,
3077 V4L2_AV1_WARP_MODEL_ROTZOOM = 2,
3078 V4L2_AV1_WARP_MODEL_AFFINE = 3,
3079 };
3080
3081 /**
3082 * enum v4l2_av1_reference_frame - AV1 reference frames
3083 *
3084 * @V4L2_AV1_REF_INTRA_FRAME: Intra Frame Reference
3085 * @V4L2_AV1_REF_LAST_FRAME: Last Reference Frame
3086 * @V4L2_AV1_REF_LAST2_FRAME: Last2 Reference Frame
3087 * @V4L2_AV1_REF_LAST3_FRAME: Last3 Reference Frame
3088 * @V4L2_AV1_REF_GOLDEN_FRAME: Golden Reference Frame
3089 * @V4L2_AV1_REF_BWDREF_FRAME: BWD Reference Frame
3090 * @V4L2_AV1_REF_ALTREF2_FRAME: Alternative2 Reference Frame
3091 * @V4L2_AV1_REF_ALTREF_FRAME: Alternative Reference Frame
3092 */
3093 enum v4l2_av1_reference_frame {
3094 V4L2_AV1_REF_INTRA_FRAME = 0,
3095 V4L2_AV1_REF_LAST_FRAME = 1,
3096 V4L2_AV1_REF_LAST2_FRAME = 2,
3097 V4L2_AV1_REF_LAST3_FRAME = 3,
3098 V4L2_AV1_REF_GOLDEN_FRAME = 4,
3099 V4L2_AV1_REF_BWDREF_FRAME = 5,
3100 V4L2_AV1_REF_ALTREF2_FRAME = 6,
3101 V4L2_AV1_REF_ALTREF_FRAME = 7,
3102 };
3103
3104 #define V4L2_AV1_GLOBAL_MOTION_IS_INVALID(ref) (1 << (ref))
3105
3106 #define V4L2_AV1_GLOBAL_MOTION_FLAG_IS_GLOBAL 0x1
3107 #define V4L2_AV1_GLOBAL_MOTION_FLAG_IS_ROT_ZOOM 0x2
3108 #define V4L2_AV1_GLOBAL_MOTION_FLAG_IS_TRANSLATION 0x4
3109 /**
3110 * struct v4l2_av1_global_motion - AV1 Global Motion parameters as described in
3111 * section 6.8.17 "Global motion params semantics" of the AV1 specification.
3112 *
3113 * @flags: A bitfield containing the flags per reference frame. See
3114 * V4L2_AV1_GLOBAL_MOTION_FLAG_{}
3115 * @type: The type of global motion transform used.
3116 * @params: this field has the same meaning as "gm_params" in the AV1
3117 * specification.
3118 * @invalid: bitfield indicating whether the global motion params are invalid
3119 * for a given reference frame. See section 7.11.3.6 Setup shear process and
3120 * the variable "warpValid". Use V4L2_AV1_GLOBAL_MOTION_IS_INVALID(ref) to
3121 * create a suitable mask.
3122 * @reserved: padding field. Should be zeroed by applications.
3123 */
3124
3125 struct v4l2_av1_global_motion {
3126 u_int8_t flags[V4L2_AV1_TOTAL_REFS_PER_FRAME];
3127 enum v4l2_av1_warp_model type[V4L2_AV1_TOTAL_REFS_PER_FRAME];
3128 int32_t params[V4L2_AV1_TOTAL_REFS_PER_FRAME][6];
3129 u_int8_t invalid;
3130 u_int8_t reserved[3];
3131 };
3132
3133 /**
3134 * enum v4l2_av1_frame_restoration_type - AV1 Frame Restoration Type
3135 * @V4L2_AV1_FRAME_RESTORE_NONE: no filtering is applied.
3136 * @V4L2_AV1_FRAME_RESTORE_WIENER: Wiener filter process is invoked.
3137 * @V4L2_AV1_FRAME_RESTORE_SGRPROJ: self guided filter process is invoked.
3138 * @V4L2_AV1_FRAME_RESTORE_SWITCHABLE: restoration filter is swichtable.
3139 */
3140 enum v4l2_av1_frame_restoration_type {
3141 V4L2_AV1_FRAME_RESTORE_NONE = 0,
3142 V4L2_AV1_FRAME_RESTORE_WIENER = 1,
3143 V4L2_AV1_FRAME_RESTORE_SGRPROJ = 2,
3144 V4L2_AV1_FRAME_RESTORE_SWITCHABLE = 3,
3145 };
3146
3147 #define V4L2_AV1_LOOP_RESTORATION_FLAG_USES_LR 0x1
3148 #define V4L2_AV1_LOOP_RESTORATION_FLAG_USES_CHROMA_LR 0x2
3149
3150 /**
3151 * struct v4l2_av1_loop_restoration - AV1 Loop Restauration as described in
3152 * section 6.10.15 "Loop restoration params semantics" of the AV1 specification.
3153 *
3154 * @flags: See V4L2_AV1_LOOP_RESTORATION_FLAG_{}.
3155 * @lr_unit_shift: specifies if the luma restoration size should be halved.
3156 * @lr_uv_shift: specifies if the chroma size should be half the luma size.
3157 * @reserved: padding field. Should be zeroed by applications.
3158 * @frame_restoration_type: specifies the type of restoration used for each
3159 * plane. See enum v4l2_av1_frame_restoration_type.
3160 * @loop_restoration_size: specifies the size of loop restoration units in units
3161 * of samples in the current plane.
3162 */
3163 struct v4l2_av1_loop_restoration {
3164 u_int8_t flags;
3165 u_int8_t lr_unit_shift;
3166 u_int8_t lr_uv_shift;
3167 u_int8_t reserved;
3168 enum v4l2_av1_frame_restoration_type frame_restoration_type[V4L2_AV1_NUM_PLANES_MAX];
3169 u_int32_t loop_restoration_size[V4L2_AV1_MAX_NUM_PLANES];
3170 };
3171
3172 /**
3173 * struct v4l2_av1_cdef - AV1 CDEF params semantics as described in section
3174 * 6.10.14 "CDEF params semantics" of the AV1 specification
3175 *
3176 * @damping_minus_3: controls the amount of damping in the deringing filter.
3177 * @bits: specifies the number of bits needed to specify which CDEF filter to
3178 * apply.
3179 * @y_pri_strength: specifies the strength of the primary filter.
3180 * @y_sec_strength: specifies the strength of the secondary filter.
3181 * @uv_pri_strength: specifies the strength of the primary filter.
3182 * @uv_sec_strength: specifies the strength of the secondary filter.
3183 */
3184 struct v4l2_av1_cdef {
3185 u_int8_t damping_minus_3;
3186 u_int8_t bits;
3187 u_int8_t y_pri_strength[V4L2_AV1_CDEF_MAX];
3188 u_int8_t y_sec_strength[V4L2_AV1_CDEF_MAX];
3189 u_int8_t uv_pri_strength[V4L2_AV1_CDEF_MAX];
3190 u_int8_t uv_sec_strength[V4L2_AV1_CDEF_MAX];
3191 };
3192
3193 #define V4L2_AV1_SEGMENTATION_FLAG_ENABLED 0x1
3194 #define V4L2_AV1_SEGMENTATION_FLAG_UPDATE_MAP 0x2
3195 #define V4L2_AV1_SEGMENTATION_FLAG_TEMPORAL_UPDATE 0x4
3196 #define V4L2_AV1_SEGMENTATION_FLAG_UPDATE_DATA 0x8
3197 #define V4L2_AV1_SEGMENTATION_FLAG_SEG_ID_PRE_SKIP 0x10
3198
3199 /**
3200 * enum v4l2_av1_segment_feature - AV1 segment features as described in section
3201 * 3 "Symbols and abbreviated terms" of the AV1 specification.
3202 *
3203 * @V4L2_AV1_SEG_LVL_ALT_Q: Index for quantizer segment feature.
3204 * @V4L2_AV1_SEG_LVL_ALT_LF_Y_V: Index for vertical luma loop filter segment
3205 * feature.
3206 * @V4L2_AV1_SEG_LVL_REF_FRAME: Index for reference frame segment feature.
3207 * @V4L2_AV1_SEG_LVL_REF_SKIP: Index for skip segment feature.
3208 * @V4L2_AV1_SEG_LVL_REF_GLOBALMV: Index for global mv feature.
3209 * @V4L2_AV1_SEG_LVL_MAX: Number of segment features.
3210 */
3211 enum v4l2_av1_segment_feature {
3212 V4L2_AV1_SEG_LVL_ALT_Q = 0,
3213 V4L2_AV1_SEG_LVL_ALT_LF_Y_V = 1,
3214 V4L2_AV1_SEG_LVL_REF_FRAME = 5,
3215 V4L2_AV1_SEG_LVL_REF_SKIP = 6,
3216 V4L2_AV1_SEG_LVL_REF_GLOBALMV = 7,
3217 V4L2_AV1_SEG_LVL_MAX = 8
3218 };
3219
3220 #define V4L2_AV1_SEGMENT_FEATURE_ENABLED(id) (1 << (id))
3221
3222 /**
3223 * struct v4l2_av1_segmentation - AV1 Segmentation params as defined in section
3224 * 6.8.13 "Segmentation params semantics" of the AV1 specification.
3225 *
3226 * @flags: see V4L2_AV1_SEGMENTATION_FLAG_{}.
3227 * @last_active_seg_id: indicates the highest numbered segment id that has some
3228 * enabled feature. This is used when decoding the segment id to only decode
3229 * choices corresponding to used segments.
3230 * @feature_enabled: bitmask defining which features are enabled in each
3231 * segment. Use V4L2_AV1_SEGMENT_FEATURE_ENABLED to build a suitable mask.
3232 * @feature_data: data attached to each feature. Data entry is only valid if the
3233 * feature is enabled
3234 */
3235 struct v4l2_av1_segmentation {
3236 u_int8_t flags;
3237 u_int8_t last_active_seg_id;
3238 u_int8_t feature_enabled[V4L2_AV1_MAX_SEGMENTS];
3239 int16_t feature_data[V4L2_AV1_MAX_SEGMENTS][V4L2_AV1_SEG_LVL_MAX];
3240 };
3241
3242 #define V4L2_AV1_LOOP_FILTER_FLAG_DELTA_ENABLED 0x1
3243 #define V4L2_AV1_LOOP_FILTER_FLAG_DELTA_UPDATE 0x2
3244 #define V4L2_AV1_LOOP_FILTER_FLAG_DELTA_LF_PRESENT 0x4
3245 #define V4L2_AV1_LOOP_FILTER_FLAG_DELTA_LF_MULTI 0x8
3246
3247 /**
3248 * struct v4l2_av1_loop_filter - AV1 Loop filter params as defined in section
3249 * 6.8.10 "Loop filter semantics" and 6.8.16 "Loop filter delta parameters
3250 * semantics" of the AV1 specification.
3251 *
3252 * @flags: see V4L2_AV1_LOOP_FILTER_FLAG_{}
3253 * @level: an array containing loop filter strength values. Different loop
3254 * filter strength values from the array are used depending on the image plane
3255 * being filtered, and the edge direction (vertical or horizontal) being
3256 * filtered.
3257 * @sharpness: indicates the sharpness level. The loop_filter_level and
3258 * loop_filter_sharpness together determine when a block edge is filtered, and
3259 * by how much the filtering can change the sample values. The loop filter
3260 * process is described in section 7.14 of the AV1 specification.
3261 * @ref_deltas: contains the adjustment needed for the filter level based on the
3262 * chosen reference frame. If this syntax element is not present, it maintains
3263 * its previous value.
3264 * @mode_deltas: contains the adjustment needed for the filter level based on
3265 * the chosen mode. If this syntax element is not present, it maintains its
3266 * previous value.
3267 * @delta_lf_res: specifies the left shift which should be applied to decoded
3268 * loop filter delta values.
3269 */
3270 struct v4l2_av1_loop_filter {
3271 u_int8_t flags;
3272 u_int8_t level[4];
3273 u_int8_t sharpness;
3274 int8_t ref_deltas[V4L2_AV1_TOTAL_REFS_PER_FRAME];
3275 int8_t mode_deltas[2];
3276 u_int8_t delta_lf_res;
3277 };
3278
3279 #define V4L2_AV1_QUANTIZATION_FLAG_DIFF_UV_DELTA 0x1
3280 #define V4L2_AV1_QUANTIZATION_FLAG_USING_QMATRIX 0x2
3281 #define V4L2_AV1_QUANTIZATION_FLAG_DELTA_Q_PRESENT 0x4
3282
3283 /**
3284 * struct v4l2_av1_quantization - AV1 Quantization params as defined in section
3285 * 6.8.11 "Quantization params semantics" of the AV1 specification.
3286 *
3287 * @flags: see V4L2_AV1_QUANTIZATION_FLAG_{}
3288 * @base_q_idx: indicates the base frame qindex. This is used for Y AC
3289 * coefficients and as the base value for the other quantizers.
3290 * @delta_q_y_dc: indicates the Y DC quantizer relative to base_q_idx.
3291 * @delta_q_u_dc: indicates the U DC quantizer relative to base_q_idx.
3292 * @delta_q_u_ac: indicates the U AC quantizer relative to base_q_idx.
3293 * @delta_q_v_dc: indicates the V DC quantizer relative to base_q_idx.
3294 * @delta_q_v_ac: indicates the V AC quantizer relative to base_q_idx.
3295 * @qm_y: specifies the level in the quantizer matrix that should be used for
3296 * luma plane decoding.
3297 * @qm_u: specifies the level in the quantizer matrix that should be used for
3298 * chroma U plane decoding.
3299 * @qm_v: specifies the level in the quantizer matrix that should be used for
3300 * chroma V plane decoding.
3301 * @delta_q_res: specifies the left shift which should be applied to decoded
3302 * quantizer index delta values.
3303 */
3304 struct v4l2_av1_quantization {
3305 u_int8_t flags;
3306 u_int8_t base_q_idx;
3307 int8_t delta_q_y_dc;
3308 int8_t delta_q_u_dc;
3309 int8_t delta_q_u_ac;
3310 int8_t delta_q_v_dc;
3311 int8_t delta_q_v_ac;
3312 u_int8_t qm_y;
3313 u_int8_t qm_u;
3314 u_int8_t qm_v;
3315 u_int8_t delta_q_res;
3316 };
3317
3318 #define V4L2_AV1_TILE_INFO_FLAG_UNIFORM_TILE_SPACING 0x1
3319
3320 /**
3321 * struct v4l2_av1_tile_info - AV1 Tile info as defined in section 6.8.14 "Tile
3322 * info semantics" of the AV1 specification.
3323 *
3324 * @flags: see V4L2_AV1_TILE_INFO_FLAG_{}
3325 * @context_update_tile_id: specifies which tile to use for the CDF update.
3326 * @tile_rows: specifies the number of tiles down the frame.
3327 * @tile_cols: specifies the number of tiles across the frame.
3328 * @mi_col_starts: an array specifying the start column (in units of 4x4 luma
3329 * samples) for each tile across the image.
3330 * @mi_row_starts: an array specifying the start row (in units of 4x4 luma
3331 * samples) for each tile down the image.
3332 * @width_in_sbs_minus_1: specifies the width of a tile minus 1 in units of
3333 * superblocks.
3334 * @height_in_sbs_minus_1: specifies the height of a tile minus 1 in units of
3335 * superblocks.
3336 * @tile_size_bytes: specifies the number of bytes needed to code each tile
3337 * size.
3338 * @reserved: padding field. Should be zeroed by applications.
3339 */
3340 struct v4l2_av1_tile_info {
3341 u_int8_t flags;
3342 u_int8_t context_update_tile_id;
3343 u_int8_t tile_cols;
3344 u_int8_t tile_rows;
3345 u_int32_t mi_col_starts[V4L2_AV1_MAX_TILE_COLS + 1];
3346 u_int32_t mi_row_starts[V4L2_AV1_MAX_TILE_ROWS + 1];
3347 u_int32_t width_in_sbs_minus_1[V4L2_AV1_MAX_TILE_COLS];
3348 u_int32_t height_in_sbs_minus_1[V4L2_AV1_MAX_TILE_ROWS];
3349 u_int8_t tile_size_bytes;
3350 u_int8_t reserved[3];
3351 };
3352
3353 /**
3354 * enum v4l2_av1_frame_type - AV1 Frame Type
3355 *
3356 * @V4L2_AV1_KEY_FRAME: Key frame
3357 * @V4L2_AV1_INTER_FRAME: Inter frame
3358 * @V4L2_AV1_INTRA_ONLY_FRAME: Intra-only frame
3359 * @V4L2_AV1_SWITCH_FRAME: Switch frame
3360 */
3361 enum v4l2_av1_frame_type {
3362 V4L2_AV1_KEY_FRAME = 0,
3363 V4L2_AV1_INTER_FRAME = 1,
3364 V4L2_AV1_INTRA_ONLY_FRAME = 2,
3365 V4L2_AV1_SWITCH_FRAME = 3
3366 };
3367
3368 /**
3369 * enum v4l2_av1_interpolation_filter - AV1 interpolation filter types
3370 *
3371 * @V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP: eight tap filter
3372 * @V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP_SMOOTH: eight tap smooth filter
3373 * @V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP_SHARP: eight tap sharp filter
3374 * @V4L2_AV1_INTERPOLATION_FILTER_BILINEAR: bilinear filter
3375 * @V4L2_AV1_INTERPOLATION_FILTER_SWITCHABLE: filter selection is signaled at
3376 * the block level
3377 *
3378 * See section 6.8.9 "Interpolation filter semantics" of the AV1 specification
3379 * for more details.
3380 */
3381 enum v4l2_av1_interpolation_filter {
3382 V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP = 0,
3383 V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP_SMOOTH = 1,
3384 V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP_SHARP = 2,
3385 V4L2_AV1_INTERPOLATION_FILTER_BILINEAR = 3,
3386 V4L2_AV1_INTERPOLATION_FILTER_SWITCHABLE = 4,
3387 };
3388
3389 /**
3390 * enum v4l2_av1_tx_mode - AV1 Tx mode as described in section 6.8.21 "TX mode
3391 * semantics" of the AV1 specification.
3392 * @V4L2_AV1_TX_MODE_ONLY_4X4: the inverse transform will use only 4x4
3393 * transforms
3394 * @V4L2_AV1_TX_MODE_LARGEST: the inverse transform will use the largest
3395 * transform size that fits inside the block
3396 * @V4L2_AV1_TX_MODE_SELECT: the choice of transform size is specified
3397 * explicitly for each block.
3398 */
3399 enum v4l2_av1_tx_mode {
3400 V4L2_AV1_TX_MODE_ONLY_4X4 = 0,
3401 V4L2_AV1_TX_MODE_LARGEST = 1,
3402 V4L2_AV1_TX_MODE_SELECT = 2
3403 };
3404
3405 #define V4L2_AV1_FRAME_FLAG_SHOW_FRAME 0x00000001
3406 #define V4L2_AV1_FRAME_FLAG_SHOWABLE_FRAME 0x00000002
3407 #define V4L2_AV1_FRAME_FLAG_ERROR_RESILIENT_MODE 0x00000004
3408 #define V4L2_AV1_FRAME_FLAG_DISABLE_CDF_UPDATE 0x00000008
3409 #define V4L2_AV1_FRAME_FLAG_ALLOW_SCREEN_CONTENT_TOOLS 0x00000010
3410 #define V4L2_AV1_FRAME_FLAG_FORCE_INTEGER_MV 0x00000020
3411 #define V4L2_AV1_FRAME_FLAG_ALLOW_INTRABC 0x00000040
3412 #define V4L2_AV1_FRAME_FLAG_USE_SUPERRES 0x00000080
3413 #define V4L2_AV1_FRAME_FLAG_ALLOW_HIGH_PRECISION_MV 0x00000100
3414 #define V4L2_AV1_FRAME_FLAG_IS_MOTION_MODE_SWITCHABLE 0x00000200
3415 #define V4L2_AV1_FRAME_FLAG_USE_REF_FRAME_MVS 0x00000400
3416 #define V4L2_AV1_FRAME_FLAG_DISABLE_FRAME_END_UPDATE_CDF 0x00000800
3417 #define V4L2_AV1_FRAME_FLAG_ALLOW_WARPED_MOTION 0x00001000
3418 #define V4L2_AV1_FRAME_FLAG_REFERENCE_SELECT 0x00002000
3419 #define V4L2_AV1_FRAME_FLAG_REDUCED_TX_SET 0x00004000
3420 #define V4L2_AV1_FRAME_FLAG_SKIP_MODE_ALLOWED 0x00008000
3421 #define V4L2_AV1_FRAME_FLAG_SKIP_MODE_PRESENT 0x00010000
3422 #define V4L2_AV1_FRAME_FLAG_FRAME_SIZE_OVERRIDE 0x00020000
3423 #define V4L2_AV1_FRAME_FLAG_BUFFER_REMOVAL_TIME_PRESENT 0x00040000
3424 #define V4L2_AV1_FRAME_FLAG_FRAME_REFS_SHORT_SIGNALING 0x00080000
3425
3426 #define V4L2_CID_STATELESS_AV1_FRAME (V4L2_CID_CODEC_STATELESS_BASE + 502)
3427 /**
3428 * struct v4l2_ctrl_av1_frame - Represents an AV1 Frame Header OBU.
3429 *
3430 * @tile_info: tile info
3431 * @quantization: quantization params
3432 * @segmentation: segmentation params
3433 * @superres_denom: the denominator for the upscaling ratio.
3434 * @loop_filter: loop filter params
3435 * @cdef: cdef params
3436 * @skip_mode_frame: specifies the frames to use for compound prediction when
3437 * skip_mode is equal to 1.
3438 * @primary_ref_frame: specifies which reference frame contains the CDF values
3439 * and other state that should be loaded at the start of the frame.
3440 * @loop_restoration: loop restoration params
3441 * @global_motion: global motion params
3442 * @flags: see V4L2_AV1_FRAME_FLAG_{}
3443 * @frame_type: specifies the AV1 frame type
3444 * @order_hint: specifies OrderHintBits least significant bits of the expected
3445 * output order for this frame.
3446 * @upscaled_width: the upscaled width.
3447 * @interpolation_filter: specifies the filter selection used for performing
3448 * inter prediction.
3449 * @tx_mode: specifies how the transform size is determined.
3450 * @frame_width_minus_1: add 1 to get the frame's width.
3451 * @frame_height_minus_1: add 1 to get the frame's height
3452 * @render_width_minus_1: add 1 to get the render width of the frame in luma
3453 * samples.
3454 * @render_height_minus_1: add 1 to get the render height of the frame in luma
3455 * samples.
3456 * @current_frame_id: specifies the frame id number for the current frame. Frame
3457 * id numbers are additional information that do not affect the decoding
3458 * process, but provide decoders with a way of detecting missing reference
3459 * frames so that appropriate action can be taken.
3460 * @buffer_removal_time: specifies the frame removal time in units of DecCT clock
3461 * ticks counted from the removal time of the last random access point for
3462 * operating point opNum.
3463 * @reserved: padding field. Should be zeroed by applications.
3464 * @order_hints: specifies the expected output order hint for each reference
3465 * frame. This field corresponds to the OrderHints variable from the
3466 * specification (section 5.9.2 "Uncompressed header syntax"). As such, this is
3467 * only used for non-intra frames and ignored otherwise. order_hints[0] is
3468 * always ignored.
3469 * @reference_frame_ts: the V4L2 timestamp of the reference frame slots.
3470 * @ref_frame_idx: used to index into @reference_frame_ts when decoding
3471 * inter-frames. The meaning of this array is the same as in the specification.
3472 * The timestamp refers to the timestamp field in struct v4l2_buffer. Use
3473 * v4l2_timeval_to_ns() to convert the struct timeval to a u_int64_t.
3474 * @refresh_frame_flags: contains a bitmask that specifies which reference frame
3475 * slots will be updated with the current frame after it is decoded.
3476 */
3477 struct v4l2_ctrl_av1_frame {
3478 struct v4l2_av1_tile_info tile_info;
3479 struct v4l2_av1_quantization quantization;
3480 u_int8_t superres_denom;
3481 struct v4l2_av1_segmentation segmentation;
3482 struct v4l2_av1_loop_filter loop_filter;
3483 struct v4l2_av1_cdef cdef;
3484 u_int8_t skip_mode_frame[2];
3485 u_int8_t primary_ref_frame;
3486 struct v4l2_av1_loop_restoration loop_restoration;
3487 struct v4l2_av1_global_motion global_motion;
3488 u_int32_t flags;
3489 enum v4l2_av1_frame_type frame_type;
3490 u_int32_t order_hint;
3491 u_int32_t upscaled_width;
3492 enum v4l2_av1_interpolation_filter interpolation_filter;
3493 enum v4l2_av1_tx_mode tx_mode;
3494 u_int32_t frame_width_minus_1;
3495 u_int32_t frame_height_minus_1;
3496 u_int16_t render_width_minus_1;
3497 u_int16_t render_height_minus_1;
3498
3499 u_int32_t current_frame_id;
3500 u_int32_t buffer_removal_time[V4L2_AV1_MAX_OPERATING_POINTS];
3501 u_int8_t reserved[4];
3502 u_int32_t order_hints[V4L2_AV1_TOTAL_REFS_PER_FRAME];
3503 u_int64_t reference_frame_ts[V4L2_AV1_TOTAL_REFS_PER_FRAME];
3504 int8_t ref_frame_idx[V4L2_AV1_REFS_PER_FRAME];
3505 u_int8_t refresh_frame_flags;
3506 };
3507
3508 #define V4L2_AV1_FILM_GRAIN_FLAG_APPLY_GRAIN 0x1
3509 #define V4L2_AV1_FILM_GRAIN_FLAG_UPDATE_GRAIN 0x2
3510 #define V4L2_AV1_FILM_GRAIN_FLAG_CHROMA_SCALING_FROM_LUMA 0x4
3511 #define V4L2_AV1_FILM_GRAIN_FLAG_OVERLAP 0x8
3512 #define V4L2_AV1_FILM_GRAIN_FLAG_CLIP_TO_RESTRICTED_RANGE 0x10
3513
3514 #define V4L2_CID_STATELESS_AV1_FILM_GRAIN (V4L2_CID_CODEC_STATELESS_BASE + 505)
3515 /**
3516 * struct v4l2_ctrl_av1_film_grain - AV1 Film Grain parameters.
3517 *
3518 * Film grain parameters as specified by section 6.8.20 of the AV1 Specification.
3519 *
3520 * @flags: see V4L2_AV1_FILM_GRAIN_{}.
3521 * @cr_mult: represents a multiplier for the cr component used in derivation of
3522 * the input index to the cr component scaling function.
3523 * @grain_seed: specifies the starting value for the pseudo-random numbers used
3524 * during film grain synthesis.
3525 * @film_grain_params_ref_idx: indicates which reference frame contains the
3526 * film grain parameters to be used for this frame.
3527 * @num_y_points: specifies the number of points for the piece-wise linear
3528 * scaling function of the luma component.
3529 * @point_y_value: represents the x (luma value) coordinate for the i-th point
3530 * of the piecewise linear scaling function for luma component. The values are
3531 * signaled on the scale of 0..255. In case of 10 bit video, these values
3532 * correspond to luma values divided by 4. In case of 12 bit video, these values
3533 * correspond to luma values divided by 16.
3534 * @point_y_scaling: represents the scaling (output) value for the i-th point
3535 * of the piecewise linear scaling function for luma component.
3536 * @num_cb_points: specifies the number of points for the piece-wise linear
3537 * scaling function of the cb component.
3538 * @point_cb_value: represents the x coordinate for the i-th point of the
3539 * piece-wise linear scaling function for cb component. The values are signaled
3540 * on the scale of 0..255.
3541 * @point_cb_scaling: represents the scaling (output) value for the i-th point
3542 * of the piecewise linear scaling function for cb component.
3543 * @num_cr_points: specifies represents the number of points for the piece-wise
3544 * linear scaling function of the cr component.
3545 * @point_cr_value: represents the x coordinate for the i-th point of the
3546 * piece-wise linear scaling function for cr component. The values are signaled
3547 * on the scale of 0..255.
3548 * @point_cr_scaling: represents the scaling (output) value for the i-th point
3549 * of the piecewise linear scaling function for cr component.
3550 * @grain_scaling_minus_8: represents the shift – 8 applied to the values of the
3551 * chroma component. The grain_scaling_minus_8 can take values of 0..3 and
3552 * determines the range and quantization step of the standard deviation of film
3553 * grain.
3554 * @ar_coeff_lag: specifies the number of auto-regressive coefficients for luma
3555 * and chroma.
3556 * @ar_coeffs_y_plus_128: specifies auto-regressive coefficients used for the Y
3557 * plane.
3558 * @ar_coeffs_cb_plus_128: specifies auto-regressive coefficients used for the U
3559 * plane.
3560 * @ar_coeffs_cr_plus_128: specifies auto-regressive coefficients used for the V
3561 * plane.
3562 * @ar_coeff_shift_minus_6: specifies the range of the auto-regressive
3563 * coefficients. Values of 0, 1, 2, and 3 correspond to the ranges for
3564 * auto-regressive coefficients of [-2, 2), [-1, 1), [-0.5, 0.5) and [-0.25,
3565 * 0.25) respectively.
3566 * @grain_scale_shift: specifies how much the Gaussian random numbers should be
3567 * scaled down during the grain synthesis process.
3568 * @cb_mult: represents a multiplier for the cb component used in derivation of
3569 * the input index to the cb component scaling function.
3570 * @cb_luma_mult: represents a multiplier for the average luma component used in
3571 * derivation of the input index to the cb component scaling function.
3572 * @cr_luma_mult: represents a multiplier for the average luma component used in
3573 * derivation of the input index to the cr component scaling function.
3574 * @cb_offset: represents an offset used in derivation of the input index to the
3575 * cb component scaling function.
3576 * @cr_offset: represents an offset used in derivation of the input index to the
3577 * cr component scaling function.
3578 * @reserved: padding field. Should be zeroed by applications.
3579 */
3580 struct v4l2_ctrl_av1_film_grain {
3581 u_int8_t flags;
3582 u_int8_t cr_mult;
3583 u_int16_t grain_seed;
3584 u_int8_t film_grain_params_ref_idx;
3585 u_int8_t num_y_points;
3586 u_int8_t point_y_value[V4L2_AV1_MAX_NUM_Y_POINTS];
3587 u_int8_t point_y_scaling[V4L2_AV1_MAX_NUM_Y_POINTS];
3588 u_int8_t num_cb_points;
3589 u_int8_t point_cb_value[V4L2_AV1_MAX_NUM_CB_POINTS];
3590 u_int8_t point_cb_scaling[V4L2_AV1_MAX_NUM_CB_POINTS];
3591 u_int8_t num_cr_points;
3592 u_int8_t point_cr_value[V4L2_AV1_MAX_NUM_CR_POINTS];
3593 u_int8_t point_cr_scaling[V4L2_AV1_MAX_NUM_CR_POINTS];
3594 u_int8_t grain_scaling_minus_8;
3595 u_int8_t ar_coeff_lag;
3596 u_int8_t ar_coeffs_y_plus_128[V4L2_AV1_AR_COEFFS_SIZE];
3597 u_int8_t ar_coeffs_cb_plus_128[V4L2_AV1_AR_COEFFS_SIZE];
3598 u_int8_t ar_coeffs_cr_plus_128[V4L2_AV1_AR_COEFFS_SIZE];
3599 u_int8_t ar_coeff_shift_minus_6;
3600 u_int8_t grain_scale_shift;
3601 u_int8_t cb_mult;
3602 u_int8_t cb_luma_mult;
3603 u_int8_t cr_luma_mult;
3604 u_int16_t cb_offset;
3605 u_int16_t cr_offset;
3606 u_int8_t reserved[4];
3607 };
3608
3609 /* MPEG-compression definitions kept for backwards compatibility */
3610 #define V4L2_CTRL_CLASS_MPEG V4L2_CTRL_CLASS_CODEC
3611 #define V4L2_CID_MPEG_CLASS V4L2_CID_CODEC_CLASS
3612 #define V4L2_CID_MPEG_BASE V4L2_CID_CODEC_BASE
3613 #define V4L2_CID_MPEG_CX2341X_BASE V4L2_CID_CODEC_CX2341X_BASE
3614 #define V4L2_CID_MPEG_MFC51_BASE V4L2_CID_CODEC_MFC51_BASE
3615 /*
3616 * End of v4l2-controls.h
3617 */
3618
3619 #ifndef __user
3620 #define __user
3621 #endif
3622
3623 /*
3624 * Common stuff for both V4L1 and V4L2
3625 * Moved from videodev.h
3626 */
3627 #define VIDEO_MAX_FRAME 32
3628 #define VIDEO_MAX_PLANES 8
3629
3630 /*
3631 * M I S C E L L A N E O U S
3632 */
3633
3634 /* Four-character-code (FOURCC) */
3635 #define v4l2_fourcc(a, b, c, d)\
3636 ((u_int32_t)(a) | ((u_int32_t)(b) << 8) | ((u_int32_t)(c) << 16) | ((u_int32_t)(d) << 24))
3637 #define v4l2_fourcc_be(a, b, c, d) (v4l2_fourcc(a, b, c, d) | (1U << 31))
3638
3639 /*
3640 * E N U M S
3641 */
3642 enum v4l2_field {
3643 V4L2_FIELD_ANY = 0, /* driver can choose from none,
3644 top, bottom, interlaced
3645 depending on whatever it thinks
3646 is approximate ... */
3647 V4L2_FIELD_NONE = 1, /* this device has no fields ... */
3648 V4L2_FIELD_TOP = 2, /* top field only */
3649 V4L2_FIELD_BOTTOM = 3, /* bottom field only */
3650 V4L2_FIELD_INTERLACED = 4, /* both fields interlaced */
3651 V4L2_FIELD_SEQ_TB = 5, /* both fields sequential into one
3652 buffer, top-bottom order */
3653 V4L2_FIELD_SEQ_BT = 6, /* same as above + bottom-top order */
3654 V4L2_FIELD_ALTERNATE = 7, /* both fields alternating into
3655 separate buffers */
3656 V4L2_FIELD_INTERLACED_TB = 8, /* both fields interlaced, top field
3657 first and the top field is
3658 transmitted first */
3659 V4L2_FIELD_INTERLACED_BT = 9, /* both fields interlaced, top field
3660 first and the bottom field is
3661 transmitted first */
3662 };
3663 #define V4L2_FIELD_HAS_TOP(field) \
3664 ((field) == V4L2_FIELD_TOP ||\
3665 (field) == V4L2_FIELD_INTERLACED ||\
3666 (field) == V4L2_FIELD_INTERLACED_TB ||\
3667 (field) == V4L2_FIELD_INTERLACED_BT ||\
3668 (field) == V4L2_FIELD_SEQ_TB ||\
3669 (field) == V4L2_FIELD_SEQ_BT)
3670 #define V4L2_FIELD_HAS_BOTTOM(field) \
3671 ((field) == V4L2_FIELD_BOTTOM ||\
3672 (field) == V4L2_FIELD_INTERLACED ||\
3673 (field) == V4L2_FIELD_INTERLACED_TB ||\
3674 (field) == V4L2_FIELD_INTERLACED_BT ||\
3675 (field) == V4L2_FIELD_SEQ_TB ||\
3676 (field) == V4L2_FIELD_SEQ_BT)
3677 #define V4L2_FIELD_HAS_BOTH(field) \
3678 ((field) == V4L2_FIELD_INTERLACED ||\
3679 (field) == V4L2_FIELD_INTERLACED_TB ||\
3680 (field) == V4L2_FIELD_INTERLACED_BT ||\
3681 (field) == V4L2_FIELD_SEQ_TB ||\
3682 (field) == V4L2_FIELD_SEQ_BT)
3683 #define V4L2_FIELD_HAS_T_OR_B(field) \
3684 ((field) == V4L2_FIELD_BOTTOM ||\
3685 (field) == V4L2_FIELD_TOP ||\
3686 (field) == V4L2_FIELD_ALTERNATE)
3687 #define V4L2_FIELD_IS_INTERLACED(field) \
3688 ((field) == V4L2_FIELD_INTERLACED ||\
3689 (field) == V4L2_FIELD_INTERLACED_TB ||\
3690 (field) == V4L2_FIELD_INTERLACED_BT)
3691 #define V4L2_FIELD_IS_SEQUENTIAL(field) \
3692 ((field) == V4L2_FIELD_SEQ_TB ||\
3693 (field) == V4L2_FIELD_SEQ_BT)
3694
3695 enum v4l2_buf_type {
3696 V4L2_BUF_TYPE_VIDEO_CAPTURE = 1,
3697 V4L2_BUF_TYPE_VIDEO_OUTPUT = 2,
3698 V4L2_BUF_TYPE_VIDEO_OVERLAY = 3,
3699 V4L2_BUF_TYPE_VBI_CAPTURE = 4,
3700 V4L2_BUF_TYPE_VBI_OUTPUT = 5,
3701 V4L2_BUF_TYPE_SLICED_VBI_CAPTURE = 6,
3702 V4L2_BUF_TYPE_SLICED_VBI_OUTPUT = 7,
3703 V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY = 8,
3704 V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE = 9,
3705 V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE = 10,
3706 V4L2_BUF_TYPE_SDR_CAPTURE = 11,
3707 V4L2_BUF_TYPE_SDR_OUTPUT = 12,
3708 V4L2_BUF_TYPE_META_CAPTURE = 13,
3709 V4L2_BUF_TYPE_META_OUTPUT = 14,
3710 /* Deprecated, do not use */
3711 V4L2_BUF_TYPE_PRIVATE = 0x80,
3712 };
3713
3714 #define V4L2_TYPE_IS_MULTIPLANAR(type) \
3715 ((type) == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE \
3716 || (type) == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE)
3717
3718 #define V4L2_TYPE_IS_OUTPUT(type) \
3719 ((type) == V4L2_BUF_TYPE_VIDEO_OUTPUT \
3720 || (type) == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE \
3721 || (type) == V4L2_BUF_TYPE_VIDEO_OVERLAY \
3722 || (type) == V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY \
3723 || (type) == V4L2_BUF_TYPE_VBI_OUTPUT \
3724 || (type) == V4L2_BUF_TYPE_SLICED_VBI_OUTPUT \
3725 || (type) == V4L2_BUF_TYPE_SDR_OUTPUT \
3726 || (type) == V4L2_BUF_TYPE_META_OUTPUT)
3727
3728 #define V4L2_TYPE_IS_CAPTURE(type) (!V4L2_TYPE_IS_OUTPUT(type))
3729
3730 enum v4l2_tuner_type {
3731 V4L2_TUNER_RADIO = 1,
3732 V4L2_TUNER_ANALOG_TV = 2,
3733 V4L2_TUNER_DIGITAL_TV = 3,
3734 V4L2_TUNER_SDR = 4,
3735 V4L2_TUNER_RF = 5,
3736 };
3737
3738 /* Deprecated, do not use */
3739 #define V4L2_TUNER_ADC V4L2_TUNER_SDR
3740
3741 enum v4l2_memory {
3742 V4L2_MEMORY_MMAP = 1,
3743 V4L2_MEMORY_USERPTR = 2,
3744 V4L2_MEMORY_OVERLAY = 3,
3745 V4L2_MEMORY_DMABUF = 4,
3746 };
3747
3748 /* see also http://vektor.theorem.ca/graphics/ycbcr/ */
3749 enum v4l2_colorspace {
3750 /*
3751 * Default colorspace, i.e. let the driver figure it out.
3752 * Can only be used with video capture.
3753 */
3754 V4L2_COLORSPACE_DEFAULT = 0,
3755
3756 /* SMPTE 170M: used for broadcast NTSC/PAL SDTV */
3757 V4L2_COLORSPACE_SMPTE170M = 1,
3758
3759 /* Obsolete pre-1998 SMPTE 240M HDTV standard, superseded by Rec 709 */
3760 V4L2_COLORSPACE_SMPTE240M = 2,
3761
3762 /* Rec.709: used for HDTV */
3763 V4L2_COLORSPACE_REC709 = 3,
3764
3765 /*
3766 * Deprecated, do not use. No driver will ever return this. This was
3767 * based on a misunderstanding of the bt878 datasheet.
3768 */
3769 V4L2_COLORSPACE_BT878 = 4,
3770
3771 /*
3772 * NTSC 1953 colorspace. This only makes sense when dealing with
3773 * really, really old NTSC recordings. Superseded by SMPTE 170M.
3774 */
3775 V4L2_COLORSPACE_470_SYSTEM_M = 5,
3776
3777 /*
3778 * EBU Tech 3213 PAL/SECAM colorspace.
3779 */
3780 V4L2_COLORSPACE_470_SYSTEM_BG = 6,
3781
3782 /*
3783 * Effectively shorthand for V4L2_COLORSPACE_SRGB, V4L2_YCBCR_ENC_601
3784 * and V4L2_QUANTIZATION_FULL_RANGE. To be used for (Motion-)JPEG.
3785 */
3786 V4L2_COLORSPACE_JPEG = 7,
3787
3788 /* For RGB colorspaces such as produces by most webcams. */
3789 V4L2_COLORSPACE_SRGB = 8,
3790
3791 /* opRGB colorspace */
3792 V4L2_COLORSPACE_OPRGB = 9,
3793
3794 /* BT.2020 colorspace, used for UHDTV. */
3795 V4L2_COLORSPACE_BT2020 = 10,
3796
3797 /* Raw colorspace: for RAW unprocessed images */
3798 V4L2_COLORSPACE_RAW = 11,
3799
3800 /* DCI-P3 colorspace, used by cinema projectors */
3801 V4L2_COLORSPACE_DCI_P3 = 12,
3802 };
3803
3804 /*
3805 * Determine how COLORSPACE_DEFAULT should map to a proper colorspace.
3806 * This depends on whether this is a SDTV image (use SMPTE 170M), an
3807 * HDTV image (use Rec. 709), or something else (use sRGB).
3808 */
3809 #define V4L2_MAP_COLORSPACE_DEFAULT(is_sdtv, is_hdtv) \
3810 ((is_sdtv) ? V4L2_COLORSPACE_SMPTE170M : \
3811 ((is_hdtv) ? V4L2_COLORSPACE_REC709 : V4L2_COLORSPACE_SRGB))
3812
3813 enum v4l2_xfer_func {
3814 /*
3815 * Mapping of V4L2_XFER_FUNC_DEFAULT to actual transfer functions
3816 * for the various colorspaces:
3817 *
3818 * V4L2_COLORSPACE_SMPTE170M, V4L2_COLORSPACE_470_SYSTEM_M,
3819 * V4L2_COLORSPACE_470_SYSTEM_BG, V4L2_COLORSPACE_REC709 and
3820 * V4L2_COLORSPACE_BT2020: V4L2_XFER_FUNC_709
3821 *
3822 * V4L2_COLORSPACE_SRGB, V4L2_COLORSPACE_JPEG: V4L2_XFER_FUNC_SRGB
3823 *
3824 * V4L2_COLORSPACE_OPRGB: V4L2_XFER_FUNC_OPRGB
3825 *
3826 * V4L2_COLORSPACE_SMPTE240M: V4L2_XFER_FUNC_SMPTE240M
3827 *
3828 * V4L2_COLORSPACE_RAW: V4L2_XFER_FUNC_NONE
3829 *
3830 * V4L2_COLORSPACE_DCI_P3: V4L2_XFER_FUNC_DCI_P3
3831 */
3832 V4L2_XFER_FUNC_DEFAULT = 0,
3833 V4L2_XFER_FUNC_709 = 1,
3834 V4L2_XFER_FUNC_SRGB = 2,
3835 V4L2_XFER_FUNC_OPRGB = 3,
3836 V4L2_XFER_FUNC_SMPTE240M = 4,
3837 V4L2_XFER_FUNC_NONE = 5,
3838 V4L2_XFER_FUNC_DCI_P3 = 6,
3839 V4L2_XFER_FUNC_SMPTE2084 = 7,
3840 };
3841
3842 /*
3843 * Determine how XFER_FUNC_DEFAULT should map to a proper transfer function.
3844 * This depends on the colorspace.
3845 */
3846 #define V4L2_MAP_XFER_FUNC_DEFAULT(colsp) \
3847 ((colsp) == V4L2_COLORSPACE_OPRGB ? V4L2_XFER_FUNC_OPRGB : \
3848 ((colsp) == V4L2_COLORSPACE_SMPTE240M ? V4L2_XFER_FUNC_SMPTE240M : \
3849 ((colsp) == V4L2_COLORSPACE_DCI_P3 ? V4L2_XFER_FUNC_DCI_P3 : \
3850 ((colsp) == V4L2_COLORSPACE_RAW ? V4L2_XFER_FUNC_NONE : \
3851 ((colsp) == V4L2_COLORSPACE_SRGB || (colsp) == V4L2_COLORSPACE_JPEG ? \
3852 V4L2_XFER_FUNC_SRGB : V4L2_XFER_FUNC_709)))))
3853
3854 enum v4l2_ycbcr_encoding {
3855 /*
3856 * Mapping of V4L2_YCBCR_ENC_DEFAULT to actual encodings for the
3857 * various colorspaces:
3858 *
3859 * V4L2_COLORSPACE_SMPTE170M, V4L2_COLORSPACE_470_SYSTEM_M,
3860 * V4L2_COLORSPACE_470_SYSTEM_BG, V4L2_COLORSPACE_SRGB,
3861 * V4L2_COLORSPACE_OPRGB and V4L2_COLORSPACE_JPEG: V4L2_YCBCR_ENC_601
3862 *
3863 * V4L2_COLORSPACE_REC709 and V4L2_COLORSPACE_DCI_P3: V4L2_YCBCR_ENC_709
3864 *
3865 * V4L2_COLORSPACE_BT2020: V4L2_YCBCR_ENC_BT2020
3866 *
3867 * V4L2_COLORSPACE_SMPTE240M: V4L2_YCBCR_ENC_SMPTE240M
3868 */
3869 V4L2_YCBCR_ENC_DEFAULT = 0,
3870
3871 /* ITU-R 601 -- SDTV */
3872 V4L2_YCBCR_ENC_601 = 1,
3873
3874 /* Rec. 709 -- HDTV */
3875 V4L2_YCBCR_ENC_709 = 2,
3876
3877 /* ITU-R 601/EN 61966-2-4 Extended Gamut -- SDTV */
3878 V4L2_YCBCR_ENC_XV601 = 3,
3879
3880 /* Rec. 709/EN 61966-2-4 Extended Gamut -- HDTV */
3881 V4L2_YCBCR_ENC_XV709 = 4,
3882
3883 /*
3884 * sYCC (Y'CbCr encoding of sRGB), identical to ENC_601. It was added
3885 * originally due to a misunderstanding of the sYCC standard. It should
3886 * not be used, instead use V4L2_YCBCR_ENC_601.
3887 */
3888 V4L2_YCBCR_ENC_SYCC = 5,
3889
3890 /* BT.2020 Non-constant Luminance Y'CbCr */
3891 V4L2_YCBCR_ENC_BT2020 = 6,
3892
3893 /* BT.2020 Constant Luminance Y'CbcCrc */
3894 V4L2_YCBCR_ENC_BT2020_CONST_LUM = 7,
3895
3896 /* SMPTE 240M -- Obsolete HDTV */
3897 V4L2_YCBCR_ENC_SMPTE240M = 8,
3898 };
3899
3900 /*
3901 * enum v4l2_hsv_encoding values should not collide with the ones from
3902 * enum v4l2_ycbcr_encoding.
3903 */
3904 enum v4l2_hsv_encoding {
3905
3906 /* Hue mapped to 0 - 179 */
3907 V4L2_HSV_ENC_180 = 128,
3908
3909 /* Hue mapped to 0-255 */
3910 V4L2_HSV_ENC_256 = 129,
3911 };
3912
3913 /*
3914 * Determine how YCBCR_ENC_DEFAULT should map to a proper Y'CbCr encoding.
3915 * This depends on the colorspace.
3916 */
3917 #define V4L2_MAP_YCBCR_ENC_DEFAULT(colsp) \
3918 (((colsp) == V4L2_COLORSPACE_REC709 || \
3919 (colsp) == V4L2_COLORSPACE_DCI_P3) ? V4L2_YCBCR_ENC_709 : \
3920 ((colsp) == V4L2_COLORSPACE_BT2020 ? V4L2_YCBCR_ENC_BT2020 : \
3921 ((colsp) == V4L2_COLORSPACE_SMPTE240M ? V4L2_YCBCR_ENC_SMPTE240M : \
3922 V4L2_YCBCR_ENC_601)))
3923
3924 enum v4l2_quantization {
3925 /*
3926 * The default for R'G'B' quantization is always full range.
3927 * For Y'CbCr the quantization is always limited range, except
3928 * for COLORSPACE_JPEG: this is full range.
3929 */
3930 V4L2_QUANTIZATION_DEFAULT = 0,
3931 V4L2_QUANTIZATION_FULL_RANGE = 1,
3932 V4L2_QUANTIZATION_LIM_RANGE = 2,
3933 };
3934
3935 /*
3936 * Determine how QUANTIZATION_DEFAULT should map to a proper quantization.
3937 * This depends on whether the image is RGB or not, the colorspace.
3938 * The Y'CbCr encoding is not used anymore, but is still there for backwards
3939 * compatibility.
3940 */
3941 #define V4L2_MAP_QUANTIZATION_DEFAULT(is_rgb_or_hsv, colsp, ycbcr_enc) \
3942 (((is_rgb_or_hsv) || (colsp) == V4L2_COLORSPACE_JPEG) ? \
3943 V4L2_QUANTIZATION_FULL_RANGE : V4L2_QUANTIZATION_LIM_RANGE)
3944
3945 /*
3946 * Deprecated names for opRGB colorspace (IEC 61966-2-5)
3947 *
3948 * WARNING: Please don't use these deprecated defines in your code, as
3949 * there is a chance we have to remove them in the future.
3950 */
3951 #define V4L2_COLORSPACE_ADOBERGB V4L2_COLORSPACE_OPRGB
3952 #define V4L2_XFER_FUNC_ADOBERGB V4L2_XFER_FUNC_OPRGB
3953
3954 enum v4l2_priority {
3955 V4L2_PRIORITY_UNSET = 0, /* not initialized */
3956 V4L2_PRIORITY_BACKGROUND = 1,
3957 V4L2_PRIORITY_INTERACTIVE = 2,
3958 V4L2_PRIORITY_RECORD = 3,
3959 V4L2_PRIORITY_DEFAULT = V4L2_PRIORITY_INTERACTIVE,
3960 };
3961
3962 struct v4l2_rect {
3963 int32_t left;
3964 int32_t top;
3965 u_int32_t width;
3966 u_int32_t height;
3967 };
3968
3969 struct v4l2_fract {
3970 u_int32_t numerator;
3971 u_int32_t denominator;
3972 };
3973
3974 struct v4l2_area {
3975 u_int32_t width;
3976 u_int32_t height;
3977 };
3978
3979 /**
3980 * struct v4l2_capability - Describes V4L2 device caps returned by VIDIOC_QUERYCAP
3981 *
3982 * @driver: name of the driver module (e.g. "bttv")
3983 * @card: name of the card (e.g. "Hauppauge WinTV")
3984 * @bus_info: name of the bus (e.g. "PCI:" + pci_name(pci_dev) )
3985 * @version: KERNEL_VERSION
3986 * @capabilities: capabilities of the physical device as a whole
3987 * @device_caps: capabilities accessed via this particular device (node)
3988 * @reserved: reserved fields for future extensions
3989 */
3990 struct v4l2_capability {
3991 u_int8_t driver[16];
3992 u_int8_t card[32];
3993 u_int8_t bus_info[32];
3994 u_int32_t version;
3995 u_int32_t capabilities;
3996 u_int32_t device_caps;
3997 u_int32_t reserved[3];
3998 };
3999
4000 /* Values for 'capabilities' field */
4001 #define V4L2_CAP_VIDEO_CAPTURE 0x00000001 /* Is a video capture device */
4002 #define V4L2_CAP_VIDEO_OUTPUT 0x00000002 /* Is a video output device */
4003 #define V4L2_CAP_VIDEO_OVERLAY 0x00000004 /* Can do video overlay */
4004 #define V4L2_CAP_VBI_CAPTURE 0x00000010 /* Is a raw VBI capture device */
4005 #define V4L2_CAP_VBI_OUTPUT 0x00000020 /* Is a raw VBI output device */
4006 #define V4L2_CAP_SLICED_VBI_CAPTURE 0x00000040 /* Is a sliced VBI capture device */
4007 #define V4L2_CAP_SLICED_VBI_OUTPUT 0x00000080 /* Is a sliced VBI output device */
4008 #define V4L2_CAP_RDS_CAPTURE 0x00000100 /* RDS data capture */
4009 #define V4L2_CAP_VIDEO_OUTPUT_OVERLAY 0x00000200 /* Can do video output overlay */
4010 #define V4L2_CAP_HW_FREQ_SEEK 0x00000400 /* Can do hardware frequency seek */
4011 #define V4L2_CAP_RDS_OUTPUT 0x00000800 /* Is an RDS encoder */
4012
4013 /* Is a video capture device that supports multiplanar formats */
4014 #define V4L2_CAP_VIDEO_CAPTURE_MPLANE 0x00001000
4015 /* Is a video output device that supports multiplanar formats */
4016 #define V4L2_CAP_VIDEO_OUTPUT_MPLANE 0x00002000
4017 /* Is a video mem-to-mem device that supports multiplanar formats */
4018 #define V4L2_CAP_VIDEO_M2M_MPLANE 0x00004000
4019 /* Is a video mem-to-mem device */
4020 #define V4L2_CAP_VIDEO_M2M 0x00008000
4021
4022 #define V4L2_CAP_TUNER 0x00010000 /* has a tuner */
4023 #define V4L2_CAP_AUDIO 0x00020000 /* has audio support */
4024 #define V4L2_CAP_RADIO 0x00040000 /* is a radio device */
4025 #define V4L2_CAP_MODULATOR 0x00080000 /* has a modulator */
4026
4027 #define V4L2_CAP_SDR_CAPTURE 0x00100000 /* Is a SDR capture device */
4028 #define V4L2_CAP_EXT_PIX_FORMAT 0x00200000 /* Supports the extended pixel format */
4029 #define V4L2_CAP_SDR_OUTPUT 0x00400000 /* Is a SDR output device */
4030 #define V4L2_CAP_META_CAPTURE 0x00800000 /* Is a metadata capture device */
4031
4032 #define V4L2_CAP_READWRITE 0x01000000 /* read/write systemcalls */
4033 #define V4L2_CAP_EDID 0x02000000 /* Is an EDID-only device */
4034 #define V4L2_CAP_STREAMING 0x04000000 /* streaming I/O ioctls */
4035 #define V4L2_CAP_META_OUTPUT 0x08000000 /* Is a metadata output device */
4036
4037 #define V4L2_CAP_TOUCH 0x10000000 /* Is a touch device */
4038
4039 #define V4L2_CAP_IO_MC 0x20000000 /* Is input/output controlled by the media controller */
4040
4041 #define V4L2_CAP_DEVICE_CAPS 0x80000000 /* sets device capabilities field */
4042
4043 /*
4044 * V I D E O I M A G E F O R M A T
4045 */
4046 struct v4l2_pix_format {
4047 u_int32_t width;
4048 u_int32_t height;
4049 u_int32_t pixelformat;
4050 u_int32_t field; /* enum v4l2_field */
4051 u_int32_t bytesperline; /* for padding, zero if unused */
4052 u_int32_t sizeimage;
4053 u_int32_t colorspace; /* enum v4l2_colorspace */
4054 u_int32_t priv; /* private data, depends on pixelformat */
4055 u_int32_t flags; /* format flags (V4L2_PIX_FMT_FLAG_*) */
4056 union {
4057 /* enum v4l2_ycbcr_encoding */
4058 u_int32_t ycbcr_enc;
4059 /* enum v4l2_hsv_encoding */
4060 u_int32_t hsv_enc;
4061 };
4062 u_int32_t quantization; /* enum v4l2_quantization */
4063 u_int32_t xfer_func; /* enum v4l2_xfer_func */
4064 };
4065
4066 /* Pixel format FOURCC depth Description */
4067
4068 /* RGB formats (1 or 2 bytes per pixel) */
4069 #define V4L2_PIX_FMT_RGB332 v4l2_fourcc('R', 'G', 'B', '1') /* 8 RGB-3-3-2 */
4070 #define V4L2_PIX_FMT_RGB444 v4l2_fourcc('R', '4', '4', '4') /* 16 xxxxrrrr ggggbbbb */
4071 #define V4L2_PIX_FMT_ARGB444 v4l2_fourcc('A', 'R', '1', '2') /* 16 aaaarrrr ggggbbbb */
4072 #define V4L2_PIX_FMT_XRGB444 v4l2_fourcc('X', 'R', '1', '2') /* 16 xxxxrrrr ggggbbbb */
4073 #define V4L2_PIX_FMT_RGBA444 v4l2_fourcc('R', 'A', '1', '2') /* 16 rrrrgggg bbbbaaaa */
4074 #define V4L2_PIX_FMT_RGBX444 v4l2_fourcc('R', 'X', '1', '2') /* 16 rrrrgggg bbbbxxxx */
4075 #define V4L2_PIX_FMT_ABGR444 v4l2_fourcc('A', 'B', '1', '2') /* 16 aaaabbbb ggggrrrr */
4076 #define V4L2_PIX_FMT_XBGR444 v4l2_fourcc('X', 'B', '1', '2') /* 16 xxxxbbbb ggggrrrr */
4077 #define V4L2_PIX_FMT_BGRA444 v4l2_fourcc('G', 'A', '1', '2') /* 16 bbbbgggg rrrraaaa */
4078 #define V4L2_PIX_FMT_BGRX444 v4l2_fourcc('B', 'X', '1', '2') /* 16 bbbbgggg rrrrxxxx */
4079 #define V4L2_PIX_FMT_RGB555 v4l2_fourcc('R', 'G', 'B', 'O') /* 16 RGB-5-5-5 */
4080 #define V4L2_PIX_FMT_ARGB555 v4l2_fourcc('A', 'R', '1', '5') /* 16 ARGB-1-5-5-5 */
4081 #define V4L2_PIX_FMT_XRGB555 v4l2_fourcc('X', 'R', '1', '5') /* 16 XRGB-1-5-5-5 */
4082 #define V4L2_PIX_FMT_RGBA555 v4l2_fourcc('R', 'A', '1', '5') /* 16 RGBA-5-5-5-1 */
4083 #define V4L2_PIX_FMT_RGBX555 v4l2_fourcc('R', 'X', '1', '5') /* 16 RGBX-5-5-5-1 */
4084 #define V4L2_PIX_FMT_ABGR555 v4l2_fourcc('A', 'B', '1', '5') /* 16 ABGR-1-5-5-5 */
4085 #define V4L2_PIX_FMT_XBGR555 v4l2_fourcc('X', 'B', '1', '5') /* 16 XBGR-1-5-5-5 */
4086 #define V4L2_PIX_FMT_BGRA555 v4l2_fourcc('B', 'A', '1', '5') /* 16 BGRA-5-5-5-1 */
4087 #define V4L2_PIX_FMT_BGRX555 v4l2_fourcc('B', 'X', '1', '5') /* 16 BGRX-5-5-5-1 */
4088 #define V4L2_PIX_FMT_RGB565 v4l2_fourcc('R', 'G', 'B', 'P') /* 16 RGB-5-6-5 */
4089 #define V4L2_PIX_FMT_RGB555X v4l2_fourcc('R', 'G', 'B', 'Q') /* 16 RGB-5-5-5 BE */
4090 #define V4L2_PIX_FMT_ARGB555X v4l2_fourcc_be('A', 'R', '1', '5') /* 16 ARGB-5-5-5 BE */
4091 #define V4L2_PIX_FMT_XRGB555X v4l2_fourcc_be('X', 'R', '1', '5') /* 16 XRGB-5-5-5 BE */
4092 #define V4L2_PIX_FMT_RGB565X v4l2_fourcc('R', 'G', 'B', 'R') /* 16 RGB-5-6-5 BE */
4093
4094 /* RGB formats (3 or 4 bytes per pixel) */
4095 #define V4L2_PIX_FMT_BGR666 v4l2_fourcc('B', 'G', 'R', 'H') /* 18 BGR-6-6-6 */
4096 #define V4L2_PIX_FMT_BGR24 v4l2_fourcc('B', 'G', 'R', '3') /* 24 BGR-8-8-8 */
4097 #define V4L2_PIX_FMT_RGB24 v4l2_fourcc('R', 'G', 'B', '3') /* 24 RGB-8-8-8 */
4098 #define V4L2_PIX_FMT_BGR32 v4l2_fourcc('B', 'G', 'R', '4') /* 32 BGR-8-8-8-8 */
4099 #define V4L2_PIX_FMT_ABGR32 v4l2_fourcc('A', 'R', '2', '4') /* 32 BGRA-8-8-8-8 */
4100 #define V4L2_PIX_FMT_XBGR32 v4l2_fourcc('X', 'R', '2', '4') /* 32 BGRX-8-8-8-8 */
4101 #define V4L2_PIX_FMT_BGRA32 v4l2_fourcc('R', 'A', '2', '4') /* 32 ABGR-8-8-8-8 */
4102 #define V4L2_PIX_FMT_BGRX32 v4l2_fourcc('R', 'X', '2', '4') /* 32 XBGR-8-8-8-8 */
4103 #define V4L2_PIX_FMT_RGB32 v4l2_fourcc('R', 'G', 'B', '4') /* 32 RGB-8-8-8-8 */
4104 #define V4L2_PIX_FMT_RGBA32 v4l2_fourcc('A', 'B', '2', '4') /* 32 RGBA-8-8-8-8 */
4105 #define V4L2_PIX_FMT_RGBX32 v4l2_fourcc('X', 'B', '2', '4') /* 32 RGBX-8-8-8-8 */
4106 #define V4L2_PIX_FMT_ARGB32 v4l2_fourcc('B', 'A', '2', '4') /* 32 ARGB-8-8-8-8 */
4107 #define V4L2_PIX_FMT_XRGB32 v4l2_fourcc('B', 'X', '2', '4') /* 32 XRGB-8-8-8-8 */
4108 #define V4L2_PIX_FMT_RGBX1010102 v4l2_fourcc('R', 'X', '3', '0') /* 32 RGBX-10-10-10-2 */
4109 #define V4L2_PIX_FMT_RGBA1010102 v4l2_fourcc('R', 'A', '3', '0') /* 32 RGBA-10-10-10-2 */
4110 #define V4L2_PIX_FMT_ARGB2101010 v4l2_fourcc('A', 'R', '3', '0') /* 32 ARGB-2-10-10-10 */
4111
4112 /* RGB formats (6 or 8 bytes per pixel) */
4113 #define V4L2_PIX_FMT_BGR48_12 v4l2_fourcc('B', '3', '1', '2') /* 48 BGR 12-bit per component */
4114 #define V4L2_PIX_FMT_BGR48 v4l2_fourcc('B', 'G', 'R', '6') /* 48 BGR 16-bit per component */
4115 #define V4L2_PIX_FMT_RGB48 v4l2_fourcc('R', 'G', 'B', '6') /* 48 RGB 16-bit per component */
4116 #define V4L2_PIX_FMT_ABGR64_12 v4l2_fourcc('B', '4', '1', '2') /* 64 BGRA 12-bit per component */
4117
4118 /* Grey formats */
4119 #define V4L2_PIX_FMT_GREY v4l2_fourcc('G', 'R', 'E', 'Y') /* 8 Greyscale */
4120 #define V4L2_PIX_FMT_Y4 v4l2_fourcc('Y', '0', '4', ' ') /* 4 Greyscale */
4121 #define V4L2_PIX_FMT_Y6 v4l2_fourcc('Y', '0', '6', ' ') /* 6 Greyscale */
4122 #define V4L2_PIX_FMT_Y10 v4l2_fourcc('Y', '1', '0', ' ') /* 10 Greyscale */
4123 #define V4L2_PIX_FMT_Y12 v4l2_fourcc('Y', '1', '2', ' ') /* 12 Greyscale */
4124 #define V4L2_PIX_FMT_Y012 v4l2_fourcc('Y', '0', '1', '2') /* 12 Greyscale */
4125 #define V4L2_PIX_FMT_Y14 v4l2_fourcc('Y', '1', '4', ' ') /* 14 Greyscale */
4126 #define V4L2_PIX_FMT_Y16 v4l2_fourcc('Y', '1', '6', ' ') /* 16 Greyscale */
4127 #define V4L2_PIX_FMT_Y16_BE v4l2_fourcc_be('Y', '1', '6', ' ') /* 16 Greyscale BE */
4128
4129 /* Grey bit-packed formats */
4130 #define V4L2_PIX_FMT_Y10BPACK v4l2_fourcc('Y', '1', '0', 'B') /* 10 Greyscale bit-packed */
4131 #define V4L2_PIX_FMT_Y10P v4l2_fourcc('Y', '1', '0', 'P') /* 10 Greyscale, MIPI RAW10 packed */
4132 #define V4L2_PIX_FMT_IPU3_Y10 v4l2_fourcc('i', 'p', '3', 'y') /* IPU3 packed 10-bit greyscale */
4133 #define V4L2_PIX_FMT_Y12P v4l2_fourcc('Y', '1', '2', 'P') /* 12 Greyscale, MIPI RAW12 packed */
4134 #define V4L2_PIX_FMT_Y14P v4l2_fourcc('Y', '1', '4', 'P') /* 14 Greyscale, MIPI RAW14 packed */
4135
4136 /* Palette formats */
4137 #define V4L2_PIX_FMT_PAL8 v4l2_fourcc('P', 'A', 'L', '8') /* 8 8-bit palette */
4138
4139 /* Chrominance formats */
4140 #define V4L2_PIX_FMT_UV8 v4l2_fourcc('U', 'V', '8', ' ') /* 8 UV 4:4 */
4141
4142 /* Luminance+Chrominance formats */
4143 #define V4L2_PIX_FMT_YUYV v4l2_fourcc('Y', 'U', 'Y', 'V') /* 16 YUV 4:2:2 */
4144 #define V4L2_PIX_FMT_YYUV v4l2_fourcc('Y', 'Y', 'U', 'V') /* 16 YUV 4:2:2 */
4145 #define V4L2_PIX_FMT_YVYU v4l2_fourcc('Y', 'V', 'Y', 'U') /* 16 YVU 4:2:2 */
4146 #define V4L2_PIX_FMT_UYVY v4l2_fourcc('U', 'Y', 'V', 'Y') /* 16 YUV 4:2:2 */
4147 #define V4L2_PIX_FMT_VYUY v4l2_fourcc('V', 'Y', 'U', 'Y') /* 16 YUV 4:2:2 */
4148 #define V4L2_PIX_FMT_Y41P v4l2_fourcc('Y', '4', '1', 'P') /* 12 YUV 4:1:1 */
4149 #define V4L2_PIX_FMT_YUV444 v4l2_fourcc('Y', '4', '4', '4') /* 16 xxxxyyyy uuuuvvvv */
4150 #define V4L2_PIX_FMT_YUV555 v4l2_fourcc('Y', 'U', 'V', 'O') /* 16 YUV-5-5-5 */
4151 #define V4L2_PIX_FMT_YUV565 v4l2_fourcc('Y', 'U', 'V', 'P') /* 16 YUV-5-6-5 */
4152 #define V4L2_PIX_FMT_YUV24 v4l2_fourcc('Y', 'U', 'V', '3') /* 24 YUV-8-8-8 */
4153 #define V4L2_PIX_FMT_YUV32 v4l2_fourcc('Y', 'U', 'V', '4') /* 32 YUV-8-8-8-8 */
4154 #define V4L2_PIX_FMT_AYUV32 v4l2_fourcc('A', 'Y', 'U', 'V') /* 32 AYUV-8-8-8-8 */
4155 #define V4L2_PIX_FMT_XYUV32 v4l2_fourcc('X', 'Y', 'U', 'V') /* 32 XYUV-8-8-8-8 */
4156 #define V4L2_PIX_FMT_VUYA32 v4l2_fourcc('V', 'U', 'Y', 'A') /* 32 VUYA-8-8-8-8 */
4157 #define V4L2_PIX_FMT_VUYX32 v4l2_fourcc('V', 'U', 'Y', 'X') /* 32 VUYX-8-8-8-8 */
4158 #define V4L2_PIX_FMT_YUVA32 v4l2_fourcc('Y', 'U', 'V', 'A') /* 32 YUVA-8-8-8-8 */
4159 #define V4L2_PIX_FMT_YUVX32 v4l2_fourcc('Y', 'U', 'V', 'X') /* 32 YUVX-8-8-8-8 */
4160 #define V4L2_PIX_FMT_M420 v4l2_fourcc('M', '4', '2', '0') /* 12 YUV 4:2:0 2 lines y, 1 line uv interleaved */
4161 #define V4L2_PIX_FMT_YUV48_12 v4l2_fourcc('Y', '3', '1', '2') /* 48 YUV 4:4:4 12-bit per component */
4162
4163 /*
4164 * YCbCr packed format. For each Y2xx format, xx bits of valid data occupy the MSBs
4165 * of the 16 bit components, and 16-xx bits of zero padding occupy the LSBs.
4166 */
4167 #define V4L2_PIX_FMT_Y210 v4l2_fourcc('Y', '2', '1', '0') /* 32 YUYV 4:2:2 */
4168 #define V4L2_PIX_FMT_Y212 v4l2_fourcc('Y', '2', '1', '2') /* 32 YUYV 4:2:2 */
4169 #define V4L2_PIX_FMT_Y216 v4l2_fourcc('Y', '2', '1', '6') /* 32 YUYV 4:2:2 */
4170
4171 /* two planes -- one Y, one Cr + Cb interleaved */
4172 #define V4L2_PIX_FMT_NV12 v4l2_fourcc('N', 'V', '1', '2') /* 12 Y/CbCr 4:2:0 */
4173 #define V4L2_PIX_FMT_NV21 v4l2_fourcc('N', 'V', '2', '1') /* 12 Y/CrCb 4:2:0 */
4174 #define V4L2_PIX_FMT_NV16 v4l2_fourcc('N', 'V', '1', '6') /* 16 Y/CbCr 4:2:2 */
4175 #define V4L2_PIX_FMT_NV61 v4l2_fourcc('N', 'V', '6', '1') /* 16 Y/CrCb 4:2:2 */
4176 #define V4L2_PIX_FMT_NV24 v4l2_fourcc('N', 'V', '2', '4') /* 24 Y/CbCr 4:4:4 */
4177 #define V4L2_PIX_FMT_NV42 v4l2_fourcc('N', 'V', '4', '2') /* 24 Y/CrCb 4:4:4 */
4178 #define V4L2_PIX_FMT_P010 v4l2_fourcc('P', '0', '1', '0') /* 24 Y/CbCr 4:2:0 10-bit per component */
4179 #define V4L2_PIX_FMT_P012 v4l2_fourcc('P', '0', '1', '2') /* 24 Y/CbCr 4:2:0 12-bit per component */
4180
4181 /* two non contiguous planes - one Y, one Cr + Cb interleaved */
4182 #define V4L2_PIX_FMT_NV12M v4l2_fourcc('N', 'M', '1', '2') /* 12 Y/CbCr 4:2:0 */
4183 #define V4L2_PIX_FMT_NV21M v4l2_fourcc('N', 'M', '2', '1') /* 21 Y/CrCb 4:2:0 */
4184 #define V4L2_PIX_FMT_NV16M v4l2_fourcc('N', 'M', '1', '6') /* 16 Y/CbCr 4:2:2 */
4185 #define V4L2_PIX_FMT_NV61M v4l2_fourcc('N', 'M', '6', '1') /* 16 Y/CrCb 4:2:2 */
4186 #define V4L2_PIX_FMT_P012M v4l2_fourcc('P', 'M', '1', '2') /* 24 Y/CbCr 4:2:0 12-bit per component */
4187
4188 /* three planes - Y Cb, Cr */
4189 #define V4L2_PIX_FMT_YUV410 v4l2_fourcc('Y', 'U', 'V', '9') /* 9 YUV 4:1:0 */
4190 #define V4L2_PIX_FMT_YVU410 v4l2_fourcc('Y', 'V', 'U', '9') /* 9 YVU 4:1:0 */
4191 #define V4L2_PIX_FMT_YUV411P v4l2_fourcc('4', '1', '1', 'P') /* 12 YVU411 planar */
4192 #define V4L2_PIX_FMT_YUV420 v4l2_fourcc('Y', 'U', '1', '2') /* 12 YUV 4:2:0 */
4193 #define V4L2_PIX_FMT_YVU420 v4l2_fourcc('Y', 'V', '1', '2') /* 12 YVU 4:2:0 */
4194 #define V4L2_PIX_FMT_YUV422P v4l2_fourcc('4', '2', '2', 'P') /* 16 YVU422 planar */
4195
4196 /* three non contiguous planes - Y, Cb, Cr */
4197 #define V4L2_PIX_FMT_YUV420M v4l2_fourcc('Y', 'M', '1', '2') /* 12 YUV420 planar */
4198 #define V4L2_PIX_FMT_YVU420M v4l2_fourcc('Y', 'M', '2', '1') /* 12 YVU420 planar */
4199 #define V4L2_PIX_FMT_YUV422M v4l2_fourcc('Y', 'M', '1', '6') /* 16 YUV422 planar */
4200 #define V4L2_PIX_FMT_YVU422M v4l2_fourcc('Y', 'M', '6', '1') /* 16 YVU422 planar */
4201 #define V4L2_PIX_FMT_YUV444M v4l2_fourcc('Y', 'M', '2', '4') /* 24 YUV444 planar */
4202 #define V4L2_PIX_FMT_YVU444M v4l2_fourcc('Y', 'M', '4', '2') /* 24 YVU444 planar */
4203
4204 /* Tiled YUV formats */
4205 #define V4L2_PIX_FMT_NV12_4L4 v4l2_fourcc('V', 'T', '1', '2') /* 12 Y/CbCr 4:2:0 4x4 tiles */
4206 #define V4L2_PIX_FMT_NV12_16L16 v4l2_fourcc('H', 'M', '1', '2') /* 12 Y/CbCr 4:2:0 16x16 tiles */
4207 #define V4L2_PIX_FMT_NV12_32L32 v4l2_fourcc('S', 'T', '1', '2') /* 12 Y/CbCr 4:2:0 32x32 tiles */
4208 #define V4L2_PIX_FMT_NV15_4L4 v4l2_fourcc('V', 'T', '1', '5') /* 15 Y/CbCr 4:2:0 10-bit 4x4 tiles */
4209 #define V4L2_PIX_FMT_P010_4L4 v4l2_fourcc('T', '0', '1', '0') /* 12 Y/CbCr 4:2:0 10-bit 4x4 macroblocks */
4210 #define V4L2_PIX_FMT_NV12_8L128 v4l2_fourcc('A', 'T', '1', '2') /* Y/CbCr 4:2:0 8x128 tiles */
4211 #define V4L2_PIX_FMT_NV12_10BE_8L128 v4l2_fourcc_be('A', 'X', '1', '2') /* Y/CbCr 4:2:0 10-bit 8x128 tiles */
4212
4213 /* Tiled YUV formats, non contiguous planes */
4214 #define V4L2_PIX_FMT_NV12MT v4l2_fourcc('T', 'M', '1', '2') /* 12 Y/CbCr 4:2:0 64x32 tiles */
4215 #define V4L2_PIX_FMT_NV12MT_16X16 v4l2_fourcc('V', 'M', '1', '2') /* 12 Y/CbCr 4:2:0 16x16 tiles */
4216 #define V4L2_PIX_FMT_NV12M_8L128 v4l2_fourcc('N', 'A', '1', '2') /* Y/CbCr 4:2:0 8x128 tiles */
4217 #define V4L2_PIX_FMT_NV12M_10BE_8L128 v4l2_fourcc_be('N', 'T', '1', '2') /* Y/CbCr 4:2:0 10-bit 8x128 tiles */
4218
4219 /* Bayer formats - see http://www.siliconimaging.com/RGB%20Bayer.htm */
4220 #define V4L2_PIX_FMT_SBGGR8 v4l2_fourcc('B', 'A', '8', '1') /* 8 BGBG.. GRGR.. */
4221 #define V4L2_PIX_FMT_SGBRG8 v4l2_fourcc('G', 'B', 'R', 'G') /* 8 GBGB.. RGRG.. */
4222 #define V4L2_PIX_FMT_SGRBG8 v4l2_fourcc('G', 'R', 'B', 'G') /* 8 GRGR.. BGBG.. */
4223 #define V4L2_PIX_FMT_SRGGB8 v4l2_fourcc('R', 'G', 'G', 'B') /* 8 RGRG.. GBGB.. */
4224 #define V4L2_PIX_FMT_SBGGR10 v4l2_fourcc('B', 'G', '1', '0') /* 10 BGBG.. GRGR.. */
4225 #define V4L2_PIX_FMT_SGBRG10 v4l2_fourcc('G', 'B', '1', '0') /* 10 GBGB.. RGRG.. */
4226 #define V4L2_PIX_FMT_SGRBG10 v4l2_fourcc('B', 'A', '1', '0') /* 10 GRGR.. BGBG.. */
4227 #define V4L2_PIX_FMT_SRGGB10 v4l2_fourcc('R', 'G', '1', '0') /* 10 RGRG.. GBGB.. */
4228 /* 10bit raw bayer packed, 5 bytes for every 4 pixels */
4229 #define V4L2_PIX_FMT_SBGGR10P v4l2_fourcc('p', 'B', 'A', 'A')
4230 #define V4L2_PIX_FMT_SGBRG10P v4l2_fourcc('p', 'G', 'A', 'A')
4231 #define V4L2_PIX_FMT_SGRBG10P v4l2_fourcc('p', 'g', 'A', 'A')
4232 #define V4L2_PIX_FMT_SRGGB10P v4l2_fourcc('p', 'R', 'A', 'A')
4233 /* 10bit raw bayer a-law compressed to 8 bits */
4234 #define V4L2_PIX_FMT_SBGGR10ALAW8 v4l2_fourcc('a', 'B', 'A', '8')
4235 #define V4L2_PIX_FMT_SGBRG10ALAW8 v4l2_fourcc('a', 'G', 'A', '8')
4236 #define V4L2_PIX_FMT_SGRBG10ALAW8 v4l2_fourcc('a', 'g', 'A', '8')
4237 #define V4L2_PIX_FMT_SRGGB10ALAW8 v4l2_fourcc('a', 'R', 'A', '8')
4238 /* 10bit raw bayer DPCM compressed to 8 bits */
4239 #define V4L2_PIX_FMT_SBGGR10DPCM8 v4l2_fourcc('b', 'B', 'A', '8')
4240 #define V4L2_PIX_FMT_SGBRG10DPCM8 v4l2_fourcc('b', 'G', 'A', '8')
4241 #define V4L2_PIX_FMT_SGRBG10DPCM8 v4l2_fourcc('B', 'D', '1', '0')
4242 #define V4L2_PIX_FMT_SRGGB10DPCM8 v4l2_fourcc('b', 'R', 'A', '8')
4243 #define V4L2_PIX_FMT_SBGGR12 v4l2_fourcc('B', 'G', '1', '2') /* 12 BGBG.. GRGR.. */
4244 #define V4L2_PIX_FMT_SGBRG12 v4l2_fourcc('G', 'B', '1', '2') /* 12 GBGB.. RGRG.. */
4245 #define V4L2_PIX_FMT_SGRBG12 v4l2_fourcc('B', 'A', '1', '2') /* 12 GRGR.. BGBG.. */
4246 #define V4L2_PIX_FMT_SRGGB12 v4l2_fourcc('R', 'G', '1', '2') /* 12 RGRG.. GBGB.. */
4247 /* 12bit raw bayer packed, 6 bytes for every 4 pixels */
4248 #define V4L2_PIX_FMT_SBGGR12P v4l2_fourcc('p', 'B', 'C', 'C')
4249 #define V4L2_PIX_FMT_SGBRG12P v4l2_fourcc('p', 'G', 'C', 'C')
4250 #define V4L2_PIX_FMT_SGRBG12P v4l2_fourcc('p', 'g', 'C', 'C')
4251 #define V4L2_PIX_FMT_SRGGB12P v4l2_fourcc('p', 'R', 'C', 'C')
4252 #define V4L2_PIX_FMT_SBGGR14 v4l2_fourcc('B', 'G', '1', '4') /* 14 BGBG.. GRGR.. */
4253 #define V4L2_PIX_FMT_SGBRG14 v4l2_fourcc('G', 'B', '1', '4') /* 14 GBGB.. RGRG.. */
4254 #define V4L2_PIX_FMT_SGRBG14 v4l2_fourcc('G', 'R', '1', '4') /* 14 GRGR.. BGBG.. */
4255 #define V4L2_PIX_FMT_SRGGB14 v4l2_fourcc('R', 'G', '1', '4') /* 14 RGRG.. GBGB.. */
4256 /* 14bit raw bayer packed, 7 bytes for every 4 pixels */
4257 #define V4L2_PIX_FMT_SBGGR14P v4l2_fourcc('p', 'B', 'E', 'E')
4258 #define V4L2_PIX_FMT_SGBRG14P v4l2_fourcc('p', 'G', 'E', 'E')
4259 #define V4L2_PIX_FMT_SGRBG14P v4l2_fourcc('p', 'g', 'E', 'E')
4260 #define V4L2_PIX_FMT_SRGGB14P v4l2_fourcc('p', 'R', 'E', 'E')
4261 #define V4L2_PIX_FMT_SBGGR16 v4l2_fourcc('B', 'Y', 'R', '2') /* 16 BGBG.. GRGR.. */
4262 #define V4L2_PIX_FMT_SGBRG16 v4l2_fourcc('G', 'B', '1', '6') /* 16 GBGB.. RGRG.. */
4263 #define V4L2_PIX_FMT_SGRBG16 v4l2_fourcc('G', 'R', '1', '6') /* 16 GRGR.. BGBG.. */
4264 #define V4L2_PIX_FMT_SRGGB16 v4l2_fourcc('R', 'G', '1', '6') /* 16 RGRG.. GBGB.. */
4265
4266 /* HSV formats */
4267 #define V4L2_PIX_FMT_HSV24 v4l2_fourcc('H', 'S', 'V', '3')
4268 #define V4L2_PIX_FMT_HSV32 v4l2_fourcc('H', 'S', 'V', '4')
4269
4270 /* compressed formats */
4271 #define V4L2_PIX_FMT_MJPEG v4l2_fourcc('M', 'J', 'P', 'G') /* Motion-JPEG */
4272 #define V4L2_PIX_FMT_JPEG v4l2_fourcc('J', 'P', 'E', 'G') /* JFIF JPEG */
4273 #define V4L2_PIX_FMT_DV v4l2_fourcc('d', 'v', 's', 'd') /* 1394 */
4274 #define V4L2_PIX_FMT_MPEG v4l2_fourcc('M', 'P', 'E', 'G') /* MPEG-1/2/4 Multiplexed */
4275 #define V4L2_PIX_FMT_H264 v4l2_fourcc('H', '2', '6', '4') /* H264 with start codes */
4276 #define V4L2_PIX_FMT_H264_NO_SC v4l2_fourcc('A', 'V', 'C', '1') /* H264 without start codes */
4277 #define V4L2_PIX_FMT_H264_MVC v4l2_fourcc('M', '2', '6', '4') /* H264 MVC */
4278 #define V4L2_PIX_FMT_H263 v4l2_fourcc('H', '2', '6', '3') /* H263 */
4279 #define V4L2_PIX_FMT_MPEG1 v4l2_fourcc('M', 'P', 'G', '1') /* MPEG-1 ES */
4280 #define V4L2_PIX_FMT_MPEG2 v4l2_fourcc('M', 'P', 'G', '2') /* MPEG-2 ES */
4281 #define V4L2_PIX_FMT_MPEG2_SLICE v4l2_fourcc('M', 'G', '2', 'S') /* MPEG-2 parsed slice data */
4282 #define V4L2_PIX_FMT_MPEG4 v4l2_fourcc('M', 'P', 'G', '4') /* MPEG-4 part 2 ES */
4283 #define V4L2_PIX_FMT_XVID v4l2_fourcc('X', 'V', 'I', 'D') /* Xvid */
4284 #define V4L2_PIX_FMT_VC1_ANNEX_G v4l2_fourcc('V', 'C', '1', 'G') /* SMPTE 421M Annex G compliant stream */
4285 #define V4L2_PIX_FMT_VC1_ANNEX_L v4l2_fourcc('V', 'C', '1', 'L') /* SMPTE 421M Annex L compliant stream */
4286 #define V4L2_PIX_FMT_VP8 v4l2_fourcc('V', 'P', '8', '0') /* VP8 */
4287 #define V4L2_PIX_FMT_VP8_FRAME v4l2_fourcc('V', 'P', '8', 'F') /* VP8 parsed frame */
4288 #define V4L2_PIX_FMT_VP9 v4l2_fourcc('V', 'P', '9', '0') /* VP9 */
4289 #define V4L2_PIX_FMT_VP9_FRAME v4l2_fourcc('V', 'P', '9', 'F') /* VP9 parsed frame */
4290 #define V4L2_PIX_FMT_HEVC v4l2_fourcc('H', 'E', 'V', 'C') /* HEVC aka H.265 */
4291 #define V4L2_PIX_FMT_FWHT v4l2_fourcc('F', 'W', 'H', 'T') /* Fast Walsh Hadamard Transform (vicodec) */
4292 #define V4L2_PIX_FMT_FWHT_STATELESS v4l2_fourcc('S', 'F', 'W', 'H') /* Stateless FWHT (vicodec) */
4293 #define V4L2_PIX_FMT_H264_SLICE v4l2_fourcc('S', '2', '6', '4') /* H264 parsed slices */
4294 #define V4L2_PIX_FMT_HEVC_SLICE v4l2_fourcc('S', '2', '6', '5') /* HEVC parsed slices */
4295 #define V4L2_PIX_FMT_AV1_FRAME v4l2_fourcc('A', 'V', '1', 'F') /* AV1 parsed frame */
4296 #define V4L2_PIX_FMT_SPK v4l2_fourcc('S', 'P', 'K', '0') /* Sorenson Spark */
4297 #define V4L2_PIX_FMT_RV30 v4l2_fourcc('R', 'V', '3', '0') /* RealVideo 8 */
4298 #define V4L2_PIX_FMT_RV40 v4l2_fourcc('R', 'V', '4', '0') /* RealVideo 9 & 10 */
4299
4300 /* Vendor-specific formats */
4301 #define V4L2_PIX_FMT_CPIA1 v4l2_fourcc('C', 'P', 'I', 'A') /* cpia1 YUV */
4302 #define V4L2_PIX_FMT_WNVA v4l2_fourcc('W', 'N', 'V', 'A') /* Winnov hw compress */
4303 #define V4L2_PIX_FMT_SN9C10X v4l2_fourcc('S', '9', '1', '0') /* SN9C10x compression */
4304 #define V4L2_PIX_FMT_SN9C20X_I420 v4l2_fourcc('S', '9', '2', '0') /* SN9C20x YUV 4:2:0 */
4305 #define V4L2_PIX_FMT_PWC1 v4l2_fourcc('P', 'W', 'C', '1') /* pwc older webcam */
4306 #define V4L2_PIX_FMT_PWC2 v4l2_fourcc('P', 'W', 'C', '2') /* pwc newer webcam */
4307 #define V4L2_PIX_FMT_ET61X251 v4l2_fourcc('E', '6', '2', '5') /* ET61X251 compression */
4308 #define V4L2_PIX_FMT_SPCA501 v4l2_fourcc('S', '5', '0', '1') /* YUYV per line */
4309 #define V4L2_PIX_FMT_SPCA505 v4l2_fourcc('S', '5', '0', '5') /* YYUV per line */
4310 #define V4L2_PIX_FMT_SPCA508 v4l2_fourcc('S', '5', '0', '8') /* YUVY per line */
4311 #define V4L2_PIX_FMT_SPCA561 v4l2_fourcc('S', '5', '6', '1') /* compressed GBRG bayer */
4312 #define V4L2_PIX_FMT_PAC207 v4l2_fourcc('P', '2', '0', '7') /* compressed BGGR bayer */
4313 #define V4L2_PIX_FMT_MR97310A v4l2_fourcc('M', '3', '1', '0') /* compressed BGGR bayer */
4314 #define V4L2_PIX_FMT_JL2005BCD v4l2_fourcc('J', 'L', '2', '0') /* compressed RGGB bayer */
4315 #define V4L2_PIX_FMT_SN9C2028 v4l2_fourcc('S', 'O', 'N', 'X') /* compressed GBRG bayer */
4316 #define V4L2_PIX_FMT_SQ905C v4l2_fourcc('9', '0', '5', 'C') /* compressed RGGB bayer */
4317 #define V4L2_PIX_FMT_PJPG v4l2_fourcc('P', 'J', 'P', 'G') /* Pixart 73xx JPEG */
4318 #define V4L2_PIX_FMT_OV511 v4l2_fourcc('O', '5', '1', '1') /* ov511 JPEG */
4319 #define V4L2_PIX_FMT_OV518 v4l2_fourcc('O', '5', '1', '8') /* ov518 JPEG */
4320 #define V4L2_PIX_FMT_STV0680 v4l2_fourcc('S', '6', '8', '0') /* stv0680 bayer */
4321 #define V4L2_PIX_FMT_TM6000 v4l2_fourcc('T', 'M', '6', '0') /* tm5600/tm60x0 */
4322 #define V4L2_PIX_FMT_CIT_YYVYUY v4l2_fourcc('C', 'I', 'T', 'V') /* one line of Y then 1 line of VYUY */
4323 #define V4L2_PIX_FMT_KONICA420 v4l2_fourcc('K', 'O', 'N', 'I') /* YUV420 planar in blocks of 256 pixels */
4324 #define V4L2_PIX_FMT_JPGL v4l2_fourcc('J', 'P', 'G', 'L') /* JPEG-Lite */
4325 #define V4L2_PIX_FMT_SE401 v4l2_fourcc('S', '4', '0', '1') /* se401 janggu compressed rgb */
4326 #define V4L2_PIX_FMT_S5C_UYVY_JPG v4l2_fourcc('S', '5', 'C', 'I') /* S5C73M3 interleaved UYVY/JPEG */
4327 #define V4L2_PIX_FMT_Y8I v4l2_fourcc('Y', '8', 'I', ' ') /* Greyscale 8-bit L/R interleaved */
4328 #define V4L2_PIX_FMT_Y12I v4l2_fourcc('Y', '1', '2', 'I') /* Greyscale 12-bit L/R interleaved */
4329 #define V4L2_PIX_FMT_Y16I v4l2_fourcc('Y', '1', '6', 'I') /* Greyscale 16-bit L/R interleaved */
4330 #define V4L2_PIX_FMT_Z16 v4l2_fourcc('Z', '1', '6', ' ') /* Depth data 16-bit */
4331 #define V4L2_PIX_FMT_MT21C v4l2_fourcc('M', 'T', '2', '1') /* Mediatek compressed block mode */
4332 #define V4L2_PIX_FMT_MM21 v4l2_fourcc('M', 'M', '2', '1') /* Mediatek 8-bit block mode, two non-contiguous planes */
4333 #define V4L2_PIX_FMT_MT2110T v4l2_fourcc('M', 'T', '2', 'T') /* Mediatek 10-bit block tile mode */
4334 #define V4L2_PIX_FMT_MT2110R v4l2_fourcc('M', 'T', '2', 'R') /* Mediatek 10-bit block raster mode */
4335 #define V4L2_PIX_FMT_INZI v4l2_fourcc('I', 'N', 'Z', 'I') /* Intel Planar Greyscale 10-bit and Depth 16-bit */
4336 #define V4L2_PIX_FMT_CNF4 v4l2_fourcc('C', 'N', 'F', '4') /* Intel 4-bit packed depth confidence information */
4337 #define V4L2_PIX_FMT_HI240 v4l2_fourcc('H', 'I', '2', '4') /* BTTV 8-bit dithered RGB */
4338 #define V4L2_PIX_FMT_QC08C v4l2_fourcc('Q', '0', '8', 'C') /* Qualcomm 8-bit compressed */
4339 #define V4L2_PIX_FMT_QC10C v4l2_fourcc('Q', '1', '0', 'C') /* Qualcomm 10-bit compressed */
4340 #define V4L2_PIX_FMT_AJPG v4l2_fourcc('A', 'J', 'P', 'G') /* Aspeed JPEG */
4341 #define V4L2_PIX_FMT_HEXTILE v4l2_fourcc('H', 'X', 'T', 'L') /* Hextile compressed */
4342
4343 /* 10bit raw packed, 32 bytes for every 25 pixels, last LSB 6 bits unused */
4344 #define V4L2_PIX_FMT_IPU3_SBGGR10 v4l2_fourcc('i', 'p', '3', 'b') /* IPU3 packed 10-bit BGGR bayer */
4345 #define V4L2_PIX_FMT_IPU3_SGBRG10 v4l2_fourcc('i', 'p', '3', 'g') /* IPU3 packed 10-bit GBRG bayer */
4346 #define V4L2_PIX_FMT_IPU3_SGRBG10 v4l2_fourcc('i', 'p', '3', 'G') /* IPU3 packed 10-bit GRBG bayer */
4347 #define V4L2_PIX_FMT_IPU3_SRGGB10 v4l2_fourcc('i', 'p', '3', 'r') /* IPU3 packed 10-bit RGGB bayer */
4348
4349 /* Raspberry Pi PiSP compressed formats. */
4350 #define V4L2_PIX_FMT_PISP_COMP1_RGGB v4l2_fourcc('P', 'C', '1', 'R') /* PiSP 8-bit mode 1 compressed RGGB bayer */
4351 #define V4L2_PIX_FMT_PISP_COMP1_GRBG v4l2_fourcc('P', 'C', '1', 'G') /* PiSP 8-bit mode 1 compressed GRBG bayer */
4352 #define V4L2_PIX_FMT_PISP_COMP1_GBRG v4l2_fourcc('P', 'C', '1', 'g') /* PiSP 8-bit mode 1 compressed GBRG bayer */
4353 #define V4L2_PIX_FMT_PISP_COMP1_BGGR v4l2_fourcc('P', 'C', '1', 'B') /* PiSP 8-bit mode 1 compressed BGGR bayer */
4354 #define V4L2_PIX_FMT_PISP_COMP1_MONO v4l2_fourcc('P', 'C', '1', 'M') /* PiSP 8-bit mode 1 compressed monochrome */
4355 #define V4L2_PIX_FMT_PISP_COMP2_RGGB v4l2_fourcc('P', 'C', '2', 'R') /* PiSP 8-bit mode 2 compressed RGGB bayer */
4356 #define V4L2_PIX_FMT_PISP_COMP2_GRBG v4l2_fourcc('P', 'C', '2', 'G') /* PiSP 8-bit mode 2 compressed GRBG bayer */
4357 #define V4L2_PIX_FMT_PISP_COMP2_GBRG v4l2_fourcc('P', 'C', '2', 'g') /* PiSP 8-bit mode 2 compressed GBRG bayer */
4358 #define V4L2_PIX_FMT_PISP_COMP2_BGGR v4l2_fourcc('P', 'C', '2', 'B') /* PiSP 8-bit mode 2 compressed BGGR bayer */
4359 #define V4L2_PIX_FMT_PISP_COMP2_MONO v4l2_fourcc('P', 'C', '2', 'M') /* PiSP 8-bit mode 2 compressed monochrome */
4360
4361 /* SDR formats - used only for Software Defined Radio devices */
4362 #define V4L2_SDR_FMT_CU8 v4l2_fourcc('C', 'U', '0', '8') /* IQ u8 */
4363 #define V4L2_SDR_FMT_CU16LE v4l2_fourcc('C', 'U', '1', '6') /* IQ u16le */
4364 #define V4L2_SDR_FMT_CS8 v4l2_fourcc('C', 'S', '0', '8') /* complex s8 */
4365 #define V4L2_SDR_FMT_CS14LE v4l2_fourcc('C', 'S', '1', '4') /* complex s14le */
4366 #define V4L2_SDR_FMT_RU12LE v4l2_fourcc('R', 'U', '1', '2') /* real u12le */
4367 #define V4L2_SDR_FMT_PCU16BE v4l2_fourcc('P', 'C', '1', '6') /* planar complex u16be */
4368 #define V4L2_SDR_FMT_PCU18BE v4l2_fourcc('P', 'C', '1', '8') /* planar complex u18be */
4369 #define V4L2_SDR_FMT_PCU20BE v4l2_fourcc('P', 'C', '2', '0') /* planar complex u20be */
4370
4371 /* Touch formats - used for Touch devices */
4372 #define V4L2_TCH_FMT_DELTA_TD16 v4l2_fourcc('T', 'D', '1', '6') /* 16-bit signed deltas */
4373 #define V4L2_TCH_FMT_DELTA_TD08 v4l2_fourcc('T', 'D', '0', '8') /* 8-bit signed deltas */
4374 #define V4L2_TCH_FMT_TU16 v4l2_fourcc('T', 'U', '1', '6') /* 16-bit unsigned touch data */
4375 #define V4L2_TCH_FMT_TU08 v4l2_fourcc('T', 'U', '0', '8') /* 8-bit unsigned touch data */
4376
4377 /* Meta-data formats */
4378 #define V4L2_META_FMT_VSP1_HGO v4l2_fourcc('V', 'S', 'P', 'H') /* R-Car VSP1 1-D Histogram */
4379 #define V4L2_META_FMT_VSP1_HGT v4l2_fourcc('V', 'S', 'P', 'T') /* R-Car VSP1 2-D Histogram */
4380 #define V4L2_META_FMT_UVC v4l2_fourcc('U', 'V', 'C', 'H') /* UVC Payload Header metadata */
4381 #define V4L2_META_FMT_D4XX v4l2_fourcc('D', '4', 'X', 'X') /* D4XX Payload Header metadata */
4382 #define V4L2_META_FMT_VIVID v4l2_fourcc('V', 'I', 'V', 'D') /* Vivid Metadata */
4383
4384 /* Vendor specific - used for RK_ISP1 camera sub-system */
4385 #define V4L2_META_FMT_RK_ISP1_PARAMS v4l2_fourcc('R', 'K', '1', 'P') /* Rockchip ISP1 3A Parameters */
4386 #define V4L2_META_FMT_RK_ISP1_STAT_3A v4l2_fourcc('R', 'K', '1', 'S') /* Rockchip ISP1 3A Statistics */
4387 #define V4L2_META_FMT_RK_ISP1_EXT_PARAMS v4l2_fourcc('R', 'K', '1', 'E') /* Rockchip ISP1 3a Extensible Parameters */
4388
4389 /* Vendor specific - used for RaspberryPi PiSP */
4390 #define V4L2_META_FMT_RPI_BE_CFG v4l2_fourcc('R', 'P', 'B', 'C') /* PiSP BE configuration */
4391 #define V4L2_META_FMT_RPI_FE_CFG v4l2_fourcc('R', 'P', 'F', 'C') /* PiSP FE configuration */
4392 #define V4L2_META_FMT_RPI_FE_STATS v4l2_fourcc('R', 'P', 'F', 'S') /* PiSP FE stats */
4393
4394 /* priv field value to indicates that subsequent fields are valid. */
4395 #define V4L2_PIX_FMT_PRIV_MAGIC 0xfeedcafe
4396
4397 /* Flags */
4398 #define V4L2_PIX_FMT_FLAG_PREMUL_ALPHA 0x00000001
4399 #define V4L2_PIX_FMT_FLAG_SET_CSC 0x00000002
4400
4401 /*
4402 * F O R M A T E N U M E R A T I O N
4403 */
4404 struct v4l2_fmtdesc {
4405 u_int32_t index; /* Format number */
4406 u_int32_t type; /* enum v4l2_buf_type */
4407 u_int32_t flags;
4408 u_int8_t description[32]; /* Description string */
4409 u_int32_t pixelformat; /* Format fourcc */
4410 u_int32_t mbus_code; /* Media bus code */
4411 u_int32_t reserved[3];
4412 };
4413
4414 #define V4L2_FMT_FLAG_COMPRESSED 0x0001
4415 #define V4L2_FMT_FLAG_EMULATED 0x0002
4416 #define V4L2_FMT_FLAG_CONTINUOUS_BYTESTREAM 0x0004
4417 #define V4L2_FMT_FLAG_DYN_RESOLUTION 0x0008
4418 #define V4L2_FMT_FLAG_ENC_CAP_FRAME_INTERVAL 0x0010
4419 #define V4L2_FMT_FLAG_CSC_COLORSPACE 0x0020
4420 #define V4L2_FMT_FLAG_CSC_XFER_FUNC 0x0040
4421 #define V4L2_FMT_FLAG_CSC_YCBCR_ENC 0x0080
4422 #define V4L2_FMT_FLAG_CSC_HSV_ENC V4L2_FMT_FLAG_CSC_YCBCR_ENC
4423 #define V4L2_FMT_FLAG_CSC_QUANTIZATION 0x0100
4424 #define V4L2_FMT_FLAG_META_LINE_BASED 0x0200
4425
4426 /* Format description flag, to be ORed with the index */
4427 #define V4L2_FMTDESC_FLAG_ENUM_ALL 0x80000000
4428
4429 /* Frame Size and frame rate enumeration */
4430 /*
4431 * F R A M E S I Z E E N U M E R A T I O N
4432 */
4433 enum v4l2_frmsizetypes {
4434 V4L2_FRMSIZE_TYPE_DISCRETE = 1,
4435 V4L2_FRMSIZE_TYPE_CONTINUOUS = 2,
4436 V4L2_FRMSIZE_TYPE_STEPWISE = 3,
4437 };
4438
4439 struct v4l2_frmsize_discrete {
4440 u_int32_t width; /* Frame width [pixel] */
4441 u_int32_t height; /* Frame height [pixel] */
4442 };
4443
4444 struct v4l2_frmsize_stepwise {
4445 u_int32_t min_width; /* Minimum frame width [pixel] */
4446 u_int32_t max_width; /* Maximum frame width [pixel] */
4447 u_int32_t step_width; /* Frame width step size [pixel] */
4448 u_int32_t min_height; /* Minimum frame height [pixel] */
4449 u_int32_t max_height; /* Maximum frame height [pixel] */
4450 u_int32_t step_height; /* Frame height step size [pixel] */
4451 };
4452
4453 struct v4l2_frmsizeenum {
4454 u_int32_t index; /* Frame size number */
4455 u_int32_t pixel_format; /* Pixel format */
4456 u_int32_t type; /* Frame size type the device supports. */
4457
4458 union { /* Frame size */
4459 struct v4l2_frmsize_discrete discrete;
4460 struct v4l2_frmsize_stepwise stepwise;
4461 };
4462
4463 u_int32_t reserved[2]; /* Reserved space for future use */
4464 };
4465
4466 /*
4467 * F R A M E R A T E E N U M E R A T I O N
4468 */
4469 enum v4l2_frmivaltypes {
4470 V4L2_FRMIVAL_TYPE_DISCRETE = 1,
4471 V4L2_FRMIVAL_TYPE_CONTINUOUS = 2,
4472 V4L2_FRMIVAL_TYPE_STEPWISE = 3,
4473 };
4474
4475 struct v4l2_frmival_stepwise {
4476 struct v4l2_fract min; /* Minimum frame interval [s] */
4477 struct v4l2_fract max; /* Maximum frame interval [s] */
4478 struct v4l2_fract step; /* Frame interval step size [s] */
4479 };
4480
4481 struct v4l2_frmivalenum {
4482 u_int32_t index; /* Frame format index */
4483 u_int32_t pixel_format; /* Pixel format */
4484 u_int32_t width; /* Frame width */
4485 u_int32_t height; /* Frame height */
4486 u_int32_t type; /* Frame interval type the device supports. */
4487
4488 union { /* Frame interval */
4489 struct v4l2_fract discrete;
4490 struct v4l2_frmival_stepwise stepwise;
4491 };
4492
4493 u_int32_t reserved[2]; /* Reserved space for future use */
4494 };
4495
4496 /*
4497 * T I M E C O D E
4498 */
4499 struct v4l2_timecode {
4500 u_int32_t type;
4501 u_int32_t flags;
4502 u_int8_t frames;
4503 u_int8_t seconds;
4504 u_int8_t minutes;
4505 u_int8_t hours;
4506 u_int8_t userbits[4];
4507 };
4508
4509 /* Type */
4510 #define V4L2_TC_TYPE_24FPS 1
4511 #define V4L2_TC_TYPE_25FPS 2
4512 #define V4L2_TC_TYPE_30FPS 3
4513 #define V4L2_TC_TYPE_50FPS 4
4514 #define V4L2_TC_TYPE_60FPS 5
4515
4516 /* Flags */
4517 #define V4L2_TC_FLAG_DROPFRAME 0x0001 /* "drop-frame" mode */
4518 #define V4L2_TC_FLAG_COLORFRAME 0x0002
4519 #define V4L2_TC_USERBITS_field 0x000C
4520 #define V4L2_TC_USERBITS_USERDEFINED 0x0000
4521 #define V4L2_TC_USERBITS_8BITCHARS 0x0008
4522 /* The above is based on SMPTE timecodes */
4523
4524 struct v4l2_jpegcompression {
4525 int quality;
4526
4527 int APPn; /* Number of APP segment to be written,
4528 * must be 0..15 */
4529 int APP_len; /* Length of data in JPEG APPn segment */
4530 char APP_data[60]; /* Data in the JPEG APPn segment. */
4531
4532 int COM_len; /* Length of data in JPEG COM segment */
4533 char COM_data[60]; /* Data in JPEG COM segment */
4534
4535 u_int32_t jpeg_markers; /* Which markers should go into the JPEG
4536 * output. Unless you exactly know what
4537 * you do, leave them untouched.
4538 * Including less markers will make the
4539 * resulting code smaller, but there will
4540 * be fewer applications which can read it.
4541 * The presence of the APP and COM marker
4542 * is influenced by APP_len and COM_len
4543 * ONLY, not by this property! */
4544
4545 #define V4L2_JPEG_MARKER_DHT (1<<3) /* Define Huffman Tables */
4546 #define V4L2_JPEG_MARKER_DQT (1<<4) /* Define Quantization Tables */
4547 #define V4L2_JPEG_MARKER_DRI (1<<5) /* Define Restart Interval */
4548 #define V4L2_JPEG_MARKER_COM (1<<6) /* Comment segment */
4549 #define V4L2_JPEG_MARKER_APP (1<<7) /* App segment, driver will
4550 * always use APP0 */
4551 };
4552
4553 /*
4554 * M E M O R Y - M A P P I N G B U F F E R S
4555 */
4556
4557 struct v4l2_requestbuffers {
4558 u_int32_t count;
4559 u_int32_t type; /* enum v4l2_buf_type */
4560 u_int32_t memory; /* enum v4l2_memory */
4561 u_int32_t capabilities;
4562 u_int8_t flags;
4563 u_int8_t reserved[3];
4564 };
4565
4566 #define V4L2_MEMORY_FLAG_NON_COHERENT (1 << 0)
4567
4568 /* capabilities for struct v4l2_requestbuffers and v4l2_create_buffers */
4569 #define V4L2_BUF_CAP_SUPPORTS_MMAP (1 << 0)
4570 #define V4L2_BUF_CAP_SUPPORTS_USERPTR (1 << 1)
4571 #define V4L2_BUF_CAP_SUPPORTS_DMABUF (1 << 2)
4572 #define V4L2_BUF_CAP_SUPPORTS_REQUESTS (1 << 3)
4573 #define V4L2_BUF_CAP_SUPPORTS_ORPHANED_BUFS (1 << 4)
4574 #define V4L2_BUF_CAP_SUPPORTS_M2M_HOLD_CAPTURE_BUF (1 << 5)
4575 #define V4L2_BUF_CAP_SUPPORTS_MMAP_CACHE_HINTS (1 << 6)
4576 #define V4L2_BUF_CAP_SUPPORTS_MAX_NUM_BUFFERS (1 << 7)
4577 #define V4L2_BUF_CAP_SUPPORTS_REMOVE_BUFS (1 << 8)
4578
4579 /**
4580 * struct v4l2_plane - plane info for multi-planar buffers
4581 * @bytesused: number of bytes occupied by data in the plane (payload)
4582 * @length: size of this plane (NOT the payload) in bytes
4583 * @m.mem_offset: when memory in the associated struct v4l2_buffer is
4584 * V4L2_MEMORY_MMAP, equals the offset from the start of
4585 * the device memory for this plane (or is a "cookie" that
4586 * should be passed to mmap() called on the video node)
4587 * @m.userptr: when memory is V4L2_MEMORY_USERPTR, a userspace pointer
4588 * pointing to this plane
4589 * @m.fd: when memory is V4L2_MEMORY_DMABUF, a userspace file
4590 * descriptor associated with this plane
4591 * @m: union of @mem_offset, @userptr and @fd
4592 * @data_offset: offset in the plane to the start of data; usually 0,
4593 * unless there is a header in front of the data
4594 * @reserved: drivers and applications must zero this array
4595 *
4596 * Multi-planar buffers consist of one or more planes, e.g. an YCbCr buffer
4597 * with two planes can have one plane for Y, and another for interleaved CbCr
4598 * components. Each plane can reside in a separate memory buffer, or even in
4599 * a completely separate memory node (e.g. in embedded devices).
4600 */
4601 struct v4l2_plane {
4602 u_int32_t bytesused;
4603 u_int32_t length;
4604 union {
4605 u_int32_t mem_offset;
4606 unsigned long userptr;
4607 int32_t fd;
4608 } m;
4609 u_int32_t data_offset;
4610 u_int32_t reserved[11];
4611 };
4612
4613 /**
4614 * struct v4l2_buffer - video buffer info
4615 * @index: id number of the buffer
4616 * @type: enum v4l2_buf_type; buffer type (type == *_MPLANE for
4617 * multiplanar buffers);
4618 * @bytesused: number of bytes occupied by data in the buffer (payload);
4619 * unused (set to 0) for multiplanar buffers
4620 * @flags: buffer informational flags
4621 * @field: enum v4l2_field; field order of the image in the buffer
4622 * @timestamp: frame timestamp
4623 * @timecode: frame timecode
4624 * @sequence: sequence count of this frame
4625 * @memory: enum v4l2_memory; the method, in which the actual video data is
4626 * passed
4627 * @m.offset: for non-multiplanar buffers with memory == V4L2_MEMORY_MMAP;
4628 * offset from the start of the device memory for this plane,
4629 * (or a "cookie" that should be passed to mmap() as offset)
4630 * @m.userptr: for non-multiplanar buffers with memory == V4L2_MEMORY_USERPTR;
4631 * a userspace pointer pointing to this buffer
4632 * @m.fd: for non-multiplanar buffers with memory == V4L2_MEMORY_DMABUF;
4633 * a userspace file descriptor associated with this buffer
4634 * @m.planes: for multiplanar buffers; userspace pointer to the array of plane
4635 * info structs for this buffer
4636 * @m: union of @offset, @userptr, @planes and @fd
4637 * @length: size in bytes of the buffer (NOT its payload) for single-plane
4638 * buffers (when type != *_MPLANE); number of elements in the
4639 * planes array for multi-plane buffers
4640 * @reserved2: drivers and applications must zero this field
4641 * @request_fd: fd of the request that this buffer should use
4642 * @reserved: for backwards compatibility with applications that do not know
4643 * about @request_fd
4644 *
4645 * Contains data exchanged by application and driver using one of the Streaming
4646 * I/O methods.
4647 */
4648 struct v4l2_buffer {
4649 u_int32_t index;
4650 u_int32_t type;
4651 u_int32_t bytesused;
4652 u_int32_t flags;
4653 u_int32_t field;
4654 struct timeval timestamp;
4655 struct v4l2_timecode timecode;
4656 u_int32_t sequence;
4657
4658 /* memory location */
4659 u_int32_t memory;
4660 union {
4661 u_int32_t offset;
4662 unsigned long userptr;
4663 struct v4l2_plane *planes;
4664 int32_t fd;
4665 } m;
4666 u_int32_t length;
4667 u_int32_t reserved2;
4668 union {
4669 int32_t request_fd;
4670 u_int32_t reserved;
4671 };
4672 };
4673
4674 /**
4675 * v4l2_timeval_to_ns - Convert timeval to nanoseconds
4676 * @tv: pointer to the timeval variable to be converted
4677 *
4678 * Returns the scalar nanosecond representation of the timeval
4679 * parameter.
4680 */
v4l2_timeval_to_ns(const struct timeval * tv)4681 static inline u_int64_t v4l2_timeval_to_ns(const struct timeval *tv)
4682 {
4683 return (u_int64_t)tv->tv_sec * 1000000000ULL + tv->tv_usec * 1000;
4684 }
4685
4686 /* Flags for 'flags' field */
4687 /* Buffer is mapped (flag) */
4688 #define V4L2_BUF_FLAG_MAPPED 0x00000001
4689 /* Buffer is queued for processing */
4690 #define V4L2_BUF_FLAG_QUEUED 0x00000002
4691 /* Buffer is ready */
4692 #define V4L2_BUF_FLAG_DONE 0x00000004
4693 /* Image is a keyframe (I-frame) */
4694 #define V4L2_BUF_FLAG_KEYFRAME 0x00000008
4695 /* Image is a P-frame */
4696 #define V4L2_BUF_FLAG_PFRAME 0x00000010
4697 /* Image is a B-frame */
4698 #define V4L2_BUF_FLAG_BFRAME 0x00000020
4699 /* Buffer is ready, but the data contained within is corrupted. */
4700 #define V4L2_BUF_FLAG_ERROR 0x00000040
4701 /* Buffer is added to an unqueued request */
4702 #define V4L2_BUF_FLAG_IN_REQUEST 0x00000080
4703 /* timecode field is valid */
4704 #define V4L2_BUF_FLAG_TIMECODE 0x00000100
4705 /* Don't return the capture buffer until OUTPUT timestamp changes */
4706 #define V4L2_BUF_FLAG_M2M_HOLD_CAPTURE_BUF 0x00000200
4707 /* Buffer is prepared for queuing */
4708 #define V4L2_BUF_FLAG_PREPARED 0x00000400
4709 /* Cache handling flags */
4710 #define V4L2_BUF_FLAG_NO_CACHE_INVALIDATE 0x00000800
4711 #define V4L2_BUF_FLAG_NO_CACHE_CLEAN 0x00001000
4712 /* Timestamp type */
4713 #define V4L2_BUF_FLAG_TIMESTAMP_MASK 0x0000e000
4714 #define V4L2_BUF_FLAG_TIMESTAMP_UNKNOWN 0x00000000
4715 #define V4L2_BUF_FLAG_TIMESTAMP_MONOTONIC 0x00002000
4716 #define V4L2_BUF_FLAG_TIMESTAMP_COPY 0x00004000
4717 /* Timestamp sources. */
4718 #define V4L2_BUF_FLAG_TSTAMP_SRC_MASK 0x00070000
4719 #define V4L2_BUF_FLAG_TSTAMP_SRC_EOF 0x00000000
4720 #define V4L2_BUF_FLAG_TSTAMP_SRC_SOE 0x00010000
4721 /* mem2mem encoder/decoder */
4722 #define V4L2_BUF_FLAG_LAST 0x00100000
4723 /* request_fd is valid */
4724 #define V4L2_BUF_FLAG_REQUEST_FD 0x00800000
4725
4726 /**
4727 * struct v4l2_exportbuffer - export of video buffer as DMABUF file descriptor
4728 *
4729 * @index: id number of the buffer
4730 * @type: enum v4l2_buf_type; buffer type (type == *_MPLANE for
4731 * multiplanar buffers);
4732 * @plane: index of the plane to be exported, 0 for single plane queues
4733 * @flags: flags for newly created file, currently only O_CLOEXEC is
4734 * supported, refer to manual of open syscall for more details
4735 * @fd: file descriptor associated with DMABUF (set by driver)
4736 * @reserved: drivers and applications must zero this array
4737 *
4738 * Contains data used for exporting a video buffer as DMABUF file descriptor.
4739 * The buffer is identified by a 'cookie' returned by VIDIOC_QUERYBUF
4740 * (identical to the cookie used to mmap() the buffer to userspace). All
4741 * reserved fields must be set to zero. The field reserved0 is expected to
4742 * become a structure 'type' allowing an alternative layout of the structure
4743 * content. Therefore this field should not be used for any other extensions.
4744 */
4745 struct v4l2_exportbuffer {
4746 u_int32_t type; /* enum v4l2_buf_type */
4747 u_int32_t index;
4748 u_int32_t plane;
4749 u_int32_t flags;
4750 int32_t fd;
4751 u_int32_t reserved[11];
4752 };
4753
4754 /*
4755 * O V E R L A Y P R E V I E W
4756 */
4757 struct v4l2_framebuffer {
4758 u_int32_t capability;
4759 u_int32_t flags;
4760 /* FIXME: in theory we should pass something like PCI device + memory
4761 * region + offset instead of some physical address */
4762 void *base;
4763 struct {
4764 u_int32_t width;
4765 u_int32_t height;
4766 u_int32_t pixelformat;
4767 u_int32_t field; /* enum v4l2_field */
4768 u_int32_t bytesperline; /* for padding, zero if unused */
4769 u_int32_t sizeimage;
4770 u_int32_t colorspace; /* enum v4l2_colorspace */
4771 u_int32_t priv; /* reserved field, set to 0 */
4772 } fmt;
4773 };
4774 /* Flags for the 'capability' field. Read only */
4775 #define V4L2_FBUF_CAP_EXTERNOVERLAY 0x0001
4776 #define V4L2_FBUF_CAP_CHROMAKEY 0x0002
4777 #define V4L2_FBUF_CAP_LIST_CLIPPING 0x0004
4778 #define V4L2_FBUF_CAP_BITMAP_CLIPPING 0x0008
4779 #define V4L2_FBUF_CAP_LOCAL_ALPHA 0x0010
4780 #define V4L2_FBUF_CAP_GLOBAL_ALPHA 0x0020
4781 #define V4L2_FBUF_CAP_LOCAL_INV_ALPHA 0x0040
4782 #define V4L2_FBUF_CAP_SRC_CHROMAKEY 0x0080
4783 /* Flags for the 'flags' field. */
4784 #define V4L2_FBUF_FLAG_PRIMARY 0x0001
4785 #define V4L2_FBUF_FLAG_OVERLAY 0x0002
4786 #define V4L2_FBUF_FLAG_CHROMAKEY 0x0004
4787 #define V4L2_FBUF_FLAG_LOCAL_ALPHA 0x0008
4788 #define V4L2_FBUF_FLAG_GLOBAL_ALPHA 0x0010
4789 #define V4L2_FBUF_FLAG_LOCAL_INV_ALPHA 0x0020
4790 #define V4L2_FBUF_FLAG_SRC_CHROMAKEY 0x0040
4791
4792 struct v4l2_clip {
4793 struct v4l2_rect c;
4794 struct v4l2_clip __user *next;
4795 };
4796
4797 struct v4l2_window {
4798 struct v4l2_rect w;
4799 u_int32_t field; /* enum v4l2_field */
4800 u_int32_t chromakey;
4801 struct v4l2_clip *clips;
4802 u_int32_t clipcount;
4803 void __user *bitmap;
4804 u_int8_t global_alpha;
4805 };
4806
4807 /*
4808 * C A P T U R E P A R A M E T E R S
4809 */
4810 struct v4l2_captureparm {
4811 u_int32_t capability; /* Supported modes */
4812 u_int32_t capturemode; /* Current mode */
4813 struct v4l2_fract timeperframe; /* Time per frame in seconds */
4814 u_int32_t extendedmode; /* Driver-specific extensions */
4815 u_int32_t readbuffers; /* # of buffers for read */
4816 u_int32_t reserved[4];
4817 };
4818
4819 /* Flags for 'capability' and 'capturemode' fields */
4820 #define V4L2_MODE_HIGHQUALITY 0x0001 /* High quality imaging mode */
4821 #define V4L2_CAP_TIMEPERFRAME 0x1000 /* timeperframe field is supported */
4822
4823 struct v4l2_outputparm {
4824 u_int32_t capability; /* Supported modes */
4825 u_int32_t outputmode; /* Current mode */
4826 struct v4l2_fract timeperframe; /* Time per frame in seconds */
4827 u_int32_t extendedmode; /* Driver-specific extensions */
4828 u_int32_t writebuffers; /* # of buffers for write */
4829 u_int32_t reserved[4];
4830 };
4831
4832 /*
4833 * I N P U T I M A G E C R O P P I N G
4834 */
4835 struct v4l2_cropcap {
4836 u_int32_t type; /* enum v4l2_buf_type */
4837 struct v4l2_rect bounds;
4838 struct v4l2_rect defrect;
4839 struct v4l2_fract pixelaspect;
4840 };
4841
4842 struct v4l2_crop {
4843 u_int32_t type; /* enum v4l2_buf_type */
4844 struct v4l2_rect c;
4845 };
4846
4847 /**
4848 * struct v4l2_selection - selection info
4849 * @type: buffer type (do not use *_MPLANE types)
4850 * @target: Selection target, used to choose one of possible rectangles;
4851 * defined in v4l2-common.h; V4L2_SEL_TGT_* .
4852 * @flags: constraints flags, defined in v4l2-common.h; V4L2_SEL_FLAG_*.
4853 * @r: coordinates of selection window
4854 * @reserved: for future use, rounds structure size to 64 bytes, set to zero
4855 *
4856 * Hardware may use multiple helper windows to process a video stream.
4857 * The structure is used to exchange this selection areas between
4858 * an application and a driver.
4859 */
4860 struct v4l2_selection {
4861 u_int32_t type;
4862 u_int32_t target;
4863 u_int32_t flags;
4864 struct v4l2_rect r;
4865 u_int32_t reserved[9];
4866 };
4867
4868
4869 /*
4870 * A N A L O G V I D E O S T A N D A R D
4871 */
4872
4873 typedef u_int64_t v4l2_std_id;
4874
4875 /*
4876 * Attention: Keep the V4L2_STD_* bit definitions in sync with
4877 * include/dt-bindings/display/sdtv-standards.h SDTV_STD_* bit definitions.
4878 */
4879 /* one bit for each */
4880 #define V4L2_STD_PAL_B ((v4l2_std_id)0x00000001)
4881 #define V4L2_STD_PAL_B1 ((v4l2_std_id)0x00000002)
4882 #define V4L2_STD_PAL_G ((v4l2_std_id)0x00000004)
4883 #define V4L2_STD_PAL_H ((v4l2_std_id)0x00000008)
4884 #define V4L2_STD_PAL_I ((v4l2_std_id)0x00000010)
4885 #define V4L2_STD_PAL_D ((v4l2_std_id)0x00000020)
4886 #define V4L2_STD_PAL_D1 ((v4l2_std_id)0x00000040)
4887 #define V4L2_STD_PAL_K ((v4l2_std_id)0x00000080)
4888
4889 #define V4L2_STD_PAL_M ((v4l2_std_id)0x00000100)
4890 #define V4L2_STD_PAL_N ((v4l2_std_id)0x00000200)
4891 #define V4L2_STD_PAL_Nc ((v4l2_std_id)0x00000400)
4892 #define V4L2_STD_PAL_60 ((v4l2_std_id)0x00000800)
4893
4894 #define V4L2_STD_NTSC_M ((v4l2_std_id)0x00001000) /* BTSC */
4895 #define V4L2_STD_NTSC_M_JP ((v4l2_std_id)0x00002000) /* EIA-J */
4896 #define V4L2_STD_NTSC_443 ((v4l2_std_id)0x00004000)
4897 #define V4L2_STD_NTSC_M_KR ((v4l2_std_id)0x00008000) /* FM A2 */
4898
4899 #define V4L2_STD_SECAM_B ((v4l2_std_id)0x00010000)
4900 #define V4L2_STD_SECAM_D ((v4l2_std_id)0x00020000)
4901 #define V4L2_STD_SECAM_G ((v4l2_std_id)0x00040000)
4902 #define V4L2_STD_SECAM_H ((v4l2_std_id)0x00080000)
4903 #define V4L2_STD_SECAM_K ((v4l2_std_id)0x00100000)
4904 #define V4L2_STD_SECAM_K1 ((v4l2_std_id)0x00200000)
4905 #define V4L2_STD_SECAM_L ((v4l2_std_id)0x00400000)
4906 #define V4L2_STD_SECAM_LC ((v4l2_std_id)0x00800000)
4907
4908 /* ATSC/HDTV */
4909 #define V4L2_STD_ATSC_8_VSB ((v4l2_std_id)0x01000000)
4910 #define V4L2_STD_ATSC_16_VSB ((v4l2_std_id)0x02000000)
4911
4912 /* FIXME:
4913 Although std_id is 64 bits, there is an issue on PPC32 architecture that
4914 makes switch(u_int64_t) to break. So, there's a hack on v4l2-common.c rounding
4915 this value to 32 bits.
4916 As, currently, the max value is for V4L2_STD_ATSC_16_VSB (30 bits wide),
4917 it should work fine. However, if needed to add more than two standards,
4918 v4l2-common.c should be fixed.
4919 */
4920
4921 /*
4922 * Some macros to merge video standards in order to make live easier for the
4923 * drivers and V4L2 applications
4924 */
4925
4926 /*
4927 * "Common" NTSC/M - It should be noticed that V4L2_STD_NTSC_443 is
4928 * Missing here.
4929 */
4930 #define V4L2_STD_NTSC (V4L2_STD_NTSC_M |\
4931 V4L2_STD_NTSC_M_JP |\
4932 V4L2_STD_NTSC_M_KR)
4933 /* Secam macros */
4934 #define V4L2_STD_SECAM_DK (V4L2_STD_SECAM_D |\
4935 V4L2_STD_SECAM_K |\
4936 V4L2_STD_SECAM_K1)
4937 /* All Secam Standards */
4938 #define V4L2_STD_SECAM (V4L2_STD_SECAM_B |\
4939 V4L2_STD_SECAM_G |\
4940 V4L2_STD_SECAM_H |\
4941 V4L2_STD_SECAM_DK |\
4942 V4L2_STD_SECAM_L |\
4943 V4L2_STD_SECAM_LC)
4944 /* PAL macros */
4945 #define V4L2_STD_PAL_BG (V4L2_STD_PAL_B |\
4946 V4L2_STD_PAL_B1 |\
4947 V4L2_STD_PAL_G)
4948 #define V4L2_STD_PAL_DK (V4L2_STD_PAL_D |\
4949 V4L2_STD_PAL_D1 |\
4950 V4L2_STD_PAL_K)
4951 /*
4952 * "Common" PAL - This macro is there to be compatible with the old
4953 * V4L1 concept of "PAL": /BGDKHI.
4954 * Several PAL standards are missing here: /M, /N and /Nc
4955 */
4956 #define V4L2_STD_PAL (V4L2_STD_PAL_BG |\
4957 V4L2_STD_PAL_DK |\
4958 V4L2_STD_PAL_H |\
4959 V4L2_STD_PAL_I)
4960 /* Chroma "agnostic" standards */
4961 #define V4L2_STD_B (V4L2_STD_PAL_B |\
4962 V4L2_STD_PAL_B1 |\
4963 V4L2_STD_SECAM_B)
4964 #define V4L2_STD_G (V4L2_STD_PAL_G |\
4965 V4L2_STD_SECAM_G)
4966 #define V4L2_STD_H (V4L2_STD_PAL_H |\
4967 V4L2_STD_SECAM_H)
4968 #define V4L2_STD_L (V4L2_STD_SECAM_L |\
4969 V4L2_STD_SECAM_LC)
4970 #define V4L2_STD_GH (V4L2_STD_G |\
4971 V4L2_STD_H)
4972 #define V4L2_STD_DK (V4L2_STD_PAL_DK |\
4973 V4L2_STD_SECAM_DK)
4974 #define V4L2_STD_BG (V4L2_STD_B |\
4975 V4L2_STD_G)
4976 #define V4L2_STD_MN (V4L2_STD_PAL_M |\
4977 V4L2_STD_PAL_N |\
4978 V4L2_STD_PAL_Nc |\
4979 V4L2_STD_NTSC)
4980
4981 /* Standards where MTS/BTSC stereo could be found */
4982 #define V4L2_STD_MTS (V4L2_STD_NTSC_M |\
4983 V4L2_STD_PAL_M |\
4984 V4L2_STD_PAL_N |\
4985 V4L2_STD_PAL_Nc)
4986
4987 /* Standards for Countries with 60Hz Line frequency */
4988 #define V4L2_STD_525_60 (V4L2_STD_PAL_M |\
4989 V4L2_STD_PAL_60 |\
4990 V4L2_STD_NTSC |\
4991 V4L2_STD_NTSC_443)
4992 /* Standards for Countries with 50Hz Line frequency */
4993 #define V4L2_STD_625_50 (V4L2_STD_PAL |\
4994 V4L2_STD_PAL_N |\
4995 V4L2_STD_PAL_Nc |\
4996 V4L2_STD_SECAM)
4997
4998 #define V4L2_STD_ATSC (V4L2_STD_ATSC_8_VSB |\
4999 V4L2_STD_ATSC_16_VSB)
5000 /* Macros with none and all analog standards */
5001 #define V4L2_STD_UNKNOWN 0
5002 #define V4L2_STD_ALL (V4L2_STD_525_60 |\
5003 V4L2_STD_625_50)
5004
5005 struct v4l2_standard {
5006 u_int32_t index;
5007 v4l2_std_id id;
5008 u_int8_t name[24];
5009 struct v4l2_fract frameperiod; /* Frames, not fields */
5010 u_int32_t framelines;
5011 u_int32_t reserved[4];
5012 };
5013
5014 /*
5015 * D V B T T I M I N G S
5016 */
5017
5018 /** struct v4l2_bt_timings - BT.656/BT.1120 timing data
5019 * @width: total width of the active video in pixels
5020 * @height: total height of the active video in lines
5021 * @interlaced: Interlaced or progressive
5022 * @polarities: Positive or negative polarities
5023 * @pixelclock: Pixel clock in HZ. Ex. 74.25MHz->74250000
5024 * @hfrontporch:Horizontal front porch in pixels
5025 * @hsync: Horizontal Sync length in pixels
5026 * @hbackporch: Horizontal back porch in pixels
5027 * @vfrontporch:Vertical front porch in lines
5028 * @vsync: Vertical Sync length in lines
5029 * @vbackporch: Vertical back porch in lines
5030 * @il_vfrontporch:Vertical front porch for the even field
5031 * (aka field 2) of interlaced field formats
5032 * @il_vsync: Vertical Sync length for the even field
5033 * (aka field 2) of interlaced field formats
5034 * @il_vbackporch:Vertical back porch for the even field
5035 * (aka field 2) of interlaced field formats
5036 * @standards: Standards the timing belongs to
5037 * @flags: Flags
5038 * @picture_aspect: The picture aspect ratio (hor/vert).
5039 * @cea861_vic: VIC code as per the CEA-861 standard.
5040 * @hdmi_vic: VIC code as per the HDMI standard.
5041 * @reserved: Reserved fields, must be zeroed.
5042 *
5043 * A note regarding vertical interlaced timings: height refers to the total
5044 * height of the active video frame (= two fields). The blanking timings refer
5045 * to the blanking of each field. So the height of the total frame is
5046 * calculated as follows:
5047 *
5048 * tot_height = height + vfrontporch + vsync + vbackporch +
5049 * il_vfrontporch + il_vsync + il_vbackporch
5050 *
5051 * The active height of each field is height / 2.
5052 */
5053 struct v4l2_bt_timings {
5054 u_int32_t width;
5055 u_int32_t height;
5056 u_int32_t interlaced;
5057 u_int32_t polarities;
5058 u_int64_t pixelclock;
5059 u_int32_t hfrontporch;
5060 u_int32_t hsync;
5061 u_int32_t hbackporch;
5062 u_int32_t vfrontporch;
5063 u_int32_t vsync;
5064 u_int32_t vbackporch;
5065 u_int32_t il_vfrontporch;
5066 u_int32_t il_vsync;
5067 u_int32_t il_vbackporch;
5068 u_int32_t standards;
5069 u_int32_t flags;
5070 struct v4l2_fract picture_aspect;
5071 u_int8_t cea861_vic;
5072 u_int8_t hdmi_vic;
5073 u_int8_t reserved[46];
5074 } __attribute__ ((packed));
5075
5076 /* Interlaced or progressive format */
5077 #define V4L2_DV_PROGRESSIVE 0
5078 #define V4L2_DV_INTERLACED 1
5079
5080 /* Polarities. If bit is not set, it is assumed to be negative polarity */
5081 #define V4L2_DV_VSYNC_POS_POL 0x00000001
5082 #define V4L2_DV_HSYNC_POS_POL 0x00000002
5083
5084 /* Timings standards */
5085 #define V4L2_DV_BT_STD_CEA861 (1 << 0) /* CEA-861 Digital TV Profile */
5086 #define V4L2_DV_BT_STD_DMT (1 << 1) /* VESA Discrete Monitor Timings */
5087 #define V4L2_DV_BT_STD_CVT (1 << 2) /* VESA Coordinated Video Timings */
5088 #define V4L2_DV_BT_STD_GTF (1 << 3) /* VESA Generalized Timings Formula */
5089 #define V4L2_DV_BT_STD_SDI (1 << 4) /* SDI Timings */
5090
5091 /* Flags */
5092
5093 /*
5094 * CVT/GTF specific: timing uses reduced blanking (CVT) or the 'Secondary
5095 * GTF' curve (GTF). In both cases the horizontal and/or vertical blanking
5096 * intervals are reduced, allowing a higher resolution over the same
5097 * bandwidth. This is a read-only flag.
5098 */
5099 #define V4L2_DV_FL_REDUCED_BLANKING (1 << 0)
5100 /*
5101 * CEA-861 specific: set for CEA-861 formats with a framerate of a multiple
5102 * of six. These formats can be optionally played at 1 / 1.001 speed.
5103 * This is a read-only flag.
5104 */
5105 #define V4L2_DV_FL_CAN_REDUCE_FPS (1 << 1)
5106 /*
5107 * CEA-861 specific: only valid for video transmitters, the flag is cleared
5108 * by receivers.
5109 * If the framerate of the format is a multiple of six, then the pixelclock
5110 * used to set up the transmitter is divided by 1.001 to make it compatible
5111 * with 60 Hz based standards such as NTSC and PAL-M that use a framerate of
5112 * 29.97 Hz. Otherwise this flag is cleared. If the transmitter can't generate
5113 * such frequencies, then the flag will also be cleared.
5114 */
5115 #define V4L2_DV_FL_REDUCED_FPS (1 << 2)
5116 /*
5117 * Specific to interlaced formats: if set, then field 1 is really one half-line
5118 * longer and field 2 is really one half-line shorter, so each field has
5119 * exactly the same number of half-lines. Whether half-lines can be detected
5120 * or used depends on the hardware.
5121 */
5122 #define V4L2_DV_FL_HALF_LINE (1 << 3)
5123 /*
5124 * If set, then this is a Consumer Electronics (CE) video format. Such formats
5125 * differ from other formats (commonly called IT formats) in that if RGB
5126 * encoding is used then by default the RGB values use limited range (i.e.
5127 * use the range 16-235) as opposed to 0-255. All formats defined in CEA-861
5128 * except for the 640x480 format are CE formats.
5129 */
5130 #define V4L2_DV_FL_IS_CE_VIDEO (1 << 4)
5131 /* Some formats like SMPTE-125M have an interlaced signal with a odd
5132 * total height. For these formats, if this flag is set, the first
5133 * field has the extra line. If not, it is the second field.
5134 */
5135 #define V4L2_DV_FL_FIRST_FIELD_EXTRA_LINE (1 << 5)
5136 /*
5137 * If set, then the picture_aspect field is valid. Otherwise assume that the
5138 * pixels are square, so the picture aspect ratio is the same as the width to
5139 * height ratio.
5140 */
5141 #define V4L2_DV_FL_HAS_PICTURE_ASPECT (1 << 6)
5142 /*
5143 * If set, then the cea861_vic field is valid and contains the Video
5144 * Identification Code as per the CEA-861 standard.
5145 */
5146 #define V4L2_DV_FL_HAS_CEA861_VIC (1 << 7)
5147 /*
5148 * If set, then the hdmi_vic field is valid and contains the Video
5149 * Identification Code as per the HDMI standard (HDMI Vendor Specific
5150 * InfoFrame).
5151 */
5152 #define V4L2_DV_FL_HAS_HDMI_VIC (1 << 8)
5153 /*
5154 * CEA-861 specific: only valid for video receivers.
5155 * If set, then HW can detect the difference between regular FPS and
5156 * 1000/1001 FPS. Note: This flag is only valid for HDMI VIC codes with
5157 * the V4L2_DV_FL_CAN_REDUCE_FPS flag set.
5158 */
5159 #define V4L2_DV_FL_CAN_DETECT_REDUCED_FPS (1 << 9)
5160
5161 /* A few useful defines to calculate the total blanking and frame sizes */
5162 #define V4L2_DV_BT_BLANKING_WIDTH(bt) \
5163 ((bt)->hfrontporch + (bt)->hsync + (bt)->hbackporch)
5164 #define V4L2_DV_BT_FRAME_WIDTH(bt) \
5165 ((bt)->width + V4L2_DV_BT_BLANKING_WIDTH(bt))
5166 #define V4L2_DV_BT_BLANKING_HEIGHT(bt) \
5167 ((bt)->vfrontporch + (bt)->vsync + (bt)->vbackporch + \
5168 ((bt)->interlaced ? \
5169 ((bt)->il_vfrontporch + (bt)->il_vsync + (bt)->il_vbackporch) : 0))
5170 #define V4L2_DV_BT_FRAME_HEIGHT(bt) \
5171 ((bt)->height + V4L2_DV_BT_BLANKING_HEIGHT(bt))
5172
5173 /** struct v4l2_dv_timings - DV timings
5174 * @type: the type of the timings
5175 * @bt: BT656/1120 timings
5176 */
5177 struct v4l2_dv_timings {
5178 u_int32_t type;
5179 union {
5180 struct v4l2_bt_timings bt;
5181 u_int32_t reserved[32];
5182 };
5183 } __attribute__ ((packed));
5184
5185 /* Values for the type field */
5186 #define V4L2_DV_BT_656_1120 0 /* BT.656/1120 timing type */
5187
5188
5189 /** struct v4l2_enum_dv_timings - DV timings enumeration
5190 * @index: enumeration index
5191 * @pad: the pad number for which to enumerate timings (used with
5192 * v4l-subdev nodes only)
5193 * @reserved: must be zeroed
5194 * @timings: the timings for the given index
5195 */
5196 struct v4l2_enum_dv_timings {
5197 u_int32_t index;
5198 u_int32_t pad;
5199 u_int32_t reserved[2];
5200 struct v4l2_dv_timings timings;
5201 };
5202
5203 /** struct v4l2_bt_timings_cap - BT.656/BT.1120 timing capabilities
5204 * @min_width: width in pixels
5205 * @max_width: width in pixels
5206 * @min_height: height in lines
5207 * @max_height: height in lines
5208 * @min_pixelclock: Pixel clock in HZ. Ex. 74.25MHz->74250000
5209 * @max_pixelclock: Pixel clock in HZ. Ex. 74.25MHz->74250000
5210 * @standards: Supported standards
5211 * @capabilities: Supported capabilities
5212 * @reserved: Must be zeroed
5213 */
5214 struct v4l2_bt_timings_cap {
5215 u_int32_t min_width;
5216 u_int32_t max_width;
5217 u_int32_t min_height;
5218 u_int32_t max_height;
5219 u_int64_t min_pixelclock;
5220 u_int64_t max_pixelclock;
5221 u_int32_t standards;
5222 u_int32_t capabilities;
5223 u_int32_t reserved[16];
5224 } __attribute__ ((packed));
5225
5226 /* Supports interlaced formats */
5227 #define V4L2_DV_BT_CAP_INTERLACED (1 << 0)
5228 /* Supports progressive formats */
5229 #define V4L2_DV_BT_CAP_PROGRESSIVE (1 << 1)
5230 /* Supports CVT/GTF reduced blanking */
5231 #define V4L2_DV_BT_CAP_REDUCED_BLANKING (1 << 2)
5232 /* Supports custom formats */
5233 #define V4L2_DV_BT_CAP_CUSTOM (1 << 3)
5234
5235 /** struct v4l2_dv_timings_cap - DV timings capabilities
5236 * @type: the type of the timings (same as in struct v4l2_dv_timings)
5237 * @pad: the pad number for which to query capabilities (used with
5238 * v4l-subdev nodes only)
5239 * @bt: the BT656/1120 timings capabilities
5240 */
5241 struct v4l2_dv_timings_cap {
5242 u_int32_t type;
5243 u_int32_t pad;
5244 u_int32_t reserved[2];
5245 union {
5246 struct v4l2_bt_timings_cap bt;
5247 u_int32_t raw_data[32];
5248 };
5249 };
5250
5251
5252 /*
5253 * V I D E O I N P U T S
5254 */
5255 struct v4l2_input {
5256 u_int32_t index; /* Which input */
5257 u_int8_t name[32]; /* Label */
5258 u_int32_t type; /* Type of input */
5259 u_int32_t audioset; /* Associated audios (bitfield) */
5260 u_int32_t tuner; /* Tuner index */
5261 v4l2_std_id std;
5262 u_int32_t status;
5263 u_int32_t capabilities;
5264 u_int32_t reserved[3];
5265 };
5266
5267 /* Values for the 'type' field */
5268 #define V4L2_INPUT_TYPE_TUNER 1
5269 #define V4L2_INPUT_TYPE_CAMERA 2
5270 #define V4L2_INPUT_TYPE_TOUCH 3
5271
5272 /* field 'status' - general */
5273 #define V4L2_IN_ST_NO_POWER 0x00000001 /* Attached device is off */
5274 #define V4L2_IN_ST_NO_SIGNAL 0x00000002
5275 #define V4L2_IN_ST_NO_COLOR 0x00000004
5276
5277 /* field 'status' - sensor orientation */
5278 /* If sensor is mounted upside down set both bits */
5279 #define V4L2_IN_ST_HFLIP 0x00000010 /* Frames are flipped horizontally */
5280 #define V4L2_IN_ST_VFLIP 0x00000020 /* Frames are flipped vertically */
5281
5282 /* field 'status' - analog */
5283 #define V4L2_IN_ST_NO_H_LOCK 0x00000100 /* No horizontal sync lock */
5284 #define V4L2_IN_ST_COLOR_KILL 0x00000200 /* Color killer is active */
5285 #define V4L2_IN_ST_NO_V_LOCK 0x00000400 /* No vertical sync lock */
5286 #define V4L2_IN_ST_NO_STD_LOCK 0x00000800 /* No standard format lock */
5287
5288 /* field 'status' - digital */
5289 #define V4L2_IN_ST_NO_SYNC 0x00010000 /* No synchronization lock */
5290 #define V4L2_IN_ST_NO_EQU 0x00020000 /* No equalizer lock */
5291 #define V4L2_IN_ST_NO_CARRIER 0x00040000 /* Carrier recovery failed */
5292
5293 /* field 'status' - VCR and set-top box */
5294 #define V4L2_IN_ST_MACROVISION 0x01000000 /* Macrovision detected */
5295 #define V4L2_IN_ST_NO_ACCESS 0x02000000 /* Conditional access denied */
5296 #define V4L2_IN_ST_VTR 0x04000000 /* VTR time constant */
5297
5298 /* capabilities flags */
5299 #define V4L2_IN_CAP_DV_TIMINGS 0x00000002 /* Supports S_DV_TIMINGS */
5300 #define V4L2_IN_CAP_CUSTOM_TIMINGS V4L2_IN_CAP_DV_TIMINGS /* For compatibility */
5301 #define V4L2_IN_CAP_STD 0x00000004 /* Supports S_STD */
5302 #define V4L2_IN_CAP_NATIVE_SIZE 0x00000008 /* Supports setting native size */
5303
5304 /*
5305 * V I D E O O U T P U T S
5306 */
5307 struct v4l2_output {
5308 u_int32_t index; /* Which output */
5309 u_int8_t name[32]; /* Label */
5310 u_int32_t type; /* Type of output */
5311 u_int32_t audioset; /* Associated audios (bitfield) */
5312 u_int32_t modulator; /* Associated modulator */
5313 v4l2_std_id std;
5314 u_int32_t capabilities;
5315 u_int32_t reserved[3];
5316 };
5317 /* Values for the 'type' field */
5318 #define V4L2_OUTPUT_TYPE_MODULATOR 1
5319 #define V4L2_OUTPUT_TYPE_ANALOG 2
5320 #define V4L2_OUTPUT_TYPE_ANALOGVGAOVERLAY 3
5321
5322 /* capabilities flags */
5323 #define V4L2_OUT_CAP_DV_TIMINGS 0x00000002 /* Supports S_DV_TIMINGS */
5324 #define V4L2_OUT_CAP_CUSTOM_TIMINGS V4L2_OUT_CAP_DV_TIMINGS /* For compatibility */
5325 #define V4L2_OUT_CAP_STD 0x00000004 /* Supports S_STD */
5326 #define V4L2_OUT_CAP_NATIVE_SIZE 0x00000008 /* Supports setting native size */
5327
5328 /*
5329 * C O N T R O L S
5330 */
5331 struct v4l2_control {
5332 u_int32_t id;
5333 int32_t value;
5334 };
5335
5336 struct v4l2_ext_control {
5337 u_int32_t id;
5338 u_int32_t size;
5339 u_int32_t reserved2[1];
5340 union {
5341 int32_t value;
5342 int64_t value64;
5343 char __user *string;
5344 u_int8_t __user *p_u8;
5345 u_int16_t __user *p_u16;
5346 u_int32_t __user *p_u32;
5347 int32_t __user *p_s32;
5348 int64_t __user *p_s64;
5349 struct v4l2_area __user *p_area;
5350 struct v4l2_ctrl_h264_sps __user *p_h264_sps;
5351 struct v4l2_ctrl_h264_pps __user *p_h264_pps;
5352 struct v4l2_ctrl_h264_scaling_matrix __user *p_h264_scaling_matrix;
5353 struct v4l2_ctrl_h264_pred_weights __user *p_h264_pred_weights;
5354 struct v4l2_ctrl_h264_slice_params __user *p_h264_slice_params;
5355 struct v4l2_ctrl_h264_decode_params __user *p_h264_decode_params;
5356 struct v4l2_ctrl_fwht_params __user *p_fwht_params;
5357 struct v4l2_ctrl_vp8_frame __user *p_vp8_frame;
5358 struct v4l2_ctrl_mpeg2_sequence __user *p_mpeg2_sequence;
5359 struct v4l2_ctrl_mpeg2_picture __user *p_mpeg2_picture;
5360 struct v4l2_ctrl_mpeg2_quantisation __user *p_mpeg2_quantisation;
5361 struct v4l2_ctrl_vp9_compressed_hdr __user *p_vp9_compressed_hdr_probs;
5362 struct v4l2_ctrl_vp9_frame __user *p_vp9_frame;
5363 struct v4l2_ctrl_hevc_sps __user *p_hevc_sps;
5364 struct v4l2_ctrl_hevc_pps __user *p_hevc_pps;
5365 struct v4l2_ctrl_hevc_slice_params __user *p_hevc_slice_params;
5366 struct v4l2_ctrl_hevc_scaling_matrix __user *p_hevc_scaling_matrix;
5367 struct v4l2_ctrl_hevc_decode_params __user *p_hevc_decode_params;
5368 struct v4l2_ctrl_av1_sequence __user *p_av1_sequence;
5369 struct v4l2_ctrl_av1_tile_group_entry __user *p_av1_tile_group_entry;
5370 struct v4l2_ctrl_av1_frame __user *p_av1_frame;
5371 struct v4l2_ctrl_av1_film_grain __user *p_av1_film_grain;
5372 struct v4l2_ctrl_hdr10_cll_info __user *p_hdr10_cll_info;
5373 struct v4l2_ctrl_hdr10_mastering_display __user *p_hdr10_mastering_display;
5374 void __user *ptr;
5375 } __attribute__ ((packed));
5376 } __attribute__ ((packed));
5377
5378 struct v4l2_ext_controls {
5379 union {
5380 u_int32_t ctrl_class;
5381 u_int32_t which;
5382 };
5383 u_int32_t count;
5384 u_int32_t error_idx;
5385 int32_t request_fd;
5386 u_int32_t reserved[1];
5387 struct v4l2_ext_control *controls;
5388 };
5389
5390 #define V4L2_CTRL_ID_MASK (0x0fffffff)
5391 #define V4L2_CTRL_ID2CLASS(id) ((id) & 0x0fff0000UL)
5392 #define V4L2_CTRL_ID2WHICH(id) ((id) & 0x0fff0000UL)
5393 #define V4L2_CTRL_DRIVER_PRIV(id) (((id) & 0xffff) >= 0x1000)
5394 #define V4L2_CTRL_MAX_DIMS (4)
5395 #define V4L2_CTRL_WHICH_CUR_VAL 0
5396 #define V4L2_CTRL_WHICH_DEF_VAL 0x0f000000
5397 #define V4L2_CTRL_WHICH_REQUEST_VAL 0x0f010000
5398
5399 enum v4l2_ctrl_type {
5400 V4L2_CTRL_TYPE_INTEGER = 1,
5401 V4L2_CTRL_TYPE_BOOLEAN = 2,
5402 V4L2_CTRL_TYPE_MENU = 3,
5403 V4L2_CTRL_TYPE_BUTTON = 4,
5404 V4L2_CTRL_TYPE_INTEGER64 = 5,
5405 V4L2_CTRL_TYPE_CTRL_CLASS = 6,
5406 V4L2_CTRL_TYPE_STRING = 7,
5407 V4L2_CTRL_TYPE_BITMASK = 8,
5408 V4L2_CTRL_TYPE_INTEGER_MENU = 9,
5409
5410 /* Compound types are >= 0x0100 */
5411 V4L2_CTRL_COMPOUND_TYPES = 0x0100,
5412 V4L2_CTRL_TYPE_U8 = 0x0100,
5413 V4L2_CTRL_TYPE_U16 = 0x0101,
5414 V4L2_CTRL_TYPE_U32 = 0x0102,
5415 V4L2_CTRL_TYPE_AREA = 0x0106,
5416
5417 V4L2_CTRL_TYPE_HDR10_CLL_INFO = 0x0110,
5418 V4L2_CTRL_TYPE_HDR10_MASTERING_DISPLAY = 0x0111,
5419
5420 V4L2_CTRL_TYPE_H264_SPS = 0x0200,
5421 V4L2_CTRL_TYPE_H264_PPS = 0x0201,
5422 V4L2_CTRL_TYPE_H264_SCALING_MATRIX = 0x0202,
5423 V4L2_CTRL_TYPE_H264_SLICE_PARAMS = 0x0203,
5424 V4L2_CTRL_TYPE_H264_DECODE_PARAMS = 0x0204,
5425 V4L2_CTRL_TYPE_H264_PRED_WEIGHTS = 0x0205,
5426
5427 V4L2_CTRL_TYPE_FWHT_PARAMS = 0x0220,
5428
5429 V4L2_CTRL_TYPE_VP8_FRAME = 0x0240,
5430
5431 V4L2_CTRL_TYPE_MPEG2_QUANTISATION = 0x0250,
5432 V4L2_CTRL_TYPE_MPEG2_SEQUENCE = 0x0251,
5433 V4L2_CTRL_TYPE_MPEG2_PICTURE = 0x0252,
5434
5435 V4L2_CTRL_TYPE_VP9_COMPRESSED_HDR = 0x0260,
5436 V4L2_CTRL_TYPE_VP9_FRAME = 0x0261,
5437
5438 V4L2_CTRL_TYPE_HEVC_SPS = 0x0270,
5439 V4L2_CTRL_TYPE_HEVC_PPS = 0x0271,
5440 V4L2_CTRL_TYPE_HEVC_SLICE_PARAMS = 0x0272,
5441 V4L2_CTRL_TYPE_HEVC_SCALING_MATRIX = 0x0273,
5442 V4L2_CTRL_TYPE_HEVC_DECODE_PARAMS = 0x0274,
5443
5444 V4L2_CTRL_TYPE_AV1_SEQUENCE = 0x280,
5445 V4L2_CTRL_TYPE_AV1_TILE_GROUP_ENTRY = 0x281,
5446 V4L2_CTRL_TYPE_AV1_FRAME = 0x282,
5447 V4L2_CTRL_TYPE_AV1_FILM_GRAIN = 0x283,
5448 };
5449
5450 /* Used in the VIDIOC_QUERYCTRL ioctl for querying controls */
5451 struct v4l2_queryctrl {
5452 u_int32_t id;
5453 u_int32_t type; /* enum v4l2_ctrl_type */
5454 u_int8_t name[32]; /* Whatever */
5455 int32_t minimum; /* Note signedness */
5456 int32_t maximum;
5457 int32_t step;
5458 int32_t default_value;
5459 u_int32_t flags;
5460 u_int32_t reserved[2];
5461 };
5462
5463 /* Used in the VIDIOC_QUERY_EXT_CTRL ioctl for querying extended controls */
5464 struct v4l2_query_ext_ctrl {
5465 u_int32_t id;
5466 u_int32_t type;
5467 char name[32];
5468 int64_t minimum;
5469 int64_t maximum;
5470 u_int64_t step;
5471 int64_t default_value;
5472 u_int32_t flags;
5473 u_int32_t elem_size;
5474 u_int32_t elems;
5475 u_int32_t nr_of_dims;
5476 u_int32_t dims[V4L2_CTRL_MAX_DIMS];
5477 u_int32_t reserved[32];
5478 };
5479
5480 /* Used in the VIDIOC_QUERYMENU ioctl for querying menu items */
5481 struct v4l2_querymenu {
5482 u_int32_t id;
5483 u_int32_t index;
5484 union {
5485 u_int8_t name[32]; /* Whatever */
5486 int64_t value;
5487 };
5488 u_int32_t reserved;
5489 } __attribute__ ((packed));
5490
5491 /* Control flags */
5492 #define V4L2_CTRL_FLAG_DISABLED 0x0001
5493 #define V4L2_CTRL_FLAG_GRABBED 0x0002
5494 #define V4L2_CTRL_FLAG_READ_ONLY 0x0004
5495 #define V4L2_CTRL_FLAG_UPDATE 0x0008
5496 #define V4L2_CTRL_FLAG_INACTIVE 0x0010
5497 #define V4L2_CTRL_FLAG_SLIDER 0x0020
5498 #define V4L2_CTRL_FLAG_WRITE_ONLY 0x0040
5499 #define V4L2_CTRL_FLAG_VOLATILE 0x0080
5500 #define V4L2_CTRL_FLAG_HAS_PAYLOAD 0x0100
5501 #define V4L2_CTRL_FLAG_EXECUTE_ON_WRITE 0x0200
5502 #define V4L2_CTRL_FLAG_MODIFY_LAYOUT 0x0400
5503 #define V4L2_CTRL_FLAG_DYNAMIC_ARRAY 0x0800
5504
5505 /* Query flags, to be ORed with the control ID */
5506 #define V4L2_CTRL_FLAG_NEXT_CTRL 0x80000000
5507 #define V4L2_CTRL_FLAG_NEXT_COMPOUND 0x40000000
5508
5509 /* User-class control IDs defined by V4L2 */
5510 #define V4L2_CID_MAX_CTRLS 1024
5511 /* IDs reserved for driver specific controls */
5512 #define V4L2_CID_PRIVATE_BASE 0x08000000
5513
5514
5515 /*
5516 * T U N I N G
5517 */
5518 struct v4l2_tuner {
5519 u_int32_t index;
5520 u_int8_t name[32];
5521 u_int32_t type; /* enum v4l2_tuner_type */
5522 u_int32_t capability;
5523 u_int32_t rangelow;
5524 u_int32_t rangehigh;
5525 u_int32_t rxsubchans;
5526 u_int32_t audmode;
5527 int32_t signal;
5528 int32_t afc;
5529 u_int32_t reserved[4];
5530 };
5531
5532 struct v4l2_modulator {
5533 u_int32_t index;
5534 u_int8_t name[32];
5535 u_int32_t capability;
5536 u_int32_t rangelow;
5537 u_int32_t rangehigh;
5538 u_int32_t txsubchans;
5539 u_int32_t type; /* enum v4l2_tuner_type */
5540 u_int32_t reserved[3];
5541 };
5542
5543 /* Flags for the 'capability' field */
5544 #define V4L2_TUNER_CAP_LOW 0x0001
5545 #define V4L2_TUNER_CAP_NORM 0x0002
5546 #define V4L2_TUNER_CAP_HWSEEK_BOUNDED 0x0004
5547 #define V4L2_TUNER_CAP_HWSEEK_WRAP 0x0008
5548 #define V4L2_TUNER_CAP_STEREO 0x0010
5549 #define V4L2_TUNER_CAP_LANG2 0x0020
5550 #define V4L2_TUNER_CAP_SAP 0x0020
5551 #define V4L2_TUNER_CAP_LANG1 0x0040
5552 #define V4L2_TUNER_CAP_RDS 0x0080
5553 #define V4L2_TUNER_CAP_RDS_BLOCK_IO 0x0100
5554 #define V4L2_TUNER_CAP_RDS_CONTROLS 0x0200
5555 #define V4L2_TUNER_CAP_FREQ_BANDS 0x0400
5556 #define V4L2_TUNER_CAP_HWSEEK_PROG_LIM 0x0800
5557 #define V4L2_TUNER_CAP_1HZ 0x1000
5558
5559 /* Flags for the 'rxsubchans' field */
5560 #define V4L2_TUNER_SUB_MONO 0x0001
5561 #define V4L2_TUNER_SUB_STEREO 0x0002
5562 #define V4L2_TUNER_SUB_LANG2 0x0004
5563 #define V4L2_TUNER_SUB_SAP 0x0004
5564 #define V4L2_TUNER_SUB_LANG1 0x0008
5565 #define V4L2_TUNER_SUB_RDS 0x0010
5566
5567 /* Values for the 'audmode' field */
5568 #define V4L2_TUNER_MODE_MONO 0x0000
5569 #define V4L2_TUNER_MODE_STEREO 0x0001
5570 #define V4L2_TUNER_MODE_LANG2 0x0002
5571 #define V4L2_TUNER_MODE_SAP 0x0002
5572 #define V4L2_TUNER_MODE_LANG1 0x0003
5573 #define V4L2_TUNER_MODE_LANG1_LANG2 0x0004
5574
5575 struct v4l2_frequency {
5576 u_int32_t tuner;
5577 u_int32_t type; /* enum v4l2_tuner_type */
5578 u_int32_t frequency;
5579 u_int32_t reserved[8];
5580 };
5581
5582 #define V4L2_BAND_MODULATION_VSB (1 << 1)
5583 #define V4L2_BAND_MODULATION_FM (1 << 2)
5584 #define V4L2_BAND_MODULATION_AM (1 << 3)
5585
5586 struct v4l2_frequency_band {
5587 u_int32_t tuner;
5588 u_int32_t type; /* enum v4l2_tuner_type */
5589 u_int32_t index;
5590 u_int32_t capability;
5591 u_int32_t rangelow;
5592 u_int32_t rangehigh;
5593 u_int32_t modulation;
5594 u_int32_t reserved[9];
5595 };
5596
5597 struct v4l2_hw_freq_seek {
5598 u_int32_t tuner;
5599 u_int32_t type; /* enum v4l2_tuner_type */
5600 u_int32_t seek_upward;
5601 u_int32_t wrap_around;
5602 u_int32_t spacing;
5603 u_int32_t rangelow;
5604 u_int32_t rangehigh;
5605 u_int32_t reserved[5];
5606 };
5607
5608 /*
5609 * R D S
5610 */
5611
5612 struct v4l2_rds_data {
5613 u_int8_t lsb;
5614 u_int8_t msb;
5615 u_int8_t block;
5616 } __attribute__ ((packed));
5617
5618 #define V4L2_RDS_BLOCK_MSK 0x7
5619 #define V4L2_RDS_BLOCK_A 0
5620 #define V4L2_RDS_BLOCK_B 1
5621 #define V4L2_RDS_BLOCK_C 2
5622 #define V4L2_RDS_BLOCK_D 3
5623 #define V4L2_RDS_BLOCK_C_ALT 4
5624 #define V4L2_RDS_BLOCK_INVALID 7
5625
5626 #define V4L2_RDS_BLOCK_CORRECTED 0x40
5627 #define V4L2_RDS_BLOCK_ERROR 0x80
5628
5629 /*
5630 * A U D I O
5631 */
5632 struct v4l2_audio {
5633 u_int32_t index;
5634 u_int8_t name[32];
5635 u_int32_t capability;
5636 u_int32_t mode;
5637 u_int32_t reserved[2];
5638 };
5639
5640 /* Flags for the 'capability' field */
5641 #define V4L2_AUDCAP_STEREO 0x00001
5642 #define V4L2_AUDCAP_AVL 0x00002
5643
5644 /* Flags for the 'mode' field */
5645 #define V4L2_AUDMODE_AVL 0x00001
5646
5647 struct v4l2_audioout {
5648 u_int32_t index;
5649 u_int8_t name[32];
5650 u_int32_t capability;
5651 u_int32_t mode;
5652 u_int32_t reserved[2];
5653 };
5654
5655 /*
5656 * M P E G S E R V I C E S
5657 */
5658 #if 1
5659 #define V4L2_ENC_IDX_FRAME_I (0)
5660 #define V4L2_ENC_IDX_FRAME_P (1)
5661 #define V4L2_ENC_IDX_FRAME_B (2)
5662 #define V4L2_ENC_IDX_FRAME_MASK (0xf)
5663
5664 struct v4l2_enc_idx_entry {
5665 u_int64_t offset;
5666 u_int64_t pts;
5667 u_int32_t length;
5668 u_int32_t flags;
5669 u_int32_t reserved[2];
5670 };
5671
5672 #define V4L2_ENC_IDX_ENTRIES (64)
5673 struct v4l2_enc_idx {
5674 u_int32_t entries;
5675 u_int32_t entries_cap;
5676 u_int32_t reserved[4];
5677 struct v4l2_enc_idx_entry entry[V4L2_ENC_IDX_ENTRIES];
5678 };
5679
5680
5681 #define V4L2_ENC_CMD_START (0)
5682 #define V4L2_ENC_CMD_STOP (1)
5683 #define V4L2_ENC_CMD_PAUSE (2)
5684 #define V4L2_ENC_CMD_RESUME (3)
5685
5686 /* Flags for V4L2_ENC_CMD_STOP */
5687 #define V4L2_ENC_CMD_STOP_AT_GOP_END (1 << 0)
5688
5689 struct v4l2_encoder_cmd {
5690 u_int32_t cmd;
5691 u_int32_t flags;
5692 union {
5693 struct {
5694 u_int32_t data[8];
5695 } raw;
5696 };
5697 };
5698
5699 /* Decoder commands */
5700 #define V4L2_DEC_CMD_START (0)
5701 #define V4L2_DEC_CMD_STOP (1)
5702 #define V4L2_DEC_CMD_PAUSE (2)
5703 #define V4L2_DEC_CMD_RESUME (3)
5704 #define V4L2_DEC_CMD_FLUSH (4)
5705
5706 /* Flags for V4L2_DEC_CMD_START */
5707 #define V4L2_DEC_CMD_START_MUTE_AUDIO (1 << 0)
5708
5709 /* Flags for V4L2_DEC_CMD_PAUSE */
5710 #define V4L2_DEC_CMD_PAUSE_TO_BLACK (1 << 0)
5711
5712 /* Flags for V4L2_DEC_CMD_STOP */
5713 #define V4L2_DEC_CMD_STOP_TO_BLACK (1 << 0)
5714 #define V4L2_DEC_CMD_STOP_IMMEDIATELY (1 << 1)
5715
5716 /* Play format requirements (returned by the driver): */
5717
5718 /* The decoder has no special format requirements */
5719 #define V4L2_DEC_START_FMT_NONE (0)
5720 /* The decoder requires full GOPs */
5721 #define V4L2_DEC_START_FMT_GOP (1)
5722
5723 /* The structure must be zeroed before use by the application
5724 This ensures it can be extended safely in the future. */
5725 struct v4l2_decoder_cmd {
5726 u_int32_t cmd;
5727 u_int32_t flags;
5728 union {
5729 struct {
5730 u_int64_t pts;
5731 } stop;
5732
5733 struct {
5734 /* 0 or 1000 specifies normal speed,
5735 1 specifies forward single stepping,
5736 -1 specifies backward single stepping,
5737 >1: playback at speed/1000 of the normal speed,
5738 <-1: reverse playback at (-speed/1000) of the normal speed. */
5739 int32_t speed;
5740 u_int32_t format;
5741 } start;
5742
5743 struct {
5744 u_int32_t data[16];
5745 } raw;
5746 };
5747 };
5748 #endif
5749
5750
5751 /*
5752 * D A T A S E R V I C E S ( V B I )
5753 *
5754 * Data services API by Michael Schimek
5755 */
5756
5757 /* Raw VBI */
5758 struct v4l2_vbi_format {
5759 u_int32_t sampling_rate; /* in 1 Hz */
5760 u_int32_t offset;
5761 u_int32_t samples_per_line;
5762 u_int32_t sample_format; /* V4L2_PIX_FMT_* */
5763 int32_t start[2];
5764 u_int32_t count[2];
5765 u_int32_t flags; /* V4L2_VBI_* */
5766 u_int32_t reserved[2]; /* must be zero */
5767 };
5768
5769 /* VBI flags */
5770 #define V4L2_VBI_UNSYNC (1 << 0)
5771 #define V4L2_VBI_INTERLACED (1 << 1)
5772
5773 /* ITU-R start lines for each field */
5774 #define V4L2_VBI_ITU_525_F1_START (1)
5775 #define V4L2_VBI_ITU_525_F2_START (264)
5776 #define V4L2_VBI_ITU_625_F1_START (1)
5777 #define V4L2_VBI_ITU_625_F2_START (314)
5778
5779 /* Sliced VBI
5780 *
5781 * This implements is a proposal V4L2 API to allow SLICED VBI
5782 * required for some hardware encoders. It should change without
5783 * notice in the definitive implementation.
5784 */
5785
5786 struct v4l2_sliced_vbi_format {
5787 u_int16_t service_set;
5788 /* service_lines[0][...] specifies lines 0-23 (1-23 used) of the first field
5789 service_lines[1][...] specifies lines 0-23 (1-23 used) of the second field
5790 (equals frame lines 313-336 for 625 line video
5791 standards, 263-286 for 525 line standards) */
5792 u_int16_t service_lines[2][24];
5793 u_int32_t io_size;
5794 u_int32_t reserved[2]; /* must be zero */
5795 };
5796
5797 /* Teletext World System Teletext
5798 (WST), defined on ITU-R BT.653-2 */
5799 #define V4L2_SLICED_TELETEXT_B (0x0001)
5800 /* Video Program System, defined on ETS 300 231*/
5801 #define V4L2_SLICED_VPS (0x0400)
5802 /* Closed Caption, defined on EIA-608 */
5803 #define V4L2_SLICED_CAPTION_525 (0x1000)
5804 /* Wide Screen System, defined on ITU-R BT1119.1 */
5805 #define V4L2_SLICED_WSS_625 (0x4000)
5806
5807 #define V4L2_SLICED_VBI_525 (V4L2_SLICED_CAPTION_525)
5808 #define V4L2_SLICED_VBI_625 (V4L2_SLICED_TELETEXT_B | V4L2_SLICED_VPS | V4L2_SLICED_WSS_625)
5809
5810 struct v4l2_sliced_vbi_cap {
5811 u_int16_t service_set;
5812 /* service_lines[0][...] specifies lines 0-23 (1-23 used) of the first field
5813 service_lines[1][...] specifies lines 0-23 (1-23 used) of the second field
5814 (equals frame lines 313-336 for 625 line video
5815 standards, 263-286 for 525 line standards) */
5816 u_int16_t service_lines[2][24];
5817 u_int32_t type; /* enum v4l2_buf_type */
5818 u_int32_t reserved[3]; /* must be 0 */
5819 };
5820
5821 struct v4l2_sliced_vbi_data {
5822 u_int32_t id;
5823 u_int32_t field; /* 0: first field, 1: second field */
5824 u_int32_t line; /* 1-23 */
5825 u_int32_t reserved; /* must be 0 */
5826 u_int8_t data[48];
5827 };
5828
5829 /*
5830 * Sliced VBI data inserted into MPEG Streams
5831 */
5832
5833 /*
5834 * V4L2_MPEG_STREAM_VBI_FMT_IVTV:
5835 *
5836 * Structure of payload contained in an MPEG 2 Private Stream 1 PES Packet in an
5837 * MPEG-2 Program Pack that contains V4L2_MPEG_STREAM_VBI_FMT_IVTV Sliced VBI
5838 * data
5839 *
5840 * Note, the MPEG-2 Program Pack and Private Stream 1 PES packet header
5841 * definitions are not included here. See the MPEG-2 specifications for details
5842 * on these headers.
5843 */
5844
5845 /* Line type IDs */
5846 #define V4L2_MPEG_VBI_IVTV_TELETEXT_B (1)
5847 #define V4L2_MPEG_VBI_IVTV_CAPTION_525 (4)
5848 #define V4L2_MPEG_VBI_IVTV_WSS_625 (5)
5849 #define V4L2_MPEG_VBI_IVTV_VPS (7)
5850
5851 struct v4l2_mpeg_vbi_itv0_line {
5852 u_int8_t id; /* One of V4L2_MPEG_VBI_IVTV_* above */
5853 u_int8_t data[42]; /* Sliced VBI data for the line */
5854 } __attribute__ ((packed));
5855
5856 struct v4l2_mpeg_vbi_itv0 {
5857 u_int32_t linemask[2]; /* Bitmasks of VBI service lines present */
5858 struct v4l2_mpeg_vbi_itv0_line line[35];
5859 } __attribute__ ((packed));
5860
5861 struct v4l2_mpeg_vbi_ITV0 {
5862 struct v4l2_mpeg_vbi_itv0_line line[36];
5863 } __attribute__ ((packed));
5864
5865 #define V4L2_MPEG_VBI_IVTV_MAGIC0 "itv0"
5866 #define V4L2_MPEG_VBI_IVTV_MAGIC1 "ITV0"
5867
5868 struct v4l2_mpeg_vbi_fmt_ivtv {
5869 u_int8_t magic[4];
5870 union {
5871 struct v4l2_mpeg_vbi_itv0 itv0;
5872 struct v4l2_mpeg_vbi_ITV0 ITV0;
5873 };
5874 } __attribute__ ((packed));
5875
5876 /*
5877 * A G G R E G A T E S T R U C T U R E S
5878 */
5879
5880 /**
5881 * struct v4l2_plane_pix_format - additional, per-plane format definition
5882 * @sizeimage: maximum size in bytes required for data, for which
5883 * this plane will be used
5884 * @bytesperline: distance in bytes between the leftmost pixels in two
5885 * adjacent lines
5886 * @reserved: drivers and applications must zero this array
5887 */
5888 struct v4l2_plane_pix_format {
5889 u_int32_t sizeimage;
5890 u_int32_t bytesperline;
5891 u_int16_t reserved[6];
5892 } __attribute__ ((packed));
5893
5894 /**
5895 * struct v4l2_pix_format_mplane - multiplanar format definition
5896 * @width: image width in pixels
5897 * @height: image height in pixels
5898 * @pixelformat: little endian four character code (fourcc)
5899 * @field: enum v4l2_field; field order (for interlaced video)
5900 * @colorspace: enum v4l2_colorspace; supplemental to pixelformat
5901 * @plane_fmt: per-plane information
5902 * @num_planes: number of planes for this format
5903 * @flags: format flags (V4L2_PIX_FMT_FLAG_*)
5904 * @ycbcr_enc: enum v4l2_ycbcr_encoding, Y'CbCr encoding
5905 * @hsv_enc: enum v4l2_hsv_encoding, HSV encoding
5906 * @quantization: enum v4l2_quantization, colorspace quantization
5907 * @xfer_func: enum v4l2_xfer_func, colorspace transfer function
5908 * @reserved: drivers and applications must zero this array
5909 */
5910 struct v4l2_pix_format_mplane {
5911 u_int32_t width;
5912 u_int32_t height;
5913 u_int32_t pixelformat;
5914 u_int32_t field;
5915 u_int32_t colorspace;
5916
5917 struct v4l2_plane_pix_format plane_fmt[VIDEO_MAX_PLANES];
5918 u_int8_t num_planes;
5919 u_int8_t flags;
5920 union {
5921 u_int8_t ycbcr_enc;
5922 u_int8_t hsv_enc;
5923 };
5924 u_int8_t quantization;
5925 u_int8_t xfer_func;
5926 u_int8_t reserved[7];
5927 } __attribute__ ((packed));
5928
5929 /**
5930 * struct v4l2_sdr_format - SDR format definition
5931 * @pixelformat: little endian four character code (fourcc)
5932 * @buffersize: maximum size in bytes required for data
5933 * @reserved: drivers and applications must zero this array
5934 */
5935 struct v4l2_sdr_format {
5936 u_int32_t pixelformat;
5937 u_int32_t buffersize;
5938 u_int8_t reserved[24];
5939 } __attribute__ ((packed));
5940
5941 /**
5942 * struct v4l2_meta_format - metadata format definition
5943 * @dataformat: little endian four character code (fourcc)
5944 * @buffersize: maximum size in bytes required for data
5945 * @width: number of data units of data per line (valid for line
5946 * based formats only, see format documentation)
5947 * @height: number of lines of data per buffer (valid for line based
5948 * formats only)
5949 * @bytesperline: offset between the beginnings of two adjacent lines in
5950 * bytes (valid for line based formats only)
5951 */
5952 struct v4l2_meta_format {
5953 u_int32_t dataformat;
5954 u_int32_t buffersize;
5955 u_int32_t width;
5956 u_int32_t height;
5957 u_int32_t bytesperline;
5958 } __attribute__ ((packed));
5959
5960 /**
5961 * struct v4l2_format - stream data format
5962 * @type: enum v4l2_buf_type; type of the data stream
5963 * @fmt.pix: definition of an image format
5964 * @fmt.pix_mp: definition of a multiplanar image format
5965 * @fmt.win: definition of an overlaid image
5966 * @fmt.vbi: raw VBI capture or output parameters
5967 * @fmt.sliced: sliced VBI capture or output parameters
5968 * @fmt.raw_data: placeholder for future extensions and custom formats
5969 * @fmt: union of @pix, @pix_mp, @win, @vbi, @sliced, @sdr,
5970 * @meta and @raw_data
5971 */
5972 struct v4l2_format {
5973 u_int32_t type;
5974 union {
5975 struct v4l2_pix_format pix; /* V4L2_BUF_TYPE_VIDEO_CAPTURE */
5976 struct v4l2_pix_format_mplane pix_mp; /* V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE */
5977 struct v4l2_window win; /* V4L2_BUF_TYPE_VIDEO_OVERLAY */
5978 struct v4l2_vbi_format vbi; /* V4L2_BUF_TYPE_VBI_CAPTURE */
5979 struct v4l2_sliced_vbi_format sliced; /* V4L2_BUF_TYPE_SLICED_VBI_CAPTURE */
5980 struct v4l2_sdr_format sdr; /* V4L2_BUF_TYPE_SDR_CAPTURE */
5981 struct v4l2_meta_format meta; /* V4L2_BUF_TYPE_META_CAPTURE */
5982 u_int8_t raw_data[200]; /* user-defined */
5983 } fmt;
5984 };
5985
5986 /* Stream type-dependent parameters
5987 */
5988 struct v4l2_streamparm {
5989 u_int32_t type; /* enum v4l2_buf_type */
5990 union {
5991 struct v4l2_captureparm capture;
5992 struct v4l2_outputparm output;
5993 u_int8_t raw_data[200]; /* user-defined */
5994 } parm;
5995 };
5996
5997 /*
5998 * E V E N T S
5999 */
6000
6001 #define V4L2_EVENT_ALL 0
6002 #define V4L2_EVENT_VSYNC 1
6003 #define V4L2_EVENT_EOS 2
6004 #define V4L2_EVENT_CTRL 3
6005 #define V4L2_EVENT_FRAME_SYNC 4
6006 #define V4L2_EVENT_SOURCE_CHANGE 5
6007 #define V4L2_EVENT_MOTION_DET 6
6008 #define V4L2_EVENT_PRIVATE_START 0x08000000
6009
6010 /* Payload for V4L2_EVENT_VSYNC */
6011 struct v4l2_event_vsync {
6012 /* Can be V4L2_FIELD_ANY, _NONE, _TOP or _BOTTOM */
6013 u_int8_t field;
6014 } __attribute__ ((packed));
6015
6016 /* Payload for V4L2_EVENT_CTRL */
6017 #define V4L2_EVENT_CTRL_CH_VALUE (1 << 0)
6018 #define V4L2_EVENT_CTRL_CH_FLAGS (1 << 1)
6019 #define V4L2_EVENT_CTRL_CH_RANGE (1 << 2)
6020 #define V4L2_EVENT_CTRL_CH_DIMENSIONS (1 << 3)
6021
6022 struct v4l2_event_ctrl {
6023 u_int32_t changes;
6024 u_int32_t type;
6025 union {
6026 int32_t value;
6027 int64_t value64;
6028 };
6029 u_int32_t flags;
6030 int32_t minimum;
6031 int32_t maximum;
6032 int32_t step;
6033 int32_t default_value;
6034 };
6035
6036 struct v4l2_event_frame_sync {
6037 u_int32_t frame_sequence;
6038 };
6039
6040 #define V4L2_EVENT_SRC_CH_RESOLUTION (1 << 0)
6041
6042 struct v4l2_event_src_change {
6043 u_int32_t changes;
6044 };
6045
6046 #define V4L2_EVENT_MD_FL_HAVE_FRAME_SEQ (1 << 0)
6047
6048 /**
6049 * struct v4l2_event_motion_det - motion detection event
6050 * @flags: if V4L2_EVENT_MD_FL_HAVE_FRAME_SEQ is set, then the
6051 * frame_sequence field is valid.
6052 * @frame_sequence: the frame sequence number associated with this event.
6053 * @region_mask: which regions detected motion.
6054 */
6055 struct v4l2_event_motion_det {
6056 u_int32_t flags;
6057 u_int32_t frame_sequence;
6058 u_int32_t region_mask;
6059 };
6060
6061 struct v4l2_event {
6062 u_int32_t type;
6063 union {
6064 struct v4l2_event_vsync vsync;
6065 struct v4l2_event_ctrl ctrl;
6066 struct v4l2_event_frame_sync frame_sync;
6067 struct v4l2_event_src_change src_change;
6068 struct v4l2_event_motion_det motion_det;
6069 u_int8_t data[64];
6070 } u;
6071 u_int32_t pending;
6072 u_int32_t sequence;
6073 struct timespec timestamp;
6074 u_int32_t id;
6075 u_int32_t reserved[8];
6076 };
6077
6078 #define V4L2_EVENT_SUB_FL_SEND_INITIAL (1 << 0)
6079 #define V4L2_EVENT_SUB_FL_ALLOW_FEEDBACK (1 << 1)
6080
6081 struct v4l2_event_subscription {
6082 u_int32_t type;
6083 u_int32_t id;
6084 u_int32_t flags;
6085 u_int32_t reserved[5];
6086 };
6087
6088 /*
6089 * A D V A N C E D D E B U G G I N G
6090 *
6091 * NOTE: EXPERIMENTAL API, NEVER RELY ON THIS IN APPLICATIONS!
6092 * FOR DEBUGGING, TESTING AND INTERNAL USE ONLY!
6093 */
6094
6095 /* VIDIOC_DBG_G_REGISTER and VIDIOC_DBG_S_REGISTER */
6096
6097 #define V4L2_CHIP_MATCH_BRIDGE 0 /* Match against chip ID on the bridge (0 for the bridge) */
6098 #define V4L2_CHIP_MATCH_SUBDEV 4 /* Match against subdev index */
6099
6100 /* The following four defines are no longer in use */
6101 #define V4L2_CHIP_MATCH_HOST V4L2_CHIP_MATCH_BRIDGE
6102 #define V4L2_CHIP_MATCH_I2C_DRIVER 1 /* Match against I2C driver name */
6103 #define V4L2_CHIP_MATCH_I2C_ADDR 2 /* Match against I2C 7-bit address */
6104 #define V4L2_CHIP_MATCH_AC97 3 /* Match against ancillary AC97 chip */
6105
6106 struct v4l2_dbg_match {
6107 u_int32_t type; /* Match type */
6108 union { /* Match this chip, meaning determined by type */
6109 u_int32_t addr;
6110 char name[32];
6111 };
6112 } __attribute__ ((packed));
6113
6114 struct v4l2_dbg_register {
6115 struct v4l2_dbg_match match;
6116 u_int32_t size; /* register size in bytes */
6117 u_int64_t reg;
6118 u_int64_t val;
6119 } __attribute__ ((packed));
6120
6121 #define V4L2_CHIP_FL_READABLE (1 << 0)
6122 #define V4L2_CHIP_FL_WRITABLE (1 << 1)
6123
6124 /* VIDIOC_DBG_G_CHIP_INFO */
6125 struct v4l2_dbg_chip_info {
6126 struct v4l2_dbg_match match;
6127 char name[32];
6128 u_int32_t flags;
6129 u_int32_t reserved[32];
6130 } __attribute__ ((packed));
6131
6132 /**
6133 * struct v4l2_create_buffers - VIDIOC_CREATE_BUFS argument
6134 * @index: on return, index of the first created buffer
6135 * @count: entry: number of requested buffers,
6136 * return: number of created buffers
6137 * @memory: enum v4l2_memory; buffer memory type
6138 * @format: frame format, for which buffers are requested
6139 * @capabilities: capabilities of this buffer type.
6140 * @flags: additional buffer management attributes (ignored unless the
6141 * queue has V4L2_BUF_CAP_SUPPORTS_MMAP_CACHE_HINTS capability
6142 * and configured for MMAP streaming I/O).
6143 * @max_num_buffers: if V4L2_BUF_CAP_SUPPORTS_MAX_NUM_BUFFERS capability flag is set
6144 * this field indicate the maximum possible number of buffers
6145 * for this queue.
6146 * @reserved: future extensions
6147 */
6148 struct v4l2_create_buffers {
6149 u_int32_t index;
6150 u_int32_t count;
6151 u_int32_t memory;
6152 struct v4l2_format format;
6153 u_int32_t capabilities;
6154 u_int32_t flags;
6155 u_int32_t max_num_buffers;
6156 u_int32_t reserved[5];
6157 };
6158
6159 /**
6160 * struct v4l2_remove_buffers - VIDIOC_REMOVE_BUFS argument
6161 * @index: the first buffer to be removed
6162 * @count: number of buffers to removed
6163 * @type: enum v4l2_buf_type
6164 * @reserved: future extensions
6165 */
6166 struct v4l2_remove_buffers {
6167 u_int32_t index;
6168 u_int32_t count;
6169 u_int32_t type;
6170 u_int32_t reserved[13];
6171 };
6172
6173 /*
6174 * 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
6175 *
6176 */
6177 #define VIDIOC_QUERYCAP _IOR('V', 0, struct v4l2_capability)
6178 #define VIDIOC_ENUM_FMT _IOWR('V', 2, struct v4l2_fmtdesc)
6179 #define VIDIOC_G_FMT _IOWR('V', 4, struct v4l2_format)
6180 #define VIDIOC_S_FMT _IOWR('V', 5, struct v4l2_format)
6181 #define VIDIOC_REQBUFS _IOWR('V', 8, struct v4l2_requestbuffers)
6182 #define VIDIOC_QUERYBUF _IOWR('V', 9, struct v4l2_buffer)
6183 #define VIDIOC_G_FBUF _IOR('V', 10, struct v4l2_framebuffer)
6184 #define VIDIOC_S_FBUF _IOW('V', 11, struct v4l2_framebuffer)
6185 #define VIDIOC_OVERLAY _IOW('V', 14, int)
6186 #define VIDIOC_QBUF _IOWR('V', 15, struct v4l2_buffer)
6187 #define VIDIOC_EXPBUF _IOWR('V', 16, struct v4l2_exportbuffer)
6188 #define VIDIOC_DQBUF _IOWR('V', 17, struct v4l2_buffer)
6189 #define VIDIOC_STREAMON _IOW('V', 18, int)
6190 #define VIDIOC_STREAMOFF _IOW('V', 19, int)
6191 #define VIDIOC_G_PARM _IOWR('V', 21, struct v4l2_streamparm)
6192 #define VIDIOC_S_PARM _IOWR('V', 22, struct v4l2_streamparm)
6193 #define VIDIOC_G_STD _IOR('V', 23, v4l2_std_id)
6194 #define VIDIOC_S_STD _IOW('V', 24, v4l2_std_id)
6195 #define VIDIOC_ENUMSTD _IOWR('V', 25, struct v4l2_standard)
6196 #define VIDIOC_ENUMINPUT _IOWR('V', 26, struct v4l2_input)
6197 #define VIDIOC_G_CTRL _IOWR('V', 27, struct v4l2_control)
6198 #define VIDIOC_S_CTRL _IOWR('V', 28, struct v4l2_control)
6199 #define VIDIOC_G_TUNER _IOWR('V', 29, struct v4l2_tuner)
6200 #define VIDIOC_S_TUNER _IOW('V', 30, struct v4l2_tuner)
6201 #define VIDIOC_G_AUDIO _IOR('V', 33, struct v4l2_audio)
6202 #define VIDIOC_S_AUDIO _IOW('V', 34, struct v4l2_audio)
6203 #define VIDIOC_QUERYCTRL _IOWR('V', 36, struct v4l2_queryctrl)
6204 #define VIDIOC_QUERYMENU _IOWR('V', 37, struct v4l2_querymenu)
6205 #define VIDIOC_G_INPUT _IOR('V', 38, int)
6206 #define VIDIOC_S_INPUT _IOWR('V', 39, int)
6207 #define VIDIOC_G_EDID _IOWR('V', 40, struct v4l2_edid)
6208 #define VIDIOC_S_EDID _IOWR('V', 41, struct v4l2_edid)
6209 #define VIDIOC_G_OUTPUT _IOR('V', 46, int)
6210 #define VIDIOC_S_OUTPUT _IOWR('V', 47, int)
6211 #define VIDIOC_ENUMOUTPUT _IOWR('V', 48, struct v4l2_output)
6212 #define VIDIOC_G_AUDOUT _IOR('V', 49, struct v4l2_audioout)
6213 #define VIDIOC_S_AUDOUT _IOW('V', 50, struct v4l2_audioout)
6214 #define VIDIOC_G_MODULATOR _IOWR('V', 54, struct v4l2_modulator)
6215 #define VIDIOC_S_MODULATOR _IOW('V', 55, struct v4l2_modulator)
6216 #define VIDIOC_G_FREQUENCY _IOWR('V', 56, struct v4l2_frequency)
6217 #define VIDIOC_S_FREQUENCY _IOW('V', 57, struct v4l2_frequency)
6218 #define VIDIOC_CROPCAP _IOWR('V', 58, struct v4l2_cropcap)
6219 #define VIDIOC_G_CROP _IOWR('V', 59, struct v4l2_crop)
6220 #define VIDIOC_S_CROP _IOW('V', 60, struct v4l2_crop)
6221 #define VIDIOC_G_JPEGCOMP _IOR('V', 61, struct v4l2_jpegcompression)
6222 #define VIDIOC_S_JPEGCOMP _IOW('V', 62, struct v4l2_jpegcompression)
6223 #define VIDIOC_QUERYSTD _IOR('V', 63, v4l2_std_id)
6224 #define VIDIOC_TRY_FMT _IOWR('V', 64, struct v4l2_format)
6225 #define VIDIOC_ENUMAUDIO _IOWR('V', 65, struct v4l2_audio)
6226 #define VIDIOC_ENUMAUDOUT _IOWR('V', 66, struct v4l2_audioout)
6227 #define VIDIOC_G_PRIORITY _IOR('V', 67, u_int32_t) /* enum v4l2_priority */
6228 #define VIDIOC_S_PRIORITY _IOW('V', 68, u_int32_t) /* enum v4l2_priority */
6229 #define VIDIOC_G_SLICED_VBI_CAP _IOWR('V', 69, struct v4l2_sliced_vbi_cap)
6230 #define VIDIOC_LOG_STATUS _IO('V', 70)
6231 #define VIDIOC_G_EXT_CTRLS _IOWR('V', 71, struct v4l2_ext_controls)
6232 #define VIDIOC_S_EXT_CTRLS _IOWR('V', 72, struct v4l2_ext_controls)
6233 #define VIDIOC_TRY_EXT_CTRLS _IOWR('V', 73, struct v4l2_ext_controls)
6234 #define VIDIOC_ENUM_FRAMESIZES _IOWR('V', 74, struct v4l2_frmsizeenum)
6235 #define VIDIOC_ENUM_FRAMEINTERVALS _IOWR('V', 75, struct v4l2_frmivalenum)
6236 #define VIDIOC_G_ENC_INDEX _IOR('V', 76, struct v4l2_enc_idx)
6237 #define VIDIOC_ENCODER_CMD _IOWR('V', 77, struct v4l2_encoder_cmd)
6238 #define VIDIOC_TRY_ENCODER_CMD _IOWR('V', 78, struct v4l2_encoder_cmd)
6239
6240 /*
6241 * Experimental, meant for debugging, testing and internal use.
6242 * Only implemented if CONFIG_VIDEO_ADV_DEBUG is defined.
6243 * You must be root to use these ioctls. Never use these in applications!
6244 */
6245 #define VIDIOC_DBG_S_REGISTER _IOW('V', 79, struct v4l2_dbg_register)
6246 #define VIDIOC_DBG_G_REGISTER _IOWR('V', 80, struct v4l2_dbg_register)
6247
6248 #define VIDIOC_S_HW_FREQ_SEEK _IOW('V', 82, struct v4l2_hw_freq_seek)
6249 #define VIDIOC_S_DV_TIMINGS _IOWR('V', 87, struct v4l2_dv_timings)
6250 #define VIDIOC_G_DV_TIMINGS _IOWR('V', 88, struct v4l2_dv_timings)
6251 #define VIDIOC_DQEVENT _IOR('V', 89, struct v4l2_event)
6252 #define VIDIOC_SUBSCRIBE_EVENT _IOW('V', 90, struct v4l2_event_subscription)
6253 #define VIDIOC_UNSUBSCRIBE_EVENT _IOW('V', 91, struct v4l2_event_subscription)
6254 #define VIDIOC_CREATE_BUFS _IOWR('V', 92, struct v4l2_create_buffers)
6255 #define VIDIOC_PREPARE_BUF _IOWR('V', 93, struct v4l2_buffer)
6256 #define VIDIOC_G_SELECTION _IOWR('V', 94, struct v4l2_selection)
6257 #define VIDIOC_S_SELECTION _IOWR('V', 95, struct v4l2_selection)
6258 #define VIDIOC_DECODER_CMD _IOWR('V', 96, struct v4l2_decoder_cmd)
6259 #define VIDIOC_TRY_DECODER_CMD _IOWR('V', 97, struct v4l2_decoder_cmd)
6260 #define VIDIOC_ENUM_DV_TIMINGS _IOWR('V', 98, struct v4l2_enum_dv_timings)
6261 #define VIDIOC_QUERY_DV_TIMINGS _IOR('V', 99, struct v4l2_dv_timings)
6262 #define VIDIOC_DV_TIMINGS_CAP _IOWR('V', 100, struct v4l2_dv_timings_cap)
6263 #define VIDIOC_ENUM_FREQ_BANDS _IOWR('V', 101, struct v4l2_frequency_band)
6264
6265 /*
6266 * Experimental, meant for debugging, testing and internal use.
6267 * Never use this in applications!
6268 */
6269 #define VIDIOC_DBG_G_CHIP_INFO _IOWR('V', 102, struct v4l2_dbg_chip_info)
6270
6271 #define VIDIOC_QUERY_EXT_CTRL _IOWR('V', 103, struct v4l2_query_ext_ctrl)
6272 #define VIDIOC_REMOVE_BUFS _IOWR('V', 104, struct v4l2_remove_buffers)
6273
6274
6275 /* Reminder: when adding new ioctls please add support for them to
6276 drivers/media/v4l2-core/v4l2-compat-ioctl32.c as well! */
6277
6278 #define BASE_VIDIOC_PRIVATE 192 /* 192-255 are private */
6279
6280 /* Deprecated definitions kept for backwards compatibility */
6281 #define V4L2_PIX_FMT_HM12 V4L2_PIX_FMT_NV12_16L16
6282 #define V4L2_PIX_FMT_SUNXI_TILED_NV12 V4L2_PIX_FMT_NV12_32L32
6283 /*
6284 * This capability was never implemented, anyone using this cap should drop it
6285 * from their code.
6286 */
6287 #define V4L2_CAP_ASYNCIO 0x02000000
6288
6289 #endif /* _SYS_VIDEOIO_H_ */
6290