xref: /linux/include/uapi/linux/v4l2-controls.h (revision c17ee635fd3a482b2ad2bf5e269755c2eae5f25e)
1 /* SPDX-License-Identifier: ((GPL-2.0+ WITH Linux-syscall-note) OR BSD-3-Clause) */
2 /*
3  *  Video for Linux Two controls header file
4  *
5  *  Copyright (C) 1999-2012 the contributors
6  *
7  *  The contents of this header was split off from videodev2.h. All control
8  *  definitions should be added to this header, which is included by
9  *  videodev2.h.
10  */
11 
12 #ifndef __LINUX_V4L2_CONTROLS_H
13 #define __LINUX_V4L2_CONTROLS_H
14 
15 #include <linux/const.h>
16 #include <linux/types.h>
17 
18 /* Control classes */
19 #define V4L2_CTRL_CLASS_USER		0x00980000	/* Old-style 'user' controls */
20 #define V4L2_CTRL_CLASS_CODEC		0x00990000	/* Stateful codec controls */
21 #define V4L2_CTRL_CLASS_CAMERA		0x009a0000	/* Camera class controls */
22 #define V4L2_CTRL_CLASS_FM_TX		0x009b0000	/* FM Modulator controls */
23 #define V4L2_CTRL_CLASS_FLASH		0x009c0000	/* Camera flash controls */
24 #define V4L2_CTRL_CLASS_JPEG		0x009d0000	/* JPEG-compression controls */
25 #define V4L2_CTRL_CLASS_IMAGE_SOURCE	0x009e0000	/* Image source controls */
26 #define V4L2_CTRL_CLASS_IMAGE_PROC	0x009f0000	/* Image processing controls */
27 #define V4L2_CTRL_CLASS_DV		0x00a00000	/* Digital Video controls */
28 #define V4L2_CTRL_CLASS_FM_RX		0x00a10000	/* FM Receiver controls */
29 #define V4L2_CTRL_CLASS_RF_TUNER	0x00a20000	/* RF tuner controls */
30 #define V4L2_CTRL_CLASS_DETECT		0x00a30000	/* Detection controls */
31 #define V4L2_CTRL_CLASS_CODEC_STATELESS 0x00a40000	/* Stateless codecs controls */
32 #define V4L2_CTRL_CLASS_COLORIMETRY	0x00a50000	/* Colorimetry controls */
33 
34 /* User-class control IDs */
35 
36 #define V4L2_CID_BASE			(V4L2_CTRL_CLASS_USER | 0x900)
37 #define V4L2_CID_USER_BASE		V4L2_CID_BASE
38 #define V4L2_CID_USER_CLASS		(V4L2_CTRL_CLASS_USER | 1)
39 #define V4L2_CID_BRIGHTNESS		(V4L2_CID_BASE+0)
40 #define V4L2_CID_CONTRAST		(V4L2_CID_BASE+1)
41 #define V4L2_CID_SATURATION		(V4L2_CID_BASE+2)
42 #define V4L2_CID_HUE			(V4L2_CID_BASE+3)
43 #define V4L2_CID_AUDIO_VOLUME		(V4L2_CID_BASE+5)
44 #define V4L2_CID_AUDIO_BALANCE		(V4L2_CID_BASE+6)
45 #define V4L2_CID_AUDIO_BASS		(V4L2_CID_BASE+7)
46 #define V4L2_CID_AUDIO_TREBLE		(V4L2_CID_BASE+8)
47 #define V4L2_CID_AUDIO_MUTE		(V4L2_CID_BASE+9)
48 #define V4L2_CID_AUDIO_LOUDNESS		(V4L2_CID_BASE+10)
49 #define V4L2_CID_BLACK_LEVEL		(V4L2_CID_BASE+11) /* Deprecated */
50 #define V4L2_CID_AUTO_WHITE_BALANCE	(V4L2_CID_BASE+12)
51 #define V4L2_CID_DO_WHITE_BALANCE	(V4L2_CID_BASE+13)
52 #define V4L2_CID_RED_BALANCE		(V4L2_CID_BASE+14)
53 #define V4L2_CID_BLUE_BALANCE		(V4L2_CID_BASE+15)
54 #define V4L2_CID_GAMMA			(V4L2_CID_BASE+16)
55 #define V4L2_CID_WHITENESS		(V4L2_CID_GAMMA) /* Deprecated */
56 #define V4L2_CID_EXPOSURE		(V4L2_CID_BASE+17)
57 #define V4L2_CID_AUTOGAIN		(V4L2_CID_BASE+18)
58 #define V4L2_CID_GAIN			(V4L2_CID_BASE+19)
59 #define V4L2_CID_HFLIP			(V4L2_CID_BASE+20)
60 #define V4L2_CID_VFLIP			(V4L2_CID_BASE+21)
61 
62 #define V4L2_CID_POWER_LINE_FREQUENCY	(V4L2_CID_BASE+24)
63 enum v4l2_power_line_frequency {
64 	V4L2_CID_POWER_LINE_FREQUENCY_DISABLED	= 0,
65 	V4L2_CID_POWER_LINE_FREQUENCY_50HZ	= 1,
66 	V4L2_CID_POWER_LINE_FREQUENCY_60HZ	= 2,
67 	V4L2_CID_POWER_LINE_FREQUENCY_AUTO	= 3,
68 };
69 #define V4L2_CID_HUE_AUTO			(V4L2_CID_BASE+25)
70 #define V4L2_CID_WHITE_BALANCE_TEMPERATURE	(V4L2_CID_BASE+26)
71 #define V4L2_CID_SHARPNESS			(V4L2_CID_BASE+27)
72 #define V4L2_CID_BACKLIGHT_COMPENSATION		(V4L2_CID_BASE+28)
73 #define V4L2_CID_CHROMA_AGC                     (V4L2_CID_BASE+29)
74 #define V4L2_CID_COLOR_KILLER                   (V4L2_CID_BASE+30)
75 #define V4L2_CID_COLORFX			(V4L2_CID_BASE+31)
76 enum v4l2_colorfx {
77 	V4L2_COLORFX_NONE			= 0,
78 	V4L2_COLORFX_BW				= 1,
79 	V4L2_COLORFX_SEPIA			= 2,
80 	V4L2_COLORFX_NEGATIVE			= 3,
81 	V4L2_COLORFX_EMBOSS			= 4,
82 	V4L2_COLORFX_SKETCH			= 5,
83 	V4L2_COLORFX_SKY_BLUE			= 6,
84 	V4L2_COLORFX_GRASS_GREEN		= 7,
85 	V4L2_COLORFX_SKIN_WHITEN		= 8,
86 	V4L2_COLORFX_VIVID			= 9,
87 	V4L2_COLORFX_AQUA			= 10,
88 	V4L2_COLORFX_ART_FREEZE			= 11,
89 	V4L2_COLORFX_SILHOUETTE			= 12,
90 	V4L2_COLORFX_SOLARIZATION		= 13,
91 	V4L2_COLORFX_ANTIQUE			= 14,
92 	V4L2_COLORFX_SET_CBCR			= 15,
93 	V4L2_COLORFX_SET_RGB			= 16,
94 };
95 #define V4L2_CID_AUTOBRIGHTNESS			(V4L2_CID_BASE+32)
96 #define V4L2_CID_BAND_STOP_FILTER		(V4L2_CID_BASE+33)
97 
98 #define V4L2_CID_ROTATE				(V4L2_CID_BASE+34)
99 #define V4L2_CID_BG_COLOR			(V4L2_CID_BASE+35)
100 
101 #define V4L2_CID_CHROMA_GAIN                    (V4L2_CID_BASE+36)
102 
103 #define V4L2_CID_ILLUMINATORS_1			(V4L2_CID_BASE+37)
104 #define V4L2_CID_ILLUMINATORS_2			(V4L2_CID_BASE+38)
105 
106 #define V4L2_CID_MIN_BUFFERS_FOR_CAPTURE	(V4L2_CID_BASE+39)
107 #define V4L2_CID_MIN_BUFFERS_FOR_OUTPUT		(V4L2_CID_BASE+40)
108 
109 #define V4L2_CID_ALPHA_COMPONENT		(V4L2_CID_BASE+41)
110 #define V4L2_CID_COLORFX_CBCR			(V4L2_CID_BASE+42)
111 #define V4L2_CID_COLORFX_RGB			(V4L2_CID_BASE+43)
112 
113 /* last CID + 1 */
114 #define V4L2_CID_LASTP1                         (V4L2_CID_BASE+44)
115 
116 /* USER-class private control IDs */
117 
118 #ifndef __KERNEL__
119 /*
120  * The base for the meye driver controls. This driver was removed, but
121  * we keep this define in case any software still uses it.
122  */
123 #define V4L2_CID_USER_MEYE_BASE			(V4L2_CID_USER_BASE + 0x1000)
124 #endif
125 
126 /* The base for the bttv driver controls.
127  * We reserve 32 controls for this driver. */
128 #define V4L2_CID_USER_BTTV_BASE			(V4L2_CID_USER_BASE + 0x1010)
129 
130 
131 /* The base for the s2255 driver controls.
132  * We reserve 16 controls for this driver. */
133 #define V4L2_CID_USER_S2255_BASE		(V4L2_CID_USER_BASE + 0x1030)
134 
135 /*
136  * The base for the si476x driver controls. See include/media/drv-intf/si476x.h
137  * for the list of controls. Total of 16 controls is reserved for this driver
138  */
139 #define V4L2_CID_USER_SI476X_BASE		(V4L2_CID_USER_BASE + 0x1040)
140 
141 /* The base for the TI VPE driver controls. Total of 16 controls is reserved for
142  * this driver */
143 #define V4L2_CID_USER_TI_VPE_BASE		(V4L2_CID_USER_BASE + 0x1050)
144 
145 /* The base for the saa7134 driver controls.
146  * We reserve 16 controls for this driver. */
147 #define V4L2_CID_USER_SAA7134_BASE		(V4L2_CID_USER_BASE + 0x1060)
148 
149 /* The base for the adv7180 driver controls.
150  * We reserve 16 controls for this driver. */
151 #define V4L2_CID_USER_ADV7180_BASE		(V4L2_CID_USER_BASE + 0x1070)
152 
153 /* The base for the tc358743 driver controls.
154  * We reserve 16 controls for this driver. */
155 #define V4L2_CID_USER_TC358743_BASE		(V4L2_CID_USER_BASE + 0x1080)
156 
157 /* The base for the max217x driver controls.
158  * We reserve 32 controls for this driver
159  */
160 #define V4L2_CID_USER_MAX217X_BASE		(V4L2_CID_USER_BASE + 0x1090)
161 
162 /* The base for the imx driver controls.
163  * We reserve 16 controls for this driver. */
164 #define V4L2_CID_USER_IMX_BASE			(V4L2_CID_USER_BASE + 0x10b0)
165 
166 /*
167  * The base for the atmel isc driver controls.
168  * We reserve 32 controls for this driver.
169  */
170 #define V4L2_CID_USER_ATMEL_ISC_BASE		(V4L2_CID_USER_BASE + 0x10c0)
171 
172 /*
173  * The base for the CODA driver controls.
174  * We reserve 16 controls for this driver.
175  */
176 #define V4L2_CID_USER_CODA_BASE			(V4L2_CID_USER_BASE + 0x10e0)
177 /*
178  * The base for MIPI CCS driver controls.
179  * We reserve 128 controls for this driver.
180  */
181 #define V4L2_CID_USER_CCS_BASE			(V4L2_CID_USER_BASE + 0x10f0)
182 /*
183  * The base for Allegro driver controls.
184  * We reserve 16 controls for this driver.
185  */
186 #define V4L2_CID_USER_ALLEGRO_BASE		(V4L2_CID_USER_BASE + 0x1170)
187 
188 /*
189  * The base for the isl7998x driver controls.
190  * We reserve 16 controls for this driver.
191  */
192 #define V4L2_CID_USER_ISL7998X_BASE		(V4L2_CID_USER_BASE + 0x1180)
193 
194 /*
195  * The base for DW100 driver controls.
196  * We reserve 16 controls for this driver.
197  */
198 #define V4L2_CID_USER_DW100_BASE		(V4L2_CID_USER_BASE + 0x1190)
199 
200 /*
201  * The base for Aspeed driver controls.
202  * We reserve 16 controls for this driver.
203  */
204 #define V4L2_CID_USER_ASPEED_BASE		(V4L2_CID_USER_BASE + 0x11a0)
205 
206 /*
207  * The base for Nuvoton NPCM driver controls.
208  * We reserve 16 controls for this driver.
209  */
210 #define V4L2_CID_USER_NPCM_BASE			(V4L2_CID_USER_BASE + 0x11b0)
211 
212 /*
213  * The base for THine THP7312 driver controls.
214  * We reserve 32 controls for this driver.
215  */
216 #define V4L2_CID_USER_THP7312_BASE		(V4L2_CID_USER_BASE + 0x11c0)
217 
218 /*
219  * The base for the uvc driver controls.
220  * See linux/uvcvideo.h for the list of controls.
221  * We reserve 64 controls for this driver.
222  */
223 #define V4L2_CID_USER_UVC_BASE			(V4L2_CID_USER_BASE + 0x11e0)
224 
225 /*
226  * The base for Rockchip ISP1 driver controls.
227  * We reserve 16 controls for this driver.
228  */
229 #define V4L2_CID_USER_RKISP1_BASE		(V4L2_CID_USER_BASE + 0x1220)
230 
231 /*
232  * The base for the Arm Mali-C55 ISP driver controls.
233  * We reserve 16 controls for this driver
234  */
235 #define V4L2_CID_USER_MALI_C55_BASE		(V4L2_CID_USER_BASE + 0x1230)
236 
237 /* MPEG-class control IDs */
238 /* The MPEG controls are applicable to all codec controls
239  * and the 'MPEG' part of the define is historical */
240 
241 #define V4L2_CID_CODEC_BASE			(V4L2_CTRL_CLASS_CODEC | 0x900)
242 #define V4L2_CID_CODEC_CLASS			(V4L2_CTRL_CLASS_CODEC | 1)
243 
244 /*  MPEG streams, specific to multiplexed streams */
245 #define V4L2_CID_MPEG_STREAM_TYPE		(V4L2_CID_CODEC_BASE+0)
246 enum v4l2_mpeg_stream_type {
247 	V4L2_MPEG_STREAM_TYPE_MPEG2_PS   = 0, /* MPEG-2 program stream */
248 	V4L2_MPEG_STREAM_TYPE_MPEG2_TS   = 1, /* MPEG-2 transport stream */
249 	V4L2_MPEG_STREAM_TYPE_MPEG1_SS   = 2, /* MPEG-1 system stream */
250 	V4L2_MPEG_STREAM_TYPE_MPEG2_DVD  = 3, /* MPEG-2 DVD-compatible stream */
251 	V4L2_MPEG_STREAM_TYPE_MPEG1_VCD  = 4, /* MPEG-1 VCD-compatible stream */
252 	V4L2_MPEG_STREAM_TYPE_MPEG2_SVCD = 5, /* MPEG-2 SVCD-compatible stream */
253 };
254 #define V4L2_CID_MPEG_STREAM_PID_PMT		(V4L2_CID_CODEC_BASE+1)
255 #define V4L2_CID_MPEG_STREAM_PID_AUDIO		(V4L2_CID_CODEC_BASE+2)
256 #define V4L2_CID_MPEG_STREAM_PID_VIDEO		(V4L2_CID_CODEC_BASE+3)
257 #define V4L2_CID_MPEG_STREAM_PID_PCR		(V4L2_CID_CODEC_BASE+4)
258 #define V4L2_CID_MPEG_STREAM_PES_ID_AUDIO	(V4L2_CID_CODEC_BASE+5)
259 #define V4L2_CID_MPEG_STREAM_PES_ID_VIDEO	(V4L2_CID_CODEC_BASE+6)
260 #define V4L2_CID_MPEG_STREAM_VBI_FMT		(V4L2_CID_CODEC_BASE+7)
261 enum v4l2_mpeg_stream_vbi_fmt {
262 	V4L2_MPEG_STREAM_VBI_FMT_NONE = 0,  /* No VBI in the MPEG stream */
263 	V4L2_MPEG_STREAM_VBI_FMT_IVTV = 1,  /* VBI in private packets, IVTV format */
264 };
265 
266 /*  MPEG audio controls specific to multiplexed streams  */
267 #define V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ	(V4L2_CID_CODEC_BASE+100)
268 enum v4l2_mpeg_audio_sampling_freq {
269 	V4L2_MPEG_AUDIO_SAMPLING_FREQ_44100 = 0,
270 	V4L2_MPEG_AUDIO_SAMPLING_FREQ_48000 = 1,
271 	V4L2_MPEG_AUDIO_SAMPLING_FREQ_32000 = 2,
272 };
273 #define V4L2_CID_MPEG_AUDIO_ENCODING		(V4L2_CID_CODEC_BASE+101)
274 enum v4l2_mpeg_audio_encoding {
275 	V4L2_MPEG_AUDIO_ENCODING_LAYER_1 = 0,
276 	V4L2_MPEG_AUDIO_ENCODING_LAYER_2 = 1,
277 	V4L2_MPEG_AUDIO_ENCODING_LAYER_3 = 2,
278 	V4L2_MPEG_AUDIO_ENCODING_AAC     = 3,
279 	V4L2_MPEG_AUDIO_ENCODING_AC3     = 4,
280 };
281 #define V4L2_CID_MPEG_AUDIO_L1_BITRATE		(V4L2_CID_CODEC_BASE+102)
282 enum v4l2_mpeg_audio_l1_bitrate {
283 	V4L2_MPEG_AUDIO_L1_BITRATE_32K  = 0,
284 	V4L2_MPEG_AUDIO_L1_BITRATE_64K  = 1,
285 	V4L2_MPEG_AUDIO_L1_BITRATE_96K  = 2,
286 	V4L2_MPEG_AUDIO_L1_BITRATE_128K = 3,
287 	V4L2_MPEG_AUDIO_L1_BITRATE_160K = 4,
288 	V4L2_MPEG_AUDIO_L1_BITRATE_192K = 5,
289 	V4L2_MPEG_AUDIO_L1_BITRATE_224K = 6,
290 	V4L2_MPEG_AUDIO_L1_BITRATE_256K = 7,
291 	V4L2_MPEG_AUDIO_L1_BITRATE_288K = 8,
292 	V4L2_MPEG_AUDIO_L1_BITRATE_320K = 9,
293 	V4L2_MPEG_AUDIO_L1_BITRATE_352K = 10,
294 	V4L2_MPEG_AUDIO_L1_BITRATE_384K = 11,
295 	V4L2_MPEG_AUDIO_L1_BITRATE_416K = 12,
296 	V4L2_MPEG_AUDIO_L1_BITRATE_448K = 13,
297 };
298 #define V4L2_CID_MPEG_AUDIO_L2_BITRATE		(V4L2_CID_CODEC_BASE+103)
299 enum v4l2_mpeg_audio_l2_bitrate {
300 	V4L2_MPEG_AUDIO_L2_BITRATE_32K  = 0,
301 	V4L2_MPEG_AUDIO_L2_BITRATE_48K  = 1,
302 	V4L2_MPEG_AUDIO_L2_BITRATE_56K  = 2,
303 	V4L2_MPEG_AUDIO_L2_BITRATE_64K  = 3,
304 	V4L2_MPEG_AUDIO_L2_BITRATE_80K  = 4,
305 	V4L2_MPEG_AUDIO_L2_BITRATE_96K  = 5,
306 	V4L2_MPEG_AUDIO_L2_BITRATE_112K = 6,
307 	V4L2_MPEG_AUDIO_L2_BITRATE_128K = 7,
308 	V4L2_MPEG_AUDIO_L2_BITRATE_160K = 8,
309 	V4L2_MPEG_AUDIO_L2_BITRATE_192K = 9,
310 	V4L2_MPEG_AUDIO_L2_BITRATE_224K = 10,
311 	V4L2_MPEG_AUDIO_L2_BITRATE_256K = 11,
312 	V4L2_MPEG_AUDIO_L2_BITRATE_320K = 12,
313 	V4L2_MPEG_AUDIO_L2_BITRATE_384K = 13,
314 };
315 #define V4L2_CID_MPEG_AUDIO_L3_BITRATE		(V4L2_CID_CODEC_BASE+104)
316 enum v4l2_mpeg_audio_l3_bitrate {
317 	V4L2_MPEG_AUDIO_L3_BITRATE_32K  = 0,
318 	V4L2_MPEG_AUDIO_L3_BITRATE_40K  = 1,
319 	V4L2_MPEG_AUDIO_L3_BITRATE_48K  = 2,
320 	V4L2_MPEG_AUDIO_L3_BITRATE_56K  = 3,
321 	V4L2_MPEG_AUDIO_L3_BITRATE_64K  = 4,
322 	V4L2_MPEG_AUDIO_L3_BITRATE_80K  = 5,
323 	V4L2_MPEG_AUDIO_L3_BITRATE_96K  = 6,
324 	V4L2_MPEG_AUDIO_L3_BITRATE_112K = 7,
325 	V4L2_MPEG_AUDIO_L3_BITRATE_128K = 8,
326 	V4L2_MPEG_AUDIO_L3_BITRATE_160K = 9,
327 	V4L2_MPEG_AUDIO_L3_BITRATE_192K = 10,
328 	V4L2_MPEG_AUDIO_L3_BITRATE_224K = 11,
329 	V4L2_MPEG_AUDIO_L3_BITRATE_256K = 12,
330 	V4L2_MPEG_AUDIO_L3_BITRATE_320K = 13,
331 };
332 #define V4L2_CID_MPEG_AUDIO_MODE		(V4L2_CID_CODEC_BASE+105)
333 enum v4l2_mpeg_audio_mode {
334 	V4L2_MPEG_AUDIO_MODE_STEREO       = 0,
335 	V4L2_MPEG_AUDIO_MODE_JOINT_STEREO = 1,
336 	V4L2_MPEG_AUDIO_MODE_DUAL         = 2,
337 	V4L2_MPEG_AUDIO_MODE_MONO         = 3,
338 };
339 #define V4L2_CID_MPEG_AUDIO_MODE_EXTENSION	(V4L2_CID_CODEC_BASE+106)
340 enum v4l2_mpeg_audio_mode_extension {
341 	V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_4  = 0,
342 	V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_8  = 1,
343 	V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_12 = 2,
344 	V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_16 = 3,
345 };
346 #define V4L2_CID_MPEG_AUDIO_EMPHASIS		(V4L2_CID_CODEC_BASE+107)
347 enum v4l2_mpeg_audio_emphasis {
348 	V4L2_MPEG_AUDIO_EMPHASIS_NONE         = 0,
349 	V4L2_MPEG_AUDIO_EMPHASIS_50_DIV_15_uS = 1,
350 	V4L2_MPEG_AUDIO_EMPHASIS_CCITT_J17    = 2,
351 };
352 #define V4L2_CID_MPEG_AUDIO_CRC			(V4L2_CID_CODEC_BASE+108)
353 enum v4l2_mpeg_audio_crc {
354 	V4L2_MPEG_AUDIO_CRC_NONE  = 0,
355 	V4L2_MPEG_AUDIO_CRC_CRC16 = 1,
356 };
357 #define V4L2_CID_MPEG_AUDIO_MUTE		(V4L2_CID_CODEC_BASE+109)
358 #define V4L2_CID_MPEG_AUDIO_AAC_BITRATE		(V4L2_CID_CODEC_BASE+110)
359 #define V4L2_CID_MPEG_AUDIO_AC3_BITRATE		(V4L2_CID_CODEC_BASE+111)
360 enum v4l2_mpeg_audio_ac3_bitrate {
361 	V4L2_MPEG_AUDIO_AC3_BITRATE_32K  = 0,
362 	V4L2_MPEG_AUDIO_AC3_BITRATE_40K  = 1,
363 	V4L2_MPEG_AUDIO_AC3_BITRATE_48K  = 2,
364 	V4L2_MPEG_AUDIO_AC3_BITRATE_56K  = 3,
365 	V4L2_MPEG_AUDIO_AC3_BITRATE_64K  = 4,
366 	V4L2_MPEG_AUDIO_AC3_BITRATE_80K  = 5,
367 	V4L2_MPEG_AUDIO_AC3_BITRATE_96K  = 6,
368 	V4L2_MPEG_AUDIO_AC3_BITRATE_112K = 7,
369 	V4L2_MPEG_AUDIO_AC3_BITRATE_128K = 8,
370 	V4L2_MPEG_AUDIO_AC3_BITRATE_160K = 9,
371 	V4L2_MPEG_AUDIO_AC3_BITRATE_192K = 10,
372 	V4L2_MPEG_AUDIO_AC3_BITRATE_224K = 11,
373 	V4L2_MPEG_AUDIO_AC3_BITRATE_256K = 12,
374 	V4L2_MPEG_AUDIO_AC3_BITRATE_320K = 13,
375 	V4L2_MPEG_AUDIO_AC3_BITRATE_384K = 14,
376 	V4L2_MPEG_AUDIO_AC3_BITRATE_448K = 15,
377 	V4L2_MPEG_AUDIO_AC3_BITRATE_512K = 16,
378 	V4L2_MPEG_AUDIO_AC3_BITRATE_576K = 17,
379 	V4L2_MPEG_AUDIO_AC3_BITRATE_640K = 18,
380 };
381 #define V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK	(V4L2_CID_CODEC_BASE+112)
382 enum v4l2_mpeg_audio_dec_playback {
383 	V4L2_MPEG_AUDIO_DEC_PLAYBACK_AUTO	    = 0,
384 	V4L2_MPEG_AUDIO_DEC_PLAYBACK_STEREO	    = 1,
385 	V4L2_MPEG_AUDIO_DEC_PLAYBACK_LEFT	    = 2,
386 	V4L2_MPEG_AUDIO_DEC_PLAYBACK_RIGHT	    = 3,
387 	V4L2_MPEG_AUDIO_DEC_PLAYBACK_MONO	    = 4,
388 	V4L2_MPEG_AUDIO_DEC_PLAYBACK_SWAPPED_STEREO = 5,
389 };
390 #define V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK (V4L2_CID_CODEC_BASE+113)
391 
392 /*  MPEG video controls specific to multiplexed streams */
393 #define V4L2_CID_MPEG_VIDEO_ENCODING		(V4L2_CID_CODEC_BASE+200)
394 enum v4l2_mpeg_video_encoding {
395 	V4L2_MPEG_VIDEO_ENCODING_MPEG_1     = 0,
396 	V4L2_MPEG_VIDEO_ENCODING_MPEG_2     = 1,
397 	V4L2_MPEG_VIDEO_ENCODING_MPEG_4_AVC = 2,
398 };
399 #define V4L2_CID_MPEG_VIDEO_ASPECT		(V4L2_CID_CODEC_BASE+201)
400 enum v4l2_mpeg_video_aspect {
401 	V4L2_MPEG_VIDEO_ASPECT_1x1     = 0,
402 	V4L2_MPEG_VIDEO_ASPECT_4x3     = 1,
403 	V4L2_MPEG_VIDEO_ASPECT_16x9    = 2,
404 	V4L2_MPEG_VIDEO_ASPECT_221x100 = 3,
405 };
406 #define V4L2_CID_MPEG_VIDEO_B_FRAMES		(V4L2_CID_CODEC_BASE+202)
407 #define V4L2_CID_MPEG_VIDEO_GOP_SIZE		(V4L2_CID_CODEC_BASE+203)
408 #define V4L2_CID_MPEG_VIDEO_GOP_CLOSURE		(V4L2_CID_CODEC_BASE+204)
409 #define V4L2_CID_MPEG_VIDEO_PULLDOWN		(V4L2_CID_CODEC_BASE+205)
410 #define V4L2_CID_MPEG_VIDEO_BITRATE_MODE	(V4L2_CID_CODEC_BASE+206)
411 enum v4l2_mpeg_video_bitrate_mode {
412 	V4L2_MPEG_VIDEO_BITRATE_MODE_VBR = 0,
413 	V4L2_MPEG_VIDEO_BITRATE_MODE_CBR = 1,
414 	V4L2_MPEG_VIDEO_BITRATE_MODE_CQ  = 2,
415 };
416 #define V4L2_CID_MPEG_VIDEO_BITRATE		(V4L2_CID_CODEC_BASE+207)
417 #define V4L2_CID_MPEG_VIDEO_BITRATE_PEAK	(V4L2_CID_CODEC_BASE+208)
418 #define V4L2_CID_MPEG_VIDEO_TEMPORAL_DECIMATION (V4L2_CID_CODEC_BASE+209)
419 #define V4L2_CID_MPEG_VIDEO_MUTE		(V4L2_CID_CODEC_BASE+210)
420 #define V4L2_CID_MPEG_VIDEO_MUTE_YUV		(V4L2_CID_CODEC_BASE+211)
421 #define V4L2_CID_MPEG_VIDEO_DECODER_SLICE_INTERFACE		(V4L2_CID_CODEC_BASE+212)
422 #define V4L2_CID_MPEG_VIDEO_DECODER_MPEG4_DEBLOCK_FILTER	(V4L2_CID_CODEC_BASE+213)
423 #define V4L2_CID_MPEG_VIDEO_CYCLIC_INTRA_REFRESH_MB		(V4L2_CID_CODEC_BASE+214)
424 #define V4L2_CID_MPEG_VIDEO_FRAME_RC_ENABLE			(V4L2_CID_CODEC_BASE+215)
425 #define V4L2_CID_MPEG_VIDEO_HEADER_MODE				(V4L2_CID_CODEC_BASE+216)
426 enum v4l2_mpeg_video_header_mode {
427 	V4L2_MPEG_VIDEO_HEADER_MODE_SEPARATE			= 0,
428 	V4L2_MPEG_VIDEO_HEADER_MODE_JOINED_WITH_1ST_FRAME	= 1,
429 
430 };
431 #define V4L2_CID_MPEG_VIDEO_MAX_REF_PIC			(V4L2_CID_CODEC_BASE+217)
432 #define V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE		(V4L2_CID_CODEC_BASE+218)
433 #define V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_BYTES	(V4L2_CID_CODEC_BASE+219)
434 #define V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_MB		(V4L2_CID_CODEC_BASE+220)
435 #define V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE		(V4L2_CID_CODEC_BASE+221)
436 enum v4l2_mpeg_video_multi_slice_mode {
437 	V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_SINGLE		= 0,
438 	V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_MB		= 1,
439 	V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_BYTES	= 2,
440 #ifndef __KERNEL__
441 	/* Kept for backwards compatibility reasons. Stupid typo... */
442 	V4L2_MPEG_VIDEO_MULTI_SICE_MODE_MAX_MB		= 1,
443 	V4L2_MPEG_VIDEO_MULTI_SICE_MODE_MAX_BYTES	= 2,
444 #endif
445 };
446 #define V4L2_CID_MPEG_VIDEO_VBV_SIZE			(V4L2_CID_CODEC_BASE+222)
447 #define V4L2_CID_MPEG_VIDEO_DEC_PTS			(V4L2_CID_CODEC_BASE+223)
448 #define V4L2_CID_MPEG_VIDEO_DEC_FRAME			(V4L2_CID_CODEC_BASE+224)
449 #define V4L2_CID_MPEG_VIDEO_VBV_DELAY			(V4L2_CID_CODEC_BASE+225)
450 #define V4L2_CID_MPEG_VIDEO_REPEAT_SEQ_HEADER		(V4L2_CID_CODEC_BASE+226)
451 #define V4L2_CID_MPEG_VIDEO_MV_H_SEARCH_RANGE		(V4L2_CID_CODEC_BASE+227)
452 #define V4L2_CID_MPEG_VIDEO_MV_V_SEARCH_RANGE		(V4L2_CID_CODEC_BASE+228)
453 #define V4L2_CID_MPEG_VIDEO_FORCE_KEY_FRAME		(V4L2_CID_CODEC_BASE+229)
454 #define V4L2_CID_MPEG_VIDEO_BASELAYER_PRIORITY_ID	(V4L2_CID_CODEC_BASE+230)
455 #define V4L2_CID_MPEG_VIDEO_AU_DELIMITER		(V4L2_CID_CODEC_BASE+231)
456 #define V4L2_CID_MPEG_VIDEO_LTR_COUNT			(V4L2_CID_CODEC_BASE+232)
457 #define V4L2_CID_MPEG_VIDEO_FRAME_LTR_INDEX		(V4L2_CID_CODEC_BASE+233)
458 #define V4L2_CID_MPEG_VIDEO_USE_LTR_FRAMES		(V4L2_CID_CODEC_BASE+234)
459 #define V4L2_CID_MPEG_VIDEO_DEC_CONCEAL_COLOR		(V4L2_CID_CODEC_BASE+235)
460 #define V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD	(V4L2_CID_CODEC_BASE+236)
461 #define V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE	(V4L2_CID_CODEC_BASE+237)
462 enum v4l2_mpeg_video_intra_refresh_period_type {
463 	V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE_RANDOM	= 0,
464 	V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE_CYCLIC	= 1,
465 };
466 
467 /* CIDs for the MPEG-2 Part 2 (H.262) codec */
468 #define V4L2_CID_MPEG_VIDEO_MPEG2_LEVEL			(V4L2_CID_CODEC_BASE+270)
469 enum v4l2_mpeg_video_mpeg2_level {
470 	V4L2_MPEG_VIDEO_MPEG2_LEVEL_LOW		= 0,
471 	V4L2_MPEG_VIDEO_MPEG2_LEVEL_MAIN	= 1,
472 	V4L2_MPEG_VIDEO_MPEG2_LEVEL_HIGH_1440	= 2,
473 	V4L2_MPEG_VIDEO_MPEG2_LEVEL_HIGH	= 3,
474 };
475 #define V4L2_CID_MPEG_VIDEO_MPEG2_PROFILE		(V4L2_CID_CODEC_BASE+271)
476 enum v4l2_mpeg_video_mpeg2_profile {
477 	V4L2_MPEG_VIDEO_MPEG2_PROFILE_SIMPLE				= 0,
478 	V4L2_MPEG_VIDEO_MPEG2_PROFILE_MAIN				= 1,
479 	V4L2_MPEG_VIDEO_MPEG2_PROFILE_SNR_SCALABLE			= 2,
480 	V4L2_MPEG_VIDEO_MPEG2_PROFILE_SPATIALLY_SCALABLE		= 3,
481 	V4L2_MPEG_VIDEO_MPEG2_PROFILE_HIGH				= 4,
482 	V4L2_MPEG_VIDEO_MPEG2_PROFILE_MULTIVIEW				= 5,
483 };
484 
485 /* CIDs for the FWHT codec as used by the vicodec driver. */
486 #define V4L2_CID_FWHT_I_FRAME_QP             (V4L2_CID_CODEC_BASE + 290)
487 #define V4L2_CID_FWHT_P_FRAME_QP             (V4L2_CID_CODEC_BASE + 291)
488 
489 #define V4L2_CID_MPEG_VIDEO_H263_I_FRAME_QP		(V4L2_CID_CODEC_BASE+300)
490 #define V4L2_CID_MPEG_VIDEO_H263_P_FRAME_QP		(V4L2_CID_CODEC_BASE+301)
491 #define V4L2_CID_MPEG_VIDEO_H263_B_FRAME_QP		(V4L2_CID_CODEC_BASE+302)
492 #define V4L2_CID_MPEG_VIDEO_H263_MIN_QP			(V4L2_CID_CODEC_BASE+303)
493 #define V4L2_CID_MPEG_VIDEO_H263_MAX_QP			(V4L2_CID_CODEC_BASE+304)
494 #define V4L2_CID_MPEG_VIDEO_H264_I_FRAME_QP		(V4L2_CID_CODEC_BASE+350)
495 #define V4L2_CID_MPEG_VIDEO_H264_P_FRAME_QP		(V4L2_CID_CODEC_BASE+351)
496 #define V4L2_CID_MPEG_VIDEO_H264_B_FRAME_QP		(V4L2_CID_CODEC_BASE+352)
497 #define V4L2_CID_MPEG_VIDEO_H264_MIN_QP			(V4L2_CID_CODEC_BASE+353)
498 #define V4L2_CID_MPEG_VIDEO_H264_MAX_QP			(V4L2_CID_CODEC_BASE+354)
499 #define V4L2_CID_MPEG_VIDEO_H264_8X8_TRANSFORM		(V4L2_CID_CODEC_BASE+355)
500 #define V4L2_CID_MPEG_VIDEO_H264_CPB_SIZE		(V4L2_CID_CODEC_BASE+356)
501 #define V4L2_CID_MPEG_VIDEO_H264_ENTROPY_MODE		(V4L2_CID_CODEC_BASE+357)
502 enum v4l2_mpeg_video_h264_entropy_mode {
503 	V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CAVLC	= 0,
504 	V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CABAC	= 1,
505 };
506 #define V4L2_CID_MPEG_VIDEO_H264_I_PERIOD		(V4L2_CID_CODEC_BASE+358)
507 #define V4L2_CID_MPEG_VIDEO_H264_LEVEL			(V4L2_CID_CODEC_BASE+359)
508 enum v4l2_mpeg_video_h264_level {
509 	V4L2_MPEG_VIDEO_H264_LEVEL_1_0	= 0,
510 	V4L2_MPEG_VIDEO_H264_LEVEL_1B	= 1,
511 	V4L2_MPEG_VIDEO_H264_LEVEL_1_1	= 2,
512 	V4L2_MPEG_VIDEO_H264_LEVEL_1_2	= 3,
513 	V4L2_MPEG_VIDEO_H264_LEVEL_1_3	= 4,
514 	V4L2_MPEG_VIDEO_H264_LEVEL_2_0	= 5,
515 	V4L2_MPEG_VIDEO_H264_LEVEL_2_1	= 6,
516 	V4L2_MPEG_VIDEO_H264_LEVEL_2_2	= 7,
517 	V4L2_MPEG_VIDEO_H264_LEVEL_3_0	= 8,
518 	V4L2_MPEG_VIDEO_H264_LEVEL_3_1	= 9,
519 	V4L2_MPEG_VIDEO_H264_LEVEL_3_2	= 10,
520 	V4L2_MPEG_VIDEO_H264_LEVEL_4_0	= 11,
521 	V4L2_MPEG_VIDEO_H264_LEVEL_4_1	= 12,
522 	V4L2_MPEG_VIDEO_H264_LEVEL_4_2	= 13,
523 	V4L2_MPEG_VIDEO_H264_LEVEL_5_0	= 14,
524 	V4L2_MPEG_VIDEO_H264_LEVEL_5_1	= 15,
525 	V4L2_MPEG_VIDEO_H264_LEVEL_5_2	= 16,
526 	V4L2_MPEG_VIDEO_H264_LEVEL_6_0	= 17,
527 	V4L2_MPEG_VIDEO_H264_LEVEL_6_1	= 18,
528 	V4L2_MPEG_VIDEO_H264_LEVEL_6_2	= 19,
529 };
530 #define V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_ALPHA	(V4L2_CID_CODEC_BASE+360)
531 #define V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_BETA	(V4L2_CID_CODEC_BASE+361)
532 #define V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_MODE	(V4L2_CID_CODEC_BASE+362)
533 enum v4l2_mpeg_video_h264_loop_filter_mode {
534 	V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_ENABLED				= 0,
535 	V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED				= 1,
536 	V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED_AT_SLICE_BOUNDARY	= 2,
537 };
538 #define V4L2_CID_MPEG_VIDEO_H264_PROFILE		(V4L2_CID_CODEC_BASE+363)
539 enum v4l2_mpeg_video_h264_profile {
540 	V4L2_MPEG_VIDEO_H264_PROFILE_BASELINE			= 0,
541 	V4L2_MPEG_VIDEO_H264_PROFILE_CONSTRAINED_BASELINE	= 1,
542 	V4L2_MPEG_VIDEO_H264_PROFILE_MAIN			= 2,
543 	V4L2_MPEG_VIDEO_H264_PROFILE_EXTENDED			= 3,
544 	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH			= 4,
545 	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10			= 5,
546 	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422			= 6,
547 	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_PREDICTIVE	= 7,
548 	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10_INTRA		= 8,
549 	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422_INTRA		= 9,
550 	V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_INTRA		= 10,
551 	V4L2_MPEG_VIDEO_H264_PROFILE_CAVLC_444_INTRA		= 11,
552 	V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_BASELINE		= 12,
553 	V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH		= 13,
554 	V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH_INTRA	= 14,
555 	V4L2_MPEG_VIDEO_H264_PROFILE_STEREO_HIGH		= 15,
556 	V4L2_MPEG_VIDEO_H264_PROFILE_MULTIVIEW_HIGH		= 16,
557 	V4L2_MPEG_VIDEO_H264_PROFILE_CONSTRAINED_HIGH		= 17,
558 };
559 #define V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_HEIGHT	(V4L2_CID_CODEC_BASE+364)
560 #define V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_WIDTH	(V4L2_CID_CODEC_BASE+365)
561 #define V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_ENABLE		(V4L2_CID_CODEC_BASE+366)
562 #define V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_IDC		(V4L2_CID_CODEC_BASE+367)
563 enum v4l2_mpeg_video_h264_vui_sar_idc {
564 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_UNSPECIFIED	= 0,
565 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_1x1		= 1,
566 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_12x11		= 2,
567 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_10x11		= 3,
568 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_16x11		= 4,
569 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_40x33		= 5,
570 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_24x11		= 6,
571 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_20x11		= 7,
572 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_32x11		= 8,
573 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_80x33		= 9,
574 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_18x11		= 10,
575 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_15x11		= 11,
576 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_64x33		= 12,
577 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_160x99		= 13,
578 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_4x3		= 14,
579 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_3x2		= 15,
580 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_2x1		= 16,
581 	V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_EXTENDED	= 17,
582 };
583 #define V4L2_CID_MPEG_VIDEO_H264_SEI_FRAME_PACKING		(V4L2_CID_CODEC_BASE+368)
584 #define V4L2_CID_MPEG_VIDEO_H264_SEI_FP_CURRENT_FRAME_0		(V4L2_CID_CODEC_BASE+369)
585 #define V4L2_CID_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE	(V4L2_CID_CODEC_BASE+370)
586 enum v4l2_mpeg_video_h264_sei_fp_arrangement_type {
587 	V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_CHECKERBOARD	= 0,
588 	V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_COLUMN		= 1,
589 	V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_ROW		= 2,
590 	V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_SIDE_BY_SIDE	= 3,
591 	V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_TOP_BOTTOM		= 4,
592 	V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_TEMPORAL		= 5,
593 };
594 #define V4L2_CID_MPEG_VIDEO_H264_FMO			(V4L2_CID_CODEC_BASE+371)
595 #define V4L2_CID_MPEG_VIDEO_H264_FMO_MAP_TYPE		(V4L2_CID_CODEC_BASE+372)
596 enum v4l2_mpeg_video_h264_fmo_map_type {
597 	V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_INTERLEAVED_SLICES		= 0,
598 	V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_SCATTERED_SLICES		= 1,
599 	V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_FOREGROUND_WITH_LEFT_OVER	= 2,
600 	V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_BOX_OUT			= 3,
601 	V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_RASTER_SCAN			= 4,
602 	V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_WIPE_SCAN			= 5,
603 	V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_EXPLICIT			= 6,
604 };
605 #define V4L2_CID_MPEG_VIDEO_H264_FMO_SLICE_GROUP	(V4L2_CID_CODEC_BASE+373)
606 #define V4L2_CID_MPEG_VIDEO_H264_FMO_CHANGE_DIRECTION	(V4L2_CID_CODEC_BASE+374)
607 enum v4l2_mpeg_video_h264_fmo_change_dir {
608 	V4L2_MPEG_VIDEO_H264_FMO_CHANGE_DIR_RIGHT	= 0,
609 	V4L2_MPEG_VIDEO_H264_FMO_CHANGE_DIR_LEFT	= 1,
610 };
611 #define V4L2_CID_MPEG_VIDEO_H264_FMO_CHANGE_RATE	(V4L2_CID_CODEC_BASE+375)
612 #define V4L2_CID_MPEG_VIDEO_H264_FMO_RUN_LENGTH		(V4L2_CID_CODEC_BASE+376)
613 #define V4L2_CID_MPEG_VIDEO_H264_ASO			(V4L2_CID_CODEC_BASE+377)
614 #define V4L2_CID_MPEG_VIDEO_H264_ASO_SLICE_ORDER	(V4L2_CID_CODEC_BASE+378)
615 #define V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING		(V4L2_CID_CODEC_BASE+379)
616 #define V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_TYPE	(V4L2_CID_CODEC_BASE+380)
617 enum v4l2_mpeg_video_h264_hierarchical_coding_type {
618 	V4L2_MPEG_VIDEO_H264_HIERARCHICAL_CODING_B	= 0,
619 	V4L2_MPEG_VIDEO_H264_HIERARCHICAL_CODING_P	= 1,
620 };
621 #define V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_LAYER	(V4L2_CID_CODEC_BASE+381)
622 #define V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_LAYER_QP	(V4L2_CID_CODEC_BASE+382)
623 #define V4L2_CID_MPEG_VIDEO_H264_CONSTRAINED_INTRA_PREDICTION	(V4L2_CID_CODEC_BASE+383)
624 #define V4L2_CID_MPEG_VIDEO_H264_CHROMA_QP_INDEX_OFFSET		(V4L2_CID_CODEC_BASE+384)
625 #define V4L2_CID_MPEG_VIDEO_H264_I_FRAME_MIN_QP	(V4L2_CID_CODEC_BASE+385)
626 #define V4L2_CID_MPEG_VIDEO_H264_I_FRAME_MAX_QP	(V4L2_CID_CODEC_BASE+386)
627 #define V4L2_CID_MPEG_VIDEO_H264_P_FRAME_MIN_QP	(V4L2_CID_CODEC_BASE+387)
628 #define V4L2_CID_MPEG_VIDEO_H264_P_FRAME_MAX_QP	(V4L2_CID_CODEC_BASE+388)
629 #define V4L2_CID_MPEG_VIDEO_H264_B_FRAME_MIN_QP	(V4L2_CID_CODEC_BASE+389)
630 #define V4L2_CID_MPEG_VIDEO_H264_B_FRAME_MAX_QP	(V4L2_CID_CODEC_BASE+390)
631 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L0_BR	(V4L2_CID_CODEC_BASE+391)
632 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L1_BR	(V4L2_CID_CODEC_BASE+392)
633 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L2_BR	(V4L2_CID_CODEC_BASE+393)
634 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L3_BR	(V4L2_CID_CODEC_BASE+394)
635 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L4_BR	(V4L2_CID_CODEC_BASE+395)
636 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L5_BR	(V4L2_CID_CODEC_BASE+396)
637 #define V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L6_BR	(V4L2_CID_CODEC_BASE+397)
638 #define V4L2_CID_MPEG_VIDEO_MPEG4_I_FRAME_QP	(V4L2_CID_CODEC_BASE+400)
639 #define V4L2_CID_MPEG_VIDEO_MPEG4_P_FRAME_QP	(V4L2_CID_CODEC_BASE+401)
640 #define V4L2_CID_MPEG_VIDEO_MPEG4_B_FRAME_QP	(V4L2_CID_CODEC_BASE+402)
641 #define V4L2_CID_MPEG_VIDEO_MPEG4_MIN_QP	(V4L2_CID_CODEC_BASE+403)
642 #define V4L2_CID_MPEG_VIDEO_MPEG4_MAX_QP	(V4L2_CID_CODEC_BASE+404)
643 #define V4L2_CID_MPEG_VIDEO_MPEG4_LEVEL		(V4L2_CID_CODEC_BASE+405)
644 enum v4l2_mpeg_video_mpeg4_level {
645 	V4L2_MPEG_VIDEO_MPEG4_LEVEL_0	= 0,
646 	V4L2_MPEG_VIDEO_MPEG4_LEVEL_0B	= 1,
647 	V4L2_MPEG_VIDEO_MPEG4_LEVEL_1	= 2,
648 	V4L2_MPEG_VIDEO_MPEG4_LEVEL_2	= 3,
649 	V4L2_MPEG_VIDEO_MPEG4_LEVEL_3	= 4,
650 	V4L2_MPEG_VIDEO_MPEG4_LEVEL_3B	= 5,
651 	V4L2_MPEG_VIDEO_MPEG4_LEVEL_4	= 6,
652 	V4L2_MPEG_VIDEO_MPEG4_LEVEL_5	= 7,
653 };
654 #define V4L2_CID_MPEG_VIDEO_MPEG4_PROFILE	(V4L2_CID_CODEC_BASE+406)
655 enum v4l2_mpeg_video_mpeg4_profile {
656 	V4L2_MPEG_VIDEO_MPEG4_PROFILE_SIMPLE				= 0,
657 	V4L2_MPEG_VIDEO_MPEG4_PROFILE_ADVANCED_SIMPLE			= 1,
658 	V4L2_MPEG_VIDEO_MPEG4_PROFILE_CORE				= 2,
659 	V4L2_MPEG_VIDEO_MPEG4_PROFILE_SIMPLE_SCALABLE			= 3,
660 	V4L2_MPEG_VIDEO_MPEG4_PROFILE_ADVANCED_CODING_EFFICIENCY	= 4,
661 };
662 #define V4L2_CID_MPEG_VIDEO_MPEG4_QPEL		(V4L2_CID_CODEC_BASE+407)
663 
664 /*  Control IDs for VP8 streams
665  *  Although VP8 is not part of MPEG we add these controls to the MPEG class
666  *  as that class is already handling other video compression standards
667  */
668 #define V4L2_CID_MPEG_VIDEO_VPX_NUM_PARTITIONS		(V4L2_CID_CODEC_BASE+500)
669 enum v4l2_vp8_num_partitions {
670 	V4L2_CID_MPEG_VIDEO_VPX_1_PARTITION	= 0,
671 	V4L2_CID_MPEG_VIDEO_VPX_2_PARTITIONS	= 1,
672 	V4L2_CID_MPEG_VIDEO_VPX_4_PARTITIONS	= 2,
673 	V4L2_CID_MPEG_VIDEO_VPX_8_PARTITIONS	= 3,
674 };
675 #define V4L2_CID_MPEG_VIDEO_VPX_IMD_DISABLE_4X4		(V4L2_CID_CODEC_BASE+501)
676 #define V4L2_CID_MPEG_VIDEO_VPX_NUM_REF_FRAMES		(V4L2_CID_CODEC_BASE+502)
677 enum v4l2_vp8_num_ref_frames {
678 	V4L2_CID_MPEG_VIDEO_VPX_1_REF_FRAME	= 0,
679 	V4L2_CID_MPEG_VIDEO_VPX_2_REF_FRAME	= 1,
680 	V4L2_CID_MPEG_VIDEO_VPX_3_REF_FRAME	= 2,
681 };
682 #define V4L2_CID_MPEG_VIDEO_VPX_FILTER_LEVEL		(V4L2_CID_CODEC_BASE+503)
683 #define V4L2_CID_MPEG_VIDEO_VPX_FILTER_SHARPNESS	(V4L2_CID_CODEC_BASE+504)
684 #define V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_REF_PERIOD	(V4L2_CID_CODEC_BASE+505)
685 #define V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_SEL	(V4L2_CID_CODEC_BASE+506)
686 enum v4l2_vp8_golden_frame_sel {
687 	V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_USE_PREV		= 0,
688 	V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_USE_REF_PERIOD	= 1,
689 };
690 #define V4L2_CID_MPEG_VIDEO_VPX_MIN_QP			(V4L2_CID_CODEC_BASE+507)
691 #define V4L2_CID_MPEG_VIDEO_VPX_MAX_QP			(V4L2_CID_CODEC_BASE+508)
692 #define V4L2_CID_MPEG_VIDEO_VPX_I_FRAME_QP		(V4L2_CID_CODEC_BASE+509)
693 #define V4L2_CID_MPEG_VIDEO_VPX_P_FRAME_QP		(V4L2_CID_CODEC_BASE+510)
694 
695 #define V4L2_CID_MPEG_VIDEO_VP8_PROFILE			(V4L2_CID_CODEC_BASE+511)
696 enum v4l2_mpeg_video_vp8_profile {
697 	V4L2_MPEG_VIDEO_VP8_PROFILE_0				= 0,
698 	V4L2_MPEG_VIDEO_VP8_PROFILE_1				= 1,
699 	V4L2_MPEG_VIDEO_VP8_PROFILE_2				= 2,
700 	V4L2_MPEG_VIDEO_VP8_PROFILE_3				= 3,
701 };
702 /* Deprecated alias for compatibility reasons. */
703 #define V4L2_CID_MPEG_VIDEO_VPX_PROFILE	V4L2_CID_MPEG_VIDEO_VP8_PROFILE
704 #define V4L2_CID_MPEG_VIDEO_VP9_PROFILE			(V4L2_CID_CODEC_BASE+512)
705 enum v4l2_mpeg_video_vp9_profile {
706 	V4L2_MPEG_VIDEO_VP9_PROFILE_0				= 0,
707 	V4L2_MPEG_VIDEO_VP9_PROFILE_1				= 1,
708 	V4L2_MPEG_VIDEO_VP9_PROFILE_2				= 2,
709 	V4L2_MPEG_VIDEO_VP9_PROFILE_3				= 3,
710 };
711 #define V4L2_CID_MPEG_VIDEO_VP9_LEVEL			(V4L2_CID_CODEC_BASE+513)
712 enum v4l2_mpeg_video_vp9_level {
713 	V4L2_MPEG_VIDEO_VP9_LEVEL_1_0	= 0,
714 	V4L2_MPEG_VIDEO_VP9_LEVEL_1_1	= 1,
715 	V4L2_MPEG_VIDEO_VP9_LEVEL_2_0	= 2,
716 	V4L2_MPEG_VIDEO_VP9_LEVEL_2_1	= 3,
717 	V4L2_MPEG_VIDEO_VP9_LEVEL_3_0	= 4,
718 	V4L2_MPEG_VIDEO_VP9_LEVEL_3_1	= 5,
719 	V4L2_MPEG_VIDEO_VP9_LEVEL_4_0	= 6,
720 	V4L2_MPEG_VIDEO_VP9_LEVEL_4_1	= 7,
721 	V4L2_MPEG_VIDEO_VP9_LEVEL_5_0	= 8,
722 	V4L2_MPEG_VIDEO_VP9_LEVEL_5_1	= 9,
723 	V4L2_MPEG_VIDEO_VP9_LEVEL_5_2	= 10,
724 	V4L2_MPEG_VIDEO_VP9_LEVEL_6_0	= 11,
725 	V4L2_MPEG_VIDEO_VP9_LEVEL_6_1	= 12,
726 	V4L2_MPEG_VIDEO_VP9_LEVEL_6_2	= 13,
727 };
728 
729 /* CIDs for HEVC encoding. */
730 
731 #define V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP		(V4L2_CID_CODEC_BASE + 600)
732 #define V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP		(V4L2_CID_CODEC_BASE + 601)
733 #define V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_QP	(V4L2_CID_CODEC_BASE + 602)
734 #define V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_QP	(V4L2_CID_CODEC_BASE + 603)
735 #define V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_QP	(V4L2_CID_CODEC_BASE + 604)
736 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_QP	(V4L2_CID_CODEC_BASE + 605)
737 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_TYPE (V4L2_CID_CODEC_BASE + 606)
738 enum v4l2_mpeg_video_hevc_hier_coding_type {
739 	V4L2_MPEG_VIDEO_HEVC_HIERARCHICAL_CODING_B	= 0,
740 	V4L2_MPEG_VIDEO_HEVC_HIERARCHICAL_CODING_P	= 1,
741 };
742 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_LAYER	(V4L2_CID_CODEC_BASE + 607)
743 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L0_QP	(V4L2_CID_CODEC_BASE + 608)
744 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L1_QP	(V4L2_CID_CODEC_BASE + 609)
745 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L2_QP	(V4L2_CID_CODEC_BASE + 610)
746 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L3_QP	(V4L2_CID_CODEC_BASE + 611)
747 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L4_QP	(V4L2_CID_CODEC_BASE + 612)
748 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L5_QP	(V4L2_CID_CODEC_BASE + 613)
749 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L6_QP	(V4L2_CID_CODEC_BASE + 614)
750 #define V4L2_CID_MPEG_VIDEO_HEVC_PROFILE	(V4L2_CID_CODEC_BASE + 615)
751 enum v4l2_mpeg_video_hevc_profile {
752 	V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN = 0,
753 	V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN_STILL_PICTURE = 1,
754 	V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN_10 = 2,
755 };
756 #define V4L2_CID_MPEG_VIDEO_HEVC_LEVEL		(V4L2_CID_CODEC_BASE + 616)
757 enum v4l2_mpeg_video_hevc_level {
758 	V4L2_MPEG_VIDEO_HEVC_LEVEL_1	= 0,
759 	V4L2_MPEG_VIDEO_HEVC_LEVEL_2	= 1,
760 	V4L2_MPEG_VIDEO_HEVC_LEVEL_2_1	= 2,
761 	V4L2_MPEG_VIDEO_HEVC_LEVEL_3	= 3,
762 	V4L2_MPEG_VIDEO_HEVC_LEVEL_3_1	= 4,
763 	V4L2_MPEG_VIDEO_HEVC_LEVEL_4	= 5,
764 	V4L2_MPEG_VIDEO_HEVC_LEVEL_4_1	= 6,
765 	V4L2_MPEG_VIDEO_HEVC_LEVEL_5	= 7,
766 	V4L2_MPEG_VIDEO_HEVC_LEVEL_5_1	= 8,
767 	V4L2_MPEG_VIDEO_HEVC_LEVEL_5_2	= 9,
768 	V4L2_MPEG_VIDEO_HEVC_LEVEL_6	= 10,
769 	V4L2_MPEG_VIDEO_HEVC_LEVEL_6_1	= 11,
770 	V4L2_MPEG_VIDEO_HEVC_LEVEL_6_2	= 12,
771 };
772 #define V4L2_CID_MPEG_VIDEO_HEVC_FRAME_RATE_RESOLUTION	(V4L2_CID_CODEC_BASE + 617)
773 #define V4L2_CID_MPEG_VIDEO_HEVC_TIER			(V4L2_CID_CODEC_BASE + 618)
774 enum v4l2_mpeg_video_hevc_tier {
775 	V4L2_MPEG_VIDEO_HEVC_TIER_MAIN = 0,
776 	V4L2_MPEG_VIDEO_HEVC_TIER_HIGH = 1,
777 };
778 #define V4L2_CID_MPEG_VIDEO_HEVC_MAX_PARTITION_DEPTH	(V4L2_CID_CODEC_BASE + 619)
779 #define V4L2_CID_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE	(V4L2_CID_CODEC_BASE + 620)
780 enum v4l2_cid_mpeg_video_hevc_loop_filter_mode {
781 	V4L2_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE_DISABLED			 = 0,
782 	V4L2_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE_ENABLED			 = 1,
783 	V4L2_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE_DISABLED_AT_SLICE_BOUNDARY = 2,
784 };
785 #define V4L2_CID_MPEG_VIDEO_HEVC_LF_BETA_OFFSET_DIV2	(V4L2_CID_CODEC_BASE + 621)
786 #define V4L2_CID_MPEG_VIDEO_HEVC_LF_TC_OFFSET_DIV2	(V4L2_CID_CODEC_BASE + 622)
787 #define V4L2_CID_MPEG_VIDEO_HEVC_REFRESH_TYPE		(V4L2_CID_CODEC_BASE + 623)
788 enum v4l2_cid_mpeg_video_hevc_refresh_type {
789 	V4L2_MPEG_VIDEO_HEVC_REFRESH_NONE		= 0,
790 	V4L2_MPEG_VIDEO_HEVC_REFRESH_CRA		= 1,
791 	V4L2_MPEG_VIDEO_HEVC_REFRESH_IDR		= 2,
792 };
793 #define V4L2_CID_MPEG_VIDEO_HEVC_REFRESH_PERIOD		(V4L2_CID_CODEC_BASE + 624)
794 #define V4L2_CID_MPEG_VIDEO_HEVC_LOSSLESS_CU		(V4L2_CID_CODEC_BASE + 625)
795 #define V4L2_CID_MPEG_VIDEO_HEVC_CONST_INTRA_PRED	(V4L2_CID_CODEC_BASE + 626)
796 #define V4L2_CID_MPEG_VIDEO_HEVC_WAVEFRONT		(V4L2_CID_CODEC_BASE + 627)
797 #define V4L2_CID_MPEG_VIDEO_HEVC_GENERAL_PB		(V4L2_CID_CODEC_BASE + 628)
798 #define V4L2_CID_MPEG_VIDEO_HEVC_TEMPORAL_ID		(V4L2_CID_CODEC_BASE + 629)
799 #define V4L2_CID_MPEG_VIDEO_HEVC_STRONG_SMOOTHING	(V4L2_CID_CODEC_BASE + 630)
800 #define V4L2_CID_MPEG_VIDEO_HEVC_MAX_NUM_MERGE_MV_MINUS1	(V4L2_CID_CODEC_BASE + 631)
801 #define V4L2_CID_MPEG_VIDEO_HEVC_INTRA_PU_SPLIT		(V4L2_CID_CODEC_BASE + 632)
802 #define V4L2_CID_MPEG_VIDEO_HEVC_TMV_PREDICTION		(V4L2_CID_CODEC_BASE + 633)
803 #define V4L2_CID_MPEG_VIDEO_HEVC_WITHOUT_STARTCODE	(V4L2_CID_CODEC_BASE + 634)
804 #define V4L2_CID_MPEG_VIDEO_HEVC_SIZE_OF_LENGTH_FIELD	(V4L2_CID_CODEC_BASE + 635)
805 enum v4l2_cid_mpeg_video_hevc_size_of_length_field {
806 	V4L2_MPEG_VIDEO_HEVC_SIZE_0		= 0,
807 	V4L2_MPEG_VIDEO_HEVC_SIZE_1		= 1,
808 	V4L2_MPEG_VIDEO_HEVC_SIZE_2		= 2,
809 	V4L2_MPEG_VIDEO_HEVC_SIZE_4		= 3,
810 };
811 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L0_BR	(V4L2_CID_CODEC_BASE + 636)
812 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L1_BR	(V4L2_CID_CODEC_BASE + 637)
813 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L2_BR	(V4L2_CID_CODEC_BASE + 638)
814 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L3_BR	(V4L2_CID_CODEC_BASE + 639)
815 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L4_BR	(V4L2_CID_CODEC_BASE + 640)
816 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L5_BR	(V4L2_CID_CODEC_BASE + 641)
817 #define V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L6_BR	(V4L2_CID_CODEC_BASE + 642)
818 #define V4L2_CID_MPEG_VIDEO_REF_NUMBER_FOR_PFRAMES	(V4L2_CID_CODEC_BASE + 643)
819 #define V4L2_CID_MPEG_VIDEO_PREPEND_SPSPPS_TO_IDR	(V4L2_CID_CODEC_BASE + 644)
820 #define V4L2_CID_MPEG_VIDEO_CONSTANT_QUALITY		(V4L2_CID_CODEC_BASE + 645)
821 #define V4L2_CID_MPEG_VIDEO_FRAME_SKIP_MODE		(V4L2_CID_CODEC_BASE + 646)
822 enum v4l2_mpeg_video_frame_skip_mode {
823 	V4L2_MPEG_VIDEO_FRAME_SKIP_MODE_DISABLED	= 0,
824 	V4L2_MPEG_VIDEO_FRAME_SKIP_MODE_LEVEL_LIMIT	= 1,
825 	V4L2_MPEG_VIDEO_FRAME_SKIP_MODE_BUF_LIMIT	= 2,
826 };
827 
828 #define V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_MIN_QP        (V4L2_CID_CODEC_BASE + 647)
829 #define V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_MAX_QP        (V4L2_CID_CODEC_BASE + 648)
830 #define V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_MIN_QP        (V4L2_CID_CODEC_BASE + 649)
831 #define V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_MAX_QP        (V4L2_CID_CODEC_BASE + 650)
832 #define V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_MIN_QP        (V4L2_CID_CODEC_BASE + 651)
833 #define V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_MAX_QP        (V4L2_CID_CODEC_BASE + 652)
834 
835 #define V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY		(V4L2_CID_CODEC_BASE + 653)
836 #define V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY_ENABLE	(V4L2_CID_CODEC_BASE + 654)
837 
838 #define V4L2_CID_MPEG_VIDEO_AV1_PROFILE (V4L2_CID_CODEC_BASE + 655)
839 /**
840  * enum v4l2_mpeg_video_av1_profile - AV1 profiles
841  *
842  * @V4L2_MPEG_VIDEO_AV1_PROFILE_MAIN: compliant decoders must be able to decode
843  * streams with seq_profile equal to 0.
844  * @V4L2_MPEG_VIDEO_AV1_PROFILE_HIGH: compliant decoders must be able to decode
845  * streams with seq_profile equal less than or equal to 1.
846  * @V4L2_MPEG_VIDEO_AV1_PROFILE_PROFESSIONAL: compliant decoders must be able to
847  * decode streams with seq_profile less than or equal to 2.
848  *
849  * Conveys the highest profile a decoder can work with.
850  */
851 enum v4l2_mpeg_video_av1_profile {
852 	V4L2_MPEG_VIDEO_AV1_PROFILE_MAIN = 0,
853 	V4L2_MPEG_VIDEO_AV1_PROFILE_HIGH = 1,
854 	V4L2_MPEG_VIDEO_AV1_PROFILE_PROFESSIONAL = 2,
855 };
856 
857 #define V4L2_CID_MPEG_VIDEO_AV1_LEVEL (V4L2_CID_CODEC_BASE + 656)
858 /**
859  * enum v4l2_mpeg_video_av1_level - AV1 levels
860  *
861  * @V4L2_MPEG_VIDEO_AV1_LEVEL_2_0: Level 2.0.
862  * @V4L2_MPEG_VIDEO_AV1_LEVEL_2_1: Level 2.1.
863  * @V4L2_MPEG_VIDEO_AV1_LEVEL_2_2: Level 2.2.
864  * @V4L2_MPEG_VIDEO_AV1_LEVEL_2_3: Level 2.3.
865  * @V4L2_MPEG_VIDEO_AV1_LEVEL_3_0: Level 3.0.
866  * @V4L2_MPEG_VIDEO_AV1_LEVEL_3_1: Level 3.1.
867  * @V4L2_MPEG_VIDEO_AV1_LEVEL_3_2: Level 3.2.
868  * @V4L2_MPEG_VIDEO_AV1_LEVEL_3_3: Level 3.3.
869  * @V4L2_MPEG_VIDEO_AV1_LEVEL_4_0: Level 4.0.
870  * @V4L2_MPEG_VIDEO_AV1_LEVEL_4_1: Level 4.1.
871  * @V4L2_MPEG_VIDEO_AV1_LEVEL_4_2: Level 4.2.
872  * @V4L2_MPEG_VIDEO_AV1_LEVEL_4_3: Level 4.3.
873  * @V4L2_MPEG_VIDEO_AV1_LEVEL_5_0: Level 5.0.
874  * @V4L2_MPEG_VIDEO_AV1_LEVEL_5_1: Level 5.1.
875  * @V4L2_MPEG_VIDEO_AV1_LEVEL_5_2: Level 5.2.
876  * @V4L2_MPEG_VIDEO_AV1_LEVEL_5_3: Level 5.3.
877  * @V4L2_MPEG_VIDEO_AV1_LEVEL_6_0: Level 6.0.
878  * @V4L2_MPEG_VIDEO_AV1_LEVEL_6_1: Level 6.1.
879  * @V4L2_MPEG_VIDEO_AV1_LEVEL_6_2: Level 6.2.
880  * @V4L2_MPEG_VIDEO_AV1_LEVEL_6_3: Level 6.3.
881  * @V4L2_MPEG_VIDEO_AV1_LEVEL_7_0: Level 7.0.
882  * @V4L2_MPEG_VIDEO_AV1_LEVEL_7_1: Level 7.1.
883  * @V4L2_MPEG_VIDEO_AV1_LEVEL_7_2: Level 7.2.
884  * @V4L2_MPEG_VIDEO_AV1_LEVEL_7_3: Level 7.3.
885  *
886  * Conveys the highest level a decoder can work with.
887  */
888 enum v4l2_mpeg_video_av1_level {
889 	V4L2_MPEG_VIDEO_AV1_LEVEL_2_0 = 0,
890 	V4L2_MPEG_VIDEO_AV1_LEVEL_2_1 = 1,
891 	V4L2_MPEG_VIDEO_AV1_LEVEL_2_2 = 2,
892 	V4L2_MPEG_VIDEO_AV1_LEVEL_2_3 = 3,
893 
894 	V4L2_MPEG_VIDEO_AV1_LEVEL_3_0 = 4,
895 	V4L2_MPEG_VIDEO_AV1_LEVEL_3_1 = 5,
896 	V4L2_MPEG_VIDEO_AV1_LEVEL_3_2 = 6,
897 	V4L2_MPEG_VIDEO_AV1_LEVEL_3_3 = 7,
898 
899 	V4L2_MPEG_VIDEO_AV1_LEVEL_4_0 = 8,
900 	V4L2_MPEG_VIDEO_AV1_LEVEL_4_1 = 9,
901 	V4L2_MPEG_VIDEO_AV1_LEVEL_4_2 = 10,
902 	V4L2_MPEG_VIDEO_AV1_LEVEL_4_3 = 11,
903 
904 	V4L2_MPEG_VIDEO_AV1_LEVEL_5_0 = 12,
905 	V4L2_MPEG_VIDEO_AV1_LEVEL_5_1 = 13,
906 	V4L2_MPEG_VIDEO_AV1_LEVEL_5_2 = 14,
907 	V4L2_MPEG_VIDEO_AV1_LEVEL_5_3 = 15,
908 
909 	V4L2_MPEG_VIDEO_AV1_LEVEL_6_0 = 16,
910 	V4L2_MPEG_VIDEO_AV1_LEVEL_6_1 = 17,
911 	V4L2_MPEG_VIDEO_AV1_LEVEL_6_2 = 18,
912 	V4L2_MPEG_VIDEO_AV1_LEVEL_6_3 = 19,
913 
914 	V4L2_MPEG_VIDEO_AV1_LEVEL_7_0 = 20,
915 	V4L2_MPEG_VIDEO_AV1_LEVEL_7_1 = 21,
916 	V4L2_MPEG_VIDEO_AV1_LEVEL_7_2 = 22,
917 	V4L2_MPEG_VIDEO_AV1_LEVEL_7_3 = 23
918 };
919 
920 #define V4L2_CID_MPEG_VIDEO_AVERAGE_QP  (V4L2_CID_CODEC_BASE + 657)
921 
922 /*  MPEG-class control IDs specific to the CX2341x driver as defined by V4L2 */
923 #define V4L2_CID_CODEC_CX2341X_BASE				(V4L2_CTRL_CLASS_CODEC | 0x1000)
924 #define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE		(V4L2_CID_CODEC_CX2341X_BASE+0)
925 enum v4l2_mpeg_cx2341x_video_spatial_filter_mode {
926 	V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_MANUAL = 0,
927 	V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_AUTO   = 1,
928 };
929 #define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER		(V4L2_CID_CODEC_CX2341X_BASE+1)
930 #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE	(V4L2_CID_CODEC_CX2341X_BASE+2)
931 enum v4l2_mpeg_cx2341x_video_luma_spatial_filter_type {
932 	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_OFF                  = 0,
933 	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_HOR               = 1,
934 	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_VERT              = 2,
935 	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_HV_SEPARABLE      = 3,
936 	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_SYM_NON_SEPARABLE = 4,
937 };
938 #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE	(V4L2_CID_CODEC_CX2341X_BASE+3)
939 enum v4l2_mpeg_cx2341x_video_chroma_spatial_filter_type {
940 	V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_OFF    = 0,
941 	V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_1D_HOR = 1,
942 };
943 #define V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE	(V4L2_CID_CODEC_CX2341X_BASE+4)
944 enum v4l2_mpeg_cx2341x_video_temporal_filter_mode {
945 	V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_MANUAL = 0,
946 	V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_AUTO   = 1,
947 };
948 #define V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER		(V4L2_CID_CODEC_CX2341X_BASE+5)
949 #define V4L2_CID_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE		(V4L2_CID_CODEC_CX2341X_BASE+6)
950 enum v4l2_mpeg_cx2341x_video_median_filter_type {
951 	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_OFF      = 0,
952 	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR      = 1,
953 	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_VERT     = 2,
954 	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR_VERT = 3,
955 	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_DIAG     = 4,
956 };
957 #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_BOTTOM	(V4L2_CID_CODEC_CX2341X_BASE+7)
958 #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_TOP	(V4L2_CID_CODEC_CX2341X_BASE+8)
959 #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_BOTTOM	(V4L2_CID_CODEC_CX2341X_BASE+9)
960 #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_TOP	(V4L2_CID_CODEC_CX2341X_BASE+10)
961 #define V4L2_CID_MPEG_CX2341X_STREAM_INSERT_NAV_PACKETS		(V4L2_CID_CODEC_CX2341X_BASE+11)
962 
963 /*  MPEG-class control IDs specific to the Samsung MFC 5.1 driver as defined by V4L2 */
964 #define V4L2_CID_CODEC_MFC51_BASE				(V4L2_CTRL_CLASS_CODEC | 0x1100)
965 
966 #define V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY		(V4L2_CID_CODEC_MFC51_BASE+0)
967 #define V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY_ENABLE	(V4L2_CID_CODEC_MFC51_BASE+1)
968 #define V4L2_CID_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE			(V4L2_CID_CODEC_MFC51_BASE+2)
969 enum v4l2_mpeg_mfc51_video_frame_skip_mode {
970 	V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_DISABLED		= 0,
971 	V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_LEVEL_LIMIT	= 1,
972 	V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_BUF_LIMIT		= 2,
973 };
974 #define V4L2_CID_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE			(V4L2_CID_CODEC_MFC51_BASE+3)
975 enum v4l2_mpeg_mfc51_video_force_frame_type {
976 	V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_DISABLED		= 0,
977 	V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_I_FRAME		= 1,
978 	V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_NOT_CODED	= 2,
979 };
980 #define V4L2_CID_MPEG_MFC51_VIDEO_PADDING				(V4L2_CID_CODEC_MFC51_BASE+4)
981 #define V4L2_CID_MPEG_MFC51_VIDEO_PADDING_YUV				(V4L2_CID_CODEC_MFC51_BASE+5)
982 #define V4L2_CID_MPEG_MFC51_VIDEO_RC_FIXED_TARGET_BIT			(V4L2_CID_CODEC_MFC51_BASE+6)
983 #define V4L2_CID_MPEG_MFC51_VIDEO_RC_REACTION_COEFF			(V4L2_CID_CODEC_MFC51_BASE+7)
984 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_ACTIVITY		(V4L2_CID_CODEC_MFC51_BASE+50)
985 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_DARK			(V4L2_CID_CODEC_MFC51_BASE+51)
986 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_SMOOTH		(V4L2_CID_CODEC_MFC51_BASE+52)
987 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_STATIC		(V4L2_CID_CODEC_MFC51_BASE+53)
988 #define V4L2_CID_MPEG_MFC51_VIDEO_H264_NUM_REF_PIC_FOR_P		(V4L2_CID_CODEC_MFC51_BASE+54)
989 
990 /*  Camera class control IDs */
991 
992 #define V4L2_CID_CAMERA_CLASS_BASE	(V4L2_CTRL_CLASS_CAMERA | 0x900)
993 #define V4L2_CID_CAMERA_CLASS		(V4L2_CTRL_CLASS_CAMERA | 1)
994 
995 #define V4L2_CID_EXPOSURE_AUTO			(V4L2_CID_CAMERA_CLASS_BASE+1)
996 enum  v4l2_exposure_auto_type {
997 	V4L2_EXPOSURE_AUTO = 0,
998 	V4L2_EXPOSURE_MANUAL = 1,
999 	V4L2_EXPOSURE_SHUTTER_PRIORITY = 2,
1000 	V4L2_EXPOSURE_APERTURE_PRIORITY = 3
1001 };
1002 #define V4L2_CID_EXPOSURE_ABSOLUTE		(V4L2_CID_CAMERA_CLASS_BASE+2)
1003 #define V4L2_CID_EXPOSURE_AUTO_PRIORITY		(V4L2_CID_CAMERA_CLASS_BASE+3)
1004 
1005 #define V4L2_CID_PAN_RELATIVE			(V4L2_CID_CAMERA_CLASS_BASE+4)
1006 #define V4L2_CID_TILT_RELATIVE			(V4L2_CID_CAMERA_CLASS_BASE+5)
1007 #define V4L2_CID_PAN_RESET			(V4L2_CID_CAMERA_CLASS_BASE+6)
1008 #define V4L2_CID_TILT_RESET			(V4L2_CID_CAMERA_CLASS_BASE+7)
1009 
1010 #define V4L2_CID_PAN_ABSOLUTE			(V4L2_CID_CAMERA_CLASS_BASE+8)
1011 #define V4L2_CID_TILT_ABSOLUTE			(V4L2_CID_CAMERA_CLASS_BASE+9)
1012 
1013 #define V4L2_CID_FOCUS_ABSOLUTE			(V4L2_CID_CAMERA_CLASS_BASE+10)
1014 #define V4L2_CID_FOCUS_RELATIVE			(V4L2_CID_CAMERA_CLASS_BASE+11)
1015 #define V4L2_CID_FOCUS_AUTO			(V4L2_CID_CAMERA_CLASS_BASE+12)
1016 
1017 #define V4L2_CID_ZOOM_ABSOLUTE			(V4L2_CID_CAMERA_CLASS_BASE+13)
1018 #define V4L2_CID_ZOOM_RELATIVE			(V4L2_CID_CAMERA_CLASS_BASE+14)
1019 #define V4L2_CID_ZOOM_CONTINUOUS		(V4L2_CID_CAMERA_CLASS_BASE+15)
1020 
1021 #define V4L2_CID_PRIVACY			(V4L2_CID_CAMERA_CLASS_BASE+16)
1022 
1023 #define V4L2_CID_IRIS_ABSOLUTE			(V4L2_CID_CAMERA_CLASS_BASE+17)
1024 #define V4L2_CID_IRIS_RELATIVE			(V4L2_CID_CAMERA_CLASS_BASE+18)
1025 
1026 #define V4L2_CID_AUTO_EXPOSURE_BIAS		(V4L2_CID_CAMERA_CLASS_BASE+19)
1027 
1028 #define V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE	(V4L2_CID_CAMERA_CLASS_BASE+20)
1029 enum v4l2_auto_n_preset_white_balance {
1030 	V4L2_WHITE_BALANCE_MANUAL		= 0,
1031 	V4L2_WHITE_BALANCE_AUTO			= 1,
1032 	V4L2_WHITE_BALANCE_INCANDESCENT		= 2,
1033 	V4L2_WHITE_BALANCE_FLUORESCENT		= 3,
1034 	V4L2_WHITE_BALANCE_FLUORESCENT_H	= 4,
1035 	V4L2_WHITE_BALANCE_HORIZON		= 5,
1036 	V4L2_WHITE_BALANCE_DAYLIGHT		= 6,
1037 	V4L2_WHITE_BALANCE_FLASH		= 7,
1038 	V4L2_WHITE_BALANCE_CLOUDY		= 8,
1039 	V4L2_WHITE_BALANCE_SHADE		= 9,
1040 };
1041 
1042 #define V4L2_CID_WIDE_DYNAMIC_RANGE		(V4L2_CID_CAMERA_CLASS_BASE+21)
1043 #define V4L2_CID_IMAGE_STABILIZATION		(V4L2_CID_CAMERA_CLASS_BASE+22)
1044 
1045 #define V4L2_CID_ISO_SENSITIVITY		(V4L2_CID_CAMERA_CLASS_BASE+23)
1046 #define V4L2_CID_ISO_SENSITIVITY_AUTO		(V4L2_CID_CAMERA_CLASS_BASE+24)
1047 enum v4l2_iso_sensitivity_auto_type {
1048 	V4L2_ISO_SENSITIVITY_MANUAL		= 0,
1049 	V4L2_ISO_SENSITIVITY_AUTO		= 1,
1050 };
1051 
1052 #define V4L2_CID_EXPOSURE_METERING		(V4L2_CID_CAMERA_CLASS_BASE+25)
1053 enum v4l2_exposure_metering {
1054 	V4L2_EXPOSURE_METERING_AVERAGE		= 0,
1055 	V4L2_EXPOSURE_METERING_CENTER_WEIGHTED	= 1,
1056 	V4L2_EXPOSURE_METERING_SPOT		= 2,
1057 	V4L2_EXPOSURE_METERING_MATRIX		= 3,
1058 };
1059 
1060 #define V4L2_CID_SCENE_MODE			(V4L2_CID_CAMERA_CLASS_BASE+26)
1061 enum v4l2_scene_mode {
1062 	V4L2_SCENE_MODE_NONE			= 0,
1063 	V4L2_SCENE_MODE_BACKLIGHT		= 1,
1064 	V4L2_SCENE_MODE_BEACH_SNOW		= 2,
1065 	V4L2_SCENE_MODE_CANDLE_LIGHT		= 3,
1066 	V4L2_SCENE_MODE_DAWN_DUSK		= 4,
1067 	V4L2_SCENE_MODE_FALL_COLORS		= 5,
1068 	V4L2_SCENE_MODE_FIREWORKS		= 6,
1069 	V4L2_SCENE_MODE_LANDSCAPE		= 7,
1070 	V4L2_SCENE_MODE_NIGHT			= 8,
1071 	V4L2_SCENE_MODE_PARTY_INDOOR		= 9,
1072 	V4L2_SCENE_MODE_PORTRAIT		= 10,
1073 	V4L2_SCENE_MODE_SPORTS			= 11,
1074 	V4L2_SCENE_MODE_SUNSET			= 12,
1075 	V4L2_SCENE_MODE_TEXT			= 13,
1076 };
1077 
1078 #define V4L2_CID_3A_LOCK			(V4L2_CID_CAMERA_CLASS_BASE+27)
1079 #define V4L2_LOCK_EXPOSURE			(1 << 0)
1080 #define V4L2_LOCK_WHITE_BALANCE			(1 << 1)
1081 #define V4L2_LOCK_FOCUS				(1 << 2)
1082 
1083 #define V4L2_CID_AUTO_FOCUS_START		(V4L2_CID_CAMERA_CLASS_BASE+28)
1084 #define V4L2_CID_AUTO_FOCUS_STOP		(V4L2_CID_CAMERA_CLASS_BASE+29)
1085 #define V4L2_CID_AUTO_FOCUS_STATUS		(V4L2_CID_CAMERA_CLASS_BASE+30)
1086 #define V4L2_AUTO_FOCUS_STATUS_IDLE		(0 << 0)
1087 #define V4L2_AUTO_FOCUS_STATUS_BUSY		(1 << 0)
1088 #define V4L2_AUTO_FOCUS_STATUS_REACHED		(1 << 1)
1089 #define V4L2_AUTO_FOCUS_STATUS_FAILED		(1 << 2)
1090 
1091 #define V4L2_CID_AUTO_FOCUS_RANGE		(V4L2_CID_CAMERA_CLASS_BASE+31)
1092 enum v4l2_auto_focus_range {
1093 	V4L2_AUTO_FOCUS_RANGE_AUTO		= 0,
1094 	V4L2_AUTO_FOCUS_RANGE_NORMAL		= 1,
1095 	V4L2_AUTO_FOCUS_RANGE_MACRO		= 2,
1096 	V4L2_AUTO_FOCUS_RANGE_INFINITY		= 3,
1097 };
1098 
1099 #define V4L2_CID_PAN_SPEED			(V4L2_CID_CAMERA_CLASS_BASE+32)
1100 #define V4L2_CID_TILT_SPEED			(V4L2_CID_CAMERA_CLASS_BASE+33)
1101 
1102 #define V4L2_CID_CAMERA_ORIENTATION		(V4L2_CID_CAMERA_CLASS_BASE+34)
1103 #define V4L2_CAMERA_ORIENTATION_FRONT		0
1104 #define V4L2_CAMERA_ORIENTATION_BACK		1
1105 #define V4L2_CAMERA_ORIENTATION_EXTERNAL	2
1106 
1107 #define V4L2_CID_CAMERA_SENSOR_ROTATION		(V4L2_CID_CAMERA_CLASS_BASE+35)
1108 
1109 #define V4L2_CID_HDR_SENSOR_MODE		(V4L2_CID_CAMERA_CLASS_BASE+36)
1110 
1111 /* FM Modulator class control IDs */
1112 
1113 #define V4L2_CID_FM_TX_CLASS_BASE		(V4L2_CTRL_CLASS_FM_TX | 0x900)
1114 #define V4L2_CID_FM_TX_CLASS			(V4L2_CTRL_CLASS_FM_TX | 1)
1115 
1116 #define V4L2_CID_RDS_TX_DEVIATION		(V4L2_CID_FM_TX_CLASS_BASE + 1)
1117 #define V4L2_CID_RDS_TX_PI			(V4L2_CID_FM_TX_CLASS_BASE + 2)
1118 #define V4L2_CID_RDS_TX_PTY			(V4L2_CID_FM_TX_CLASS_BASE + 3)
1119 #define V4L2_CID_RDS_TX_PS_NAME			(V4L2_CID_FM_TX_CLASS_BASE + 5)
1120 #define V4L2_CID_RDS_TX_RADIO_TEXT		(V4L2_CID_FM_TX_CLASS_BASE + 6)
1121 #define V4L2_CID_RDS_TX_MONO_STEREO		(V4L2_CID_FM_TX_CLASS_BASE + 7)
1122 #define V4L2_CID_RDS_TX_ARTIFICIAL_HEAD		(V4L2_CID_FM_TX_CLASS_BASE + 8)
1123 #define V4L2_CID_RDS_TX_COMPRESSED		(V4L2_CID_FM_TX_CLASS_BASE + 9)
1124 #define V4L2_CID_RDS_TX_DYNAMIC_PTY		(V4L2_CID_FM_TX_CLASS_BASE + 10)
1125 #define V4L2_CID_RDS_TX_TRAFFIC_ANNOUNCEMENT	(V4L2_CID_FM_TX_CLASS_BASE + 11)
1126 #define V4L2_CID_RDS_TX_TRAFFIC_PROGRAM		(V4L2_CID_FM_TX_CLASS_BASE + 12)
1127 #define V4L2_CID_RDS_TX_MUSIC_SPEECH		(V4L2_CID_FM_TX_CLASS_BASE + 13)
1128 #define V4L2_CID_RDS_TX_ALT_FREQS_ENABLE	(V4L2_CID_FM_TX_CLASS_BASE + 14)
1129 #define V4L2_CID_RDS_TX_ALT_FREQS		(V4L2_CID_FM_TX_CLASS_BASE + 15)
1130 
1131 #define V4L2_CID_AUDIO_LIMITER_ENABLED		(V4L2_CID_FM_TX_CLASS_BASE + 64)
1132 #define V4L2_CID_AUDIO_LIMITER_RELEASE_TIME	(V4L2_CID_FM_TX_CLASS_BASE + 65)
1133 #define V4L2_CID_AUDIO_LIMITER_DEVIATION	(V4L2_CID_FM_TX_CLASS_BASE + 66)
1134 
1135 #define V4L2_CID_AUDIO_COMPRESSION_ENABLED	(V4L2_CID_FM_TX_CLASS_BASE + 80)
1136 #define V4L2_CID_AUDIO_COMPRESSION_GAIN		(V4L2_CID_FM_TX_CLASS_BASE + 81)
1137 #define V4L2_CID_AUDIO_COMPRESSION_THRESHOLD	(V4L2_CID_FM_TX_CLASS_BASE + 82)
1138 #define V4L2_CID_AUDIO_COMPRESSION_ATTACK_TIME	(V4L2_CID_FM_TX_CLASS_BASE + 83)
1139 #define V4L2_CID_AUDIO_COMPRESSION_RELEASE_TIME	(V4L2_CID_FM_TX_CLASS_BASE + 84)
1140 
1141 #define V4L2_CID_PILOT_TONE_ENABLED		(V4L2_CID_FM_TX_CLASS_BASE + 96)
1142 #define V4L2_CID_PILOT_TONE_DEVIATION		(V4L2_CID_FM_TX_CLASS_BASE + 97)
1143 #define V4L2_CID_PILOT_TONE_FREQUENCY		(V4L2_CID_FM_TX_CLASS_BASE + 98)
1144 
1145 #define V4L2_CID_TUNE_PREEMPHASIS		(V4L2_CID_FM_TX_CLASS_BASE + 112)
1146 enum v4l2_preemphasis {
1147 	V4L2_PREEMPHASIS_DISABLED	= 0,
1148 	V4L2_PREEMPHASIS_50_uS		= 1,
1149 	V4L2_PREEMPHASIS_75_uS		= 2,
1150 };
1151 #define V4L2_CID_TUNE_POWER_LEVEL		(V4L2_CID_FM_TX_CLASS_BASE + 113)
1152 #define V4L2_CID_TUNE_ANTENNA_CAPACITOR		(V4L2_CID_FM_TX_CLASS_BASE + 114)
1153 
1154 
1155 /* Flash and privacy (indicator) light controls */
1156 
1157 #define V4L2_CID_FLASH_CLASS_BASE		(V4L2_CTRL_CLASS_FLASH | 0x900)
1158 #define V4L2_CID_FLASH_CLASS			(V4L2_CTRL_CLASS_FLASH | 1)
1159 
1160 #define V4L2_CID_FLASH_LED_MODE			(V4L2_CID_FLASH_CLASS_BASE + 1)
1161 enum v4l2_flash_led_mode {
1162 	V4L2_FLASH_LED_MODE_NONE,
1163 	V4L2_FLASH_LED_MODE_FLASH,
1164 	V4L2_FLASH_LED_MODE_TORCH,
1165 };
1166 
1167 #define V4L2_CID_FLASH_STROBE_SOURCE		(V4L2_CID_FLASH_CLASS_BASE + 2)
1168 enum v4l2_flash_strobe_source {
1169 	V4L2_FLASH_STROBE_SOURCE_SOFTWARE,
1170 	V4L2_FLASH_STROBE_SOURCE_EXTERNAL,
1171 };
1172 
1173 #define V4L2_CID_FLASH_STROBE			(V4L2_CID_FLASH_CLASS_BASE + 3)
1174 #define V4L2_CID_FLASH_STROBE_STOP		(V4L2_CID_FLASH_CLASS_BASE + 4)
1175 #define V4L2_CID_FLASH_STROBE_STATUS		(V4L2_CID_FLASH_CLASS_BASE + 5)
1176 
1177 #define V4L2_CID_FLASH_TIMEOUT			(V4L2_CID_FLASH_CLASS_BASE + 6)
1178 #define V4L2_CID_FLASH_INTENSITY		(V4L2_CID_FLASH_CLASS_BASE + 7)
1179 #define V4L2_CID_FLASH_TORCH_INTENSITY		(V4L2_CID_FLASH_CLASS_BASE + 8)
1180 #define V4L2_CID_FLASH_INDICATOR_INTENSITY	(V4L2_CID_FLASH_CLASS_BASE + 9)
1181 
1182 #define V4L2_CID_FLASH_FAULT			(V4L2_CID_FLASH_CLASS_BASE + 10)
1183 #define V4L2_FLASH_FAULT_OVER_VOLTAGE		(1 << 0)
1184 #define V4L2_FLASH_FAULT_TIMEOUT		(1 << 1)
1185 #define V4L2_FLASH_FAULT_OVER_TEMPERATURE	(1 << 2)
1186 #define V4L2_FLASH_FAULT_SHORT_CIRCUIT		(1 << 3)
1187 #define V4L2_FLASH_FAULT_OVER_CURRENT		(1 << 4)
1188 #define V4L2_FLASH_FAULT_INDICATOR		(1 << 5)
1189 #define V4L2_FLASH_FAULT_UNDER_VOLTAGE		(1 << 6)
1190 #define V4L2_FLASH_FAULT_INPUT_VOLTAGE		(1 << 7)
1191 #define V4L2_FLASH_FAULT_LED_OVER_TEMPERATURE	(1 << 8)
1192 
1193 #define V4L2_CID_FLASH_CHARGE			(V4L2_CID_FLASH_CLASS_BASE + 11)
1194 #define V4L2_CID_FLASH_READY			(V4L2_CID_FLASH_CLASS_BASE + 12)
1195 #define V4L2_CID_FLASH_DURATION			(V4L2_CID_FLASH_CLASS_BASE + 13)
1196 #define V4L2_CID_FLASH_STROBE_OE		(V4L2_CID_FLASH_CLASS_BASE + 14)
1197 
1198 
1199 /* JPEG-class control IDs */
1200 
1201 #define V4L2_CID_JPEG_CLASS_BASE		(V4L2_CTRL_CLASS_JPEG | 0x900)
1202 #define V4L2_CID_JPEG_CLASS			(V4L2_CTRL_CLASS_JPEG | 1)
1203 
1204 #define V4L2_CID_JPEG_CHROMA_SUBSAMPLING	(V4L2_CID_JPEG_CLASS_BASE + 1)
1205 enum v4l2_jpeg_chroma_subsampling {
1206 	V4L2_JPEG_CHROMA_SUBSAMPLING_444	= 0,
1207 	V4L2_JPEG_CHROMA_SUBSAMPLING_422	= 1,
1208 	V4L2_JPEG_CHROMA_SUBSAMPLING_420	= 2,
1209 	V4L2_JPEG_CHROMA_SUBSAMPLING_411	= 3,
1210 	V4L2_JPEG_CHROMA_SUBSAMPLING_410	= 4,
1211 	V4L2_JPEG_CHROMA_SUBSAMPLING_GRAY	= 5,
1212 };
1213 #define V4L2_CID_JPEG_RESTART_INTERVAL		(V4L2_CID_JPEG_CLASS_BASE + 2)
1214 #define V4L2_CID_JPEG_COMPRESSION_QUALITY	(V4L2_CID_JPEG_CLASS_BASE + 3)
1215 
1216 #define V4L2_CID_JPEG_ACTIVE_MARKER		(V4L2_CID_JPEG_CLASS_BASE + 4)
1217 #define V4L2_JPEG_ACTIVE_MARKER_APP0		(1 << 0)
1218 #define V4L2_JPEG_ACTIVE_MARKER_APP1		(1 << 1)
1219 #define V4L2_JPEG_ACTIVE_MARKER_COM		(1 << 16)
1220 #define V4L2_JPEG_ACTIVE_MARKER_DQT		(1 << 17)
1221 #define V4L2_JPEG_ACTIVE_MARKER_DHT		(1 << 18)
1222 
1223 
1224 /* Image source controls */
1225 #define V4L2_CID_IMAGE_SOURCE_CLASS_BASE	(V4L2_CTRL_CLASS_IMAGE_SOURCE | 0x900)
1226 #define V4L2_CID_IMAGE_SOURCE_CLASS		(V4L2_CTRL_CLASS_IMAGE_SOURCE | 1)
1227 
1228 #define V4L2_CID_VBLANK				(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 1)
1229 #define V4L2_CID_HBLANK				(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 2)
1230 #define V4L2_CID_ANALOGUE_GAIN			(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 3)
1231 #define V4L2_CID_TEST_PATTERN_RED		(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 4)
1232 #define V4L2_CID_TEST_PATTERN_GREENR		(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 5)
1233 #define V4L2_CID_TEST_PATTERN_BLUE		(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 6)
1234 #define V4L2_CID_TEST_PATTERN_GREENB		(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 7)
1235 #define V4L2_CID_UNIT_CELL_SIZE			(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 8)
1236 #define V4L2_CID_NOTIFY_GAINS			(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 9)
1237 
1238 
1239 /* Image processing controls */
1240 
1241 #define V4L2_CID_IMAGE_PROC_CLASS_BASE		(V4L2_CTRL_CLASS_IMAGE_PROC | 0x900)
1242 #define V4L2_CID_IMAGE_PROC_CLASS		(V4L2_CTRL_CLASS_IMAGE_PROC | 1)
1243 
1244 #define V4L2_CID_LINK_FREQ			(V4L2_CID_IMAGE_PROC_CLASS_BASE + 1)
1245 #define V4L2_CID_PIXEL_RATE			(V4L2_CID_IMAGE_PROC_CLASS_BASE + 2)
1246 #define V4L2_CID_TEST_PATTERN			(V4L2_CID_IMAGE_PROC_CLASS_BASE + 3)
1247 #define V4L2_CID_DEINTERLACING_MODE		(V4L2_CID_IMAGE_PROC_CLASS_BASE + 4)
1248 #define V4L2_CID_DIGITAL_GAIN			(V4L2_CID_IMAGE_PROC_CLASS_BASE + 5)
1249 
1250 /*  DV-class control IDs defined by V4L2 */
1251 #define V4L2_CID_DV_CLASS_BASE			(V4L2_CTRL_CLASS_DV | 0x900)
1252 #define V4L2_CID_DV_CLASS			(V4L2_CTRL_CLASS_DV | 1)
1253 
1254 #define V4L2_CID_DV_TX_HOTPLUG			(V4L2_CID_DV_CLASS_BASE + 1)
1255 #define V4L2_CID_DV_TX_RXSENSE			(V4L2_CID_DV_CLASS_BASE + 2)
1256 #define V4L2_CID_DV_TX_EDID_PRESENT		(V4L2_CID_DV_CLASS_BASE + 3)
1257 #define V4L2_CID_DV_TX_MODE			(V4L2_CID_DV_CLASS_BASE + 4)
1258 enum v4l2_dv_tx_mode {
1259 	V4L2_DV_TX_MODE_DVI_D	= 0,
1260 	V4L2_DV_TX_MODE_HDMI	= 1,
1261 };
1262 #define V4L2_CID_DV_TX_RGB_RANGE		(V4L2_CID_DV_CLASS_BASE + 5)
1263 enum v4l2_dv_rgb_range {
1264 	V4L2_DV_RGB_RANGE_AUTO	  = 0,
1265 	V4L2_DV_RGB_RANGE_LIMITED = 1,
1266 	V4L2_DV_RGB_RANGE_FULL	  = 2,
1267 };
1268 
1269 #define V4L2_CID_DV_TX_IT_CONTENT_TYPE		(V4L2_CID_DV_CLASS_BASE + 6)
1270 enum v4l2_dv_it_content_type {
1271 	V4L2_DV_IT_CONTENT_TYPE_GRAPHICS  = 0,
1272 	V4L2_DV_IT_CONTENT_TYPE_PHOTO	  = 1,
1273 	V4L2_DV_IT_CONTENT_TYPE_CINEMA	  = 2,
1274 	V4L2_DV_IT_CONTENT_TYPE_GAME	  = 3,
1275 	V4L2_DV_IT_CONTENT_TYPE_NO_ITC	  = 4,
1276 };
1277 
1278 #define V4L2_CID_DV_RX_POWER_PRESENT		(V4L2_CID_DV_CLASS_BASE + 100)
1279 #define V4L2_CID_DV_RX_RGB_RANGE		(V4L2_CID_DV_CLASS_BASE + 101)
1280 #define V4L2_CID_DV_RX_IT_CONTENT_TYPE		(V4L2_CID_DV_CLASS_BASE + 102)
1281 
1282 #define V4L2_CID_FM_RX_CLASS_BASE		(V4L2_CTRL_CLASS_FM_RX | 0x900)
1283 #define V4L2_CID_FM_RX_CLASS			(V4L2_CTRL_CLASS_FM_RX | 1)
1284 
1285 #define V4L2_CID_TUNE_DEEMPHASIS		(V4L2_CID_FM_RX_CLASS_BASE + 1)
1286 enum v4l2_deemphasis {
1287 	V4L2_DEEMPHASIS_DISABLED	= V4L2_PREEMPHASIS_DISABLED,
1288 	V4L2_DEEMPHASIS_50_uS		= V4L2_PREEMPHASIS_50_uS,
1289 	V4L2_DEEMPHASIS_75_uS		= V4L2_PREEMPHASIS_75_uS,
1290 };
1291 
1292 #define V4L2_CID_RDS_RECEPTION			(V4L2_CID_FM_RX_CLASS_BASE + 2)
1293 #define V4L2_CID_RDS_RX_PTY			(V4L2_CID_FM_RX_CLASS_BASE + 3)
1294 #define V4L2_CID_RDS_RX_PS_NAME			(V4L2_CID_FM_RX_CLASS_BASE + 4)
1295 #define V4L2_CID_RDS_RX_RADIO_TEXT		(V4L2_CID_FM_RX_CLASS_BASE + 5)
1296 #define V4L2_CID_RDS_RX_TRAFFIC_ANNOUNCEMENT	(V4L2_CID_FM_RX_CLASS_BASE + 6)
1297 #define V4L2_CID_RDS_RX_TRAFFIC_PROGRAM		(V4L2_CID_FM_RX_CLASS_BASE + 7)
1298 #define V4L2_CID_RDS_RX_MUSIC_SPEECH		(V4L2_CID_FM_RX_CLASS_BASE + 8)
1299 
1300 #define V4L2_CID_RF_TUNER_CLASS_BASE		(V4L2_CTRL_CLASS_RF_TUNER | 0x900)
1301 #define V4L2_CID_RF_TUNER_CLASS			(V4L2_CTRL_CLASS_RF_TUNER | 1)
1302 
1303 #define V4L2_CID_RF_TUNER_BANDWIDTH_AUTO	(V4L2_CID_RF_TUNER_CLASS_BASE + 11)
1304 #define V4L2_CID_RF_TUNER_BANDWIDTH		(V4L2_CID_RF_TUNER_CLASS_BASE + 12)
1305 #define V4L2_CID_RF_TUNER_RF_GAIN		(V4L2_CID_RF_TUNER_CLASS_BASE + 32)
1306 #define V4L2_CID_RF_TUNER_LNA_GAIN_AUTO		(V4L2_CID_RF_TUNER_CLASS_BASE + 41)
1307 #define V4L2_CID_RF_TUNER_LNA_GAIN		(V4L2_CID_RF_TUNER_CLASS_BASE + 42)
1308 #define V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO	(V4L2_CID_RF_TUNER_CLASS_BASE + 51)
1309 #define V4L2_CID_RF_TUNER_MIXER_GAIN		(V4L2_CID_RF_TUNER_CLASS_BASE + 52)
1310 #define V4L2_CID_RF_TUNER_IF_GAIN_AUTO		(V4L2_CID_RF_TUNER_CLASS_BASE + 61)
1311 #define V4L2_CID_RF_TUNER_IF_GAIN		(V4L2_CID_RF_TUNER_CLASS_BASE + 62)
1312 #define V4L2_CID_RF_TUNER_PLL_LOCK			(V4L2_CID_RF_TUNER_CLASS_BASE + 91)
1313 
1314 
1315 /*  Detection-class control IDs defined by V4L2 */
1316 #define V4L2_CID_DETECT_CLASS_BASE		(V4L2_CTRL_CLASS_DETECT | 0x900)
1317 #define V4L2_CID_DETECT_CLASS			(V4L2_CTRL_CLASS_DETECT | 1)
1318 
1319 #define V4L2_CID_DETECT_MD_MODE			(V4L2_CID_DETECT_CLASS_BASE + 1)
1320 enum v4l2_detect_md_mode {
1321 	V4L2_DETECT_MD_MODE_DISABLED		= 0,
1322 	V4L2_DETECT_MD_MODE_GLOBAL		= 1,
1323 	V4L2_DETECT_MD_MODE_THRESHOLD_GRID	= 2,
1324 	V4L2_DETECT_MD_MODE_REGION_GRID		= 3,
1325 };
1326 #define V4L2_CID_DETECT_MD_GLOBAL_THRESHOLD	(V4L2_CID_DETECT_CLASS_BASE + 2)
1327 #define V4L2_CID_DETECT_MD_THRESHOLD_GRID	(V4L2_CID_DETECT_CLASS_BASE + 3)
1328 #define V4L2_CID_DETECT_MD_REGION_GRID		(V4L2_CID_DETECT_CLASS_BASE + 4)
1329 
1330 
1331 /*  Stateless CODECs controls */
1332 #define V4L2_CID_CODEC_STATELESS_BASE          (V4L2_CTRL_CLASS_CODEC_STATELESS | 0x900)
1333 #define V4L2_CID_CODEC_STATELESS_CLASS         (V4L2_CTRL_CLASS_CODEC_STATELESS | 1)
1334 
1335 #define V4L2_CID_STATELESS_H264_DECODE_MODE	(V4L2_CID_CODEC_STATELESS_BASE + 0)
1336 /**
1337  * enum v4l2_stateless_h264_decode_mode - Decoding mode
1338  *
1339  * @V4L2_STATELESS_H264_DECODE_MODE_SLICE_BASED: indicates that decoding
1340  * is performed one slice at a time. In this mode,
1341  * V4L2_CID_STATELESS_H264_SLICE_PARAMS must contain the parsed slice
1342  * parameters and the OUTPUT buffer must contain a single slice.
1343  * V4L2_BUF_CAP_SUPPORTS_M2M_HOLD_CAPTURE_BUF feature is used
1344  * in order to support multislice frames.
1345  * @V4L2_STATELESS_H264_DECODE_MODE_FRAME_BASED: indicates that
1346  * decoding is performed per frame. The OUTPUT buffer must contain
1347  * all slices and also both fields. This mode is typically supported
1348  * by device drivers that are able to parse the slice(s) header(s)
1349  * in hardware. When this mode is selected,
1350  * V4L2_CID_STATELESS_H264_SLICE_PARAMS is not used.
1351  */
1352 enum v4l2_stateless_h264_decode_mode {
1353 	V4L2_STATELESS_H264_DECODE_MODE_SLICE_BASED,
1354 	V4L2_STATELESS_H264_DECODE_MODE_FRAME_BASED,
1355 };
1356 
1357 #define V4L2_CID_STATELESS_H264_START_CODE	(V4L2_CID_CODEC_STATELESS_BASE + 1)
1358 /**
1359  * enum v4l2_stateless_h264_start_code - Start code
1360  *
1361  * @V4L2_STATELESS_H264_START_CODE_NONE: slices are passed
1362  * to the driver without any start code.
1363  * @V4L2_STATELESS_H264_START_CODE_ANNEX_B: slices are passed
1364  * to the driver with an Annex B start code prefix
1365  * (legal start codes can be 3-bytes 0x000001 or 4-bytes 0x00000001).
1366  * This mode is typically supported by device drivers that parse
1367  * the start code in hardware.
1368  */
1369 enum v4l2_stateless_h264_start_code {
1370 	V4L2_STATELESS_H264_START_CODE_NONE,
1371 	V4L2_STATELESS_H264_START_CODE_ANNEX_B,
1372 };
1373 
1374 #define V4L2_H264_SPS_CONSTRAINT_SET0_FLAG			0x01
1375 #define V4L2_H264_SPS_CONSTRAINT_SET1_FLAG			0x02
1376 #define V4L2_H264_SPS_CONSTRAINT_SET2_FLAG			0x04
1377 #define V4L2_H264_SPS_CONSTRAINT_SET3_FLAG			0x08
1378 #define V4L2_H264_SPS_CONSTRAINT_SET4_FLAG			0x10
1379 #define V4L2_H264_SPS_CONSTRAINT_SET5_FLAG			0x20
1380 
1381 #define V4L2_H264_SPS_FLAG_SEPARATE_COLOUR_PLANE		0x01
1382 #define V4L2_H264_SPS_FLAG_QPPRIME_Y_ZERO_TRANSFORM_BYPASS	0x02
1383 #define V4L2_H264_SPS_FLAG_DELTA_PIC_ORDER_ALWAYS_ZERO		0x04
1384 #define V4L2_H264_SPS_FLAG_GAPS_IN_FRAME_NUM_VALUE_ALLOWED	0x08
1385 #define V4L2_H264_SPS_FLAG_FRAME_MBS_ONLY			0x10
1386 #define V4L2_H264_SPS_FLAG_MB_ADAPTIVE_FRAME_FIELD		0x20
1387 #define V4L2_H264_SPS_FLAG_DIRECT_8X8_INFERENCE			0x40
1388 
1389 #define V4L2_H264_SPS_HAS_CHROMA_FORMAT(sps) \
1390 	((sps)->profile_idc == 100 || (sps)->profile_idc == 110 || \
1391 	 (sps)->profile_idc == 122 || (sps)->profile_idc == 244 || \
1392 	 (sps)->profile_idc == 44  || (sps)->profile_idc == 83  || \
1393 	 (sps)->profile_idc == 86  || (sps)->profile_idc == 118 || \
1394 	 (sps)->profile_idc == 128 || (sps)->profile_idc == 138 || \
1395 	 (sps)->profile_idc == 139 || (sps)->profile_idc == 134 || \
1396 	 (sps)->profile_idc == 135)
1397 
1398 #define V4L2_CID_STATELESS_H264_SPS		(V4L2_CID_CODEC_STATELESS_BASE + 2)
1399 /**
1400  * struct v4l2_ctrl_h264_sps - H264 sequence parameter set
1401  *
1402  * All the members on this sequence parameter set structure match the
1403  * sequence parameter set syntax as specified by the H264 specification.
1404  *
1405  * @profile_idc: see H264 specification.
1406  * @constraint_set_flags: see H264 specification.
1407  * @level_idc: see H264 specification.
1408  * @seq_parameter_set_id: see H264 specification.
1409  * @chroma_format_idc: see H264 specification.
1410  * @bit_depth_luma_minus8: see H264 specification.
1411  * @bit_depth_chroma_minus8: see H264 specification.
1412  * @log2_max_frame_num_minus4: see H264 specification.
1413  * @pic_order_cnt_type: see H264 specification.
1414  * @log2_max_pic_order_cnt_lsb_minus4: see H264 specification.
1415  * @max_num_ref_frames: see H264 specification.
1416  * @num_ref_frames_in_pic_order_cnt_cycle: see H264 specification.
1417  * @offset_for_ref_frame: see H264 specification.
1418  * @offset_for_non_ref_pic: see H264 specification.
1419  * @offset_for_top_to_bottom_field: see H264 specification.
1420  * @pic_width_in_mbs_minus1: see H264 specification.
1421  * @pic_height_in_map_units_minus1: see H264 specification.
1422  * @flags: see V4L2_H264_SPS_FLAG_{}.
1423  */
1424 struct v4l2_ctrl_h264_sps {
1425 	__u8 profile_idc;
1426 	__u8 constraint_set_flags;
1427 	__u8 level_idc;
1428 	__u8 seq_parameter_set_id;
1429 	__u8 chroma_format_idc;
1430 	__u8 bit_depth_luma_minus8;
1431 	__u8 bit_depth_chroma_minus8;
1432 	__u8 log2_max_frame_num_minus4;
1433 	__u8 pic_order_cnt_type;
1434 	__u8 log2_max_pic_order_cnt_lsb_minus4;
1435 	__u8 max_num_ref_frames;
1436 	__u8 num_ref_frames_in_pic_order_cnt_cycle;
1437 	__s32 offset_for_ref_frame[255];
1438 	__s32 offset_for_non_ref_pic;
1439 	__s32 offset_for_top_to_bottom_field;
1440 	__u16 pic_width_in_mbs_minus1;
1441 	__u16 pic_height_in_map_units_minus1;
1442 	__u32 flags;
1443 };
1444 
1445 #define V4L2_H264_PPS_FLAG_ENTROPY_CODING_MODE				0x0001
1446 #define V4L2_H264_PPS_FLAG_BOTTOM_FIELD_PIC_ORDER_IN_FRAME_PRESENT	0x0002
1447 #define V4L2_H264_PPS_FLAG_WEIGHTED_PRED				0x0004
1448 #define V4L2_H264_PPS_FLAG_DEBLOCKING_FILTER_CONTROL_PRESENT		0x0008
1449 #define V4L2_H264_PPS_FLAG_CONSTRAINED_INTRA_PRED			0x0010
1450 #define V4L2_H264_PPS_FLAG_REDUNDANT_PIC_CNT_PRESENT			0x0020
1451 #define V4L2_H264_PPS_FLAG_TRANSFORM_8X8_MODE				0x0040
1452 #define V4L2_H264_PPS_FLAG_SCALING_MATRIX_PRESENT			0x0080
1453 
1454 #define V4L2_CID_STATELESS_H264_PPS		(V4L2_CID_CODEC_STATELESS_BASE + 3)
1455 /**
1456  * struct v4l2_ctrl_h264_pps - H264 picture parameter set
1457  *
1458  * Except where noted, all the members on this picture parameter set
1459  * structure match the picture parameter set syntax as specified
1460  * by the H264 specification.
1461  *
1462  * In particular, V4L2_H264_PPS_FLAG_SCALING_MATRIX_PRESENT flag
1463  * has a specific meaning. This flag should be set if a non-flat
1464  * scaling matrix applies to the picture. In this case, applications
1465  * are expected to use V4L2_CID_STATELESS_H264_SCALING_MATRIX,
1466  * to pass the values of the non-flat matrices.
1467  *
1468  * @pic_parameter_set_id: see H264 specification.
1469  * @seq_parameter_set_id: see H264 specification.
1470  * @num_slice_groups_minus1: see H264 specification.
1471  * @num_ref_idx_l0_default_active_minus1: see H264 specification.
1472  * @num_ref_idx_l1_default_active_minus1: see H264 specification.
1473  * @weighted_bipred_idc: see H264 specification.
1474  * @pic_init_qp_minus26: see H264 specification.
1475  * @pic_init_qs_minus26: see H264 specification.
1476  * @chroma_qp_index_offset: see H264 specification.
1477  * @second_chroma_qp_index_offset: see H264 specification.
1478  * @flags: see V4L2_H264_PPS_FLAG_{}.
1479  */
1480 struct v4l2_ctrl_h264_pps {
1481 	__u8 pic_parameter_set_id;
1482 	__u8 seq_parameter_set_id;
1483 	__u8 num_slice_groups_minus1;
1484 	__u8 num_ref_idx_l0_default_active_minus1;
1485 	__u8 num_ref_idx_l1_default_active_minus1;
1486 	__u8 weighted_bipred_idc;
1487 	__s8 pic_init_qp_minus26;
1488 	__s8 pic_init_qs_minus26;
1489 	__s8 chroma_qp_index_offset;
1490 	__s8 second_chroma_qp_index_offset;
1491 	__u16 flags;
1492 };
1493 
1494 #define V4L2_CID_STATELESS_H264_SCALING_MATRIX	(V4L2_CID_CODEC_STATELESS_BASE + 4)
1495 /**
1496  * struct v4l2_ctrl_h264_scaling_matrix - H264 scaling matrices
1497  *
1498  * @scaling_list_4x4: scaling matrix after applying the inverse
1499  * scanning process. Expected list order is Intra Y, Intra Cb,
1500  * Intra Cr, Inter Y, Inter Cb, Inter Cr. The values on each
1501  * scaling list are expected in raster scan order.
1502  * @scaling_list_8x8: scaling matrix after applying the inverse
1503  * scanning process. Expected list order is Intra Y, Inter Y,
1504  * Intra Cb, Inter Cb, Intra Cr, Inter Cr. The values on each
1505  * scaling list are expected in raster scan order.
1506  *
1507  * Note that the list order is different for the 4x4 and 8x8
1508  * matrices as per the H264 specification, see table 7-2 "Assignment
1509  * of mnemonic names to scaling list indices and specification of
1510  * fall-back rule".
1511  */
1512 struct v4l2_ctrl_h264_scaling_matrix {
1513 	__u8 scaling_list_4x4[6][16];
1514 	__u8 scaling_list_8x8[6][64];
1515 };
1516 
1517 struct v4l2_h264_weight_factors {
1518 	__s16 luma_weight[32];
1519 	__s16 luma_offset[32];
1520 	__s16 chroma_weight[32][2];
1521 	__s16 chroma_offset[32][2];
1522 };
1523 
1524 #define V4L2_H264_CTRL_PRED_WEIGHTS_REQUIRED(pps, slice) \
1525 	((((pps)->flags & V4L2_H264_PPS_FLAG_WEIGHTED_PRED) && \
1526 	 ((slice)->slice_type == V4L2_H264_SLICE_TYPE_P || \
1527 	  (slice)->slice_type == V4L2_H264_SLICE_TYPE_SP)) || \
1528 	 ((pps)->weighted_bipred_idc == 1 && \
1529 	  (slice)->slice_type == V4L2_H264_SLICE_TYPE_B))
1530 
1531 #define V4L2_CID_STATELESS_H264_PRED_WEIGHTS	(V4L2_CID_CODEC_STATELESS_BASE + 5)
1532 /**
1533  * struct v4l2_ctrl_h264_pred_weights - Prediction weight table
1534  *
1535  * Prediction weight table, which matches the syntax specified
1536  * by the H264 specification.
1537  *
1538  * @luma_log2_weight_denom: see H264 specification.
1539  * @chroma_log2_weight_denom: see H264 specification.
1540  * @weight_factors: luma and chroma weight factors.
1541  */
1542 struct v4l2_ctrl_h264_pred_weights {
1543 	__u16 luma_log2_weight_denom;
1544 	__u16 chroma_log2_weight_denom;
1545 	struct v4l2_h264_weight_factors weight_factors[2];
1546 };
1547 
1548 #define V4L2_H264_TOP_FIELD_REF				0x1
1549 #define V4L2_H264_BOTTOM_FIELD_REF			0x2
1550 #define V4L2_H264_FRAME_REF				0x3
1551 
1552 /**
1553  * struct v4l2_h264_reference - H264 picture reference
1554  *
1555  * @fields: indicates how the picture is referenced.
1556  * Valid values are V4L2_H264_{}_REF.
1557  * @index: index into v4l2_ctrl_h264_decode_params.dpb[].
1558  */
1559 struct v4l2_h264_reference {
1560 	__u8 fields;
1561 	__u8 index;
1562 };
1563 
1564 /*
1565  * Maximum DPB size, as specified by section 'A.3.1 Level limits
1566  * common to the Baseline, Main, and Extended profiles'.
1567  */
1568 #define V4L2_H264_NUM_DPB_ENTRIES		16
1569 #define V4L2_H264_REF_LIST_LEN			(2 * V4L2_H264_NUM_DPB_ENTRIES)
1570 
1571 #define V4L2_H264_SLICE_TYPE_P				0
1572 #define V4L2_H264_SLICE_TYPE_B				1
1573 #define V4L2_H264_SLICE_TYPE_I				2
1574 #define V4L2_H264_SLICE_TYPE_SP				3
1575 #define V4L2_H264_SLICE_TYPE_SI				4
1576 
1577 #define V4L2_H264_SLICE_FLAG_DIRECT_SPATIAL_MV_PRED		0x01
1578 #define V4L2_H264_SLICE_FLAG_SP_FOR_SWITCH			0x02
1579 
1580 #define V4L2_CID_STATELESS_H264_SLICE_PARAMS	(V4L2_CID_CODEC_STATELESS_BASE + 6)
1581 /**
1582  * struct v4l2_ctrl_h264_slice_params - H264 slice parameters
1583  *
1584  * This structure holds the H264 syntax elements that are specified
1585  * as non-invariant for the slices in a given frame.
1586  *
1587  * Slice invariant syntax elements are contained in struct
1588  * v4l2_ctrl_h264_decode_params. This is done to reduce the API surface
1589  * on frame-based decoders, where slice header parsing is done by the
1590  * hardware.
1591  *
1592  * Slice invariant syntax elements are specified in specification section
1593  * "7.4.3 Slice header semantics".
1594  *
1595  * Except where noted, the members on this struct match the slice header syntax.
1596  *
1597  * @header_bit_size: offset in bits to slice_data() from the beginning of this slice.
1598  * @first_mb_in_slice: see H264 specification.
1599  * @slice_type: see H264 specification.
1600  * @colour_plane_id: see H264 specification.
1601  * @redundant_pic_cnt: see H264 specification.
1602  * @cabac_init_idc: see H264 specification.
1603  * @slice_qp_delta: see H264 specification.
1604  * @slice_qs_delta: see H264 specification.
1605  * @disable_deblocking_filter_idc: see H264 specification.
1606  * @slice_alpha_c0_offset_div2: see H264 specification.
1607  * @slice_beta_offset_div2: see H264 specification.
1608  * @num_ref_idx_l0_active_minus1: see H264 specification.
1609  * @num_ref_idx_l1_active_minus1: see H264 specification.
1610  * @reserved: padding field. Should be zeroed by applications.
1611  * @ref_pic_list0: reference picture list 0 after applying the per-slice modifications.
1612  * @ref_pic_list1: reference picture list 1 after applying the per-slice modifications.
1613  * @flags: see V4L2_H264_SLICE_FLAG_{}.
1614  */
1615 struct v4l2_ctrl_h264_slice_params {
1616 	__u32 header_bit_size;
1617 	__u32 first_mb_in_slice;
1618 	__u8 slice_type;
1619 	__u8 colour_plane_id;
1620 	__u8 redundant_pic_cnt;
1621 	__u8 cabac_init_idc;
1622 	__s8 slice_qp_delta;
1623 	__s8 slice_qs_delta;
1624 	__u8 disable_deblocking_filter_idc;
1625 	__s8 slice_alpha_c0_offset_div2;
1626 	__s8 slice_beta_offset_div2;
1627 	__u8 num_ref_idx_l0_active_minus1;
1628 	__u8 num_ref_idx_l1_active_minus1;
1629 
1630 	__u8 reserved;
1631 
1632 	struct v4l2_h264_reference ref_pic_list0[V4L2_H264_REF_LIST_LEN];
1633 	struct v4l2_h264_reference ref_pic_list1[V4L2_H264_REF_LIST_LEN];
1634 
1635 	__u32 flags;
1636 };
1637 
1638 #define V4L2_H264_DPB_ENTRY_FLAG_VALID		0x01
1639 #define V4L2_H264_DPB_ENTRY_FLAG_ACTIVE		0x02
1640 #define V4L2_H264_DPB_ENTRY_FLAG_LONG_TERM	0x04
1641 #define V4L2_H264_DPB_ENTRY_FLAG_FIELD		0x08
1642 
1643 /**
1644  * struct v4l2_h264_dpb_entry - H264 decoded picture buffer entry
1645  *
1646  * @reference_ts: timestamp of the V4L2 capture buffer to use as reference.
1647  * The timestamp refers to the timestamp field in struct v4l2_buffer.
1648  * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
1649  * @pic_num: matches PicNum variable assigned during the reference
1650  * picture lists construction process.
1651  * @frame_num: frame identifier which matches frame_num syntax element.
1652  * @fields: indicates how the DPB entry is referenced. Valid values are
1653  * V4L2_H264_{}_REF.
1654  * @reserved: padding field. Should be zeroed by applications.
1655  * @top_field_order_cnt: matches TopFieldOrderCnt picture value.
1656  * @bottom_field_order_cnt: matches BottomFieldOrderCnt picture value.
1657  * Note that picture field is indicated by v4l2_buffer.field.
1658  * @flags: see V4L2_H264_DPB_ENTRY_FLAG_{}.
1659  */
1660 struct v4l2_h264_dpb_entry {
1661 	__u64 reference_ts;
1662 	__u32 pic_num;
1663 	__u16 frame_num;
1664 	__u8 fields;
1665 	__u8 reserved[5];
1666 	__s32 top_field_order_cnt;
1667 	__s32 bottom_field_order_cnt;
1668 	__u32 flags;
1669 };
1670 
1671 #define V4L2_H264_DECODE_PARAM_FLAG_IDR_PIC		0x01
1672 #define V4L2_H264_DECODE_PARAM_FLAG_FIELD_PIC		0x02
1673 #define V4L2_H264_DECODE_PARAM_FLAG_BOTTOM_FIELD	0x04
1674 #define V4L2_H264_DECODE_PARAM_FLAG_PFRAME		0x08
1675 #define V4L2_H264_DECODE_PARAM_FLAG_BFRAME		0x10
1676 
1677 #define V4L2_CID_STATELESS_H264_DECODE_PARAMS	(V4L2_CID_CODEC_STATELESS_BASE + 7)
1678 /**
1679  * struct v4l2_ctrl_h264_decode_params - H264 decoding parameters
1680  *
1681  * @dpb: decoded picture buffer.
1682  * @nal_ref_idc: slice header syntax element.
1683  * @frame_num: slice header syntax element.
1684  * @top_field_order_cnt: matches TopFieldOrderCnt picture value.
1685  * @bottom_field_order_cnt: matches BottomFieldOrderCnt picture value.
1686  * Note that picture field is indicated by v4l2_buffer.field.
1687  * @idr_pic_id: slice header syntax element.
1688  * @pic_order_cnt_lsb: slice header syntax element.
1689  * @delta_pic_order_cnt_bottom: slice header syntax element.
1690  * @delta_pic_order_cnt0: slice header syntax element.
1691  * @delta_pic_order_cnt1: slice header syntax element.
1692  * @dec_ref_pic_marking_bit_size: size in bits of dec_ref_pic_marking()
1693  * syntax element.
1694  * @pic_order_cnt_bit_size: size in bits of pic order count syntax.
1695  * @slice_group_change_cycle: slice header syntax element.
1696  * @reserved: padding field. Should be zeroed by applications.
1697  * @flags: see V4L2_H264_DECODE_PARAM_FLAG_{}.
1698  */
1699 struct v4l2_ctrl_h264_decode_params {
1700 	struct v4l2_h264_dpb_entry dpb[V4L2_H264_NUM_DPB_ENTRIES];
1701 	__u16 nal_ref_idc;
1702 	__u16 frame_num;
1703 	__s32 top_field_order_cnt;
1704 	__s32 bottom_field_order_cnt;
1705 	__u16 idr_pic_id;
1706 	__u16 pic_order_cnt_lsb;
1707 	__s32 delta_pic_order_cnt_bottom;
1708 	__s32 delta_pic_order_cnt0;
1709 	__s32 delta_pic_order_cnt1;
1710 	__u32 dec_ref_pic_marking_bit_size;
1711 	__u32 pic_order_cnt_bit_size;
1712 	__u32 slice_group_change_cycle;
1713 
1714 	__u32 reserved;
1715 	__u32 flags;
1716 };
1717 
1718 /* Stateless FWHT control, used by the vicodec driver */
1719 
1720 /* Current FWHT version */
1721 #define V4L2_FWHT_VERSION			3
1722 
1723 /* Set if this is an interlaced format */
1724 #define V4L2_FWHT_FL_IS_INTERLACED		_BITUL(0)
1725 /* Set if this is a bottom-first (NTSC) interlaced format */
1726 #define V4L2_FWHT_FL_IS_BOTTOM_FIRST		_BITUL(1)
1727 /* Set if each 'frame' contains just one field */
1728 #define V4L2_FWHT_FL_IS_ALTERNATE		_BITUL(2)
1729 /*
1730  * If V4L2_FWHT_FL_IS_ALTERNATE was set, then this is set if this
1731  * 'frame' is the bottom field, else it is the top field.
1732  */
1733 #define V4L2_FWHT_FL_IS_BOTTOM_FIELD		_BITUL(3)
1734 /* Set if the Y' plane is uncompressed */
1735 #define V4L2_FWHT_FL_LUMA_IS_UNCOMPRESSED	_BITUL(4)
1736 /* Set if the Cb plane is uncompressed */
1737 #define V4L2_FWHT_FL_CB_IS_UNCOMPRESSED		_BITUL(5)
1738 /* Set if the Cr plane is uncompressed */
1739 #define V4L2_FWHT_FL_CR_IS_UNCOMPRESSED		_BITUL(6)
1740 /* Set if the chroma plane is full height, if cleared it is half height */
1741 #define V4L2_FWHT_FL_CHROMA_FULL_HEIGHT		_BITUL(7)
1742 /* Set if the chroma plane is full width, if cleared it is half width */
1743 #define V4L2_FWHT_FL_CHROMA_FULL_WIDTH		_BITUL(8)
1744 /* Set if the alpha plane is uncompressed */
1745 #define V4L2_FWHT_FL_ALPHA_IS_UNCOMPRESSED	_BITUL(9)
1746 /* Set if this is an I Frame */
1747 #define V4L2_FWHT_FL_I_FRAME			_BITUL(10)
1748 
1749 /* A 4-values flag - the number of components - 1 */
1750 #define V4L2_FWHT_FL_COMPONENTS_NUM_MSK		GENMASK(18, 16)
1751 #define V4L2_FWHT_FL_COMPONENTS_NUM_OFFSET	16
1752 
1753 /* A 4-values flag - the pixel encoding type */
1754 #define V4L2_FWHT_FL_PIXENC_MSK			GENMASK(20, 19)
1755 #define V4L2_FWHT_FL_PIXENC_OFFSET		19
1756 #define V4L2_FWHT_FL_PIXENC_YUV			(1 << V4L2_FWHT_FL_PIXENC_OFFSET)
1757 #define V4L2_FWHT_FL_PIXENC_RGB			(2 << V4L2_FWHT_FL_PIXENC_OFFSET)
1758 #define V4L2_FWHT_FL_PIXENC_HSV			(3 << V4L2_FWHT_FL_PIXENC_OFFSET)
1759 
1760 #define V4L2_CID_STATELESS_FWHT_PARAMS		(V4L2_CID_CODEC_STATELESS_BASE + 100)
1761 /**
1762  * struct v4l2_ctrl_fwht_params - FWHT parameters
1763  *
1764  * @backward_ref_ts: timestamp of the V4L2 capture buffer to use as reference.
1765  * The timestamp refers to the timestamp field in struct v4l2_buffer.
1766  * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
1767  * @version: must be V4L2_FWHT_VERSION.
1768  * @width: width of frame.
1769  * @height: height of frame.
1770  * @flags: FWHT flags (see V4L2_FWHT_FL_*).
1771  * @colorspace: the colorspace (enum v4l2_colorspace).
1772  * @xfer_func: the transfer function (enum v4l2_xfer_func).
1773  * @ycbcr_enc: the Y'CbCr encoding (enum v4l2_ycbcr_encoding).
1774  * @quantization: the quantization (enum v4l2_quantization).
1775  */
1776 struct v4l2_ctrl_fwht_params {
1777 	__u64 backward_ref_ts;
1778 	__u32 version;
1779 	__u32 width;
1780 	__u32 height;
1781 	__u32 flags;
1782 	__u32 colorspace;
1783 	__u32 xfer_func;
1784 	__u32 ycbcr_enc;
1785 	__u32 quantization;
1786 };
1787 
1788 /* Stateless VP8 control */
1789 
1790 #define V4L2_VP8_SEGMENT_FLAG_ENABLED              0x01
1791 #define V4L2_VP8_SEGMENT_FLAG_UPDATE_MAP           0x02
1792 #define V4L2_VP8_SEGMENT_FLAG_UPDATE_FEATURE_DATA  0x04
1793 #define V4L2_VP8_SEGMENT_FLAG_DELTA_VALUE_MODE     0x08
1794 
1795 /**
1796  * struct v4l2_vp8_segment - VP8 segment-based adjustments parameters
1797  *
1798  * @quant_update: update values for the segment quantizer.
1799  * @lf_update: update values for the loop filter level.
1800  * @segment_probs: branch probabilities of the segment_id decoding tree.
1801  * @padding: padding field. Should be zeroed by applications.
1802  * @flags: see V4L2_VP8_SEGMENT_FLAG_{}.
1803  *
1804  * This structure contains segment-based adjustments related parameters.
1805  * See the 'update_segmentation()' part of the frame header syntax,
1806  * and section '9.3. Segment-Based Adjustments' of the VP8 specification
1807  * for more details.
1808  */
1809 struct v4l2_vp8_segment {
1810 	__s8 quant_update[4];
1811 	__s8 lf_update[4];
1812 	__u8 segment_probs[3];
1813 	__u8 padding;
1814 	__u32 flags;
1815 };
1816 
1817 #define V4L2_VP8_LF_ADJ_ENABLE	0x01
1818 #define V4L2_VP8_LF_DELTA_UPDATE	0x02
1819 #define V4L2_VP8_LF_FILTER_TYPE_SIMPLE	0x04
1820 
1821 /**
1822  * struct v4l2_vp8_loop_filter - VP8 loop filter parameters
1823  *
1824  * @ref_frm_delta: Reference frame signed delta values.
1825  * @mb_mode_delta: MB prediction mode signed delta values.
1826  * @sharpness_level: matches sharpness_level syntax element.
1827  * @level: matches loop_filter_level syntax element.
1828  * @padding: padding field. Should be zeroed by applications.
1829  * @flags: see V4L2_VP8_LF_{}.
1830  *
1831  * This structure contains loop filter related parameters.
1832  * See the 'mb_lf_adjustments()' part of the frame header syntax,
1833  * and section '9.4. Loop Filter Type and Levels' of the VP8 specification
1834  * for more details.
1835  */
1836 struct v4l2_vp8_loop_filter {
1837 	__s8 ref_frm_delta[4];
1838 	__s8 mb_mode_delta[4];
1839 	__u8 sharpness_level;
1840 	__u8 level;
1841 	__u16 padding;
1842 	__u32 flags;
1843 };
1844 
1845 /**
1846  * struct v4l2_vp8_quantization - VP8 quantizattion indices
1847  *
1848  * @y_ac_qi: luma AC coefficient table index.
1849  * @y_dc_delta: luma DC delta vaue.
1850  * @y2_dc_delta: y2 block DC delta value.
1851  * @y2_ac_delta: y2 block AC delta value.
1852  * @uv_dc_delta: chroma DC delta value.
1853  * @uv_ac_delta: chroma AC delta value.
1854  * @padding: padding field. Should be zeroed by applications.
1855  *
1856  * This structure contains the quantization indices present
1857  * in 'quant_indices()' part of the frame header syntax.
1858  * See section '9.6. Dequantization Indices' of the VP8 specification
1859  * for more details.
1860  */
1861 struct v4l2_vp8_quantization {
1862 	__u8 y_ac_qi;
1863 	__s8 y_dc_delta;
1864 	__s8 y2_dc_delta;
1865 	__s8 y2_ac_delta;
1866 	__s8 uv_dc_delta;
1867 	__s8 uv_ac_delta;
1868 	__u16 padding;
1869 };
1870 
1871 #define V4L2_VP8_COEFF_PROB_CNT 11
1872 #define V4L2_VP8_MV_PROB_CNT 19
1873 
1874 /**
1875  * struct v4l2_vp8_entropy - VP8 update probabilities
1876  *
1877  * @coeff_probs: coefficient probability update values.
1878  * @y_mode_probs: luma intra-prediction probabilities.
1879  * @uv_mode_probs: chroma intra-prediction probabilities.
1880  * @mv_probs: mv decoding probability.
1881  * @padding: padding field. Should be zeroed by applications.
1882  *
1883  * This structure contains the update probabilities present in
1884  * 'token_prob_update()' and 'mv_prob_update()' part of the frame header.
1885  * See section '17.2. Probability Updates' of the VP8 specification
1886  * for more details.
1887  */
1888 struct v4l2_vp8_entropy {
1889 	__u8 coeff_probs[4][8][3][V4L2_VP8_COEFF_PROB_CNT];
1890 	__u8 y_mode_probs[4];
1891 	__u8 uv_mode_probs[3];
1892 	__u8 mv_probs[2][V4L2_VP8_MV_PROB_CNT];
1893 	__u8 padding[3];
1894 };
1895 
1896 /**
1897  * struct v4l2_vp8_entropy_coder_state - VP8 boolean coder state
1898  *
1899  * @range: coder state value for "Range"
1900  * @value: coder state value for "Value"
1901  * @bit_count: number of bits left in range "Value".
1902  * @padding: padding field. Should be zeroed by applications.
1903  *
1904  * This structure contains the state for the boolean coder, as
1905  * explained in section '7. Boolean Entropy Decoder' of the VP8 specification.
1906  */
1907 struct v4l2_vp8_entropy_coder_state {
1908 	__u8 range;
1909 	__u8 value;
1910 	__u8 bit_count;
1911 	__u8 padding;
1912 };
1913 
1914 #define V4L2_VP8_FRAME_FLAG_KEY_FRAME		0x01
1915 #define V4L2_VP8_FRAME_FLAG_EXPERIMENTAL		0x02
1916 #define V4L2_VP8_FRAME_FLAG_SHOW_FRAME		0x04
1917 #define V4L2_VP8_FRAME_FLAG_MB_NO_SKIP_COEFF	0x08
1918 #define V4L2_VP8_FRAME_FLAG_SIGN_BIAS_GOLDEN	0x10
1919 #define V4L2_VP8_FRAME_FLAG_SIGN_BIAS_ALT	0x20
1920 
1921 #define V4L2_VP8_FRAME_IS_KEY_FRAME(hdr) \
1922 	(!!((hdr)->flags & V4L2_VP8_FRAME_FLAG_KEY_FRAME))
1923 
1924 #define V4L2_CID_STATELESS_VP8_FRAME (V4L2_CID_CODEC_STATELESS_BASE + 200)
1925 /**
1926  * struct v4l2_ctrl_vp8_frame - VP8 frame parameters
1927  *
1928  * @segment: segmentation parameters. See &v4l2_vp8_segment for more details
1929  * @lf: loop filter parameters. See &v4l2_vp8_loop_filter for more details
1930  * @quant: quantization parameters. See &v4l2_vp8_quantization for more details
1931  * @entropy: update probabilities. See &v4l2_vp8_entropy for more details
1932  * @coder_state: boolean coder state. See &v4l2_vp8_entropy_coder_state for more details
1933  * @width: frame width.
1934  * @height: frame height.
1935  * @horizontal_scale: horizontal scaling factor.
1936  * @vertical_scale: vertical scaling factor.
1937  * @version: bitstream version.
1938  * @prob_skip_false: frame header syntax element.
1939  * @prob_intra: frame header syntax element.
1940  * @prob_last: frame header syntax element.
1941  * @prob_gf: frame header syntax element.
1942  * @num_dct_parts: number of DCT coefficients partitions.
1943  * @first_part_size: size of the first partition, i.e. the control partition.
1944  * @first_part_header_bits: size in bits of the first partition header portion.
1945  * @dct_part_sizes: DCT coefficients sizes.
1946  * @last_frame_ts: "last" reference buffer timestamp.
1947  * The timestamp refers to the timestamp field in struct v4l2_buffer.
1948  * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
1949  * @golden_frame_ts: "golden" reference buffer timestamp.
1950  * @alt_frame_ts: "alt" reference buffer timestamp.
1951  * @flags: see V4L2_VP8_FRAME_FLAG_{}.
1952  */
1953 struct v4l2_ctrl_vp8_frame {
1954 	struct v4l2_vp8_segment segment;
1955 	struct v4l2_vp8_loop_filter lf;
1956 	struct v4l2_vp8_quantization quant;
1957 	struct v4l2_vp8_entropy entropy;
1958 	struct v4l2_vp8_entropy_coder_state coder_state;
1959 
1960 	__u16 width;
1961 	__u16 height;
1962 
1963 	__u8 horizontal_scale;
1964 	__u8 vertical_scale;
1965 
1966 	__u8 version;
1967 	__u8 prob_skip_false;
1968 	__u8 prob_intra;
1969 	__u8 prob_last;
1970 	__u8 prob_gf;
1971 	__u8 num_dct_parts;
1972 
1973 	__u32 first_part_size;
1974 	__u32 first_part_header_bits;
1975 	__u32 dct_part_sizes[8];
1976 
1977 	__u64 last_frame_ts;
1978 	__u64 golden_frame_ts;
1979 	__u64 alt_frame_ts;
1980 
1981 	__u64 flags;
1982 };
1983 
1984 /* Stateless MPEG-2 controls */
1985 
1986 #define V4L2_MPEG2_SEQ_FLAG_PROGRESSIVE	0x01
1987 
1988 #define V4L2_CID_STATELESS_MPEG2_SEQUENCE (V4L2_CID_CODEC_STATELESS_BASE+220)
1989 /**
1990  * struct v4l2_ctrl_mpeg2_sequence - MPEG-2 sequence header
1991  *
1992  * All the members on this structure match the sequence header and sequence
1993  * extension syntaxes as specified by the MPEG-2 specification.
1994  *
1995  * Fields horizontal_size, vertical_size and vbv_buffer_size are a
1996  * combination of respective _value and extension syntax elements,
1997  * as described in section 6.3.3 "Sequence header".
1998  *
1999  * @horizontal_size: combination of elements horizontal_size_value and
2000  * horizontal_size_extension.
2001  * @vertical_size: combination of elements vertical_size_value and
2002  * vertical_size_extension.
2003  * @vbv_buffer_size: combination of elements vbv_buffer_size_value and
2004  * vbv_buffer_size_extension.
2005  * @profile_and_level_indication: see MPEG-2 specification.
2006  * @chroma_format: see MPEG-2 specification.
2007  * @flags: see V4L2_MPEG2_SEQ_FLAG_{}.
2008  */
2009 struct v4l2_ctrl_mpeg2_sequence {
2010 	__u16	horizontal_size;
2011 	__u16	vertical_size;
2012 	__u32	vbv_buffer_size;
2013 	__u16	profile_and_level_indication;
2014 	__u8	chroma_format;
2015 	__u8	flags;
2016 };
2017 
2018 #define V4L2_MPEG2_PIC_CODING_TYPE_I			1
2019 #define V4L2_MPEG2_PIC_CODING_TYPE_P			2
2020 #define V4L2_MPEG2_PIC_CODING_TYPE_B			3
2021 #define V4L2_MPEG2_PIC_CODING_TYPE_D			4
2022 
2023 #define V4L2_MPEG2_PIC_TOP_FIELD			0x1
2024 #define V4L2_MPEG2_PIC_BOTTOM_FIELD			0x2
2025 #define V4L2_MPEG2_PIC_FRAME				0x3
2026 
2027 #define V4L2_MPEG2_PIC_FLAG_TOP_FIELD_FIRST		0x0001
2028 #define V4L2_MPEG2_PIC_FLAG_FRAME_PRED_DCT		0x0002
2029 #define V4L2_MPEG2_PIC_FLAG_CONCEALMENT_MV		0x0004
2030 #define V4L2_MPEG2_PIC_FLAG_Q_SCALE_TYPE		0x0008
2031 #define V4L2_MPEG2_PIC_FLAG_INTRA_VLC			0x0010
2032 #define V4L2_MPEG2_PIC_FLAG_ALT_SCAN			0x0020
2033 #define V4L2_MPEG2_PIC_FLAG_REPEAT_FIRST		0x0040
2034 #define V4L2_MPEG2_PIC_FLAG_PROGRESSIVE			0x0080
2035 
2036 #define V4L2_CID_STATELESS_MPEG2_PICTURE (V4L2_CID_CODEC_STATELESS_BASE+221)
2037 /**
2038  * struct v4l2_ctrl_mpeg2_picture - MPEG-2 picture header
2039  *
2040  * All the members on this structure match the picture header and picture
2041  * coding extension syntaxes as specified by the MPEG-2 specification.
2042  *
2043  * @backward_ref_ts: timestamp of the V4L2 capture buffer to use as
2044  * reference for backward prediction.
2045  * @forward_ref_ts: timestamp of the V4L2 capture buffer to use as
2046  * reference for forward prediction. These timestamp refers to the
2047  * timestamp field in struct v4l2_buffer. Use v4l2_timeval_to_ns()
2048  * to convert the struct timeval to a __u64.
2049  * @flags: see V4L2_MPEG2_PIC_FLAG_{}.
2050  * @f_code: see MPEG-2 specification.
2051  * @picture_coding_type: see MPEG-2 specification.
2052  * @picture_structure: see V4L2_MPEG2_PIC_{}_FIELD.
2053  * @intra_dc_precision: see MPEG-2 specification.
2054  * @reserved: padding field. Should be zeroed by applications.
2055  */
2056 struct v4l2_ctrl_mpeg2_picture {
2057 	__u64	backward_ref_ts;
2058 	__u64	forward_ref_ts;
2059 	__u32	flags;
2060 	__u8	f_code[2][2];
2061 	__u8	picture_coding_type;
2062 	__u8	picture_structure;
2063 	__u8	intra_dc_precision;
2064 	__u8	reserved[5];
2065 };
2066 
2067 #define V4L2_CID_STATELESS_MPEG2_QUANTISATION (V4L2_CID_CODEC_STATELESS_BASE+222)
2068 /**
2069  * struct v4l2_ctrl_mpeg2_quantisation - MPEG-2 quantisation
2070  *
2071  * Quantisation matrices as specified by section 6.3.7
2072  * "Quant matrix extension".
2073  *
2074  * @intra_quantiser_matrix: The quantisation matrix coefficients
2075  * for intra-coded frames, in zigzag scanning order. It is relevant
2076  * for both luma and chroma components, although it can be superseded
2077  * by the chroma-specific matrix for non-4:2:0 YUV formats.
2078  * @non_intra_quantiser_matrix: The quantisation matrix coefficients
2079  * for non-intra-coded frames, in zigzag scanning order. It is relevant
2080  * for both luma and chroma components, although it can be superseded
2081  * by the chroma-specific matrix for non-4:2:0 YUV formats.
2082  * @chroma_intra_quantiser_matrix: The quantisation matrix coefficients
2083  * for the chominance component of intra-coded frames, in zigzag scanning
2084  * order. Only relevant for 4:2:2 and 4:4:4 YUV formats.
2085  * @chroma_non_intra_quantiser_matrix: The quantisation matrix coefficients
2086  * for the chrominance component of non-intra-coded frames, in zigzag scanning
2087  * order. Only relevant for 4:2:2 and 4:4:4 YUV formats.
2088  */
2089 struct v4l2_ctrl_mpeg2_quantisation {
2090 	__u8	intra_quantiser_matrix[64];
2091 	__u8	non_intra_quantiser_matrix[64];
2092 	__u8	chroma_intra_quantiser_matrix[64];
2093 	__u8	chroma_non_intra_quantiser_matrix[64];
2094 };
2095 
2096 #define V4L2_CID_STATELESS_HEVC_SPS		(V4L2_CID_CODEC_STATELESS_BASE + 400)
2097 #define V4L2_CID_STATELESS_HEVC_PPS		(V4L2_CID_CODEC_STATELESS_BASE + 401)
2098 #define V4L2_CID_STATELESS_HEVC_SLICE_PARAMS	(V4L2_CID_CODEC_STATELESS_BASE + 402)
2099 #define V4L2_CID_STATELESS_HEVC_SCALING_MATRIX	(V4L2_CID_CODEC_STATELESS_BASE + 403)
2100 #define V4L2_CID_STATELESS_HEVC_DECODE_PARAMS	(V4L2_CID_CODEC_STATELESS_BASE + 404)
2101 #define V4L2_CID_STATELESS_HEVC_DECODE_MODE	(V4L2_CID_CODEC_STATELESS_BASE + 405)
2102 #define V4L2_CID_STATELESS_HEVC_START_CODE	(V4L2_CID_CODEC_STATELESS_BASE + 406)
2103 #define V4L2_CID_STATELESS_HEVC_ENTRY_POINT_OFFSETS (V4L2_CID_CODEC_STATELESS_BASE + 407)
2104 #define V4L2_CID_STATELESS_HEVC_EXT_SPS_ST_RPS  (V4L2_CID_CODEC_STATELESS_BASE + 408)
2105 #define V4L2_CID_STATELESS_HEVC_EXT_SPS_LT_RPS  (V4L2_CID_CODEC_STATELESS_BASE + 409)
2106 
2107 enum v4l2_stateless_hevc_decode_mode {
2108 	V4L2_STATELESS_HEVC_DECODE_MODE_SLICE_BASED,
2109 	V4L2_STATELESS_HEVC_DECODE_MODE_FRAME_BASED,
2110 };
2111 
2112 enum v4l2_stateless_hevc_start_code {
2113 	V4L2_STATELESS_HEVC_START_CODE_NONE,
2114 	V4L2_STATELESS_HEVC_START_CODE_ANNEX_B,
2115 };
2116 
2117 #define V4L2_HEVC_SLICE_TYPE_B	0
2118 #define V4L2_HEVC_SLICE_TYPE_P	1
2119 #define V4L2_HEVC_SLICE_TYPE_I	2
2120 
2121 #define V4L2_HEVC_SPS_FLAG_SEPARATE_COLOUR_PLANE		(1ULL << 0)
2122 #define V4L2_HEVC_SPS_FLAG_SCALING_LIST_ENABLED			(1ULL << 1)
2123 #define V4L2_HEVC_SPS_FLAG_AMP_ENABLED				(1ULL << 2)
2124 #define V4L2_HEVC_SPS_FLAG_SAMPLE_ADAPTIVE_OFFSET		(1ULL << 3)
2125 #define V4L2_HEVC_SPS_FLAG_PCM_ENABLED				(1ULL << 4)
2126 #define V4L2_HEVC_SPS_FLAG_PCM_LOOP_FILTER_DISABLED		(1ULL << 5)
2127 #define V4L2_HEVC_SPS_FLAG_LONG_TERM_REF_PICS_PRESENT		(1ULL << 6)
2128 #define V4L2_HEVC_SPS_FLAG_SPS_TEMPORAL_MVP_ENABLED		(1ULL << 7)
2129 #define V4L2_HEVC_SPS_FLAG_STRONG_INTRA_SMOOTHING_ENABLED	(1ULL << 8)
2130 
2131 /**
2132  * struct v4l2_ctrl_hevc_sps - ITU-T Rec. H.265: Sequence parameter set
2133  *
2134  * @video_parameter_set_id: specifies the value of the
2135  *			vps_video_parameter_set_id of the active VPS
2136  * @seq_parameter_set_id: provides an identifier for the SPS for
2137  *			  reference by other syntax elements
2138  * @pic_width_in_luma_samples:	specifies the width of each decoded picture
2139  *				in units of luma samples
2140  * @pic_height_in_luma_samples: specifies the height of each decoded picture
2141  *				in units of luma samples
2142  * @bit_depth_luma_minus8: this value plus 8specifies the bit depth of the
2143  *                         samples of the luma array
2144  * @bit_depth_chroma_minus8: this value plus 8 specifies the bit depth of the
2145  *                           samples of the chroma arrays
2146  * @log2_max_pic_order_cnt_lsb_minus4: this value plus 4 specifies the value of
2147  *                                     the variable MaxPicOrderCntLsb
2148  * @sps_max_dec_pic_buffering_minus1: this value plus 1 specifies the maximum
2149  *                                    required size of the decoded picture
2150  *                                    buffer for the codec video sequence
2151  * @sps_max_num_reorder_pics: indicates the maximum allowed number of pictures
2152  * @sps_max_latency_increase_plus1: not equal to 0 is used to compute the
2153  *				    value of SpsMaxLatencyPictures array
2154  * @log2_min_luma_coding_block_size_minus3: plus 3 specifies the minimum
2155  *					    luma coding block size
2156  * @log2_diff_max_min_luma_coding_block_size: specifies the difference between
2157  *					      the maximum and minimum luma
2158  *					      coding block size
2159  * @log2_min_luma_transform_block_size_minus2: plus 2 specifies the minimum luma
2160  *					       transform block size
2161  * @log2_diff_max_min_luma_transform_block_size: specifies the difference between
2162  *						 the maximum and minimum luma
2163  *						 transform block size
2164  * @max_transform_hierarchy_depth_inter: specifies the maximum hierarchy
2165  *					 depth for transform units of
2166  *					 coding units coded in inter
2167  *					 prediction mode
2168  * @max_transform_hierarchy_depth_intra: specifies the maximum hierarchy
2169  *					 depth for transform units of
2170  *					 coding units coded in intra
2171  *					 prediction mode
2172  * @pcm_sample_bit_depth_luma_minus1: this value plus 1 specifies the number of
2173  *                                    bits used to represent each of PCM sample
2174  *                                    values of the luma component
2175  * @pcm_sample_bit_depth_chroma_minus1: this value plus 1 specifies the number
2176  *                                      of bits used to represent each of PCM
2177  *                                      sample values of the chroma components
2178  * @log2_min_pcm_luma_coding_block_size_minus3: this value plus 3 specifies the
2179  *                                              minimum size of coding blocks
2180  * @log2_diff_max_min_pcm_luma_coding_block_size: specifies the difference between
2181  *						  the maximum and minimum size of
2182  *						  coding blocks
2183  * @num_short_term_ref_pic_sets: specifies the number of st_ref_pic_set()
2184  *				 syntax structures included in the SPS
2185  * @num_long_term_ref_pics_sps: specifies the number of candidate long-term
2186  *				reference pictures that are specified in the SPS
2187  * @chroma_format_idc: specifies the chroma sampling
2188  * @sps_max_sub_layers_minus1: this value plus 1 specifies the maximum number
2189  *                             of temporal sub-layers
2190  * @reserved: padding field. Should be zeroed by applications.
2191  * @flags: see V4L2_HEVC_SPS_FLAG_{}
2192  */
2193 struct v4l2_ctrl_hevc_sps {
2194 	__u8	video_parameter_set_id;
2195 	__u8	seq_parameter_set_id;
2196 	__u16	pic_width_in_luma_samples;
2197 	__u16	pic_height_in_luma_samples;
2198 	__u8	bit_depth_luma_minus8;
2199 	__u8	bit_depth_chroma_minus8;
2200 	__u8	log2_max_pic_order_cnt_lsb_minus4;
2201 	__u8	sps_max_dec_pic_buffering_minus1;
2202 	__u8	sps_max_num_reorder_pics;
2203 	__u8	sps_max_latency_increase_plus1;
2204 	__u8	log2_min_luma_coding_block_size_minus3;
2205 	__u8	log2_diff_max_min_luma_coding_block_size;
2206 	__u8	log2_min_luma_transform_block_size_minus2;
2207 	__u8	log2_diff_max_min_luma_transform_block_size;
2208 	__u8	max_transform_hierarchy_depth_inter;
2209 	__u8	max_transform_hierarchy_depth_intra;
2210 	__u8	pcm_sample_bit_depth_luma_minus1;
2211 	__u8	pcm_sample_bit_depth_chroma_minus1;
2212 	__u8	log2_min_pcm_luma_coding_block_size_minus3;
2213 	__u8	log2_diff_max_min_pcm_luma_coding_block_size;
2214 	__u8	num_short_term_ref_pic_sets;
2215 	__u8	num_long_term_ref_pics_sps;
2216 	__u8	chroma_format_idc;
2217 	__u8	sps_max_sub_layers_minus1;
2218 
2219 	__u8	reserved[6];
2220 	__u64	flags;
2221 };
2222 
2223 #define V4L2_HEVC_PPS_FLAG_DEPENDENT_SLICE_SEGMENT_ENABLED	(1ULL << 0)
2224 #define V4L2_HEVC_PPS_FLAG_OUTPUT_FLAG_PRESENT			(1ULL << 1)
2225 #define V4L2_HEVC_PPS_FLAG_SIGN_DATA_HIDING_ENABLED		(1ULL << 2)
2226 #define V4L2_HEVC_PPS_FLAG_CABAC_INIT_PRESENT			(1ULL << 3)
2227 #define V4L2_HEVC_PPS_FLAG_CONSTRAINED_INTRA_PRED		(1ULL << 4)
2228 #define V4L2_HEVC_PPS_FLAG_TRANSFORM_SKIP_ENABLED		(1ULL << 5)
2229 #define V4L2_HEVC_PPS_FLAG_CU_QP_DELTA_ENABLED			(1ULL << 6)
2230 #define V4L2_HEVC_PPS_FLAG_PPS_SLICE_CHROMA_QP_OFFSETS_PRESENT	(1ULL << 7)
2231 #define V4L2_HEVC_PPS_FLAG_WEIGHTED_PRED			(1ULL << 8)
2232 #define V4L2_HEVC_PPS_FLAG_WEIGHTED_BIPRED			(1ULL << 9)
2233 #define V4L2_HEVC_PPS_FLAG_TRANSQUANT_BYPASS_ENABLED		(1ULL << 10)
2234 #define V4L2_HEVC_PPS_FLAG_TILES_ENABLED			(1ULL << 11)
2235 #define V4L2_HEVC_PPS_FLAG_ENTROPY_CODING_SYNC_ENABLED		(1ULL << 12)
2236 #define V4L2_HEVC_PPS_FLAG_LOOP_FILTER_ACROSS_TILES_ENABLED	(1ULL << 13)
2237 #define V4L2_HEVC_PPS_FLAG_PPS_LOOP_FILTER_ACROSS_SLICES_ENABLED (1ULL << 14)
2238 #define V4L2_HEVC_PPS_FLAG_DEBLOCKING_FILTER_OVERRIDE_ENABLED	(1ULL << 15)
2239 #define V4L2_HEVC_PPS_FLAG_PPS_DISABLE_DEBLOCKING_FILTER	(1ULL << 16)
2240 #define V4L2_HEVC_PPS_FLAG_LISTS_MODIFICATION_PRESENT		(1ULL << 17)
2241 #define V4L2_HEVC_PPS_FLAG_SLICE_SEGMENT_HEADER_EXTENSION_PRESENT (1ULL << 18)
2242 #define V4L2_HEVC_PPS_FLAG_DEBLOCKING_FILTER_CONTROL_PRESENT	(1ULL << 19)
2243 #define V4L2_HEVC_PPS_FLAG_UNIFORM_SPACING			(1ULL << 20)
2244 
2245 /**
2246  * struct v4l2_ctrl_hevc_pps - ITU-T Rec. H.265: Picture parameter set
2247  *
2248  * @pic_parameter_set_id: identifies the PPS for reference by other
2249  *			  syntax elements
2250  * @num_extra_slice_header_bits: specifies the number of extra slice header
2251  *				 bits that are present in the slice header RBSP
2252  *				 for coded pictures referring to the PPS.
2253  * @num_ref_idx_l0_default_active_minus1: this value plus 1 specifies the
2254  *                                        inferred value of num_ref_idx_l0_active_minus1
2255  * @num_ref_idx_l1_default_active_minus1: this value plus 1 specifies the
2256  *                                        inferred value of num_ref_idx_l1_active_minus1
2257  * @init_qp_minus26: this value plus 26 specifies the initial value of SliceQp Y for
2258  *		     each slice referring to the PPS
2259  * @diff_cu_qp_delta_depth: specifies the difference between the luma coding
2260  *			    tree block size and the minimum luma coding block
2261  *			    size of coding units that convey cu_qp_delta_abs
2262  *			    and cu_qp_delta_sign_flag
2263  * @pps_cb_qp_offset: specify the offsets to the luma quantization parameter Cb
2264  * @pps_cr_qp_offset: specify the offsets to the luma quantization parameter Cr
2265  * @num_tile_columns_minus1: this value plus 1 specifies the number of tile columns
2266  *			     partitioning the picture
2267  * @num_tile_rows_minus1: this value plus 1 specifies the number of tile rows partitioning
2268  *			  the picture
2269  * @column_width_minus1: this value plus 1 specifies the width of the each tile column in
2270  *			 units of coding tree blocks
2271  * @row_height_minus1: this value plus 1 specifies the height of the each tile row in
2272  *		       units of coding tree blocks
2273  * @pps_beta_offset_div2: specify the default deblocking parameter offsets for
2274  *			  beta divided by 2
2275  * @pps_tc_offset_div2: specify the default deblocking parameter offsets for tC
2276  *			divided by 2
2277  * @log2_parallel_merge_level_minus2: this value plus 2 specifies the value of
2278  *                                    the variable Log2ParMrgLevel
2279  * @reserved: padding field. Should be zeroed by applications.
2280  * @flags: see V4L2_HEVC_PPS_FLAG_{}
2281  */
2282 struct v4l2_ctrl_hevc_pps {
2283 	__u8	pic_parameter_set_id;
2284 	__u8	num_extra_slice_header_bits;
2285 	__u8	num_ref_idx_l0_default_active_minus1;
2286 	__u8	num_ref_idx_l1_default_active_minus1;
2287 	__s8	init_qp_minus26;
2288 	__u8	diff_cu_qp_delta_depth;
2289 	__s8	pps_cb_qp_offset;
2290 	__s8	pps_cr_qp_offset;
2291 	__u8	num_tile_columns_minus1;
2292 	__u8	num_tile_rows_minus1;
2293 	__u8	column_width_minus1[20];
2294 	__u8	row_height_minus1[22];
2295 	__s8	pps_beta_offset_div2;
2296 	__s8	pps_tc_offset_div2;
2297 	__u8	log2_parallel_merge_level_minus2;
2298 	__u8	reserved;
2299 	__u64	flags;
2300 };
2301 
2302 #define V4L2_HEVC_DPB_ENTRY_LONG_TERM_REFERENCE	0x01
2303 
2304 #define V4L2_HEVC_SEI_PIC_STRUCT_FRAME				0
2305 #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_FIELD			1
2306 #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_FIELD			2
2307 #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_BOTTOM			3
2308 #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_TOP			4
2309 #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_BOTTOM_TOP			5
2310 #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_TOP_BOTTOM		6
2311 #define V4L2_HEVC_SEI_PIC_STRUCT_FRAME_DOUBLING			7
2312 #define V4L2_HEVC_SEI_PIC_STRUCT_FRAME_TRIPLING			8
2313 #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_PAIRED_PREVIOUS_BOTTOM	9
2314 #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_PAIRED_PREVIOUS_TOP	10
2315 #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_PAIRED_NEXT_BOTTOM		11
2316 #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_PAIRED_NEXT_TOP		12
2317 
2318 #define V4L2_HEVC_DPB_ENTRIES_NUM_MAX		16
2319 
2320 /**
2321  * struct v4l2_hevc_dpb_entry - HEVC decoded picture buffer entry
2322  *
2323  * @timestamp: timestamp of the V4L2 capture buffer to use as reference.
2324  * @flags: long term flag for the reference frame
2325  * @field_pic: whether the reference is a field picture or a frame.
2326  * @reserved: padding field. Should be zeroed by applications.
2327  * @pic_order_cnt_val: the picture order count of the current picture.
2328  */
2329 struct v4l2_hevc_dpb_entry {
2330 	__u64	timestamp;
2331 	__u8	flags;
2332 	__u8	field_pic;
2333 	__u16	reserved;
2334 	__s32	pic_order_cnt_val;
2335 };
2336 
2337 /**
2338  * struct v4l2_hevc_pred_weight_table - HEVC weighted prediction parameters
2339  *
2340  * @delta_luma_weight_l0: the difference of the weighting factor applied
2341  *			  to the luma prediction value for list 0
2342  * @luma_offset_l0: the additive offset applied to the luma prediction value
2343  *		    for list 0
2344  * @delta_chroma_weight_l0: the difference of the weighting factor applied
2345  *			    to the chroma prediction values for list 0
2346  * @chroma_offset_l0: the difference of the additive offset applied to
2347  *		      the chroma prediction values for list 0
2348  * @delta_luma_weight_l1: the difference of the weighting factor applied
2349  *			  to the luma prediction value for list 1
2350  * @luma_offset_l1: the additive offset applied to the luma prediction value
2351  *		    for list 1
2352  * @delta_chroma_weight_l1: the difference of the weighting factor applied
2353  *			    to the chroma prediction values for list 1
2354  * @chroma_offset_l1: the difference of the additive offset applied to
2355  *		      the chroma prediction values for list 1
2356  * @luma_log2_weight_denom: the base 2 logarithm of the denominator for
2357  *			    all luma weighting factors
2358  * @delta_chroma_log2_weight_denom: the difference of the base 2 logarithm
2359  *				    of the denominator for all chroma
2360  *				    weighting factors
2361  */
2362 struct v4l2_hevc_pred_weight_table {
2363 	__s8	delta_luma_weight_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2364 	__s8	luma_offset_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2365 	__s8	delta_chroma_weight_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2];
2366 	__s8	chroma_offset_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2];
2367 
2368 	__s8	delta_luma_weight_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2369 	__s8	luma_offset_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2370 	__s8	delta_chroma_weight_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2];
2371 	__s8	chroma_offset_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2];
2372 
2373 	__u8	luma_log2_weight_denom;
2374 	__s8	delta_chroma_log2_weight_denom;
2375 };
2376 
2377 #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_SAO_LUMA		(1ULL << 0)
2378 #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_SAO_CHROMA		(1ULL << 1)
2379 #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_TEMPORAL_MVP_ENABLED	(1ULL << 2)
2380 #define V4L2_HEVC_SLICE_PARAMS_FLAG_MVD_L1_ZERO			(1ULL << 3)
2381 #define V4L2_HEVC_SLICE_PARAMS_FLAG_CABAC_INIT			(1ULL << 4)
2382 #define V4L2_HEVC_SLICE_PARAMS_FLAG_COLLOCATED_FROM_L0		(1ULL << 5)
2383 #define V4L2_HEVC_SLICE_PARAMS_FLAG_USE_INTEGER_MV		(1ULL << 6)
2384 #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_DEBLOCKING_FILTER_DISABLED (1ULL << 7)
2385 #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_LOOP_FILTER_ACROSS_SLICES_ENABLED (1ULL << 8)
2386 #define V4L2_HEVC_SLICE_PARAMS_FLAG_DEPENDENT_SLICE_SEGMENT	(1ULL << 9)
2387 
2388 /**
2389  * struct v4l2_ctrl_hevc_slice_params - HEVC slice parameters
2390  *
2391  * This control is a dynamically sized 1-dimensional array,
2392  * V4L2_CTRL_FLAG_DYNAMIC_ARRAY flag must be set when using it.
2393  *
2394  * @bit_size: size (in bits) of the current slice data
2395  * @data_byte_offset: offset (in bytes) to the video data in the current slice data
2396  * @num_entry_point_offsets: specifies the number of entry point offset syntax
2397  *			     elements in the slice header.
2398  * @nal_unit_type: specifies the coding type of the slice (B, P or I)
2399  * @nuh_temporal_id_plus1: minus 1 specifies a temporal identifier for the NAL unit
2400  * @slice_type: see V4L2_HEVC_SLICE_TYPE_{}
2401  * @colour_plane_id: specifies the colour plane associated with the current slice
2402  * @slice_pic_order_cnt: specifies the picture order count
2403  * @num_ref_idx_l0_active_minus1: this value plus 1 specifies the maximum
2404  *                                reference index for reference picture list 0
2405  *                                that may be used to decode the slice
2406  * @num_ref_idx_l1_active_minus1: this value plus 1 specifies the maximum
2407  *                                reference index for reference picture list 1
2408  *                                that may be used to decode the slice
2409  * @collocated_ref_idx: specifies the reference index of the collocated picture used
2410  *			for temporal motion vector prediction
2411  * @five_minus_max_num_merge_cand: specifies the maximum number of merging
2412  *				   motion vector prediction candidates supported in
2413  *				   the slice subtracted from 5
2414  * @slice_qp_delta: specifies the initial value of QpY to be used for the coding
2415  *		    blocks in the slice
2416  * @slice_cb_qp_offset: specifies a difference to be added to the value of pps_cb_qp_offset
2417  * @slice_cr_qp_offset: specifies a difference to be added to the value of pps_cr_qp_offset
2418  * @slice_act_y_qp_offset: screen content extension parameters
2419  * @slice_act_cb_qp_offset: screen content extension parameters
2420  * @slice_act_cr_qp_offset: screen content extension parameters
2421  * @slice_beta_offset_div2: specify the deblocking parameter offsets for beta divided by 2
2422  * @slice_tc_offset_div2: specify the deblocking parameter offsets for tC divided by 2
2423  * @pic_struct: indicates whether a picture should be displayed as a frame or as one or
2424  *		more fields
2425  * @reserved0: padding field. Should be zeroed by applications.
2426  * @slice_segment_addr: specifies the address of the first coding tree block in
2427  *			the slice segment
2428  * @ref_idx_l0: the list of L0 reference elements as indices in the DPB
2429  * @ref_idx_l1: the list of L1 reference elements as indices in the DPB
2430  * @short_term_ref_pic_set_size: specifies the size of short-term reference
2431  *				 pictures set included in the SPS
2432  * @long_term_ref_pic_set_size: specifies the size of long-term reference
2433  *				pictures set include in the SPS
2434  * @pred_weight_table: the prediction weight coefficients for inter-picture
2435  *		       prediction
2436  * @reserved1: padding field. Should be zeroed by applications.
2437  * @flags: see V4L2_HEVC_SLICE_PARAMS_FLAG_{}
2438  */
2439 struct v4l2_ctrl_hevc_slice_params {
2440 	__u32	bit_size;
2441 	__u32	data_byte_offset;
2442 	__u32	num_entry_point_offsets;
2443 
2444 	/* ISO/IEC 23008-2, ITU-T Rec. H.265: NAL unit header */
2445 	__u8	nal_unit_type;
2446 	__u8	nuh_temporal_id_plus1;
2447 
2448 	/* ISO/IEC 23008-2, ITU-T Rec. H.265: General slice segment header */
2449 	__u8	slice_type;
2450 	__u8	colour_plane_id;
2451 	__s32	slice_pic_order_cnt;
2452 	__u8	num_ref_idx_l0_active_minus1;
2453 	__u8	num_ref_idx_l1_active_minus1;
2454 	__u8	collocated_ref_idx;
2455 	__u8	five_minus_max_num_merge_cand;
2456 	__s8	slice_qp_delta;
2457 	__s8	slice_cb_qp_offset;
2458 	__s8	slice_cr_qp_offset;
2459 	__s8	slice_act_y_qp_offset;
2460 	__s8	slice_act_cb_qp_offset;
2461 	__s8	slice_act_cr_qp_offset;
2462 	__s8	slice_beta_offset_div2;
2463 	__s8	slice_tc_offset_div2;
2464 
2465 	/* ISO/IEC 23008-2, ITU-T Rec. H.265: Picture timing SEI message */
2466 	__u8	pic_struct;
2467 
2468 	__u8	reserved0[3];
2469 	/* ISO/IEC 23008-2, ITU-T Rec. H.265: General slice segment header */
2470 	__u32	slice_segment_addr;
2471 	__u8	ref_idx_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2472 	__u8	ref_idx_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2473 	__u16	short_term_ref_pic_set_size;
2474 	__u16	long_term_ref_pic_set_size;
2475 
2476 	/* ISO/IEC 23008-2, ITU-T Rec. H.265: Weighted prediction parameter */
2477 	struct v4l2_hevc_pred_weight_table pred_weight_table;
2478 
2479 	__u8	reserved1[2];
2480 	__u64	flags;
2481 };
2482 
2483 #define V4L2_HEVC_DECODE_PARAM_FLAG_IRAP_PIC		0x1
2484 #define V4L2_HEVC_DECODE_PARAM_FLAG_IDR_PIC		0x2
2485 #define V4L2_HEVC_DECODE_PARAM_FLAG_NO_OUTPUT_OF_PRIOR  0x4
2486 
2487 /**
2488  * struct v4l2_ctrl_hevc_decode_params - HEVC decode parameters
2489  *
2490  * @pic_order_cnt_val: picture order count
2491  * @short_term_ref_pic_set_size: specifies the size of short-term reference
2492  *				 pictures set included in the SPS of the first slice
2493  * @long_term_ref_pic_set_size: specifies the size of long-term reference
2494  *				pictures set include in the SPS of the first slice
2495  * @num_active_dpb_entries: the number of entries in dpb
2496  * @num_poc_st_curr_before: the number of reference pictures in the short-term
2497  *			    set that come before the current frame
2498  * @num_poc_st_curr_after: the number of reference pictures in the short-term
2499  *			   set that come after the current frame
2500  * @num_poc_lt_curr: the number of reference pictures in the long-term set
2501  * @poc_st_curr_before: provides the index of the short term before references
2502  *			in DPB array
2503  * @poc_st_curr_after: provides the index of the short term after references
2504  *		       in DPB array
2505  * @poc_lt_curr: provides the index of the long term references in DPB array
2506  * @num_delta_pocs_of_ref_rps_idx: same as the derived value NumDeltaPocs[RefRpsIdx],
2507  *				   can be used to parse the RPS data in slice headers
2508  *				   instead of skipping it with @short_term_ref_pic_set_size.
2509  * @reserved: padding field. Should be zeroed by applications.
2510  * @dpb: the decoded picture buffer, for meta-data about reference frames
2511  * @flags: see V4L2_HEVC_DECODE_PARAM_FLAG_{}
2512  */
2513 struct v4l2_ctrl_hevc_decode_params {
2514 	__s32	pic_order_cnt_val;
2515 	__u16	short_term_ref_pic_set_size;
2516 	__u16	long_term_ref_pic_set_size;
2517 	__u8	num_active_dpb_entries;
2518 	__u8	num_poc_st_curr_before;
2519 	__u8	num_poc_st_curr_after;
2520 	__u8	num_poc_lt_curr;
2521 	__u8	poc_st_curr_before[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2522 	__u8	poc_st_curr_after[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2523 	__u8	poc_lt_curr[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2524 	__u8	num_delta_pocs_of_ref_rps_idx;
2525 	__u8	reserved[3];
2526 	struct	v4l2_hevc_dpb_entry dpb[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2527 	__u64	flags;
2528 };
2529 
2530 /**
2531  * struct v4l2_ctrl_hevc_scaling_matrix - HEVC scaling lists parameters
2532  *
2533  * @scaling_list_4x4: scaling list is used for the scaling process for
2534  *		      transform coefficients. The values on each scaling
2535  *		      list are expected in raster scan order
2536  * @scaling_list_8x8: scaling list is used for the scaling process for
2537  *		      transform coefficients. The values on each scaling
2538  *		      list are expected in raster scan order
2539  * @scaling_list_16x16:	scaling list is used for the scaling process for
2540  *			transform coefficients. The values on each scaling
2541  *			list are expected in raster scan order
2542  * @scaling_list_32x32:	scaling list is used for the scaling process for
2543  *			transform coefficients. The values on each scaling
2544  *			list are expected in raster scan order
2545  * @scaling_list_dc_coef_16x16:	scaling list is used for the scaling process
2546  *				for transform coefficients. The values on each
2547  *				scaling list are expected in raster scan order.
2548  * @scaling_list_dc_coef_32x32:	scaling list is used for the scaling process
2549  *				for transform coefficients. The values on each
2550  *				scaling list are expected in raster scan order.
2551  */
2552 struct v4l2_ctrl_hevc_scaling_matrix {
2553 	__u8	scaling_list_4x4[6][16];
2554 	__u8	scaling_list_8x8[6][64];
2555 	__u8	scaling_list_16x16[6][64];
2556 	__u8	scaling_list_32x32[2][64];
2557 	__u8	scaling_list_dc_coef_16x16[6];
2558 	__u8	scaling_list_dc_coef_32x32[2];
2559 };
2560 
2561 #define V4L2_HEVC_EXT_SPS_ST_RPS_FLAG_INTER_REF_PIC_SET_PRED	0x1
2562 
2563 /*
2564  * struct v4l2_ctrl_hevc_ext_sps_st_rps - HEVC short term RPS parameters
2565  *
2566  * Dynamic size 1-dimension array for short term RPS. The number of elements
2567  * is v4l2_ctrl_hevc_sps::num_short_term_ref_pic_sets. It can contain up to 65 elements.
2568  *
2569  * @delta_idx_minus1: Specifies the delta compare to the index. See details in section 7.4.8
2570  *                    "Short-term reference picture set semantics" of the specification.
2571  * @delta_rps_sign: Sign of the delta as specified in section 7.4.8 "Short-term reference picture
2572  *                  set semantics" of the specification.
2573  * @abs_delta_rps_minus1: Absolute delta RPS as specified in section 7.4.8 "Short-term reference
2574  *                        picture set semantics" of the specification.
2575  * @num_negative_pics: Number of short-term RPS entries that have picture order count values less
2576  *                     than the picture order count value of the current picture.
2577  * @num_positive_pics: Number of short-term RPS entries that have picture order count values
2578  *                     greater than the picture order count value of the current picture.
2579  * @used_by_curr_pic: Bit j specifies if short-term RPS j is used by the current picture.
2580  * @use_delta_flag: Bit j equals to 1 specifies that the j-th entry in the source candidate
2581  *                  short-term RPS is included in this candidate short-term RPS.
2582  * @delta_poc_s0_minus1: Specifies the negative picture order count delta for the i-th entry in
2583  *                       the short-term RPS. See details in section 7.4.8 "Short-term reference
2584  *                       picture set semantics" of the specification.
2585  * @delta_poc_s1_minus1: Specifies the positive picture order count delta for the i-th entry in
2586  *                       the short-term RPS. See details in section 7.4.8 "Short-term reference
2587  *                       picture set semantics" of the specification.
2588  * @flags: See V4L2_HEVC_EXT_SPS_ST_RPS_FLAG_{}
2589  */
2590 struct v4l2_ctrl_hevc_ext_sps_st_rps {
2591 	__u8	delta_idx_minus1;
2592 	__u8	delta_rps_sign;
2593 	__u8	num_negative_pics;
2594 	__u8	num_positive_pics;
2595 	__u32	used_by_curr_pic;
2596 	__u32	use_delta_flag;
2597 	__u16	abs_delta_rps_minus1;
2598 	__u16	delta_poc_s0_minus1[16];
2599 	__u16	delta_poc_s1_minus1[16];
2600 	__u16	flags;
2601 };
2602 
2603 #define V4L2_HEVC_EXT_SPS_LT_RPS_FLAG_USED_LT		0x1
2604 
2605 /*
2606  * struct v4l2_ctrl_hevc_ext_sps_lt_rps - HEVC long term RPS parameters
2607  *
2608  * Dynamic size 1-dimension array for long term RPS. The number of elements
2609  * is v4l2_ctrl_hevc_sps::num_long_term_ref_pics_sps. It can contain up to 65 elements.
2610  *
2611  * @lt_ref_pic_poc_lsb_sps: picture order count modulo MaxPicOrderCntLsb of the i-th candidate
2612  *                          long-term reference picture.
2613  * @flags: See V4L2_HEVC_EXT_SPS_LT_RPS_FLAG_{}
2614  */
2615 struct v4l2_ctrl_hevc_ext_sps_lt_rps {
2616 	__u16	lt_ref_pic_poc_lsb_sps;
2617 	__u16	flags;
2618 };
2619 
2620 /* Stateless VP9 controls */
2621 
2622 #define V4L2_VP9_LOOP_FILTER_FLAG_DELTA_ENABLED	0x1
2623 #define V4L2_VP9_LOOP_FILTER_FLAG_DELTA_UPDATE	0x2
2624 
2625 /**
2626  * struct v4l2_vp9_loop_filter - VP9 loop filter parameters
2627  *
2628  * @ref_deltas: contains the adjustment needed for the filter level based on the
2629  * chosen reference frame. If this syntax element is not present in the bitstream,
2630  * users should pass its last value.
2631  * @mode_deltas: contains the adjustment needed for the filter level based on the
2632  * chosen mode.	If this syntax element is not present in the bitstream, users should
2633  * pass its last value.
2634  * @level: indicates the loop filter strength.
2635  * @sharpness: indicates the sharpness level.
2636  * @flags: combination of V4L2_VP9_LOOP_FILTER_FLAG_{} flags.
2637  * @reserved: padding field. Should be zeroed by applications.
2638  *
2639  * This structure contains all loop filter related parameters. See sections
2640  * '7.2.8 Loop filter semantics' of the VP9 specification for more details.
2641  */
2642 struct v4l2_vp9_loop_filter {
2643 	__s8 ref_deltas[4];
2644 	__s8 mode_deltas[2];
2645 	__u8 level;
2646 	__u8 sharpness;
2647 	__u8 flags;
2648 	__u8 reserved[7];
2649 };
2650 
2651 /**
2652  * struct v4l2_vp9_quantization - VP9 quantization parameters
2653  *
2654  * @base_q_idx: indicates the base frame qindex.
2655  * @delta_q_y_dc: indicates the Y DC quantizer relative to base_q_idx.
2656  * @delta_q_uv_dc: indicates the UV DC quantizer relative to base_q_idx.
2657  * @delta_q_uv_ac: indicates the UV AC quantizer relative to base_q_idx.
2658  * @reserved: padding field. Should be zeroed by applications.
2659  *
2660  * Encodes the quantization parameters. See section '7.2.9 Quantization params
2661  * syntax' of the VP9 specification for more details.
2662  */
2663 struct v4l2_vp9_quantization {
2664 	__u8 base_q_idx;
2665 	__s8 delta_q_y_dc;
2666 	__s8 delta_q_uv_dc;
2667 	__s8 delta_q_uv_ac;
2668 	__u8 reserved[4];
2669 };
2670 
2671 #define V4L2_VP9_SEGMENTATION_FLAG_ENABLED		0x01
2672 #define V4L2_VP9_SEGMENTATION_FLAG_UPDATE_MAP		0x02
2673 #define V4L2_VP9_SEGMENTATION_FLAG_TEMPORAL_UPDATE	0x04
2674 #define V4L2_VP9_SEGMENTATION_FLAG_UPDATE_DATA		0x08
2675 #define V4L2_VP9_SEGMENTATION_FLAG_ABS_OR_DELTA_UPDATE	0x10
2676 
2677 #define V4L2_VP9_SEG_LVL_ALT_Q				0
2678 #define V4L2_VP9_SEG_LVL_ALT_L				1
2679 #define V4L2_VP9_SEG_LVL_REF_FRAME			2
2680 #define V4L2_VP9_SEG_LVL_SKIP				3
2681 #define V4L2_VP9_SEG_LVL_MAX				4
2682 
2683 #define V4L2_VP9_SEGMENT_FEATURE_ENABLED(id)	(1 << (id))
2684 #define V4L2_VP9_SEGMENT_FEATURE_ENABLED_MASK	0xf
2685 
2686 /**
2687  * struct v4l2_vp9_segmentation - VP9 segmentation parameters
2688  *
2689  * @feature_data: data attached to each feature. Data entry is only valid if
2690  * the feature is enabled. The array shall be indexed with segment number as
2691  * the first dimension (0..7) and one of V4L2_VP9_SEG_{} as the second dimension.
2692  * @feature_enabled: bitmask defining which features are enabled in each segment.
2693  * The value for each segment is a combination of V4L2_VP9_SEGMENT_FEATURE_ENABLED(id)
2694  * values where id is one of V4L2_VP9_SEG_LVL_{}.
2695  * @tree_probs: specifies the probability values to be used when decoding a
2696  * Segment-ID. See '5.15. Segmentation map' section of the VP9 specification
2697  * for more details.
2698  * @pred_probs: specifies the probability values to be used when decoding a
2699  * Predicted-Segment-ID. See '6.4.14. Get segment id syntax' section of :ref:`vp9`
2700  * for more details.
2701  * @flags: combination of V4L2_VP9_SEGMENTATION_FLAG_{} flags.
2702  * @reserved: padding field. Should be zeroed by applications.
2703  *
2704  * Encodes the quantization parameters. See section '7.2.10 Segmentation params syntax' of
2705  * the VP9 specification for more details.
2706  */
2707 struct v4l2_vp9_segmentation {
2708 	__s16 feature_data[8][4];
2709 	__u8 feature_enabled[8];
2710 	__u8 tree_probs[7];
2711 	__u8 pred_probs[3];
2712 	__u8 flags;
2713 	__u8 reserved[5];
2714 };
2715 
2716 #define V4L2_VP9_FRAME_FLAG_KEY_FRAME			0x001
2717 #define V4L2_VP9_FRAME_FLAG_SHOW_FRAME			0x002
2718 #define V4L2_VP9_FRAME_FLAG_ERROR_RESILIENT		0x004
2719 #define V4L2_VP9_FRAME_FLAG_INTRA_ONLY			0x008
2720 #define V4L2_VP9_FRAME_FLAG_ALLOW_HIGH_PREC_MV		0x010
2721 #define V4L2_VP9_FRAME_FLAG_REFRESH_FRAME_CTX		0x020
2722 #define V4L2_VP9_FRAME_FLAG_PARALLEL_DEC_MODE		0x040
2723 #define V4L2_VP9_FRAME_FLAG_X_SUBSAMPLING		0x080
2724 #define V4L2_VP9_FRAME_FLAG_Y_SUBSAMPLING		0x100
2725 #define V4L2_VP9_FRAME_FLAG_COLOR_RANGE_FULL_SWING	0x200
2726 
2727 #define V4L2_VP9_SIGN_BIAS_LAST				0x1
2728 #define V4L2_VP9_SIGN_BIAS_GOLDEN			0x2
2729 #define V4L2_VP9_SIGN_BIAS_ALT				0x4
2730 
2731 #define V4L2_VP9_RESET_FRAME_CTX_NONE			0
2732 #define V4L2_VP9_RESET_FRAME_CTX_SPEC			1
2733 #define V4L2_VP9_RESET_FRAME_CTX_ALL			2
2734 
2735 #define V4L2_VP9_INTERP_FILTER_EIGHTTAP			0
2736 #define V4L2_VP9_INTERP_FILTER_EIGHTTAP_SMOOTH		1
2737 #define V4L2_VP9_INTERP_FILTER_EIGHTTAP_SHARP		2
2738 #define V4L2_VP9_INTERP_FILTER_BILINEAR			3
2739 #define V4L2_VP9_INTERP_FILTER_SWITCHABLE		4
2740 
2741 #define V4L2_VP9_REFERENCE_MODE_SINGLE_REFERENCE	0
2742 #define V4L2_VP9_REFERENCE_MODE_COMPOUND_REFERENCE	1
2743 #define V4L2_VP9_REFERENCE_MODE_SELECT			2
2744 
2745 #define V4L2_VP9_PROFILE_MAX				3
2746 
2747 #define V4L2_CID_STATELESS_VP9_FRAME	(V4L2_CID_CODEC_STATELESS_BASE + 300)
2748 /**
2749  * struct v4l2_ctrl_vp9_frame - VP9 frame decoding control
2750  *
2751  * @lf: loop filter parameters. See &v4l2_vp9_loop_filter for more details.
2752  * @quant: quantization parameters. See &v4l2_vp9_quantization for more details.
2753  * @seg: segmentation parameters. See &v4l2_vp9_segmentation for more details.
2754  * @flags: combination of V4L2_VP9_FRAME_FLAG_{} flags.
2755  * @compressed_header_size: compressed header size in bytes.
2756  * @uncompressed_header_size: uncompressed header size in bytes.
2757  * @frame_width_minus_1: add 1 to it and you'll get the frame width expressed in pixels.
2758  * @frame_height_minus_1: add 1 to it and you'll get the frame height expressed in pixels.
2759  * @render_width_minus_1: add 1 to it and you'll get the expected render width expressed in
2760  * pixels. This is not used during the decoding process but might be used by HW scalers
2761  * to prepare a frame that's ready for scanout.
2762  * @render_height_minus_1: add 1 to it and you'll get the expected render height expressed in
2763  * pixels. This is not used during the decoding process but might be used by HW scalers
2764  * to prepare a frame that's ready for scanout.
2765  * @last_frame_ts: "last" reference buffer timestamp.
2766  * The timestamp refers to the timestamp field in struct v4l2_buffer.
2767  * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
2768  * @golden_frame_ts: "golden" reference buffer timestamp.
2769  * The timestamp refers to the timestamp field in struct v4l2_buffer.
2770  * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
2771  * @alt_frame_ts: "alt" reference buffer timestamp.
2772  * The timestamp refers to the timestamp field in struct v4l2_buffer.
2773  * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
2774  * @ref_frame_sign_bias: a bitfield specifying whether the sign bias is set for a given
2775  * reference frame. Either of V4L2_VP9_SIGN_BIAS_{}.
2776  * @reset_frame_context: specifies whether the frame context should be reset to default values.
2777  * Either of V4L2_VP9_RESET_FRAME_CTX_{}.
2778  * @frame_context_idx: frame context that should be used/updated.
2779  * @profile: VP9 profile. Can be 0, 1, 2 or 3.
2780  * @bit_depth: bits per components. Can be 8, 10 or 12. Note that not all profiles support
2781  * 10 and/or 12 bits depths.
2782  * @interpolation_filter: specifies the filter selection used for performing inter prediction.
2783  * Set to one of V4L2_VP9_INTERP_FILTER_{}.
2784  * @tile_cols_log2: specifies the base 2 logarithm of the width of each tile (where the width
2785  * is measured in units of 8x8 blocks). Shall be less than or equal to 6.
2786  * @tile_rows_log2: specifies the base 2 logarithm of the height of each tile (where the height
2787  * is measured in units of 8x8 blocks).
2788  * @reference_mode: specifies the type of inter prediction to be used.
2789  * Set to one of V4L2_VP9_REFERENCE_MODE_{}.
2790  * @reserved: padding field. Should be zeroed by applications.
2791  */
2792 struct v4l2_ctrl_vp9_frame {
2793 	struct v4l2_vp9_loop_filter lf;
2794 	struct v4l2_vp9_quantization quant;
2795 	struct v4l2_vp9_segmentation seg;
2796 	__u32 flags;
2797 	__u16 compressed_header_size;
2798 	__u16 uncompressed_header_size;
2799 	__u16 frame_width_minus_1;
2800 	__u16 frame_height_minus_1;
2801 	__u16 render_width_minus_1;
2802 	__u16 render_height_minus_1;
2803 	__u64 last_frame_ts;
2804 	__u64 golden_frame_ts;
2805 	__u64 alt_frame_ts;
2806 	__u8 ref_frame_sign_bias;
2807 	__u8 reset_frame_context;
2808 	__u8 frame_context_idx;
2809 	__u8 profile;
2810 	__u8 bit_depth;
2811 	__u8 interpolation_filter;
2812 	__u8 tile_cols_log2;
2813 	__u8 tile_rows_log2;
2814 	__u8 reference_mode;
2815 	__u8 reserved[7];
2816 };
2817 
2818 #define V4L2_VP9_NUM_FRAME_CTX	4
2819 
2820 /**
2821  * struct v4l2_vp9_mv_probs - VP9 Motion vector probability updates
2822  * @joint: motion vector joint probability updates.
2823  * @sign: motion vector sign probability updates.
2824  * @classes: motion vector class probability updates.
2825  * @class0_bit: motion vector class0 bit probability updates.
2826  * @bits: motion vector bits probability updates.
2827  * @class0_fr: motion vector class0 fractional bit probability updates.
2828  * @fr: motion vector fractional bit probability updates.
2829  * @class0_hp: motion vector class0 high precision fractional bit probability updates.
2830  * @hp: motion vector high precision fractional bit probability updates.
2831  *
2832  * This structure contains new values of motion vector probabilities.
2833  * A value of zero in an array element means there is no update of the relevant probability.
2834  * See `struct v4l2_vp9_prob_updates` for details.
2835  */
2836 struct v4l2_vp9_mv_probs {
2837 	__u8 joint[3];
2838 	__u8 sign[2];
2839 	__u8 classes[2][10];
2840 	__u8 class0_bit[2];
2841 	__u8 bits[2][10];
2842 	__u8 class0_fr[2][2][3];
2843 	__u8 fr[2][3];
2844 	__u8 class0_hp[2];
2845 	__u8 hp[2];
2846 };
2847 
2848 #define V4L2_CID_STATELESS_VP9_COMPRESSED_HDR	(V4L2_CID_CODEC_STATELESS_BASE + 301)
2849 
2850 #define V4L2_VP9_TX_MODE_ONLY_4X4			0
2851 #define V4L2_VP9_TX_MODE_ALLOW_8X8			1
2852 #define V4L2_VP9_TX_MODE_ALLOW_16X16			2
2853 #define V4L2_VP9_TX_MODE_ALLOW_32X32			3
2854 #define V4L2_VP9_TX_MODE_SELECT				4
2855 
2856 /**
2857  * struct v4l2_ctrl_vp9_compressed_hdr - VP9 probability updates control
2858  * @tx_mode: specifies the TX mode. Set to one of V4L2_VP9_TX_MODE_{}.
2859  * @tx8: TX 8x8 probability updates.
2860  * @tx16: TX 16x16 probability updates.
2861  * @tx32: TX 32x32 probability updates.
2862  * @coef: coefficient probability updates.
2863  * @skip: skip probability updates.
2864  * @inter_mode: inter mode probability updates.
2865  * @interp_filter: interpolation filter probability updates.
2866  * @is_inter: is inter-block probability updates.
2867  * @comp_mode: compound prediction mode probability updates.
2868  * @single_ref: single ref probability updates.
2869  * @comp_ref: compound ref probability updates.
2870  * @y_mode: Y prediction mode probability updates.
2871  * @uv_mode: UV prediction mode probability updates.
2872  * @partition: partition probability updates.
2873  * @mv: motion vector probability updates.
2874  *
2875  * This structure holds the probabilities update as parsed in the compressed
2876  * header (Spec 6.3). These values represent the value of probability update after
2877  * being translated with inv_map_table[] (see 6.3.5). A value of zero in an array element
2878  * means that there is no update of the relevant probability.
2879  *
2880  * This control is optional and needs to be used when dealing with the hardware which is
2881  * not capable of parsing the compressed header itself. Only drivers which need it will
2882  * implement it.
2883  */
2884 struct v4l2_ctrl_vp9_compressed_hdr {
2885 	__u8 tx_mode;
2886 	__u8 tx8[2][1];
2887 	__u8 tx16[2][2];
2888 	__u8 tx32[2][3];
2889 	__u8 coef[4][2][2][6][6][3];
2890 	__u8 skip[3];
2891 	__u8 inter_mode[7][3];
2892 	__u8 interp_filter[4][2];
2893 	__u8 is_inter[4];
2894 	__u8 comp_mode[5];
2895 	__u8 single_ref[5][2];
2896 	__u8 comp_ref[5];
2897 	__u8 y_mode[4][9];
2898 	__u8 uv_mode[10][9];
2899 	__u8 partition[16][3];
2900 
2901 	struct v4l2_vp9_mv_probs mv;
2902 };
2903 
2904 /* Stateless AV1 controls */
2905 
2906 #define V4L2_AV1_TOTAL_REFS_PER_FRAME	8
2907 #define V4L2_AV1_CDEF_MAX		8
2908 #define V4L2_AV1_NUM_PLANES_MAX		3 /* 1 if monochrome, 3 otherwise */
2909 #define V4L2_AV1_MAX_SEGMENTS		8
2910 #define V4L2_AV1_MAX_OPERATING_POINTS	(1 << 5) /* 5 bits to encode */
2911 #define V4L2_AV1_REFS_PER_FRAME		7
2912 #define V4L2_AV1_MAX_NUM_Y_POINTS	(1 << 4) /* 4 bits to encode */
2913 #define V4L2_AV1_MAX_NUM_CB_POINTS	(1 << 4) /* 4 bits to encode */
2914 #define V4L2_AV1_MAX_NUM_CR_POINTS	(1 << 4) /* 4 bits to encode */
2915 #define V4L2_AV1_AR_COEFFS_SIZE		25 /* (2 * 3 * (3 + 1)) + 1 */
2916 #define V4L2_AV1_MAX_NUM_PLANES		3
2917 #define V4L2_AV1_MAX_TILE_COLS		64
2918 #define V4L2_AV1_MAX_TILE_ROWS		64
2919 #define V4L2_AV1_MAX_TILE_COUNT		512
2920 
2921 #define V4L2_AV1_SEQUENCE_FLAG_STILL_PICTURE		  0x00000001
2922 #define V4L2_AV1_SEQUENCE_FLAG_USE_128X128_SUPERBLOCK	  0x00000002
2923 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_FILTER_INTRA	  0x00000004
2924 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_INTRA_EDGE_FILTER   0x00000008
2925 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_INTERINTRA_COMPOUND 0x00000010
2926 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_MASKED_COMPOUND	  0x00000020
2927 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_WARPED_MOTION	  0x00000040
2928 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_DUAL_FILTER	  0x00000080
2929 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_ORDER_HINT	  0x00000100
2930 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_JNT_COMP		  0x00000200
2931 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_REF_FRAME_MVS	  0x00000400
2932 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_SUPERRES		  0x00000800
2933 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_CDEF		  0x00001000
2934 #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_RESTORATION	  0x00002000
2935 #define V4L2_AV1_SEQUENCE_FLAG_MONO_CHROME		  0x00004000
2936 #define V4L2_AV1_SEQUENCE_FLAG_COLOR_RANGE		  0x00008000
2937 #define V4L2_AV1_SEQUENCE_FLAG_SUBSAMPLING_X		  0x00010000
2938 #define V4L2_AV1_SEQUENCE_FLAG_SUBSAMPLING_Y		  0x00020000
2939 #define V4L2_AV1_SEQUENCE_FLAG_FILM_GRAIN_PARAMS_PRESENT  0x00040000
2940 #define V4L2_AV1_SEQUENCE_FLAG_SEPARATE_UV_DELTA_Q	  0x00080000
2941 
2942 #define V4L2_CID_STATELESS_AV1_SEQUENCE (V4L2_CID_CODEC_STATELESS_BASE + 500)
2943 /**
2944  * struct v4l2_ctrl_av1_sequence - AV1 Sequence
2945  *
2946  * Represents an AV1 Sequence OBU. See section 5.5 "Sequence header OBU syntax"
2947  * for more details.
2948  *
2949  * @flags: See V4L2_AV1_SEQUENCE_FLAG_{}.
2950  * @seq_profile: specifies the features that can be used in the coded video
2951  * sequence.
2952  * @order_hint_bits: specifies the number of bits used for the order_hint field
2953  * at each frame.
2954  * @bit_depth: the bitdepth to use for the sequence as described in section
2955  * 5.5.2 "Color config syntax".
2956  * @reserved: padding field. Should be zeroed by applications.
2957  * @max_frame_width_minus_1: specifies the maximum frame width minus 1 for the
2958  * frames represented by this sequence header.
2959  * @max_frame_height_minus_1: specifies the maximum frame height minus 1 for the
2960  * frames represented by this sequence header.
2961  */
2962 struct v4l2_ctrl_av1_sequence {
2963 	__u32 flags;
2964 	__u8 seq_profile;
2965 	__u8 order_hint_bits;
2966 	__u8 bit_depth;
2967 	__u8 reserved;
2968 	__u16 max_frame_width_minus_1;
2969 	__u16 max_frame_height_minus_1;
2970 };
2971 
2972 #define V4L2_CID_STATELESS_AV1_TILE_GROUP_ENTRY (V4L2_CID_CODEC_STATELESS_BASE + 501)
2973 /**
2974  * struct v4l2_ctrl_av1_tile_group_entry - AV1 Tile Group entry
2975  *
2976  * Represents a single AV1 tile inside an AV1 Tile Group. Note that MiRowStart,
2977  * MiRowEnd, MiColStart and MiColEnd can be retrieved from struct
2978  * v4l2_av1_tile_info in struct v4l2_ctrl_av1_frame using tile_row and
2979  * tile_col. See section 6.10.1 "General tile group OBU semantics" for more
2980  * details.
2981  *
2982  * @tile_offset: offset from the OBU data, i.e. where the coded tile data
2983  * actually starts.
2984  * @tile_size: specifies the size in bytes of the coded tile. Equivalent to
2985  * "TileSize" in the AV1 Specification.
2986  * @tile_row: specifies the row of the current tile. Equivalent to "TileRow" in
2987  * the AV1 Specification.
2988  * @tile_col: specifies the col of the current tile. Equivalent to "TileCol" in
2989  * the AV1 Specification.
2990  */
2991 struct v4l2_ctrl_av1_tile_group_entry {
2992 	__u32 tile_offset;
2993 	__u32 tile_size;
2994 	__u32 tile_row;
2995 	__u32 tile_col;
2996 };
2997 
2998 /**
2999  * enum v4l2_av1_warp_model - AV1 Warp Model as described in section 3
3000  * "Symbols and abbreviated terms" of the AV1 Specification.
3001  *
3002  * @V4L2_AV1_WARP_MODEL_IDENTITY: Warp model is just an identity transform.
3003  * @V4L2_AV1_WARP_MODEL_TRANSLATION: Warp model is a pure translation.
3004  * @V4L2_AV1_WARP_MODEL_ROTZOOM: Warp model is a rotation + symmetric zoom +
3005  * translation.
3006  * @V4L2_AV1_WARP_MODEL_AFFINE: Warp model is a general affine transform.
3007  */
3008 enum v4l2_av1_warp_model {
3009 	V4L2_AV1_WARP_MODEL_IDENTITY = 0,
3010 	V4L2_AV1_WARP_MODEL_TRANSLATION = 1,
3011 	V4L2_AV1_WARP_MODEL_ROTZOOM = 2,
3012 	V4L2_AV1_WARP_MODEL_AFFINE = 3,
3013 };
3014 
3015 /**
3016  * enum v4l2_av1_reference_frame - AV1 reference frames
3017  *
3018  * @V4L2_AV1_REF_INTRA_FRAME: Intra Frame Reference
3019  * @V4L2_AV1_REF_LAST_FRAME: Last Reference Frame
3020  * @V4L2_AV1_REF_LAST2_FRAME: Last2 Reference Frame
3021  * @V4L2_AV1_REF_LAST3_FRAME: Last3 Reference Frame
3022  * @V4L2_AV1_REF_GOLDEN_FRAME: Golden Reference Frame
3023  * @V4L2_AV1_REF_BWDREF_FRAME: BWD Reference Frame
3024  * @V4L2_AV1_REF_ALTREF2_FRAME: Alternative2 Reference Frame
3025  * @V4L2_AV1_REF_ALTREF_FRAME: Alternative Reference Frame
3026  */
3027 enum v4l2_av1_reference_frame {
3028 	V4L2_AV1_REF_INTRA_FRAME = 0,
3029 	V4L2_AV1_REF_LAST_FRAME = 1,
3030 	V4L2_AV1_REF_LAST2_FRAME = 2,
3031 	V4L2_AV1_REF_LAST3_FRAME = 3,
3032 	V4L2_AV1_REF_GOLDEN_FRAME = 4,
3033 	V4L2_AV1_REF_BWDREF_FRAME = 5,
3034 	V4L2_AV1_REF_ALTREF2_FRAME = 6,
3035 	V4L2_AV1_REF_ALTREF_FRAME = 7,
3036 };
3037 
3038 #define V4L2_AV1_GLOBAL_MOTION_IS_INVALID(ref) (1 << (ref))
3039 
3040 #define V4L2_AV1_GLOBAL_MOTION_FLAG_IS_GLOBAL	   0x1
3041 #define V4L2_AV1_GLOBAL_MOTION_FLAG_IS_ROT_ZOOM	   0x2
3042 #define V4L2_AV1_GLOBAL_MOTION_FLAG_IS_TRANSLATION 0x4
3043 /**
3044  * struct v4l2_av1_global_motion - AV1 Global Motion parameters as described in
3045  * section 6.8.17 "Global motion params semantics" of the AV1 specification.
3046  *
3047  * @flags: A bitfield containing the flags per reference frame. See
3048  * V4L2_AV1_GLOBAL_MOTION_FLAG_{}
3049  * @type: The type of global motion transform used.
3050  * @params: this field has the same meaning as "gm_params" in the AV1
3051  * specification.
3052  * @invalid: bitfield indicating whether the global motion params are invalid
3053  * for a given reference frame. See section 7.11.3.6 Setup shear process and
3054  * the variable "warpValid". Use V4L2_AV1_GLOBAL_MOTION_IS_INVALID(ref) to
3055  * create a suitable mask.
3056  * @reserved: padding field. Should be zeroed by applications.
3057  */
3058 
3059 struct v4l2_av1_global_motion {
3060 	__u8 flags[V4L2_AV1_TOTAL_REFS_PER_FRAME];
3061 	enum v4l2_av1_warp_model type[V4L2_AV1_TOTAL_REFS_PER_FRAME];
3062 	__s32 params[V4L2_AV1_TOTAL_REFS_PER_FRAME][6];
3063 	__u8 invalid;
3064 	__u8 reserved[3];
3065 };
3066 
3067 /**
3068  * enum v4l2_av1_frame_restoration_type - AV1 Frame Restoration Type
3069  * @V4L2_AV1_FRAME_RESTORE_NONE: no filtering is applied.
3070  * @V4L2_AV1_FRAME_RESTORE_WIENER: Wiener filter process is invoked.
3071  * @V4L2_AV1_FRAME_RESTORE_SGRPROJ: self guided filter process is invoked.
3072  * @V4L2_AV1_FRAME_RESTORE_SWITCHABLE: restoration filter is swichtable.
3073  */
3074 enum v4l2_av1_frame_restoration_type {
3075 	V4L2_AV1_FRAME_RESTORE_NONE = 0,
3076 	V4L2_AV1_FRAME_RESTORE_WIENER = 1,
3077 	V4L2_AV1_FRAME_RESTORE_SGRPROJ = 2,
3078 	V4L2_AV1_FRAME_RESTORE_SWITCHABLE = 3,
3079 };
3080 
3081 #define V4L2_AV1_LOOP_RESTORATION_FLAG_USES_LR		0x1
3082 #define V4L2_AV1_LOOP_RESTORATION_FLAG_USES_CHROMA_LR	0x2
3083 
3084 /**
3085  * struct v4l2_av1_loop_restoration - AV1 Loop Restauration as described in
3086  * section 6.10.15 "Loop restoration params semantics" of the AV1 specification.
3087  *
3088  * @flags: See V4L2_AV1_LOOP_RESTORATION_FLAG_{}.
3089  * @lr_unit_shift: specifies if the luma restoration size should be halved.
3090  * @lr_uv_shift: specifies if the chroma size should be half the luma size.
3091  * @reserved: padding field. Should be zeroed by applications.
3092  * @frame_restoration_type: specifies the type of restoration used for each
3093  * plane. See enum v4l2_av1_frame_restoration_type.
3094  * @loop_restoration_size: specifies the size of loop restoration units in units
3095  * of samples in the current plane.
3096  */
3097 struct v4l2_av1_loop_restoration {
3098 	__u8 flags;
3099 	__u8 lr_unit_shift;
3100 	__u8 lr_uv_shift;
3101 	__u8 reserved;
3102 	enum v4l2_av1_frame_restoration_type frame_restoration_type[V4L2_AV1_NUM_PLANES_MAX];
3103 	__u32 loop_restoration_size[V4L2_AV1_MAX_NUM_PLANES];
3104 };
3105 
3106 /**
3107  * struct v4l2_av1_cdef - AV1 CDEF params semantics as described in section
3108  * 6.10.14 "CDEF params semantics" of the AV1 specification
3109  *
3110  * @damping_minus_3: controls the amount of damping in the deringing filter.
3111  * @bits: specifies the number of bits needed to specify which CDEF filter to
3112  * apply.
3113  * @y_pri_strength: specifies the strength of the primary filter.
3114  * @y_sec_strength: specifies the strength of the secondary filter.
3115  * @uv_pri_strength: specifies the strength of the primary filter.
3116  * @uv_sec_strength: specifies the strength of the secondary filter.
3117  */
3118 struct v4l2_av1_cdef {
3119 	__u8 damping_minus_3;
3120 	__u8 bits;
3121 	__u8 y_pri_strength[V4L2_AV1_CDEF_MAX];
3122 	__u8 y_sec_strength[V4L2_AV1_CDEF_MAX];
3123 	__u8 uv_pri_strength[V4L2_AV1_CDEF_MAX];
3124 	__u8 uv_sec_strength[V4L2_AV1_CDEF_MAX];
3125 };
3126 
3127 #define V4L2_AV1_SEGMENTATION_FLAG_ENABLED	   0x1
3128 #define V4L2_AV1_SEGMENTATION_FLAG_UPDATE_MAP	   0x2
3129 #define V4L2_AV1_SEGMENTATION_FLAG_TEMPORAL_UPDATE 0x4
3130 #define V4L2_AV1_SEGMENTATION_FLAG_UPDATE_DATA	   0x8
3131 #define V4L2_AV1_SEGMENTATION_FLAG_SEG_ID_PRE_SKIP 0x10
3132 
3133 /**
3134  * enum v4l2_av1_segment_feature - AV1 segment features as described in section
3135  * 3 "Symbols and abbreviated terms" of the AV1 specification.
3136  *
3137  * @V4L2_AV1_SEG_LVL_ALT_Q: Index for quantizer segment feature.
3138  * @V4L2_AV1_SEG_LVL_ALT_LF_Y_V: Index for vertical luma loop filter segment
3139  * feature.
3140  * @V4L2_AV1_SEG_LVL_REF_FRAME: Index for reference frame segment feature.
3141  * @V4L2_AV1_SEG_LVL_REF_SKIP: Index for skip segment feature.
3142  * @V4L2_AV1_SEG_LVL_REF_GLOBALMV: Index for global mv feature.
3143  * @V4L2_AV1_SEG_LVL_MAX: Number of segment features.
3144  */
3145 enum v4l2_av1_segment_feature {
3146 	V4L2_AV1_SEG_LVL_ALT_Q = 0,
3147 	V4L2_AV1_SEG_LVL_ALT_LF_Y_V = 1,
3148 	V4L2_AV1_SEG_LVL_REF_FRAME = 5,
3149 	V4L2_AV1_SEG_LVL_REF_SKIP = 6,
3150 	V4L2_AV1_SEG_LVL_REF_GLOBALMV = 7,
3151 	V4L2_AV1_SEG_LVL_MAX = 8
3152 };
3153 
3154 #define V4L2_AV1_SEGMENT_FEATURE_ENABLED(id)	(1 << (id))
3155 
3156 /**
3157  * struct v4l2_av1_segmentation - AV1 Segmentation params as defined in section
3158  * 6.8.13 "Segmentation params semantics" of the AV1 specification.
3159  *
3160  * @flags: see V4L2_AV1_SEGMENTATION_FLAG_{}.
3161  * @last_active_seg_id: indicates the highest numbered segment id that has some
3162  * enabled feature. This is used when decoding the segment id to only decode
3163  * choices corresponding to used segments.
3164  * @feature_enabled: bitmask defining which features are enabled in each
3165  * segment. Use V4L2_AV1_SEGMENT_FEATURE_ENABLED to build a suitable mask.
3166  * @feature_data: data attached to each feature. Data entry is only valid if the
3167  * feature is enabled
3168  */
3169 struct v4l2_av1_segmentation {
3170 	__u8 flags;
3171 	__u8 last_active_seg_id;
3172 	__u8 feature_enabled[V4L2_AV1_MAX_SEGMENTS];
3173 	__s16 feature_data[V4L2_AV1_MAX_SEGMENTS][V4L2_AV1_SEG_LVL_MAX];
3174 };
3175 
3176 #define V4L2_AV1_LOOP_FILTER_FLAG_DELTA_ENABLED    0x1
3177 #define V4L2_AV1_LOOP_FILTER_FLAG_DELTA_UPDATE     0x2
3178 #define V4L2_AV1_LOOP_FILTER_FLAG_DELTA_LF_PRESENT 0x4
3179 #define V4L2_AV1_LOOP_FILTER_FLAG_DELTA_LF_MULTI   0x8
3180 
3181 /**
3182  * struct v4l2_av1_loop_filter - AV1 Loop filter params as defined in section
3183  * 6.8.10 "Loop filter semantics" and 6.8.16 "Loop filter delta parameters
3184  * semantics" of the AV1 specification.
3185  *
3186  * @flags: see V4L2_AV1_LOOP_FILTER_FLAG_{}
3187  * @level: an array containing loop filter strength values. Different loop
3188  * filter strength values from the array are used depending on the image plane
3189  * being filtered, and the edge direction (vertical or horizontal) being
3190  * filtered.
3191  * @sharpness: indicates the sharpness level. The loop_filter_level and
3192  * loop_filter_sharpness together determine when a block edge is filtered, and
3193  * by how much the filtering can change the sample values. The loop filter
3194  * process is described in section 7.14 of the AV1 specification.
3195  * @ref_deltas: contains the adjustment needed for the filter level based on the
3196  * chosen reference frame. If this syntax element is not present, it maintains
3197  * its previous value.
3198  * @mode_deltas: contains the adjustment needed for the filter level based on
3199  * the chosen mode. If this syntax element is not present, it maintains its
3200  * previous value.
3201  * @delta_lf_res: specifies the left shift which should be applied to decoded
3202  * loop filter delta values.
3203  */
3204 struct v4l2_av1_loop_filter {
3205 	__u8 flags;
3206 	__u8 level[4];
3207 	__u8 sharpness;
3208 	__s8 ref_deltas[V4L2_AV1_TOTAL_REFS_PER_FRAME];
3209 	__s8 mode_deltas[2];
3210 	__u8 delta_lf_res;
3211 };
3212 
3213 #define V4L2_AV1_QUANTIZATION_FLAG_DIFF_UV_DELTA   0x1
3214 #define V4L2_AV1_QUANTIZATION_FLAG_USING_QMATRIX   0x2
3215 #define V4L2_AV1_QUANTIZATION_FLAG_DELTA_Q_PRESENT 0x4
3216 
3217 /**
3218  * struct v4l2_av1_quantization - AV1 Quantization params as defined in section
3219  * 6.8.11 "Quantization params semantics" of the AV1 specification.
3220  *
3221  * @flags: see V4L2_AV1_QUANTIZATION_FLAG_{}
3222  * @base_q_idx: indicates the base frame qindex. This is used for Y AC
3223  * coefficients and as the base value for the other quantizers.
3224  * @delta_q_y_dc: indicates the Y DC quantizer relative to base_q_idx.
3225  * @delta_q_u_dc: indicates the U DC quantizer relative to base_q_idx.
3226  * @delta_q_u_ac: indicates the U AC quantizer relative to base_q_idx.
3227  * @delta_q_v_dc: indicates the V DC quantizer relative to base_q_idx.
3228  * @delta_q_v_ac: indicates the V AC quantizer relative to base_q_idx.
3229  * @qm_y: specifies the level in the quantizer matrix that should be used for
3230  * luma plane decoding.
3231  * @qm_u: specifies the level in the quantizer matrix that should be used for
3232  * chroma U plane decoding.
3233  * @qm_v: specifies the level in the quantizer matrix that should be used for
3234  * chroma V plane decoding.
3235  * @delta_q_res: specifies the left shift which should be applied to decoded
3236  * quantizer index delta values.
3237  */
3238 struct v4l2_av1_quantization {
3239 	__u8 flags;
3240 	__u8 base_q_idx;
3241 	__s8 delta_q_y_dc;
3242 	__s8 delta_q_u_dc;
3243 	__s8 delta_q_u_ac;
3244 	__s8 delta_q_v_dc;
3245 	__s8 delta_q_v_ac;
3246 	__u8 qm_y;
3247 	__u8 qm_u;
3248 	__u8 qm_v;
3249 	__u8 delta_q_res;
3250 };
3251 
3252 #define V4L2_AV1_TILE_INFO_FLAG_UNIFORM_TILE_SPACING	0x1
3253 
3254 /**
3255  * struct v4l2_av1_tile_info - AV1 Tile info as defined in section 6.8.14 "Tile
3256  * info semantics" of the AV1 specification.
3257  *
3258  * @flags: see V4L2_AV1_TILE_INFO_FLAG_{}
3259  * @context_update_tile_id: specifies which tile to use for the CDF update.
3260  * @tile_rows: specifies the number of tiles down the frame.
3261  * @tile_cols: specifies the number of tiles across the frame.
3262  * @mi_col_starts: an array specifying the start column (in units of 4x4 luma
3263  * samples) for each tile across the image.
3264  * @mi_row_starts: an array specifying the start row (in units of 4x4 luma
3265  * samples) for each tile down the image.
3266  * @width_in_sbs_minus_1: specifies the width of a tile minus 1 in units of
3267  * superblocks.
3268  * @height_in_sbs_minus_1:  specifies the height of a tile minus 1 in units of
3269  * superblocks.
3270  * @tile_size_bytes: specifies the number of bytes needed to code each tile
3271  * size.
3272  * @reserved: padding field. Should be zeroed by applications.
3273  */
3274 struct v4l2_av1_tile_info {
3275 	__u8 flags;
3276 	__u8 context_update_tile_id;
3277 	__u8 tile_cols;
3278 	__u8 tile_rows;
3279 	__u32 mi_col_starts[V4L2_AV1_MAX_TILE_COLS + 1];
3280 	__u32 mi_row_starts[V4L2_AV1_MAX_TILE_ROWS + 1];
3281 	__u32 width_in_sbs_minus_1[V4L2_AV1_MAX_TILE_COLS];
3282 	__u32 height_in_sbs_minus_1[V4L2_AV1_MAX_TILE_ROWS];
3283 	__u8 tile_size_bytes;
3284 	__u8 reserved[3];
3285 };
3286 
3287 /**
3288  * enum v4l2_av1_frame_type - AV1 Frame Type
3289  *
3290  * @V4L2_AV1_KEY_FRAME: Key frame
3291  * @V4L2_AV1_INTER_FRAME: Inter frame
3292  * @V4L2_AV1_INTRA_ONLY_FRAME: Intra-only frame
3293  * @V4L2_AV1_SWITCH_FRAME: Switch frame
3294  */
3295 enum v4l2_av1_frame_type {
3296 	V4L2_AV1_KEY_FRAME = 0,
3297 	V4L2_AV1_INTER_FRAME = 1,
3298 	V4L2_AV1_INTRA_ONLY_FRAME = 2,
3299 	V4L2_AV1_SWITCH_FRAME = 3
3300 };
3301 
3302 /**
3303  * enum v4l2_av1_interpolation_filter - AV1 interpolation filter types
3304  *
3305  * @V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP: eight tap filter
3306  * @V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP_SMOOTH: eight tap smooth filter
3307  * @V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP_SHARP: eight tap sharp filter
3308  * @V4L2_AV1_INTERPOLATION_FILTER_BILINEAR: bilinear filter
3309  * @V4L2_AV1_INTERPOLATION_FILTER_SWITCHABLE: filter selection is signaled at
3310  * the block level
3311  *
3312  * See section 6.8.9 "Interpolation filter semantics" of the AV1 specification
3313  * for more details.
3314  */
3315 enum v4l2_av1_interpolation_filter {
3316 	V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP = 0,
3317 	V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP_SMOOTH = 1,
3318 	V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP_SHARP = 2,
3319 	V4L2_AV1_INTERPOLATION_FILTER_BILINEAR = 3,
3320 	V4L2_AV1_INTERPOLATION_FILTER_SWITCHABLE = 4,
3321 };
3322 
3323 /**
3324  * enum v4l2_av1_tx_mode - AV1 Tx mode as described in section 6.8.21 "TX mode
3325  * semantics" of the AV1 specification.
3326  * @V4L2_AV1_TX_MODE_ONLY_4X4: the inverse transform will use only 4x4
3327  * transforms
3328  * @V4L2_AV1_TX_MODE_LARGEST: the inverse transform will use the largest
3329  * transform size that fits inside the block
3330  * @V4L2_AV1_TX_MODE_SELECT: the choice of transform size is specified
3331  * explicitly for each block.
3332  */
3333 enum v4l2_av1_tx_mode {
3334 	V4L2_AV1_TX_MODE_ONLY_4X4 = 0,
3335 	V4L2_AV1_TX_MODE_LARGEST = 1,
3336 	V4L2_AV1_TX_MODE_SELECT = 2
3337 };
3338 
3339 #define V4L2_AV1_FRAME_FLAG_SHOW_FRAME			 0x00000001
3340 #define V4L2_AV1_FRAME_FLAG_SHOWABLE_FRAME		 0x00000002
3341 #define V4L2_AV1_FRAME_FLAG_ERROR_RESILIENT_MODE	 0x00000004
3342 #define V4L2_AV1_FRAME_FLAG_DISABLE_CDF_UPDATE		 0x00000008
3343 #define V4L2_AV1_FRAME_FLAG_ALLOW_SCREEN_CONTENT_TOOLS	 0x00000010
3344 #define V4L2_AV1_FRAME_FLAG_FORCE_INTEGER_MV		 0x00000020
3345 #define V4L2_AV1_FRAME_FLAG_ALLOW_INTRABC		 0x00000040
3346 #define V4L2_AV1_FRAME_FLAG_USE_SUPERRES		 0x00000080
3347 #define V4L2_AV1_FRAME_FLAG_ALLOW_HIGH_PRECISION_MV	 0x00000100
3348 #define V4L2_AV1_FRAME_FLAG_IS_MOTION_MODE_SWITCHABLE	 0x00000200
3349 #define V4L2_AV1_FRAME_FLAG_USE_REF_FRAME_MVS		 0x00000400
3350 #define V4L2_AV1_FRAME_FLAG_DISABLE_FRAME_END_UPDATE_CDF 0x00000800
3351 #define V4L2_AV1_FRAME_FLAG_ALLOW_WARPED_MOTION		 0x00001000
3352 #define V4L2_AV1_FRAME_FLAG_REFERENCE_SELECT		 0x00002000
3353 #define V4L2_AV1_FRAME_FLAG_REDUCED_TX_SET		 0x00004000
3354 #define V4L2_AV1_FRAME_FLAG_SKIP_MODE_ALLOWED		 0x00008000
3355 #define V4L2_AV1_FRAME_FLAG_SKIP_MODE_PRESENT		 0x00010000
3356 #define V4L2_AV1_FRAME_FLAG_FRAME_SIZE_OVERRIDE		 0x00020000
3357 #define V4L2_AV1_FRAME_FLAG_BUFFER_REMOVAL_TIME_PRESENT	 0x00040000
3358 #define V4L2_AV1_FRAME_FLAG_FRAME_REFS_SHORT_SIGNALING	 0x00080000
3359 
3360 #define V4L2_CID_STATELESS_AV1_FRAME (V4L2_CID_CODEC_STATELESS_BASE + 502)
3361 /**
3362  * struct v4l2_ctrl_av1_frame - Represents an AV1 Frame Header OBU.
3363  *
3364  * @tile_info: tile info
3365  * @quantization: quantization params
3366  * @segmentation: segmentation params
3367  * @superres_denom: the denominator for the upscaling ratio.
3368  * @loop_filter: loop filter params
3369  * @cdef: cdef params
3370  * @skip_mode_frame: specifies the frames to use for compound prediction when
3371  * skip_mode is equal to 1.
3372  * @primary_ref_frame: specifies which reference frame contains the CDF values
3373  * and other state that should be loaded at the start of the frame.
3374  * @loop_restoration: loop restoration params
3375  * @global_motion: global motion params
3376  * @flags: see V4L2_AV1_FRAME_FLAG_{}
3377  * @frame_type: specifies the AV1 frame type
3378  * @order_hint: specifies OrderHintBits least significant bits of the expected
3379  * output order for this frame.
3380  * @upscaled_width: the upscaled width.
3381  * @interpolation_filter: specifies the filter selection used for performing
3382  * inter prediction.
3383  * @tx_mode: specifies how the transform size is determined.
3384  * @frame_width_minus_1: add 1 to get the frame's width.
3385  * @frame_height_minus_1: add 1 to get the frame's height
3386  * @render_width_minus_1: add 1 to get the render width of the frame in luma
3387  * samples.
3388  * @render_height_minus_1: add 1 to get the render height of the frame in luma
3389  * samples.
3390  * @current_frame_id: specifies the frame id number for the current frame. Frame
3391  * id numbers are additional information that do not affect the decoding
3392  * process, but provide decoders with a way of detecting missing reference
3393  * frames so that appropriate action can be taken.
3394  * @buffer_removal_time: specifies the frame removal time in units of DecCT clock
3395  * ticks counted from the removal time of the last random access point for
3396  * operating point opNum.
3397  * @reserved: padding field. Should be zeroed by applications.
3398  * @order_hints: specifies the expected output order hint for each reference
3399  * frame. This field corresponds to the OrderHints variable from the
3400  * specification (section 5.9.2 "Uncompressed header syntax"). As such, this is
3401  * only used for non-intra frames and ignored otherwise. order_hints[0] is
3402  * always ignored.
3403  * @reference_frame_ts: the V4L2 timestamp of the reference frame slots.
3404  * @ref_frame_idx: used to index into @reference_frame_ts when decoding
3405  * inter-frames. The meaning of this array is the same as in the specification.
3406  * The timestamp refers to the timestamp field in struct v4l2_buffer. Use
3407  * v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
3408  * @refresh_frame_flags: contains a bitmask that specifies which reference frame
3409  * slots will be updated with the current frame after it is decoded.
3410  */
3411 struct v4l2_ctrl_av1_frame {
3412 	struct v4l2_av1_tile_info tile_info;
3413 	struct v4l2_av1_quantization quantization;
3414 	__u8 superres_denom;
3415 	struct v4l2_av1_segmentation segmentation;
3416 	struct v4l2_av1_loop_filter loop_filter;
3417 	struct v4l2_av1_cdef cdef;
3418 	__u8 skip_mode_frame[2];
3419 	__u8 primary_ref_frame;
3420 	struct v4l2_av1_loop_restoration loop_restoration;
3421 	struct v4l2_av1_global_motion global_motion;
3422 	__u32 flags;
3423 	enum v4l2_av1_frame_type frame_type;
3424 	__u32 order_hint;
3425 	__u32 upscaled_width;
3426 	enum v4l2_av1_interpolation_filter interpolation_filter;
3427 	enum v4l2_av1_tx_mode tx_mode;
3428 	__u32 frame_width_minus_1;
3429 	__u32 frame_height_minus_1;
3430 	__u16 render_width_minus_1;
3431 	__u16 render_height_minus_1;
3432 
3433 	__u32 current_frame_id;
3434 	__u32 buffer_removal_time[V4L2_AV1_MAX_OPERATING_POINTS];
3435 	__u8 reserved[4];
3436 	__u32 order_hints[V4L2_AV1_TOTAL_REFS_PER_FRAME];
3437 	__u64 reference_frame_ts[V4L2_AV1_TOTAL_REFS_PER_FRAME];
3438 	__s8 ref_frame_idx[V4L2_AV1_REFS_PER_FRAME];
3439 	__u8 refresh_frame_flags;
3440 };
3441 
3442 #define V4L2_AV1_FILM_GRAIN_FLAG_APPLY_GRAIN 0x1
3443 #define V4L2_AV1_FILM_GRAIN_FLAG_UPDATE_GRAIN 0x2
3444 #define V4L2_AV1_FILM_GRAIN_FLAG_CHROMA_SCALING_FROM_LUMA 0x4
3445 #define V4L2_AV1_FILM_GRAIN_FLAG_OVERLAP 0x8
3446 #define V4L2_AV1_FILM_GRAIN_FLAG_CLIP_TO_RESTRICTED_RANGE 0x10
3447 
3448 #define V4L2_CID_STATELESS_AV1_FILM_GRAIN (V4L2_CID_CODEC_STATELESS_BASE + 505)
3449 /**
3450  * struct v4l2_ctrl_av1_film_grain - AV1 Film Grain parameters.
3451  *
3452  * Film grain parameters as specified by section 6.8.20 of the AV1 Specification.
3453  *
3454  * @flags: see V4L2_AV1_FILM_GRAIN_{}.
3455  * @cr_mult: represents a multiplier for the cr component used in derivation of
3456  * the input index to the cr component scaling function.
3457  * @grain_seed: specifies the starting value for the pseudo-random numbers used
3458  * during film grain synthesis.
3459  * @film_grain_params_ref_idx: indicates which reference frame contains the
3460  * film grain parameters to be used for this frame.
3461  * @num_y_points: specifies the number of points for the piece-wise linear
3462  * scaling function of the luma component.
3463  * @point_y_value: represents the x (luma value) coordinate for the i-th point
3464  * of the piecewise linear scaling function for luma component. The values are
3465  * signaled on the scale of 0..255. In case of 10 bit video, these values
3466  * correspond to luma values divided by 4. In case of 12 bit video, these values
3467  * correspond to luma values divided by 16.
3468  * @point_y_scaling:  represents the scaling (output) value for the i-th point
3469  * of the piecewise linear scaling function for luma component.
3470  * @num_cb_points: specifies the number of points for the piece-wise linear
3471  * scaling function of the cb component.
3472  * @point_cb_value: represents the x coordinate for the i-th point of the
3473  * piece-wise linear scaling function for cb component. The values are signaled
3474  * on the scale of 0..255.
3475  * @point_cb_scaling: represents the scaling (output) value for the i-th point
3476  * of the piecewise linear scaling function for cb component.
3477  * @num_cr_points: specifies represents the number of points for the piece-wise
3478  * linear scaling function of the cr component.
3479  * @point_cr_value:  represents the x coordinate for the i-th point of the
3480  * piece-wise linear scaling function for cr component. The values are signaled
3481  * on the scale of 0..255.
3482  * @point_cr_scaling:  represents the scaling (output) value for the i-th point
3483  * of the piecewise linear scaling function for cr component.
3484  * @grain_scaling_minus_8: represents the shift – 8 applied to the values of the
3485  * chroma component. The grain_scaling_minus_8 can take values of 0..3 and
3486  * determines the range and quantization step of the standard deviation of film
3487  * grain.
3488  * @ar_coeff_lag: specifies the number of auto-regressive coefficients for luma
3489  * and chroma.
3490  * @ar_coeffs_y_plus_128: specifies auto-regressive coefficients used for the Y
3491  * plane.
3492  * @ar_coeffs_cb_plus_128: specifies auto-regressive coefficients used for the U
3493  * plane.
3494  * @ar_coeffs_cr_plus_128: specifies auto-regressive coefficients used for the V
3495  * plane.
3496  * @ar_coeff_shift_minus_6: specifies the range of the auto-regressive
3497  * coefficients. Values of 0, 1, 2, and 3 correspond to the ranges for
3498  * auto-regressive coefficients of [-2, 2), [-1, 1), [-0.5, 0.5) and [-0.25,
3499  * 0.25) respectively.
3500  * @grain_scale_shift: specifies how much the Gaussian random numbers should be
3501  * scaled down during the grain synthesis process.
3502  * @cb_mult: represents a multiplier for the cb component used in derivation of
3503  * the input index to the cb component scaling function.
3504  * @cb_luma_mult: represents a multiplier for the average luma component used in
3505  * derivation of the input index to the cb component scaling function.
3506  * @cr_luma_mult: represents a multiplier for the average luma component used in
3507  * derivation of the input index to the cr component scaling function.
3508  * @cb_offset: represents an offset used in derivation of the input index to the
3509  * cb component scaling function.
3510  * @cr_offset: represents an offset used in derivation of the input index to the
3511  * cr component scaling function.
3512  * @reserved: padding field. Should be zeroed by applications.
3513  */
3514 struct v4l2_ctrl_av1_film_grain {
3515 	__u8 flags;
3516 	__u8 cr_mult;
3517 	__u16 grain_seed;
3518 	__u8 film_grain_params_ref_idx;
3519 	__u8 num_y_points;
3520 	__u8 point_y_value[V4L2_AV1_MAX_NUM_Y_POINTS];
3521 	__u8 point_y_scaling[V4L2_AV1_MAX_NUM_Y_POINTS];
3522 	__u8 num_cb_points;
3523 	__u8 point_cb_value[V4L2_AV1_MAX_NUM_CB_POINTS];
3524 	__u8 point_cb_scaling[V4L2_AV1_MAX_NUM_CB_POINTS];
3525 	__u8 num_cr_points;
3526 	__u8 point_cr_value[V4L2_AV1_MAX_NUM_CR_POINTS];
3527 	__u8 point_cr_scaling[V4L2_AV1_MAX_NUM_CR_POINTS];
3528 	__u8 grain_scaling_minus_8;
3529 	__u8 ar_coeff_lag;
3530 	__u8 ar_coeffs_y_plus_128[V4L2_AV1_AR_COEFFS_SIZE];
3531 	__u8 ar_coeffs_cb_plus_128[V4L2_AV1_AR_COEFFS_SIZE];
3532 	__u8 ar_coeffs_cr_plus_128[V4L2_AV1_AR_COEFFS_SIZE];
3533 	__u8 ar_coeff_shift_minus_6;
3534 	__u8 grain_scale_shift;
3535 	__u8 cb_mult;
3536 	__u8 cb_luma_mult;
3537 	__u8 cr_luma_mult;
3538 	__u16 cb_offset;
3539 	__u16 cr_offset;
3540 	__u8 reserved[4];
3541 };
3542 
3543 /* MPEG-compression definitions kept for backwards compatibility */
3544 #ifndef __KERNEL__
3545 #define V4L2_CTRL_CLASS_MPEG            V4L2_CTRL_CLASS_CODEC
3546 #define V4L2_CID_MPEG_CLASS             V4L2_CID_CODEC_CLASS
3547 #define V4L2_CID_MPEG_BASE              V4L2_CID_CODEC_BASE
3548 #define V4L2_CID_MPEG_CX2341X_BASE      V4L2_CID_CODEC_CX2341X_BASE
3549 #define V4L2_CID_MPEG_MFC51_BASE        V4L2_CID_CODEC_MFC51_BASE
3550 #endif
3551 
3552 #define V4L2_CID_COLORIMETRY_CLASS_BASE	(V4L2_CTRL_CLASS_COLORIMETRY | 0x900)
3553 #define V4L2_CID_COLORIMETRY_CLASS	(V4L2_CTRL_CLASS_COLORIMETRY | 1)
3554 
3555 #define V4L2_CID_COLORIMETRY_HDR10_CLL_INFO	(V4L2_CID_COLORIMETRY_CLASS_BASE + 0)
3556 
3557 struct v4l2_ctrl_hdr10_cll_info {
3558 	__u16 max_content_light_level;
3559 	__u16 max_pic_average_light_level;
3560 };
3561 
3562 #define V4L2_CID_COLORIMETRY_HDR10_MASTERING_DISPLAY	(V4L2_CID_COLORIMETRY_CLASS_BASE + 1)
3563 
3564 #define V4L2_HDR10_MASTERING_PRIMARIES_X_LOW	5
3565 #define V4L2_HDR10_MASTERING_PRIMARIES_X_HIGH	37000
3566 #define V4L2_HDR10_MASTERING_PRIMARIES_Y_LOW	5
3567 #define V4L2_HDR10_MASTERING_PRIMARIES_Y_HIGH	42000
3568 #define V4L2_HDR10_MASTERING_WHITE_POINT_X_LOW	5
3569 #define V4L2_HDR10_MASTERING_WHITE_POINT_X_HIGH	37000
3570 #define V4L2_HDR10_MASTERING_WHITE_POINT_Y_LOW	5
3571 #define V4L2_HDR10_MASTERING_WHITE_POINT_Y_HIGH	42000
3572 #define V4L2_HDR10_MASTERING_MAX_LUMA_LOW	50000
3573 #define V4L2_HDR10_MASTERING_MAX_LUMA_HIGH	100000000
3574 #define V4L2_HDR10_MASTERING_MIN_LUMA_LOW	1
3575 #define V4L2_HDR10_MASTERING_MIN_LUMA_HIGH	50000
3576 
3577 struct v4l2_ctrl_hdr10_mastering_display {
3578 	__u16 display_primaries_x[3];
3579 	__u16 display_primaries_y[3];
3580 	__u16 white_point_x;
3581 	__u16 white_point_y;
3582 	__u32 max_display_mastering_luminance;
3583 	__u32 min_display_mastering_luminance;
3584 };
3585 
3586 #endif
3587