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