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