1  /* SPDX-License-Identifier: ((GPL-2.0+ WITH Linux-syscall-note) OR BSD-3-Clause) */
2  /*
3   *  Video for Linux Two controls header file
4   *
5   *  Copyright (C) 1999-2012 the contributors
6   *
7   *  The contents of this header was split off from videodev2.h. All control
8   *  definitions should be added to this header, which is included by
9   *  videodev2.h.
10   */
11  
12  #ifndef __LINUX_V4L2_CONTROLS_H
13  #define __LINUX_V4L2_CONTROLS_H
14  
15  #include <linux/const.h>
16  #include <linux/types.h>
17  
18  /* Control classes */
19  #define V4L2_CTRL_CLASS_USER		0x00980000	/* Old-style 'user' controls */
20  #define V4L2_CTRL_CLASS_CODEC		0x00990000	/* Stateful codec controls */
21  #define V4L2_CTRL_CLASS_CAMERA		0x009a0000	/* Camera class controls */
22  #define V4L2_CTRL_CLASS_FM_TX		0x009b0000	/* FM Modulator controls */
23  #define V4L2_CTRL_CLASS_FLASH		0x009c0000	/* Camera flash controls */
24  #define V4L2_CTRL_CLASS_JPEG		0x009d0000	/* JPEG-compression controls */
25  #define V4L2_CTRL_CLASS_IMAGE_SOURCE	0x009e0000	/* Image source controls */
26  #define V4L2_CTRL_CLASS_IMAGE_PROC	0x009f0000	/* Image processing controls */
27  #define V4L2_CTRL_CLASS_DV		0x00a00000	/* Digital Video controls */
28  #define V4L2_CTRL_CLASS_FM_RX		0x00a10000	/* FM Receiver controls */
29  #define V4L2_CTRL_CLASS_RF_TUNER	0x00a20000	/* RF tuner controls */
30  #define V4L2_CTRL_CLASS_DETECT		0x00a30000	/* Detection controls */
31  #define V4L2_CTRL_CLASS_CODEC_STATELESS 0x00a40000	/* Stateless codecs controls */
32  #define V4L2_CTRL_CLASS_COLORIMETRY	0x00a50000	/* Colorimetry controls */
33  
34  /* User-class control IDs */
35  
36  #define V4L2_CID_BASE			(V4L2_CTRL_CLASS_USER | 0x900)
37  #define V4L2_CID_USER_BASE		V4L2_CID_BASE
38  #define V4L2_CID_USER_CLASS		(V4L2_CTRL_CLASS_USER | 1)
39  #define V4L2_CID_BRIGHTNESS		(V4L2_CID_BASE+0)
40  #define V4L2_CID_CONTRAST		(V4L2_CID_BASE+1)
41  #define V4L2_CID_SATURATION		(V4L2_CID_BASE+2)
42  #define V4L2_CID_HUE			(V4L2_CID_BASE+3)
43  #define V4L2_CID_AUDIO_VOLUME		(V4L2_CID_BASE+5)
44  #define V4L2_CID_AUDIO_BALANCE		(V4L2_CID_BASE+6)
45  #define V4L2_CID_AUDIO_BASS		(V4L2_CID_BASE+7)
46  #define V4L2_CID_AUDIO_TREBLE		(V4L2_CID_BASE+8)
47  #define V4L2_CID_AUDIO_MUTE		(V4L2_CID_BASE+9)
48  #define V4L2_CID_AUDIO_LOUDNESS		(V4L2_CID_BASE+10)
49  #define V4L2_CID_BLACK_LEVEL		(V4L2_CID_BASE+11) /* Deprecated */
50  #define V4L2_CID_AUTO_WHITE_BALANCE	(V4L2_CID_BASE+12)
51  #define V4L2_CID_DO_WHITE_BALANCE	(V4L2_CID_BASE+13)
52  #define V4L2_CID_RED_BALANCE		(V4L2_CID_BASE+14)
53  #define V4L2_CID_BLUE_BALANCE		(V4L2_CID_BASE+15)
54  #define V4L2_CID_GAMMA			(V4L2_CID_BASE+16)
55  #define V4L2_CID_WHITENESS		(V4L2_CID_GAMMA) /* Deprecated */
56  #define V4L2_CID_EXPOSURE		(V4L2_CID_BASE+17)
57  #define V4L2_CID_AUTOGAIN		(V4L2_CID_BASE+18)
58  #define V4L2_CID_GAIN			(V4L2_CID_BASE+19)
59  #define V4L2_CID_HFLIP			(V4L2_CID_BASE+20)
60  #define V4L2_CID_VFLIP			(V4L2_CID_BASE+21)
61  
62  #define V4L2_CID_POWER_LINE_FREQUENCY	(V4L2_CID_BASE+24)
63  enum v4l2_power_line_frequency {
64  	V4L2_CID_POWER_LINE_FREQUENCY_DISABLED	= 0,
65  	V4L2_CID_POWER_LINE_FREQUENCY_50HZ	= 1,
66  	V4L2_CID_POWER_LINE_FREQUENCY_60HZ	= 2,
67  	V4L2_CID_POWER_LINE_FREQUENCY_AUTO	= 3,
68  };
69  #define V4L2_CID_HUE_AUTO			(V4L2_CID_BASE+25)
70  #define V4L2_CID_WHITE_BALANCE_TEMPERATURE	(V4L2_CID_BASE+26)
71  #define V4L2_CID_SHARPNESS			(V4L2_CID_BASE+27)
72  #define V4L2_CID_BACKLIGHT_COMPENSATION		(V4L2_CID_BASE+28)
73  #define V4L2_CID_CHROMA_AGC                     (V4L2_CID_BASE+29)
74  #define V4L2_CID_COLOR_KILLER                   (V4L2_CID_BASE+30)
75  #define V4L2_CID_COLORFX			(V4L2_CID_BASE+31)
76  enum v4l2_colorfx {
77  	V4L2_COLORFX_NONE			= 0,
78  	V4L2_COLORFX_BW				= 1,
79  	V4L2_COLORFX_SEPIA			= 2,
80  	V4L2_COLORFX_NEGATIVE			= 3,
81  	V4L2_COLORFX_EMBOSS			= 4,
82  	V4L2_COLORFX_SKETCH			= 5,
83  	V4L2_COLORFX_SKY_BLUE			= 6,
84  	V4L2_COLORFX_GRASS_GREEN		= 7,
85  	V4L2_COLORFX_SKIN_WHITEN		= 8,
86  	V4L2_COLORFX_VIVID			= 9,
87  	V4L2_COLORFX_AQUA			= 10,
88  	V4L2_COLORFX_ART_FREEZE			= 11,
89  	V4L2_COLORFX_SILHOUETTE			= 12,
90  	V4L2_COLORFX_SOLARIZATION		= 13,
91  	V4L2_COLORFX_ANTIQUE			= 14,
92  	V4L2_COLORFX_SET_CBCR			= 15,
93  	V4L2_COLORFX_SET_RGB			= 16,
94  };
95  #define V4L2_CID_AUTOBRIGHTNESS			(V4L2_CID_BASE+32)
96  #define V4L2_CID_BAND_STOP_FILTER		(V4L2_CID_BASE+33)
97  
98  #define V4L2_CID_ROTATE				(V4L2_CID_BASE+34)
99  #define V4L2_CID_BG_COLOR			(V4L2_CID_BASE+35)
100  
101  #define V4L2_CID_CHROMA_GAIN                    (V4L2_CID_BASE+36)
102  
103  #define V4L2_CID_ILLUMINATORS_1			(V4L2_CID_BASE+37)
104  #define V4L2_CID_ILLUMINATORS_2			(V4L2_CID_BASE+38)
105  
106  #define V4L2_CID_MIN_BUFFERS_FOR_CAPTURE	(V4L2_CID_BASE+39)
107  #define V4L2_CID_MIN_BUFFERS_FOR_OUTPUT		(V4L2_CID_BASE+40)
108  
109  #define V4L2_CID_ALPHA_COMPONENT		(V4L2_CID_BASE+41)
110  #define V4L2_CID_COLORFX_CBCR			(V4L2_CID_BASE+42)
111  #define V4L2_CID_COLORFX_RGB			(V4L2_CID_BASE+43)
112  
113  /* last CID + 1 */
114  #define V4L2_CID_LASTP1                         (V4L2_CID_BASE+44)
115  
116  /* USER-class private control IDs */
117  
118  #ifndef __KERNEL__
119  /*
120   * The base for the meye driver controls. This driver was removed, but
121   * we keep this define in case any software still uses it.
122   */
123  #define V4L2_CID_USER_MEYE_BASE			(V4L2_CID_USER_BASE + 0x1000)
124  #endif
125  
126  /* The base for the bttv driver controls.
127   * We reserve 32 controls for this driver. */
128  #define V4L2_CID_USER_BTTV_BASE			(V4L2_CID_USER_BASE + 0x1010)
129  
130  
131  /* The base for the s2255 driver controls.
132   * We reserve 16 controls for this driver. */
133  #define V4L2_CID_USER_S2255_BASE		(V4L2_CID_USER_BASE + 0x1030)
134  
135  /*
136   * The base for the si476x driver controls. See include/media/drv-intf/si476x.h
137   * for the list of controls. Total of 16 controls is reserved for this driver
138   */
139  #define V4L2_CID_USER_SI476X_BASE		(V4L2_CID_USER_BASE + 0x1040)
140  
141  /* The base for the TI VPE driver controls. Total of 16 controls is reserved for
142   * this driver */
143  #define V4L2_CID_USER_TI_VPE_BASE		(V4L2_CID_USER_BASE + 0x1050)
144  
145  /* The base for the saa7134 driver controls.
146   * We reserve 16 controls for this driver. */
147  #define V4L2_CID_USER_SAA7134_BASE		(V4L2_CID_USER_BASE + 0x1060)
148  
149  /* The base for the adv7180 driver controls.
150   * We reserve 16 controls for this driver. */
151  #define V4L2_CID_USER_ADV7180_BASE		(V4L2_CID_USER_BASE + 0x1070)
152  
153  /* The base for the tc358743 driver controls.
154   * We reserve 16 controls for this driver. */
155  #define V4L2_CID_USER_TC358743_BASE		(V4L2_CID_USER_BASE + 0x1080)
156  
157  /* The base for the max217x driver controls.
158   * We reserve 32 controls for this driver
159   */
160  #define V4L2_CID_USER_MAX217X_BASE		(V4L2_CID_USER_BASE + 0x1090)
161  
162  /* The base for the imx driver controls.
163   * We reserve 16 controls for this driver. */
164  #define V4L2_CID_USER_IMX_BASE			(V4L2_CID_USER_BASE + 0x10b0)
165  
166  /*
167   * The base for the atmel isc driver controls.
168   * We reserve 32 controls for this driver.
169   */
170  #define V4L2_CID_USER_ATMEL_ISC_BASE		(V4L2_CID_USER_BASE + 0x10c0)
171  
172  /*
173   * The base for the CODA driver controls.
174   * We reserve 16 controls for this driver.
175   */
176  #define V4L2_CID_USER_CODA_BASE			(V4L2_CID_USER_BASE + 0x10e0)
177  /*
178   * The base for MIPI CCS driver controls.
179   * We reserve 128 controls for this driver.
180   */
181  #define V4L2_CID_USER_CCS_BASE			(V4L2_CID_USER_BASE + 0x10f0)
182  /*
183   * The base for Allegro driver controls.
184   * We reserve 16 controls for this driver.
185   */
186  #define V4L2_CID_USER_ALLEGRO_BASE		(V4L2_CID_USER_BASE + 0x1170)
187  
188  /*
189   * The base for the isl7998x driver controls.
190   * We reserve 16 controls for this driver.
191   */
192  #define V4L2_CID_USER_ISL7998X_BASE		(V4L2_CID_USER_BASE + 0x1180)
193  
194  /*
195   * The base for DW100 driver controls.
196   * We reserve 16 controls for this driver.
197   */
198  #define V4L2_CID_USER_DW100_BASE		(V4L2_CID_USER_BASE + 0x1190)
199  
200  /*
201   * The base for Aspeed driver controls.
202   * We reserve 16 controls for this driver.
203   */
204  #define V4L2_CID_USER_ASPEED_BASE		(V4L2_CID_USER_BASE + 0x11a0)
205  
206  /*
207   * The base for Nuvoton NPCM driver controls.
208   * We reserve 16 controls for this driver.
209   */
210  #define V4L2_CID_USER_NPCM_BASE			(V4L2_CID_USER_BASE + 0x11b0)
211  
212  /*
213   * The base for THine THP7312 driver controls.
214   * We reserve 32 controls for this driver.
215   */
216  #define V4L2_CID_USER_THP7312_BASE		(V4L2_CID_USER_BASE + 0x11c0)
217  
218  /* 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)
227  enum 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)
242  enum 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)
249  enum 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)
255  enum 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)
263  enum 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)
280  enum 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)
297  enum 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)
314  enum 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)
321  enum 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)
328  enum 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)
334  enum 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)
341  enum 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)
363  enum 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)
375  enum 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)
381  enum 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)
392  enum 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)
407  enum 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)
417  enum 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)
443  enum 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)
450  enum 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)
457  enum 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)
483  enum 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)
489  enum 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)
514  enum 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)
520  enum 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)
544  enum 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)
567  enum 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)
577  enum 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)
588  enum 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)
598  enum 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)
625  enum 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)
636  enum 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)
650  enum 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)
658  enum 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)
667  enum 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)
677  enum 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)
686  enum 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)
693  enum 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)
719  enum 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)
732  enum 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)
738  enum 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)
755  enum 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)
761  enum 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)
769  enum 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)
786  enum 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)
803  enum 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   */
832  enum 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   */
869  enum 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  #define V4L2_CID_MPEG_VIDEO_AVERAGE_QP  (V4L2_CID_CODEC_BASE + 657)
902  
903  /*  MPEG-class control IDs specific to the CX2341x driver as defined by V4L2 */
904  #define V4L2_CID_CODEC_CX2341X_BASE				(V4L2_CTRL_CLASS_CODEC | 0x1000)
905  #define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE		(V4L2_CID_CODEC_CX2341X_BASE+0)
906  enum v4l2_mpeg_cx2341x_video_spatial_filter_mode {
907  	V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_MANUAL = 0,
908  	V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_AUTO   = 1,
909  };
910  #define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER		(V4L2_CID_CODEC_CX2341X_BASE+1)
911  #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE	(V4L2_CID_CODEC_CX2341X_BASE+2)
912  enum v4l2_mpeg_cx2341x_video_luma_spatial_filter_type {
913  	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_OFF                  = 0,
914  	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_HOR               = 1,
915  	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_VERT              = 2,
916  	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_HV_SEPARABLE      = 3,
917  	V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_SYM_NON_SEPARABLE = 4,
918  };
919  #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE	(V4L2_CID_CODEC_CX2341X_BASE+3)
920  enum v4l2_mpeg_cx2341x_video_chroma_spatial_filter_type {
921  	V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_OFF    = 0,
922  	V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_1D_HOR = 1,
923  };
924  #define V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE	(V4L2_CID_CODEC_CX2341X_BASE+4)
925  enum v4l2_mpeg_cx2341x_video_temporal_filter_mode {
926  	V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_MANUAL = 0,
927  	V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_AUTO   = 1,
928  };
929  #define V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER		(V4L2_CID_CODEC_CX2341X_BASE+5)
930  #define V4L2_CID_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE		(V4L2_CID_CODEC_CX2341X_BASE+6)
931  enum v4l2_mpeg_cx2341x_video_median_filter_type {
932  	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_OFF      = 0,
933  	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR      = 1,
934  	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_VERT     = 2,
935  	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR_VERT = 3,
936  	V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_DIAG     = 4,
937  };
938  #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_BOTTOM	(V4L2_CID_CODEC_CX2341X_BASE+7)
939  #define V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_TOP	(V4L2_CID_CODEC_CX2341X_BASE+8)
940  #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_BOTTOM	(V4L2_CID_CODEC_CX2341X_BASE+9)
941  #define V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_TOP	(V4L2_CID_CODEC_CX2341X_BASE+10)
942  #define V4L2_CID_MPEG_CX2341X_STREAM_INSERT_NAV_PACKETS		(V4L2_CID_CODEC_CX2341X_BASE+11)
943  
944  /*  MPEG-class control IDs specific to the Samsung MFC 5.1 driver as defined by V4L2 */
945  #define V4L2_CID_CODEC_MFC51_BASE				(V4L2_CTRL_CLASS_CODEC | 0x1100)
946  
947  #define V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY		(V4L2_CID_CODEC_MFC51_BASE+0)
948  #define V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY_ENABLE	(V4L2_CID_CODEC_MFC51_BASE+1)
949  #define V4L2_CID_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE			(V4L2_CID_CODEC_MFC51_BASE+2)
950  enum v4l2_mpeg_mfc51_video_frame_skip_mode {
951  	V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_DISABLED		= 0,
952  	V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_LEVEL_LIMIT	= 1,
953  	V4L2_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE_BUF_LIMIT		= 2,
954  };
955  #define V4L2_CID_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE			(V4L2_CID_CODEC_MFC51_BASE+3)
956  enum v4l2_mpeg_mfc51_video_force_frame_type {
957  	V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_DISABLED		= 0,
958  	V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_I_FRAME		= 1,
959  	V4L2_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE_NOT_CODED	= 2,
960  };
961  #define V4L2_CID_MPEG_MFC51_VIDEO_PADDING				(V4L2_CID_CODEC_MFC51_BASE+4)
962  #define V4L2_CID_MPEG_MFC51_VIDEO_PADDING_YUV				(V4L2_CID_CODEC_MFC51_BASE+5)
963  #define V4L2_CID_MPEG_MFC51_VIDEO_RC_FIXED_TARGET_BIT			(V4L2_CID_CODEC_MFC51_BASE+6)
964  #define V4L2_CID_MPEG_MFC51_VIDEO_RC_REACTION_COEFF			(V4L2_CID_CODEC_MFC51_BASE+7)
965  #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_ACTIVITY		(V4L2_CID_CODEC_MFC51_BASE+50)
966  #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_DARK			(V4L2_CID_CODEC_MFC51_BASE+51)
967  #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_SMOOTH		(V4L2_CID_CODEC_MFC51_BASE+52)
968  #define V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_STATIC		(V4L2_CID_CODEC_MFC51_BASE+53)
969  #define V4L2_CID_MPEG_MFC51_VIDEO_H264_NUM_REF_PIC_FOR_P		(V4L2_CID_CODEC_MFC51_BASE+54)
970  
971  /*  Camera class control IDs */
972  
973  #define V4L2_CID_CAMERA_CLASS_BASE	(V4L2_CTRL_CLASS_CAMERA | 0x900)
974  #define V4L2_CID_CAMERA_CLASS		(V4L2_CTRL_CLASS_CAMERA | 1)
975  
976  #define V4L2_CID_EXPOSURE_AUTO			(V4L2_CID_CAMERA_CLASS_BASE+1)
977  enum  v4l2_exposure_auto_type {
978  	V4L2_EXPOSURE_AUTO = 0,
979  	V4L2_EXPOSURE_MANUAL = 1,
980  	V4L2_EXPOSURE_SHUTTER_PRIORITY = 2,
981  	V4L2_EXPOSURE_APERTURE_PRIORITY = 3
982  };
983  #define V4L2_CID_EXPOSURE_ABSOLUTE		(V4L2_CID_CAMERA_CLASS_BASE+2)
984  #define V4L2_CID_EXPOSURE_AUTO_PRIORITY		(V4L2_CID_CAMERA_CLASS_BASE+3)
985  
986  #define V4L2_CID_PAN_RELATIVE			(V4L2_CID_CAMERA_CLASS_BASE+4)
987  #define V4L2_CID_TILT_RELATIVE			(V4L2_CID_CAMERA_CLASS_BASE+5)
988  #define V4L2_CID_PAN_RESET			(V4L2_CID_CAMERA_CLASS_BASE+6)
989  #define V4L2_CID_TILT_RESET			(V4L2_CID_CAMERA_CLASS_BASE+7)
990  
991  #define V4L2_CID_PAN_ABSOLUTE			(V4L2_CID_CAMERA_CLASS_BASE+8)
992  #define V4L2_CID_TILT_ABSOLUTE			(V4L2_CID_CAMERA_CLASS_BASE+9)
993  
994  #define V4L2_CID_FOCUS_ABSOLUTE			(V4L2_CID_CAMERA_CLASS_BASE+10)
995  #define V4L2_CID_FOCUS_RELATIVE			(V4L2_CID_CAMERA_CLASS_BASE+11)
996  #define V4L2_CID_FOCUS_AUTO			(V4L2_CID_CAMERA_CLASS_BASE+12)
997  
998  #define V4L2_CID_ZOOM_ABSOLUTE			(V4L2_CID_CAMERA_CLASS_BASE+13)
999  #define V4L2_CID_ZOOM_RELATIVE			(V4L2_CID_CAMERA_CLASS_BASE+14)
1000  #define V4L2_CID_ZOOM_CONTINUOUS		(V4L2_CID_CAMERA_CLASS_BASE+15)
1001  
1002  #define V4L2_CID_PRIVACY			(V4L2_CID_CAMERA_CLASS_BASE+16)
1003  
1004  #define V4L2_CID_IRIS_ABSOLUTE			(V4L2_CID_CAMERA_CLASS_BASE+17)
1005  #define V4L2_CID_IRIS_RELATIVE			(V4L2_CID_CAMERA_CLASS_BASE+18)
1006  
1007  #define V4L2_CID_AUTO_EXPOSURE_BIAS		(V4L2_CID_CAMERA_CLASS_BASE+19)
1008  
1009  #define V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE	(V4L2_CID_CAMERA_CLASS_BASE+20)
1010  enum v4l2_auto_n_preset_white_balance {
1011  	V4L2_WHITE_BALANCE_MANUAL		= 0,
1012  	V4L2_WHITE_BALANCE_AUTO			= 1,
1013  	V4L2_WHITE_BALANCE_INCANDESCENT		= 2,
1014  	V4L2_WHITE_BALANCE_FLUORESCENT		= 3,
1015  	V4L2_WHITE_BALANCE_FLUORESCENT_H	= 4,
1016  	V4L2_WHITE_BALANCE_HORIZON		= 5,
1017  	V4L2_WHITE_BALANCE_DAYLIGHT		= 6,
1018  	V4L2_WHITE_BALANCE_FLASH		= 7,
1019  	V4L2_WHITE_BALANCE_CLOUDY		= 8,
1020  	V4L2_WHITE_BALANCE_SHADE		= 9,
1021  };
1022  
1023  #define V4L2_CID_WIDE_DYNAMIC_RANGE		(V4L2_CID_CAMERA_CLASS_BASE+21)
1024  #define V4L2_CID_IMAGE_STABILIZATION		(V4L2_CID_CAMERA_CLASS_BASE+22)
1025  
1026  #define V4L2_CID_ISO_SENSITIVITY		(V4L2_CID_CAMERA_CLASS_BASE+23)
1027  #define V4L2_CID_ISO_SENSITIVITY_AUTO		(V4L2_CID_CAMERA_CLASS_BASE+24)
1028  enum v4l2_iso_sensitivity_auto_type {
1029  	V4L2_ISO_SENSITIVITY_MANUAL		= 0,
1030  	V4L2_ISO_SENSITIVITY_AUTO		= 1,
1031  };
1032  
1033  #define V4L2_CID_EXPOSURE_METERING		(V4L2_CID_CAMERA_CLASS_BASE+25)
1034  enum v4l2_exposure_metering {
1035  	V4L2_EXPOSURE_METERING_AVERAGE		= 0,
1036  	V4L2_EXPOSURE_METERING_CENTER_WEIGHTED	= 1,
1037  	V4L2_EXPOSURE_METERING_SPOT		= 2,
1038  	V4L2_EXPOSURE_METERING_MATRIX		= 3,
1039  };
1040  
1041  #define V4L2_CID_SCENE_MODE			(V4L2_CID_CAMERA_CLASS_BASE+26)
1042  enum v4l2_scene_mode {
1043  	V4L2_SCENE_MODE_NONE			= 0,
1044  	V4L2_SCENE_MODE_BACKLIGHT		= 1,
1045  	V4L2_SCENE_MODE_BEACH_SNOW		= 2,
1046  	V4L2_SCENE_MODE_CANDLE_LIGHT		= 3,
1047  	V4L2_SCENE_MODE_DAWN_DUSK		= 4,
1048  	V4L2_SCENE_MODE_FALL_COLORS		= 5,
1049  	V4L2_SCENE_MODE_FIREWORKS		= 6,
1050  	V4L2_SCENE_MODE_LANDSCAPE		= 7,
1051  	V4L2_SCENE_MODE_NIGHT			= 8,
1052  	V4L2_SCENE_MODE_PARTY_INDOOR		= 9,
1053  	V4L2_SCENE_MODE_PORTRAIT		= 10,
1054  	V4L2_SCENE_MODE_SPORTS			= 11,
1055  	V4L2_SCENE_MODE_SUNSET			= 12,
1056  	V4L2_SCENE_MODE_TEXT			= 13,
1057  };
1058  
1059  #define V4L2_CID_3A_LOCK			(V4L2_CID_CAMERA_CLASS_BASE+27)
1060  #define V4L2_LOCK_EXPOSURE			(1 << 0)
1061  #define V4L2_LOCK_WHITE_BALANCE			(1 << 1)
1062  #define V4L2_LOCK_FOCUS				(1 << 2)
1063  
1064  #define V4L2_CID_AUTO_FOCUS_START		(V4L2_CID_CAMERA_CLASS_BASE+28)
1065  #define V4L2_CID_AUTO_FOCUS_STOP		(V4L2_CID_CAMERA_CLASS_BASE+29)
1066  #define V4L2_CID_AUTO_FOCUS_STATUS		(V4L2_CID_CAMERA_CLASS_BASE+30)
1067  #define V4L2_AUTO_FOCUS_STATUS_IDLE		(0 << 0)
1068  #define V4L2_AUTO_FOCUS_STATUS_BUSY		(1 << 0)
1069  #define V4L2_AUTO_FOCUS_STATUS_REACHED		(1 << 1)
1070  #define V4L2_AUTO_FOCUS_STATUS_FAILED		(1 << 2)
1071  
1072  #define V4L2_CID_AUTO_FOCUS_RANGE		(V4L2_CID_CAMERA_CLASS_BASE+31)
1073  enum v4l2_auto_focus_range {
1074  	V4L2_AUTO_FOCUS_RANGE_AUTO		= 0,
1075  	V4L2_AUTO_FOCUS_RANGE_NORMAL		= 1,
1076  	V4L2_AUTO_FOCUS_RANGE_MACRO		= 2,
1077  	V4L2_AUTO_FOCUS_RANGE_INFINITY		= 3,
1078  };
1079  
1080  #define V4L2_CID_PAN_SPEED			(V4L2_CID_CAMERA_CLASS_BASE+32)
1081  #define V4L2_CID_TILT_SPEED			(V4L2_CID_CAMERA_CLASS_BASE+33)
1082  
1083  #define V4L2_CID_CAMERA_ORIENTATION		(V4L2_CID_CAMERA_CLASS_BASE+34)
1084  #define V4L2_CAMERA_ORIENTATION_FRONT		0
1085  #define V4L2_CAMERA_ORIENTATION_BACK		1
1086  #define V4L2_CAMERA_ORIENTATION_EXTERNAL	2
1087  
1088  #define V4L2_CID_CAMERA_SENSOR_ROTATION		(V4L2_CID_CAMERA_CLASS_BASE+35)
1089  
1090  #define V4L2_CID_HDR_SENSOR_MODE		(V4L2_CID_CAMERA_CLASS_BASE+36)
1091  
1092  /* FM Modulator class control IDs */
1093  
1094  #define V4L2_CID_FM_TX_CLASS_BASE		(V4L2_CTRL_CLASS_FM_TX | 0x900)
1095  #define V4L2_CID_FM_TX_CLASS			(V4L2_CTRL_CLASS_FM_TX | 1)
1096  
1097  #define V4L2_CID_RDS_TX_DEVIATION		(V4L2_CID_FM_TX_CLASS_BASE + 1)
1098  #define V4L2_CID_RDS_TX_PI			(V4L2_CID_FM_TX_CLASS_BASE + 2)
1099  #define V4L2_CID_RDS_TX_PTY			(V4L2_CID_FM_TX_CLASS_BASE + 3)
1100  #define V4L2_CID_RDS_TX_PS_NAME			(V4L2_CID_FM_TX_CLASS_BASE + 5)
1101  #define V4L2_CID_RDS_TX_RADIO_TEXT		(V4L2_CID_FM_TX_CLASS_BASE + 6)
1102  #define V4L2_CID_RDS_TX_MONO_STEREO		(V4L2_CID_FM_TX_CLASS_BASE + 7)
1103  #define V4L2_CID_RDS_TX_ARTIFICIAL_HEAD		(V4L2_CID_FM_TX_CLASS_BASE + 8)
1104  #define V4L2_CID_RDS_TX_COMPRESSED		(V4L2_CID_FM_TX_CLASS_BASE + 9)
1105  #define V4L2_CID_RDS_TX_DYNAMIC_PTY		(V4L2_CID_FM_TX_CLASS_BASE + 10)
1106  #define V4L2_CID_RDS_TX_TRAFFIC_ANNOUNCEMENT	(V4L2_CID_FM_TX_CLASS_BASE + 11)
1107  #define V4L2_CID_RDS_TX_TRAFFIC_PROGRAM		(V4L2_CID_FM_TX_CLASS_BASE + 12)
1108  #define V4L2_CID_RDS_TX_MUSIC_SPEECH		(V4L2_CID_FM_TX_CLASS_BASE + 13)
1109  #define V4L2_CID_RDS_TX_ALT_FREQS_ENABLE	(V4L2_CID_FM_TX_CLASS_BASE + 14)
1110  #define V4L2_CID_RDS_TX_ALT_FREQS		(V4L2_CID_FM_TX_CLASS_BASE + 15)
1111  
1112  #define V4L2_CID_AUDIO_LIMITER_ENABLED		(V4L2_CID_FM_TX_CLASS_BASE + 64)
1113  #define V4L2_CID_AUDIO_LIMITER_RELEASE_TIME	(V4L2_CID_FM_TX_CLASS_BASE + 65)
1114  #define V4L2_CID_AUDIO_LIMITER_DEVIATION	(V4L2_CID_FM_TX_CLASS_BASE + 66)
1115  
1116  #define V4L2_CID_AUDIO_COMPRESSION_ENABLED	(V4L2_CID_FM_TX_CLASS_BASE + 80)
1117  #define V4L2_CID_AUDIO_COMPRESSION_GAIN		(V4L2_CID_FM_TX_CLASS_BASE + 81)
1118  #define V4L2_CID_AUDIO_COMPRESSION_THRESHOLD	(V4L2_CID_FM_TX_CLASS_BASE + 82)
1119  #define V4L2_CID_AUDIO_COMPRESSION_ATTACK_TIME	(V4L2_CID_FM_TX_CLASS_BASE + 83)
1120  #define V4L2_CID_AUDIO_COMPRESSION_RELEASE_TIME	(V4L2_CID_FM_TX_CLASS_BASE + 84)
1121  
1122  #define V4L2_CID_PILOT_TONE_ENABLED		(V4L2_CID_FM_TX_CLASS_BASE + 96)
1123  #define V4L2_CID_PILOT_TONE_DEVIATION		(V4L2_CID_FM_TX_CLASS_BASE + 97)
1124  #define V4L2_CID_PILOT_TONE_FREQUENCY		(V4L2_CID_FM_TX_CLASS_BASE + 98)
1125  
1126  #define V4L2_CID_TUNE_PREEMPHASIS		(V4L2_CID_FM_TX_CLASS_BASE + 112)
1127  enum v4l2_preemphasis {
1128  	V4L2_PREEMPHASIS_DISABLED	= 0,
1129  	V4L2_PREEMPHASIS_50_uS		= 1,
1130  	V4L2_PREEMPHASIS_75_uS		= 2,
1131  };
1132  #define V4L2_CID_TUNE_POWER_LEVEL		(V4L2_CID_FM_TX_CLASS_BASE + 113)
1133  #define V4L2_CID_TUNE_ANTENNA_CAPACITOR		(V4L2_CID_FM_TX_CLASS_BASE + 114)
1134  
1135  
1136  /* Flash and privacy (indicator) light controls */
1137  
1138  #define V4L2_CID_FLASH_CLASS_BASE		(V4L2_CTRL_CLASS_FLASH | 0x900)
1139  #define V4L2_CID_FLASH_CLASS			(V4L2_CTRL_CLASS_FLASH | 1)
1140  
1141  #define V4L2_CID_FLASH_LED_MODE			(V4L2_CID_FLASH_CLASS_BASE + 1)
1142  enum v4l2_flash_led_mode {
1143  	V4L2_FLASH_LED_MODE_NONE,
1144  	V4L2_FLASH_LED_MODE_FLASH,
1145  	V4L2_FLASH_LED_MODE_TORCH,
1146  };
1147  
1148  #define V4L2_CID_FLASH_STROBE_SOURCE		(V4L2_CID_FLASH_CLASS_BASE + 2)
1149  enum v4l2_flash_strobe_source {
1150  	V4L2_FLASH_STROBE_SOURCE_SOFTWARE,
1151  	V4L2_FLASH_STROBE_SOURCE_EXTERNAL,
1152  };
1153  
1154  #define V4L2_CID_FLASH_STROBE			(V4L2_CID_FLASH_CLASS_BASE + 3)
1155  #define V4L2_CID_FLASH_STROBE_STOP		(V4L2_CID_FLASH_CLASS_BASE + 4)
1156  #define V4L2_CID_FLASH_STROBE_STATUS		(V4L2_CID_FLASH_CLASS_BASE + 5)
1157  
1158  #define V4L2_CID_FLASH_TIMEOUT			(V4L2_CID_FLASH_CLASS_BASE + 6)
1159  #define V4L2_CID_FLASH_INTENSITY		(V4L2_CID_FLASH_CLASS_BASE + 7)
1160  #define V4L2_CID_FLASH_TORCH_INTENSITY		(V4L2_CID_FLASH_CLASS_BASE + 8)
1161  #define V4L2_CID_FLASH_INDICATOR_INTENSITY	(V4L2_CID_FLASH_CLASS_BASE + 9)
1162  
1163  #define V4L2_CID_FLASH_FAULT			(V4L2_CID_FLASH_CLASS_BASE + 10)
1164  #define V4L2_FLASH_FAULT_OVER_VOLTAGE		(1 << 0)
1165  #define V4L2_FLASH_FAULT_TIMEOUT		(1 << 1)
1166  #define V4L2_FLASH_FAULT_OVER_TEMPERATURE	(1 << 2)
1167  #define V4L2_FLASH_FAULT_SHORT_CIRCUIT		(1 << 3)
1168  #define V4L2_FLASH_FAULT_OVER_CURRENT		(1 << 4)
1169  #define V4L2_FLASH_FAULT_INDICATOR		(1 << 5)
1170  #define V4L2_FLASH_FAULT_UNDER_VOLTAGE		(1 << 6)
1171  #define V4L2_FLASH_FAULT_INPUT_VOLTAGE		(1 << 7)
1172  #define V4L2_FLASH_FAULT_LED_OVER_TEMPERATURE	(1 << 8)
1173  
1174  #define V4L2_CID_FLASH_CHARGE			(V4L2_CID_FLASH_CLASS_BASE + 11)
1175  #define V4L2_CID_FLASH_READY			(V4L2_CID_FLASH_CLASS_BASE + 12)
1176  
1177  
1178  /* JPEG-class control IDs */
1179  
1180  #define V4L2_CID_JPEG_CLASS_BASE		(V4L2_CTRL_CLASS_JPEG | 0x900)
1181  #define V4L2_CID_JPEG_CLASS			(V4L2_CTRL_CLASS_JPEG | 1)
1182  
1183  #define	V4L2_CID_JPEG_CHROMA_SUBSAMPLING	(V4L2_CID_JPEG_CLASS_BASE + 1)
1184  enum v4l2_jpeg_chroma_subsampling {
1185  	V4L2_JPEG_CHROMA_SUBSAMPLING_444	= 0,
1186  	V4L2_JPEG_CHROMA_SUBSAMPLING_422	= 1,
1187  	V4L2_JPEG_CHROMA_SUBSAMPLING_420	= 2,
1188  	V4L2_JPEG_CHROMA_SUBSAMPLING_411	= 3,
1189  	V4L2_JPEG_CHROMA_SUBSAMPLING_410	= 4,
1190  	V4L2_JPEG_CHROMA_SUBSAMPLING_GRAY	= 5,
1191  };
1192  #define	V4L2_CID_JPEG_RESTART_INTERVAL		(V4L2_CID_JPEG_CLASS_BASE + 2)
1193  #define	V4L2_CID_JPEG_COMPRESSION_QUALITY	(V4L2_CID_JPEG_CLASS_BASE + 3)
1194  
1195  #define	V4L2_CID_JPEG_ACTIVE_MARKER		(V4L2_CID_JPEG_CLASS_BASE + 4)
1196  #define	V4L2_JPEG_ACTIVE_MARKER_APP0		(1 << 0)
1197  #define	V4L2_JPEG_ACTIVE_MARKER_APP1		(1 << 1)
1198  #define	V4L2_JPEG_ACTIVE_MARKER_COM		(1 << 16)
1199  #define	V4L2_JPEG_ACTIVE_MARKER_DQT		(1 << 17)
1200  #define	V4L2_JPEG_ACTIVE_MARKER_DHT		(1 << 18)
1201  
1202  
1203  /* Image source controls */
1204  #define V4L2_CID_IMAGE_SOURCE_CLASS_BASE	(V4L2_CTRL_CLASS_IMAGE_SOURCE | 0x900)
1205  #define V4L2_CID_IMAGE_SOURCE_CLASS		(V4L2_CTRL_CLASS_IMAGE_SOURCE | 1)
1206  
1207  #define V4L2_CID_VBLANK				(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 1)
1208  #define V4L2_CID_HBLANK				(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 2)
1209  #define V4L2_CID_ANALOGUE_GAIN			(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 3)
1210  #define V4L2_CID_TEST_PATTERN_RED		(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 4)
1211  #define V4L2_CID_TEST_PATTERN_GREENR		(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 5)
1212  #define V4L2_CID_TEST_PATTERN_BLUE		(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 6)
1213  #define V4L2_CID_TEST_PATTERN_GREENB		(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 7)
1214  #define V4L2_CID_UNIT_CELL_SIZE			(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 8)
1215  #define V4L2_CID_NOTIFY_GAINS			(V4L2_CID_IMAGE_SOURCE_CLASS_BASE + 9)
1216  
1217  
1218  /* Image processing controls */
1219  
1220  #define V4L2_CID_IMAGE_PROC_CLASS_BASE		(V4L2_CTRL_CLASS_IMAGE_PROC | 0x900)
1221  #define V4L2_CID_IMAGE_PROC_CLASS		(V4L2_CTRL_CLASS_IMAGE_PROC | 1)
1222  
1223  #define V4L2_CID_LINK_FREQ			(V4L2_CID_IMAGE_PROC_CLASS_BASE + 1)
1224  #define V4L2_CID_PIXEL_RATE			(V4L2_CID_IMAGE_PROC_CLASS_BASE + 2)
1225  #define V4L2_CID_TEST_PATTERN			(V4L2_CID_IMAGE_PROC_CLASS_BASE + 3)
1226  #define V4L2_CID_DEINTERLACING_MODE		(V4L2_CID_IMAGE_PROC_CLASS_BASE + 4)
1227  #define V4L2_CID_DIGITAL_GAIN			(V4L2_CID_IMAGE_PROC_CLASS_BASE + 5)
1228  
1229  /*  DV-class control IDs defined by V4L2 */
1230  #define V4L2_CID_DV_CLASS_BASE			(V4L2_CTRL_CLASS_DV | 0x900)
1231  #define V4L2_CID_DV_CLASS			(V4L2_CTRL_CLASS_DV | 1)
1232  
1233  #define	V4L2_CID_DV_TX_HOTPLUG			(V4L2_CID_DV_CLASS_BASE + 1)
1234  #define	V4L2_CID_DV_TX_RXSENSE			(V4L2_CID_DV_CLASS_BASE + 2)
1235  #define	V4L2_CID_DV_TX_EDID_PRESENT		(V4L2_CID_DV_CLASS_BASE + 3)
1236  #define	V4L2_CID_DV_TX_MODE			(V4L2_CID_DV_CLASS_BASE + 4)
1237  enum v4l2_dv_tx_mode {
1238  	V4L2_DV_TX_MODE_DVI_D	= 0,
1239  	V4L2_DV_TX_MODE_HDMI	= 1,
1240  };
1241  #define V4L2_CID_DV_TX_RGB_RANGE		(V4L2_CID_DV_CLASS_BASE + 5)
1242  enum v4l2_dv_rgb_range {
1243  	V4L2_DV_RGB_RANGE_AUTO	  = 0,
1244  	V4L2_DV_RGB_RANGE_LIMITED = 1,
1245  	V4L2_DV_RGB_RANGE_FULL	  = 2,
1246  };
1247  
1248  #define V4L2_CID_DV_TX_IT_CONTENT_TYPE		(V4L2_CID_DV_CLASS_BASE + 6)
1249  enum v4l2_dv_it_content_type {
1250  	V4L2_DV_IT_CONTENT_TYPE_GRAPHICS  = 0,
1251  	V4L2_DV_IT_CONTENT_TYPE_PHOTO	  = 1,
1252  	V4L2_DV_IT_CONTENT_TYPE_CINEMA	  = 2,
1253  	V4L2_DV_IT_CONTENT_TYPE_GAME	  = 3,
1254  	V4L2_DV_IT_CONTENT_TYPE_NO_ITC	  = 4,
1255  };
1256  
1257  #define	V4L2_CID_DV_RX_POWER_PRESENT		(V4L2_CID_DV_CLASS_BASE + 100)
1258  #define V4L2_CID_DV_RX_RGB_RANGE		(V4L2_CID_DV_CLASS_BASE + 101)
1259  #define V4L2_CID_DV_RX_IT_CONTENT_TYPE		(V4L2_CID_DV_CLASS_BASE + 102)
1260  
1261  #define V4L2_CID_FM_RX_CLASS_BASE		(V4L2_CTRL_CLASS_FM_RX | 0x900)
1262  #define V4L2_CID_FM_RX_CLASS			(V4L2_CTRL_CLASS_FM_RX | 1)
1263  
1264  #define V4L2_CID_TUNE_DEEMPHASIS		(V4L2_CID_FM_RX_CLASS_BASE + 1)
1265  enum v4l2_deemphasis {
1266  	V4L2_DEEMPHASIS_DISABLED	= V4L2_PREEMPHASIS_DISABLED,
1267  	V4L2_DEEMPHASIS_50_uS		= V4L2_PREEMPHASIS_50_uS,
1268  	V4L2_DEEMPHASIS_75_uS		= V4L2_PREEMPHASIS_75_uS,
1269  };
1270  
1271  #define V4L2_CID_RDS_RECEPTION			(V4L2_CID_FM_RX_CLASS_BASE + 2)
1272  #define V4L2_CID_RDS_RX_PTY			(V4L2_CID_FM_RX_CLASS_BASE + 3)
1273  #define V4L2_CID_RDS_RX_PS_NAME			(V4L2_CID_FM_RX_CLASS_BASE + 4)
1274  #define V4L2_CID_RDS_RX_RADIO_TEXT		(V4L2_CID_FM_RX_CLASS_BASE + 5)
1275  #define V4L2_CID_RDS_RX_TRAFFIC_ANNOUNCEMENT	(V4L2_CID_FM_RX_CLASS_BASE + 6)
1276  #define V4L2_CID_RDS_RX_TRAFFIC_PROGRAM		(V4L2_CID_FM_RX_CLASS_BASE + 7)
1277  #define V4L2_CID_RDS_RX_MUSIC_SPEECH		(V4L2_CID_FM_RX_CLASS_BASE + 8)
1278  
1279  #define V4L2_CID_RF_TUNER_CLASS_BASE		(V4L2_CTRL_CLASS_RF_TUNER | 0x900)
1280  #define V4L2_CID_RF_TUNER_CLASS			(V4L2_CTRL_CLASS_RF_TUNER | 1)
1281  
1282  #define V4L2_CID_RF_TUNER_BANDWIDTH_AUTO	(V4L2_CID_RF_TUNER_CLASS_BASE + 11)
1283  #define V4L2_CID_RF_TUNER_BANDWIDTH		(V4L2_CID_RF_TUNER_CLASS_BASE + 12)
1284  #define V4L2_CID_RF_TUNER_RF_GAIN		(V4L2_CID_RF_TUNER_CLASS_BASE + 32)
1285  #define V4L2_CID_RF_TUNER_LNA_GAIN_AUTO		(V4L2_CID_RF_TUNER_CLASS_BASE + 41)
1286  #define V4L2_CID_RF_TUNER_LNA_GAIN		(V4L2_CID_RF_TUNER_CLASS_BASE + 42)
1287  #define V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO	(V4L2_CID_RF_TUNER_CLASS_BASE + 51)
1288  #define V4L2_CID_RF_TUNER_MIXER_GAIN		(V4L2_CID_RF_TUNER_CLASS_BASE + 52)
1289  #define V4L2_CID_RF_TUNER_IF_GAIN_AUTO		(V4L2_CID_RF_TUNER_CLASS_BASE + 61)
1290  #define V4L2_CID_RF_TUNER_IF_GAIN		(V4L2_CID_RF_TUNER_CLASS_BASE + 62)
1291  #define V4L2_CID_RF_TUNER_PLL_LOCK			(V4L2_CID_RF_TUNER_CLASS_BASE + 91)
1292  
1293  
1294  /*  Detection-class control IDs defined by V4L2 */
1295  #define V4L2_CID_DETECT_CLASS_BASE		(V4L2_CTRL_CLASS_DETECT | 0x900)
1296  #define V4L2_CID_DETECT_CLASS			(V4L2_CTRL_CLASS_DETECT | 1)
1297  
1298  #define V4L2_CID_DETECT_MD_MODE			(V4L2_CID_DETECT_CLASS_BASE + 1)
1299  enum v4l2_detect_md_mode {
1300  	V4L2_DETECT_MD_MODE_DISABLED		= 0,
1301  	V4L2_DETECT_MD_MODE_GLOBAL		= 1,
1302  	V4L2_DETECT_MD_MODE_THRESHOLD_GRID	= 2,
1303  	V4L2_DETECT_MD_MODE_REGION_GRID		= 3,
1304  };
1305  #define V4L2_CID_DETECT_MD_GLOBAL_THRESHOLD	(V4L2_CID_DETECT_CLASS_BASE + 2)
1306  #define V4L2_CID_DETECT_MD_THRESHOLD_GRID	(V4L2_CID_DETECT_CLASS_BASE + 3)
1307  #define V4L2_CID_DETECT_MD_REGION_GRID		(V4L2_CID_DETECT_CLASS_BASE + 4)
1308  
1309  
1310  /*  Stateless CODECs controls */
1311  #define V4L2_CID_CODEC_STATELESS_BASE          (V4L2_CTRL_CLASS_CODEC_STATELESS | 0x900)
1312  #define V4L2_CID_CODEC_STATELESS_CLASS         (V4L2_CTRL_CLASS_CODEC_STATELESS | 1)
1313  
1314  #define V4L2_CID_STATELESS_H264_DECODE_MODE	(V4L2_CID_CODEC_STATELESS_BASE + 0)
1315  /**
1316   * enum v4l2_stateless_h264_decode_mode - Decoding mode
1317   *
1318   * @V4L2_STATELESS_H264_DECODE_MODE_SLICE_BASED: indicates that decoding
1319   * is performed one slice at a time. In this mode,
1320   * V4L2_CID_STATELESS_H264_SLICE_PARAMS must contain the parsed slice
1321   * parameters and the OUTPUT buffer must contain a single slice.
1322   * V4L2_BUF_CAP_SUPPORTS_M2M_HOLD_CAPTURE_BUF feature is used
1323   * in order to support multislice frames.
1324   * @V4L2_STATELESS_H264_DECODE_MODE_FRAME_BASED: indicates that
1325   * decoding is performed per frame. The OUTPUT buffer must contain
1326   * all slices and also both fields. This mode is typically supported
1327   * by device drivers that are able to parse the slice(s) header(s)
1328   * in hardware. When this mode is selected,
1329   * V4L2_CID_STATELESS_H264_SLICE_PARAMS is not used.
1330   */
1331  enum v4l2_stateless_h264_decode_mode {
1332  	V4L2_STATELESS_H264_DECODE_MODE_SLICE_BASED,
1333  	V4L2_STATELESS_H264_DECODE_MODE_FRAME_BASED,
1334  };
1335  
1336  #define V4L2_CID_STATELESS_H264_START_CODE	(V4L2_CID_CODEC_STATELESS_BASE + 1)
1337  /**
1338   * enum v4l2_stateless_h264_start_code - Start code
1339   *
1340   * @V4L2_STATELESS_H264_START_CODE_NONE: slices are passed
1341   * to the driver without any start code.
1342   * @V4L2_STATELESS_H264_START_CODE_ANNEX_B: slices are passed
1343   * to the driver with an Annex B start code prefix
1344   * (legal start codes can be 3-bytes 0x000001 or 4-bytes 0x00000001).
1345   * This mode is typically supported by device drivers that parse
1346   * the start code in hardware.
1347   */
1348  enum v4l2_stateless_h264_start_code {
1349  	V4L2_STATELESS_H264_START_CODE_NONE,
1350  	V4L2_STATELESS_H264_START_CODE_ANNEX_B,
1351  };
1352  
1353  #define V4L2_H264_SPS_CONSTRAINT_SET0_FLAG			0x01
1354  #define V4L2_H264_SPS_CONSTRAINT_SET1_FLAG			0x02
1355  #define V4L2_H264_SPS_CONSTRAINT_SET2_FLAG			0x04
1356  #define V4L2_H264_SPS_CONSTRAINT_SET3_FLAG			0x08
1357  #define V4L2_H264_SPS_CONSTRAINT_SET4_FLAG			0x10
1358  #define V4L2_H264_SPS_CONSTRAINT_SET5_FLAG			0x20
1359  
1360  #define V4L2_H264_SPS_FLAG_SEPARATE_COLOUR_PLANE		0x01
1361  #define V4L2_H264_SPS_FLAG_QPPRIME_Y_ZERO_TRANSFORM_BYPASS	0x02
1362  #define V4L2_H264_SPS_FLAG_DELTA_PIC_ORDER_ALWAYS_ZERO		0x04
1363  #define V4L2_H264_SPS_FLAG_GAPS_IN_FRAME_NUM_VALUE_ALLOWED	0x08
1364  #define V4L2_H264_SPS_FLAG_FRAME_MBS_ONLY			0x10
1365  #define V4L2_H264_SPS_FLAG_MB_ADAPTIVE_FRAME_FIELD		0x20
1366  #define V4L2_H264_SPS_FLAG_DIRECT_8X8_INFERENCE			0x40
1367  
1368  #define V4L2_H264_SPS_HAS_CHROMA_FORMAT(sps) \
1369  	((sps)->profile_idc == 100 || (sps)->profile_idc == 110 || \
1370  	 (sps)->profile_idc == 122 || (sps)->profile_idc == 244 || \
1371  	 (sps)->profile_idc == 44  || (sps)->profile_idc == 83  || \
1372  	 (sps)->profile_idc == 86  || (sps)->profile_idc == 118 || \
1373  	 (sps)->profile_idc == 128 || (sps)->profile_idc == 138 || \
1374  	 (sps)->profile_idc == 139 || (sps)->profile_idc == 134 || \
1375  	 (sps)->profile_idc == 135)
1376  
1377  #define V4L2_CID_STATELESS_H264_SPS		(V4L2_CID_CODEC_STATELESS_BASE + 2)
1378  /**
1379   * struct v4l2_ctrl_h264_sps - H264 sequence parameter set
1380   *
1381   * All the members on this sequence parameter set structure match the
1382   * sequence parameter set syntax as specified by the H264 specification.
1383   *
1384   * @profile_idc: see H264 specification.
1385   * @constraint_set_flags: see H264 specification.
1386   * @level_idc: see H264 specification.
1387   * @seq_parameter_set_id: see H264 specification.
1388   * @chroma_format_idc: see H264 specification.
1389   * @bit_depth_luma_minus8: see H264 specification.
1390   * @bit_depth_chroma_minus8: see H264 specification.
1391   * @log2_max_frame_num_minus4: see H264 specification.
1392   * @pic_order_cnt_type: see H264 specification.
1393   * @log2_max_pic_order_cnt_lsb_minus4: see H264 specification.
1394   * @max_num_ref_frames: see H264 specification.
1395   * @num_ref_frames_in_pic_order_cnt_cycle: see H264 specification.
1396   * @offset_for_ref_frame: see H264 specification.
1397   * @offset_for_non_ref_pic: see H264 specification.
1398   * @offset_for_top_to_bottom_field: see H264 specification.
1399   * @pic_width_in_mbs_minus1: see H264 specification.
1400   * @pic_height_in_map_units_minus1: see H264 specification.
1401   * @flags: see V4L2_H264_SPS_FLAG_{}.
1402   */
1403  struct v4l2_ctrl_h264_sps {
1404  	__u8 profile_idc;
1405  	__u8 constraint_set_flags;
1406  	__u8 level_idc;
1407  	__u8 seq_parameter_set_id;
1408  	__u8 chroma_format_idc;
1409  	__u8 bit_depth_luma_minus8;
1410  	__u8 bit_depth_chroma_minus8;
1411  	__u8 log2_max_frame_num_minus4;
1412  	__u8 pic_order_cnt_type;
1413  	__u8 log2_max_pic_order_cnt_lsb_minus4;
1414  	__u8 max_num_ref_frames;
1415  	__u8 num_ref_frames_in_pic_order_cnt_cycle;
1416  	__s32 offset_for_ref_frame[255];
1417  	__s32 offset_for_non_ref_pic;
1418  	__s32 offset_for_top_to_bottom_field;
1419  	__u16 pic_width_in_mbs_minus1;
1420  	__u16 pic_height_in_map_units_minus1;
1421  	__u32 flags;
1422  };
1423  
1424  #define V4L2_H264_PPS_FLAG_ENTROPY_CODING_MODE				0x0001
1425  #define V4L2_H264_PPS_FLAG_BOTTOM_FIELD_PIC_ORDER_IN_FRAME_PRESENT	0x0002
1426  #define V4L2_H264_PPS_FLAG_WEIGHTED_PRED				0x0004
1427  #define V4L2_H264_PPS_FLAG_DEBLOCKING_FILTER_CONTROL_PRESENT		0x0008
1428  #define V4L2_H264_PPS_FLAG_CONSTRAINED_INTRA_PRED			0x0010
1429  #define V4L2_H264_PPS_FLAG_REDUNDANT_PIC_CNT_PRESENT			0x0020
1430  #define V4L2_H264_PPS_FLAG_TRANSFORM_8X8_MODE				0x0040
1431  #define V4L2_H264_PPS_FLAG_SCALING_MATRIX_PRESENT			0x0080
1432  
1433  #define V4L2_CID_STATELESS_H264_PPS		(V4L2_CID_CODEC_STATELESS_BASE + 3)
1434  /**
1435   * struct v4l2_ctrl_h264_pps - H264 picture parameter set
1436   *
1437   * Except where noted, all the members on this picture parameter set
1438   * structure match the picture parameter set syntax as specified
1439   * by the H264 specification.
1440   *
1441   * In particular, V4L2_H264_PPS_FLAG_SCALING_MATRIX_PRESENT flag
1442   * has a specific meaning. This flag should be set if a non-flat
1443   * scaling matrix applies to the picture. In this case, applications
1444   * are expected to use V4L2_CID_STATELESS_H264_SCALING_MATRIX,
1445   * to pass the values of the non-flat matrices.
1446   *
1447   * @pic_parameter_set_id: see H264 specification.
1448   * @seq_parameter_set_id: see H264 specification.
1449   * @num_slice_groups_minus1: see H264 specification.
1450   * @num_ref_idx_l0_default_active_minus1: see H264 specification.
1451   * @num_ref_idx_l1_default_active_minus1: see H264 specification.
1452   * @weighted_bipred_idc: see H264 specification.
1453   * @pic_init_qp_minus26: see H264 specification.
1454   * @pic_init_qs_minus26: see H264 specification.
1455   * @chroma_qp_index_offset: see H264 specification.
1456   * @second_chroma_qp_index_offset: see H264 specification.
1457   * @flags: see V4L2_H264_PPS_FLAG_{}.
1458   */
1459  struct v4l2_ctrl_h264_pps {
1460  	__u8 pic_parameter_set_id;
1461  	__u8 seq_parameter_set_id;
1462  	__u8 num_slice_groups_minus1;
1463  	__u8 num_ref_idx_l0_default_active_minus1;
1464  	__u8 num_ref_idx_l1_default_active_minus1;
1465  	__u8 weighted_bipred_idc;
1466  	__s8 pic_init_qp_minus26;
1467  	__s8 pic_init_qs_minus26;
1468  	__s8 chroma_qp_index_offset;
1469  	__s8 second_chroma_qp_index_offset;
1470  	__u16 flags;
1471  };
1472  
1473  #define V4L2_CID_STATELESS_H264_SCALING_MATRIX	(V4L2_CID_CODEC_STATELESS_BASE + 4)
1474  /**
1475   * struct v4l2_ctrl_h264_scaling_matrix - H264 scaling matrices
1476   *
1477   * @scaling_list_4x4: scaling matrix after applying the inverse
1478   * scanning process. Expected list order is Intra Y, Intra Cb,
1479   * Intra Cr, Inter Y, Inter Cb, Inter Cr. The values on each
1480   * scaling list are expected in raster scan order.
1481   * @scaling_list_8x8: scaling matrix after applying the inverse
1482   * scanning process. Expected list order is Intra Y, Inter Y,
1483   * Intra Cb, Inter Cb, Intra Cr, Inter Cr. The values on each
1484   * scaling list are expected in raster scan order.
1485   *
1486   * Note that the list order is different for the 4x4 and 8x8
1487   * matrices as per the H264 specification, see table 7-2 "Assignment
1488   * of mnemonic names to scaling list indices and specification of
1489   * fall-back rule".
1490   */
1491  struct v4l2_ctrl_h264_scaling_matrix {
1492  	__u8 scaling_list_4x4[6][16];
1493  	__u8 scaling_list_8x8[6][64];
1494  };
1495  
1496  struct v4l2_h264_weight_factors {
1497  	__s16 luma_weight[32];
1498  	__s16 luma_offset[32];
1499  	__s16 chroma_weight[32][2];
1500  	__s16 chroma_offset[32][2];
1501  };
1502  
1503  #define V4L2_H264_CTRL_PRED_WEIGHTS_REQUIRED(pps, slice) \
1504  	((((pps)->flags & V4L2_H264_PPS_FLAG_WEIGHTED_PRED) && \
1505  	 ((slice)->slice_type == V4L2_H264_SLICE_TYPE_P || \
1506  	  (slice)->slice_type == V4L2_H264_SLICE_TYPE_SP)) || \
1507  	 ((pps)->weighted_bipred_idc == 1 && \
1508  	  (slice)->slice_type == V4L2_H264_SLICE_TYPE_B))
1509  
1510  #define V4L2_CID_STATELESS_H264_PRED_WEIGHTS	(V4L2_CID_CODEC_STATELESS_BASE + 5)
1511  /**
1512   * struct v4l2_ctrl_h264_pred_weights - Prediction weight table
1513   *
1514   * Prediction weight table, which matches the syntax specified
1515   * by the H264 specification.
1516   *
1517   * @luma_log2_weight_denom: see H264 specification.
1518   * @chroma_log2_weight_denom: see H264 specification.
1519   * @weight_factors: luma and chroma weight factors.
1520   */
1521  struct v4l2_ctrl_h264_pred_weights {
1522  	__u16 luma_log2_weight_denom;
1523  	__u16 chroma_log2_weight_denom;
1524  	struct v4l2_h264_weight_factors weight_factors[2];
1525  };
1526  
1527  #define V4L2_H264_SLICE_TYPE_P				0
1528  #define V4L2_H264_SLICE_TYPE_B				1
1529  #define V4L2_H264_SLICE_TYPE_I				2
1530  #define V4L2_H264_SLICE_TYPE_SP				3
1531  #define V4L2_H264_SLICE_TYPE_SI				4
1532  
1533  #define V4L2_H264_SLICE_FLAG_DIRECT_SPATIAL_MV_PRED	0x01
1534  #define V4L2_H264_SLICE_FLAG_SP_FOR_SWITCH		0x02
1535  
1536  #define V4L2_H264_TOP_FIELD_REF				0x1
1537  #define V4L2_H264_BOTTOM_FIELD_REF			0x2
1538  #define V4L2_H264_FRAME_REF				0x3
1539  
1540  /**
1541   * struct v4l2_h264_reference - H264 picture reference
1542   *
1543   * @fields: indicates how the picture is referenced.
1544   * Valid values are V4L2_H264_{}_REF.
1545   * @index: index into v4l2_ctrl_h264_decode_params.dpb[].
1546   */
1547  struct v4l2_h264_reference {
1548  	__u8 fields;
1549  	__u8 index;
1550  };
1551  
1552  /*
1553   * Maximum DPB size, as specified by section 'A.3.1 Level limits
1554   * common to the Baseline, Main, and Extended profiles'.
1555   */
1556  #define V4L2_H264_NUM_DPB_ENTRIES 16
1557  #define V4L2_H264_REF_LIST_LEN (2 * V4L2_H264_NUM_DPB_ENTRIES)
1558  
1559  #define V4L2_CID_STATELESS_H264_SLICE_PARAMS	(V4L2_CID_CODEC_STATELESS_BASE + 6)
1560  /**
1561   * struct v4l2_ctrl_h264_slice_params - H264 slice parameters
1562   *
1563   * This structure holds the H264 syntax elements that are specified
1564   * as non-invariant for the slices in a given frame.
1565   *
1566   * Slice invariant syntax elements are contained in struct
1567   * v4l2_ctrl_h264_decode_params. This is done to reduce the API surface
1568   * on frame-based decoders, where slice header parsing is done by the
1569   * hardware.
1570   *
1571   * Slice invariant syntax elements are specified in specification section
1572   * "7.4.3 Slice header semantics".
1573   *
1574   * Except where noted, the members on this struct match the slice header syntax.
1575   *
1576   * @header_bit_size: offset in bits to slice_data() from the beginning of this slice.
1577   * @first_mb_in_slice: see H264 specification.
1578   * @slice_type: see H264 specification.
1579   * @colour_plane_id: see H264 specification.
1580   * @redundant_pic_cnt: see H264 specification.
1581   * @cabac_init_idc: see H264 specification.
1582   * @slice_qp_delta: see H264 specification.
1583   * @slice_qs_delta: see H264 specification.
1584   * @disable_deblocking_filter_idc: see H264 specification.
1585   * @slice_alpha_c0_offset_div2: see H264 specification.
1586   * @slice_beta_offset_div2: see H264 specification.
1587   * @num_ref_idx_l0_active_minus1: see H264 specification.
1588   * @num_ref_idx_l1_active_minus1: see H264 specification.
1589   * @reserved: padding field. Should be zeroed by applications.
1590   * @ref_pic_list0: reference picture list 0 after applying the per-slice modifications.
1591   * @ref_pic_list1: reference picture list 1 after applying the per-slice modifications.
1592   * @flags: see V4L2_H264_SLICE_FLAG_{}.
1593   */
1594  struct v4l2_ctrl_h264_slice_params {
1595  	__u32 header_bit_size;
1596  	__u32 first_mb_in_slice;
1597  	__u8 slice_type;
1598  	__u8 colour_plane_id;
1599  	__u8 redundant_pic_cnt;
1600  	__u8 cabac_init_idc;
1601  	__s8 slice_qp_delta;
1602  	__s8 slice_qs_delta;
1603  	__u8 disable_deblocking_filter_idc;
1604  	__s8 slice_alpha_c0_offset_div2;
1605  	__s8 slice_beta_offset_div2;
1606  	__u8 num_ref_idx_l0_active_minus1;
1607  	__u8 num_ref_idx_l1_active_minus1;
1608  
1609  	__u8 reserved;
1610  
1611  	struct v4l2_h264_reference ref_pic_list0[V4L2_H264_REF_LIST_LEN];
1612  	struct v4l2_h264_reference ref_pic_list1[V4L2_H264_REF_LIST_LEN];
1613  
1614  	__u32 flags;
1615  };
1616  
1617  #define V4L2_H264_DPB_ENTRY_FLAG_VALID		0x01
1618  #define V4L2_H264_DPB_ENTRY_FLAG_ACTIVE		0x02
1619  #define V4L2_H264_DPB_ENTRY_FLAG_LONG_TERM	0x04
1620  #define V4L2_H264_DPB_ENTRY_FLAG_FIELD		0x08
1621  
1622  /**
1623   * struct v4l2_h264_dpb_entry - H264 decoded picture buffer entry
1624   *
1625   * @reference_ts: timestamp of the V4L2 capture buffer to use as reference.
1626   * The timestamp refers to the timestamp field in struct v4l2_buffer.
1627   * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
1628   * @pic_num: matches PicNum variable assigned during the reference
1629   * picture lists construction process.
1630   * @frame_num: frame identifier which matches frame_num syntax element.
1631   * @fields: indicates how the DPB entry is referenced. Valid values are
1632   * V4L2_H264_{}_REF.
1633   * @reserved: padding field. Should be zeroed by applications.
1634   * @top_field_order_cnt: matches TopFieldOrderCnt picture value.
1635   * @bottom_field_order_cnt: matches BottomFieldOrderCnt picture value.
1636   * Note that picture field is indicated by v4l2_buffer.field.
1637   * @flags: see V4L2_H264_DPB_ENTRY_FLAG_{}.
1638   */
1639  struct v4l2_h264_dpb_entry {
1640  	__u64 reference_ts;
1641  	__u32 pic_num;
1642  	__u16 frame_num;
1643  	__u8 fields;
1644  	__u8 reserved[5];
1645  	__s32 top_field_order_cnt;
1646  	__s32 bottom_field_order_cnt;
1647  	__u32 flags;
1648  };
1649  
1650  #define V4L2_H264_DECODE_PARAM_FLAG_IDR_PIC		0x01
1651  #define V4L2_H264_DECODE_PARAM_FLAG_FIELD_PIC		0x02
1652  #define V4L2_H264_DECODE_PARAM_FLAG_BOTTOM_FIELD	0x04
1653  #define V4L2_H264_DECODE_PARAM_FLAG_PFRAME		0x08
1654  #define V4L2_H264_DECODE_PARAM_FLAG_BFRAME		0x10
1655  
1656  #define V4L2_CID_STATELESS_H264_DECODE_PARAMS	(V4L2_CID_CODEC_STATELESS_BASE + 7)
1657  /**
1658   * struct v4l2_ctrl_h264_decode_params - H264 decoding parameters
1659   *
1660   * @dpb: decoded picture buffer.
1661   * @nal_ref_idc: slice header syntax element.
1662   * @frame_num: slice header syntax element.
1663   * @top_field_order_cnt: matches TopFieldOrderCnt picture value.
1664   * @bottom_field_order_cnt: matches BottomFieldOrderCnt picture value.
1665   * Note that picture field is indicated by v4l2_buffer.field.
1666   * @idr_pic_id: slice header syntax element.
1667   * @pic_order_cnt_lsb: slice header syntax element.
1668   * @delta_pic_order_cnt_bottom: slice header syntax element.
1669   * @delta_pic_order_cnt0: slice header syntax element.
1670   * @delta_pic_order_cnt1: slice header syntax element.
1671   * @dec_ref_pic_marking_bit_size: size in bits of dec_ref_pic_marking()
1672   * syntax element.
1673   * @pic_order_cnt_bit_size: size in bits of pic order count syntax.
1674   * @slice_group_change_cycle: slice header syntax element.
1675   * @reserved: padding field. Should be zeroed by applications.
1676   * @flags: see V4L2_H264_DECODE_PARAM_FLAG_{}.
1677   */
1678  struct v4l2_ctrl_h264_decode_params {
1679  	struct v4l2_h264_dpb_entry dpb[V4L2_H264_NUM_DPB_ENTRIES];
1680  	__u16 nal_ref_idc;
1681  	__u16 frame_num;
1682  	__s32 top_field_order_cnt;
1683  	__s32 bottom_field_order_cnt;
1684  	__u16 idr_pic_id;
1685  	__u16 pic_order_cnt_lsb;
1686  	__s32 delta_pic_order_cnt_bottom;
1687  	__s32 delta_pic_order_cnt0;
1688  	__s32 delta_pic_order_cnt1;
1689  	__u32 dec_ref_pic_marking_bit_size;
1690  	__u32 pic_order_cnt_bit_size;
1691  	__u32 slice_group_change_cycle;
1692  
1693  	__u32 reserved;
1694  	__u32 flags;
1695  };
1696  
1697  
1698  /* Stateless FWHT control, used by the vicodec driver */
1699  
1700  /* Current FWHT version */
1701  #define V4L2_FWHT_VERSION			3
1702  
1703  /* Set if this is an interlaced format */
1704  #define V4L2_FWHT_FL_IS_INTERLACED		_BITUL(0)
1705  /* Set if this is a bottom-first (NTSC) interlaced format */
1706  #define V4L2_FWHT_FL_IS_BOTTOM_FIRST		_BITUL(1)
1707  /* Set if each 'frame' contains just one field */
1708  #define V4L2_FWHT_FL_IS_ALTERNATE		_BITUL(2)
1709  /*
1710   * If V4L2_FWHT_FL_IS_ALTERNATE was set, then this is set if this
1711   * 'frame' is the bottom field, else it is the top field.
1712   */
1713  #define V4L2_FWHT_FL_IS_BOTTOM_FIELD		_BITUL(3)
1714  /* Set if the Y' plane is uncompressed */
1715  #define V4L2_FWHT_FL_LUMA_IS_UNCOMPRESSED	_BITUL(4)
1716  /* Set if the Cb plane is uncompressed */
1717  #define V4L2_FWHT_FL_CB_IS_UNCOMPRESSED		_BITUL(5)
1718  /* Set if the Cr plane is uncompressed */
1719  #define V4L2_FWHT_FL_CR_IS_UNCOMPRESSED		_BITUL(6)
1720  /* Set if the chroma plane is full height, if cleared it is half height */
1721  #define V4L2_FWHT_FL_CHROMA_FULL_HEIGHT		_BITUL(7)
1722  /* Set if the chroma plane is full width, if cleared it is half width */
1723  #define V4L2_FWHT_FL_CHROMA_FULL_WIDTH		_BITUL(8)
1724  /* Set if the alpha plane is uncompressed */
1725  #define V4L2_FWHT_FL_ALPHA_IS_UNCOMPRESSED	_BITUL(9)
1726  /* Set if this is an I Frame */
1727  #define V4L2_FWHT_FL_I_FRAME			_BITUL(10)
1728  
1729  /* A 4-values flag - the number of components - 1 */
1730  #define V4L2_FWHT_FL_COMPONENTS_NUM_MSK		GENMASK(18, 16)
1731  #define V4L2_FWHT_FL_COMPONENTS_NUM_OFFSET	16
1732  
1733  /* A 4-values flag - the pixel encoding type */
1734  #define V4L2_FWHT_FL_PIXENC_MSK			GENMASK(20, 19)
1735  #define V4L2_FWHT_FL_PIXENC_OFFSET		19
1736  #define V4L2_FWHT_FL_PIXENC_YUV			(1 << V4L2_FWHT_FL_PIXENC_OFFSET)
1737  #define V4L2_FWHT_FL_PIXENC_RGB			(2 << V4L2_FWHT_FL_PIXENC_OFFSET)
1738  #define V4L2_FWHT_FL_PIXENC_HSV			(3 << V4L2_FWHT_FL_PIXENC_OFFSET)
1739  
1740  #define V4L2_CID_STATELESS_FWHT_PARAMS		(V4L2_CID_CODEC_STATELESS_BASE + 100)
1741  /**
1742   * struct v4l2_ctrl_fwht_params - FWHT parameters
1743   *
1744   * @backward_ref_ts: timestamp of the V4L2 capture buffer to use as reference.
1745   * The timestamp refers to the timestamp field in struct v4l2_buffer.
1746   * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
1747   * @version: must be V4L2_FWHT_VERSION.
1748   * @width: width of frame.
1749   * @height: height of frame.
1750   * @flags: FWHT flags (see V4L2_FWHT_FL_*).
1751   * @colorspace: the colorspace (enum v4l2_colorspace).
1752   * @xfer_func: the transfer function (enum v4l2_xfer_func).
1753   * @ycbcr_enc: the Y'CbCr encoding (enum v4l2_ycbcr_encoding).
1754   * @quantization: the quantization (enum v4l2_quantization).
1755   */
1756  struct v4l2_ctrl_fwht_params {
1757  	__u64 backward_ref_ts;
1758  	__u32 version;
1759  	__u32 width;
1760  	__u32 height;
1761  	__u32 flags;
1762  	__u32 colorspace;
1763  	__u32 xfer_func;
1764  	__u32 ycbcr_enc;
1765  	__u32 quantization;
1766  };
1767  
1768  /* Stateless VP8 control */
1769  
1770  #define V4L2_VP8_SEGMENT_FLAG_ENABLED              0x01
1771  #define V4L2_VP8_SEGMENT_FLAG_UPDATE_MAP           0x02
1772  #define V4L2_VP8_SEGMENT_FLAG_UPDATE_FEATURE_DATA  0x04
1773  #define V4L2_VP8_SEGMENT_FLAG_DELTA_VALUE_MODE     0x08
1774  
1775  /**
1776   * struct v4l2_vp8_segment - VP8 segment-based adjustments parameters
1777   *
1778   * @quant_update: update values for the segment quantizer.
1779   * @lf_update: update values for the loop filter level.
1780   * @segment_probs: branch probabilities of the segment_id decoding tree.
1781   * @padding: padding field. Should be zeroed by applications.
1782   * @flags: see V4L2_VP8_SEGMENT_FLAG_{}.
1783   *
1784   * This structure contains segment-based adjustments related parameters.
1785   * See the 'update_segmentation()' part of the frame header syntax,
1786   * and section '9.3. Segment-Based Adjustments' of the VP8 specification
1787   * for more details.
1788   */
1789  struct v4l2_vp8_segment {
1790  	__s8 quant_update[4];
1791  	__s8 lf_update[4];
1792  	__u8 segment_probs[3];
1793  	__u8 padding;
1794  	__u32 flags;
1795  };
1796  
1797  #define V4L2_VP8_LF_ADJ_ENABLE	0x01
1798  #define V4L2_VP8_LF_DELTA_UPDATE	0x02
1799  #define V4L2_VP8_LF_FILTER_TYPE_SIMPLE	0x04
1800  
1801  /**
1802   * struct v4l2_vp8_loop_filter - VP8 loop filter parameters
1803   *
1804   * @ref_frm_delta: Reference frame signed delta values.
1805   * @mb_mode_delta: MB prediction mode signed delta values.
1806   * @sharpness_level: matches sharpness_level syntax element.
1807   * @level: matches loop_filter_level syntax element.
1808   * @padding: padding field. Should be zeroed by applications.
1809   * @flags: see V4L2_VP8_LF_{}.
1810   *
1811   * This structure contains loop filter related parameters.
1812   * See the 'mb_lf_adjustments()' part of the frame header syntax,
1813   * and section '9.4. Loop Filter Type and Levels' of the VP8 specification
1814   * for more details.
1815   */
1816  struct v4l2_vp8_loop_filter {
1817  	__s8 ref_frm_delta[4];
1818  	__s8 mb_mode_delta[4];
1819  	__u8 sharpness_level;
1820  	__u8 level;
1821  	__u16 padding;
1822  	__u32 flags;
1823  };
1824  
1825  /**
1826   * struct v4l2_vp8_quantization - VP8 quantizattion indices
1827   *
1828   * @y_ac_qi: luma AC coefficient table index.
1829   * @y_dc_delta: luma DC delta vaue.
1830   * @y2_dc_delta: y2 block DC delta value.
1831   * @y2_ac_delta: y2 block AC delta value.
1832   * @uv_dc_delta: chroma DC delta value.
1833   * @uv_ac_delta: chroma AC delta value.
1834   * @padding: padding field. Should be zeroed by applications.
1835   *
1836   * This structure contains the quantization indices present
1837   * in 'quant_indices()' part of the frame header syntax.
1838   * See section '9.6. Dequantization Indices' of the VP8 specification
1839   * for more details.
1840   */
1841  struct v4l2_vp8_quantization {
1842  	__u8 y_ac_qi;
1843  	__s8 y_dc_delta;
1844  	__s8 y2_dc_delta;
1845  	__s8 y2_ac_delta;
1846  	__s8 uv_dc_delta;
1847  	__s8 uv_ac_delta;
1848  	__u16 padding;
1849  };
1850  
1851  #define V4L2_VP8_COEFF_PROB_CNT 11
1852  #define V4L2_VP8_MV_PROB_CNT 19
1853  
1854  /**
1855   * struct v4l2_vp8_entropy - VP8 update probabilities
1856   *
1857   * @coeff_probs: coefficient probability update values.
1858   * @y_mode_probs: luma intra-prediction probabilities.
1859   * @uv_mode_probs: chroma intra-prediction probabilities.
1860   * @mv_probs: mv decoding probability.
1861   * @padding: padding field. Should be zeroed by applications.
1862   *
1863   * This structure contains the update probabilities present in
1864   * 'token_prob_update()' and 'mv_prob_update()' part of the frame header.
1865   * See section '17.2. Probability Updates' of the VP8 specification
1866   * for more details.
1867   */
1868  struct v4l2_vp8_entropy {
1869  	__u8 coeff_probs[4][8][3][V4L2_VP8_COEFF_PROB_CNT];
1870  	__u8 y_mode_probs[4];
1871  	__u8 uv_mode_probs[3];
1872  	__u8 mv_probs[2][V4L2_VP8_MV_PROB_CNT];
1873  	__u8 padding[3];
1874  };
1875  
1876  /**
1877   * struct v4l2_vp8_entropy_coder_state - VP8 boolean coder state
1878   *
1879   * @range: coder state value for "Range"
1880   * @value: coder state value for "Value"
1881   * @bit_count: number of bits left in range "Value".
1882   * @padding: padding field. Should be zeroed by applications.
1883   *
1884   * This structure contains the state for the boolean coder, as
1885   * explained in section '7. Boolean Entropy Decoder' of the VP8 specification.
1886   */
1887  struct v4l2_vp8_entropy_coder_state {
1888  	__u8 range;
1889  	__u8 value;
1890  	__u8 bit_count;
1891  	__u8 padding;
1892  };
1893  
1894  #define V4L2_VP8_FRAME_FLAG_KEY_FRAME		0x01
1895  #define V4L2_VP8_FRAME_FLAG_EXPERIMENTAL		0x02
1896  #define V4L2_VP8_FRAME_FLAG_SHOW_FRAME		0x04
1897  #define V4L2_VP8_FRAME_FLAG_MB_NO_SKIP_COEFF	0x08
1898  #define V4L2_VP8_FRAME_FLAG_SIGN_BIAS_GOLDEN	0x10
1899  #define V4L2_VP8_FRAME_FLAG_SIGN_BIAS_ALT	0x20
1900  
1901  #define V4L2_VP8_FRAME_IS_KEY_FRAME(hdr) \
1902  	(!!((hdr)->flags & V4L2_VP8_FRAME_FLAG_KEY_FRAME))
1903  
1904  #define V4L2_CID_STATELESS_VP8_FRAME (V4L2_CID_CODEC_STATELESS_BASE + 200)
1905  /**
1906   * struct v4l2_ctrl_vp8_frame - VP8 frame parameters
1907   *
1908   * @segment: segmentation parameters. See &v4l2_vp8_segment for more details
1909   * @lf: loop filter parameters. See &v4l2_vp8_loop_filter for more details
1910   * @quant: quantization parameters. See &v4l2_vp8_quantization for more details
1911   * @entropy: update probabilities. See &v4l2_vp8_entropy for more details
1912   * @coder_state: boolean coder state. See &v4l2_vp8_entropy_coder_state for more details
1913   * @width: frame width.
1914   * @height: frame height.
1915   * @horizontal_scale: horizontal scaling factor.
1916   * @vertical_scale: vertical scaling factor.
1917   * @version: bitstream version.
1918   * @prob_skip_false: frame header syntax element.
1919   * @prob_intra: frame header syntax element.
1920   * @prob_last: frame header syntax element.
1921   * @prob_gf: frame header syntax element.
1922   * @num_dct_parts: number of DCT coefficients partitions.
1923   * @first_part_size: size of the first partition, i.e. the control partition.
1924   * @first_part_header_bits: size in bits of the first partition header portion.
1925   * @dct_part_sizes: DCT coefficients sizes.
1926   * @last_frame_ts: "last" reference buffer timestamp.
1927   * The timestamp refers to the timestamp field in struct v4l2_buffer.
1928   * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
1929   * @golden_frame_ts: "golden" reference buffer timestamp.
1930   * @alt_frame_ts: "alt" reference buffer timestamp.
1931   * @flags: see V4L2_VP8_FRAME_FLAG_{}.
1932   */
1933  struct v4l2_ctrl_vp8_frame {
1934  	struct v4l2_vp8_segment segment;
1935  	struct v4l2_vp8_loop_filter lf;
1936  	struct v4l2_vp8_quantization quant;
1937  	struct v4l2_vp8_entropy entropy;
1938  	struct v4l2_vp8_entropy_coder_state coder_state;
1939  
1940  	__u16 width;
1941  	__u16 height;
1942  
1943  	__u8 horizontal_scale;
1944  	__u8 vertical_scale;
1945  
1946  	__u8 version;
1947  	__u8 prob_skip_false;
1948  	__u8 prob_intra;
1949  	__u8 prob_last;
1950  	__u8 prob_gf;
1951  	__u8 num_dct_parts;
1952  
1953  	__u32 first_part_size;
1954  	__u32 first_part_header_bits;
1955  	__u32 dct_part_sizes[8];
1956  
1957  	__u64 last_frame_ts;
1958  	__u64 golden_frame_ts;
1959  	__u64 alt_frame_ts;
1960  
1961  	__u64 flags;
1962  };
1963  
1964  /* Stateless MPEG-2 controls */
1965  
1966  #define V4L2_MPEG2_SEQ_FLAG_PROGRESSIVE	0x01
1967  
1968  #define V4L2_CID_STATELESS_MPEG2_SEQUENCE (V4L2_CID_CODEC_STATELESS_BASE+220)
1969  /**
1970   * struct v4l2_ctrl_mpeg2_sequence - MPEG-2 sequence header
1971   *
1972   * All the members on this structure match the sequence header and sequence
1973   * extension syntaxes as specified by the MPEG-2 specification.
1974   *
1975   * Fields horizontal_size, vertical_size and vbv_buffer_size are a
1976   * combination of respective _value and extension syntax elements,
1977   * as described in section 6.3.3 "Sequence header".
1978   *
1979   * @horizontal_size: combination of elements horizontal_size_value and
1980   * horizontal_size_extension.
1981   * @vertical_size: combination of elements vertical_size_value and
1982   * vertical_size_extension.
1983   * @vbv_buffer_size: combination of elements vbv_buffer_size_value and
1984   * vbv_buffer_size_extension.
1985   * @profile_and_level_indication: see MPEG-2 specification.
1986   * @chroma_format: see MPEG-2 specification.
1987   * @flags: see V4L2_MPEG2_SEQ_FLAG_{}.
1988   */
1989  struct v4l2_ctrl_mpeg2_sequence {
1990  	__u16	horizontal_size;
1991  	__u16	vertical_size;
1992  	__u32	vbv_buffer_size;
1993  	__u16	profile_and_level_indication;
1994  	__u8	chroma_format;
1995  	__u8	flags;
1996  };
1997  
1998  #define V4L2_MPEG2_PIC_CODING_TYPE_I			1
1999  #define V4L2_MPEG2_PIC_CODING_TYPE_P			2
2000  #define V4L2_MPEG2_PIC_CODING_TYPE_B			3
2001  #define V4L2_MPEG2_PIC_CODING_TYPE_D			4
2002  
2003  #define V4L2_MPEG2_PIC_TOP_FIELD			0x1
2004  #define V4L2_MPEG2_PIC_BOTTOM_FIELD			0x2
2005  #define V4L2_MPEG2_PIC_FRAME				0x3
2006  
2007  #define V4L2_MPEG2_PIC_FLAG_TOP_FIELD_FIRST		0x0001
2008  #define V4L2_MPEG2_PIC_FLAG_FRAME_PRED_DCT		0x0002
2009  #define V4L2_MPEG2_PIC_FLAG_CONCEALMENT_MV		0x0004
2010  #define V4L2_MPEG2_PIC_FLAG_Q_SCALE_TYPE		0x0008
2011  #define V4L2_MPEG2_PIC_FLAG_INTRA_VLC			0x0010
2012  #define V4L2_MPEG2_PIC_FLAG_ALT_SCAN			0x0020
2013  #define V4L2_MPEG2_PIC_FLAG_REPEAT_FIRST		0x0040
2014  #define V4L2_MPEG2_PIC_FLAG_PROGRESSIVE			0x0080
2015  
2016  #define V4L2_CID_STATELESS_MPEG2_PICTURE (V4L2_CID_CODEC_STATELESS_BASE+221)
2017  /**
2018   * struct v4l2_ctrl_mpeg2_picture - MPEG-2 picture header
2019   *
2020   * All the members on this structure match the picture header and picture
2021   * coding extension syntaxes as specified by the MPEG-2 specification.
2022   *
2023   * @backward_ref_ts: timestamp of the V4L2 capture buffer to use as
2024   * reference for backward prediction.
2025   * @forward_ref_ts: timestamp of the V4L2 capture buffer to use as
2026   * reference for forward prediction. These timestamp refers to the
2027   * timestamp field in struct v4l2_buffer. Use v4l2_timeval_to_ns()
2028   * to convert the struct timeval to a __u64.
2029   * @flags: see V4L2_MPEG2_PIC_FLAG_{}.
2030   * @f_code: see MPEG-2 specification.
2031   * @picture_coding_type: see MPEG-2 specification.
2032   * @picture_structure: see V4L2_MPEG2_PIC_{}_FIELD.
2033   * @intra_dc_precision: see MPEG-2 specification.
2034   * @reserved: padding field. Should be zeroed by applications.
2035   */
2036  struct v4l2_ctrl_mpeg2_picture {
2037  	__u64	backward_ref_ts;
2038  	__u64	forward_ref_ts;
2039  	__u32	flags;
2040  	__u8	f_code[2][2];
2041  	__u8	picture_coding_type;
2042  	__u8	picture_structure;
2043  	__u8	intra_dc_precision;
2044  	__u8	reserved[5];
2045  };
2046  
2047  #define V4L2_CID_STATELESS_MPEG2_QUANTISATION (V4L2_CID_CODEC_STATELESS_BASE+222)
2048  /**
2049   * struct v4l2_ctrl_mpeg2_quantisation - MPEG-2 quantisation
2050   *
2051   * Quantisation matrices as specified by section 6.3.7
2052   * "Quant matrix extension".
2053   *
2054   * @intra_quantiser_matrix: The quantisation matrix coefficients
2055   * for intra-coded frames, in zigzag scanning order. It is relevant
2056   * for both luma and chroma components, although it can be superseded
2057   * by the chroma-specific matrix for non-4:2:0 YUV formats.
2058   * @non_intra_quantiser_matrix: The quantisation matrix coefficients
2059   * for non-intra-coded frames, in zigzag scanning order. It is relevant
2060   * for both luma and chroma components, although it can be superseded
2061   * by the chroma-specific matrix for non-4:2:0 YUV formats.
2062   * @chroma_intra_quantiser_matrix: The quantisation matrix coefficients
2063   * for the chominance component of intra-coded frames, in zigzag scanning
2064   * order. Only relevant for 4:2:2 and 4:4:4 YUV formats.
2065   * @chroma_non_intra_quantiser_matrix: The quantisation matrix coefficients
2066   * for the chrominance component of non-intra-coded frames, in zigzag scanning
2067   * order. Only relevant for 4:2:2 and 4:4:4 YUV formats.
2068   */
2069  struct v4l2_ctrl_mpeg2_quantisation {
2070  	__u8	intra_quantiser_matrix[64];
2071  	__u8	non_intra_quantiser_matrix[64];
2072  	__u8	chroma_intra_quantiser_matrix[64];
2073  	__u8	chroma_non_intra_quantiser_matrix[64];
2074  };
2075  
2076  #define V4L2_CID_STATELESS_HEVC_SPS		(V4L2_CID_CODEC_STATELESS_BASE + 400)
2077  #define V4L2_CID_STATELESS_HEVC_PPS		(V4L2_CID_CODEC_STATELESS_BASE + 401)
2078  #define V4L2_CID_STATELESS_HEVC_SLICE_PARAMS	(V4L2_CID_CODEC_STATELESS_BASE + 402)
2079  #define V4L2_CID_STATELESS_HEVC_SCALING_MATRIX	(V4L2_CID_CODEC_STATELESS_BASE + 403)
2080  #define V4L2_CID_STATELESS_HEVC_DECODE_PARAMS	(V4L2_CID_CODEC_STATELESS_BASE + 404)
2081  #define V4L2_CID_STATELESS_HEVC_DECODE_MODE	(V4L2_CID_CODEC_STATELESS_BASE + 405)
2082  #define V4L2_CID_STATELESS_HEVC_START_CODE	(V4L2_CID_CODEC_STATELESS_BASE + 406)
2083  #define V4L2_CID_STATELESS_HEVC_ENTRY_POINT_OFFSETS (V4L2_CID_CODEC_STATELESS_BASE + 407)
2084  
2085  enum v4l2_stateless_hevc_decode_mode {
2086  	V4L2_STATELESS_HEVC_DECODE_MODE_SLICE_BASED,
2087  	V4L2_STATELESS_HEVC_DECODE_MODE_FRAME_BASED,
2088  };
2089  
2090  enum v4l2_stateless_hevc_start_code {
2091  	V4L2_STATELESS_HEVC_START_CODE_NONE,
2092  	V4L2_STATELESS_HEVC_START_CODE_ANNEX_B,
2093  };
2094  
2095  #define V4L2_HEVC_SLICE_TYPE_B	0
2096  #define V4L2_HEVC_SLICE_TYPE_P	1
2097  #define V4L2_HEVC_SLICE_TYPE_I	2
2098  
2099  #define V4L2_HEVC_SPS_FLAG_SEPARATE_COLOUR_PLANE		(1ULL << 0)
2100  #define V4L2_HEVC_SPS_FLAG_SCALING_LIST_ENABLED			(1ULL << 1)
2101  #define V4L2_HEVC_SPS_FLAG_AMP_ENABLED				(1ULL << 2)
2102  #define V4L2_HEVC_SPS_FLAG_SAMPLE_ADAPTIVE_OFFSET		(1ULL << 3)
2103  #define V4L2_HEVC_SPS_FLAG_PCM_ENABLED				(1ULL << 4)
2104  #define V4L2_HEVC_SPS_FLAG_PCM_LOOP_FILTER_DISABLED		(1ULL << 5)
2105  #define V4L2_HEVC_SPS_FLAG_LONG_TERM_REF_PICS_PRESENT		(1ULL << 6)
2106  #define V4L2_HEVC_SPS_FLAG_SPS_TEMPORAL_MVP_ENABLED		(1ULL << 7)
2107  #define V4L2_HEVC_SPS_FLAG_STRONG_INTRA_SMOOTHING_ENABLED	(1ULL << 8)
2108  
2109  /**
2110   * struct v4l2_ctrl_hevc_sps - ITU-T Rec. H.265: Sequence parameter set
2111   *
2112   * @video_parameter_set_id: specifies the value of the
2113   *			vps_video_parameter_set_id of the active VPS
2114   * @seq_parameter_set_id: provides an identifier for the SPS for
2115   *			  reference by other syntax elements
2116   * @pic_width_in_luma_samples:	specifies the width of each decoded picture
2117   *				in units of luma samples
2118   * @pic_height_in_luma_samples: specifies the height of each decoded picture
2119   *				in units of luma samples
2120   * @bit_depth_luma_minus8: this value plus 8specifies the bit depth of the
2121   *                         samples of the luma array
2122   * @bit_depth_chroma_minus8: this value plus 8 specifies the bit depth of the
2123   *                           samples of the chroma arrays
2124   * @log2_max_pic_order_cnt_lsb_minus4: this value plus 4 specifies the value of
2125   *                                     the variable MaxPicOrderCntLsb
2126   * @sps_max_dec_pic_buffering_minus1: this value plus 1 specifies the maximum
2127   *                                    required size of the decoded picture
2128   *                                    buffer for the codec video sequence
2129   * @sps_max_num_reorder_pics: indicates the maximum allowed number of pictures
2130   * @sps_max_latency_increase_plus1: not equal to 0 is used to compute the
2131   *				    value of SpsMaxLatencyPictures array
2132   * @log2_min_luma_coding_block_size_minus3: plus 3 specifies the minimum
2133   *					    luma coding block size
2134   * @log2_diff_max_min_luma_coding_block_size: specifies the difference between
2135   *					      the maximum and minimum luma
2136   *					      coding block size
2137   * @log2_min_luma_transform_block_size_minus2: plus 2 specifies the minimum luma
2138   *					       transform block size
2139   * @log2_diff_max_min_luma_transform_block_size: specifies the difference between
2140   *						 the maximum and minimum luma
2141   *						 transform block size
2142   * @max_transform_hierarchy_depth_inter: specifies the maximum hierarchy
2143   *					 depth for transform units of
2144   *					 coding units coded in inter
2145   *					 prediction mode
2146   * @max_transform_hierarchy_depth_intra: specifies the maximum hierarchy
2147   *					 depth for transform units of
2148   *					 coding units coded in intra
2149   *					 prediction mode
2150   * @pcm_sample_bit_depth_luma_minus1: this value plus 1 specifies the number of
2151   *                                    bits used to represent each of PCM sample
2152   *                                    values of the luma component
2153   * @pcm_sample_bit_depth_chroma_minus1: this value plus 1 specifies the number
2154   *                                      of bits used to represent each of PCM
2155   *                                      sample values of the chroma components
2156   * @log2_min_pcm_luma_coding_block_size_minus3: this value plus 3 specifies the
2157   *                                              minimum size of coding blocks
2158   * @log2_diff_max_min_pcm_luma_coding_block_size: specifies the difference between
2159   *						  the maximum and minimum size of
2160   *						  coding blocks
2161   * @num_short_term_ref_pic_sets: specifies the number of st_ref_pic_set()
2162   *				 syntax structures included in the SPS
2163   * @num_long_term_ref_pics_sps: specifies the number of candidate long-term
2164   *				reference pictures that are specified in the SPS
2165   * @chroma_format_idc: specifies the chroma sampling
2166   * @sps_max_sub_layers_minus1: this value plus 1 specifies the maximum number
2167   *                             of temporal sub-layers
2168   * @reserved: padding field. Should be zeroed by applications.
2169   * @flags: see V4L2_HEVC_SPS_FLAG_{}
2170   */
2171  struct v4l2_ctrl_hevc_sps {
2172  	__u8	video_parameter_set_id;
2173  	__u8	seq_parameter_set_id;
2174  	__u16	pic_width_in_luma_samples;
2175  	__u16	pic_height_in_luma_samples;
2176  	__u8	bit_depth_luma_minus8;
2177  	__u8	bit_depth_chroma_minus8;
2178  	__u8	log2_max_pic_order_cnt_lsb_minus4;
2179  	__u8	sps_max_dec_pic_buffering_minus1;
2180  	__u8	sps_max_num_reorder_pics;
2181  	__u8	sps_max_latency_increase_plus1;
2182  	__u8	log2_min_luma_coding_block_size_minus3;
2183  	__u8	log2_diff_max_min_luma_coding_block_size;
2184  	__u8	log2_min_luma_transform_block_size_minus2;
2185  	__u8	log2_diff_max_min_luma_transform_block_size;
2186  	__u8	max_transform_hierarchy_depth_inter;
2187  	__u8	max_transform_hierarchy_depth_intra;
2188  	__u8	pcm_sample_bit_depth_luma_minus1;
2189  	__u8	pcm_sample_bit_depth_chroma_minus1;
2190  	__u8	log2_min_pcm_luma_coding_block_size_minus3;
2191  	__u8	log2_diff_max_min_pcm_luma_coding_block_size;
2192  	__u8	num_short_term_ref_pic_sets;
2193  	__u8	num_long_term_ref_pics_sps;
2194  	__u8	chroma_format_idc;
2195  	__u8	sps_max_sub_layers_minus1;
2196  
2197  	__u8	reserved[6];
2198  	__u64	flags;
2199  };
2200  
2201  #define V4L2_HEVC_PPS_FLAG_DEPENDENT_SLICE_SEGMENT_ENABLED	(1ULL << 0)
2202  #define V4L2_HEVC_PPS_FLAG_OUTPUT_FLAG_PRESENT			(1ULL << 1)
2203  #define V4L2_HEVC_PPS_FLAG_SIGN_DATA_HIDING_ENABLED		(1ULL << 2)
2204  #define V4L2_HEVC_PPS_FLAG_CABAC_INIT_PRESENT			(1ULL << 3)
2205  #define V4L2_HEVC_PPS_FLAG_CONSTRAINED_INTRA_PRED		(1ULL << 4)
2206  #define V4L2_HEVC_PPS_FLAG_TRANSFORM_SKIP_ENABLED		(1ULL << 5)
2207  #define V4L2_HEVC_PPS_FLAG_CU_QP_DELTA_ENABLED			(1ULL << 6)
2208  #define V4L2_HEVC_PPS_FLAG_PPS_SLICE_CHROMA_QP_OFFSETS_PRESENT	(1ULL << 7)
2209  #define V4L2_HEVC_PPS_FLAG_WEIGHTED_PRED			(1ULL << 8)
2210  #define V4L2_HEVC_PPS_FLAG_WEIGHTED_BIPRED			(1ULL << 9)
2211  #define V4L2_HEVC_PPS_FLAG_TRANSQUANT_BYPASS_ENABLED		(1ULL << 10)
2212  #define V4L2_HEVC_PPS_FLAG_TILES_ENABLED			(1ULL << 11)
2213  #define V4L2_HEVC_PPS_FLAG_ENTROPY_CODING_SYNC_ENABLED		(1ULL << 12)
2214  #define V4L2_HEVC_PPS_FLAG_LOOP_FILTER_ACROSS_TILES_ENABLED	(1ULL << 13)
2215  #define V4L2_HEVC_PPS_FLAG_PPS_LOOP_FILTER_ACROSS_SLICES_ENABLED (1ULL << 14)
2216  #define V4L2_HEVC_PPS_FLAG_DEBLOCKING_FILTER_OVERRIDE_ENABLED	(1ULL << 15)
2217  #define V4L2_HEVC_PPS_FLAG_PPS_DISABLE_DEBLOCKING_FILTER	(1ULL << 16)
2218  #define V4L2_HEVC_PPS_FLAG_LISTS_MODIFICATION_PRESENT		(1ULL << 17)
2219  #define V4L2_HEVC_PPS_FLAG_SLICE_SEGMENT_HEADER_EXTENSION_PRESENT (1ULL << 18)
2220  #define V4L2_HEVC_PPS_FLAG_DEBLOCKING_FILTER_CONTROL_PRESENT	(1ULL << 19)
2221  #define V4L2_HEVC_PPS_FLAG_UNIFORM_SPACING			(1ULL << 20)
2222  
2223  /**
2224   * struct v4l2_ctrl_hevc_pps - ITU-T Rec. H.265: Picture parameter set
2225   *
2226   * @pic_parameter_set_id: identifies the PPS for reference by other
2227   *			  syntax elements
2228   * @num_extra_slice_header_bits: specifies the number of extra slice header
2229   *				 bits that are present in the slice header RBSP
2230   *				 for coded pictures referring to the PPS.
2231   * @num_ref_idx_l0_default_active_minus1: this value plus 1 specifies the
2232   *                                        inferred value of num_ref_idx_l0_active_minus1
2233   * @num_ref_idx_l1_default_active_minus1: this value plus 1 specifies the
2234   *                                        inferred value of num_ref_idx_l1_active_minus1
2235   * @init_qp_minus26: this value plus 26 specifies the initial value of SliceQp Y for
2236   *		     each slice referring to the PPS
2237   * @diff_cu_qp_delta_depth: specifies the difference between the luma coding
2238   *			    tree block size and the minimum luma coding block
2239   *			    size of coding units that convey cu_qp_delta_abs
2240   *			    and cu_qp_delta_sign_flag
2241   * @pps_cb_qp_offset: specify the offsets to the luma quantization parameter Cb
2242   * @pps_cr_qp_offset: specify the offsets to the luma quantization parameter Cr
2243   * @num_tile_columns_minus1: this value plus 1 specifies the number of tile columns
2244   *			     partitioning the picture
2245   * @num_tile_rows_minus1: this value plus 1 specifies the number of tile rows partitioning
2246   *			  the picture
2247   * @column_width_minus1: this value plus 1 specifies the width of the each tile column in
2248   *			 units of coding tree blocks
2249   * @row_height_minus1: this value plus 1 specifies the height of the each tile row in
2250   *		       units of coding tree blocks
2251   * @pps_beta_offset_div2: specify the default deblocking parameter offsets for
2252   *			  beta divided by 2
2253   * @pps_tc_offset_div2: specify the default deblocking parameter offsets for tC
2254   *			divided by 2
2255   * @log2_parallel_merge_level_minus2: this value plus 2 specifies the value of
2256   *                                    the variable Log2ParMrgLevel
2257   * @reserved: padding field. Should be zeroed by applications.
2258   * @flags: see V4L2_HEVC_PPS_FLAG_{}
2259   */
2260  struct v4l2_ctrl_hevc_pps {
2261  	__u8	pic_parameter_set_id;
2262  	__u8	num_extra_slice_header_bits;
2263  	__u8	num_ref_idx_l0_default_active_minus1;
2264  	__u8	num_ref_idx_l1_default_active_minus1;
2265  	__s8	init_qp_minus26;
2266  	__u8	diff_cu_qp_delta_depth;
2267  	__s8	pps_cb_qp_offset;
2268  	__s8	pps_cr_qp_offset;
2269  	__u8	num_tile_columns_minus1;
2270  	__u8	num_tile_rows_minus1;
2271  	__u8	column_width_minus1[20];
2272  	__u8	row_height_minus1[22];
2273  	__s8	pps_beta_offset_div2;
2274  	__s8	pps_tc_offset_div2;
2275  	__u8	log2_parallel_merge_level_minus2;
2276  	__u8	reserved;
2277  	__u64	flags;
2278  };
2279  
2280  #define V4L2_HEVC_DPB_ENTRY_LONG_TERM_REFERENCE	0x01
2281  
2282  #define V4L2_HEVC_SEI_PIC_STRUCT_FRAME				0
2283  #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_FIELD			1
2284  #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_FIELD			2
2285  #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_BOTTOM			3
2286  #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_TOP			4
2287  #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_BOTTOM_TOP			5
2288  #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_TOP_BOTTOM		6
2289  #define V4L2_HEVC_SEI_PIC_STRUCT_FRAME_DOUBLING			7
2290  #define V4L2_HEVC_SEI_PIC_STRUCT_FRAME_TRIPLING			8
2291  #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_PAIRED_PREVIOUS_BOTTOM	9
2292  #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_PAIRED_PREVIOUS_TOP	10
2293  #define V4L2_HEVC_SEI_PIC_STRUCT_TOP_PAIRED_NEXT_BOTTOM		11
2294  #define V4L2_HEVC_SEI_PIC_STRUCT_BOTTOM_PAIRED_NEXT_TOP		12
2295  
2296  #define V4L2_HEVC_DPB_ENTRIES_NUM_MAX		16
2297  
2298  /**
2299   * struct v4l2_hevc_dpb_entry - HEVC decoded picture buffer entry
2300   *
2301   * @timestamp: timestamp of the V4L2 capture buffer to use as reference.
2302   * @flags: long term flag for the reference frame
2303   * @field_pic: whether the reference is a field picture or a frame.
2304   * @reserved: padding field. Should be zeroed by applications.
2305   * @pic_order_cnt_val: the picture order count of the current picture.
2306   */
2307  struct v4l2_hevc_dpb_entry {
2308  	__u64	timestamp;
2309  	__u8	flags;
2310  	__u8	field_pic;
2311  	__u16	reserved;
2312  	__s32	pic_order_cnt_val;
2313  };
2314  
2315  /**
2316   * struct v4l2_hevc_pred_weight_table - HEVC weighted prediction parameters
2317   *
2318   * @delta_luma_weight_l0: the difference of the weighting factor applied
2319   *			  to the luma prediction value for list 0
2320   * @luma_offset_l0: the additive offset applied to the luma prediction value
2321   *		    for list 0
2322   * @delta_chroma_weight_l0: the difference of the weighting factor applied
2323   *			    to the chroma prediction values for list 0
2324   * @chroma_offset_l0: the difference of the additive offset applied to
2325   *		      the chroma prediction values for list 0
2326   * @delta_luma_weight_l1: the difference of the weighting factor applied
2327   *			  to the luma prediction value for list 1
2328   * @luma_offset_l1: the additive offset applied to the luma prediction value
2329   *		    for list 1
2330   * @delta_chroma_weight_l1: the difference of the weighting factor applied
2331   *			    to the chroma prediction values for list 1
2332   * @chroma_offset_l1: the difference of the additive offset applied to
2333   *		      the chroma prediction values for list 1
2334   * @luma_log2_weight_denom: the base 2 logarithm of the denominator for
2335   *			    all luma weighting factors
2336   * @delta_chroma_log2_weight_denom: the difference of the base 2 logarithm
2337   *				    of the denominator for all chroma
2338   *				    weighting factors
2339   */
2340  struct v4l2_hevc_pred_weight_table {
2341  	__s8	delta_luma_weight_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2342  	__s8	luma_offset_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2343  	__s8	delta_chroma_weight_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2];
2344  	__s8	chroma_offset_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2];
2345  
2346  	__s8	delta_luma_weight_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2347  	__s8	luma_offset_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2348  	__s8	delta_chroma_weight_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2];
2349  	__s8	chroma_offset_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX][2];
2350  
2351  	__u8	luma_log2_weight_denom;
2352  	__s8	delta_chroma_log2_weight_denom;
2353  };
2354  
2355  #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_SAO_LUMA		(1ULL << 0)
2356  #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_SAO_CHROMA		(1ULL << 1)
2357  #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_TEMPORAL_MVP_ENABLED	(1ULL << 2)
2358  #define V4L2_HEVC_SLICE_PARAMS_FLAG_MVD_L1_ZERO			(1ULL << 3)
2359  #define V4L2_HEVC_SLICE_PARAMS_FLAG_CABAC_INIT			(1ULL << 4)
2360  #define V4L2_HEVC_SLICE_PARAMS_FLAG_COLLOCATED_FROM_L0		(1ULL << 5)
2361  #define V4L2_HEVC_SLICE_PARAMS_FLAG_USE_INTEGER_MV		(1ULL << 6)
2362  #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_DEBLOCKING_FILTER_DISABLED (1ULL << 7)
2363  #define V4L2_HEVC_SLICE_PARAMS_FLAG_SLICE_LOOP_FILTER_ACROSS_SLICES_ENABLED (1ULL << 8)
2364  #define V4L2_HEVC_SLICE_PARAMS_FLAG_DEPENDENT_SLICE_SEGMENT	(1ULL << 9)
2365  
2366  /**
2367   * struct v4l2_ctrl_hevc_slice_params - HEVC slice parameters
2368   *
2369   * This control is a dynamically sized 1-dimensional array,
2370   * V4L2_CTRL_FLAG_DYNAMIC_ARRAY flag must be set when using it.
2371   *
2372   * @bit_size: size (in bits) of the current slice data
2373   * @data_byte_offset: offset (in bytes) to the video data in the current slice data
2374   * @num_entry_point_offsets: specifies the number of entry point offset syntax
2375   *			     elements in the slice header.
2376   * @nal_unit_type: specifies the coding type of the slice (B, P or I)
2377   * @nuh_temporal_id_plus1: minus 1 specifies a temporal identifier for the NAL unit
2378   * @slice_type: see V4L2_HEVC_SLICE_TYPE_{}
2379   * @colour_plane_id: specifies the colour plane associated with the current slice
2380   * @slice_pic_order_cnt: specifies the picture order count
2381   * @num_ref_idx_l0_active_minus1: this value plus 1 specifies the maximum
2382   *                                reference index for reference picture list 0
2383   *                                that may be used to decode the slice
2384   * @num_ref_idx_l1_active_minus1: this value plus 1 specifies the maximum
2385   *                                reference index for reference picture list 1
2386   *                                that may be used to decode the slice
2387   * @collocated_ref_idx: specifies the reference index of the collocated picture used
2388   *			for temporal motion vector prediction
2389   * @five_minus_max_num_merge_cand: specifies the maximum number of merging
2390   *				   motion vector prediction candidates supported in
2391   *				   the slice subtracted from 5
2392   * @slice_qp_delta: specifies the initial value of QpY to be used for the coding
2393   *		    blocks in the slice
2394   * @slice_cb_qp_offset: specifies a difference to be added to the value of pps_cb_qp_offset
2395   * @slice_cr_qp_offset: specifies a difference to be added to the value of pps_cr_qp_offset
2396   * @slice_act_y_qp_offset: screen content extension parameters
2397   * @slice_act_cb_qp_offset: screen content extension parameters
2398   * @slice_act_cr_qp_offset: screen content extension parameters
2399   * @slice_beta_offset_div2: specify the deblocking parameter offsets for beta divided by 2
2400   * @slice_tc_offset_div2: specify the deblocking parameter offsets for tC divided by 2
2401   * @pic_struct: indicates whether a picture should be displayed as a frame or as one or
2402   *		more fields
2403   * @reserved0: padding field. Should be zeroed by applications.
2404   * @slice_segment_addr: specifies the address of the first coding tree block in
2405   *			the slice segment
2406   * @ref_idx_l0: the list of L0 reference elements as indices in the DPB
2407   * @ref_idx_l1: the list of L1 reference elements as indices in the DPB
2408   * @short_term_ref_pic_set_size: specifies the size of short-term reference
2409   *				 pictures set included in the SPS
2410   * @long_term_ref_pic_set_size: specifies the size of long-term reference
2411   *				pictures set include in the SPS
2412   * @pred_weight_table: the prediction weight coefficients for inter-picture
2413   *		       prediction
2414   * @reserved1: padding field. Should be zeroed by applications.
2415   * @flags: see V4L2_HEVC_SLICE_PARAMS_FLAG_{}
2416   */
2417  struct v4l2_ctrl_hevc_slice_params {
2418  	__u32	bit_size;
2419  	__u32	data_byte_offset;
2420  	__u32	num_entry_point_offsets;
2421  
2422  	/* ISO/IEC 23008-2, ITU-T Rec. H.265: NAL unit header */
2423  	__u8	nal_unit_type;
2424  	__u8	nuh_temporal_id_plus1;
2425  
2426  	/* ISO/IEC 23008-2, ITU-T Rec. H.265: General slice segment header */
2427  	__u8	slice_type;
2428  	__u8	colour_plane_id;
2429  	__s32	slice_pic_order_cnt;
2430  	__u8	num_ref_idx_l0_active_minus1;
2431  	__u8	num_ref_idx_l1_active_minus1;
2432  	__u8	collocated_ref_idx;
2433  	__u8	five_minus_max_num_merge_cand;
2434  	__s8	slice_qp_delta;
2435  	__s8	slice_cb_qp_offset;
2436  	__s8	slice_cr_qp_offset;
2437  	__s8	slice_act_y_qp_offset;
2438  	__s8	slice_act_cb_qp_offset;
2439  	__s8	slice_act_cr_qp_offset;
2440  	__s8	slice_beta_offset_div2;
2441  	__s8	slice_tc_offset_div2;
2442  
2443  	/* ISO/IEC 23008-2, ITU-T Rec. H.265: Picture timing SEI message */
2444  	__u8	pic_struct;
2445  
2446  	__u8	reserved0[3];
2447  	/* ISO/IEC 23008-2, ITU-T Rec. H.265: General slice segment header */
2448  	__u32	slice_segment_addr;
2449  	__u8	ref_idx_l0[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2450  	__u8	ref_idx_l1[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2451  	__u16	short_term_ref_pic_set_size;
2452  	__u16	long_term_ref_pic_set_size;
2453  
2454  	/* ISO/IEC 23008-2, ITU-T Rec. H.265: Weighted prediction parameter */
2455  	struct v4l2_hevc_pred_weight_table pred_weight_table;
2456  
2457  	__u8	reserved1[2];
2458  	__u64	flags;
2459  };
2460  
2461  #define V4L2_HEVC_DECODE_PARAM_FLAG_IRAP_PIC		0x1
2462  #define V4L2_HEVC_DECODE_PARAM_FLAG_IDR_PIC		0x2
2463  #define V4L2_HEVC_DECODE_PARAM_FLAG_NO_OUTPUT_OF_PRIOR  0x4
2464  
2465  /**
2466   * struct v4l2_ctrl_hevc_decode_params - HEVC decode parameters
2467   *
2468   * @pic_order_cnt_val: picture order count
2469   * @short_term_ref_pic_set_size: specifies the size of short-term reference
2470   *				 pictures set included in the SPS of the first slice
2471   * @long_term_ref_pic_set_size: specifies the size of long-term reference
2472   *				pictures set include in the SPS of the first slice
2473   * @num_active_dpb_entries: the number of entries in dpb
2474   * @num_poc_st_curr_before: the number of reference pictures in the short-term
2475   *			    set that come before the current frame
2476   * @num_poc_st_curr_after: the number of reference pictures in the short-term
2477   *			   set that come after the current frame
2478   * @num_poc_lt_curr: the number of reference pictures in the long-term set
2479   * @poc_st_curr_before: provides the index of the short term before references
2480   *			in DPB array
2481   * @poc_st_curr_after: provides the index of the short term after references
2482   *		       in DPB array
2483   * @poc_lt_curr: provides the index of the long term references in DPB array
2484   * @num_delta_pocs_of_ref_rps_idx: same as the derived value NumDeltaPocs[RefRpsIdx],
2485   *				   can be used to parse the RPS data in slice headers
2486   *				   instead of skipping it with @short_term_ref_pic_set_size.
2487   * @reserved: padding field. Should be zeroed by applications.
2488   * @dpb: the decoded picture buffer, for meta-data about reference frames
2489   * @flags: see V4L2_HEVC_DECODE_PARAM_FLAG_{}
2490   */
2491  struct v4l2_ctrl_hevc_decode_params {
2492  	__s32	pic_order_cnt_val;
2493  	__u16	short_term_ref_pic_set_size;
2494  	__u16	long_term_ref_pic_set_size;
2495  	__u8	num_active_dpb_entries;
2496  	__u8	num_poc_st_curr_before;
2497  	__u8	num_poc_st_curr_after;
2498  	__u8	num_poc_lt_curr;
2499  	__u8	poc_st_curr_before[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2500  	__u8	poc_st_curr_after[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2501  	__u8	poc_lt_curr[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2502  	__u8	num_delta_pocs_of_ref_rps_idx;
2503  	__u8	reserved[3];
2504  	struct	v4l2_hevc_dpb_entry dpb[V4L2_HEVC_DPB_ENTRIES_NUM_MAX];
2505  	__u64	flags;
2506  };
2507  
2508  /**
2509   * struct v4l2_ctrl_hevc_scaling_matrix - HEVC scaling lists parameters
2510   *
2511   * @scaling_list_4x4: scaling list is used for the scaling process for
2512   *		      transform coefficients. The values on each scaling
2513   *		      list are expected in raster scan order
2514   * @scaling_list_8x8: scaling list is used for the scaling process for
2515   *		      transform coefficients. The values on each scaling
2516   *		      list are expected in raster scan order
2517   * @scaling_list_16x16:	scaling list is used for the scaling process for
2518   *			transform coefficients. The values on each scaling
2519   *			list are expected in raster scan order
2520   * @scaling_list_32x32:	scaling list is used for the scaling process for
2521   *			transform coefficients. The values on each scaling
2522   *			list are expected in raster scan order
2523   * @scaling_list_dc_coef_16x16:	scaling list is used for the scaling process
2524   *				for transform coefficients. The values on each
2525   *				scaling list are expected in raster scan order.
2526   * @scaling_list_dc_coef_32x32:	scaling list is used for the scaling process
2527   *				for transform coefficients. The values on each
2528   *				scaling list are expected in raster scan order.
2529   */
2530  struct v4l2_ctrl_hevc_scaling_matrix {
2531  	__u8	scaling_list_4x4[6][16];
2532  	__u8	scaling_list_8x8[6][64];
2533  	__u8	scaling_list_16x16[6][64];
2534  	__u8	scaling_list_32x32[2][64];
2535  	__u8	scaling_list_dc_coef_16x16[6];
2536  	__u8	scaling_list_dc_coef_32x32[2];
2537  };
2538  
2539  #define V4L2_CID_COLORIMETRY_CLASS_BASE	(V4L2_CTRL_CLASS_COLORIMETRY | 0x900)
2540  #define V4L2_CID_COLORIMETRY_CLASS	(V4L2_CTRL_CLASS_COLORIMETRY | 1)
2541  
2542  #define V4L2_CID_COLORIMETRY_HDR10_CLL_INFO	(V4L2_CID_COLORIMETRY_CLASS_BASE + 0)
2543  
2544  struct v4l2_ctrl_hdr10_cll_info {
2545  	__u16 max_content_light_level;
2546  	__u16 max_pic_average_light_level;
2547  };
2548  
2549  #define V4L2_CID_COLORIMETRY_HDR10_MASTERING_DISPLAY	(V4L2_CID_COLORIMETRY_CLASS_BASE + 1)
2550  
2551  #define V4L2_HDR10_MASTERING_PRIMARIES_X_LOW	5
2552  #define V4L2_HDR10_MASTERING_PRIMARIES_X_HIGH	37000
2553  #define V4L2_HDR10_MASTERING_PRIMARIES_Y_LOW	5
2554  #define V4L2_HDR10_MASTERING_PRIMARIES_Y_HIGH	42000
2555  #define V4L2_HDR10_MASTERING_WHITE_POINT_X_LOW	5
2556  #define V4L2_HDR10_MASTERING_WHITE_POINT_X_HIGH	37000
2557  #define V4L2_HDR10_MASTERING_WHITE_POINT_Y_LOW	5
2558  #define V4L2_HDR10_MASTERING_WHITE_POINT_Y_HIGH	42000
2559  #define V4L2_HDR10_MASTERING_MAX_LUMA_LOW	50000
2560  #define V4L2_HDR10_MASTERING_MAX_LUMA_HIGH	100000000
2561  #define V4L2_HDR10_MASTERING_MIN_LUMA_LOW	1
2562  #define V4L2_HDR10_MASTERING_MIN_LUMA_HIGH	50000
2563  
2564  struct v4l2_ctrl_hdr10_mastering_display {
2565  	__u16 display_primaries_x[3];
2566  	__u16 display_primaries_y[3];
2567  	__u16 white_point_x;
2568  	__u16 white_point_y;
2569  	__u32 max_display_mastering_luminance;
2570  	__u32 min_display_mastering_luminance;
2571  };
2572  
2573  /* Stateless VP9 controls */
2574  
2575  #define V4L2_VP9_LOOP_FILTER_FLAG_DELTA_ENABLED	0x1
2576  #define	V4L2_VP9_LOOP_FILTER_FLAG_DELTA_UPDATE	0x2
2577  
2578  /**
2579   * struct v4l2_vp9_loop_filter - VP9 loop filter parameters
2580   *
2581   * @ref_deltas: contains the adjustment needed for the filter level based on the
2582   * chosen reference frame. If this syntax element is not present in the bitstream,
2583   * users should pass its last value.
2584   * @mode_deltas: contains the adjustment needed for the filter level based on the
2585   * chosen mode.	If this syntax element is not present in the bitstream, users should
2586   * pass its last value.
2587   * @level: indicates the loop filter strength.
2588   * @sharpness: indicates the sharpness level.
2589   * @flags: combination of V4L2_VP9_LOOP_FILTER_FLAG_{} flags.
2590   * @reserved: padding field. Should be zeroed by applications.
2591   *
2592   * This structure contains all loop filter related parameters. See sections
2593   * '7.2.8 Loop filter semantics' of the VP9 specification for more details.
2594   */
2595  struct v4l2_vp9_loop_filter {
2596  	__s8 ref_deltas[4];
2597  	__s8 mode_deltas[2];
2598  	__u8 level;
2599  	__u8 sharpness;
2600  	__u8 flags;
2601  	__u8 reserved[7];
2602  };
2603  
2604  /**
2605   * struct v4l2_vp9_quantization - VP9 quantization parameters
2606   *
2607   * @base_q_idx: indicates the base frame qindex.
2608   * @delta_q_y_dc: indicates the Y DC quantizer relative to base_q_idx.
2609   * @delta_q_uv_dc: indicates the UV DC quantizer relative to base_q_idx.
2610   * @delta_q_uv_ac: indicates the UV AC quantizer relative to base_q_idx.
2611   * @reserved: padding field. Should be zeroed by applications.
2612   *
2613   * Encodes the quantization parameters. See section '7.2.9 Quantization params
2614   * syntax' of the VP9 specification for more details.
2615   */
2616  struct v4l2_vp9_quantization {
2617  	__u8 base_q_idx;
2618  	__s8 delta_q_y_dc;
2619  	__s8 delta_q_uv_dc;
2620  	__s8 delta_q_uv_ac;
2621  	__u8 reserved[4];
2622  };
2623  
2624  #define V4L2_VP9_SEGMENTATION_FLAG_ENABLED		0x01
2625  #define V4L2_VP9_SEGMENTATION_FLAG_UPDATE_MAP		0x02
2626  #define V4L2_VP9_SEGMENTATION_FLAG_TEMPORAL_UPDATE	0x04
2627  #define V4L2_VP9_SEGMENTATION_FLAG_UPDATE_DATA		0x08
2628  #define V4L2_VP9_SEGMENTATION_FLAG_ABS_OR_DELTA_UPDATE	0x10
2629  
2630  #define V4L2_VP9_SEG_LVL_ALT_Q				0
2631  #define V4L2_VP9_SEG_LVL_ALT_L				1
2632  #define V4L2_VP9_SEG_LVL_REF_FRAME			2
2633  #define V4L2_VP9_SEG_LVL_SKIP				3
2634  #define V4L2_VP9_SEG_LVL_MAX				4
2635  
2636  #define V4L2_VP9_SEGMENT_FEATURE_ENABLED(id)	(1 << (id))
2637  #define V4L2_VP9_SEGMENT_FEATURE_ENABLED_MASK	0xf
2638  
2639  /**
2640   * struct v4l2_vp9_segmentation - VP9 segmentation parameters
2641   *
2642   * @feature_data: data attached to each feature. Data entry is only valid if
2643   * the feature is enabled. The array shall be indexed with segment number as
2644   * the first dimension (0..7) and one of V4L2_VP9_SEG_{} as the second dimension.
2645   * @feature_enabled: bitmask defining which features are enabled in each segment.
2646   * The value for each segment is a combination of V4L2_VP9_SEGMENT_FEATURE_ENABLED(id)
2647   * values where id is one of V4L2_VP9_SEG_LVL_{}.
2648   * @tree_probs: specifies the probability values to be used when decoding a
2649   * Segment-ID. See '5.15. Segmentation map' section of the VP9 specification
2650   * for more details.
2651   * @pred_probs: specifies the probability values to be used when decoding a
2652   * Predicted-Segment-ID. See '6.4.14. Get segment id syntax' section of :ref:`vp9`
2653   * for more details.
2654   * @flags: combination of V4L2_VP9_SEGMENTATION_FLAG_{} flags.
2655   * @reserved: padding field. Should be zeroed by applications.
2656   *
2657   * Encodes the quantization parameters. See section '7.2.10 Segmentation params syntax' of
2658   * the VP9 specification for more details.
2659   */
2660  struct v4l2_vp9_segmentation {
2661  	__s16 feature_data[8][4];
2662  	__u8 feature_enabled[8];
2663  	__u8 tree_probs[7];
2664  	__u8 pred_probs[3];
2665  	__u8 flags;
2666  	__u8 reserved[5];
2667  };
2668  
2669  #define V4L2_VP9_FRAME_FLAG_KEY_FRAME			0x001
2670  #define V4L2_VP9_FRAME_FLAG_SHOW_FRAME			0x002
2671  #define V4L2_VP9_FRAME_FLAG_ERROR_RESILIENT		0x004
2672  #define V4L2_VP9_FRAME_FLAG_INTRA_ONLY			0x008
2673  #define V4L2_VP9_FRAME_FLAG_ALLOW_HIGH_PREC_MV		0x010
2674  #define V4L2_VP9_FRAME_FLAG_REFRESH_FRAME_CTX		0x020
2675  #define V4L2_VP9_FRAME_FLAG_PARALLEL_DEC_MODE		0x040
2676  #define V4L2_VP9_FRAME_FLAG_X_SUBSAMPLING		0x080
2677  #define V4L2_VP9_FRAME_FLAG_Y_SUBSAMPLING		0x100
2678  #define V4L2_VP9_FRAME_FLAG_COLOR_RANGE_FULL_SWING	0x200
2679  
2680  #define V4L2_VP9_SIGN_BIAS_LAST				0x1
2681  #define V4L2_VP9_SIGN_BIAS_GOLDEN			0x2
2682  #define V4L2_VP9_SIGN_BIAS_ALT				0x4
2683  
2684  #define V4L2_VP9_RESET_FRAME_CTX_NONE			0
2685  #define V4L2_VP9_RESET_FRAME_CTX_SPEC			1
2686  #define V4L2_VP9_RESET_FRAME_CTX_ALL			2
2687  
2688  #define V4L2_VP9_INTERP_FILTER_EIGHTTAP			0
2689  #define V4L2_VP9_INTERP_FILTER_EIGHTTAP_SMOOTH		1
2690  #define V4L2_VP9_INTERP_FILTER_EIGHTTAP_SHARP		2
2691  #define V4L2_VP9_INTERP_FILTER_BILINEAR			3
2692  #define V4L2_VP9_INTERP_FILTER_SWITCHABLE		4
2693  
2694  #define V4L2_VP9_REFERENCE_MODE_SINGLE_REFERENCE	0
2695  #define V4L2_VP9_REFERENCE_MODE_COMPOUND_REFERENCE	1
2696  #define V4L2_VP9_REFERENCE_MODE_SELECT			2
2697  
2698  #define V4L2_VP9_PROFILE_MAX				3
2699  
2700  #define V4L2_CID_STATELESS_VP9_FRAME	(V4L2_CID_CODEC_STATELESS_BASE + 300)
2701  /**
2702   * struct v4l2_ctrl_vp9_frame - VP9 frame decoding control
2703   *
2704   * @lf: loop filter parameters. See &v4l2_vp9_loop_filter for more details.
2705   * @quant: quantization parameters. See &v4l2_vp9_quantization for more details.
2706   * @seg: segmentation parameters. See &v4l2_vp9_segmentation for more details.
2707   * @flags: combination of V4L2_VP9_FRAME_FLAG_{} flags.
2708   * @compressed_header_size: compressed header size in bytes.
2709   * @uncompressed_header_size: uncompressed header size in bytes.
2710   * @frame_width_minus_1: add 1 to it and you'll get the frame width expressed in pixels.
2711   * @frame_height_minus_1: add 1 to it and you'll get the frame height expressed in pixels.
2712   * @render_width_minus_1: add 1 to it and you'll get the expected render width expressed in
2713   * pixels. This is not used during the decoding process but might be used by HW scalers
2714   * to prepare a frame that's ready for scanout.
2715   * @render_height_minus_1: add 1 to it and you'll get the expected render height expressed in
2716   * pixels. This is not used during the decoding process but might be used by HW scalers
2717   * to prepare a frame that's ready for scanout.
2718   * @last_frame_ts: "last" reference buffer timestamp.
2719   * The timestamp refers to the timestamp field in struct v4l2_buffer.
2720   * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
2721   * @golden_frame_ts: "golden" reference buffer timestamp.
2722   * The timestamp refers to the timestamp field in struct v4l2_buffer.
2723   * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
2724   * @alt_frame_ts: "alt" reference buffer timestamp.
2725   * The timestamp refers to the timestamp field in struct v4l2_buffer.
2726   * Use v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
2727   * @ref_frame_sign_bias: a bitfield specifying whether the sign bias is set for a given
2728   * reference frame. Either of V4L2_VP9_SIGN_BIAS_{}.
2729   * @reset_frame_context: specifies whether the frame context should be reset to default values.
2730   * Either of V4L2_VP9_RESET_FRAME_CTX_{}.
2731   * @frame_context_idx: frame context that should be used/updated.
2732   * @profile: VP9 profile. Can be 0, 1, 2 or 3.
2733   * @bit_depth: bits per components. Can be 8, 10 or 12. Note that not all profiles support
2734   * 10 and/or 12 bits depths.
2735   * @interpolation_filter: specifies the filter selection used for performing inter prediction.
2736   * Set to one of V4L2_VP9_INTERP_FILTER_{}.
2737   * @tile_cols_log2: specifies the base 2 logarithm of the width of each tile (where the width
2738   * is measured in units of 8x8 blocks). Shall be less than or equal to 6.
2739   * @tile_rows_log2: specifies the base 2 logarithm of the height of each tile (where the height
2740   * is measured in units of 8x8 blocks).
2741   * @reference_mode: specifies the type of inter prediction to be used.
2742   * Set to one of V4L2_VP9_REFERENCE_MODE_{}.
2743   * @reserved: padding field. Should be zeroed by applications.
2744   */
2745  struct v4l2_ctrl_vp9_frame {
2746  	struct v4l2_vp9_loop_filter lf;
2747  	struct v4l2_vp9_quantization quant;
2748  	struct v4l2_vp9_segmentation seg;
2749  	__u32 flags;
2750  	__u16 compressed_header_size;
2751  	__u16 uncompressed_header_size;
2752  	__u16 frame_width_minus_1;
2753  	__u16 frame_height_minus_1;
2754  	__u16 render_width_minus_1;
2755  	__u16 render_height_minus_1;
2756  	__u64 last_frame_ts;
2757  	__u64 golden_frame_ts;
2758  	__u64 alt_frame_ts;
2759  	__u8 ref_frame_sign_bias;
2760  	__u8 reset_frame_context;
2761  	__u8 frame_context_idx;
2762  	__u8 profile;
2763  	__u8 bit_depth;
2764  	__u8 interpolation_filter;
2765  	__u8 tile_cols_log2;
2766  	__u8 tile_rows_log2;
2767  	__u8 reference_mode;
2768  	__u8 reserved[7];
2769  };
2770  
2771  #define V4L2_VP9_NUM_FRAME_CTX	4
2772  
2773  /**
2774   * struct v4l2_vp9_mv_probs - VP9 Motion vector probability updates
2775   * @joint: motion vector joint probability updates.
2776   * @sign: motion vector sign probability updates.
2777   * @classes: motion vector class probability updates.
2778   * @class0_bit: motion vector class0 bit probability updates.
2779   * @bits: motion vector bits probability updates.
2780   * @class0_fr: motion vector class0 fractional bit probability updates.
2781   * @fr: motion vector fractional bit probability updates.
2782   * @class0_hp: motion vector class0 high precision fractional bit probability updates.
2783   * @hp: motion vector high precision fractional bit probability updates.
2784   *
2785   * This structure contains new values of motion vector probabilities.
2786   * A value of zero in an array element means there is no update of the relevant probability.
2787   * See `struct v4l2_vp9_prob_updates` for details.
2788   */
2789  struct v4l2_vp9_mv_probs {
2790  	__u8 joint[3];
2791  	__u8 sign[2];
2792  	__u8 classes[2][10];
2793  	__u8 class0_bit[2];
2794  	__u8 bits[2][10];
2795  	__u8 class0_fr[2][2][3];
2796  	__u8 fr[2][3];
2797  	__u8 class0_hp[2];
2798  	__u8 hp[2];
2799  };
2800  
2801  #define V4L2_CID_STATELESS_VP9_COMPRESSED_HDR	(V4L2_CID_CODEC_STATELESS_BASE + 301)
2802  
2803  #define V4L2_VP9_TX_MODE_ONLY_4X4			0
2804  #define V4L2_VP9_TX_MODE_ALLOW_8X8			1
2805  #define V4L2_VP9_TX_MODE_ALLOW_16X16			2
2806  #define V4L2_VP9_TX_MODE_ALLOW_32X32			3
2807  #define V4L2_VP9_TX_MODE_SELECT				4
2808  
2809  /**
2810   * struct v4l2_ctrl_vp9_compressed_hdr - VP9 probability updates control
2811   * @tx_mode: specifies the TX mode. Set to one of V4L2_VP9_TX_MODE_{}.
2812   * @tx8: TX 8x8 probability updates.
2813   * @tx16: TX 16x16 probability updates.
2814   * @tx32: TX 32x32 probability updates.
2815   * @coef: coefficient probability updates.
2816   * @skip: skip probability updates.
2817   * @inter_mode: inter mode probability updates.
2818   * @interp_filter: interpolation filter probability updates.
2819   * @is_inter: is inter-block probability updates.
2820   * @comp_mode: compound prediction mode probability updates.
2821   * @single_ref: single ref probability updates.
2822   * @comp_ref: compound ref probability updates.
2823   * @y_mode: Y prediction mode probability updates.
2824   * @uv_mode: UV prediction mode probability updates.
2825   * @partition: partition probability updates.
2826   * @mv: motion vector probability updates.
2827   *
2828   * This structure holds the probabilities update as parsed in the compressed
2829   * header (Spec 6.3). These values represent the value of probability update after
2830   * being translated with inv_map_table[] (see 6.3.5). A value of zero in an array element
2831   * means that there is no update of the relevant probability.
2832   *
2833   * This control is optional and needs to be used when dealing with the hardware which is
2834   * not capable of parsing the compressed header itself. Only drivers which need it will
2835   * implement it.
2836   */
2837  struct v4l2_ctrl_vp9_compressed_hdr {
2838  	__u8 tx_mode;
2839  	__u8 tx8[2][1];
2840  	__u8 tx16[2][2];
2841  	__u8 tx32[2][3];
2842  	__u8 coef[4][2][2][6][6][3];
2843  	__u8 skip[3];
2844  	__u8 inter_mode[7][3];
2845  	__u8 interp_filter[4][2];
2846  	__u8 is_inter[4];
2847  	__u8 comp_mode[5];
2848  	__u8 single_ref[5][2];
2849  	__u8 comp_ref[5];
2850  	__u8 y_mode[4][9];
2851  	__u8 uv_mode[10][9];
2852  	__u8 partition[16][3];
2853  
2854  	struct v4l2_vp9_mv_probs mv;
2855  };
2856  
2857  /* Stateless AV1 controls */
2858  
2859  #define V4L2_AV1_TOTAL_REFS_PER_FRAME	8
2860  #define V4L2_AV1_CDEF_MAX		8
2861  #define V4L2_AV1_NUM_PLANES_MAX		3 /* 1 if monochrome, 3 otherwise */
2862  #define V4L2_AV1_MAX_SEGMENTS		8
2863  #define V4L2_AV1_MAX_OPERATING_POINTS	(1 << 5) /* 5 bits to encode */
2864  #define V4L2_AV1_REFS_PER_FRAME		7
2865  #define V4L2_AV1_MAX_NUM_Y_POINTS	(1 << 4) /* 4 bits to encode */
2866  #define V4L2_AV1_MAX_NUM_CB_POINTS	(1 << 4) /* 4 bits to encode */
2867  #define V4L2_AV1_MAX_NUM_CR_POINTS	(1 << 4) /* 4 bits to encode */
2868  #define V4L2_AV1_AR_COEFFS_SIZE		25 /* (2 * 3 * (3 + 1)) + 1 */
2869  #define V4L2_AV1_MAX_NUM_PLANES		3
2870  #define V4L2_AV1_MAX_TILE_COLS		64
2871  #define V4L2_AV1_MAX_TILE_ROWS		64
2872  #define V4L2_AV1_MAX_TILE_COUNT		512
2873  
2874  #define V4L2_AV1_SEQUENCE_FLAG_STILL_PICTURE		  0x00000001
2875  #define V4L2_AV1_SEQUENCE_FLAG_USE_128X128_SUPERBLOCK	  0x00000002
2876  #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_FILTER_INTRA	  0x00000004
2877  #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_INTRA_EDGE_FILTER   0x00000008
2878  #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_INTERINTRA_COMPOUND 0x00000010
2879  #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_MASKED_COMPOUND	  0x00000020
2880  #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_WARPED_MOTION	  0x00000040
2881  #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_DUAL_FILTER	  0x00000080
2882  #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_ORDER_HINT	  0x00000100
2883  #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_JNT_COMP		  0x00000200
2884  #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_REF_FRAME_MVS	  0x00000400
2885  #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_SUPERRES		  0x00000800
2886  #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_CDEF		  0x00001000
2887  #define V4L2_AV1_SEQUENCE_FLAG_ENABLE_RESTORATION	  0x00002000
2888  #define V4L2_AV1_SEQUENCE_FLAG_MONO_CHROME		  0x00004000
2889  #define V4L2_AV1_SEQUENCE_FLAG_COLOR_RANGE		  0x00008000
2890  #define V4L2_AV1_SEQUENCE_FLAG_SUBSAMPLING_X		  0x00010000
2891  #define V4L2_AV1_SEQUENCE_FLAG_SUBSAMPLING_Y		  0x00020000
2892  #define V4L2_AV1_SEQUENCE_FLAG_FILM_GRAIN_PARAMS_PRESENT  0x00040000
2893  #define V4L2_AV1_SEQUENCE_FLAG_SEPARATE_UV_DELTA_Q	  0x00080000
2894  
2895  #define V4L2_CID_STATELESS_AV1_SEQUENCE (V4L2_CID_CODEC_STATELESS_BASE + 500)
2896  /**
2897   * struct v4l2_ctrl_av1_sequence - AV1 Sequence
2898   *
2899   * Represents an AV1 Sequence OBU. See section 5.5 "Sequence header OBU syntax"
2900   * for more details.
2901   *
2902   * @flags: See V4L2_AV1_SEQUENCE_FLAG_{}.
2903   * @seq_profile: specifies the features that can be used in the coded video
2904   * sequence.
2905   * @order_hint_bits: specifies the number of bits used for the order_hint field
2906   * at each frame.
2907   * @bit_depth: the bitdepth to use for the sequence as described in section
2908   * 5.5.2 "Color config syntax".
2909   * @reserved: padding field. Should be zeroed by applications.
2910   * @max_frame_width_minus_1: specifies the maximum frame width minus 1 for the
2911   * frames represented by this sequence header.
2912   * @max_frame_height_minus_1: specifies the maximum frame height minus 1 for the
2913   * frames represented by this sequence header.
2914   */
2915  struct v4l2_ctrl_av1_sequence {
2916  	__u32 flags;
2917  	__u8 seq_profile;
2918  	__u8 order_hint_bits;
2919  	__u8 bit_depth;
2920  	__u8 reserved;
2921  	__u16 max_frame_width_minus_1;
2922  	__u16 max_frame_height_minus_1;
2923  };
2924  
2925  #define V4L2_CID_STATELESS_AV1_TILE_GROUP_ENTRY (V4L2_CID_CODEC_STATELESS_BASE + 501)
2926  /**
2927   * struct v4l2_ctrl_av1_tile_group_entry - AV1 Tile Group entry
2928   *
2929   * Represents a single AV1 tile inside an AV1 Tile Group. Note that MiRowStart,
2930   * MiRowEnd, MiColStart and MiColEnd can be retrieved from struct
2931   * v4l2_av1_tile_info in struct v4l2_ctrl_av1_frame using tile_row and
2932   * tile_col. See section 6.10.1 "General tile group OBU semantics" for more
2933   * details.
2934   *
2935   * @tile_offset: offset from the OBU data, i.e. where the coded tile data
2936   * actually starts.
2937   * @tile_size: specifies the size in bytes of the coded tile. Equivalent to
2938   * "TileSize" in the AV1 Specification.
2939   * @tile_row: specifies the row of the current tile. Equivalent to "TileRow" in
2940   * the AV1 Specification.
2941   * @tile_col: specifies the col of the current tile. Equivalent to "TileCol" in
2942   * the AV1 Specification.
2943   */
2944  struct v4l2_ctrl_av1_tile_group_entry {
2945  	__u32 tile_offset;
2946  	__u32 tile_size;
2947  	__u32 tile_row;
2948  	__u32 tile_col;
2949  };
2950  
2951  /**
2952   * enum v4l2_av1_warp_model - AV1 Warp Model as described in section 3
2953   * "Symbols and abbreviated terms" of the AV1 Specification.
2954   *
2955   * @V4L2_AV1_WARP_MODEL_IDENTITY: Warp model is just an identity transform.
2956   * @V4L2_AV1_WARP_MODEL_TRANSLATION: Warp model is a pure translation.
2957   * @V4L2_AV1_WARP_MODEL_ROTZOOM: Warp model is a rotation + symmetric zoom +
2958   * translation.
2959   * @V4L2_AV1_WARP_MODEL_AFFINE: Warp model is a general affine transform.
2960   */
2961  enum v4l2_av1_warp_model {
2962  	V4L2_AV1_WARP_MODEL_IDENTITY = 0,
2963  	V4L2_AV1_WARP_MODEL_TRANSLATION = 1,
2964  	V4L2_AV1_WARP_MODEL_ROTZOOM = 2,
2965  	V4L2_AV1_WARP_MODEL_AFFINE = 3,
2966  };
2967  
2968  /**
2969   * enum v4l2_av1_reference_frame - AV1 reference frames
2970   *
2971   * @V4L2_AV1_REF_INTRA_FRAME: Intra Frame Reference
2972   * @V4L2_AV1_REF_LAST_FRAME: Last Reference Frame
2973   * @V4L2_AV1_REF_LAST2_FRAME: Last2 Reference Frame
2974   * @V4L2_AV1_REF_LAST3_FRAME: Last3 Reference Frame
2975   * @V4L2_AV1_REF_GOLDEN_FRAME: Golden Reference Frame
2976   * @V4L2_AV1_REF_BWDREF_FRAME: BWD Reference Frame
2977   * @V4L2_AV1_REF_ALTREF2_FRAME: Alternative2 Reference Frame
2978   * @V4L2_AV1_REF_ALTREF_FRAME: Alternative Reference Frame
2979   */
2980  enum v4l2_av1_reference_frame {
2981  	V4L2_AV1_REF_INTRA_FRAME = 0,
2982  	V4L2_AV1_REF_LAST_FRAME = 1,
2983  	V4L2_AV1_REF_LAST2_FRAME = 2,
2984  	V4L2_AV1_REF_LAST3_FRAME = 3,
2985  	V4L2_AV1_REF_GOLDEN_FRAME = 4,
2986  	V4L2_AV1_REF_BWDREF_FRAME = 5,
2987  	V4L2_AV1_REF_ALTREF2_FRAME = 6,
2988  	V4L2_AV1_REF_ALTREF_FRAME = 7,
2989  };
2990  
2991  #define V4L2_AV1_GLOBAL_MOTION_IS_INVALID(ref) (1 << (ref))
2992  
2993  #define V4L2_AV1_GLOBAL_MOTION_FLAG_IS_GLOBAL	   0x1
2994  #define V4L2_AV1_GLOBAL_MOTION_FLAG_IS_ROT_ZOOM	   0x2
2995  #define V4L2_AV1_GLOBAL_MOTION_FLAG_IS_TRANSLATION 0x4
2996  /**
2997   * struct v4l2_av1_global_motion - AV1 Global Motion parameters as described in
2998   * section 6.8.17 "Global motion params semantics" of the AV1 specification.
2999   *
3000   * @flags: A bitfield containing the flags per reference frame. See
3001   * V4L2_AV1_GLOBAL_MOTION_FLAG_{}
3002   * @type: The type of global motion transform used.
3003   * @params: this field has the same meaning as "gm_params" in the AV1
3004   * specification.
3005   * @invalid: bitfield indicating whether the global motion params are invalid
3006   * for a given reference frame. See section 7.11.3.6 Setup shear process and
3007   * the variable "warpValid". Use V4L2_AV1_GLOBAL_MOTION_IS_INVALID(ref) to
3008   * create a suitable mask.
3009   * @reserved: padding field. Should be zeroed by applications.
3010   */
3011  
3012  struct v4l2_av1_global_motion {
3013  	__u8 flags[V4L2_AV1_TOTAL_REFS_PER_FRAME];
3014  	enum v4l2_av1_warp_model type[V4L2_AV1_TOTAL_REFS_PER_FRAME];
3015  	__s32 params[V4L2_AV1_TOTAL_REFS_PER_FRAME][6];
3016  	__u8 invalid;
3017  	__u8 reserved[3];
3018  };
3019  
3020  /**
3021   * enum v4l2_av1_frame_restoration_type - AV1 Frame Restoration Type
3022   * @V4L2_AV1_FRAME_RESTORE_NONE: no filtering is applied.
3023   * @V4L2_AV1_FRAME_RESTORE_WIENER: Wiener filter process is invoked.
3024   * @V4L2_AV1_FRAME_RESTORE_SGRPROJ: self guided filter process is invoked.
3025   * @V4L2_AV1_FRAME_RESTORE_SWITCHABLE: restoration filter is swichtable.
3026   */
3027  enum v4l2_av1_frame_restoration_type {
3028  	V4L2_AV1_FRAME_RESTORE_NONE = 0,
3029  	V4L2_AV1_FRAME_RESTORE_WIENER = 1,
3030  	V4L2_AV1_FRAME_RESTORE_SGRPROJ = 2,
3031  	V4L2_AV1_FRAME_RESTORE_SWITCHABLE = 3,
3032  };
3033  
3034  #define V4L2_AV1_LOOP_RESTORATION_FLAG_USES_LR		0x1
3035  #define V4L2_AV1_LOOP_RESTORATION_FLAG_USES_CHROMA_LR	0x2
3036  
3037  /**
3038   * struct v4l2_av1_loop_restoration - AV1 Loop Restauration as described in
3039   * section 6.10.15 "Loop restoration params semantics" of the AV1 specification.
3040   *
3041   * @flags: See V4L2_AV1_LOOP_RESTORATION_FLAG_{}.
3042   * @lr_unit_shift: specifies if the luma restoration size should be halved.
3043   * @lr_uv_shift: specifies if the chroma size should be half the luma size.
3044   * @reserved: padding field. Should be zeroed by applications.
3045   * @frame_restoration_type: specifies the type of restoration used for each
3046   * plane. See enum v4l2_av1_frame_restoration_type.
3047   * @loop_restoration_size: specifies the size of loop restoration units in units
3048   * of samples in the current plane.
3049   */
3050  struct v4l2_av1_loop_restoration {
3051  	__u8 flags;
3052  	__u8 lr_unit_shift;
3053  	__u8 lr_uv_shift;
3054  	__u8 reserved;
3055  	enum v4l2_av1_frame_restoration_type frame_restoration_type[V4L2_AV1_NUM_PLANES_MAX];
3056  	__u32 loop_restoration_size[V4L2_AV1_MAX_NUM_PLANES];
3057  };
3058  
3059  /**
3060   * struct v4l2_av1_cdef - AV1 CDEF params semantics as described in section
3061   * 6.10.14 "CDEF params semantics" of the AV1 specification
3062   *
3063   * @damping_minus_3: controls the amount of damping in the deringing filter.
3064   * @bits: specifies the number of bits needed to specify which CDEF filter to
3065   * apply.
3066   * @y_pri_strength: specifies the strength of the primary filter.
3067   * @y_sec_strength: specifies the strength of the secondary filter.
3068   * @uv_pri_strength: specifies the strength of the primary filter.
3069   * @uv_sec_strength: specifies the strength of the secondary filter.
3070   */
3071  struct v4l2_av1_cdef {
3072  	__u8 damping_minus_3;
3073  	__u8 bits;
3074  	__u8 y_pri_strength[V4L2_AV1_CDEF_MAX];
3075  	__u8 y_sec_strength[V4L2_AV1_CDEF_MAX];
3076  	__u8 uv_pri_strength[V4L2_AV1_CDEF_MAX];
3077  	__u8 uv_sec_strength[V4L2_AV1_CDEF_MAX];
3078  };
3079  
3080  #define V4L2_AV1_SEGMENTATION_FLAG_ENABLED	   0x1
3081  #define V4L2_AV1_SEGMENTATION_FLAG_UPDATE_MAP	   0x2
3082  #define V4L2_AV1_SEGMENTATION_FLAG_TEMPORAL_UPDATE 0x4
3083  #define V4L2_AV1_SEGMENTATION_FLAG_UPDATE_DATA	   0x8
3084  #define V4L2_AV1_SEGMENTATION_FLAG_SEG_ID_PRE_SKIP 0x10
3085  
3086  /**
3087   * enum v4l2_av1_segment_feature - AV1 segment features as described in section
3088   * 3 "Symbols and abbreviated terms" of the AV1 specification.
3089   *
3090   * @V4L2_AV1_SEG_LVL_ALT_Q: Index for quantizer segment feature.
3091   * @V4L2_AV1_SEG_LVL_ALT_LF_Y_V: Index for vertical luma loop filter segment
3092   * feature.
3093   * @V4L2_AV1_SEG_LVL_REF_FRAME: Index for reference frame segment feature.
3094   * @V4L2_AV1_SEG_LVL_REF_SKIP: Index for skip segment feature.
3095   * @V4L2_AV1_SEG_LVL_REF_GLOBALMV: Index for global mv feature.
3096   * @V4L2_AV1_SEG_LVL_MAX: Number of segment features.
3097   */
3098  enum v4l2_av1_segment_feature {
3099  	V4L2_AV1_SEG_LVL_ALT_Q = 0,
3100  	V4L2_AV1_SEG_LVL_ALT_LF_Y_V = 1,
3101  	V4L2_AV1_SEG_LVL_REF_FRAME = 5,
3102  	V4L2_AV1_SEG_LVL_REF_SKIP = 6,
3103  	V4L2_AV1_SEG_LVL_REF_GLOBALMV = 7,
3104  	V4L2_AV1_SEG_LVL_MAX = 8
3105  };
3106  
3107  #define V4L2_AV1_SEGMENT_FEATURE_ENABLED(id)	(1 << (id))
3108  
3109  /**
3110   * struct v4l2_av1_segmentation - AV1 Segmentation params as defined in section
3111   * 6.8.13 "Segmentation params semantics" of the AV1 specification.
3112   *
3113   * @flags: see V4L2_AV1_SEGMENTATION_FLAG_{}.
3114   * @last_active_seg_id: indicates the highest numbered segment id that has some
3115   * enabled feature. This is used when decoding the segment id to only decode
3116   * choices corresponding to used segments.
3117   * @feature_enabled: bitmask defining which features are enabled in each
3118   * segment. Use V4L2_AV1_SEGMENT_FEATURE_ENABLED to build a suitable mask.
3119   * @feature_data: data attached to each feature. Data entry is only valid if the
3120   * feature is enabled
3121   */
3122  struct v4l2_av1_segmentation {
3123  	__u8 flags;
3124  	__u8 last_active_seg_id;
3125  	__u8 feature_enabled[V4L2_AV1_MAX_SEGMENTS];
3126  	__s16 feature_data[V4L2_AV1_MAX_SEGMENTS][V4L2_AV1_SEG_LVL_MAX];
3127  };
3128  
3129  #define V4L2_AV1_LOOP_FILTER_FLAG_DELTA_ENABLED    0x1
3130  #define V4L2_AV1_LOOP_FILTER_FLAG_DELTA_UPDATE     0x2
3131  #define V4L2_AV1_LOOP_FILTER_FLAG_DELTA_LF_PRESENT 0x4
3132  #define V4L2_AV1_LOOP_FILTER_FLAG_DELTA_LF_MULTI   0x8
3133  
3134  /**
3135   * struct v4l2_av1_loop_filter - AV1 Loop filter params as defined in section
3136   * 6.8.10 "Loop filter semantics" and 6.8.16 "Loop filter delta parameters
3137   * semantics" of the AV1 specification.
3138   *
3139   * @flags: see V4L2_AV1_LOOP_FILTER_FLAG_{}
3140   * @level: an array containing loop filter strength values. Different loop
3141   * filter strength values from the array are used depending on the image plane
3142   * being filtered, and the edge direction (vertical or horizontal) being
3143   * filtered.
3144   * @sharpness: indicates the sharpness level. The loop_filter_level and
3145   * loop_filter_sharpness together determine when a block edge is filtered, and
3146   * by how much the filtering can change the sample values. The loop filter
3147   * process is described in section 7.14 of the AV1 specification.
3148   * @ref_deltas: contains the adjustment needed for the filter level based on the
3149   * chosen reference frame. If this syntax element is not present, it maintains
3150   * its previous value.
3151   * @mode_deltas: contains the adjustment needed for the filter level based on
3152   * the chosen mode. If this syntax element is not present, it maintains its
3153   * previous value.
3154   * @delta_lf_res: specifies the left shift which should be applied to decoded
3155   * loop filter delta values.
3156   */
3157  struct v4l2_av1_loop_filter {
3158  	__u8 flags;
3159  	__u8 level[4];
3160  	__u8 sharpness;
3161  	__s8 ref_deltas[V4L2_AV1_TOTAL_REFS_PER_FRAME];
3162  	__s8 mode_deltas[2];
3163  	__u8 delta_lf_res;
3164  };
3165  
3166  #define V4L2_AV1_QUANTIZATION_FLAG_DIFF_UV_DELTA   0x1
3167  #define V4L2_AV1_QUANTIZATION_FLAG_USING_QMATRIX   0x2
3168  #define V4L2_AV1_QUANTIZATION_FLAG_DELTA_Q_PRESENT 0x4
3169  
3170  /**
3171   * struct v4l2_av1_quantization - AV1 Quantization params as defined in section
3172   * 6.8.11 "Quantization params semantics" of the AV1 specification.
3173   *
3174   * @flags: see V4L2_AV1_QUANTIZATION_FLAG_{}
3175   * @base_q_idx: indicates the base frame qindex. This is used for Y AC
3176   * coefficients and as the base value for the other quantizers.
3177   * @delta_q_y_dc: indicates the Y DC quantizer relative to base_q_idx.
3178   * @delta_q_u_dc: indicates the U DC quantizer relative to base_q_idx.
3179   * @delta_q_u_ac: indicates the U AC quantizer relative to base_q_idx.
3180   * @delta_q_v_dc: indicates the V DC quantizer relative to base_q_idx.
3181   * @delta_q_v_ac: indicates the V AC quantizer relative to base_q_idx.
3182   * @qm_y: specifies the level in the quantizer matrix that should be used for
3183   * luma plane decoding.
3184   * @qm_u: specifies the level in the quantizer matrix that should be used for
3185   * chroma U plane decoding.
3186   * @qm_v: specifies the level in the quantizer matrix that should be used for
3187   * chroma V plane decoding.
3188   * @delta_q_res: specifies the left shift which should be applied to decoded
3189   * quantizer index delta values.
3190   */
3191  struct v4l2_av1_quantization {
3192  	__u8 flags;
3193  	__u8 base_q_idx;
3194  	__s8 delta_q_y_dc;
3195  	__s8 delta_q_u_dc;
3196  	__s8 delta_q_u_ac;
3197  	__s8 delta_q_v_dc;
3198  	__s8 delta_q_v_ac;
3199  	__u8 qm_y;
3200  	__u8 qm_u;
3201  	__u8 qm_v;
3202  	__u8 delta_q_res;
3203  };
3204  
3205  #define V4L2_AV1_TILE_INFO_FLAG_UNIFORM_TILE_SPACING	0x1
3206  
3207  /**
3208   * struct v4l2_av1_tile_info - AV1 Tile info as defined in section 6.8.14 "Tile
3209   * info semantics" of the AV1 specification.
3210   *
3211   * @flags: see V4L2_AV1_TILE_INFO_FLAG_{}
3212   * @context_update_tile_id: specifies which tile to use for the CDF update.
3213   * @tile_rows: specifies the number of tiles down the frame.
3214   * @tile_cols: specifies the number of tiles across the frame.
3215   * @mi_col_starts: an array specifying the start column (in units of 4x4 luma
3216   * samples) for each tile across the image.
3217   * @mi_row_starts: an array specifying the start row (in units of 4x4 luma
3218   * samples) for each tile down the image.
3219   * @width_in_sbs_minus_1: specifies the width of a tile minus 1 in units of
3220   * superblocks.
3221   * @height_in_sbs_minus_1:  specifies the height of a tile minus 1 in units of
3222   * superblocks.
3223   * @tile_size_bytes: specifies the number of bytes needed to code each tile
3224   * size.
3225   * @reserved: padding field. Should be zeroed by applications.
3226   */
3227  struct v4l2_av1_tile_info {
3228  	__u8 flags;
3229  	__u8 context_update_tile_id;
3230  	__u8 tile_cols;
3231  	__u8 tile_rows;
3232  	__u32 mi_col_starts[V4L2_AV1_MAX_TILE_COLS + 1];
3233  	__u32 mi_row_starts[V4L2_AV1_MAX_TILE_ROWS + 1];
3234  	__u32 width_in_sbs_minus_1[V4L2_AV1_MAX_TILE_COLS];
3235  	__u32 height_in_sbs_minus_1[V4L2_AV1_MAX_TILE_ROWS];
3236  	__u8 tile_size_bytes;
3237  	__u8 reserved[3];
3238  };
3239  
3240  /**
3241   * enum v4l2_av1_frame_type - AV1 Frame Type
3242   *
3243   * @V4L2_AV1_KEY_FRAME: Key frame
3244   * @V4L2_AV1_INTER_FRAME: Inter frame
3245   * @V4L2_AV1_INTRA_ONLY_FRAME: Intra-only frame
3246   * @V4L2_AV1_SWITCH_FRAME: Switch frame
3247   */
3248  enum v4l2_av1_frame_type {
3249  	V4L2_AV1_KEY_FRAME = 0,
3250  	V4L2_AV1_INTER_FRAME = 1,
3251  	V4L2_AV1_INTRA_ONLY_FRAME = 2,
3252  	V4L2_AV1_SWITCH_FRAME = 3
3253  };
3254  
3255  /**
3256   * enum v4l2_av1_interpolation_filter - AV1 interpolation filter types
3257   *
3258   * @V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP: eight tap filter
3259   * @V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP_SMOOTH: eight tap smooth filter
3260   * @V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP_SHARP: eight tap sharp filter
3261   * @V4L2_AV1_INTERPOLATION_FILTER_BILINEAR: bilinear filter
3262   * @V4L2_AV1_INTERPOLATION_FILTER_SWITCHABLE: filter selection is signaled at
3263   * the block level
3264   *
3265   * See section 6.8.9 "Interpolation filter semantics" of the AV1 specification
3266   * for more details.
3267   */
3268  enum v4l2_av1_interpolation_filter {
3269  	V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP = 0,
3270  	V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP_SMOOTH = 1,
3271  	V4L2_AV1_INTERPOLATION_FILTER_EIGHTTAP_SHARP = 2,
3272  	V4L2_AV1_INTERPOLATION_FILTER_BILINEAR = 3,
3273  	V4L2_AV1_INTERPOLATION_FILTER_SWITCHABLE = 4,
3274  };
3275  
3276  /**
3277   * enum v4l2_av1_tx_mode - AV1 Tx mode as described in section 6.8.21 "TX mode
3278   * semantics" of the AV1 specification.
3279   * @V4L2_AV1_TX_MODE_ONLY_4X4: the inverse transform will use only 4x4
3280   * transforms
3281   * @V4L2_AV1_TX_MODE_LARGEST: the inverse transform will use the largest
3282   * transform size that fits inside the block
3283   * @V4L2_AV1_TX_MODE_SELECT: the choice of transform size is specified
3284   * explicitly for each block.
3285   */
3286  enum v4l2_av1_tx_mode {
3287  	V4L2_AV1_TX_MODE_ONLY_4X4 = 0,
3288  	V4L2_AV1_TX_MODE_LARGEST = 1,
3289  	V4L2_AV1_TX_MODE_SELECT = 2
3290  };
3291  
3292  #define V4L2_AV1_FRAME_FLAG_SHOW_FRAME			 0x00000001
3293  #define V4L2_AV1_FRAME_FLAG_SHOWABLE_FRAME		 0x00000002
3294  #define V4L2_AV1_FRAME_FLAG_ERROR_RESILIENT_MODE	 0x00000004
3295  #define V4L2_AV1_FRAME_FLAG_DISABLE_CDF_UPDATE		 0x00000008
3296  #define V4L2_AV1_FRAME_FLAG_ALLOW_SCREEN_CONTENT_TOOLS	 0x00000010
3297  #define V4L2_AV1_FRAME_FLAG_FORCE_INTEGER_MV		 0x00000020
3298  #define V4L2_AV1_FRAME_FLAG_ALLOW_INTRABC		 0x00000040
3299  #define V4L2_AV1_FRAME_FLAG_USE_SUPERRES		 0x00000080
3300  #define V4L2_AV1_FRAME_FLAG_ALLOW_HIGH_PRECISION_MV	 0x00000100
3301  #define V4L2_AV1_FRAME_FLAG_IS_MOTION_MODE_SWITCHABLE	 0x00000200
3302  #define V4L2_AV1_FRAME_FLAG_USE_REF_FRAME_MVS		 0x00000400
3303  #define V4L2_AV1_FRAME_FLAG_DISABLE_FRAME_END_UPDATE_CDF 0x00000800
3304  #define V4L2_AV1_FRAME_FLAG_ALLOW_WARPED_MOTION		 0x00001000
3305  #define V4L2_AV1_FRAME_FLAG_REFERENCE_SELECT		 0x00002000
3306  #define V4L2_AV1_FRAME_FLAG_REDUCED_TX_SET		 0x00004000
3307  #define V4L2_AV1_FRAME_FLAG_SKIP_MODE_ALLOWED		 0x00008000
3308  #define V4L2_AV1_FRAME_FLAG_SKIP_MODE_PRESENT		 0x00010000
3309  #define V4L2_AV1_FRAME_FLAG_FRAME_SIZE_OVERRIDE		 0x00020000
3310  #define V4L2_AV1_FRAME_FLAG_BUFFER_REMOVAL_TIME_PRESENT	 0x00040000
3311  #define V4L2_AV1_FRAME_FLAG_FRAME_REFS_SHORT_SIGNALING	 0x00080000
3312  
3313  #define V4L2_CID_STATELESS_AV1_FRAME (V4L2_CID_CODEC_STATELESS_BASE + 502)
3314  /**
3315   * struct v4l2_ctrl_av1_frame - Represents an AV1 Frame Header OBU.
3316   *
3317   * @tile_info: tile info
3318   * @quantization: quantization params
3319   * @segmentation: segmentation params
3320   * @superres_denom: the denominator for the upscaling ratio.
3321   * @loop_filter: loop filter params
3322   * @cdef: cdef params
3323   * @skip_mode_frame: specifies the frames to use for compound prediction when
3324   * skip_mode is equal to 1.
3325   * @primary_ref_frame: specifies which reference frame contains the CDF values
3326   * and other state that should be loaded at the start of the frame.
3327   * @loop_restoration: loop restoration params
3328   * @global_motion: global motion params
3329   * @flags: see V4L2_AV1_FRAME_FLAG_{}
3330   * @frame_type: specifies the AV1 frame type
3331   * @order_hint: specifies OrderHintBits least significant bits of the expected
3332   * output order for this frame.
3333   * @upscaled_width: the upscaled width.
3334   * @interpolation_filter: specifies the filter selection used for performing
3335   * inter prediction.
3336   * @tx_mode: specifies how the transform size is determined.
3337   * @frame_width_minus_1: add 1 to get the frame's width.
3338   * @frame_height_minus_1: add 1 to get the frame's height
3339   * @render_width_minus_1: add 1 to get the render width of the frame in luma
3340   * samples.
3341   * @render_height_minus_1: add 1 to get the render height of the frame in luma
3342   * samples.
3343   * @current_frame_id: specifies the frame id number for the current frame. Frame
3344   * id numbers are additional information that do not affect the decoding
3345   * process, but provide decoders with a way of detecting missing reference
3346   * frames so that appropriate action can be taken.
3347   * @buffer_removal_time: specifies the frame removal time in units of DecCT clock
3348   * ticks counted from the removal time of the last random access point for
3349   * operating point opNum.
3350   * @reserved: padding field. Should be zeroed by applications.
3351   * @order_hints: specifies the expected output order hint for each reference
3352   * frame. This field corresponds to the OrderHints variable from the
3353   * specification (section 5.9.2 "Uncompressed header syntax"). As such, this is
3354   * only used for non-intra frames and ignored otherwise. order_hints[0] is
3355   * always ignored.
3356   * @reference_frame_ts: the V4L2 timestamp of the reference frame slots.
3357   * @ref_frame_idx: used to index into @reference_frame_ts when decoding
3358   * inter-frames. The meaning of this array is the same as in the specification.
3359   * The timestamp refers to the timestamp field in struct v4l2_buffer. Use
3360   * v4l2_timeval_to_ns() to convert the struct timeval to a __u64.
3361   * @refresh_frame_flags: contains a bitmask that specifies which reference frame
3362   * slots will be updated with the current frame after it is decoded.
3363   */
3364  struct v4l2_ctrl_av1_frame {
3365  	struct v4l2_av1_tile_info tile_info;
3366  	struct v4l2_av1_quantization quantization;
3367  	__u8 superres_denom;
3368  	struct v4l2_av1_segmentation segmentation;
3369  	struct v4l2_av1_loop_filter loop_filter;
3370  	struct v4l2_av1_cdef cdef;
3371  	__u8 skip_mode_frame[2];
3372  	__u8 primary_ref_frame;
3373  	struct v4l2_av1_loop_restoration loop_restoration;
3374  	struct v4l2_av1_global_motion global_motion;
3375  	__u32 flags;
3376  	enum v4l2_av1_frame_type frame_type;
3377  	__u32 order_hint;
3378  	__u32 upscaled_width;
3379  	enum v4l2_av1_interpolation_filter interpolation_filter;
3380  	enum v4l2_av1_tx_mode tx_mode;
3381  	__u32 frame_width_minus_1;
3382  	__u32 frame_height_minus_1;
3383  	__u16 render_width_minus_1;
3384  	__u16 render_height_minus_1;
3385  
3386  	__u32 current_frame_id;
3387  	__u32 buffer_removal_time[V4L2_AV1_MAX_OPERATING_POINTS];
3388  	__u8 reserved[4];
3389  	__u32 order_hints[V4L2_AV1_TOTAL_REFS_PER_FRAME];
3390  	__u64 reference_frame_ts[V4L2_AV1_TOTAL_REFS_PER_FRAME];
3391  	__s8 ref_frame_idx[V4L2_AV1_REFS_PER_FRAME];
3392  	__u8 refresh_frame_flags;
3393  };
3394  
3395  #define V4L2_AV1_FILM_GRAIN_FLAG_APPLY_GRAIN 0x1
3396  #define V4L2_AV1_FILM_GRAIN_FLAG_UPDATE_GRAIN 0x2
3397  #define V4L2_AV1_FILM_GRAIN_FLAG_CHROMA_SCALING_FROM_LUMA 0x4
3398  #define V4L2_AV1_FILM_GRAIN_FLAG_OVERLAP 0x8
3399  #define V4L2_AV1_FILM_GRAIN_FLAG_CLIP_TO_RESTRICTED_RANGE 0x10
3400  
3401  #define V4L2_CID_STATELESS_AV1_FILM_GRAIN (V4L2_CID_CODEC_STATELESS_BASE + 505)
3402  /**
3403   * struct v4l2_ctrl_av1_film_grain - AV1 Film Grain parameters.
3404   *
3405   * Film grain parameters as specified by section 6.8.20 of the AV1 Specification.
3406   *
3407   * @flags: see V4L2_AV1_FILM_GRAIN_{}.
3408   * @cr_mult: represents a multiplier for the cr component used in derivation of
3409   * the input index to the cr component scaling function.
3410   * @grain_seed: specifies the starting value for the pseudo-random numbers used
3411   * during film grain synthesis.
3412   * @film_grain_params_ref_idx: indicates which reference frame contains the
3413   * film grain parameters to be used for this frame.
3414   * @num_y_points: specifies the number of points for the piece-wise linear
3415   * scaling function of the luma component.
3416   * @point_y_value: represents the x (luma value) coordinate for the i-th point
3417   * of the piecewise linear scaling function for luma component. The values are
3418   * signaled on the scale of 0..255. In case of 10 bit video, these values
3419   * correspond to luma values divided by 4. In case of 12 bit video, these values
3420   * correspond to luma values divided by 16.
3421   * @point_y_scaling:  represents the scaling (output) value for the i-th point
3422   * of the piecewise linear scaling function for luma component.
3423   * @num_cb_points: specifies the number of points for the piece-wise linear
3424   * scaling function of the cb component.
3425   * @point_cb_value: represents the x coordinate for the i-th point of the
3426   * piece-wise linear scaling function for cb component. The values are signaled
3427   * on the scale of 0..255.
3428   * @point_cb_scaling: represents the scaling (output) value for the i-th point
3429   * of the piecewise linear scaling function for cb component.
3430   * @num_cr_points: specifies represents the number of points for the piece-wise
3431   * linear scaling function of the cr component.
3432   * @point_cr_value:  represents the x coordinate for the i-th point of the
3433   * piece-wise linear scaling function for cr component. The values are signaled
3434   * on the scale of 0..255.
3435   * @point_cr_scaling:  represents the scaling (output) value for the i-th point
3436   * of the piecewise linear scaling function for cr component.
3437   * @grain_scaling_minus_8: represents the shift – 8 applied to the values of the
3438   * chroma component. The grain_scaling_minus_8 can take values of 0..3 and
3439   * determines the range and quantization step of the standard deviation of film
3440   * grain.
3441   * @ar_coeff_lag: specifies the number of auto-regressive coefficients for luma
3442   * and chroma.
3443   * @ar_coeffs_y_plus_128: specifies auto-regressive coefficients used for the Y
3444   * plane.
3445   * @ar_coeffs_cb_plus_128: specifies auto-regressive coefficients used for the U
3446   * plane.
3447   * @ar_coeffs_cr_plus_128: specifies auto-regressive coefficients used for the V
3448   * plane.
3449   * @ar_coeff_shift_minus_6: specifies the range of the auto-regressive
3450   * coefficients. Values of 0, 1, 2, and 3 correspond to the ranges for
3451   * auto-regressive coefficients of [-2, 2), [-1, 1), [-0.5, 0.5) and [-0.25,
3452   * 0.25) respectively.
3453   * @grain_scale_shift: specifies how much the Gaussian random numbers should be
3454   * scaled down during the grain synthesis process.
3455   * @cb_mult: represents a multiplier for the cb component used in derivation of
3456   * the input index to the cb component scaling function.
3457   * @cb_luma_mult: represents a multiplier for the average luma component used in
3458   * derivation of the input index to the cb component scaling function.
3459   * @cr_luma_mult: represents a multiplier for the average luma component used in
3460   * derivation of the input index to the cr component scaling function.
3461   * @cb_offset: represents an offset used in derivation of the input index to the
3462   * cb component scaling function.
3463   * @cr_offset: represents an offset used in derivation of the input index to the
3464   * cr component scaling function.
3465   * @reserved: padding field. Should be zeroed by applications.
3466   */
3467  struct v4l2_ctrl_av1_film_grain {
3468  	__u8 flags;
3469  	__u8 cr_mult;
3470  	__u16 grain_seed;
3471  	__u8 film_grain_params_ref_idx;
3472  	__u8 num_y_points;
3473  	__u8 point_y_value[V4L2_AV1_MAX_NUM_Y_POINTS];
3474  	__u8 point_y_scaling[V4L2_AV1_MAX_NUM_Y_POINTS];
3475  	__u8 num_cb_points;
3476  	__u8 point_cb_value[V4L2_AV1_MAX_NUM_CB_POINTS];
3477  	__u8 point_cb_scaling[V4L2_AV1_MAX_NUM_CB_POINTS];
3478  	__u8 num_cr_points;
3479  	__u8 point_cr_value[V4L2_AV1_MAX_NUM_CR_POINTS];
3480  	__u8 point_cr_scaling[V4L2_AV1_MAX_NUM_CR_POINTS];
3481  	__u8 grain_scaling_minus_8;
3482  	__u8 ar_coeff_lag;
3483  	__u8 ar_coeffs_y_plus_128[V4L2_AV1_AR_COEFFS_SIZE];
3484  	__u8 ar_coeffs_cb_plus_128[V4L2_AV1_AR_COEFFS_SIZE];
3485  	__u8 ar_coeffs_cr_plus_128[V4L2_AV1_AR_COEFFS_SIZE];
3486  	__u8 ar_coeff_shift_minus_6;
3487  	__u8 grain_scale_shift;
3488  	__u8 cb_mult;
3489  	__u8 cb_luma_mult;
3490  	__u8 cr_luma_mult;
3491  	__u16 cb_offset;
3492  	__u16 cr_offset;
3493  	__u8 reserved[4];
3494  };
3495  
3496  /* MPEG-compression definitions kept for backwards compatibility */
3497  #ifndef __KERNEL__
3498  #define V4L2_CTRL_CLASS_MPEG            V4L2_CTRL_CLASS_CODEC
3499  #define V4L2_CID_MPEG_CLASS             V4L2_CID_CODEC_CLASS
3500  #define V4L2_CID_MPEG_BASE              V4L2_CID_CODEC_BASE
3501  #define V4L2_CID_MPEG_CX2341X_BASE      V4L2_CID_CODEC_CX2341X_BASE
3502  #define V4L2_CID_MPEG_MFC51_BASE        V4L2_CID_CODEC_MFC51_BASE
3503  #endif
3504  
3505  #endif
3506