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