1 /* SPDX-License-Identifier: ((GPL-2.0+ WITH Linux-syscall-note) OR BSD-3-Clause) */
3 * Video for Linux Two controls header file
5 * Copyright (C) 1999-2012 the contributors
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * Alternatively you can redistribute this file under the terms of the
18 * BSD license as stated below:
20 * Redistribution and use in source and binary forms, with or without
21 * modification, are permitted provided that the following conditions
23 * 1. Redistributions of source code must retain the above copyright
24 * notice, this list of conditions and the following disclaimer.
25 * 2. Redistributions in binary form must reproduce the above copyright
26 * notice, this list of conditions and the following disclaimer in
27 * the documentation and/or other materials provided with the
29 * 3. The names of its contributors may not be used to endorse or promote
30 * products derived from this software without specific prior written
33 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
34 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
35 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
36 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
37 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
38 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
39 * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
40 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
41 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
42 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
43 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
45 * The contents of this header was split off from videodev2.h. All control
46 * definitions should be added to this header, which is included by
50 #ifndef __LINUX_V4L2_CONTROLS_H
51 #define __LINUX_V4L2_CONTROLS_H
53 #include <linux/const.h>
54 #include <linux/types.h>
57 #define V4L2_CTRL_CLASS_USER 0x00980000 /* Old-style 'user' controls */
58 #define V4L2_CTRL_CLASS_CODEC 0x00990000 /* Stateful codec controls */
59 #define V4L2_CTRL_CLASS_CAMERA 0x009a0000 /* Camera class controls */
60 #define V4L2_CTRL_CLASS_FM_TX 0x009b0000 /* FM Modulator controls */
61 #define V4L2_CTRL_CLASS_FLASH 0x009c0000 /* Camera flash controls */
62 #define V4L2_CTRL_CLASS_JPEG 0x009d0000 /* JPEG-compression controls */
63 #define V4L2_CTRL_CLASS_IMAGE_SOURCE 0x009e0000 /* Image source controls */
64 #define V4L2_CTRL_CLASS_IMAGE_PROC 0x009f0000 /* Image processing controls */
65 #define V4L2_CTRL_CLASS_DV 0x00a00000 /* Digital Video controls */
66 #define V4L2_CTRL_CLASS_FM_RX 0x00a10000 /* FM Receiver controls */
67 #define V4L2_CTRL_CLASS_RF_TUNER 0x00a20000 /* RF tuner controls */
68 #define V4L2_CTRL_CLASS_DETECT 0x00a30000 /* Detection controls */
69 #define V4L2_CTRL_CLASS_CODEC_STATELESS 0x00a40000 /* Stateless codecs controls */
70 #define V4L2_CTRL_CLASS_COLORIMETRY 0x00a50000 /* Colorimetry controls */
72 /* User-class control IDs */
74 #define V4L2_CID_BASE (V4L2_CTRL_CLASS_USER | 0x900)
75 #define V4L2_CID_USER_BASE V4L2_CID_BASE
76 #define V4L2_CID_USER_CLASS (V4L2_CTRL_CLASS_USER | 1)
77 #define V4L2_CID_BRIGHTNESS (V4L2_CID_BASE+0)
78 #define V4L2_CID_CONTRAST (V4L2_CID_BASE+1)
79 #define V4L2_CID_SATURATION (V4L2_CID_BASE+2)
80 #define V4L2_CID_HUE (V4L2_CID_BASE+3)
81 #define V4L2_CID_AUDIO_VOLUME (V4L2_CID_BASE+5)
82 #define V4L2_CID_AUDIO_BALANCE (V4L2_CID_BASE+6)
83 #define V4L2_CID_AUDIO_BASS (V4L2_CID_BASE+7)
84 #define V4L2_CID_AUDIO_TREBLE (V4L2_CID_BASE+8)
85 #define V4L2_CID_AUDIO_MUTE (V4L2_CID_BASE+9)
86 #define V4L2_CID_AUDIO_LOUDNESS (V4L2_CID_BASE+10)
87 #define V4L2_CID_BLACK_LEVEL (V4L2_CID_BASE+11) /* Deprecated */
88 #define V4L2_CID_AUTO_WHITE_BALANCE (V4L2_CID_BASE+12)
89 #define V4L2_CID_DO_WHITE_BALANCE (V4L2_CID_BASE+13)
90 #define V4L2_CID_RED_BALANCE (V4L2_CID_BASE+14)
91 #define V4L2_CID_BLUE_BALANCE (V4L2_CID_BASE+15)
92 #define V4L2_CID_GAMMA (V4L2_CID_BASE+16)
93 #define V4L2_CID_WHITENESS (V4L2_CID_GAMMA) /* Deprecated */
94 #define V4L2_CID_EXPOSURE (V4L2_CID_BASE+17)
95 #define V4L2_CID_AUTOGAIN (V4L2_CID_BASE+18)
96 #define V4L2_CID_GAIN (V4L2_CID_BASE+19)
97 #define V4L2_CID_HFLIP (V4L2_CID_BASE+20)
98 #define V4L2_CID_VFLIP (V4L2_CID_BASE+21)
100 #define V4L2_CID_POWER_LINE_FREQUENCY (V4L2_CID_BASE+24)
101 enum v4l2_power_line_frequency {
102 V4L2_CID_POWER_LINE_FREQUENCY_DISABLED = 0,
103 V4L2_CID_POWER_LINE_FREQUENCY_50HZ = 1,
104 V4L2_CID_POWER_LINE_FREQUENCY_60HZ = 2,
105 V4L2_CID_POWER_LINE_FREQUENCY_AUTO = 3,
107 #define V4L2_CID_HUE_AUTO (V4L2_CID_BASE+25)
108 #define V4L2_CID_WHITE_BALANCE_TEMPERATURE (V4L2_CID_BASE+26)
109 #define V4L2_CID_SHARPNESS (V4L2_CID_BASE+27)
110 #define V4L2_CID_BACKLIGHT_COMPENSATION (V4L2_CID_BASE+28)
111 #define V4L2_CID_CHROMA_AGC (V4L2_CID_BASE+29)
112 #define V4L2_CID_COLOR_KILLER (V4L2_CID_BASE+30)
113 #define V4L2_CID_COLORFX (V4L2_CID_BASE+31)
115 V4L2_COLORFX_NONE = 0,
117 V4L2_COLORFX_SEPIA = 2,
118 V4L2_COLORFX_NEGATIVE = 3,
119 V4L2_COLORFX_EMBOSS = 4,
120 V4L2_COLORFX_SKETCH = 5,
121 V4L2_COLORFX_SKY_BLUE = 6,
122 V4L2_COLORFX_GRASS_GREEN = 7,
123 V4L2_COLORFX_SKIN_WHITEN = 8,
124 V4L2_COLORFX_VIVID = 9,
125 V4L2_COLORFX_AQUA = 10,
126 V4L2_COLORFX_ART_FREEZE = 11,
127 V4L2_COLORFX_SILHOUETTE = 12,
128 V4L2_COLORFX_SOLARIZATION = 13,
129 V4L2_COLORFX_ANTIQUE = 14,
130 V4L2_COLORFX_SET_CBCR = 15,
131 V4L2_COLORFX_SET_RGB = 16,
133 #define V4L2_CID_AUTOBRIGHTNESS (V4L2_CID_BASE+32)
134 #define V4L2_CID_BAND_STOP_FILTER (V4L2_CID_BASE+33)
136 #define V4L2_CID_ROTATE (V4L2_CID_BASE+34)
137 #define V4L2_CID_BG_COLOR (V4L2_CID_BASE+35)
139 #define V4L2_CID_CHROMA_GAIN (V4L2_CID_BASE+36)
141 #define V4L2_CID_ILLUMINATORS_1 (V4L2_CID_BASE+37)
142 #define V4L2_CID_ILLUMINATORS_2 (V4L2_CID_BASE+38)
144 #define V4L2_CID_MIN_BUFFERS_FOR_CAPTURE (V4L2_CID_BASE+39)
145 #define V4L2_CID_MIN_BUFFERS_FOR_OUTPUT (V4L2_CID_BASE+40)
147 #define V4L2_CID_ALPHA_COMPONENT (V4L2_CID_BASE+41)
148 #define V4L2_CID_COLORFX_CBCR (V4L2_CID_BASE+42)
149 #define V4L2_CID_COLORFX_RGB (V4L2_CID_BASE+43)
152 #define V4L2_CID_LASTP1 (V4L2_CID_BASE+44)
154 /* USER-class private control IDs */
156 /* The base for the meye driver controls. See linux/meye.h for the list
157 * of controls. We reserve 16 controls for this driver. */
158 #define V4L2_CID_USER_MEYE_BASE (V4L2_CID_USER_BASE + 0x1000)
160 /* The base for the bttv driver controls.
161 * We reserve 32 controls for this driver. */
162 #define V4L2_CID_USER_BTTV_BASE (V4L2_CID_USER_BASE + 0x1010)
165 /* The base for the s2255 driver controls.
166 * We reserve 16 controls for this driver. */
167 #define V4L2_CID_USER_S2255_BASE (V4L2_CID_USER_BASE + 0x1030)
170 * The base for the si476x driver controls. See include/media/drv-intf/si476x.h
171 * for the list of controls. Total of 16 controls is reserved for this driver
173 #define V4L2_CID_USER_SI476X_BASE (V4L2_CID_USER_BASE + 0x1040)
175 /* The base for the TI VPE driver controls. Total of 16 controls is reserved for
177 #define V4L2_CID_USER_TI_VPE_BASE (V4L2_CID_USER_BASE + 0x1050)
179 /* The base for the saa7134 driver controls.
180 * We reserve 16 controls for this driver. */
181 #define V4L2_CID_USER_SAA7134_BASE (V4L2_CID_USER_BASE + 0x1060)
183 /* The base for the adv7180 driver controls.
184 * We reserve 16 controls for this driver. */
185 #define V4L2_CID_USER_ADV7180_BASE (V4L2_CID_USER_BASE + 0x1070)
187 /* The base for the tc358743 driver controls.
188 * We reserve 16 controls for this driver. */
189 #define V4L2_CID_USER_TC358743_BASE (V4L2_CID_USER_BASE + 0x1080)
191 /* The base for the max217x driver controls.
192 * We reserve 32 controls for this driver
194 #define V4L2_CID_USER_MAX217X_BASE (V4L2_CID_USER_BASE + 0x1090)
196 /* The base for the imx driver controls.
197 * We reserve 16 controls for this driver. */
198 #define V4L2_CID_USER_IMX_BASE (V4L2_CID_USER_BASE + 0x10b0)
201 * The base for the atmel isc driver controls.
202 * We reserve 32 controls for this driver.
204 #define V4L2_CID_USER_ATMEL_ISC_BASE (V4L2_CID_USER_BASE + 0x10c0)
207 * The base for the CODA driver controls.
208 * We reserve 16 controls for this driver.
210 #define V4L2_CID_USER_CODA_BASE (V4L2_CID_USER_BASE + 0x10e0)
212 * The base for MIPI CCS driver controls.
213 * We reserve 128 controls for this driver.
215 #define V4L2_CID_USER_CCS_BASE (V4L2_CID_USER_BASE + 0x10f0)
217 * The base for Allegro driver controls.
218 * We reserve 16 controls for this driver.
220 #define V4L2_CID_USER_ALLEGRO_BASE (V4L2_CID_USER_BASE + 0x1170)
223 * The base for the isl7998x driver controls.
224 * We reserve 16 controls for this driver.
226 #define V4L2_CID_USER_ISL7998X_BASE (V4L2_CID_USER_BASE + 0x1180)
229 * The base for DW100 driver controls.
230 * We reserve 16 controls for this driver.
232 #define V4L2_CID_USER_DW100_BASE (V4L2_CID_USER_BASE + 0x1190)
234 /* MPEG-class control IDs */
235 /* The MPEG controls are applicable to all codec controls
236 * and the 'MPEG' part of the define is historical */
238 #define V4L2_CID_CODEC_BASE (V4L2_CTRL_CLASS_CODEC | 0x900)
239 #define V4L2_CID_CODEC_CLASS (V4L2_CTRL_CLASS_CODEC | 1)
241 /* MPEG streams, specific to multiplexed streams */
242 #define V4L2_CID_MPEG_STREAM_TYPE (V4L2_CID_CODEC_BASE+0)
243 enum v4l2_mpeg_stream_type {
244 V4L2_MPEG_STREAM_TYPE_MPEG2_PS = 0, /* MPEG-2 program stream */
245 V4L2_MPEG_STREAM_TYPE_MPEG2_TS = 1, /* MPEG-2 transport stream */
246 V4L2_MPEG_STREAM_TYPE_MPEG1_SS = 2, /* MPEG-1 system stream */
247 V4L2_MPEG_STREAM_TYPE_MPEG2_DVD = 3, /* MPEG-2 DVD-compatible stream */
248 V4L2_MPEG_STREAM_TYPE_MPEG1_VCD = 4, /* MPEG-1 VCD-compatible stream */
249 V4L2_MPEG_STREAM_TYPE_MPEG2_SVCD = 5, /* MPEG-2 SVCD-compatible stream */
251 #define V4L2_CID_MPEG_STREAM_PID_PMT (V4L2_CID_CODEC_BASE+1)
252 #define V4L2_CID_MPEG_STREAM_PID_AUDIO (V4L2_CID_CODEC_BASE+2)
253 #define V4L2_CID_MPEG_STREAM_PID_VIDEO (V4L2_CID_CODEC_BASE+3)
254 #define V4L2_CID_MPEG_STREAM_PID_PCR (V4L2_CID_CODEC_BASE+4)
255 #define V4L2_CID_MPEG_STREAM_PES_ID_AUDIO (V4L2_CID_CODEC_BASE+5)
256 #define V4L2_CID_MPEG_STREAM_PES_ID_VIDEO (V4L2_CID_CODEC_BASE+6)
257 #define V4L2_CID_MPEG_STREAM_VBI_FMT (V4L2_CID_CODEC_BASE+7)
258 enum v4l2_mpeg_stream_vbi_fmt {
259 V4L2_MPEG_STREAM_VBI_FMT_NONE = 0, /* No VBI in the MPEG stream */
260 V4L2_MPEG_STREAM_VBI_FMT_IVTV = 1, /* VBI in private packets, IVTV format */
263 /* MPEG audio controls specific to multiplexed streams */
264 #define V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ (V4L2_CID_CODEC_BASE+100)
265 enum v4l2_mpeg_audio_sampling_freq {
266 V4L2_MPEG_AUDIO_SAMPLING_FREQ_44100 = 0,
267 V4L2_MPEG_AUDIO_SAMPLING_FREQ_48000 = 1,
268 V4L2_MPEG_AUDIO_SAMPLING_FREQ_32000 = 2,
270 #define V4L2_CID_MPEG_AUDIO_ENCODING (V4L2_CID_CODEC_BASE+101)
271 enum v4l2_mpeg_audio_encoding {
272 V4L2_MPEG_AUDIO_ENCODING_LAYER_1 = 0,
273 V4L2_MPEG_AUDIO_ENCODING_LAYER_2 = 1,
274 V4L2_MPEG_AUDIO_ENCODING_LAYER_3 = 2,
275 V4L2_MPEG_AUDIO_ENCODING_AAC = 3,
276 V4L2_MPEG_AUDIO_ENCODING_AC3 = 4,
278 #define V4L2_CID_MPEG_AUDIO_L1_BITRATE (V4L2_CID_CODEC_BASE+102)
279 enum v4l2_mpeg_audio_l1_bitrate {
280 V4L2_MPEG_AUDIO_L1_BITRATE_32K = 0,
281 V4L2_MPEG_AUDIO_L1_BITRATE_64K = 1,
282 V4L2_MPEG_AUDIO_L1_BITRATE_96K = 2,
283 V4L2_MPEG_AUDIO_L1_BITRATE_128K = 3,
284 V4L2_MPEG_AUDIO_L1_BITRATE_160K = 4,
285 V4L2_MPEG_AUDIO_L1_BITRATE_192K = 5,
286 V4L2_MPEG_AUDIO_L1_BITRATE_224K = 6,
287 V4L2_MPEG_AUDIO_L1_BITRATE_256K = 7,
288 V4L2_MPEG_AUDIO_L1_BITRATE_288K = 8,
289 V4L2_MPEG_AUDIO_L1_BITRATE_320K = 9,
290 V4L2_MPEG_AUDIO_L1_BITRATE_352K = 10,
291 V4L2_MPEG_AUDIO_L1_BITRATE_384K = 11,
292 V4L2_MPEG_AUDIO_L1_BITRATE_416K = 12,
293 V4L2_MPEG_AUDIO_L1_BITRATE_448K = 13,
295 #define V4L2_CID_MPEG_AUDIO_L2_BITRATE (V4L2_CID_CODEC_BASE+103)
296 enum v4l2_mpeg_audio_l2_bitrate {
297 V4L2_MPEG_AUDIO_L2_BITRATE_32K = 0,
298 V4L2_MPEG_AUDIO_L2_BITRATE_48K = 1,
299 V4L2_MPEG_AUDIO_L2_BITRATE_56K = 2,
300 V4L2_MPEG_AUDIO_L2_BITRATE_64K = 3,
301 V4L2_MPEG_AUDIO_L2_BITRATE_80K = 4,
302 V4L2_MPEG_AUDIO_L2_BITRATE_96K = 5,
303 V4L2_MPEG_AUDIO_L2_BITRATE_112K = 6,
304 V4L2_MPEG_AUDIO_L2_BITRATE_128K = 7,
305 V4L2_MPEG_AUDIO_L2_BITRATE_160K = 8,
306 V4L2_MPEG_AUDIO_L2_BITRATE_192K = 9,
307 V4L2_MPEG_AUDIO_L2_BITRATE_224K = 10,
308 V4L2_MPEG_AUDIO_L2_BITRATE_256K = 11,
309 V4L2_MPEG_AUDIO_L2_BITRATE_320K = 12,
310 V4L2_MPEG_AUDIO_L2_BITRATE_384K = 13,
312 #define V4L2_CID_MPEG_AUDIO_L3_BITRATE (V4L2_CID_CODEC_BASE+104)
313 enum v4l2_mpeg_audio_l3_bitrate {
314 V4L2_MPEG_AUDIO_L3_BITRATE_32K = 0,
315 V4L2_MPEG_AUDIO_L3_BITRATE_40K = 1,
316 V4L2_MPEG_AUDIO_L3_BITRATE_48K = 2,
317 V4L2_MPEG_AUDIO_L3_BITRATE_56K = 3,
318 V4L2_MPEG_AUDIO_L3_BITRATE_64K = 4,
319 V4L2_MPEG_AUDIO_L3_BITRATE_80K = 5,
320 V4L2_MPEG_AUDIO_L3_BITRATE_96K = 6,
321 V4L2_MPEG_AUDIO_L3_BITRATE_112K = 7,
322 V4L2_MPEG_AUDIO_L3_BITRATE_128K = 8,
323 V4L2_MPEG_AUDIO_L3_BITRATE_160K = 9,
324 V4L2_MPEG_AUDIO_L3_BITRATE_192K = 10,
325 V4L2_MPEG_AUDIO_L3_BITRATE_224K = 11,
326 V4L2_MPEG_AUDIO_L3_BITRATE_256K = 12,
327 V4L2_MPEG_AUDIO_L3_BITRATE_320K = 13,
329 #define V4L2_CID_MPEG_AUDIO_MODE (V4L2_CID_CODEC_BASE+105)
330 enum v4l2_mpeg_audio_mode {
331 V4L2_MPEG_AUDIO_MODE_STEREO = 0,
332 V4L2_MPEG_AUDIO_MODE_JOINT_STEREO = 1,
333 V4L2_MPEG_AUDIO_MODE_DUAL = 2,
334 V4L2_MPEG_AUDIO_MODE_MONO = 3,
336 #define V4L2_CID_MPEG_AUDIO_MODE_EXTENSION (V4L2_CID_CODEC_BASE+106)
337 enum v4l2_mpeg_audio_mode_extension {
338 V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_4 = 0,
339 V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_8 = 1,
340 V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_12 = 2,
341 V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_16 = 3,
343 #define V4L2_CID_MPEG_AUDIO_EMPHASIS (V4L2_CID_CODEC_BASE+107)
344 enum v4l2_mpeg_audio_emphasis {
345 V4L2_MPEG_AUDIO_EMPHASIS_NONE = 0,
346 V4L2_MPEG_AUDIO_EMPHASIS_50_DIV_15_uS = 1,
347 V4L2_MPEG_AUDIO_EMPHASIS_CCITT_J17 = 2,
349 #define V4L2_CID_MPEG_AUDIO_CRC (V4L2_CID_CODEC_BASE+108)
350 enum v4l2_mpeg_audio_crc {
351 V4L2_MPEG_AUDIO_CRC_NONE = 0,
352 V4L2_MPEG_AUDIO_CRC_CRC16 = 1,
354 #define V4L2_CID_MPEG_AUDIO_MUTE (V4L2_CID_CODEC_BASE+109)
355 #define V4L2_CID_MPEG_AUDIO_AAC_BITRATE (V4L2_CID_CODEC_BASE+110)
356 #define V4L2_CID_MPEG_AUDIO_AC3_BITRATE (V4L2_CID_CODEC_BASE+111)
357 enum v4l2_mpeg_audio_ac3_bitrate {
358 V4L2_MPEG_AUDIO_AC3_BITRATE_32K = 0,
359 V4L2_MPEG_AUDIO_AC3_BITRATE_40K = 1,
360 V4L2_MPEG_AUDIO_AC3_BITRATE_48K = 2,
361 V4L2_MPEG_AUDIO_AC3_BITRATE_56K = 3,
362 V4L2_MPEG_AUDIO_AC3_BITRATE_64K = 4,
363 V4L2_MPEG_AUDIO_AC3_BITRATE_80K = 5,
364 V4L2_MPEG_AUDIO_AC3_BITRATE_96K = 6,
365 V4L2_MPEG_AUDIO_AC3_BITRATE_112K = 7,
366 V4L2_MPEG_AUDIO_AC3_BITRATE_128K = 8,
367 V4L2_MPEG_AUDIO_AC3_BITRATE_160K = 9,
368 V4L2_MPEG_AUDIO_AC3_BITRATE_192K = 10,
369 V4L2_MPEG_AUDIO_AC3_BITRATE_224K = 11,
370 V4L2_MPEG_AUDIO_AC3_BITRATE_256K = 12,
371 V4L2_MPEG_AUDIO_AC3_BITRATE_320K = 13,
372 V4L2_MPEG_AUDIO_AC3_BITRATE_384K = 14,
373 V4L2_MPEG_AUDIO_AC3_BITRATE_448K = 15,
374 V4L2_MPEG_AUDIO_AC3_BITRATE_512K = 16,
375 V4L2_MPEG_AUDIO_AC3_BITRATE_576K = 17,
376 V4L2_MPEG_AUDIO_AC3_BITRATE_640K = 18,
378 #define V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK (V4L2_CID_CODEC_BASE+112)
379 enum v4l2_mpeg_audio_dec_playback {
380 V4L2_MPEG_AUDIO_DEC_PLAYBACK_AUTO = 0,
381 V4L2_MPEG_AUDIO_DEC_PLAYBACK_STEREO = 1,
382 V4L2_MPEG_AUDIO_DEC_PLAYBACK_LEFT = 2,
383 V4L2_MPEG_AUDIO_DEC_PLAYBACK_RIGHT = 3,
384 V4L2_MPEG_AUDIO_DEC_PLAYBACK_MONO = 4,
385 V4L2_MPEG_AUDIO_DEC_PLAYBACK_SWAPPED_STEREO = 5,
387 #define V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK (V4L2_CID_CODEC_BASE+113)
389 /* MPEG video controls specific to multiplexed streams */
390 #define V4L2_CID_MPEG_VIDEO_ENCODING (V4L2_CID_CODEC_BASE+200)
391 enum v4l2_mpeg_video_encoding {
392 V4L2_MPEG_VIDEO_ENCODING_MPEG_1 = 0,
393 V4L2_MPEG_VIDEO_ENCODING_MPEG_2 = 1,
394 V4L2_MPEG_VIDEO_ENCODING_MPEG_4_AVC = 2,
396 #define V4L2_CID_MPEG_VIDEO_ASPECT (V4L2_CID_CODEC_BASE+201)
397 enum v4l2_mpeg_video_aspect {
398 V4L2_MPEG_VIDEO_ASPECT_1x1 = 0,
399 V4L2_MPEG_VIDEO_ASPECT_4x3 = 1,
400 V4L2_MPEG_VIDEO_ASPECT_16x9 = 2,
401 V4L2_MPEG_VIDEO_ASPECT_221x100 = 3,
403 #define V4L2_CID_MPEG_VIDEO_B_FRAMES (V4L2_CID_CODEC_BASE+202)
404 #define V4L2_CID_MPEG_VIDEO_GOP_SIZE (V4L2_CID_CODEC_BASE+203)
405 #define V4L2_CID_MPEG_VIDEO_GOP_CLOSURE (V4L2_CID_CODEC_BASE+204)
406 #define V4L2_CID_MPEG_VIDEO_PULLDOWN (V4L2_CID_CODEC_BASE+205)
407 #define V4L2_CID_MPEG_VIDEO_BITRATE_MODE (V4L2_CID_CODEC_BASE+206)
408 enum v4l2_mpeg_video_bitrate_mode {
409 V4L2_MPEG_VIDEO_BITRATE_MODE_VBR = 0,
410 V4L2_MPEG_VIDEO_BITRATE_MODE_CBR = 1,
411 V4L2_MPEG_VIDEO_BITRATE_MODE_CQ = 2,
413 #define V4L2_CID_MPEG_VIDEO_BITRATE (V4L2_CID_CODEC_BASE+207)
414 #define V4L2_CID_MPEG_VIDEO_BITRATE_PEAK (V4L2_CID_CODEC_BASE+208)
415 #define V4L2_CID_MPEG_VIDEO_TEMPORAL_DECIMATION (V4L2_CID_CODEC_BASE+209)
416 #define V4L2_CID_MPEG_VIDEO_MUTE (V4L2_CID_CODEC_BASE+210)
417 #define V4L2_CID_MPEG_VIDEO_MUTE_YUV (V4L2_CID_CODEC_BASE+211)
418 #define V4L2_CID_MPEG_VIDEO_DECODER_SLICE_INTERFACE (V4L2_CID_CODEC_BASE+212)
419 #define V4L2_CID_MPEG_VIDEO_DECODER_MPEG4_DEBLOCK_FILTER (V4L2_CID_CODEC_BASE+213)
420 #define V4L2_CID_MPEG_VIDEO_CYCLIC_INTRA_REFRESH_MB (V4L2_CID_CODEC_BASE+214)
421 #define V4L2_CID_MPEG_VIDEO_FRAME_RC_ENABLE (V4L2_CID_CODEC_BASE+215)
422 #define V4L2_CID_MPEG_VIDEO_HEADER_MODE (V4L2_CID_CODEC_BASE+216)
423 enum v4l2_mpeg_video_header_mode {
424 V4L2_MPEG_VIDEO_HEADER_MODE_SEPARATE = 0,
425 V4L2_MPEG_VIDEO_HEADER_MODE_JOINED_WITH_1ST_FRAME = 1,
428 #define V4L2_CID_MPEG_VIDEO_MAX_REF_PIC (V4L2_CID_CODEC_BASE+217)
429 #define V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE (V4L2_CID_CODEC_BASE+218)
430 #define V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_BYTES (V4L2_CID_CODEC_BASE+219)
431 #define V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_MB (V4L2_CID_CODEC_BASE+220)
432 #define V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE (V4L2_CID_CODEC_BASE+221)
433 enum v4l2_mpeg_video_multi_slice_mode {
434 V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_SINGLE = 0,
435 V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_MB = 1,
436 V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_BYTES = 2,
438 /* Kept for backwards compatibility reasons. Stupid typo... */
439 V4L2_MPEG_VIDEO_MULTI_SICE_MODE_MAX_MB = 1,
440 V4L2_MPEG_VIDEO_MULTI_SICE_MODE_MAX_BYTES = 2,
443 #define V4L2_CID_MPEG_VIDEO_VBV_SIZE (V4L2_CID_CODEC_BASE+222)
444 #define V4L2_CID_MPEG_VIDEO_DEC_PTS (V4L2_CID_CODEC_BASE+223)
445 #define V4L2_CID_MPEG_VIDEO_DEC_FRAME (V4L2_CID_CODEC_BASE+224)
446 #define V4L2_CID_MPEG_VIDEO_VBV_DELAY (V4L2_CID_CODEC_BASE+225)
447 #define V4L2_CID_MPEG_VIDEO_REPEAT_SEQ_HEADER (V4L2_CID_CODEC_BASE+226)
448 #define V4L2_CID_MPEG_VIDEO_MV_H_SEARCH_RANGE (V4L2_CID_CODEC_BASE+227)
449 #define V4L2_CID_MPEG_VIDEO_MV_V_SEARCH_RANGE (V4L2_CID_CODEC_BASE+228)
450 #define V4L2_CID_MPEG_VIDEO_FORCE_KEY_FRAME (V4L2_CID_CODEC_BASE+229)
451 #define V4L2_CID_MPEG_VIDEO_BASELAYER_PRIORITY_ID (V4L2_CID_CODEC_BASE+230)
452 #define V4L2_CID_MPEG_VIDEO_AU_DELIMITER (V4L2_CID_CODEC_BASE+231)
453 #define V4L2_CID_MPEG_VIDEO_LTR_COUNT (V4L2_CID_CODEC_BASE+232)
454 #define V4L2_CID_MPEG_VIDEO_FRAME_LTR_INDEX (V4L2_CID_CODEC_BASE+233)
455 #define V4L2_CID_MPEG_VIDEO_USE_LTR_FRAMES (V4L2_CID_CODEC_BASE+234)
456 #define V4L2_CID_MPEG_VIDEO_DEC_CONCEAL_COLOR (V4L2_CID_CODEC_BASE+235)
457 #define V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD (V4L2_CID_CODEC_BASE+236)
458 #define V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE (V4L2_CID_CODEC_BASE+237)
459 enum v4l2_mpeg_video_intra_refresh_period_type {
460 V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE_RANDOM = 0,
461 V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE_CYCLIC = 1,
464 /* CIDs for the MPEG-2 Part 2 (H.262) codec */
465 #define V4L2_CID_MPEG_VIDEO_MPEG2_LEVEL (V4L2_CID_CODEC_BASE+270)
466 enum v4l2_mpeg_video_mpeg2_level {
467 V4L2_MPEG_VIDEO_MPEG2_LEVEL_LOW = 0,
468 V4L2_MPEG_VIDEO_MPEG2_LEVEL_MAIN = 1,
469 V4L2_MPEG_VIDEO_MPEG2_LEVEL_HIGH_1440 = 2,
470 V4L2_MPEG_VIDEO_MPEG2_LEVEL_HIGH = 3,
472 #define V4L2_CID_MPEG_VIDEO_MPEG2_PROFILE (V4L2_CID_CODEC_BASE+271)
473 enum v4l2_mpeg_video_mpeg2_profile {
474 V4L2_MPEG_VIDEO_MPEG2_PROFILE_SIMPLE = 0,
475 V4L2_MPEG_VIDEO_MPEG2_PROFILE_MAIN = 1,
476 V4L2_MPEG_VIDEO_MPEG2_PROFILE_SNR_SCALABLE = 2,
477 V4L2_MPEG_VIDEO_MPEG2_PROFILE_SPATIALLY_SCALABLE = 3,
478 V4L2_MPEG_VIDEO_MPEG2_PROFILE_HIGH = 4,
479 V4L2_MPEG_VIDEO_MPEG2_PROFILE_MULTIVIEW = 5,
482 /* CIDs for the FWHT codec as used by the vicodec driver. */
483 #define V4L2_CID_FWHT_I_FRAME_QP (V4L2_CID_CODEC_BASE + 290)
484 #define V4L2_CID_FWHT_P_FRAME_QP (V4L2_CID_CODEC_BASE + 291)
486 #define V4L2_CID_MPEG_VIDEO_H263_I_FRAME_QP (V4L2_CID_CODEC_BASE+300)
487 #define V4L2_CID_MPEG_VIDEO_H263_P_FRAME_QP (V4L2_CID_CODEC_BASE+301)
488 #define V4L2_CID_MPEG_VIDEO_H263_B_FRAME_QP (V4L2_CID_CODEC_BASE+302)
489 #define V4L2_CID_MPEG_VIDEO_H263_MIN_QP (V4L2_CID_CODEC_BASE+303)
490 #define V4L2_CID_MPEG_VIDEO_H263_MAX_QP (V4L2_CID_CODEC_BASE+304)
491 #define V4L2_CID_MPEG_VIDEO_H264_I_FRAME_QP (V4L2_CID_CODEC_BASE+350)
492 #define V4L2_CID_MPEG_VIDEO_H264_P_FRAME_QP (V4L2_CID_CODEC_BASE+351)
493 #define V4L2_CID_MPEG_VIDEO_H264_B_FRAME_QP (V4L2_CID_CODEC_BASE+352)
494 #define V4L2_CID_MPEG_VIDEO_H264_MIN_QP (V4L2_CID_CODEC_BASE+353)
495 #define V4L2_CID_MPEG_VIDEO_H264_MAX_QP (V4L2_CID_CODEC_BASE+354)
496 #define V4L2_CID_MPEG_VIDEO_H264_8X8_TRANSFORM (V4L2_CID_CODEC_BASE+355)
497 #define V4L2_CID_MPEG_VIDEO_H264_CPB_SIZE (V4L2_CID_CODEC_BASE+356)
498 #define V4L2_CID_MPEG_VIDEO_H264_ENTROPY_MODE (V4L2_CID_CODEC_BASE+357)
499 enum v4l2_mpeg_video_h264_entropy_mode {
500 V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CAVLC = 0,
501 V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CABAC = 1,
503 #define V4L2_CID_MPEG_VIDEO_H264_I_PERIOD (V4L2_CID_CODEC_BASE+358)
504 #define V4L2_CID_MPEG_VIDEO_H264_LEVEL (V4L2_CID_CODEC_BASE+359)
505 enum v4l2_mpeg_video_h264_level {
506 V4L2_MPEG_VIDEO_H264_LEVEL_1_0 = 0,
507 V4L2_MPEG_VIDEO_H264_LEVEL_1B = 1,
508 V4L2_MPEG_VIDEO_H264_LEVEL_1_1 = 2,
509 V4L2_MPEG_VIDEO_H264_LEVEL_1_2 = 3,
510 V4L2_MPEG_VIDEO_H264_LEVEL_1_3 = 4,
511 V4L2_MPEG_VIDEO_H264_LEVEL_2_0 = 5,
512 V4L2_MPEG_VIDEO_H264_LEVEL_2_1 = 6,
513 V4L2_MPEG_VIDEO_H264_LEVEL_2_2 = 7,
514 V4L2_MPEG_VIDEO_H264_LEVEL_3_0 = 8,
515 V4L2_MPEG_VIDEO_H264_LEVEL_3_1 = 9,
516 V4L2_MPEG_VIDEO_H264_LEVEL_3_2 = 10,
517 V4L2_MPEG_VIDEO_H264_LEVEL_4_0 = 11,
518 V4L2_MPEG_VIDEO_H264_LEVEL_4_1 = 12,
519 V4L2_MPEG_VIDEO_H264_LEVEL_4_2 = 13,
520 V4L2_MPEG_VIDEO_H264_LEVEL_5_0 = 14,
521 V4L2_MPEG_VIDEO_H264_LEVEL_5_1 = 15,
522 V4L2_MPEG_VIDEO_H264_LEVEL_5_2 = 16,
523 V4L2_MPEG_VIDEO_H264_LEVEL_6_0 = 17,
524 V4L2_MPEG_VIDEO_H264_LEVEL_6_1 = 18,
525 V4L2_MPEG_VIDEO_H264_LEVEL_6_2 = 19,
527 #define V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_ALPHA (V4L2_CID_CODEC_BASE+360)
528 #define V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_BETA (V4L2_CID_CODEC_BASE+361)
529 #define V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_MODE (V4L2_CID_CODEC_BASE+362)
530 enum v4l2_mpeg_video_h264_loop_filter_mode {
531 V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_ENABLED = 0,
532 V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED = 1,
533 V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED_AT_SLICE_BOUNDARY = 2,
535 #define V4L2_CID_MPEG_VIDEO_H264_PROFILE (V4L2_CID_CODEC_BASE+363)
536 enum v4l2_mpeg_video_h264_profile {
537 V4L2_MPEG_VIDEO_H264_PROFILE_BASELINE = 0,
538 V4L2_MPEG_VIDEO_H264_PROFILE_CONSTRAINED_BASELINE = 1,
539 V4L2_MPEG_VIDEO_H264_PROFILE_MAIN = 2,
540 V4L2_MPEG_VIDEO_H264_PROFILE_EXTENDED = 3,
541 V4L2_MPEG_VIDEO_H264_PROFILE_HIGH = 4,
542 V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10 = 5,
543 V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422 = 6,
544 V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_PREDICTIVE = 7,
545 V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10_INTRA = 8,
546 V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422_INTRA = 9,
547 V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_INTRA = 10,
548 V4L2_MPEG_VIDEO_H264_PROFILE_CAVLC_444_INTRA = 11,
549 V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_BASELINE = 12,
550 V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH = 13,
551 V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH_INTRA = 14,
552 V4L2_MPEG_VIDEO_H264_PROFILE_STEREO_HIGH = 15,
553 V4L2_MPEG_VIDEO_H264_PROFILE_MULTIVIEW_HIGH = 16,
554 V4L2_MPEG_VIDEO_H264_PROFILE_CONSTRAINED_HIGH = 17,
556 #define V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_HEIGHT (V4L2_CID_CODEC_BASE+364)
557 #define V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_WIDTH (V4L2_CID_CODEC_BASE+365)
558 #define V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_ENABLE (V4L2_CID_CODEC_BASE+366)
559 #define V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_IDC (V4L2_CID_CODEC_BASE+367)
560 enum v4l2_mpeg_video_h264_vui_sar_idc {
561 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_UNSPECIFIED = 0,
562 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_1x1 = 1,
563 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_12x11 = 2,
564 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_10x11 = 3,
565 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_16x11 = 4,
566 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_40x33 = 5,
567 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_24x11 = 6,
568 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_20x11 = 7,
569 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_32x11 = 8,
570 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_80x33 = 9,
571 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_18x11 = 10,
572 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_15x11 = 11,
573 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_64x33 = 12,
574 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_160x99 = 13,
575 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_4x3 = 14,
576 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_3x2 = 15,
577 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_2x1 = 16,
578 V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_EXTENDED = 17,
580 #define V4L2_CID_MPEG_VIDEO_H264_SEI_FRAME_PACKING (V4L2_CID_CODEC_BASE+368)
581 #define V4L2_CID_MPEG_VIDEO_H264_SEI_FP_CURRENT_FRAME_0 (V4L2_CID_CODEC_BASE+369)
582 #define V4L2_CID_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE (V4L2_CID_CODEC_BASE+370)
583 enum v4l2_mpeg_video_h264_sei_fp_arrangement_type {
584 V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_CHECKERBOARD = 0,
585 V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_COLUMN = 1,
586 V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_ROW = 2,
587 V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_SIDE_BY_SIDE = 3,
588 V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_TOP_BOTTOM = 4,
589 V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_TEMPORAL = 5,
591 #define V4L2_CID_MPEG_VIDEO_H264_FMO (V4L2_CID_CODEC_BASE+371)
592 #define V4L2_CID_MPEG_VIDEO_H264_FMO_MAP_TYPE (V4L2_CID_CODEC_BASE+372)
593 enum v4l2_mpeg_video_h264_fmo_map_type {
594 V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_INTERLEAVED_SLICES = 0,
595 V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_SCATTERED_SLICES = 1,
596 V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_FOREGROUND_WITH_LEFT_OVER = 2,
597 V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_BOX_OUT = 3,
598 V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_RASTER_SCAN = 4,
599 V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_WIPE_SCAN = 5,
600 V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_EXPLICIT = 6,
602 #define V4L2_CID_MPEG_VIDEO_H264_FMO_SLICE_GROUP (V4L2_CID_CODEC_BASE+373)
603 #define V4L2_CID_MPEG_VIDEO_H264_FMO_CHANGE_DIRECTION (V4L2_CID_CODEC_BASE+374)
604 enum v4l2_mpeg_video_h264_fmo_change_dir {
605 V4L2_MPEG_VIDEO_H264_FMO_CHANGE_DIR_RIGHT = 0,
606 V4L2_MPEG_VIDEO_H264_FMO_CHANGE_DIR_LEFT = 1,
608 #define V4L2_CID_MPEG_VIDEO_H264_FMO_CHANGE_RATE (V4L2_CID_CODEC_BASE+375)
609 #define V4L2_CID_MPEG_VIDEO_H264_FMO_RUN_LENGTH (V4L2_CID_CODEC_BASE+376)
610 #define V4L2_CID_MPEG_VIDEO_H264_ASO (V4L2_CID_CODEC_BASE+377)
611 #define V4L2_CID_MPEG_VIDEO_H264_ASO_SLICE_ORDER (V4L2_CID_CODEC_BASE+378)
612 #define V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING (V4L2_CID_CODEC_BASE+379)
613 #define V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_TYPE (V4L2_CID_CODEC_BASE+380)
614 enum v4l2_mpeg_video_h264_hierarchical_coding_type {
615 V4L2_MPEG_VIDEO_H264_HIERARCHICAL_CODING_B = 0,
616 V4L2_MPEG_VIDEO_H264_HIERARCHICAL_CODING_P = 1,
618 #define V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_LAYER (V4L2_CID_CODEC_BASE+381)
619 #define V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_LAYER_QP (V4L2_CID_CODEC_BASE+382)
620 #define V4L2_CID_MPEG_VIDEO_H264_CONSTRAINED_INTRA_PREDICTION (V4L2_CID_CODEC_BASE+383)
621 #define V4L2_CID_MPEG_VIDEO_H264_CHROMA_QP_INDEX_OFFSET (V4L2_CID_CODEC_BASE+384)
622 #define V4L2_CID_MPEG_VIDEO_H264_I_FRAME_MIN_QP (V4L2_CID_CODEC_BASE+385)
623 #define V4L2_CID_MPEG_VIDEO_H264_I_FRAME_MAX_QP (V4L2_CID_CODEC_BASE+386)
624 #define V4L2_CID_MPEG_VIDEO_H264_P_FRAME_MIN_QP (V4L2_CID_CODEC_BASE+387)
625 #define V4L2_CID_MPEG_VIDEO_H264_P_FRAME_MAX_QP (V4L2_CID_CODEC_BASE+388)
626 #define V4L2_CID_MPEG_VIDEO_H264_B_FRAME_MIN_QP (V4L2_CID_CODEC_BASE+389)
627 #define V4L2_CID_MPEG_VIDEO_H264_B_FRAME_MAX_QP (V4L2_CID_CODEC_BASE+390)
628 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L0_BR (V4L2_CID_CODEC_BASE+391)
629 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L1_BR (V4L2_CID_CODEC_BASE+392)
630 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L2_BR (V4L2_CID_CODEC_BASE+393)
631 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L3_BR (V4L2_CID_CODEC_BASE+394)
632 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L4_BR (V4L2_CID_CODEC_BASE+395)
633 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L5_BR (V4L2_CID_CODEC_BASE+396)
634 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L6_BR (V4L2_CID_CODEC_BASE+397)
635 #define V4L2_CID_MPEG_VIDEO_MPEG4_I_FRAME_QP (V4L2_CID_CODEC_BASE+400)
636 #define V4L2_CID_MPEG_VIDEO_MPEG4_P_FRAME_QP (V4L2_CID_CODEC_BASE+401)
637 #define V4L2_CID_MPEG_VIDEO_MPEG4_B_FRAME_QP (V4L2_CID_CODEC_BASE+402)
638 #define V4L2_CID_MPEG_VIDEO_MPEG4_MIN_QP (V4L2_CID_CODEC_BASE+403)
639 #define V4L2_CID_MPEG_VIDEO_MPEG4_MAX_QP (V4L2_CID_CODEC_BASE+404)
640 #define V4L2_CID_MPEG_VIDEO_MPEG4_LEVEL (V4L2_CID_CODEC_BASE+405)
641 enum v4l2_mpeg_video_mpeg4_level {
642 V4L2_MPEG_VIDEO_MPEG4_LEVEL_0 = 0,
643 V4L2_MPEG_VIDEO_MPEG4_LEVEL_0B = 1,
644 V4L2_MPEG_VIDEO_MPEG4_LEVEL_1 = 2,
645 V4L2_MPEG_VIDEO_MPEG4_LEVEL_2 = 3,
646 V4L2_MPEG_VIDEO_MPEG4_LEVEL_3 = 4,
647 V4L2_MPEG_VIDEO_MPEG4_LEVEL_3B = 5,
648 V4L2_MPEG_VIDEO_MPEG4_LEVEL_4 = 6,
649 V4L2_MPEG_VIDEO_MPEG4_LEVEL_5 = 7,
651 #define V4L2_CID_MPEG_VIDEO_MPEG4_PROFILE (V4L2_CID_CODEC_BASE+406)
652 enum v4l2_mpeg_video_mpeg4_profile {
653 V4L2_MPEG_VIDEO_MPEG4_PROFILE_SIMPLE = 0,
654 V4L2_MPEG_VIDEO_MPEG4_PROFILE_ADVANCED_SIMPLE = 1,
655 V4L2_MPEG_VIDEO_MPEG4_PROFILE_CORE = 2,
656 V4L2_MPEG_VIDEO_MPEG4_PROFILE_SIMPLE_SCALABLE = 3,
657 V4L2_MPEG_VIDEO_MPEG4_PROFILE_ADVANCED_CODING_EFFICIENCY = 4,
659 #define V4L2_CID_MPEG_VIDEO_MPEG4_QPEL (V4L2_CID_CODEC_BASE+407)
661 /* Control IDs for VP8 streams
662 * Although VP8 is not part of MPEG we add these controls to the MPEG class
663 * as that class is already handling other video compression standards
665 #define V4L2_CID_MPEG_VIDEO_VPX_NUM_PARTITIONS (V4L2_CID_CODEC_BASE+500)
666 enum v4l2_vp8_num_partitions {
667 V4L2_CID_MPEG_VIDEO_VPX_1_PARTITION = 0,
668 V4L2_CID_MPEG_VIDEO_VPX_2_PARTITIONS = 1,
669 V4L2_CID_MPEG_VIDEO_VPX_4_PARTITIONS = 2,
670 V4L2_CID_MPEG_VIDEO_VPX_8_PARTITIONS = 3,
672 #define V4L2_CID_MPEG_VIDEO_VPX_IMD_DISABLE_4X4 (V4L2_CID_CODEC_BASE+501)
673 #define V4L2_CID_MPEG_VIDEO_VPX_NUM_REF_FRAMES (V4L2_CID_CODEC_BASE+502)
674 enum v4l2_vp8_num_ref_frames {
675 V4L2_CID_MPEG_VIDEO_VPX_1_REF_FRAME = 0,
676 V4L2_CID_MPEG_VIDEO_VPX_2_REF_FRAME = 1,
677 V4L2_CID_MPEG_VIDEO_VPX_3_REF_FRAME = 2,
679 #define V4L2_CID_MPEG_VIDEO_VPX_FILTER_LEVEL (V4L2_CID_CODEC_BASE+503)
680 #define V4L2_CID_MPEG_VIDEO_VPX_FILTER_SHARPNESS (V4L2_CID_CODEC_BASE+504)
681 #define V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_REF_PERIOD (V4L2_CID_CODEC_BASE+505)
682 #define V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_SEL (V4L2_CID_CODEC_BASE+506)
683 enum v4l2_vp8_golden_frame_sel {
684 V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_USE_PREV = 0,
685 V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_USE_REF_PERIOD = 1,
687 #define V4L2_CID_MPEG_VIDEO_VPX_MIN_QP (V4L2_CID_CODEC_BASE+507)
688 #define V4L2_CID_MPEG_VIDEO_VPX_MAX_QP (V4L2_CID_CODEC_BASE+508)
689 #define V4L2_CID_MPEG_VIDEO_VPX_I_FRAME_QP (V4L2_CID_CODEC_BASE+509)
690 #define V4L2_CID_MPEG_VIDEO_VPX_P_FRAME_QP (V4L2_CID_CODEC_BASE+510)
692 #define V4L2_CID_MPEG_VIDEO_VP8_PROFILE (V4L2_CID_CODEC_BASE+511)
693 enum v4l2_mpeg_video_vp8_profile {
694 V4L2_MPEG_VIDEO_VP8_PROFILE_0 = 0,
695 V4L2_MPEG_VIDEO_VP8_PROFILE_1 = 1,
696 V4L2_MPEG_VIDEO_VP8_PROFILE_2 = 2,
697 V4L2_MPEG_VIDEO_VP8_PROFILE_3 = 3,
699 /* Deprecated alias for compatibility reasons. */
700 #define V4L2_CID_MPEG_VIDEO_VPX_PROFILE V4L2_CID_MPEG_VIDEO_VP8_PROFILE
701 #define V4L2_CID_MPEG_VIDEO_VP9_PROFILE (V4L2_CID_CODEC_BASE+512)
702 enum v4l2_mpeg_video_vp9_profile {
703 V4L2_MPEG_VIDEO_VP9_PROFILE_0 = 0,
704 V4L2_MPEG_VIDEO_VP9_PROFILE_1 = 1,
705 V4L2_MPEG_VIDEO_VP9_PROFILE_2 = 2,
706 V4L2_MPEG_VIDEO_VP9_PROFILE_3 = 3,
708 #define V4L2_CID_MPEG_VIDEO_VP9_LEVEL (V4L2_CID_CODEC_BASE+513)
709 enum v4l2_mpeg_video_vp9_level {
710 V4L2_MPEG_VIDEO_VP9_LEVEL_1_0 = 0,
711 V4L2_MPEG_VIDEO_VP9_LEVEL_1_1 = 1,
712 V4L2_MPEG_VIDEO_VP9_LEVEL_2_0 = 2,
713 V4L2_MPEG_VIDEO_VP9_LEVEL_2_1 = 3,
714 V4L2_MPEG_VIDEO_VP9_LEVEL_3_0 = 4,
715 V4L2_MPEG_VIDEO_VP9_LEVEL_3_1 = 5,
716 V4L2_MPEG_VIDEO_VP9_LEVEL_4_0 = 6,
717 V4L2_MPEG_VIDEO_VP9_LEVEL_4_1 = 7,
718 V4L2_MPEG_VIDEO_VP9_LEVEL_5_0 = 8,
719 V4L2_MPEG_VIDEO_VP9_LEVEL_5_1 = 9,
720 V4L2_MPEG_VIDEO_VP9_LEVEL_5_2 = 10,
721 V4L2_MPEG_VIDEO_VP9_LEVEL_6_0 = 11,
722 V4L2_MPEG_VIDEO_VP9_LEVEL_6_1 = 12,
723 V4L2_MPEG_VIDEO_VP9_LEVEL_6_2 = 13,
726 /* CIDs for HEVC encoding. */
728 #define V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP (V4L2_CID_CODEC_BASE + 600)
729 #define V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP (V4L2_CID_CODEC_BASE + 601)
730 #define V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_QP (V4L2_CID_CODEC_BASE + 602)
731 #define V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_QP (V4L2_CID_CODEC_BASE + 603)
732 #define V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_QP (V4L2_CID_CODEC_BASE + 604)
733 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_QP (V4L2_CID_CODEC_BASE + 605)
734 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_TYPE (V4L2_CID_CODEC_BASE + 606)
735 enum v4l2_mpeg_video_hevc_hier_coding_type {
736 V4L2_MPEG_VIDEO_HEVC_HIERARCHICAL_CODING_B = 0,
737 V4L2_MPEG_VIDEO_HEVC_HIERARCHICAL_CODING_P = 1,
739 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_LAYER (V4L2_CID_CODEC_BASE + 607)
740 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L0_QP (V4L2_CID_CODEC_BASE + 608)
741 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L1_QP (V4L2_CID_CODEC_BASE + 609)
742 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L2_QP (V4L2_CID_CODEC_BASE + 610)
743 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L3_QP (V4L2_CID_CODEC_BASE + 611)
744 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L4_QP (V4L2_CID_CODEC_BASE + 612)
745 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L5_QP (V4L2_CID_CODEC_BASE + 613)
746 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L6_QP (V4L2_CID_CODEC_BASE + 614)
747 #define V4L2_CID_MPEG_VIDEO_HEVC_PROFILE (V4L2_CID_CODEC_BASE + 615)
748 enum v4l2_mpeg_video_hevc_profile {
749 V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN = 0,
750 V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN_STILL_PICTURE = 1,
751 V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN_10 = 2,
753 #define V4L2_CID_MPEG_VIDEO_HEVC_LEVEL (V4L2_CID_CODEC_BASE + 616)
754 enum v4l2_mpeg_video_hevc_level {
755 V4L2_MPEG_VIDEO_HEVC_LEVEL_1 = 0,
756 V4L2_MPEG_VIDEO_HEVC_LEVEL_2 = 1,
757 V4L2_MPEG_VIDEO_HEVC_LEVEL_2_1 = 2,
758 V4L2_MPEG_VIDEO_HEVC_LEVEL_3 = 3,
759 V4L2_MPEG_VIDEO_HEVC_LEVEL_3_1 = 4,
760 V4L2_MPEG_VIDEO_HEVC_LEVEL_4 = 5,
761 V4L2_MPEG_VIDEO_HEVC_LEVEL_4_1 = 6,
762 V4L2_MPEG_VIDEO_HEVC_LEVEL_5 = 7,
763 V4L2_MPEG_VIDEO_HEVC_LEVEL_5_1 = 8,
764 V4L2_MPEG_VIDEO_HEVC_LEVEL_5_2 = 9,
765 V4L2_MPEG_VIDEO_HEVC_LEVEL_6 = 10,
766 V4L2_MPEG_VIDEO_HEVC_LEVEL_6_1 = 11,
767 V4L2_MPEG_VIDEO_HEVC_LEVEL_6_2 = 12,
769 #define V4L2_CID_MPEG_VIDEO_HEVC_FRAME_RATE_RESOLUTION (V4L2_CID_CODEC_BASE + 617)
770 #define V4L2_CID_MPEG_VIDEO_HEVC_TIER (V4L2_CID_CODEC_BASE + 618)
771 enum v4l2_mpeg_video_hevc_tier {
772 V4L2_MPEG_VIDEO_HEVC_TIER_MAIN = 0,
773 V4L2_MPEG_VIDEO_HEVC_TIER_HIGH = 1,
775 #define V4L2_CID_MPEG_VIDEO_HEVC_MAX_PARTITION_DEPTH (V4L2_CID_CODEC_BASE + 619)
776 #define V4L2_CID_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE (V4L2_CID_CODEC_BASE + 620)
777 enum v4l2_cid_mpeg_video_hevc_loop_filter_mode {
778 V4L2_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE_DISABLED = 0,
779 V4L2_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE_ENABLED = 1,
780 V4L2_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE_DISABLED_AT_SLICE_BOUNDARY = 2,
782 #define V4L2_CID_MPEG_VIDEO_HEVC_LF_BETA_OFFSET_DIV2 (V4L2_CID_CODEC_BASE + 621)
783 #define V4L2_CID_MPEG_VIDEO_HEVC_LF_TC_OFFSET_DIV2 (V4L2_CID_CODEC_BASE + 622)
784 #define V4L2_CID_MPEG_VIDEO_HEVC_REFRESH_TYPE (V4L2_CID_CODEC_BASE + 623)
785 enum v4l2_cid_mpeg_video_hevc_refresh_type {
786 V4L2_MPEG_VIDEO_HEVC_REFRESH_NONE = 0,
787 V4L2_MPEG_VIDEO_HEVC_REFRESH_CRA = 1,
788 V4L2_MPEG_VIDEO_HEVC_REFRESH_IDR = 2,
790 #define V4L2_CID_MPEG_VIDEO_HEVC_REFRESH_PERIOD (V4L2_CID_CODEC_BASE + 624)
791 #define V4L2_CID_MPEG_VIDEO_HEVC_LOSSLESS_CU (V4L2_CID_CODEC_BASE + 625)
792 #define V4L2_CID_MPEG_VIDEO_HEVC_CONST_INTRA_PRED (V4L2_CID_CODEC_BASE + 626)
793 #define V4L2_CID_MPEG_VIDEO_HEVC_WAVEFRONT (V4L2_CID_CODEC_BASE + 627)
794 #define V4L2_CID_MPEG_VIDEO_HEVC_GENERAL_PB (V4L2_CID_CODEC_BASE + 628)
795 #define V4L2_CID_MPEG_VIDEO_HEVC_TEMPORAL_ID (V4L2_CID_CODEC_BASE + 629)
796 #define V4L2_CID_MPEG_VIDEO_HEVC_STRONG_SMOOTHING (V4L2_CID_CODEC_BASE + 630)
797 #define V4L2_CID_MPEG_VIDEO_HEVC_MAX_NUM_MERGE_MV_MINUS1 (V4L2_CID_CODEC_BASE + 631)
798 #define V4L2_CID_MPEG_VIDEO_HEVC_INTRA_PU_SPLIT (V4L2_CID_CODEC_BASE + 632)
799 #define V4L2_CID_MPEG_VIDEO_HEVC_TMV_PREDICTION (V4L2_CID_CODEC_BASE + 633)
800 #define V4L2_CID_MPEG_VIDEO_HEVC_WITHOUT_STARTCODE (V4L2_CID_CODEC_BASE + 634)
801 #define V4L2_CID_MPEG_VIDEO_HEVC_SIZE_OF_LENGTH_FIELD (V4L2_CID_CODEC_BASE + 635)
802 enum v4l2_cid_mpeg_video_hevc_size_of_length_field {
803 V4L2_MPEG_VIDEO_HEVC_SIZE_0 = 0,
804 V4L2_MPEG_VIDEO_HEVC_SIZE_1 = 1,
805 V4L2_MPEG_VIDEO_HEVC_SIZE_2 = 2,
806 V4L2_MPEG_VIDEO_HEVC_SIZE_4 = 3,
808 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L0_BR (V4L2_CID_CODEC_BASE + 636)
809 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L1_BR (V4L2_CID_CODEC_BASE + 637)
810 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L2_BR (V4L2_CID_CODEC_BASE + 638)
811 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L3_BR (V4L2_CID_CODEC_BASE + 639)
812 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L4_BR (V4L2_CID_CODEC_BASE + 640)
813 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L5_BR (V4L2_CID_CODEC_BASE + 641)
814 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L6_BR (V4L2_CID_CODEC_BASE + 642)
815 #define V4L2_CID_MPEG_VIDEO_REF_NUMBER_FOR_PFRAMES (V4L2_CID_CODEC_BASE + 643)
816 #define V4L2_CID_MPEG_VIDEO_PREPEND_SPSPPS_TO_IDR (V4L2_CID_CODEC_BASE + 644)
817 #define V4L2_CID_MPEG_VIDEO_CONSTANT_QUALITY (V4L2_CID_CODEC_BASE + 645)
818 #define V4L2_CID_MPEG_VIDEO_FRAME_SKIP_MODE (V4L2_CID_CODEC_BASE + 646)
819 enum v4l2_mpeg_video_frame_skip_mode {
820 V4L2_MPEG_VIDEO_FRAME_SKIP_MODE_DISABLED = 0,
821 V4L2_MPEG_VIDEO_FRAME_SKIP_MODE_LEVEL_LIMIT = 1,
822 V4L2_MPEG_VIDEO_FRAME_SKIP_MODE_BUF_LIMIT = 2,
825 #define V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_MIN_QP (V4L2_CID_CODEC_BASE + 647)
826 #define V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_MAX_QP (V4L2_CID_CODEC_BASE + 648)
827 #define V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_MIN_QP (V4L2_CID_CODEC_BASE + 649)
828 #define V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_MAX_QP (V4L2_CID_CODEC_BASE + 650)
829 #define V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_MIN_QP (V4L2_CID_CODEC_BASE + 651)
830 #define V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_MAX_QP (V4L2_CID_CODEC_BASE + 652)
832 #define V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY (V4L2_CID_CODEC_BASE + 653)
833 #define V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY_ENABLE (V4L2_CID_CODEC_BASE + 654)
835 /* MPEG-class control IDs specific to the CX2341x driver as defined by V4L2 */
836 #define V4L2_CID_CODEC_CX2341X_BASE (V4L2_CTRL_CLASS_CODEC | 0x1000)
837 #define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE (V4L2_CID_CODEC_CX2341X_BASE+0)
838 enum v4l2_mpeg_cx2341x_video_spatial_filter_mode {
839 V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_MANUAL = 0,
840 V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_AUTO = 1,
842 #define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER (V4L2_CID_CODEC_CX2341X_BASE+1)
843 #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE (V4L2_CID_CODEC_CX2341X_BASE+2)
844 enum v4l2_mpeg_cx2341x_video_luma_spatial_filter_type {
845 V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_OFF = 0,
846 V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_HOR = 1,
847 V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_VERT = 2,
848 V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_HV_SEPARABLE = 3,
849 V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_SYM_NON_SEPARABLE = 4,
851 #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE (V4L2_CID_CODEC_CX2341X_BASE+3)
852 enum v4l2_mpeg_cx2341x_video_chroma_spatial_filter_type {
853 V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_OFF = 0,
854 V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_1D_HOR = 1,
856 #define V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE (V4L2_CID_CODEC_CX2341X_BASE+4)
857 enum v4l2_mpeg_cx2341x_video_temporal_filter_mode {
858 V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_MANUAL = 0,
859 V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_AUTO = 1,
861 #define V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER (V4L2_CID_CODEC_CX2341X_BASE+5)
862 #define V4L2_CID_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE (V4L2_CID_CODEC_CX2341X_BASE+6)
863 enum v4l2_mpeg_cx2341x_video_median_filter_type {
864 V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_OFF = 0,
865 V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR = 1,
866 V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_VERT = 2,
867 V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR_VERT = 3,
868 V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_DIAG = 4,
870 #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_BOTTOM (V4L2_CID_CODEC_CX2341X_BASE+7)
871 #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_TOP (V4L2_CID_CODEC_CX2341X_BASE+8)
872 #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_BOTTOM (V4L2_CID_CODEC_CX2341X_BASE+9)
873 #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_TOP (V4L2_CID_CODEC_CX2341X_BASE+10)
874 #define V4L2_CID_MPEG_CX2341X_STREAM_INSERT_NAV_PACKETS (V4L2_CID_CODEC_CX2341X_BASE+11)
876 /* MPEG-class control IDs specific to the Samsung MFC 5.1 driver as defined by V4L2 */
877 #define V4L2_CID_CODEC_MFC51_BASE (V4L2_CTRL_CLASS_CODEC | 0x1100)
879 #define V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY (V4L2_CID_CODEC_MFC51_BASE+0)
880 #define V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY_ENABLE (V4L2_CID_CODEC_MFC51_BASE+1)
881 #define V4L2_CID_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE (V4L2_CID_CODEC_MFC51_BASE+2)
882 enum v4l2_mpeg_mfc51_video_frame_skip_mode {
883 V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_DISABLED = 0,
884 V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_LEVEL_LIMIT = 1,
885 V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_BUF_LIMIT = 2,
887 #define V4L2_CID_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE (V4L2_CID_CODEC_MFC51_BASE+3)
888 enum v4l2_mpeg_mfc51_video_force_frame_type {
889 V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_DISABLED = 0,
890 V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_I_FRAME = 1,
891 V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_NOT_CODED = 2,
893 #define V4L2_CID_MPEG_MFC51_VIDEO_PADDING (V4L2_CID_CODEC_MFC51_BASE+4)
894 #define V4L2_CID_MPEG_MFC51_VIDEO_PADDING_YUV (V4L2_CID_CODEC_MFC51_BASE+5)
895 #define V4L2_CID_MPEG_MFC51_VIDEO_RC_FIXED_TARGET_BIT (V4L2_CID_CODEC_MFC51_BASE+6)
896 #define V4L2_CID_MPEG_MFC51_VIDEO_RC_REACTION_COEFF (V4L2_CID_CODEC_MFC51_BASE+7)
897 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_ACTIVITY (V4L2_CID_CODEC_MFC51_BASE+50)
898 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_DARK (V4L2_CID_CODEC_MFC51_BASE+51)
899 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_SMOOTH (V4L2_CID_CODEC_MFC51_BASE+52)
900 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_STATIC (V4L2_CID_CODEC_MFC51_BASE+53)
901 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_NUM_REF_PIC_FOR_P (V4L2_CID_CODEC_MFC51_BASE+54)
903 /* Camera class control IDs */
905 #define V4L2_CID_CAMERA_CLASS_BASE (V4L2_CTRL_CLASS_CAMERA | 0x900)
906 #define V4L2_CID_CAMERA_CLASS (V4L2_CTRL_CLASS_CAMERA | 1)
908 #define V4L2_CID_EXPOSURE_AUTO (V4L2_CID_CAMERA_CLASS_BASE+1)
909 enum v4l2_exposure_auto_type {
910 V4L2_EXPOSURE_AUTO = 0,
911 V4L2_EXPOSURE_MANUAL = 1,
912 V4L2_EXPOSURE_SHUTTER_PRIORITY = 2,
913 V4L2_EXPOSURE_APERTURE_PRIORITY = 3
915 #define V4L2_CID_EXPOSURE_ABSOLUTE (V4L2_CID_CAMERA_CLASS_BASE+2)
916 #define V4L2_CID_EXPOSURE_AUTO_PRIORITY (V4L2_CID_CAMERA_CLASS_BASE+3)
918 #define V4L2_CID_PAN_RELATIVE (V4L2_CID_CAMERA_CLASS_BASE+4)
919 #define V4L2_CID_TILT_RELATIVE (V4L2_CID_CAMERA_CLASS_BASE+5)
920 #define V4L2_CID_PAN_RESET (V4L2_CID_CAMERA_CLASS_BASE+6)
921 #define V4L2_CID_TILT_RESET (V4L2_CID_CAMERA_CLASS_BASE+7)
923 #define V4L2_CID_PAN_ABSOLUTE (V4L2_CID_CAMERA_CLASS_BASE+8)
924 #define V4L2_CID_TILT_ABSOLUTE (V4L2_CID_CAMERA_CLASS_BASE+9)
926 #define V4L2_CID_FOCUS_ABSOLUTE (V4L2_CID_CAMERA_CLASS_BASE+10)
927 #define V4L2_CID_FOCUS_RELATIVE (V4L2_CID_CAMERA_CLASS_BASE+11)
928 #define V4L2_CID_FOCUS_AUTO (V4L2_CID_CAMERA_CLASS_BASE+12)
930 #define V4L2_CID_ZOOM_ABSOLUTE (V4L2_CID_CAMERA_CLASS_BASE+13)
931 #define V4L2_CID_ZOOM_RELATIVE (V4L2_CID_CAMERA_CLASS_BASE+14)
932 #define V4L2_CID_ZOOM_CONTINUOUS (V4L2_CID_CAMERA_CLASS_BASE+15)
934 #define V4L2_CID_PRIVACY (V4L2_CID_CAMERA_CLASS_BASE+16)
936 #define V4L2_CID_IRIS_ABSOLUTE (V4L2_CID_CAMERA_CLASS_BASE+17)
937 #define V4L2_CID_IRIS_RELATIVE (V4L2_CID_CAMERA_CLASS_BASE+18)
939 #define V4L2_CID_AUTO_EXPOSURE_BIAS (V4L2_CID_CAMERA_CLASS_BASE+19)
941 #define V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE (V4L2_CID_CAMERA_CLASS_BASE+20)
942 enum v4l2_auto_n_preset_white_balance {
943 V4L2_WHITE_BALANCE_MANUAL = 0,
944 V4L2_WHITE_BALANCE_AUTO = 1,
945 V4L2_WHITE_BALANCE_INCANDESCENT = 2,
946 V4L2_WHITE_BALANCE_FLUORESCENT = 3,
947 V4L2_WHITE_BALANCE_FLUORESCENT_H = 4,
948 V4L2_WHITE_BALANCE_HORIZON = 5,
949 V4L2_WHITE_BALANCE_DAYLIGHT = 6,
950 V4L2_WHITE_BALANCE_FLASH = 7,
951 V4L2_WHITE_BALANCE_CLOUDY = 8,
952 V4L2_WHITE_BALANCE_SHADE = 9,
955 #define V4L2_CID_WIDE_DYNAMIC_RANGE (V4L2_CID_CAMERA_CLASS_BASE+21)
956 #define V4L2_CID_IMAGE_STABILIZATION (V4L2_CID_CAMERA_CLASS_BASE+22)
958 #define V4L2_CID_ISO_SENSITIVITY (V4L2_CID_CAMERA_CLASS_BASE+23)
959 #define V4L2_CID_ISO_SENSITIVITY_AUTO (V4L2_CID_CAMERA_CLASS_BASE+24)
960 enum v4l2_iso_sensitivity_auto_type {
961 V4L2_ISO_SENSITIVITY_MANUAL = 0,
962 V4L2_ISO_SENSITIVITY_AUTO = 1,
965 #define V4L2_CID_EXPOSURE_METERING (V4L2_CID_CAMERA_CLASS_BASE+25)
966 enum v4l2_exposure_metering {
967 V4L2_EXPOSURE_METERING_AVERAGE = 0,
968 V4L2_EXPOSURE_METERING_CENTER_WEIGHTED = 1,
969 V4L2_EXPOSURE_METERING_SPOT = 2,
970 V4L2_EXPOSURE_METERING_MATRIX = 3,
973 #define V4L2_CID_SCENE_MODE (V4L2_CID_CAMERA_CLASS_BASE+26)
974 enum v4l2_scene_mode {
975 V4L2_SCENE_MODE_NONE = 0,
976 V4L2_SCENE_MODE_BACKLIGHT = 1,
977 V4L2_SCENE_MODE_BEACH_SNOW = 2,
978 V4L2_SCENE_MODE_CANDLE_LIGHT = 3,
979 V4L2_SCENE_MODE_DAWN_DUSK = 4,
980 V4L2_SCENE_MODE_FALL_COLORS = 5,
981 V4L2_SCENE_MODE_FIREWORKS = 6,
982 V4L2_SCENE_MODE_LANDSCAPE = 7,
983 V4L2_SCENE_MODE_NIGHT = 8,
984 V4L2_SCENE_MODE_PARTY_INDOOR = 9,
985 V4L2_SCENE_MODE_PORTRAIT = 10,
986 V4L2_SCENE_MODE_SPORTS = 11,
987 V4L2_SCENE_MODE_SUNSET = 12,
988 V4L2_SCENE_MODE_TEXT = 13,
991 #define V4L2_CID_3A_LOCK (V4L2_CID_CAMERA_CLASS_BASE+27)
992 #define V4L2_LOCK_EXPOSURE (1 << 0)
993 #define V4L2_LOCK_WHITE_BALANCE (1 << 1)
994 #define V4L2_LOCK_FOCUS (1 << 2)
996 #define V4L2_CID_AUTO_FOCUS_START (V4L2_CID_CAMERA_CLASS_BASE+28)
997 #define V4L2_CID_AUTO_FOCUS_STOP (V4L2_CID_CAMERA_CLASS_BASE+29)
998 #define V4L2_CID_AUTO_FOCUS_STATUS (V4L2_CID_CAMERA_CLASS_BASE+30)
999 #define V4L2_AUTO_FOCUS_STATUS_IDLE (0 << 0)
1000 #define V4L2_AUTO_FOCUS_STATUS_BUSY (1 << 0)
1001 #define V4L2_AUTO_FOCUS_STATUS_REACHED (1 << 1)
1002 #define V4L2_AUTO_FOCUS_STATUS_FAILED (1 << 2)
1004 #define V4L2_CID_AUTO_FOCUS_RANGE (V4L2_CID_CAMERA_CLASS_BASE+31)
1005 enum v4l2_auto_focus_range {
1006 V4L2_AUTO_FOCUS_RANGE_AUTO = 0,
1007 V4L2_AUTO_FOCUS_RANGE_NORMAL = 1,
1008 V4L2_AUTO_FOCUS_RANGE_MACRO = 2,
1009 V4L2_AUTO_FOCUS_RANGE_INFINITY = 3,
1012 #define V4L2_CID_PAN_SPEED (V4L2_CID_CAMERA_CLASS_BASE+32)
1013 #define V4L2_CID_TILT_SPEED (V4L2_CID_CAMERA_CLASS_BASE+33)
1015 #define V4L2_CID_CAMERA_ORIENTATION (V4L2_CID_CAMERA_CLASS_BASE+34)
1016 #define V4L2_CAMERA_ORIENTATION_FRONT 0
1017 #define V4L2_CAMERA_ORIENTATION_BACK 1
1018 #define V4L2_CAMERA_ORIENTATION_EXTERNAL 2
1020 #define V4L2_CID_CAMERA_SENSOR_ROTATION (V4L2_CID_CAMERA_CLASS_BASE+35)
1022 /* FM Modulator class control IDs */
1024 #define V4L2_CID_FM_TX_CLASS_BASE (V4L2_CTRL_CLASS_FM_TX | 0x900)
1025 #define V4L2_CID_FM_TX_CLASS (V4L2_CTRL_CLASS_FM_TX | 1)
1027 #define V4L2_CID_RDS_TX_DEVIATION (V4L2_CID_FM_TX_CLASS_BASE + 1)
1028 #define V4L2_CID_RDS_TX_PI (V4L2_CID_FM_TX_CLASS_BASE + 2)
1029 #define V4L2_CID_RDS_TX_PTY (V4L2_CID_FM_TX_CLASS_BASE + 3)
1030 #define V4L2_CID_RDS_TX_PS_NAME (V4L2_CID_FM_TX_CLASS_BASE + 5)
1031 #define V4L2_CID_RDS_TX_RADIO_TEXT (V4L2_CID_FM_TX_CLASS_BASE + 6)
1032 #define V4L2_CID_RDS_TX_MONO_STEREO (V4L2_CID_FM_TX_CLASS_BASE + 7)
1033 #define V4L2_CID_RDS_TX_ARTIFICIAL_HEAD (V4L2_CID_FM_TX_CLASS_BASE + 8)
1034 #define V4L2_CID_RDS_TX_COMPRESSED (V4L2_CID_FM_TX_CLASS_BASE + 9)
1035 #define V4L2_CID_RDS_TX_DYNAMIC_PTY (V4L2_CID_FM_TX_CLASS_BASE + 10)
1036 #define V4L2_CID_RDS_TX_TRAFFIC_ANNOUNCEMENT (V4L2_CID_FM_TX_CLASS_BASE + 11)
1037 #define V4L2_CID_RDS_TX_TRAFFIC_PROGRAM (V4L2_CID_FM_TX_CLASS_BASE + 12)
1038 #define V4L2_CID_RDS_TX_MUSIC_SPEECH (V4L2_CID_FM_TX_CLASS_BASE + 13)
1039 #define V4L2_CID_RDS_TX_ALT_FREQS_ENABLE (V4L2_CID_FM_TX_CLASS_BASE + 14)
1040 #define V4L2_CID_RDS_TX_ALT_FREQS (V4L2_CID_FM_TX_CLASS_BASE + 15)
1042 #define V4L2_CID_AUDIO_LIMITER_ENABLED (V4L2_CID_FM_TX_CLASS_BASE + 64)
1043 #define V4L2_CID_AUDIO_LIMITER_RELEASE_TIME (V4L2_CID_FM_TX_CLASS_BASE + 65)
1044 #define V4L2_CID_AUDIO_LIMITER_DEVIATION (V4L2_CID_FM_TX_CLASS_BASE + 66)
1046 #define V4L2_CID_AUDIO_COMPRESSION_ENABLED (V4L2_CID_FM_TX_CLASS_BASE + 80)
1047 #define V4L2_CID_AUDIO_COMPRESSION_GAIN (V4L2_CID_FM_TX_CLASS_BASE + 81)
1048 #define V4L2_CID_AUDIO_COMPRESSION_THRESHOLD (V4L2_CID_FM_TX_CLASS_BASE + 82)
1049 #define V4L2_CID_AUDIO_COMPRESSION_ATTACK_TIME (V4L2_CID_FM_TX_CLASS_BASE + 83)
1050 #define V4L2_CID_AUDIO_COMPRESSION_RELEASE_TIME (V4L2_CID_FM_TX_CLASS_BASE + 84)
1052 #define V4L2_CID_PILOT_TONE_ENABLED (V4L2_CID_FM_TX_CLASS_BASE + 96)
1053 #define V4L2_CID_PILOT_TONE_DEVIATION (V4L2_CID_FM_TX_CLASS_BASE + 97)
1054 #define V4L2_CID_PILOT_TONE_FREQUENCY (V4L2_CID_FM_TX_CLASS_BASE + 98)
1056 #define V4L2_CID_TUNE_PREEMPHASIS (V4L2_CID_FM_TX_CLASS_BASE + 112)
1057 enum v4l2_preemphasis {
1058 V4L2_PREEMPHASIS_DISABLED = 0,
1059 V4L2_PREEMPHASIS_50_uS = 1,
1060 V4L2_PREEMPHASIS_75_uS = 2,
1062 #define V4L2_CID_TUNE_POWER_LEVEL (V4L2_CID_FM_TX_CLASS_BASE + 113)
1063 #define V4L2_CID_TUNE_ANTENNA_CAPACITOR (V4L2_CID_FM_TX_CLASS_BASE + 114)
1066 /* Flash and privacy (indicator) light controls */
1068 #define V4L2_CID_FLASH_CLASS_BASE (V4L2_CTRL_CLASS_FLASH | 0x900)
1069 #define V4L2_CID_FLASH_CLASS (V4L2_CTRL_CLASS_FLASH | 1)
1071 #define V4L2_CID_FLASH_LED_MODE (V4L2_CID_FLASH_CLASS_BASE + 1)
1072 enum v4l2_flash_led_mode {
1073 V4L2_FLASH_LED_MODE_NONE,
1074 V4L2_FLASH_LED_MODE_FLASH,
1075 V4L2_FLASH_LED_MODE_TORCH,
1078 #define V4L2_CID_FLASH_STROBE_SOURCE (V4L2_CID_FLASH_CLASS_BASE + 2)
1079 enum v4l2_flash_strobe_source {
1080 V4L2_FLASH_STROBE_SOURCE_SOFTWARE,
1081 V4L2_FLASH_STROBE_SOURCE_EXTERNAL,
1084 #define V4L2_CID_FLASH_STROBE (V4L2_CID_FLASH_CLASS_BASE + 3)
1085 #define V4L2_CID_FLASH_STROBE_STOP (V4L2_CID_FLASH_CLASS_BASE + 4)
1086 #define V4L2_CID_FLASH_STROBE_STATUS (V4L2_CID_FLASH_CLASS_BASE + 5)
1088 #define V4L2_CID_FLASH_TIMEOUT (V4L2_CID_FLASH_CLASS_BASE + 6)
1089 #define V4L2_CID_FLASH_INTENSITY (V4L2_CID_FLASH_CLASS_BASE + 7)
1090 #define V4L2_CID_FLASH_TORCH_INTENSITY (V4L2_CID_FLASH_CLASS_BASE + 8)
1091 #define V4L2_CID_FLASH_INDICATOR_INTENSITY (V4L2_CID_FLASH_CLASS_BASE + 9)
1093 #define V4L2_CID_FLASH_FAULT (V4L2_CID_FLASH_CLASS_BASE + 10)
1094 #define V4L2_FLASH_FAULT_OVER_VOLTAGE (1 << 0)
1095 #define V4L2_FLASH_FAULT_TIMEOUT (1 << 1)
1096 #define V4L2_FLASH_FAULT_OVER_TEMPERATURE (1 << 2)
1097 #define V4L2_FLASH_FAULT_SHORT_CIRCUIT (1 << 3)
1098 #define V4L2_FLASH_FAULT_OVER_CURRENT (1 << 4)
1099 #define V4L2_FLASH_FAULT_INDICATOR (1 << 5)
1100 #define V4L2_FLASH_FAULT_UNDER_VOLTAGE (1 << 6)
1101 #define V4L2_FLASH_FAULT_INPUT_VOLTAGE (1 << 7)
1102 #define V4L2_FLASH_FAULT_LED_OVER_TEMPERATURE (1 << 8)
1104 #define V4L2_CID_FLASH_CHARGE (V4L2_CID_FLASH_CLASS_BASE + 11)
1105 #define V4L2_CID_FLASH_READY (V4L2_CID_FLASH_CLASS_BASE + 12)
1108 /* JPEG-class control IDs */
1110 #define V4L2_CID_JPEG_CLASS_BASE (V4L2_CTRL_CLASS_JPEG | 0x900)
1111 #define V4L2_CID_JPEG_CLASS (V4L2_CTRL_CLASS_JPEG | 1)
1113 #define V4L2_CID_JPEG_CHROMA_SUBSAMPLING (V4L2_CID_JPEG_CLASS_BASE + 1)
1114 enum v4l2_jpeg_chroma_subsampling {
1115 V4L2_JPEG_CHROMA_SUBSAMPLING_444 = 0,
1116 V4L2_JPEG_CHROMA_SUBSAMPLING_422 = 1,
1117 V4L2_JPEG_CHROMA_SUBSAMPLING_420 = 2,
1118 V4L2_JPEG_CHROMA_SUBSAMPLING_411 = 3,
1119 V4L2_JPEG_CHROMA_SUBSAMPLING_410 = 4,
1120 V4L2_JPEG_CHROMA_SUBSAMPLING_GRAY = 5,
1122 #define V4L2_CID_JPEG_RESTART_INTERVAL (V4L2_CID_JPEG_CLASS_BASE + 2)
1123 #define V4L2_CID_JPEG_COMPRESSION_QUALITY (V4L2_CID_JPEG_CLASS_BASE + 3)
1125 #define V4L2_CID_JPEG_ACTIVE_MARKER (V4L2_CID_JPEG_CLASS_BASE + 4)
1126 #define V4L2_JPEG_ACTIVE_MARKER_APP0 (1 << 0)
1127 #define V4L2_JPEG_ACTIVE_MARKER_APP1 (1 << 1)
1128 #define V4L2_JPEG_ACTIVE_MARKER_COM (1 << 16)
1129 #define V4L2_JPEG_ACTIVE_MARKER_DQT (1 << 17)
1130 #define V4L2_JPEG_ACTIVE_MARKER_DHT (1 << 18)
1133 /* Image source controls */
1134 #define V4L2_CID_IMAGE_SOURCE_CLASS_BASE (V4L2_CTRL_CLASS_IMAGE_SOURCE | 0x900)
1135 #define V4L2_CID_IMAGE_SOURCE_CLASS (V4L2_CTRL_CLASS_IMAGE_SOURCE | 1)
1137 #define V4L2_CID_VBLANK (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 1)
1138 #define V4L2_CID_HBLANK (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 2)
1139 #define V4L2_CID_ANALOGUE_GAIN (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 3)
1140 #define V4L2_CID_TEST_PATTERN_RED (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 4)
1141 #define V4L2_CID_TEST_PATTERN_GREENR (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 5)
1142 #define V4L2_CID_TEST_PATTERN_BLUE (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 6)
1143 #define V4L2_CID_TEST_PATTERN_GREENB (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 7)
1144 #define V4L2_CID_UNIT_CELL_SIZE (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 8)
1145 #define V4L2_CID_NOTIFY_GAINS (V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 9)
1148 /* Image processing controls */
1150 #define V4L2_CID_IMAGE_PROC_CLASS_BASE (V4L2_CTRL_CLASS_IMAGE_PROC | 0x900)
1151 #define V4L2_CID_IMAGE_PROC_CLASS (V4L2_CTRL_CLASS_IMAGE_PROC | 1)
1153 #define V4L2_CID_LINK_FREQ (V4L2_CID_IMAGE_PROC_CLASS_BASE + 1)
1154 #define V4L2_CID_PIXEL_RATE (V4L2_CID_IMAGE_PROC_CLASS_BASE + 2)
1155 #define V4L2_CID_TEST_PATTERN (V4L2_CID_IMAGE_PROC_CLASS_BASE + 3)
1156 #define V4L2_CID_DEINTERLACING_MODE (V4L2_CID_IMAGE_PROC_CLASS_BASE + 4)
1157 #define V4L2_CID_DIGITAL_GAIN (V4L2_CID_IMAGE_PROC_CLASS_BASE + 5)
1159 /* DV-class control IDs defined by V4L2 */
1160 #define V4L2_CID_DV_CLASS_BASE (V4L2_CTRL_CLASS_DV | 0x900)
1161 #define V4L2_CID_DV_CLASS (V4L2_CTRL_CLASS_DV | 1)
1163 #define V4L2_CID_DV_TX_HOTPLUG (V4L2_CID_DV_CLASS_BASE + 1)
1164 #define V4L2_CID_DV_TX_RXSENSE (V4L2_CID_DV_CLASS_BASE + 2)
1165 #define V4L2_CID_DV_TX_EDID_PRESENT (V4L2_CID_DV_CLASS_BASE + 3)
1166 #define V4L2_CID_DV_TX_MODE (V4L2_CID_DV_CLASS_BASE + 4)
1167 enum v4l2_dv_tx_mode {
1168 V4L2_DV_TX_MODE_DVI_D = 0,
1169 V4L2_DV_TX_MODE_HDMI = 1,
1171 #define V4L2_CID_DV_TX_RGB_RANGE (V4L2_CID_DV_CLASS_BASE + 5)
1172 enum v4l2_dv_rgb_range {
1173 V4L2_DV_RGB_RANGE_AUTO = 0,
1174 V4L2_DV_RGB_RANGE_LIMITED = 1,
1175 V4L2_DV_RGB_RANGE_FULL = 2,
1178 #define V4L2_CID_DV_TX_IT_CONTENT_TYPE (V4L2_CID_DV_CLASS_BASE + 6)
1179 enum v4l2_dv_it_content_type {
1180 V4L2_DV_IT_CONTENT_TYPE_GRAPHICS = 0,
1181 V4L2_DV_IT_CONTENT_TYPE_PHOTO = 1,
1182 V4L2_DV_IT_CONTENT_TYPE_CINEMA = 2,
1183 V4L2_DV_IT_CONTENT_TYPE_GAME = 3,
1184 V4L2_DV_IT_CONTENT_TYPE_NO_ITC = 4,
1187 #define V4L2_CID_DV_RX_POWER_PRESENT (V4L2_CID_DV_CLASS_BASE + 100)
1188 #define V4L2_CID_DV_RX_RGB_RANGE (V4L2_CID_DV_CLASS_BASE + 101)
1189 #define V4L2_CID_DV_RX_IT_CONTENT_TYPE (V4L2_CID_DV_CLASS_BASE + 102)
1191 #define V4L2_CID_FM_RX_CLASS_BASE (V4L2_CTRL_CLASS_FM_RX | 0x900)
1192 #define V4L2_CID_FM_RX_CLASS (V4L2_CTRL_CLASS_FM_RX | 1)
1194 #define V4L2_CID_TUNE_DEEMPHASIS (V4L2_CID_FM_RX_CLASS_BASE + 1)
1195 enum v4l2_deemphasis {
1196 V4L2_DEEMPHASIS_DISABLED = V4L2_PREEMPHASIS_DISABLED,
1197 V4L2_DEEMPHASIS_50_uS = V4L2_PREEMPHASIS_50_uS,
1198 V4L2_DEEMPHASIS_75_uS = V4L2_PREEMPHASIS_75_uS,
1201 #define V4L2_CID_RDS_RECEPTION (V4L2_CID_FM_RX_CLASS_BASE + 2)
1202 #define V4L2_CID_RDS_RX_PTY (V4L2_CID_FM_RX_CLASS_BASE + 3)
1203 #define V4L2_CID_RDS_RX_PS_NAME (V4L2_CID_FM_RX_CLASS_BASE + 4)
1204 #define V4L2_CID_RDS_RX_RADIO_TEXT (V4L2_CID_FM_RX_CLASS_BASE + 5)
1205 #define V4L2_CID_RDS_RX_TRAFFIC_ANNOUNCEMENT (V4L2_CID_FM_RX_CLASS_BASE + 6)
1206 #define V4L2_CID_RDS_RX_TRAFFIC_PROGRAM (V4L2_CID_FM_RX_CLASS_BASE + 7)
1207 #define V4L2_CID_RDS_RX_MUSIC_SPEECH (V4L2_CID_FM_RX_CLASS_BASE + 8)
1209 #define V4L2_CID_RF_TUNER_CLASS_BASE (V4L2_CTRL_CLASS_RF_TUNER | 0x900)
1210 #define V4L2_CID_RF_TUNER_CLASS (V4L2_CTRL_CLASS_RF_TUNER | 1)
1212 #define V4L2_CID_RF_TUNER_BANDWIDTH_AUTO (V4L2_CID_RF_TUNER_CLASS_BASE + 11)
1213 #define V4L2_CID_RF_TUNER_BANDWIDTH (V4L2_CID_RF_TUNER_CLASS_BASE + 12)
1214 #define V4L2_CID_RF_TUNER_RF_GAIN (V4L2_CID_RF_TUNER_CLASS_BASE + 32)
1215 #define V4L2_CID_RF_TUNER_LNA_GAIN_AUTO (V4L2_CID_RF_TUNER_CLASS_BASE + 41)
1216 #define V4L2_CID_RF_TUNER_LNA_GAIN (V4L2_CID_RF_TUNER_CLASS_BASE + 42)
1217 #define V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO (V4L2_CID_RF_TUNER_CLASS_BASE + 51)
1218 #define V4L2_CID_RF_TUNER_MIXER_GAIN (V4L2_CID_RF_TUNER_CLASS_BASE + 52)
1219 #define V4L2_CID_RF_TUNER_IF_GAIN_AUTO (V4L2_CID_RF_TUNER_CLASS_BASE + 61)
1220 #define V4L2_CID_RF_TUNER_IF_GAIN (V4L2_CID_RF_TUNER_CLASS_BASE + 62)
1221 #define V4L2_CID_RF_TUNER_PLL_LOCK (V4L2_CID_RF_TUNER_CLASS_BASE + 91)
1224 /* Detection-class control IDs defined by V4L2 */
1225 #define V4L2_CID_DETECT_CLASS_BASE (V4L2_CTRL_CLASS_DETECT | 0x900)
1226 #define V4L2_CID_DETECT_CLASS (V4L2_CTRL_CLASS_DETECT | 1)
1228 #define V4L2_CID_DETECT_MD_MODE (V4L2_CID_DETECT_CLASS_BASE + 1)
1229 enum v4l2_detect_md_mode {
1230 V4L2_DETECT_MD_MODE_DISABLED = 0,
1231 V4L2_DETECT_MD_MODE_GLOBAL = 1,
1232 V4L2_DETECT_MD_MODE_THRESHOLD_GRID = 2,
1233 V4L2_DETECT_MD_MODE_REGION_GRID = 3,
1235 #define V4L2_CID_DETECT_MD_GLOBAL_THRESHOLD (V4L2_CID_DETECT_CLASS_BASE + 2)
1236 #define V4L2_CID_DETECT_MD_THRESHOLD_GRID (V4L2_CID_DETECT_CLASS_BASE + 3)
1237 #define V4L2_CID_DETECT_MD_REGION_GRID (V4L2_CID_DETECT_CLASS_BASE + 4)
1240 /* Stateless CODECs controls */
1241 #define V4L2_CID_CODEC_STATELESS_BASE (V4L2_CTRL_CLASS_CODEC_STATELESS | 0x900)
1242 #define V4L2_CID_CODEC_STATELESS_CLASS (V4L2_CTRL_CLASS_CODEC_STATELESS | 1)
1244 #define V4L2_CID_STATELESS_H264_DECODE_MODE (V4L2_CID_CODEC_STATELESS_BASE + 0)
1246 * enum v4l2_stateless_h264_decode_mode - Decoding mode
1248 * @V4L2_STATELESS_H264_DECODE_MODE_SLICE_BASED: indicates that decoding
1249 * is performed one slice at a time. In this mode,
1250 * V4L2_CID_STATELESS_H264_SLICE_PARAMS must contain the parsed slice
1251 * parameters and the OUTPUT buffer must contain a single slice.
1252 * V4L2_BUF_CAP_SUPPORTS_M2M_HOLD_CAPTURE_BUF feature is used
1253 * in order to support multislice frames.
1254 * @V4L2_STATELESS_H264_DECODE_MODE_FRAME_BASED: indicates that
1255 * decoding is performed per frame. The OUTPUT buffer must contain
1256 * all slices and also both fields. This mode is typically supported
1257 * by device drivers that are able to parse the slice(s) header(s)
1258 * in hardware. When this mode is selected,
1259 * V4L2_CID_STATELESS_H264_SLICE_PARAMS is not used.
1261 enum v4l2_stateless_h264_decode_mode {
1262 V4L2_STATELESS_H264_DECODE_MODE_SLICE_BASED,
1263 V4L2_STATELESS_H264_DECODE_MODE_FRAME_BASED,
1266 #define V4L2_CID_STATELESS_H264_START_CODE (V4L2_CID_CODEC_STATELESS_BASE + 1)
1268 * enum v4l2_stateless_h264_start_code - Start code
1270 * @V4L2_STATELESS_H264_START_CODE_NONE: slices are passed
1271 * to the driver without any start code.
1272 * @V4L2_STATELESS_H264_START_CODE_ANNEX_B: slices are passed
1273 * to the driver with an Annex B start code prefix
1274 * (legal start codes can be 3-bytes 0x000001 or 4-bytes 0x00000001).
1275 * This mode is typically supported by device drivers that parse
1276 * the start code in hardware.
1278 enum v4l2_stateless_h264_start_code {
1279 V4L2_STATELESS_H264_START_CODE_NONE,
1280 V4L2_STATELESS_H264_START_CODE_ANNEX_B,
1283 #define V4L2_H264_SPS_CONSTRAINT_SET0_FLAG 0x01
1284 #define V4L2_H264_SPS_CONSTRAINT_SET1_FLAG 0x02
1285 #define V4L2_H264_SPS_CONSTRAINT_SET2_FLAG 0x04
1286 #define V4L2_H264_SPS_CONSTRAINT_SET3_FLAG 0x08
1287 #define V4L2_H264_SPS_CONSTRAINT_SET4_FLAG 0x10
1288 #define V4L2_H264_SPS_CONSTRAINT_SET5_FLAG 0x20
1290 #define V4L2_H264_SPS_FLAG_SEPARATE_COLOUR_PLANE 0x01
1291 #define V4L2_H264_SPS_FLAG_QPPRIME_Y_ZERO_TRANSFORM_BYPASS 0x02
1292 #define V4L2_H264_SPS_FLAG_DELTA_PIC_ORDER_ALWAYS_ZERO 0x04
1293 #define V4L2_H264_SPS_FLAG_GAPS_IN_FRAME_NUM_VALUE_ALLOWED 0x08
1294 #define V4L2_H264_SPS_FLAG_FRAME_MBS_ONLY 0x10
1295 #define V4L2_H264_SPS_FLAG_MB_ADAPTIVE_FRAME_FIELD 0x20
1296 #define V4L2_H264_SPS_FLAG_DIRECT_8X8_INFERENCE 0x40
1298 #define V4L2_H264_SPS_HAS_CHROMA_FORMAT(sps) \
1299 ((sps)->profile_idc == 100 || (sps)->profile_idc == 110 || \
1300 (sps)->profile_idc == 122 || (sps)->profile_idc == 244 || \
1301 (sps)->profile_idc == 44 || (sps)->profile_idc == 83 || \
1302 (sps)->profile_idc == 86 || (sps)->profile_idc == 118 || \
1303 (sps)->profile_idc == 128 || (sps)->profile_idc == 138 || \
1304 (sps)->profile_idc == 139 || (sps)->profile_idc == 134 || \
1305 (sps)->profile_idc == 135)
1307 #define V4L2_CID_STATELESS_H264_SPS (V4L2_CID_CODEC_STATELESS_BASE + 2)
1309 * struct v4l2_ctrl_h264_sps - H264 sequence parameter set
1311 * All the members on this sequence parameter set structure match the
1312 * sequence parameter set syntax as specified by the H264 specification.
1314 * @profile_idc: see H264 specification.
1315 * @constraint_set_flags: see H264 specification.
1316 * @level_idc: see H264 specification.
1317 * @seq_parameter_set_id: see H264 specification.
1318 * @chroma_format_idc: see H264 specification.
1319 * @bit_depth_luma_minus8: see H264 specification.
1320 * @bit_depth_chroma_minus8: see H264 specification.
1321 * @log2_max_frame_num_minus4: see H264 specification.
1322 * @pic_order_cnt_type: see H264 specification.
1323 * @log2_max_pic_order_cnt_lsb_minus4: see H264 specification.
1324 * @max_num_ref_frames: see H264 specification.
1325 * @num_ref_frames_in_pic_order_cnt_cycle: see H264 specification.
1326 * @offset_for_ref_frame: see H264 specification.
1327 * @offset_for_non_ref_pic: see H264 specification.
1328 * @offset_for_top_to_bottom_field: see H264 specification.
1329 * @pic_width_in_mbs_minus1: see H264 specification.
1330 * @pic_height_in_map_units_minus1: see H264 specification.
1331 * @flags: see V4L2_H264_SPS_FLAG_{}.
1333 struct v4l2_ctrl_h264_sps {
1335 __u8 constraint_set_flags;
1337 __u8 seq_parameter_set_id;
1338 __u8 chroma_format_idc;
1339 __u8 bit_depth_luma_minus8;
1340 __u8 bit_depth_chroma_minus8;
1341 __u8 log2_max_frame_num_minus4;
1342 __u8 pic_order_cnt_type;
1343 __u8 log2_max_pic_order_cnt_lsb_minus4;
1344 __u8 max_num_ref_frames;
1345 __u8 num_ref_frames_in_pic_order_cnt_cycle;
1346 __s32 offset_for_ref_frame[255];
1347 __s32 offset_for_non_ref_pic;
1348 __s32 offset_for_top_to_bottom_field;
1349 __u16 pic_width_in_mbs_minus1;
1350 __u16 pic_height_in_map_units_minus1;
1354 #define V4L2_H264_PPS_FLAG_ENTROPY_CODING_MODE 0x0001
1355 #define V4L2_H264_PPS_FLAG_BOTTOM_FIELD_PIC_ORDER_IN_FRAME_PRESENT 0x0002
1356 #define V4L2_H264_PPS_FLAG_WEIGHTED_PRED 0x0004
1357 #define V4L2_H264_PPS_FLAG_DEBLOCKING_FILTER_CONTROL_PRESENT 0x0008
1358 #define V4L2_H264_PPS_FLAG_CONSTRAINED_INTRA_PRED 0x0010
1359 #define V4L2_H264_PPS_FLAG_REDUNDANT_PIC_CNT_PRESENT 0x0020
1360 #define V4L2_H264_PPS_FLAG_TRANSFORM_8X8_MODE 0x0040
1361 #define V4L2_H264_PPS_FLAG_SCALING_MATRIX_PRESENT 0x0080
1363 #define V4L2_CID_STATELESS_H264_PPS (V4L2_CID_CODEC_STATELESS_BASE + 3)
1365 * struct v4l2_ctrl_h264_pps - H264 picture parameter set
1367 * Except where noted, all the members on this picture parameter set
1368 * structure match the picture parameter set syntax as specified
1369 * by the H264 specification.
1371 * In particular, V4L2_H264_PPS_FLAG_SCALING_MATRIX_PRESENT flag
1372 * has a specific meaning. This flag should be set if a non-flat
1373 * scaling matrix applies to the picture. In this case, applications
1374 * are expected to use V4L2_CID_STATELESS_H264_SCALING_MATRIX,
1375 * to pass the values of the non-flat matrices.
1377 * @pic_parameter_set_id: see H264 specification.
1378 * @seq_parameter_set_id: see H264 specification.
1379 * @num_slice_groups_minus1: see H264 specification.
1380 * @num_ref_idx_l0_default_active_minus1: see H264 specification.
1381 * @num_ref_idx_l1_default_active_minus1: see H264 specification.
1382 * @weighted_bipred_idc: see H264 specification.
1383 * @pic_init_qp_minus26: see H264 specification.
1384 * @pic_init_qs_minus26: see H264 specification.
1385 * @chroma_qp_index_offset: see H264 specification.
1386 * @second_chroma_qp_index_offset: see H264 specification.
1387 * @flags: see V4L2_H264_PPS_FLAG_{}.
1389 struct v4l2_ctrl_h264_pps {
1390 __u8 pic_parameter_set_id;
1391 __u8 seq_parameter_set_id;
1392 __u8 num_slice_groups_minus1;
1393 __u8 num_ref_idx_l0_default_active_minus1;
1394 __u8 num_ref_idx_l1_default_active_minus1;
1395 __u8 weighted_bipred_idc;
1396 __s8 pic_init_qp_minus26;
1397 __s8 pic_init_qs_minus26;
1398 __s8 chroma_qp_index_offset;
1399 __s8 second_chroma_qp_index_offset;
1403 #define V4L2_CID_STATELESS_H264_SCALING_MATRIX (V4L2_CID_CODEC_STATELESS_BASE + 4)
1405 * struct v4l2_ctrl_h264_scaling_matrix - H264 scaling matrices
1407 * @scaling_list_4x4: scaling matrix after applying the inverse
1408 * scanning process. Expected list order is Intra Y, Intra Cb,
1409 * Intra Cr, Inter Y, Inter Cb, Inter Cr. The values on each
1410 * scaling list are expected in raster scan order.
1411 * @scaling_list_8x8: scaling matrix after applying the inverse
1412 * scanning process. Expected list order is Intra Y, Inter Y,
1413 * Intra Cb, Inter Cb, Intra Cr, Inter Cr. The values on each
1414 * scaling list are expected in raster scan order.
1416 * Note that the list order is different for the 4x4 and 8x8
1417 * matrices as per the H264 specification, see table 7-2 "Assignment
1418 * of mnemonic names to scaling list indices and specification of
1421 struct v4l2_ctrl_h264_scaling_matrix {
1422 __u8 scaling_list_4x4[6][16];
1423 __u8 scaling_list_8x8[6][64];
1426 struct v4l2_h264_weight_factors {
1427 __s16 luma_weight[32];
1428 __s16 luma_offset[32];
1429 __s16 chroma_weight[32][2];
1430 __s16 chroma_offset[32][2];
1433 #define V4L2_H264_CTRL_PRED_WEIGHTS_REQUIRED(pps, slice) \
1434 ((((pps)->flags & V4L2_H264_PPS_FLAG_WEIGHTED_PRED) && \
1435 ((slice)->slice_type == V4L2_H264_SLICE_TYPE_P || \
1436 (slice)->slice_type == V4L2_H264_SLICE_TYPE_SP)) || \
1437 ((pps)->weighted_bipred_idc == 1 && \
1438 (slice)->slice_type == V4L2_H264_SLICE_TYPE_B))
1440 #define V4L2_CID_STATELESS_H264_PRED_WEIGHTS (V4L2_CID_CODEC_STATELESS_BASE + 5)
1442 * struct v4l2_ctrl_h264_pred_weights - Prediction weight table
1444 * Prediction weight table, which matches the syntax specified
1445 * by the H264 specification.
1447 * @luma_log2_weight_denom: see H264 specification.
1448 * @chroma_log2_weight_denom: see H264 specification.
1449 * @weight_factors: luma and chroma weight factors.
1451 struct v4l2_ctrl_h264_pred_weights {
1452 __u16 luma_log2_weight_denom;
1453 __u16 chroma_log2_weight_denom;
1454 struct v4l2_h264_weight_factors weight_factors[2];
1457 #define V4L2_H264_SLICE_TYPE_P 0
1458 #define V4L2_H264_SLICE_TYPE_B 1
1459 #define V4L2_H264_SLICE_TYPE_I 2
1460 #define V4L2_H264_SLICE_TYPE_SP 3
1461 #define V4L2_H264_SLICE_TYPE_SI 4
1463 #define V4L2_H264_SLICE_FLAG_DIRECT_SPATIAL_MV_PRED 0x01
1464 #define V4L2_H264_SLICE_FLAG_SP_FOR_SWITCH 0x02
1466 #define V4L2_H264_TOP_FIELD_REF 0x1
1467 #define V4L2_H264_BOTTOM_FIELD_REF 0x2
1468 #define V4L2_H264_FRAME_REF 0x3
1471 * struct v4l2_h264_reference - H264 picture reference
1473 * @fields: indicates how the picture is referenced.
1474 * Valid values are V4L2_H264_{}_REF.
1475 * @index: index into v4l2_ctrl_h264_decode_params.dpb[].
1477 struct v4l2_h264_reference {
1483 * Maximum DPB size, as specified by section 'A.3.1 Level limits
1484 * common to the Baseline, Main, and Extended profiles'.
1486 #define V4L2_H264_NUM_DPB_ENTRIES 16
1487 #define V4L2_H264_REF_LIST_LEN (2 * V4L2_H264_NUM_DPB_ENTRIES)
1489 #define V4L2_CID_STATELESS_H264_SLICE_PARAMS (V4L2_CID_CODEC_STATELESS_BASE + 6)
1491 * struct v4l2_ctrl_h264_slice_params - H264 slice parameters
1493 * This structure holds the H264 syntax elements that are specified
1494 * as non-invariant for the slices in a given frame.
1496 * Slice invariant syntax elements are contained in struct
1497 * v4l2_ctrl_h264_decode_params. This is done to reduce the API surface
1498 * on frame-based decoders, where slice header parsing is done by the
1501 * Slice invariant syntax elements are specified in specification section
1502 * "7.4.3 Slice header semantics".
1504 * Except where noted, the members on this struct match the slice header syntax.
1506 * @header_bit_size: offset in bits to slice_data() from the beginning of this slice.
1507 * @first_mb_in_slice: see H264 specification.
1508 * @slice_type: see H264 specification.
1509 * @colour_plane_id: see H264 specification.
1510 * @redundant_pic_cnt: see H264 specification.
1511 * @cabac_init_idc: see H264 specification.
1512 * @slice_qp_delta: see H264 specification.
1513 * @slice_qs_delta: see H264 specification.
1514 * @disable_deblocking_filter_idc: see H264 specification.
1515 * @slice_alpha_c0_offset_div2: see H264 specification.
1516 * @slice_beta_offset_div2: see H264 specification.
1517 * @num_ref_idx_l0_active_minus1: see H264 specification.
1518 * @num_ref_idx_l1_active_minus1: see H264 specification.
1519 * @reserved: padding field. Should be zeroed by applications.
1520 * @ref_pic_list0: reference picture list 0 after applying the per-slice modifications.
1521 * @ref_pic_list1: reference picture list 1 after applying the per-slice modifications.
1522 * @flags: see V4L2_H264_SLICE_FLAG_{}.
1524 struct v4l2_ctrl_h264_slice_params {
1525 __u32 header_bit_size;
1526 __u32 first_mb_in_slice;
1528 __u8 colour_plane_id;
1529 __u8 redundant_pic_cnt;
1530 __u8 cabac_init_idc;
1531 __s8 slice_qp_delta;
1532 __s8 slice_qs_delta;
1533 __u8 disable_deblocking_filter_idc;
1534 __s8 slice_alpha_c0_offset_div2;
1535 __s8 slice_beta_offset_div2;
1536 __u8 num_ref_idx_l0_active_minus1;
1537 __u8 num_ref_idx_l1_active_minus1;
1541 struct v4l2_h264_reference ref_pic_list0[V4L2_H264_REF_LIST_LEN];
1542 struct v4l2_h264_reference ref_pic_list1[V4L2_H264_REF_LIST_LEN];
1547 #define V4L2_H264_DPB_ENTRY_FLAG_VALID 0x01
1548 #define V4L2_H264_DPB_ENTRY_FLAG_ACTIVE 0x02
1549 #define V4L2_H264_DPB_ENTRY_FLAG_LONG_TERM 0x04
1550 #define V4L2_H264_DPB_ENTRY_FLAG_FIELD 0x08
1553 * struct v4l2_h264_dpb_entry - H264 decoded picture buffer entry
1555 * @reference_ts: timestamp of the V4L2 capture buffer to use as reference.
1556 * The timestamp refers to the timestamp field in struct v4l2_buffer.
1557 * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
1558 * @pic_num: matches PicNum variable assigned during the reference
1559 * picture lists construction process.
1560 * @frame_num: frame identifier which matches frame_num syntax element.
1561 * @fields: indicates how the DPB entry is referenced. Valid values are
1563 * @reserved: padding field. Should be zeroed by applications.
1564 * @top_field_order_cnt: matches TopFieldOrderCnt picture value.
1565 * @bottom_field_order_cnt: matches BottomFieldOrderCnt picture value.
1566 * Note that picture field is indicated by v4l2_buffer.field.
1567 * @flags: see V4L2_H264_DPB_ENTRY_FLAG_{}.
1569 struct v4l2_h264_dpb_entry {
1575 __s32 top_field_order_cnt;
1576 __s32 bottom_field_order_cnt;
1580 #define V4L2_H264_DECODE_PARAM_FLAG_IDR_PIC 0x01
1581 #define V4L2_H264_DECODE_PARAM_FLAG_FIELD_PIC 0x02
1582 #define V4L2_H264_DECODE_PARAM_FLAG_BOTTOM_FIELD 0x04
1583 #define V4L2_H264_DECODE_PARAM_FLAG_PFRAME 0x08
1584 #define V4L2_H264_DECODE_PARAM_FLAG_BFRAME 0x10
1586 #define V4L2_CID_STATELESS_H264_DECODE_PARAMS (V4L2_CID_CODEC_STATELESS_BASE + 7)
1588 * struct v4l2_ctrl_h264_decode_params - H264 decoding parameters
1590 * @dpb: decoded picture buffer.
1591 * @nal_ref_idc: slice header syntax element.
1592 * @frame_num: slice header syntax element.
1593 * @top_field_order_cnt: matches TopFieldOrderCnt picture value.
1594 * @bottom_field_order_cnt: matches BottomFieldOrderCnt picture value.
1595 * Note that picture field is indicated by v4l2_buffer.field.
1596 * @idr_pic_id: slice header syntax element.
1597 * @pic_order_cnt_lsb: slice header syntax element.
1598 * @delta_pic_order_cnt_bottom: slice header syntax element.
1599 * @delta_pic_order_cnt0: slice header syntax element.
1600 * @delta_pic_order_cnt1: slice header syntax element.
1601 * @dec_ref_pic_marking_bit_size: size in bits of dec_ref_pic_marking()
1603 * @pic_order_cnt_bit_size: size in bits of pic order count syntax.
1604 * @slice_group_change_cycle: slice header syntax element.
1605 * @reserved: padding field. Should be zeroed by applications.
1606 * @flags: see V4L2_H264_DECODE_PARAM_FLAG_{}.
1608 struct v4l2_ctrl_h264_decode_params {
1609 struct v4l2_h264_dpb_entry dpb[V4L2_H264_NUM_DPB_ENTRIES];
1612 __s32 top_field_order_cnt;
1613 __s32 bottom_field_order_cnt;
1615 __u16 pic_order_cnt_lsb;
1616 __s32 delta_pic_order_cnt_bottom;
1617 __s32 delta_pic_order_cnt0;
1618 __s32 delta_pic_order_cnt1;
1619 __u32 dec_ref_pic_marking_bit_size;
1620 __u32 pic_order_cnt_bit_size;
1621 __u32 slice_group_change_cycle;
1628 /* Stateless FWHT control, used by the vicodec driver */
1630 /* Current FWHT version */
1631 #define V4L2_FWHT_VERSION 3
1633 /* Set if this is an interlaced format */
1634 #define V4L2_FWHT_FL_IS_INTERLACED _BITUL(0)
1635 /* Set if this is a bottom-first (NTSC) interlaced format */
1636 #define V4L2_FWHT_FL_IS_BOTTOM_FIRST _BITUL(1)
1637 /* Set if each 'frame' contains just one field */
1638 #define V4L2_FWHT_FL_IS_ALTERNATE _BITUL(2)
1640 * If V4L2_FWHT_FL_IS_ALTERNATE was set, then this is set if this
1641 * 'frame' is the bottom field, else it is the top field.
1643 #define V4L2_FWHT_FL_IS_BOTTOM_FIELD _BITUL(3)
1644 /* Set if the Y' plane is uncompressed */
1645 #define V4L2_FWHT_FL_LUMA_IS_UNCOMPRESSED _BITUL(4)
1646 /* Set if the Cb plane is uncompressed */
1647 #define V4L2_FWHT_FL_CB_IS_UNCOMPRESSED _BITUL(5)
1648 /* Set if the Cr plane is uncompressed */
1649 #define V4L2_FWHT_FL_CR_IS_UNCOMPRESSED _BITUL(6)
1650 /* Set if the chroma plane is full height, if cleared it is half height */
1651 #define V4L2_FWHT_FL_CHROMA_FULL_HEIGHT _BITUL(7)
1652 /* Set if the chroma plane is full width, if cleared it is half width */
1653 #define V4L2_FWHT_FL_CHROMA_FULL_WIDTH _BITUL(8)
1654 /* Set if the alpha plane is uncompressed */
1655 #define V4L2_FWHT_FL_ALPHA_IS_UNCOMPRESSED _BITUL(9)
1656 /* Set if this is an I Frame */
1657 #define V4L2_FWHT_FL_I_FRAME _BITUL(10)
1659 /* A 4-values flag - the number of components - 1 */
1660 #define V4L2_FWHT_FL_COMPONENTS_NUM_MSK GENMASK(18, 16)
1661 #define V4L2_FWHT_FL_COMPONENTS_NUM_OFFSET 16
1663 /* A 4-values flag - the pixel encoding type */
1664 #define V4L2_FWHT_FL_PIXENC_MSK GENMASK(20, 19)
1665 #define V4L2_FWHT_FL_PIXENC_OFFSET 19
1666 #define V4L2_FWHT_FL_PIXENC_YUV (1 << V4L2_FWHT_FL_PIXENC_OFFSET)
1667 #define V4L2_FWHT_FL_PIXENC_RGB (2 << V4L2_FWHT_FL_PIXENC_OFFSET)
1668 #define V4L2_FWHT_FL_PIXENC_HSV (3 << V4L2_FWHT_FL_PIXENC_OFFSET)
1670 #define V4L2_CID_STATELESS_FWHT_PARAMS (V4L2_CID_CODEC_STATELESS_BASE + 100)
1672 * struct v4l2_ctrl_fwht_params - FWHT parameters
1674 * @backward_ref_ts: timestamp of the V4L2 capture buffer to use as reference.
1675 * The timestamp refers to the timestamp field in struct v4l2_buffer.
1676 * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
1677 * @version: must be V4L2_FWHT_VERSION.
1678 * @width: width of frame.
1679 * @height: height of frame.
1680 * @flags: FWHT flags (see V4L2_FWHT_FL_*).
1681 * @colorspace: the colorspace (enum v4l2_colorspace).
1682 * @xfer_func: the transfer function (enum v4l2_xfer_func).
1683 * @ycbcr_enc: the Y'CbCr encoding (enum v4l2_ycbcr_encoding).
1684 * @quantization: the quantization (enum v4l2_quantization).
1686 struct v4l2_ctrl_fwht_params {
1687 __u64 backward_ref_ts;
1698 /* Stateless VP8 control */
1700 #define V4L2_VP8_SEGMENT_FLAG_ENABLED 0x01
1701 #define V4L2_VP8_SEGMENT_FLAG_UPDATE_MAP 0x02
1702 #define V4L2_VP8_SEGMENT_FLAG_UPDATE_FEATURE_DATA 0x04
1703 #define V4L2_VP8_SEGMENT_FLAG_DELTA_VALUE_MODE 0x08
1706 * struct v4l2_vp8_segment - VP8 segment-based adjustments parameters
1708 * @quant_update: update values for the segment quantizer.
1709 * @lf_update: update values for the loop filter level.
1710 * @segment_probs: branch probabilities of the segment_id decoding tree.
1711 * @padding: padding field. Should be zeroed by applications.
1712 * @flags: see V4L2_VP8_SEGMENT_FLAG_{}.
1714 * This structure contains segment-based adjustments related parameters.
1715 * See the 'update_segmentation()' part of the frame header syntax,
1716 * and section '9.3. Segment-Based Adjustments' of the VP8 specification
1719 struct v4l2_vp8_segment {
1720 __s8 quant_update[4];
1722 __u8 segment_probs[3];
1727 #define V4L2_VP8_LF_ADJ_ENABLE 0x01
1728 #define V4L2_VP8_LF_DELTA_UPDATE 0x02
1729 #define V4L2_VP8_LF_FILTER_TYPE_SIMPLE 0x04
1732 * struct v4l2_vp8_loop_filter - VP8 loop filter parameters
1734 * @ref_frm_delta: Reference frame signed delta values.
1735 * @mb_mode_delta: MB prediction mode signed delta values.
1736 * @sharpness_level: matches sharpness_level syntax element.
1737 * @level: matches loop_filter_level syntax element.
1738 * @padding: padding field. Should be zeroed by applications.
1739 * @flags: see V4L2_VP8_LF_{}.
1741 * This structure contains loop filter related parameters.
1742 * See the 'mb_lf_adjustments()' part of the frame header syntax,
1743 * and section '9.4. Loop Filter Type and Levels' of the VP8 specification
1746 struct v4l2_vp8_loop_filter {
1747 __s8 ref_frm_delta[4];
1748 __s8 mb_mode_delta[4];
1749 __u8 sharpness_level;
1756 * struct v4l2_vp8_quantization - VP8 quantizattion indices
1758 * @y_ac_qi: luma AC coefficient table index.
1759 * @y_dc_delta: luma DC delta vaue.
1760 * @y2_dc_delta: y2 block DC delta value.
1761 * @y2_ac_delta: y2 block AC delta value.
1762 * @uv_dc_delta: chroma DC delta value.
1763 * @uv_ac_delta: chroma AC delta value.
1764 * @padding: padding field. Should be zeroed by applications.
1766 * This structure contains the quantization indices present
1767 * in 'quant_indices()' part of the frame header syntax.
1768 * See section '9.6. Dequantization Indices' of the VP8 specification
1771 struct v4l2_vp8_quantization {
1781 #define V4L2_VP8_COEFF_PROB_CNT 11
1782 #define V4L2_VP8_MV_PROB_CNT 19
1785 * struct v4l2_vp8_entropy - VP8 update probabilities
1787 * @coeff_probs: coefficient probability update values.
1788 * @y_mode_probs: luma intra-prediction probabilities.
1789 * @uv_mode_probs: chroma intra-prediction probabilities.
1790 * @mv_probs: mv decoding probability.
1791 * @padding: padding field. Should be zeroed by applications.
1793 * This structure contains the update probabilities present in
1794 * 'token_prob_update()' and 'mv_prob_update()' part of the frame header.
1795 * See section '17.2. Probability Updates' of the VP8 specification
1798 struct v4l2_vp8_entropy {
1799 __u8 coeff_probs[4][8][3][V4L2_VP8_COEFF_PROB_CNT];
1800 __u8 y_mode_probs[4];
1801 __u8 uv_mode_probs[3];
1802 __u8 mv_probs[2][V4L2_VP8_MV_PROB_CNT];
1807 * struct v4l2_vp8_entropy_coder_state - VP8 boolean coder state
1809 * @range: coder state value for "Range"
1810 * @value: coder state value for "Value"
1811 * @bit_count: number of bits left in range "Value".
1812 * @padding: padding field. Should be zeroed by applications.
1814 * This structure contains the state for the boolean coder, as
1815 * explained in section '7. Boolean Entropy Decoder' of the VP8 specification.
1817 struct v4l2_vp8_entropy_coder_state {
1824 #define V4L2_VP8_FRAME_FLAG_KEY_FRAME 0x01
1825 #define V4L2_VP8_FRAME_FLAG_EXPERIMENTAL 0x02
1826 #define V4L2_VP8_FRAME_FLAG_SHOW_FRAME 0x04
1827 #define V4L2_VP8_FRAME_FLAG_MB_NO_SKIP_COEFF 0x08
1828 #define V4L2_VP8_FRAME_FLAG_SIGN_BIAS_GOLDEN 0x10
1829 #define V4L2_VP8_FRAME_FLAG_SIGN_BIAS_ALT 0x20
1831 #define V4L2_VP8_FRAME_IS_KEY_FRAME(hdr) \
1832 (!!((hdr)->flags & V4L2_VP8_FRAME_FLAG_KEY_FRAME))
1834 #define V4L2_CID_STATELESS_VP8_FRAME (V4L2_CID_CODEC_STATELESS_BASE + 200)
1836 * struct v4l2_ctrl_vp8_frame - VP8 frame parameters
1838 * @segment: segmentation parameters. See &v4l2_vp8_segment for more details
1839 * @lf: loop filter parameters. See &v4l2_vp8_loop_filter for more details
1840 * @quant: quantization parameters. See &v4l2_vp8_quantization for more details
1841 * @entropy: update probabilities. See &v4l2_vp8_entropy for more details
1842 * @coder_state: boolean coder state. See &v4l2_vp8_entropy_coder_state for more details
1843 * @width: frame width.
1844 * @height: frame height.
1845 * @horizontal_scale: horizontal scaling factor.
1846 * @vertical_scale: vertical scaling factor.
1847 * @version: bitstream version.
1848 * @prob_skip_false: frame header syntax element.
1849 * @prob_intra: frame header syntax element.
1850 * @prob_last: frame header syntax element.
1851 * @prob_gf: frame header syntax element.
1852 * @num_dct_parts: number of DCT coefficients partitions.
1853 * @first_part_size: size of the first partition, i.e. the control partition.
1854 * @first_part_header_bits: size in bits of the first partition header portion.
1855 * @dct_part_sizes: DCT coefficients sizes.
1856 * @last_frame_ts: "last" reference buffer timestamp.
1857 * The timestamp refers to the timestamp field in struct v4l2_buffer.
1858 * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
1859 * @golden_frame_ts: "golden" reference buffer timestamp.
1860 * @alt_frame_ts: "alt" reference buffer timestamp.
1861 * @flags: see V4L2_VP8_FRAME_FLAG_{}.
1863 struct v4l2_ctrl_vp8_frame {
1864 struct v4l2_vp8_segment segment;
1865 struct v4l2_vp8_loop_filter lf;
1866 struct v4l2_vp8_quantization quant;
1867 struct v4l2_vp8_entropy entropy;
1868 struct v4l2_vp8_entropy_coder_state coder_state;
1873 __u8 horizontal_scale;
1874 __u8 vertical_scale;
1877 __u8 prob_skip_false;
1883 __u32 first_part_size;
1884 __u32 first_part_header_bits;
1885 __u32 dct_part_sizes[8];
1887 __u64 last_frame_ts;
1888 __u64 golden_frame_ts;
1894 /* Stateless MPEG-2 controls */
1896 #define V4L2_MPEG2_SEQ_FLAG_PROGRESSIVE 0x01
1898 #define V4L2_CID_STATELESS_MPEG2_SEQUENCE (V4L2_CID_CODEC_STATELESS_BASE+220)
1900 * struct v4l2_ctrl_mpeg2_sequence - MPEG-2 sequence header
1902 * All the members on this structure match the sequence header and sequence
1903 * extension syntaxes as specified by the MPEG-2 specification.
1905 * Fields horizontal_size, vertical_size and vbv_buffer_size are a
1906 * combination of respective _value and extension syntax elements,
1907 * as described in section 6.3.3 "Sequence header".
1909 * @horizontal_size: combination of elements horizontal_size_value and
1910 * horizontal_size_extension.
1911 * @vertical_size: combination of elements vertical_size_value and
1912 * vertical_size_extension.
1913 * @vbv_buffer_size: combination of elements vbv_buffer_size_value and
1914 * vbv_buffer_size_extension.
1915 * @profile_and_level_indication: see MPEG-2 specification.
1916 * @chroma_format: see MPEG-2 specification.
1917 * @flags: see V4L2_MPEG2_SEQ_FLAG_{}.
1919 struct v4l2_ctrl_mpeg2_sequence {
1920 __u16 horizontal_size;
1921 __u16 vertical_size;
1922 __u32 vbv_buffer_size;
1923 __u16 profile_and_level_indication;
1928 #define V4L2_MPEG2_PIC_CODING_TYPE_I 1
1929 #define V4L2_MPEG2_PIC_CODING_TYPE_P 2
1930 #define V4L2_MPEG2_PIC_CODING_TYPE_B 3
1931 #define V4L2_MPEG2_PIC_CODING_TYPE_D 4
1933 #define V4L2_MPEG2_PIC_TOP_FIELD 0x1
1934 #define V4L2_MPEG2_PIC_BOTTOM_FIELD 0x2
1935 #define V4L2_MPEG2_PIC_FRAME 0x3
1937 #define V4L2_MPEG2_PIC_FLAG_TOP_FIELD_FIRST 0x0001
1938 #define V4L2_MPEG2_PIC_FLAG_FRAME_PRED_DCT 0x0002
1939 #define V4L2_MPEG2_PIC_FLAG_CONCEALMENT_MV 0x0004
1940 #define V4L2_MPEG2_PIC_FLAG_Q_SCALE_TYPE 0x0008
1941 #define V4L2_MPEG2_PIC_FLAG_INTRA_VLC 0x0010
1942 #define V4L2_MPEG2_PIC_FLAG_ALT_SCAN 0x0020
1943 #define V4L2_MPEG2_PIC_FLAG_REPEAT_FIRST 0x0040
1944 #define V4L2_MPEG2_PIC_FLAG_PROGRESSIVE 0x0080
1946 #define V4L2_CID_STATELESS_MPEG2_PICTURE (V4L2_CID_CODEC_STATELESS_BASE+221)
1948 * struct v4l2_ctrl_mpeg2_picture - MPEG-2 picture header
1950 * All the members on this structure match the picture header and picture
1951 * coding extension syntaxes as specified by the MPEG-2 specification.
1953 * @backward_ref_ts: timestamp of the V4L2 capture buffer to use as
1954 * reference for backward prediction.
1955 * @forward_ref_ts: timestamp of the V4L2 capture buffer to use as
1956 * reference for forward prediction. These timestamp refers to the
1957 * timestamp field in struct v4l2_buffer. Use v4l2_timeval_to_ns()
1958 * to convert the struct timeval to a __u64.
1959 * @flags: see V4L2_MPEG2_PIC_FLAG_{}.
1960 * @f_code: see MPEG-2 specification.
1961 * @picture_coding_type: see MPEG-2 specification.
1962 * @picture_structure: see V4L2_MPEG2_PIC_{}_FIELD.
1963 * @intra_dc_precision: see MPEG-2 specification.
1964 * @reserved: padding field. Should be zeroed by applications.
1966 struct v4l2_ctrl_mpeg2_picture {
1967 __u64 backward_ref_ts;
1968 __u64 forward_ref_ts;
1971 __u8 picture_coding_type;
1972 __u8 picture_structure;
1973 __u8 intra_dc_precision;
1977 #define V4L2_CID_STATELESS_MPEG2_QUANTISATION (V4L2_CID_CODEC_STATELESS_BASE+222)
1979 * struct v4l2_ctrl_mpeg2_quantisation - MPEG-2 quantisation
1981 * Quantisation matrices as specified by section 6.3.7
1982 * "Quant matrix extension".
1984 * @intra_quantiser_matrix: The quantisation matrix coefficients
1985 * for intra-coded frames, in zigzag scanning order. It is relevant
1986 * for both luma and chroma components, although it can be superseded
1987 * by the chroma-specific matrix for non-4:2:0 YUV formats.
1988 * @non_intra_quantiser_matrix: The quantisation matrix coefficients
1989 * for non-intra-coded frames, in zigzag scanning order. It is relevant
1990 * for both luma and chroma components, although it can be superseded
1991 * by the chroma-specific matrix for non-4:2:0 YUV formats.
1992 * @chroma_intra_quantiser_matrix: The quantisation matrix coefficients
1993 * for the chominance component of intra-coded frames, in zigzag scanning
1994 * order. Only relevant for 4:2:2 and 4:4:4 YUV formats.
1995 * @chroma_non_intra_quantiser_matrix: The quantisation matrix coefficients
1996 * for the chrominance component of non-intra-coded frames, in zigzag scanning
1997 * order. Only relevant for 4:2:2 and 4:4:4 YUV formats.
1999 struct v4l2_ctrl_mpeg2_quantisation {
2000 __u8 intra_quantiser_matrix[64];
2001 __u8 non_intra_quantiser_matrix[64];
2002 __u8 chroma_intra_quantiser_matrix[64];
2003 __u8 chroma_non_intra_quantiser_matrix[64];
2006 #define V4L2_CID_STATELESS_HEVC_SPS (V4L2_CID_CODEC_STATELESS_BASE + 400)
2007 #define V4L2_CID_STATELESS_HEVC_PPS (V4L2_CID_CODEC_STATELESS_BASE + 401)
2008 #define V4L2_CID_STATELESS_HEVC_SLICE_PARAMS (V4L2_CID_CODEC_STATELESS_BASE + 402)
2009 #define V4L2_CID_STATELESS_HEVC_SCALING_MATRIX (V4L2_CID_CODEC_STATELESS_BASE + 403)
2010 #define V4L2_CID_STATELESS_HEVC_DECODE_PARAMS (V4L2_CID_CODEC_STATELESS_BASE + 404)
2011 #define V4L2_CID_STATELESS_HEVC_DECODE_MODE (V4L2_CID_CODEC_STATELESS_BASE + 405)
2012 #define V4L2_CID_STATELESS_HEVC_START_CODE (V4L2_CID_CODEC_STATELESS_BASE + 406)
2013 #define V4L2_CID_STATELESS_HEVC_ENTRY_POINT_OFFSETS (V4L2_CID_CODEC_STATELESS_BASE + 407)
2015 enum v4l2_stateless_hevc_decode_mode {
2016 V4L2_STATELESS_HEVC_DECODE_MODE_SLICE_BASED,
2017 V4L2_STATELESS_HEVC_DECODE_MODE_FRAME_BASED,
2020 enum v4l2_stateless_hevc_start_code {
2021 V4L2_STATELESS_HEVC_START_CODE_NONE,
2022 V4L2_STATELESS_HEVC_START_CODE_ANNEX_B,
2025 #define V4L2_HEVC_SLICE_TYPE_B 0
2026 #define V4L2_HEVC_SLICE_TYPE_P 1
2027 #define V4L2_HEVC_SLICE_TYPE_I 2
2029 #define V4L2_HEVC_SPS_FLAG_SEPARATE_COLOUR_PLANE (1ULL << 0)
2030 #define V4L2_HEVC_SPS_FLAG_SCALING_LIST_ENABLED (1ULL << 1)
2031 #define V4L2_HEVC_SPS_FLAG_AMP_ENABLED (1ULL << 2)
2032 #define V4L2_HEVC_SPS_FLAG_SAMPLE_ADAPTIVE_OFFSET (1ULL << 3)
2033 #define V4L2_HEVC_SPS_FLAG_PCM_ENABLED (1ULL << 4)
2034 #define V4L2_HEVC_SPS_FLAG_PCM_LOOP_FILTER_DISABLED (1ULL << 5)
2035 #define V4L2_HEVC_SPS_FLAG_LONG_TERM_REF_PICS_PRESENT (1ULL << 6)
2036 #define V4L2_HEVC_SPS_FLAG_SPS_TEMPORAL_MVP_ENABLED (1ULL << 7)
2037 #define V4L2_HEVC_SPS_FLAG_STRONG_INTRA_SMOOTHING_ENABLED (1ULL << 8)
2040 * struct v4l2_ctrl_hevc_sps - ITU-T Rec. H.265: Sequence parameter set
2042 * @video_parameter_set_id: specifies the value of the
2043 * vps_video_parameter_set_id of the active VPS
2044 * @seq_parameter_set_id: provides an identifier for the SPS for
2045 * reference by other syntax elements
2046 * @pic_width_in_luma_samples: specifies the width of each decoded picture
2047 * in units of luma samples
2048 * @pic_height_in_luma_samples: specifies the height of each decoded picture
2049 * in units of luma samples
2050 * @bit_depth_luma_minus8: this value plus 8specifies the bit depth of the
2051 * samples of the luma array
2052 * @bit_depth_chroma_minus8: this value plus 8 specifies the bit depth of the
2053 * samples of the chroma arrays
2054 * @log2_max_pic_order_cnt_lsb_minus4: this value plus 4 specifies the value of
2055 * the variable MaxPicOrderCntLsb
2056 * @sps_max_dec_pic_buffering_minus1: this value plus 1 specifies the maximum
2057 * required size of the decoded picture
2058 * buffer for the codec video sequence
2059 * @sps_max_num_reorder_pics: indicates the maximum allowed number of pictures
2060 * @sps_max_latency_increase_plus1: not equal to 0 is used to compute the
2061 * value of SpsMaxLatencyPictures array
2062 * @log2_min_luma_coding_block_size_minus3: plus 3 specifies the minimum
2063 * luma coding block size
2064 * @log2_diff_max_min_luma_coding_block_size: specifies the difference between
2065 * the maximum and minimum luma
2067 * @log2_min_luma_transform_block_size_minus2: plus 2 specifies the minimum luma
2068 * transform block size
2069 * @log2_diff_max_min_luma_transform_block_size: specifies the difference between
2070 * the maximum and minimum luma
2071 * transform block size
2072 * @max_transform_hierarchy_depth_inter: specifies the maximum hierarchy
2073 * depth for transform units of
2074 * coding units coded in inter
2076 * @max_transform_hierarchy_depth_intra: specifies the maximum hierarchy
2077 * depth for transform units of
2078 * coding units coded in intra
2080 * @pcm_sample_bit_depth_luma_minus1: this value plus 1 specifies the number of
2081 * bits used to represent each of PCM sample
2082 * values of the luma component
2083 * @pcm_sample_bit_depth_chroma_minus1: this value plus 1 specifies the number
2084 * of bits used to represent each of PCM
2085 * sample values of the chroma components
2086 * @log2_min_pcm_luma_coding_block_size_minus3: this value plus 3 specifies the
2087 * minimum size of coding blocks
2088 * @log2_diff_max_min_pcm_luma_coding_block_size: specifies the difference between
2089 * the maximum and minimum size of
2091 * @num_short_term_ref_pic_sets: specifies the number of st_ref_pic_set()
2092 * syntax structures included in the SPS
2093 * @num_long_term_ref_pics_sps: specifies the number of candidate long-term
2094 * reference pictures that are specified in the SPS
2095 * @chroma_format_idc: specifies the chroma sampling
2096 * @sps_max_sub_layers_minus1: this value plus 1 specifies the maximum number
2097 * of temporal sub-layers
2098 * @reserved: padding field. Should be zeroed by applications.
2099 * @flags: see V4L2_HEVC_SPS_FLAG_{}
2101 struct v4l2_ctrl_hevc_sps {
2102 __u8 video_parameter_set_id;
2103 __u8 seq_parameter_set_id;
2104 __u16 pic_width_in_luma_samples;
2105 __u16 pic_height_in_luma_samples;
2106 __u8 bit_depth_luma_minus8;
2107 __u8 bit_depth_chroma_minus8;
2108 __u8 log2_max_pic_order_cnt_lsb_minus4;
2109 __u8 sps_max_dec_pic_buffering_minus1;
2110 __u8 sps_max_num_reorder_pics;
2111 __u8 sps_max_latency_increase_plus1;
2112 __u8 log2_min_luma_coding_block_size_minus3;
2113 __u8 log2_diff_max_min_luma_coding_block_size;
2114 __u8 log2_min_luma_transform_block_size_minus2;
2115 __u8 log2_diff_max_min_luma_transform_block_size;
2116 __u8 max_transform_hierarchy_depth_inter;
2117 __u8 max_transform_hierarchy_depth_intra;
2118 __u8 pcm_sample_bit_depth_luma_minus1;
2119 __u8 pcm_sample_bit_depth_chroma_minus1;
2120 __u8 log2_min_pcm_luma_coding_block_size_minus3;
2121 __u8 log2_diff_max_min_pcm_luma_coding_block_size;
2122 __u8 num_short_term_ref_pic_sets;
2123 __u8 num_long_term_ref_pics_sps;
2124 __u8 chroma_format_idc;
2125 __u8 sps_max_sub_layers_minus1;
2131 #define V4L2_HEVC_PPS_FLAG_DEPENDENT_SLICE_SEGMENT_ENABLED (1ULL << 0)
2132 #define V4L2_HEVC_PPS_FLAG_OUTPUT_FLAG_PRESENT (1ULL << 1)
2133 #define V4L2_HEVC_PPS_FLAG_SIGN_DATA_HIDING_ENABLED (1ULL << 2)
2134 #define V4L2_HEVC_PPS_FLAG_CABAC_INIT_PRESENT (1ULL << 3)
2135 #define V4L2_HEVC_PPS_FLAG_CONSTRAINED_INTRA_PRED (1ULL << 4)
2136 #define V4L2_HEVC_PPS_FLAG_TRANSFORM_SKIP_ENABLED (1ULL << 5)
2137 #define V4L2_HEVC_PPS_FLAG_CU_QP_DELTA_ENABLED (1ULL << 6)
2138 #define V4L2_HEVC_PPS_FLAG_PPS_SLICE_CHROMA_QP_OFFSETS_PRESENT (1ULL << 7)
2139 #define V4L2_HEVC_PPS_FLAG_WEIGHTED_PRED (1ULL << 8)
2140 #define V4L2_HEVC_PPS_FLAG_WEIGHTED_BIPRED (1ULL << 9)
2141 #define V4L2_HEVC_PPS_FLAG_TRANSQUANT_BYPASS_ENABLED (1ULL << 10)
2142 #define V4L2_HEVC_PPS_FLAG_TILES_ENABLED (1ULL << 11)
2143 #define V4L2_HEVC_PPS_FLAG_ENTROPY_CODING_SYNC_ENABLED (1ULL << 12)
2144 #define V4L2_HEVC_PPS_FLAG_LOOP_FILTER_ACROSS_TILES_ENABLED (1ULL << 13)
2145 #define V4L2_HEVC_PPS_FLAG_PPS_LOOP_FILTER_ACROSS_SLICES_ENABLED (1ULL << 14)
2146 #define V4L2_HEVC_PPS_FLAG_DEBLOCKING_FILTER_OVERRIDE_ENABLED (1ULL << 15)
2147 #define V4L2_HEVC_PPS_FLAG_PPS_DISABLE_DEBLOCKING_FILTER (1ULL << 16)
2148 #define V4L2_HEVC_PPS_FLAG_LISTS_MODIFICATION_PRESENT (1ULL << 17)
2149 #define V4L2_HEVC_PPS_FLAG_SLICE_SEGMENT_HEADER_EXTENSION_PRESENT (1ULL << 18)
2150 #define V4L2_HEVC_PPS_FLAG_DEBLOCKING_FILTER_CONTROL_PRESENT (1ULL << 19)
2151 #define V4L2_HEVC_PPS_FLAG_UNIFORM_SPACING (1ULL << 20)
2154 * struct v4l2_ctrl_hevc_pps - ITU-T Rec. H.265: Picture parameter set
2156 * @pic_parameter_set_id: identifies the PPS for reference by other
2158 * @num_extra_slice_header_bits: specifies the number of extra slice header
2159 * bits that are present in the slice header RBSP
2160 * for coded pictures referring to the PPS.
2161 * @num_ref_idx_l0_default_active_minus1: this value plus 1 specifies the
2162 * inferred value of num_ref_idx_l0_active_minus1
2163 * @num_ref_idx_l1_default_active_minus1: this value plus 1 specifies the
2164 * inferred value of num_ref_idx_l1_active_minus1
2165 * @init_qp_minus26: this value plus 26 specifies the initial value of SliceQp Y for
2166 * each slice referring to the PPS
2167 * @diff_cu_qp_delta_depth: specifies the difference between the luma coding
2168 * tree block size and the minimum luma coding block
2169 * size of coding units that convey cu_qp_delta_abs
2170 * and cu_qp_delta_sign_flag
2171 * @pps_cb_qp_offset: specify the offsets to the luma quantization parameter Cb
2172 * @pps_cr_qp_offset: specify the offsets to the luma quantization parameter Cr
2173 * @num_tile_columns_minus1: this value plus 1 specifies the number of tile columns
2174 * partitioning the picture
2175 * @num_tile_rows_minus1: this value plus 1 specifies the number of tile rows partitioning
2177 * @column_width_minus1: this value plus 1 specifies the width of the each tile column in
2178 * units of coding tree blocks
2179 * @row_height_minus1: this value plus 1 specifies the height of the each tile row in
2180 * units of coding tree blocks
2181 * @pps_beta_offset_div2: specify the default deblocking parameter offsets for
2183 * @pps_tc_offset_div2: specify the default deblocking parameter offsets for tC
2185 * @log2_parallel_merge_level_minus2: this value plus 2 specifies the value of
2186 * the variable Log2ParMrgLevel
2187 * @reserved: padding field. Should be zeroed by applications.
2188 * @flags: see V4L2_HEVC_PPS_FLAG_{}
2190 struct v4l2_ctrl_hevc_pps {
2191 __u8 pic_parameter_set_id;
2192 __u8 num_extra_slice_header_bits;
2193 __u8 num_ref_idx_l0_default_active_minus1;
2194 __u8 num_ref_idx_l1_default_active_minus1;
2195 __s8 init_qp_minus26;
2196 __u8 diff_cu_qp_delta_depth;
2197 __s8 pps_cb_qp_offset;
2198 __s8 pps_cr_qp_offset;
2199 __u8 num_tile_columns_minus1;
2200 __u8 num_tile_rows_minus1;
2201 __u8 column_width_minus1[20];
2202 __u8 row_height_minus1[22];
2203 __s8 pps_beta_offset_div2;
2204 __s8 pps_tc_offset_div2;
2205 __u8 log2_parallel_merge_level_minus2;
2210 #define V4L2_HEVC_DPB_ENTRY_LONG_TERM_REFERENCE 0x01
2212 #define V4L2_HEVC_SEI_PIC_STRUCT_FRAME 0
2213 #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_FIELD 1
2214 #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_FIELD 2
2215 #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_BOTTOM 3
2216 #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_TOP 4
2217 #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_BOTTOM_TOP 5
2218 #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_TOP_BOTTOM 6
2219 #define V4L2_HEVC_SEI_PIC_STRUCT_FRAME_DOUBLING 7
2220 #define V4L2_HEVC_SEI_PIC_STRUCT_FRAME_TRIPLING 8
2221 #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_PAIRED_PREVIOUS_BOTTOM 9
2222 #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_PAIRED_PREVIOUS_TOP 10
2223 #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_PAIRED_NEXT_BOTTOM 11
2224 #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_PAIRED_NEXT_TOP 12
2226 #define V4L2_HEVC_DPB_ENTRIES_NUM_MAX 16
2229 * struct v4l2_hevc_dpb_entry - HEVC decoded picture buffer entry
2231 * @timestamp: timestamp of the V4L2 capture buffer to use as reference.
2232 * @flags: long term flag for the reference frame
2233 * @field_pic: whether the reference is a field picture or a frame.
2234 * @reserved: padding field. Should be zeroed by applications.
2235 * @pic_order_cnt_val: the picture order count of the current picture.
2237 struct v4l2_hevc_dpb_entry {
2242 __s32 pic_order_cnt_val;
2246 * struct v4l2_hevc_pred_weight_table - HEVC weighted prediction parameters
2248 * @delta_luma_weight_l0: the difference of the weighting factor applied
2249 * to the luma prediction value for list 0
2250 * @luma_offset_l0: the additive offset applied to the luma prediction value
2252 * @delta_chroma_weight_l0: the difference of the weighting factor applied
2253 * to the chroma prediction values for list 0
2254 * @chroma_offset_l0: the difference of the additive offset applied to
2255 * the chroma prediction values for list 0
2256 * @delta_luma_weight_l1: the difference of the weighting factor applied
2257 * to the luma prediction value for list 1
2258 * @luma_offset_l1: the additive offset applied to the luma prediction value
2260 * @delta_chroma_weight_l1: the difference of the weighting factor applied
2261 * to the chroma prediction values for list 1
2262 * @chroma_offset_l1: the difference of the additive offset applied to
2263 * the chroma prediction values for list 1
2264 * @luma_log2_weight_denom: the base 2 logarithm of the denominator for
2265 * all luma weighting factors
2266 * @delta_chroma_log2_weight_denom: the difference of the base 2 logarithm
2267 * of the denominator for all chroma
2270 struct v4l2_hevc_pred_weight_table {
2271 __s8 delta_luma_weight_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2272 __s8 luma_offset_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2273 __s8 delta_chroma_weight_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2];
2274 __s8 chroma_offset_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2];
2276 __s8 delta_luma_weight_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2277 __s8 luma_offset_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2278 __s8 delta_chroma_weight_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2];
2279 __s8 chroma_offset_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2];
2281 __u8 luma_log2_weight_denom;
2282 __s8 delta_chroma_log2_weight_denom;
2285 #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_SAO_LUMA (1ULL << 0)
2286 #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_SAO_CHROMA (1ULL << 1)
2287 #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_TEMPORAL_MVP_ENABLED (1ULL << 2)
2288 #define V4L2_HEVC_SLICE_PARAMS_FLAG_MVD_L1_ZERO (1ULL << 3)
2289 #define V4L2_HEVC_SLICE_PARAMS_FLAG_CABAC_INIT (1ULL << 4)
2290 #define V4L2_HEVC_SLICE_PARAMS_FLAG_COLLOCATED_FROM_L0 (1ULL << 5)
2291 #define V4L2_HEVC_SLICE_PARAMS_FLAG_USE_INTEGER_MV (1ULL << 6)
2292 #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_DEBLOCKING_FILTER_DISABLED (1ULL << 7)
2293 #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_LOOP_FILTER_ACROSS_SLICES_ENABLED (1ULL << 8)
2294 #define V4L2_HEVC_SLICE_PARAMS_FLAG_DEPENDENT_SLICE_SEGMENT (1ULL << 9)
2297 * struct v4l2_ctrl_hevc_slice_params - HEVC slice parameters
2299 * This control is a dynamically sized 1-dimensional array,
2300 * V4L2_CTRL_FLAG_DYNAMIC_ARRAY flag must be set when using it.
2302 * @bit_size: size (in bits) of the current slice data
2303 * @data_byte_offset: offset (in bytes) to the video data in the current slice data
2304 * @num_entry_point_offsets: specifies the number of entry point offset syntax
2305 * elements in the slice header.
2306 * @nal_unit_type: specifies the coding type of the slice (B, P or I)
2307 * @nuh_temporal_id_plus1: minus 1 specifies a temporal identifier for the NAL unit
2308 * @slice_type: see V4L2_HEVC_SLICE_TYPE_{}
2309 * @colour_plane_id: specifies the colour plane associated with the current slice
2310 * @slice_pic_order_cnt: specifies the picture order count
2311 * @num_ref_idx_l0_active_minus1: this value plus 1 specifies the maximum
2312 * reference index for reference picture list 0
2313 * that may be used to decode the slice
2314 * @num_ref_idx_l1_active_minus1: this value plus 1 specifies the maximum
2315 * reference index for reference picture list 1
2316 * that may be used to decode the slice
2317 * @collocated_ref_idx: specifies the reference index of the collocated picture used
2318 * for temporal motion vector prediction
2319 * @five_minus_max_num_merge_cand: specifies the maximum number of merging
2320 * motion vector prediction candidates supported in
2321 * the slice subtracted from 5
2322 * @slice_qp_delta: specifies the initial value of QpY to be used for the coding
2323 * blocks in the slice
2324 * @slice_cb_qp_offset: specifies a difference to be added to the value of pps_cb_qp_offset
2325 * @slice_cr_qp_offset: specifies a difference to be added to the value of pps_cr_qp_offset
2326 * @slice_act_y_qp_offset: screen content extension parameters
2327 * @slice_act_cb_qp_offset: screen content extension parameters
2328 * @slice_act_cr_qp_offset: screen content extension parameters
2329 * @slice_beta_offset_div2: specify the deblocking parameter offsets for beta divided by 2
2330 * @slice_tc_offset_div2: specify the deblocking parameter offsets for tC divided by 2
2331 * @pic_struct: indicates whether a picture should be displayed as a frame or as one or
2333 * @reserved0: padding field. Should be zeroed by applications.
2334 * @slice_segment_addr: specifies the address of the first coding tree block in
2336 * @ref_idx_l0: the list of L0 reference elements as indices in the DPB
2337 * @ref_idx_l1: the list of L1 reference elements as indices in the DPB
2338 * @short_term_ref_pic_set_size: specifies the size of short-term reference
2339 * pictures set included in the SPS
2340 * @long_term_ref_pic_set_size: specifies the size of long-term reference
2341 * pictures set include in the SPS
2342 * @pred_weight_table: the prediction weight coefficients for inter-picture
2344 * @reserved1: padding field. Should be zeroed by applications.
2345 * @flags: see V4L2_HEVC_SLICE_PARAMS_FLAG_{}
2347 struct v4l2_ctrl_hevc_slice_params {
2349 __u32 data_byte_offset;
2350 __u32 num_entry_point_offsets;
2352 /* ISO/IEC 23008-2, ITU-T Rec. H.265: NAL unit header */
2354 __u8 nuh_temporal_id_plus1;
2356 /* ISO/IEC 23008-2, ITU-T Rec. H.265: General slice segment header */
2358 __u8 colour_plane_id;
2359 __s32 slice_pic_order_cnt;
2360 __u8 num_ref_idx_l0_active_minus1;
2361 __u8 num_ref_idx_l1_active_minus1;
2362 __u8 collocated_ref_idx;
2363 __u8 five_minus_max_num_merge_cand;
2364 __s8 slice_qp_delta;
2365 __s8 slice_cb_qp_offset;
2366 __s8 slice_cr_qp_offset;
2367 __s8 slice_act_y_qp_offset;
2368 __s8 slice_act_cb_qp_offset;
2369 __s8 slice_act_cr_qp_offset;
2370 __s8 slice_beta_offset_div2;
2371 __s8 slice_tc_offset_div2;
2373 /* ISO/IEC 23008-2, ITU-T Rec. H.265: Picture timing SEI message */
2377 /* ISO/IEC 23008-2, ITU-T Rec. H.265: General slice segment header */
2378 __u32 slice_segment_addr;
2379 __u8 ref_idx_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2380 __u8 ref_idx_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2381 __u16 short_term_ref_pic_set_size;
2382 __u16 long_term_ref_pic_set_size;
2384 /* ISO/IEC 23008-2, ITU-T Rec. H.265: Weighted prediction parameter */
2385 struct v4l2_hevc_pred_weight_table pred_weight_table;
2391 #define V4L2_HEVC_DECODE_PARAM_FLAG_IRAP_PIC 0x1
2392 #define V4L2_HEVC_DECODE_PARAM_FLAG_IDR_PIC 0x2
2393 #define V4L2_HEVC_DECODE_PARAM_FLAG_NO_OUTPUT_OF_PRIOR 0x4
2396 * struct v4l2_ctrl_hevc_decode_params - HEVC decode parameters
2398 * @pic_order_cnt_val: picture order count
2399 * @short_term_ref_pic_set_size: specifies the size of short-term reference
2400 * pictures set included in the SPS of the first slice
2401 * @long_term_ref_pic_set_size: specifies the size of long-term reference
2402 * pictures set include in the SPS of the first slice
2403 * @num_active_dpb_entries: the number of entries in dpb
2404 * @num_poc_st_curr_before: the number of reference pictures in the short-term
2405 * set that come before the current frame
2406 * @num_poc_st_curr_after: the number of reference pictures in the short-term
2407 * set that come after the current frame
2408 * @num_poc_lt_curr: the number of reference pictures in the long-term set
2409 * @poc_st_curr_before: provides the index of the short term before references
2411 * @poc_st_curr_after: provides the index of the short term after references
2413 * @poc_lt_curr: provides the index of the long term references in DPB array
2414 * @num_delta_pocs_of_ref_rps_idx: same as the derived value NumDeltaPocs[RefRpsIdx],
2415 * can be used to parse the RPS data in slice headers
2416 * instead of skipping it with @short_term_ref_pic_set_size.
2417 * @reserved: padding field. Should be zeroed by applications.
2418 * @dpb: the decoded picture buffer, for meta-data about reference frames
2419 * @flags: see V4L2_HEVC_DECODE_PARAM_FLAG_{}
2421 struct v4l2_ctrl_hevc_decode_params {
2422 __s32 pic_order_cnt_val;
2423 __u16 short_term_ref_pic_set_size;
2424 __u16 long_term_ref_pic_set_size;
2425 __u8 num_active_dpb_entries;
2426 __u8 num_poc_st_curr_before;
2427 __u8 num_poc_st_curr_after;
2428 __u8 num_poc_lt_curr;
2429 __u8 poc_st_curr_before[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2430 __u8 poc_st_curr_after[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2431 __u8 poc_lt_curr[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2432 __u8 num_delta_pocs_of_ref_rps_idx;
2434 struct v4l2_hevc_dpb_entry dpb[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2439 * struct v4l2_ctrl_hevc_scaling_matrix - HEVC scaling lists parameters
2441 * @scaling_list_4x4: scaling list is used for the scaling process for
2442 * transform coefficients. The values on each scaling
2443 * list are expected in raster scan order
2444 * @scaling_list_8x8: scaling list is used for the scaling process for
2445 * transform coefficients. The values on each scaling
2446 * list are expected in raster scan order
2447 * @scaling_list_16x16: scaling list is used for the scaling process for
2448 * transform coefficients. The values on each scaling
2449 * list are expected in raster scan order
2450 * @scaling_list_32x32: scaling list is used for the scaling process for
2451 * transform coefficients. The values on each scaling
2452 * list are expected in raster scan order
2453 * @scaling_list_dc_coef_16x16: scaling list is used for the scaling process
2454 * for transform coefficients. The values on each
2455 * scaling list are expected in raster scan order.
2456 * @scaling_list_dc_coef_32x32: scaling list is used for the scaling process
2457 * for transform coefficients. The values on each
2458 * scaling list are expected in raster scan order.
2460 struct v4l2_ctrl_hevc_scaling_matrix {
2461 __u8 scaling_list_4x4[6][16];
2462 __u8 scaling_list_8x8[6][64];
2463 __u8 scaling_list_16x16[6][64];
2464 __u8 scaling_list_32x32[2][64];
2465 __u8 scaling_list_dc_coef_16x16[6];
2466 __u8 scaling_list_dc_coef_32x32[2];
2469 #define V4L2_CID_COLORIMETRY_CLASS_BASE (V4L2_CTRL_CLASS_COLORIMETRY | 0x900)
2470 #define V4L2_CID_COLORIMETRY_CLASS (V4L2_CTRL_CLASS_COLORIMETRY | 1)
2472 #define V4L2_CID_COLORIMETRY_HDR10_CLL_INFO (V4L2_CID_COLORIMETRY_CLASS_BASE + 0)
2474 struct v4l2_ctrl_hdr10_cll_info {
2475 __u16 max_content_light_level;
2476 __u16 max_pic_average_light_level;
2479 #define V4L2_CID_COLORIMETRY_HDR10_MASTERING_DISPLAY (V4L2_CID_COLORIMETRY_CLASS_BASE + 1)
2481 #define V4L2_HDR10_MASTERING_PRIMARIES_X_LOW 5
2482 #define V4L2_HDR10_MASTERING_PRIMARIES_X_HIGH 37000
2483 #define V4L2_HDR10_MASTERING_PRIMARIES_Y_LOW 5
2484 #define V4L2_HDR10_MASTERING_PRIMARIES_Y_HIGH 42000
2485 #define V4L2_HDR10_MASTERING_WHITE_POINT_X_LOW 5
2486 #define V4L2_HDR10_MASTERING_WHITE_POINT_X_HIGH 37000
2487 #define V4L2_HDR10_MASTERING_WHITE_POINT_Y_LOW 5
2488 #define V4L2_HDR10_MASTERING_WHITE_POINT_Y_HIGH 42000
2489 #define V4L2_HDR10_MASTERING_MAX_LUMA_LOW 50000
2490 #define V4L2_HDR10_MASTERING_MAX_LUMA_HIGH 100000000
2491 #define V4L2_HDR10_MASTERING_MIN_LUMA_LOW 1
2492 #define V4L2_HDR10_MASTERING_MIN_LUMA_HIGH 50000
2494 struct v4l2_ctrl_hdr10_mastering_display {
2495 __u16 display_primaries_x[3];
2496 __u16 display_primaries_y[3];
2497 __u16 white_point_x;
2498 __u16 white_point_y;
2499 __u32 max_display_mastering_luminance;
2500 __u32 min_display_mastering_luminance;
2503 /* Stateless VP9 controls */
2505 #define V4L2_VP9_LOOP_FILTER_FLAG_DELTA_ENABLED 0x1
2506 #define V4L2_VP9_LOOP_FILTER_FLAG_DELTA_UPDATE 0x2
2509 * struct v4l2_vp9_loop_filter - VP9 loop filter parameters
2511 * @ref_deltas: contains the adjustment needed for the filter level based on the
2512 * chosen reference frame. If this syntax element is not present in the bitstream,
2513 * users should pass its last value.
2514 * @mode_deltas: contains the adjustment needed for the filter level based on the
2515 * chosen mode. If this syntax element is not present in the bitstream, users should
2516 * pass its last value.
2517 * @level: indicates the loop filter strength.
2518 * @sharpness: indicates the sharpness level.
2519 * @flags: combination of V4L2_VP9_LOOP_FILTER_FLAG_{} flags.
2520 * @reserved: padding field. Should be zeroed by applications.
2522 * This structure contains all loop filter related parameters. See sections
2523 * '7.2.8 Loop filter semantics' of the VP9 specification for more details.
2525 struct v4l2_vp9_loop_filter {
2527 __s8 mode_deltas[2];
2535 * struct v4l2_vp9_quantization - VP9 quantization parameters
2537 * @base_q_idx: indicates the base frame qindex.
2538 * @delta_q_y_dc: indicates the Y DC quantizer relative to base_q_idx.
2539 * @delta_q_uv_dc: indicates the UV DC quantizer relative to base_q_idx.
2540 * @delta_q_uv_ac: indicates the UV AC quantizer relative to base_q_idx.
2541 * @reserved: padding field. Should be zeroed by applications.
2543 * Encodes the quantization parameters. See section '7.2.9 Quantization params
2544 * syntax' of the VP9 specification for more details.
2546 struct v4l2_vp9_quantization {
2554 #define V4L2_VP9_SEGMENTATION_FLAG_ENABLED 0x01
2555 #define V4L2_VP9_SEGMENTATION_FLAG_UPDATE_MAP 0x02
2556 #define V4L2_VP9_SEGMENTATION_FLAG_TEMPORAL_UPDATE 0x04
2557 #define V4L2_VP9_SEGMENTATION_FLAG_UPDATE_DATA 0x08
2558 #define V4L2_VP9_SEGMENTATION_FLAG_ABS_OR_DELTA_UPDATE 0x10
2560 #define V4L2_VP9_SEG_LVL_ALT_Q 0
2561 #define V4L2_VP9_SEG_LVL_ALT_L 1
2562 #define V4L2_VP9_SEG_LVL_REF_FRAME 2
2563 #define V4L2_VP9_SEG_LVL_SKIP 3
2564 #define V4L2_VP9_SEG_LVL_MAX 4
2566 #define V4L2_VP9_SEGMENT_FEATURE_ENABLED(id) (1 << (id))
2567 #define V4L2_VP9_SEGMENT_FEATURE_ENABLED_MASK 0xf
2570 * struct v4l2_vp9_segmentation - VP9 segmentation parameters
2572 * @feature_data: data attached to each feature. Data entry is only valid if
2573 * the feature is enabled. The array shall be indexed with segment number as
2574 * the first dimension (0..7) and one of V4L2_VP9_SEG_{} as the second dimension.
2575 * @feature_enabled: bitmask defining which features are enabled in each segment.
2576 * The value for each segment is a combination of V4L2_VP9_SEGMENT_FEATURE_ENABLED(id)
2577 * values where id is one of V4L2_VP9_SEG_LVL_{}.
2578 * @tree_probs: specifies the probability values to be used when decoding a
2579 * Segment-ID. See '5.15. Segmentation map' section of the VP9 specification
2581 * @pred_probs: specifies the probability values to be used when decoding a
2582 * Predicted-Segment-ID. See '6.4.14. Get segment id syntax' section of :ref:`vp9`
2584 * @flags: combination of V4L2_VP9_SEGMENTATION_FLAG_{} flags.
2585 * @reserved: padding field. Should be zeroed by applications.
2587 * Encodes the quantization parameters. See section '7.2.10 Segmentation params syntax' of
2588 * the VP9 specification for more details.
2590 struct v4l2_vp9_segmentation {
2591 __s16 feature_data[8][4];
2592 __u8 feature_enabled[8];
2599 #define V4L2_VP9_FRAME_FLAG_KEY_FRAME 0x001
2600 #define V4L2_VP9_FRAME_FLAG_SHOW_FRAME 0x002
2601 #define V4L2_VP9_FRAME_FLAG_ERROR_RESILIENT 0x004
2602 #define V4L2_VP9_FRAME_FLAG_INTRA_ONLY 0x008
2603 #define V4L2_VP9_FRAME_FLAG_ALLOW_HIGH_PREC_MV 0x010
2604 #define V4L2_VP9_FRAME_FLAG_REFRESH_FRAME_CTX 0x020
2605 #define V4L2_VP9_FRAME_FLAG_PARALLEL_DEC_MODE 0x040
2606 #define V4L2_VP9_FRAME_FLAG_X_SUBSAMPLING 0x080
2607 #define V4L2_VP9_FRAME_FLAG_Y_SUBSAMPLING 0x100
2608 #define V4L2_VP9_FRAME_FLAG_COLOR_RANGE_FULL_SWING 0x200
2610 #define V4L2_VP9_SIGN_BIAS_LAST 0x1
2611 #define V4L2_VP9_SIGN_BIAS_GOLDEN 0x2
2612 #define V4L2_VP9_SIGN_BIAS_ALT 0x4
2614 #define V4L2_VP9_RESET_FRAME_CTX_NONE 0
2615 #define V4L2_VP9_RESET_FRAME_CTX_SPEC 1
2616 #define V4L2_VP9_RESET_FRAME_CTX_ALL 2
2618 #define V4L2_VP9_INTERP_FILTER_EIGHTTAP 0
2619 #define V4L2_VP9_INTERP_FILTER_EIGHTTAP_SMOOTH 1
2620 #define V4L2_VP9_INTERP_FILTER_EIGHTTAP_SHARP 2
2621 #define V4L2_VP9_INTERP_FILTER_BILINEAR 3
2622 #define V4L2_VP9_INTERP_FILTER_SWITCHABLE 4
2624 #define V4L2_VP9_REFERENCE_MODE_SINGLE_REFERENCE 0
2625 #define V4L2_VP9_REFERENCE_MODE_COMPOUND_REFERENCE 1
2626 #define V4L2_VP9_REFERENCE_MODE_SELECT 2
2628 #define V4L2_VP9_PROFILE_MAX 3
2630 #define V4L2_CID_STATELESS_VP9_FRAME (V4L2_CID_CODEC_STATELESS_BASE + 300)
2632 * struct v4l2_ctrl_vp9_frame - VP9 frame decoding control
2634 * @lf: loop filter parameters. See &v4l2_vp9_loop_filter for more details.
2635 * @quant: quantization parameters. See &v4l2_vp9_quantization for more details.
2636 * @seg: segmentation parameters. See &v4l2_vp9_segmentation for more details.
2637 * @flags: combination of V4L2_VP9_FRAME_FLAG_{} flags.
2638 * @compressed_header_size: compressed header size in bytes.
2639 * @uncompressed_header_size: uncompressed header size in bytes.
2640 * @frame_width_minus_1: add 1 to it and you'll get the frame width expressed in pixels.
2641 * @frame_height_minus_1: add 1 to it and you'll get the frame height expressed in pixels.
2642 * @render_width_minus_1: add 1 to it and you'll get the expected render width expressed in
2643 * pixels. This is not used during the decoding process but might be used by HW scalers
2644 * to prepare a frame that's ready for scanout.
2645 * @render_height_minus_1: add 1 to it and you'll get the expected render height expressed in
2646 * pixels. This is not used during the decoding process but might be used by HW scalers
2647 * to prepare a frame that's ready for scanout.
2648 * @last_frame_ts: "last" reference buffer timestamp.
2649 * The timestamp refers to the timestamp field in struct v4l2_buffer.
2650 * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
2651 * @golden_frame_ts: "golden" reference buffer timestamp.
2652 * The timestamp refers to the timestamp field in struct v4l2_buffer.
2653 * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
2654 * @alt_frame_ts: "alt" reference buffer timestamp.
2655 * The timestamp refers to the timestamp field in struct v4l2_buffer.
2656 * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
2657 * @ref_frame_sign_bias: a bitfield specifying whether the sign bias is set for a given
2658 * reference frame. Either of V4L2_VP9_SIGN_BIAS_{}.
2659 * @reset_frame_context: specifies whether the frame context should be reset to default values.
2660 * Either of V4L2_VP9_RESET_FRAME_CTX_{}.
2661 * @frame_context_idx: frame context that should be used/updated.
2662 * @profile: VP9 profile. Can be 0, 1, 2 or 3.
2663 * @bit_depth: bits per components. Can be 8, 10 or 12. Note that not all profiles support
2664 * 10 and/or 12 bits depths.
2665 * @interpolation_filter: specifies the filter selection used for performing inter prediction.
2666 * Set to one of V4L2_VP9_INTERP_FILTER_{}.
2667 * @tile_cols_log2: specifies the base 2 logarithm of the width of each tile (where the width
2668 * is measured in units of 8x8 blocks). Shall be less than or equal to 6.
2669 * @tile_rows_log2: specifies the base 2 logarithm of the height of each tile (where the height
2670 * is measured in units of 8x8 blocks).
2671 * @reference_mode: specifies the type of inter prediction to be used.
2672 * Set to one of V4L2_VP9_REFERENCE_MODE_{}.
2673 * @reserved: padding field. Should be zeroed by applications.
2675 struct v4l2_ctrl_vp9_frame {
2676 struct v4l2_vp9_loop_filter lf;
2677 struct v4l2_vp9_quantization quant;
2678 struct v4l2_vp9_segmentation seg;
2680 __u16 compressed_header_size;
2681 __u16 uncompressed_header_size;
2682 __u16 frame_width_minus_1;
2683 __u16 frame_height_minus_1;
2684 __u16 render_width_minus_1;
2685 __u16 render_height_minus_1;
2686 __u64 last_frame_ts;
2687 __u64 golden_frame_ts;
2689 __u8 ref_frame_sign_bias;
2690 __u8 reset_frame_context;
2691 __u8 frame_context_idx;
2694 __u8 interpolation_filter;
2695 __u8 tile_cols_log2;
2696 __u8 tile_rows_log2;
2697 __u8 reference_mode;
2701 #define V4L2_VP9_NUM_FRAME_CTX 4
2704 * struct v4l2_vp9_mv_probs - VP9 Motion vector probability updates
2705 * @joint: motion vector joint probability updates.
2706 * @sign: motion vector sign probability updates.
2707 * @classes: motion vector class probability updates.
2708 * @class0_bit: motion vector class0 bit probability updates.
2709 * @bits: motion vector bits probability updates.
2710 * @class0_fr: motion vector class0 fractional bit probability updates.
2711 * @fr: motion vector fractional bit probability updates.
2712 * @class0_hp: motion vector class0 high precision fractional bit probability updates.
2713 * @hp: motion vector high precision fractional bit probability updates.
2715 * This structure contains new values of motion vector probabilities.
2716 * A value of zero in an array element means there is no update of the relevant probability.
2717 * See `struct v4l2_vp9_prob_updates` for details.
2719 struct v4l2_vp9_mv_probs {
2722 __u8 classes[2][10];
2725 __u8 class0_fr[2][2][3];
2731 #define V4L2_CID_STATELESS_VP9_COMPRESSED_HDR (V4L2_CID_CODEC_STATELESS_BASE + 301)
2733 #define V4L2_VP9_TX_MODE_ONLY_4X4 0
2734 #define V4L2_VP9_TX_MODE_ALLOW_8X8 1
2735 #define V4L2_VP9_TX_MODE_ALLOW_16X16 2
2736 #define V4L2_VP9_TX_MODE_ALLOW_32X32 3
2737 #define V4L2_VP9_TX_MODE_SELECT 4
2740 * struct v4l2_ctrl_vp9_compressed_hdr - VP9 probability updates control
2741 * @tx_mode: specifies the TX mode. Set to one of V4L2_VP9_TX_MODE_{}.
2742 * @tx8: TX 8x8 probability updates.
2743 * @tx16: TX 16x16 probability updates.
2744 * @tx32: TX 32x32 probability updates.
2745 * @coef: coefficient probability updates.
2746 * @skip: skip probability updates.
2747 * @inter_mode: inter mode probability updates.
2748 * @interp_filter: interpolation filter probability updates.
2749 * @is_inter: is inter-block probability updates.
2750 * @comp_mode: compound prediction mode probability updates.
2751 * @single_ref: single ref probability updates.
2752 * @comp_ref: compound ref probability updates.
2753 * @y_mode: Y prediction mode probability updates.
2754 * @uv_mode: UV prediction mode probability updates.
2755 * @partition: partition probability updates.
2756 * @mv: motion vector probability updates.
2758 * This structure holds the probabilities update as parsed in the compressed
2759 * header (Spec 6.3). These values represent the value of probability update after
2760 * being translated with inv_map_table[] (see 6.3.5). A value of zero in an array element
2761 * means that there is no update of the relevant probability.
2763 * This control is optional and needs to be used when dealing with the hardware which is
2764 * not capable of parsing the compressed header itself. Only drivers which need it will
2767 struct v4l2_ctrl_vp9_compressed_hdr {
2772 __u8 coef[4][2][2][6][6][3];
2774 __u8 inter_mode[7][3];
2775 __u8 interp_filter[4][2];
2778 __u8 single_ref[5][2];
2781 __u8 uv_mode[10][9];
2782 __u8 partition[16][3];
2784 struct v4l2_vp9_mv_probs mv;
2787 /* MPEG-compression definitions kept for backwards compatibility */
2789 #define V4L2_CTRL_CLASS_MPEG V4L2_CTRL_CLASS_CODEC
2790 #define V4L2_CID_MPEG_CLASS V4L2_CID_CODEC_CLASS
2791 #define V4L2_CID_MPEG_BASE V4L2_CID_CODEC_BASE
2792 #define V4L2_CID_MPEG_CX2341X_BASE V4L2_CID_CODEC_CX2341X_BASE
2793 #define V4L2_CID_MPEG_MFC51_BASE V4L2_CID_CODEC_MFC51_BASE