Where Online Learning is simpler!

The C and C++ Include Header Files

cat -n /usr/include/linux/v4l2-controls.h

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