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