Debian Codegraph @

sys/v4l2/ext/v4l2-controls.h

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