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