v4l2_vidc_extensions.h 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263
  1. /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
  2. /*
  3. * Copyright (c) 2020-2021, The Linux Foundation. All rights reserved.
  4. * Copyright (c) 2023 Qualcomm Innovation Center, Inc. All rights reserved.
  5. */
  6. #ifndef __V4l2_VIDC_EXTENSIONS_H__
  7. #define __V4l2_VIDC_EXTENSIONS_H__
  8. #include <linux/types.h>
  9. #include <linux/v4l2-controls.h>
  10. /* 32 RGBA-8-8-8-8 compressed */
  11. #define V4L2_PIX_FMT_VIDC_ARGB32C v4l2_fourcc('Q', '2', '4', 'C')
  12. #define V4L2_META_FMT_VIDC v4l2_fourcc('Q', 'M', 'E', 'T')
  13. /* AV1 */
  14. #define V4L2_PIX_FMT_AV1 v4l2_fourcc('A', 'V', '1', '0')
  15. #ifndef V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN_10_STILL_PICTURE
  16. #define V4L2_MPEG_VIDEO_HEVC_PROFILE_MAIN_10_STILL_PICTURE (3)
  17. #endif
  18. /* vendor controls start */
  19. #ifdef V4L2_CTRL_CLASS_CODEC
  20. #define V4L2_CID_MPEG_VIDC_BASE (V4L2_CTRL_CLASS_CODEC | 0x2000)
  21. #else
  22. #define V4L2_CID_MPEG_VIDC_BASE (V4L2_CTRL_CLASS_MPEG | 0x2000)
  23. #endif
  24. #define V4L2_MPEG_MSM_VIDC_DISABLE 0
  25. #define V4L2_MPEG_MSM_VIDC_ENABLE 1
  26. #define V4L2_CID_MPEG_VIDC_SECURE (V4L2_CID_MPEG_VIDC_BASE + 0x1)
  27. #define V4L2_CID_MPEG_VIDC_LOWLATENCY_REQUEST (V4L2_CID_MPEG_VIDC_BASE + 0x3)
  28. /* FIXme: */
  29. #define V4L2_CID_MPEG_VIDC_CODEC_CONFIG (V4L2_CID_MPEG_VIDC_BASE + 0x4)
  30. #define V4L2_CID_MPEG_VIDC_FRAME_RATE (V4L2_CID_MPEG_VIDC_BASE + 0x5)
  31. #define V4L2_CID_MPEG_VIDC_OPERATING_RATE (V4L2_CID_MPEG_VIDC_BASE + 0x6)
  32. #define V4L2_CID_MPEG_VIDC_TIME_DELTA_BASED_RC (V4L2_CID_MPEG_VIDC_BASE + 0xD)
  33. /* Encoder quality controls */
  34. #define V4L2_CID_MPEG_VIDC_CONTENT_ADAPTIVE_CODING \
  35. (V4L2_CID_MPEG_VIDC_BASE + 0xE)
  36. #define V4L2_CID_MPEG_VIDC_QUALITY_BITRATE_BOOST \
  37. (V4L2_CID_MPEG_VIDC_BASE + 0xF)
  38. #define V4L2_CID_MPEG_VIDC_VIDEO_BLUR_TYPES \
  39. (V4L2_CID_MPEG_VIDC_BASE + 0x10)
  40. enum v4l2_mpeg_vidc_blur_types {
  41. VIDC_BLUR_NONE = 0x0,
  42. VIDC_BLUR_EXTERNAL = 0x1,
  43. VIDC_BLUR_ADAPTIVE = 0x2,
  44. };
  45. /* (blur width) << 16 | (blur height) */
  46. #define V4L2_CID_MPEG_VIDC_VIDEO_BLUR_RESOLUTION \
  47. (V4L2_CID_MPEG_VIDC_BASE + 0x11)
  48. /* TODO: jdas: compound control for matrix */
  49. #define V4L2_CID_MPEG_VIDC_VIDEO_VPE_CSC_CUSTOM_MATRIX \
  50. (V4L2_CID_MPEG_VIDC_BASE + 0x12)
  51. #define V4L2_CID_MPEG_VIDC_METADATA_LTR_MARK_USE_DETAILS \
  52. (V4L2_CID_MPEG_VIDC_BASE + 0x13)
  53. #define V4L2_CID_MPEG_VIDC_METADATA_SEQ_HEADER_NAL \
  54. (V4L2_CID_MPEG_VIDC_BASE + 0x14)
  55. #define V4L2_CID_MPEG_VIDC_METADATA_DPB_LUMA_CHROMA_MISR \
  56. (V4L2_CID_MPEG_VIDC_BASE + 0x15)
  57. #define V4L2_CID_MPEG_VIDC_METADATA_OPB_LUMA_CHROMA_MISR \
  58. (V4L2_CID_MPEG_VIDC_BASE + 0x16)
  59. #define V4L2_CID_MPEG_VIDC_METADATA_INTERLACE \
  60. (V4L2_CID_MPEG_VIDC_BASE + 0x17)
  61. #define V4L2_CID_MPEG_VIDC_METADATA_CONCEALED_MB_COUNT \
  62. (V4L2_CID_MPEG_VIDC_BASE + 0x18)
  63. #define V4L2_CID_MPEG_VIDC_METADATA_HISTOGRAM_INFO \
  64. (V4L2_CID_MPEG_VIDC_BASE + 0x19)
  65. #define V4L2_CID_MPEG_VIDC_METADATA_SEI_MASTERING_DISPLAY_COLOUR \
  66. (V4L2_CID_MPEG_VIDC_BASE + 0x1A)
  67. #define V4L2_CID_MPEG_VIDC_METADATA_SEI_CONTENT_LIGHT_LEVEL \
  68. (V4L2_CID_MPEG_VIDC_BASE + 0x1B)
  69. #define V4L2_CID_MPEG_VIDC_METADATA_HDR10PLUS \
  70. (V4L2_CID_MPEG_VIDC_BASE + 0x1C)
  71. #define V4L2_CID_MPEG_VIDC_METADATA_EVA_STATS \
  72. (V4L2_CID_MPEG_VIDC_BASE + 0x1D)
  73. #define V4L2_CID_MPEG_VIDC_METADATA_BUFFER_TAG \
  74. (V4L2_CID_MPEG_VIDC_BASE + 0x1E)
  75. #define V4L2_CID_MPEG_VIDC_METADATA_SUBFRAME_OUTPUT \
  76. (V4L2_CID_MPEG_VIDC_BASE + 0x1F)
  77. #define V4L2_CID_MPEG_VIDC_METADATA_ROI_INFO \
  78. (V4L2_CID_MPEG_VIDC_BASE + 0x20)
  79. #define V4L2_CID_MPEG_VIDC_METADATA_TIMESTAMP \
  80. (V4L2_CID_MPEG_VIDC_BASE + 0x21)
  81. #define V4L2_CID_MPEG_VIDC_METADATA_ENC_QP_METADATA \
  82. (V4L2_CID_MPEG_VIDC_BASE + 0x22)
  83. #define V4L2_CID_MPEG_VIDC_MIN_BITSTREAM_SIZE_OVERWRITE \
  84. (V4L2_CID_MPEG_VIDC_BASE + 0x23)
  85. #define V4L2_CID_MPEG_VIDC_METADATA_BITSTREAM_RESOLUTION \
  86. (V4L2_CID_MPEG_VIDC_BASE + 0x24)
  87. #define V4L2_CID_MPEG_VIDC_METADATA_CROP_OFFSETS \
  88. (V4L2_CID_MPEG_VIDC_BASE + 0x25)
  89. #define V4L2_CID_MPEG_VIDC_METADATA_SALIENCY_INFO \
  90. (V4L2_CID_MPEG_VIDC_BASE + 0x26)
  91. #define V4L2_CID_MPEG_VIDC_METADATA_TRANSCODE_STAT_INFO \
  92. (V4L2_CID_MPEG_VIDC_BASE + 0x27)
  93. /* Encoder Super frame control */
  94. #define V4L2_CID_MPEG_VIDC_SUPERFRAME (V4L2_CID_MPEG_VIDC_BASE + 0x28)
  95. /* Thumbnail Mode control */
  96. #define V4L2_CID_MPEG_VIDC_THUMBNAIL_MODE (V4L2_CID_MPEG_VIDC_BASE + 0x29)
  97. /* Priority control */
  98. #define V4L2_CID_MPEG_VIDC_PRIORITY (V4L2_CID_MPEG_VIDC_BASE + 0x2A)
  99. /* Metadata DPB Tag List*/
  100. #define V4L2_CID_MPEG_VIDC_METADATA_DPB_TAG_LIST \
  101. (V4L2_CID_MPEG_VIDC_BASE + 0x2B)
  102. /* Encoder Input Compression Ratio control */
  103. #define V4L2_CID_MPEG_VIDC_ENC_INPUT_COMPRESSION_RATIO \
  104. (V4L2_CID_MPEG_VIDC_BASE + 0x2C)
  105. #define V4L2_CID_MPEG_VIDC_METADATA_DEC_QP_METADATA \
  106. (V4L2_CID_MPEG_VIDC_BASE + 0x2E)
  107. /* Encoder Complexity control */
  108. #define V4L2_CID_MPEG_VIDC_VENC_COMPLEXITY \
  109. (V4L2_CID_MPEG_VIDC_BASE + 0x2F)
  110. /* Decoder Max Number of Reorder Frames */
  111. #define V4L2_CID_MPEG_VIDC_METADATA_MAX_NUM_REORDER_FRAMES \
  112. (V4L2_CID_MPEG_VIDC_BASE + 0x30)
  113. /* Control IDs for AV1 */
  114. #define V4L2_CID_MPEG_VIDEO_AV1_PROFILE (V4L2_CID_MPEG_VIDC_BASE + 0x31)
  115. enum v4l2_mpeg_video_av1_profile {
  116. V4L2_MPEG_VIDEO_AV1_PROFILE_MAIN = 0,
  117. V4L2_MPEG_VIDEO_AV1_PROFILE_HIGH = 1,
  118. V4L2_MPEG_VIDEO_AV1_PROFILE_PROFESSIONAL = 2,
  119. };
  120. #define V4L2_CID_MPEG_VIDEO_AV1_LEVEL (V4L2_CID_MPEG_VIDC_BASE + 0x32)
  121. enum v4l2_mpeg_video_av1_level {
  122. V4L2_MPEG_VIDEO_AV1_LEVEL_2_0 = 0,
  123. V4L2_MPEG_VIDEO_AV1_LEVEL_2_1 = 1,
  124. V4L2_MPEG_VIDEO_AV1_LEVEL_2_2 = 2,
  125. V4L2_MPEG_VIDEO_AV1_LEVEL_2_3 = 3,
  126. V4L2_MPEG_VIDEO_AV1_LEVEL_3_0 = 4,
  127. V4L2_MPEG_VIDEO_AV1_LEVEL_3_1 = 5,
  128. V4L2_MPEG_VIDEO_AV1_LEVEL_3_2 = 6,
  129. V4L2_MPEG_VIDEO_AV1_LEVEL_3_3 = 7,
  130. V4L2_MPEG_VIDEO_AV1_LEVEL_4_0 = 8,
  131. V4L2_MPEG_VIDEO_AV1_LEVEL_4_1 = 9,
  132. V4L2_MPEG_VIDEO_AV1_LEVEL_4_2 = 10,
  133. V4L2_MPEG_VIDEO_AV1_LEVEL_4_3 = 11,
  134. V4L2_MPEG_VIDEO_AV1_LEVEL_5_0 = 12,
  135. V4L2_MPEG_VIDEO_AV1_LEVEL_5_1 = 13,
  136. V4L2_MPEG_VIDEO_AV1_LEVEL_5_2 = 14,
  137. V4L2_MPEG_VIDEO_AV1_LEVEL_5_3 = 15,
  138. V4L2_MPEG_VIDEO_AV1_LEVEL_6_0 = 16,
  139. V4L2_MPEG_VIDEO_AV1_LEVEL_6_1 = 17,
  140. V4L2_MPEG_VIDEO_AV1_LEVEL_6_2 = 18,
  141. V4L2_MPEG_VIDEO_AV1_LEVEL_6_3 = 19,
  142. V4L2_MPEG_VIDEO_AV1_LEVEL_7_0 = 20,
  143. V4L2_MPEG_VIDEO_AV1_LEVEL_7_1 = 21,
  144. V4L2_MPEG_VIDEO_AV1_LEVEL_7_2 = 22,
  145. V4L2_MPEG_VIDEO_AV1_LEVEL_7_3 = 23,
  146. };
  147. #define V4L2_CID_MPEG_VIDEO_AV1_TIER (V4L2_CID_MPEG_VIDC_BASE + 0x33)
  148. enum v4l2_mpeg_video_av1_tier {
  149. V4L2_MPEG_VIDEO_AV1_TIER_MAIN = 0,
  150. V4L2_MPEG_VIDEO_AV1_TIER_HIGH = 1,
  151. };
  152. /* Decoder Timestamp Reorder control */
  153. #define V4L2_CID_MPEG_VIDC_TS_REORDER (V4L2_CID_MPEG_VIDC_BASE + 0x34)
  154. /* AV1 Decoder Film Grain */
  155. #define V4L2_CID_MPEG_VIDC_AV1D_FILM_GRAIN_PRESENT \
  156. (V4L2_CID_MPEG_VIDC_BASE + 0x35)
  157. /* Enables Output buffer fence id via input metadata */
  158. #define V4L2_CID_MPEG_VIDC_METADATA_OUTBUF_FENCE \
  159. (V4L2_CID_MPEG_VIDC_BASE + 0x38)
  160. /* Control to set fence id to driver in order get corresponding fence fd */
  161. #define V4L2_CID_MPEG_VIDC_SW_FENCE_ID \
  162. (V4L2_CID_MPEG_VIDC_BASE + 0x39)
  163. /*
  164. * Control to get fence fd from driver for the fence id
  165. * set via V4L2_CID_MPEG_VIDC_SW_FENCE_ID
  166. */
  167. #define V4L2_CID_MPEG_VIDC_SW_FENCE_FD \
  168. (V4L2_CID_MPEG_VIDC_BASE + 0x3A)
  169. #define V4L2_CID_MPEG_VIDC_METADATA_PICTURE_TYPE \
  170. (V4L2_CID_MPEG_VIDC_BASE + 0x3B)
  171. /* Encoder Slice Delivery Mode
  172. * set format has a dependency on this control
  173. * and gets invoked when this control is updated.
  174. */
  175. #define V4L2_CID_MPEG_VIDC_HEVC_ENCODE_DELIVERY_MODE \
  176. (V4L2_CID_MPEG_VIDC_BASE + 0x3C)
  177. #define V4L2_CID_MPEG_VIDC_H264_ENCODE_DELIVERY_MODE \
  178. (V4L2_CID_MPEG_VIDC_BASE + 0x3D)
  179. #define V4L2_CID_MPEG_VIDC_CRITICAL_PRIORITY \
  180. (V4L2_CID_MPEG_VIDC_BASE + 0x3E)
  181. #define V4L2_CID_MPEG_VIDC_RESERVE_DURATION \
  182. (V4L2_CID_MPEG_VIDC_BASE + 0x3F)
  183. #define V4L2_CID_MPEG_VIDC_METADATA_DOLBY_RPU \
  184. (V4L2_CID_MPEG_VIDC_BASE + 0x40)
  185. #define V4L2_CID_MPEG_VIDC_CLIENT_ID \
  186. (V4L2_CID_MPEG_VIDC_BASE + 0x41)
  187. #define V4L2_CID_MPEG_VIDC_LAST_FLAG_EVENT_ENABLE \
  188. (V4L2_CID_MPEG_VIDC_BASE + 0x42)
  189. #define V4L2_CID_MPEG_VIDC_VUI_TIMING_INFO \
  190. (V4L2_CID_MPEG_VIDC_BASE + 0x43)
  191. #define V4L2_CID_MPEG_VIDC_EARLY_NOTIFY_ENABLE \
  192. (V4L2_CID_MPEG_VIDC_BASE + 0x44)
  193. #define V4L2_CID_MPEG_VIDC_EARLY_NOTIFY_LINE_COUNT \
  194. (V4L2_CID_MPEG_VIDC_BASE + 0x45)
  195. /*
  196. * This control is introduced to overcome v4l2 limitation
  197. * of allowing only standard colorspace info via s_fmt.
  198. * v4l_sanitize_colorspace() is introduced in s_fmt ioctl
  199. * to reject private colorspace. Through this control, client
  200. * can set private colorspace info and/or use this control
  201. * to set colorspace dynamically.
  202. * The control value is 32 bits packed as:
  203. * [ 0 - 7] : matrix coefficients
  204. * [ 8 - 15] : transfer characteristics
  205. * [16 - 23] : colour primaries
  206. * [24 - 31] : range
  207. * This control is only for encoder.
  208. * Currently g_fmt in v4l2 does not santize colorspace,
  209. * hence this control is not introduced for decoder.
  210. */
  211. #define V4L2_CID_MPEG_VIDC_SIGNAL_COLOR_INFO \
  212. (V4L2_CID_MPEG_VIDC_BASE + 0x46)
  213. /* control to enable csc */
  214. #define V4L2_CID_MPEG_VIDC_CSC \
  215. (V4L2_CID_MPEG_VIDC_BASE + 0x47)
  216. #define V4L2_CID_MPEG_VIDC_DRIVER_VERSION \
  217. (V4L2_CID_MPEG_VIDC_BASE + 0x48)
  218. /* vendor controls end */
  219. /* vendor events start */
  220. /*
  221. * Vendor event structure looks like below (reference videodev2.h)
  222. * struct v4l2_event {
  223. * __u32 type;
  224. * union {
  225. * struct v4l2_event_src_change src_change;
  226. * ...
  227. * / ********** vendor event structure ******** /
  228. * __u8 data[64];
  229. * } u;
  230. * __u32 pending;
  231. * ...
  232. * }
  233. */
  234. /* vendor events end */
  235. #endif