xref: /aosp_15_r20/external/mesa3d/src/amd/common/ac_vcn_enc.h (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1 /**************************************************************************
2  *
3  * Copyright 2017 Advanced Micro Devices, Inc.
4  * All Rights Reserved.
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a
7  * copy of this software and associated documentation files (the
8  * "Software"), to deal in the Software without restriction, including
9  * without limitation the rights to use, copy, modify, merge, publish,
10  * distribute, sub license, and/or sell copies of the Software, and to
11  * permit persons to whom the Software is furnished to do so, subject to
12  * the following conditions:
13  *
14  * The above copyright notice and this permission notice (including the
15  * next paragraph) shall be included in all copies or substantial portions
16  * of the Software.
17  *
18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
21  * IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR
22  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25  *
26  **************************************************************************/
27 
28 #ifndef AC_VCN_ENC_H
29 #define AC_VCN_ENC_H
30 
31 #define RENCODE_IB_OP_INITIALIZE                                                    0x01000001
32 #define RENCODE_IB_OP_CLOSE_SESSION                                                 0x01000002
33 #define RENCODE_IB_OP_ENCODE                                                        0x01000003
34 #define RENCODE_IB_OP_INIT_RC                                                       0x01000004
35 #define RENCODE_IB_OP_INIT_RC_VBV_BUFFER_LEVEL                                      0x01000005
36 #define RENCODE_IB_OP_SET_SPEED_ENCODING_MODE                                       0x01000006
37 #define RENCODE_IB_OP_SET_BALANCE_ENCODING_MODE                                     0x01000007
38 #define RENCODE_IB_OP_SET_QUALITY_ENCODING_MODE                                     0x01000008
39 #define RENCODE_IB_OP_SET_HIGH_QUALITY_ENCODING_MODE                                0x01000009
40 
41 #define RENCODE_IF_MAJOR_VERSION_MASK                                               0xFFFF0000
42 #define RENCODE_IF_MAJOR_VERSION_SHIFT                                              16
43 #define RENCODE_IF_MINOR_VERSION_MASK                                               0x0000FFFF
44 #define RENCODE_IF_MINOR_VERSION_SHIFT                                              0
45 
46 #define RENCODE_ENGINE_TYPE_ENCODE                                                  1
47 
48 #define RENCODE_ENCODE_STANDARD_HEVC                                                0
49 #define RENCODE_ENCODE_STANDARD_H264                                                1
50 #define RENCODE_ENCODE_STANDARD_AV1                                                 2
51 
52 #define RENCODE_PREENCODE_MODE_NONE                                                 0x00000000
53 #define RENCODE_PREENCODE_MODE_1X                                                   0x00000001
54 #define RENCODE_PREENCODE_MODE_2X                                                   0x00000002
55 #define RENCODE_PREENCODE_MODE_4X                                                   0x00000004
56 
57 #define RENCODE_VBAQ_NONE                                                           0x00000000
58 #define RENCODE_VBAQ_AUTO                                                           0x00000001
59 
60 #define RENCODE_PRESET_MODE_SPEED                                                   0x00000000
61 #define RENCODE_PRESET_MODE_BALANCE                                                 0x00000001
62 #define RENCODE_PRESET_MODE_QUALITY                                                 0x00000002
63 #define RENCODE_PRESET_MODE_HIGH_QUALITY                                            0x00000003
64 
65 #define RENCODE_H264_SLICE_CONTROL_MODE_FIXED_MBS                                   0x00000000
66 #define RENCODE_H264_SLICE_CONTROL_MODE_FIXED_BITS                                  0x00000001
67 
68 #define RENCODE_HEVC_SLICE_CONTROL_MODE_FIXED_CTBS                                  0x00000000
69 #define RENCODE_HEVC_SLICE_CONTROL_MODE_FIXED_BITS                                  0x00000001
70 
71 #define RENCODE_RATE_CONTROL_METHOD_NONE                                            0x00000000
72 #define RENCODE_RATE_CONTROL_METHOD_LATENCY_CONSTRAINED_VBR                         0x00000001
73 #define RENCODE_RATE_CONTROL_METHOD_PEAK_CONSTRAINED_VBR                            0x00000002
74 #define RENCODE_RATE_CONTROL_METHOD_CBR                                             0x00000003
75 #define RENCODE_RATE_CONTROL_METHOD_QUALITY_VBR                                     0x00000004
76 
77 #define RENCODE_DIRECT_OUTPUT_NALU_TYPE_AUD                                         0x00000000
78 #define RENCODE_DIRECT_OUTPUT_NALU_TYPE_VPS                                         0x00000001
79 #define RENCODE_DIRECT_OUTPUT_NALU_TYPE_SPS                                         0x00000002
80 #define RENCODE_DIRECT_OUTPUT_NALU_TYPE_PPS                                         0x00000003
81 #define RENCODE_DIRECT_OUTPUT_NALU_TYPE_PREFIX                                      0x00000004
82 #define RENCODE_DIRECT_OUTPUT_NALU_TYPE_END_OF_SEQUENCE                             0x00000005
83 #define RENCODE_DIRECT_OUTPUT_NALU_TYPE_SEI                                         0x00000006
84 
85 #define RENCODE_SLICE_HEADER_TEMPLATE_MAX_TEMPLATE_SIZE_IN_DWORDS                   16
86 #define RENCODE_SLICE_HEADER_TEMPLATE_MAX_NUM_INSTRUCTIONS                          16
87 
88 #define RENCODE_HEADER_INSTRUCTION_END                                              0x00000000
89 #define RENCODE_HEADER_INSTRUCTION_COPY                                             0x00000001
90 
91 #define RENCODE_HEVC_HEADER_INSTRUCTION_DEPENDENT_SLICE_END                         0x00010000
92 #define RENCODE_HEVC_HEADER_INSTRUCTION_FIRST_SLICE                                 0x00010001
93 #define RENCODE_HEVC_HEADER_INSTRUCTION_SLICE_SEGMENT                               0x00010002
94 #define RENCODE_HEVC_HEADER_INSTRUCTION_SLICE_QP_DELTA                              0x00010003
95 #define RENCODE_HEVC_HEADER_INSTRUCTION_SAO_ENABLE                                  0x00010004
96 #define RENCODE_HEVC_HEADER_INSTRUCTION_LOOP_FILTER_ACROSS_SLICES_ENABLE            0x00010005
97 
98 #define RENCODE_H264_HEADER_INSTRUCTION_FIRST_MB                                    0x00020000
99 #define RENCODE_H264_HEADER_INSTRUCTION_SLICE_QP_DELTA                              0x00020001
100 
101 #define RENCODE_HEVC_SEI_TYPE_MDCV                                                  137
102 #define RENCODE_HEVC_SEI_TYPE_CLL                                                   144
103 
104 #define RENCODE_AV1_BITSTREAM_INSTRUCTION_OBU_START                                 0x00000002
105 #define RENCODE_AV1_BITSTREAM_INSTRUCTION_OBU_SIZE                                  0x00000003
106 #define RENCODE_AV1_BITSTREAM_INSTRUCTION_OBU_END                                   0x00000004
107 
108 #define RENCODE_OBU_START_TYPE_FRAME                                                1
109 #define RENCODE_OBU_START_TYPE_FRAME_HEADER                                         2
110 #define RENCODE_OBU_START_TYPE_TILE_GROUP                                           3
111 
112 #define RENCODE_OBU_TYPE_SEQUENCE_HEADER                                            1
113 #define RENCODE_OBU_TYPE_TEMPORAL_DELIMITER                                         2
114 #define RENCODE_OBU_TYPE_FRAME_HEADER                                               3
115 #define RENCODE_OBU_TYPE_TILE_GROUP                                                 4
116 #define RENCODE_OBU_TYPE_METADATA                                                   5
117 #define RENCODE_OBU_TYPE_FRAME                                                      6
118 #define RENCODE_OBU_TYPE_REDUNDANT_FRAME_HEADER                                     7
119 #define RENCODE_OBU_TYPE_TILE_LIST                                                  8
120 #define RENCODE_OBU_TYPE_PADDING                                                    15
121 
122 #define RENCODE_METADATA_TYPE_HDR_CLL                                               1
123 #define RENCODE_METADATA_TYPE_HDR_MDCV                                              2
124 #define RENCODE_METADATA_TYPE_ITUT_T35                                              4
125 #define RENCODE_METADATA_TYPE_TIMECODE                                              5
126 
127 #define RENCODE_AV1_MV_PRECISION_ALLOW_HIGH_PRECISION                               0x00
128 #define RENCODE_AV1_MV_PRECISION_DISALLOW_HIGH_PRECISION                            0x10
129 #define RENCODE_AV1_MV_PRECISION_FORCE_INTEGER_MV                                   0x30
130 
131 #define RENCODE_AV1_CDEF_MODE_DISABLE                                               0
132 #define RENCODE_AV1_CDEF_MODE_ENABLE                                                1
133 
134 #define RENCODE_AV1_ORDER_HINT_BITS                                                 8
135 #define RENCODE_AV1_DELTA_FRAME_ID_LENGTH                                           15
136 #define RENCODE_AV1_ADDITIONAL_FRAME_ID_LENGTH                                      1
137 
138 #define RENCDOE_AV1_NUM_REF_FRAMES                                                  8
139 #define RENCDOE_AV1_REFS_PER_FRAME                                                  7
140 #define RENCODE_AV1_SDB_FRAME_CONTEXT_SIZE                                          947200
141 #define RENCODE_AV1_FRAME_CONTEXT_CDF_TABLE_SIZE                                    22528
142 #define RENCODE_AV1_CDEF_ALGORITHM_FRAME_CONTEXT_SIZE                               (64 * 8 * 3)
143 #define RENCODE_AV1_CDEF_MAX_NUM                                                    8
144 #define RENCODE_MAX_METADATA_BUFFER_SIZE_PER_FRAME                                  1024
145 #define RENCODE_AV1_MAX_TILE_COLS                                                   64
146 #define RENCODE_AV1_MAX_TILE_ROWS                                                   64
147 #define RENCODE_AV1_MAX_TILE_AREA                                                   (4096 * 2304)
148 #define RENCODE_AV1_MAX_TILE_WIDTH                                                  4096
149 #define RENCODE_AV1_MAX_TILE_HEIGHT                                                 4096
150 #define RENCODE_INVALID_COLOC_OFFSET                                                0XFFFFFFFF
151 
152 #define RENCODE_PICTURE_TYPE_B                                                      0
153 #define RENCODE_PICTURE_TYPE_P                                                      1
154 #define RENCODE_PICTURE_TYPE_I                                                      2
155 #define RENCODE_PICTURE_TYPE_P_SKIP                                                 3
156 
157 #define RENCODE_INPUT_SWIZZLE_MODE_LINEAR                                           0
158 #define RENCODE_INPUT_SWIZZLE_MODE_256B_S                                           1
159 #define RENCODE_INPUT_SWIZZLE_MODE_4kB_S                                            5
160 #define RENCODE_INPUT_SWIZZLE_MODE_64kB_S                                           9
161 
162 #define RENCODE_H264_PICTURE_STRUCTURE_FRAME                                        0
163 #define RENCODE_H264_PICTURE_STRUCTURE_TOP_FIELD                                    1
164 #define RENCODE_H264_PICTURE_STRUCTURE_BOTTOM_FIELD                                 2
165 
166 #define RENCODE_H264_INTERLACING_MODE_PROGRESSIVE                                   0
167 #define RENCODE_H264_INTERLACING_MODE_INTERLACED_STACKED                            1
168 #define RENCODE_H264_INTERLACING_MODE_INTERLACED_INTERLEAVED                        2
169 
170 #define RENCODE_H264_DISABLE_DEBLOCKING_FILTER_IDC_ENABLE                           0
171 #define RENCODE_H264_DISABLE_DEBLOCKING_FILTER_IDC_DISABLE                          1
172 #define RENCODE_H264_DISABLE_DEBLOCKING_FILTER_IDC_DISABLE_ACROSS_SLICE_BOUNDARY    2
173 
174 #define RENCODE_INTRA_REFRESH_MODE_NONE                                             0
175 #define RENCODE_INTRA_REFRESH_MODE_CTB_MB_ROWS                                      1
176 #define RENCODE_INTRA_REFRESH_MODE_CTB_MB_COLUMNS                                   2
177 
178 #define RENCODE_MAX_NUM_RECONSTRUCTED_PICTURES                                      34
179 
180 #define RENCODE_REC_SWIZZLE_MODE_LINEAR                                             0
181 #define RENCODE_REC_SWIZZLE_MODE_256B_S                                             1
182 #define RENCODE_REC_SWIZZLE_MODE_256B_D                                             2
183 #define RENCODE_REC_SWIZZLE_MODE_8x8_1D_THIN_12_24BPP                               0x10000001
184 
185 #define RENCODE_VIDEO_BITSTREAM_BUFFER_MODE_LINEAR                                  0
186 #define RENCODE_VIDEO_BITSTREAM_BUFFER_MODE_CIRCULAR                                1
187 
188 #define RENCODE_FEEDBACK_BUFFER_MODE_LINEAR                                         0
189 #define RENCODE_FEEDBACK_BUFFER_MODE_CIRCULAR                                       1
190 
191 #define RENCODE_STATISTICS_TYPE_NONE                                                0
192 #define RENCODE_STATISTICS_TYPE_0                                                   1
193 
194 #define RENCODE_MAX_NUM_TEMPORAL_LAYERS                                             4
195 
196 #define PIPE_AV1_ENC_SB_SIZE                                                        64
197 #define PIPE_H265_ENC_CTB_SIZE                                                      64
198 #define PIPE_H264_MB_SIZE                                                           16
199 
200 #define RENCODE_COLOR_VOLUME_G22_BT709                                              0
201 
202 #define RENCODE_COLOR_RANGE_FULL                                                    0
203 #define RENCODE_COLOR_RANGE_STUDIO                                                  1
204 #define RENCODE_CHROMA_LOCATION_INTERSTITIAL                                        0
205 
206 #define RENCODE_COLOR_BIT_DEPTH_8_BIT                                               0
207 #define RENCODE_COLOR_BIT_DEPTH_10_BIT                                              1
208 
209 #define RENCODE_CHROMA_SUBSAMPLING_4_2_0                                            0
210 #define RENCODE_CHROMA_SUBSAMPLING_4_4_4                                            1
211 
212 #define RENCODE_COLOR_PACKING_FORMAT_NV12                                           0
213 #define RENCODE_COLOR_PACKING_FORMAT_P010                                           1
214 #define RENCODE_COLOR_PACKING_FORMAT_A8R8G8B8                                       4
215 #define RENCODE_COLOR_PACKING_FORMAT_A2R10G10B10                                    5
216 #define RENCODE_COLOR_PACKING_FORMAT_A8B8G8R8                                       7
217 #define RENCODE_COLOR_PACKING_FORMAT_A2B10G10R10                                    8
218 
219 #define RENCODE_COLOR_SPACE_YUV                                                     0
220 #define RENCODE_COLOR_SPACE_RGB                                                     1
221 
222 #define RENCODE_VCN4_AV1_MAX_NUM_LTR                                                2
223 #define RENCODE_AV1_CDEF_MODE_DEFAULT                                               1
224 #define RENCODE_AV1_CDEF_MODE_EXPLICIT                                              2
225 
226 typedef struct rvcn_enc_session_info_s {
227    uint32_t interface_version;
228    uint32_t sw_context_address_hi;
229    uint32_t sw_context_address_lo;
230 } rvcn_enc_session_info_t;
231 
232 typedef struct rvcn_enc_task_info_s {
233    uint32_t total_size_of_all_packages;
234    uint32_t task_id;
235    uint32_t allowed_max_num_feedbacks;
236 } rvcn_enc_task_info_t;
237 
238 typedef struct rvcn_enc_session_init_s {
239    uint32_t encode_standard;
240    uint32_t aligned_picture_width;
241    uint32_t aligned_picture_height;
242    uint32_t padding_width;
243    uint32_t padding_height;
244    uint32_t pre_encode_mode;
245    uint32_t pre_encode_chroma_enabled;
246    uint32_t slice_output_enabled;
247    uint32_t display_remote;
248 } rvcn_enc_session_init_t;
249 
250 typedef struct rvcn_enc_layer_control_s {
251    uint32_t max_num_temporal_layers;
252    uint32_t num_temporal_layers;
253 } rvcn_enc_layer_control_t;
254 
255 typedef struct rvcn_enc_layer_select_s {
256    uint32_t temporal_layer_index;
257 } rvcn_enc_layer_select_t;
258 
259 typedef struct rvcn_enc_h264_slice_control_s {
260    uint32_t slice_control_mode;
261    union {
262       uint32_t num_mbs_per_slice;
263       uint32_t num_bits_per_slice;
264    };
265 } rvcn_enc_h264_slice_control_t;
266 
267 typedef struct rvcn_enc_hevc_slice_control_s {
268    uint32_t slice_control_mode;
269    union {
270       struct {
271          uint32_t num_ctbs_per_slice;
272          uint32_t num_ctbs_per_slice_segment;
273       } fixed_ctbs_per_slice;
274 
275       struct {
276          uint32_t num_bits_per_slice;
277          uint32_t num_bits_per_slice_segment;
278       } fixed_bits_per_slice;
279    };
280 } rvcn_enc_hevc_slice_control_t;
281 
282 typedef struct rvcn_enc_h264_spec_misc_s {
283    uint32_t constrained_intra_pred_flag;
284    uint32_t cabac_enable;
285    uint32_t cabac_init_idc;
286    uint32_t transform_8x8_mode;
287    uint32_t half_pel_enabled;
288    uint32_t quarter_pel_enabled;
289    uint32_t profile_idc;
290    uint32_t level_idc;
291    uint32_t b_picture_enabled;
292    uint32_t weighted_bipred_idc;
293    struct {
294       uint32_t deblocking_filter_control_present_flag:1;
295       uint32_t redundant_pic_cnt_present_flag:1;
296    };
297 } rvcn_enc_h264_spec_misc_t;
298 
299 typedef struct rvcn_enc_hevc_spec_misc_s {
300    uint32_t log2_min_luma_coding_block_size_minus3;
301    uint32_t amp_disabled;
302    uint32_t strong_intra_smoothing_enabled;
303    uint32_t constrained_intra_pred_flag;
304    uint32_t cabac_init_flag;
305    uint32_t half_pel_enabled;
306    uint32_t quarter_pel_enabled;
307    uint32_t transform_skip_disabled;
308    uint32_t cu_qp_delta_enabled_flag;
309 } rvcn_enc_hevc_spec_misc_t;
310 
311 typedef struct rvcn_enc_av1_spec_misc_s {
312    uint32_t palette_mode_enable;
313    uint32_t mv_precision;
314    uint32_t cdef_mode;
315    uint32_t disable_cdf_update;
316    uint32_t disable_frame_end_update_cdf;
317    uint32_t num_tiles_per_picture;
318    /* for vcn5 */
319    bool separate_delta_q;
320    uint32_t cdef_bits;
321    uint32_t cdef_damping_minus3;
322    uint32_t cdef_y_pri_strength[RENCODE_AV1_CDEF_MAX_NUM];
323    uint32_t cdef_y_sec_strength[RENCODE_AV1_CDEF_MAX_NUM];
324    uint32_t cdef_uv_pri_strength[RENCODE_AV1_CDEF_MAX_NUM];
325    uint32_t cdef_uv_sec_strength[RENCODE_AV1_CDEF_MAX_NUM];
326     int32_t delta_q_y_dc;
327     int32_t delta_q_u_dc;
328     int32_t delta_q_u_ac;
329     int32_t delta_q_v_dc;
330     int32_t delta_q_v_ac;
331 } rvcn_enc_av1_spec_misc_t;
332 
333 /* vcn5 */
334 typedef struct rvcn_enc_av1_tile_group_s {
335    uint32_t start;
336    uint32_t end;
337 } rvcn_enc_av1_tile_group_t;
338 
339 #define RENCODE_AV1_TILE_CONFIG_MAX_NUM_COLS               2
340 #define RENCODE_AV1_TILE_CONFIG_MAX_NUM_ROWS               16
341 #define RENCODE_AV1_CONTEXT_UPDATE_TILE_ID_MODE_CUSTOMIZED 1
342 #define RENCODE_AV1_CONTEXT_UPDATE_TILE_ID_MODE_DEFAULT    2
343 /* vcn5 */
344 typedef struct rvcn_enc_av1_tile_config_s {
345    /* check if app settings can be applied or not, due to some
346     * constraints, the settings only meet the limitations can
347     * be used, then all the app settings can be applied.*/
348    bool     apply_app_setting;
349    bool     uniform_tile_spacing;
350    uint32_t num_tile_cols;
351    uint32_t num_tile_rows;
352    uint32_t tile_widths[RENCODE_AV1_TILE_CONFIG_MAX_NUM_COLS];
353    uint32_t tile_height[RENCODE_AV1_TILE_CONFIG_MAX_NUM_ROWS];
354    uint32_t num_tile_groups;
355    rvcn_enc_av1_tile_group_t tile_groups[RENCODE_AV1_TILE_CONFIG_MAX_NUM_COLS
356                                        * RENCODE_AV1_TILE_CONFIG_MAX_NUM_ROWS];
357    uint32_t context_update_tile_id_mode;
358    uint32_t context_update_tile_id;
359    uint32_t tile_size_bytes_minus_1;
360 } rvcn_enc_av1_tile_config_t;
361 
362 typedef struct rvcn_enc_rate_ctl_session_init_s {
363    uint32_t rate_control_method;
364    uint32_t vbv_buffer_level;
365 } rvcn_enc_rate_ctl_session_init_t;
366 
367 typedef struct rvcn_enc_rate_ctl_layer_init_s {
368    uint32_t target_bit_rate;
369    uint32_t peak_bit_rate;
370    uint32_t frame_rate_num;
371    uint32_t frame_rate_den;
372    uint32_t vbv_buffer_size;
373    uint32_t avg_target_bits_per_picture;
374    uint32_t peak_bits_per_picture_integer;
375    uint32_t peak_bits_per_picture_fractional;
376 } rvcn_enc_rate_ctl_layer_init_t;
377 
378 typedef struct rvcn_enc_rate_ctl_per_picture_s {
379    uint32_t qp_obs;
380    uint32_t min_qp_app_obs;
381    uint32_t max_qp_app_obs;
382    uint32_t max_au_size_obs;
383    uint32_t qp_i;
384    uint32_t qp_p;
385    uint32_t qp_b;
386    uint32_t min_qp_i;
387    uint32_t max_qp_i;
388    uint32_t min_qp_p;
389    uint32_t max_qp_p;
390    uint32_t min_qp_b;
391    uint32_t max_qp_b;
392    uint32_t max_au_size_i;
393    uint32_t max_au_size_p;
394    uint32_t max_au_size_b;
395    uint32_t enabled_filler_data;
396    uint32_t skip_frame_enable;
397    uint32_t enforce_hrd;
398    uint32_t qvbr_quality_level;
399 } rvcn_enc_rate_ctl_per_picture_t;
400 
401 typedef struct rvcn_enc_quality_params_s {
402    uint32_t vbaq_mode;
403    uint32_t scene_change_sensitivity;
404    uint32_t scene_change_min_idr_interval;
405    uint32_t two_pass_search_center_map_mode;
406    uint32_t vbaq_strength;
407 } rvcn_enc_quality_params_t;
408 
409 typedef struct rvcn_enc_direct_output_nalu_s {
410    uint32_t type;
411    uint32_t size;
412    uint32_t data[1];
413 } rvcn_enc_direct_output_nalu_t;
414 
415 typedef struct rvcn_enc_slice_header_s {
416    uint32_t bitstream_template[RENCODE_SLICE_HEADER_TEMPLATE_MAX_TEMPLATE_SIZE_IN_DWORDS];
417    struct {
418       uint32_t instruction;
419       uint32_t num_bits;
420    } instructions[RENCODE_SLICE_HEADER_TEMPLATE_MAX_NUM_INSTRUCTIONS];
421 } rvcn_enc_slice_header_t;
422 
423 typedef struct rvcn_enc_h264_reference_picture_info_s {
424    unsigned int pic_type;
425    unsigned int is_long_term;
426    unsigned int picture_structure;
427    unsigned int pic_order_cnt;
428 } rvcn_enc_h264_reference_picture_info_t;
429 
430 typedef struct rvcn_enc_encode_params_s {
431    uint32_t pic_type;
432    uint32_t allowed_max_bitstream_size;
433    uint32_t input_picture_luma_address_hi;
434    uint32_t input_picture_luma_address_lo;
435    uint32_t input_picture_chroma_address_hi;
436    uint32_t input_picture_chroma_address_lo;
437    uint32_t input_pic_luma_pitch;
438    uint32_t input_pic_chroma_pitch;
439    uint8_t input_pic_swizzle_mode;
440    uint32_t reference_picture_index;
441    uint32_t reconstructed_picture_index;
442 } rvcn_enc_encode_params_t;
443 
444 #define RENCODE_H264_MAX_REFERENCE_LIST_SIZE   32
445 typedef struct rvcn_enc_h264_encode_params_s {
446    uint32_t input_picture_structure;
447    uint32_t input_pic_order_cnt;
448    uint32_t interlaced_mode;
449    uint32_t is_reference;
450    /* for vcn1 - vcn4 */
451    uint32_t reference_picture_structure;
452    uint32_t reference_picture1_index;
453    rvcn_enc_h264_reference_picture_info_t picture_info_l0_reference_picture0;
454    uint32_t l0_reference_picture1_index;
455    rvcn_enc_h264_reference_picture_info_t picture_info_l0_reference_picture1;
456    uint32_t l1_reference_picture0_index;
457    rvcn_enc_h264_reference_picture_info_t picture_info_l1_reference_picture0;
458    /* for vcn5*/
459    uint32_t is_long_term;
460    uint32_t ref_list0[RENCODE_H264_MAX_REFERENCE_LIST_SIZE];
461    uint32_t num_active_references_l0;
462    uint32_t ref_list1[RENCODE_H264_MAX_REFERENCE_LIST_SIZE];
463    uint32_t num_active_references_l1;
464    struct {
465       uint32_t list;
466       uint32_t list_index;
467    } lsm_reference_pictures[2];
468 } rvcn_enc_h264_encode_params_t;
469 
470 #define RENCODE_HEVC_MAX_REFERENCE_LIST_SIZE   15
471 typedef struct rvcn_enc_hevc_encode_params_s {
472    uint32_t ref_list0[RENCODE_HEVC_MAX_REFERENCE_LIST_SIZE];
473    uint32_t num_active_references_l0;
474    uint32_t lsm_reference_pictures_list_index;
475 } rvcn_enc_hevc_encode_params_t;
476 
477 typedef struct rvcn_enc_av1_encode_params_s {
478    uint32_t ref_frames[RENCDOE_AV1_REFS_PER_FRAME];
479    uint32_t lsm_reference_frame_index[2];
480 } rvcn_enc_av1_encode_params_t;
481 
482 typedef struct rvcn_enc_h264_deblocking_filter_s {
483    uint32_t disable_deblocking_filter_idc;
484    int32_t alpha_c0_offset_div2;
485    int32_t beta_offset_div2;
486    int32_t cb_qp_offset;
487    int32_t cr_qp_offset;
488 } rvcn_enc_h264_deblocking_filter_t;
489 
490 typedef struct rvcn_enc_hevc_deblocking_filter_s {
491    uint32_t loop_filter_across_slices_enabled;
492    int32_t deblocking_filter_disabled;
493    int32_t beta_offset_div2;
494    int32_t tc_offset_div2;
495    int32_t cb_qp_offset;
496    int32_t cr_qp_offset;
497    uint32_t disable_sao;
498 } rvcn_enc_hevc_deblocking_filter_t;
499 
500 typedef struct rvcn_enc_intra_refresh_s {
501    uint32_t intra_refresh_mode;
502    uint32_t offset;
503    uint32_t region_size;
504 } rvcn_enc_intra_refresh_t;
505 
506 typedef struct rvcn_enc_reconstructed_picture_s {
507    uint32_t luma_offset;
508    uint32_t chroma_offset;
509    uint32_t luma_addr_hi;
510    uint32_t luma_addr_lo;
511    uint32_t luma_pitch;
512    uint32_t chroma_addr_hi;
513    uint32_t chroma_addr_lo;
514    uint32_t chroma_pitch;
515    uint32_t chroma_v_addr_hi;
516    uint32_t chroma_v_addr_lo;
517    uint32_t chroma_v_offset;
518    uint32_t chroma_v_pitch;
519    uint32_t swizzle_mode;
520    uint32_t frame_context_buffer_addr_hi;
521    uint32_t frame_context_buffer_addr_lo;
522    uint32_t frame_context_buffer_offset;
523    union {
524       struct
525       {
526          uint32_t av1_cdf_frame_context_offset;
527          uint32_t av1_cdef_algorithm_context_offset;
528       } av1;
529       /* vcn5 only */
530       struct
531       {
532          uint32_t colloc_buffer_offset;
533       } h264;
534    };
535    uint32_t encode_metadata_offset; /* vcn5 only */
536 } rvcn_enc_reconstructed_picture_t;
537 
538 typedef struct rvcn_enc_pre_encode_input_picture_s {
539    union {
540       struct {
541          uint32_t luma_offset;
542          uint32_t chroma_offset;
543       } yuv;
544       struct {
545          uint32_t red_offset;
546          uint32_t green_offset;
547          uint32_t blue_offset;
548       } rgb;
549    };
550 } rvcn_enc_pre_encode_input_picture_t;
551 
552 typedef struct rvcn_enc_encode_context_buffer_s {
553    uint32_t encode_context_address_hi;
554    uint32_t encode_context_address_lo;
555    uint32_t swizzle_mode;     /* vcn1 - vcn4 */
556    uint32_t rec_luma_pitch;   /* vcn1 - vcn4 */
557    uint32_t rec_chroma_pitch; /* vcn1 - vcn4 */
558    uint32_t num_reconstructed_pictures;
559    rvcn_enc_reconstructed_picture_t reconstructed_pictures[RENCODE_MAX_NUM_RECONSTRUCTED_PICTURES];
560    uint32_t pre_encode_picture_luma_pitch;
561    uint32_t pre_encode_picture_chroma_pitch;
562    rvcn_enc_reconstructed_picture_t
563    pre_encode_reconstructed_pictures[RENCODE_MAX_NUM_RECONSTRUCTED_PICTURES];
564    rvcn_enc_pre_encode_input_picture_t pre_encode_input_picture;
565    uint32_t two_pass_search_center_map_offset;
566    union {
567       uint32_t colloc_buffer_offset; /* vcn5 */
568       struct {
569          uint32_t av1_sdb_intermediate_context_offset;
570       } av1;
571    };
572 } rvcn_enc_encode_context_buffer_t;
573 
574 typedef struct rvcn_enc_metadata_buffer_s {
575    uint32_t metadata_buffer_address_hi;
576    uint32_t metadata_buffer_address_lo;
577    uint32_t two_pass_search_center_map_offset;
578 } rvcn_enc_metadata_buffer_t;
579 
580 typedef struct rvcn_enc_sei_hdr_cll_s {
581    uint16_t max_cll;
582    uint16_t max_fall;
583 } rvcn_enc_sei_hdr_cll_t;
584 
585 typedef struct rvcn_enc_sei_hdr_mdcv_s {
586    uint16_t primary_chromaticity_x[3];
587    uint16_t primary_chromaticity_y[3];
588    uint16_t white_point_chromaticity_x;
589    uint16_t white_point_chromaticity_y;
590    uint32_t luminance_max;
591    uint32_t luminance_min;
592 } rvcn_enc_sei_hdr_mdcv_t;
593 
594 /* shared sei structure */
595 typedef struct rvcn_enc_seidata_s {
596    union {
597       struct {
598          uint32_t hdr_cll:1;
599          uint32_t hdr_mdcv:1;
600       };
601       uint32_t value;
602    } flags;
603    rvcn_enc_sei_hdr_cll_t hdr_cll;
604    rvcn_enc_sei_hdr_mdcv_t hdr_mdcv;
605 } rvcn_enc_seidata_t;
606 
607 typedef struct rvcn_enc_video_bitstream_buffer_s {
608    uint32_t mode;
609    uint32_t video_bitstream_buffer_address_hi;
610    uint32_t video_bitstream_buffer_address_lo;
611    uint32_t video_bitstream_buffer_size;
612    uint32_t video_bitstream_data_offset;
613 } rvcn_enc_video_bitstream_buffer_t;
614 
615 typedef struct rvcn_enc_feedback_buffer_s {
616    uint32_t mode;
617    uint32_t feedback_buffer_address_hi;
618    uint32_t feedback_buffer_address_lo;
619    uint32_t feedback_buffer_size;
620    uint32_t feedback_data_size;
621 } rvcn_enc_feedback_buffer_t;
622 
623 typedef struct rvcn_enc_av1_cdf_default_table_s {
624    uint32_t use_cdf_default;
625    uint32_t cdf_default_buffer_address_lo;
626    uint32_t cdf_default_buffer_address_hi;
627 } rvcn_enc_av1_cdf_default_table_t;
628 
629 typedef struct rvcn_encode_stats_type_0_s
630 {
631     uint32_t qp_frame;
632     uint32_t qp_avg_ctb;
633     uint32_t qp_max_ctb;
634     uint32_t qp_min_ctb;
635     uint32_t pix_intra;
636     uint32_t pix_inter;
637     uint32_t pix_skip;
638     uint32_t bitcount_residual;
639     uint32_t bitcount_all_minus_header;
640     uint32_t bitcount_motion;
641     uint32_t bitcount_inter;
642     uint32_t bitcount_intra;
643     uint32_t mv_x_frame;
644     uint32_t mv_y_frame;
645 } rvcn_encode_stats_type_0_t;
646 
647 typedef struct rvcn_encode_stats_s
648 {
649     uint32_t encode_stats_type;
650     uint32_t encode_stats_buffer_address_hi;
651     uint32_t encode_stats_buffer_address_lo;
652 } rvcn_enc_stats_t;
653 
654 typedef struct rvcn_enc_cmd_s {
655    uint32_t session_info;
656    uint32_t task_info;
657    uint32_t session_init;
658    uint32_t layer_control;
659    uint32_t layer_select;
660    uint32_t rc_session_init;
661    uint32_t rc_layer_init;
662    uint32_t rc_per_pic;
663    uint32_t quality_params;
664    uint32_t slice_header;
665    uint32_t enc_params;
666    uint32_t intra_refresh;
667    uint32_t ctx;
668    uint32_t bitstream;
669    uint32_t feedback;
670    uint32_t nalu;
671    uint32_t slice_control_hevc;
672    uint32_t spec_misc_hevc;
673    uint32_t enc_params_hevc;
674    uint32_t deblocking_filter_hevc;
675    uint32_t slice_control_h264;
676    uint32_t spec_misc_h264;
677    uint32_t enc_params_h264;
678    uint32_t deblocking_filter_h264;
679    uint32_t spec_misc_av1;
680    uint32_t bitstream_instruction_av1;
681    uint32_t cdf_default_table_av1;
682    uint32_t enc_params_av1;
683    uint32_t tile_config_av1;
684    uint32_t input_format;
685    uint32_t output_format;
686    uint32_t enc_statistics;
687    uint32_t enc_qp_map;
688    uint32_t metadata;
689    uint32_t ctx_override;
690    uint32_t enc_latency;
691 } rvcn_enc_cmd_t;
692 
693 typedef struct rvcn_enc_quality_modes_s
694 {
695    unsigned pre_encode_mode;
696    unsigned vbaq_mode;
697    unsigned preset_mode;
698 } rvcn_enc_quality_modes_t;
699 
700 typedef struct rvcn_enc_input_format_s
701 {
702    uint32_t input_color_volume;
703    uint32_t input_color_space;
704    uint32_t input_color_range;
705    uint32_t input_chroma_subsampling;
706    uint32_t input_chroma_location;
707    uint32_t input_color_bit_depth;
708    uint32_t input_color_packing_format;
709 } rvcn_enc_input_format_t;
710 
711 typedef struct rvcn_enc_output_format_s
712 {
713    uint32_t output_color_volume;
714    uint32_t output_color_range;
715    uint32_t output_chroma_subsampling;
716    uint32_t output_chroma_location;  /* chroma location to luma */
717    uint32_t output_color_bit_depth;
718 } rvcn_enc_output_format_t;
719 
720 typedef struct rvcn_enc_av1_timing_info_s
721 {
722    uint32_t num_units_in_display_tick;
723    uint32_t time_scale;
724    uint32_t num_tick_per_picture_minus1;
725 }rvcn_enc_av1_timing_info_t;
726 
727 typedef struct rvcn_enc_av1_color_description_s
728 {
729    uint32_t color_primaries;
730    uint32_t transfer_characteristics;
731    uint32_t maxtrix_coefficients;
732    uint32_t color_range;
733    uint32_t chroma_sample_position;
734 }rvcn_enc_av1_color_description_t;
735 
736 #define AV1_ENC_FRAME_TYPE_KEY 0x00
737 #define AV1_ENC_FRAME_TYPE_INTER 0x01
738 #define AV1_ENC_FRAME_TYPE_INTRA_ONLY 0x02
739 #define AV1_ENC_FRAME_TYPE_SWITCH 0x03
740 #define AV1_ENC_FRAME_TYPE_SHOW_EXISTING 0x04
741 
742 typedef struct rvcn_enc_av1_ref_frame_s
743 {
744    bool in_use;
745    bool is_ltr;
746    uint32_t frame_id;
747    uint32_t temporal_id;
748    uint32_t slot_id;
749    uint32_t frame_type;
750    uint32_t ltr_seq;
751    void *frame_signature;
752 } rvcn_enc_av1_ref_frame_t;
753 
754 typedef struct rvcn_enc_av1_recon_slot_s
755 {
756    bool in_use;
757    bool is_orphaned;
758 } rvcn_enc_av1_recon_slot_t;
759 
760 #define RENCODE_QP_MAP_TYPE_NONE               0
761 #define RENCODE_QP_MAP_TYPE_DELTA              1
762 #define RENCODE_QP_MAP_TYPE_MAP_PA             4
763 #define RENCODE_QP_MAP_MAX_REGIONS             32
764 #define RENCODE_QP_MAP_UNIFIED_QP_BITS_SHIFT   7
765 
766 struct rvcn_enc_qp_map_region
767 {
768    bool     is_valid;
769    int32_t  qp_delta;
770    uint32_t x_in_unit;
771    uint32_t y_in_unit;
772    uint32_t width_in_unit;
773    uint32_t height_in_unit;
774 };
775 
776 typedef struct rvcn_enc_qp_map_s
777 {
778    uint32_t qp_map_type;
779    uint32_t qp_map_buffer_address_hi;
780    uint32_t qp_map_buffer_address_lo;
781    uint32_t qp_map_pitch; /* number of units in width */
782    /* format difference between these two versions
783     * legacy is using a 32 bit for 1 unit
784     * vcn5 is using a 32 bit for 2 units, and use 2 units as the alignment
785     */
786    enum {
787       RENCODE_QP_MAP_LEGACY = 0,
788       RENCODE_QP_MAP_VCN5
789    } version;
790    uint32_t width_in_block;
791    uint32_t height_in_block;
792    struct rvcn_enc_qp_map_region map[RENCODE_QP_MAP_MAX_REGIONS];
793 }rvcn_enc_qp_map_t;
794 
795 typedef struct rvcn_enc_latency_s
796 {
797    uint32_t encode_latency;
798 } rvcn_enc_latency_t;
799 
800 #endif
801