Debian Codegraph @

media_softlet/agnostic/common/hw/vdbox/mhw_vdbox_hcp_itf.h

raw
1 /*
2 * Copyright (c) 2021-2022, Intel Corporation
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice shall be included
12 * in all copies or substantial portions of the Software.
13 *
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
18 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20 * OTHER DEALINGS IN THE SOFTWARE.
21 */
22 //!
23 //! \file mhw_vdbox_hcp_itf.h
24 //! \brief MHW VDBOX HCP interface common base
25 //! \details
26 //!
27
28 #ifndef __MHW_VDBOX_HCP_ITF_H__
29 #define __MHW_VDBOX_HCP_ITF_H__
30
31 #include "mhw_itf.h"
32 #include "mhw_vdbox_hcp_cmdpar.h"
33
34 #define _HCP_CMD_DEF(DEF) \
35 DEF(HCP_SURFACE_STATE); \
36 DEF(HCP_PIC_STATE); \
37 DEF(HCP_SLICE_STATE); \
38 DEF(HCP_IND_OBJ_BASE_ADDR_STATE); \
39 DEF(HCP_QM_STATE); \
40 DEF(HCP_BSD_OBJECT); \
41 DEF(HCP_TILE_STATE); \
42 DEF(HCP_REF_IDX_STATE); \
43 DEF(HCP_WEIGHTOFFSET_STATE); \
44 DEF(HCP_PIPE_MODE_SELECT); \
45 DEF(HCP_PIPE_BUF_ADDR_STATE); \
46 DEF(HCP_FQM_STATE); \
47 DEF(HCP_PAK_INSERT_OBJECT); \
48 DEF(HCP_VP9_PIC_STATE); \
49 DEF(HCP_VP9_SEGMENT_STATE); \
50 DEF(HEVC_VP9_RDOQ_STATE); \
51 DEF(HCP_TILE_CODING); \
52 DEF(HCP_PALETTE_INITIALIZER_STATE)
53
54 namespace mhw
55 {
56 namespace vdbox
57 {
58 namespace hcp
59 {
60 enum HevcSliceType
61 {
62 hevcSliceB = 0,
63 hevcSliceP = 1,
64 hevcSliceI = 2
65 };
66
67 class Itf
68 {
69 public:
70 enum CommandsNumberOfAddresses
71 {
72 MI_BATCH_BUFFER_START_CMD_NUMBER_OF_ADDRESSES = 1, // 2 DW for 1 address field
73 MI_STORE_DATA_IMM_CMD_NUMBER_OF_ADDRESSES = 1, // 2 DW for 1 address field
74 MI_FLUSH_DW_CMD_NUMBER_OF_ADDRESSES = 1, // 2 DW for 1 address field
75 MI_CONDITIONAL_BATCH_BUFFER_END_CMD_NUMBER_OF_ADDRESSES = 1, // 2 DW for 1 address field
76 MI_STORE_REGISTER_MEM_CMD_NUMBER_OF_ADDRESSES = 1, // 2 DW for 1 address field
77 MI_COPY_MEM_MEM_CMD_NUMBER_OF_ADDRESSES = 4, // 4 DW for 2 address fields
78 MI_SEMAPHORE_WAIT_CMD_NUMBER_OF_ADDRESSES = 1, // 2 DW for 1 address fields
79 MI_ATOMIC_CMD_NUMBER_OF_ADDRESSES = 1, // 2 DW for 1 address field
80
81 MFX_WAIT_CMD_NUMBER_OF_ADDRESSES = 0, // 0 DW for address fields
82
83 HCP_PIPE_MODE_SELECT_CMD_NUMBER_OF_ADDRESSES = 0, // 0 DW for address fields
84 HCP_SURFACE_STATE_CMD_NUMBER_OF_ADDRESSES = 0, // 0 DW for address fields
85 HCP_PIPE_BUF_ADDR_STATE_CMD_NUMBER_OF_ADDRESSES = 45, // 45 address fields
86 HCP_IND_OBJ_BASE_ADDR_STATE_CMD_NUMBER_OF_ADDRESSES = 11, // 22 DW for 11 address field
87 HCP_QM_STATE_CMD_NUMBER_OF_ADDRESSES = 0, // 0 DW for address fields
88 HCP_FQM_STATE_CMD_NUMBER_OF_ADDRESSES = 0, // 0 DW for address fields
89 HCP_PIC_STATE_CMD_NUMBER_OF_ADDRESSES = 0, // 0 DW for address fields
90 HCP_REF_IDX_STATE_CMD_NUMBER_OF_ADDRESSES = 0, // 0 DW for address fields
91 HCP_WEIGHTOFFSET_STATE_CMD_NUMBER_OF_ADDRESSES = 0, // 0 DW for address fields
92 HCP_SLICE_STATE_CMD_NUMBER_OF_ADDRESSES = 0, // 0 DW for address fields
93 HCP_PAK_INSERT_OBJECT_CMD_NUMBER_OF_ADDRESSES = 0, // 0 DW for address fields
94 HCP_TILE_STATE_CMD_NUMBER_OF_ADDRESSES = 0, // 0 DW for address fields
95 HCP_BSD_OBJECT_CMD_NUMBER_OF_ADDRESSES = 0, // 0 DW for address fields
96 HCP_VP9_SEGMENT_STATE_CMD_NUMBER_OF_ADDRESSES = 0, // 0 DW for address fields
97 HCP_VP9_PIC_STATE_CMD_NUMBER_OF_ADDRESSES = 0, // 0 DW for address fields
98 HCP_TILE_CODING_COMMAND_NUMBER_OF_ADDRESSES = 1, // 0 DW for address fields
99 HCP_PALETTE_INITIALIZER_STATE_CMD_NUMBER_OF_ADDRESSES = 0, // 0 DW for address fields
100
101 VDENC_PIPE_BUF_ADDR_STATE_CMD_NUMBER_OF_ADDRESSES = 12, // 12 DW for 12 address fields
102 VD_PIPELINE_FLUSH_CMD_NUMBER_OF_ADDRESSES = 0, // 0 DW for 0 address fields
103 };
104
105 class ParSetting
106 {
107 public:
108 virtual ~ParSetting() = default;
109
110 _HCP_CMD_DEF(_MHW_SETPAR_DEF);
111 };
112
113 virtual ~Itf() = default;
114
115 virtual MOS_STATUS SetCacheabilitySettings(MHW_MEMORY_OBJECT_CONTROL_PARAMS settings[MOS_CODEC_RESOURCE_USAGE_END_CODEC]) = 0;
116
117 virtual MOS_STATUS GetHcpBufSize(const HcpBufferSizePar &par, uint32_t &size) = 0;
118
119 virtual MOS_STATUS GetVP9BufSize(const HcpBufferSizePar &par, uint32_t &size) = 0;
120
121 virtual const HcpMmioRegisters *GetMmioRegisters(const MHW_VDBOX_NODE_IND index) const = 0;
122
123 virtual uint32_t GetEncCuRecordSize() = 0;
124
125 virtual uint32_t GetHcpPakObjSize() = 0;
126
127 virtual bool IsRowStoreCachingSupported() = 0;
128
129 virtual uint32_t GetPakHWTileSizeRecordSize() = 0;
130
131 virtual MOS_STATUS SetRowstoreCachingOffsets(const HcpVdboxRowStorePar &rowstoreParams) = 0;
132
133 virtual MOS_STATUS GetHcpStateCommandSize(
134 uint32_t mode,
135 uint32_t * commandsSize,
136 uint32_t * patchListSize,
137 PMHW_VDBOX_STATE_CMDSIZE_PARAMS params) = 0;
138
139 virtual MOS_STATUS GetHcpPrimitiveCommandSize(
140 uint32_t mode,
141 uint32_t *commandsSize,
142 uint32_t *patchListSize,
143 bool modeSpecific) = 0;
144 //!
145 //! \brief Get Hcp Cabac Error Flags Mask
146 //!
147 //! \return [out] uint32_t
148 //! Mask got.
149 //!
150 virtual inline uint32_t GetHcpCabacErrorFlagsMask()
151 {
152 return m_hcpCabacErrorFlagsMask;
153 }
154
155 //!
156 //! \brief Judge if hevc sao row store caching enabled
157 //!
158 //! \return bool
159 //! true if enabled, else false
160 //!
161 inline bool IsHevcSaoRowstoreCacheEnabled()
162 {
163 return m_hevcSaoRowStoreCache.enabled ? true : false;
164 }
165
166 //!
167 //! \brief Judge if hevc df row store caching enabled
168 //!
169 //! \return bool
170 //! true if enabled, else false
171 //!
172 inline bool IsHevcDfRowstoreCacheEnabled()
173 {
174 return m_hevcDfRowStoreCache.enabled ? true : false;
175 }
176
177 //!
178 //! \brief Judge if hevc dat store caching enabled
179 //!
180 //! \return bool
181 //! true if enabled, else false
182 //!
183 inline bool IsHevcDatRowstoreCacheEnabled()
184 {
185 return m_hevcDatRowStoreCache.enabled ? true : false;
186 }
187
188 //!
189 //! \brief Determines if the slice is I slice
190 //! \param [in] sliceType
191 //! slice type
192 //! \return bool
193 //! True if it's I slice, otherwise return false
194 //!
195 inline bool IsHevcISlice(uint8_t sliceType)
196 {
197 return (sliceType < MHW_ARRAY_SIZE(m_hevcBsdSliceType)) ? (m_hevcBsdSliceType[sliceType] == hevcSliceI) : false;
198 }
199
200 //!
201 //! \brief Determines if the slice is P slice
202 //! \param [in] sliceType
203 //! slice type
204 //! \return bool
205 //! True if it's P slice, otherwise return false
206 //!
207 inline bool IsHevcPSlice(uint8_t sliceType)
208 {
209 return (sliceType < MHW_ARRAY_SIZE(m_hevcBsdSliceType)) ? (m_hevcBsdSliceType[sliceType] == hevcSliceP) : false;
210 }
211
212 //!
213 //! \brief Determines if the slice is B slice
214 //! \param [in] sliceType
215 //! slice type
216 //! \return bool
217 //! True if it's B slice, otherwise return false
218 //!
219 inline bool IsHevcBSlice(uint8_t sliceType)
220 {
221 return (sliceType < MHW_ARRAY_SIZE(m_hevcBsdSliceType)) ? (m_hevcBsdSliceType[sliceType] == hevcSliceB) : false;
222 }
223
224 bool IsVp9DfRowstoreCacheEnabled()
225 {
226 return m_vp9DfRowStoreCache.enabled ? true : false;
227 }
228
229 enum HevcSliceType
230 {
231 hevcSliceB = 0,
232 hevcSliceP = 1,
233 hevcSliceI = 2
234 };
235
236 MOS_STATUS GetVp9BufferSize(
237 HCP_INTERNAL_BUFFER_TYPE bufferType,
238 HcpBufferSizePar *hcpBufSizeParam)
239 {
240 MOS_STATUS eStatus = MOS_STATUS_SUCCESS;
241
242 MHW_FUNCTION_ENTER;
243
244 MHW_MI_CHK_NULL(hcpBufSizeParam);
245
246 uint32_t bufferSize = 0;
247 uint32_t dblkRsbSizeMultiplier = 0;
248 uint32_t dblkCsbSizeMultiplier = 0;
249 uint32_t intraPredMultiplier = 0;
250
251 uint8_t maxBitDepth = hcpBufSizeParam->ucMaxBitDepth;
252 uint32_t widthInSb = hcpBufSizeParam->dwPicWidth;
253 uint32_t heightInSb = hcpBufSizeParam->dwPicHeight;
254 uint32_t widthInMinCb = widthInSb * 64 / 8; //using smallest cb to get max width
255 uint32_t heightInMinCb = heightInSb * 64 / 8;
256 HCP_CHROMA_FORMAT_IDC chromaFormat = (HCP_CHROMA_FORMAT_IDC)hcpBufSizeParam->ucChromaFormat;
257 uint32_t maxFrameSize = hcpBufSizeParam->dwMaxFrameSize;
258
259 if (chromaFormat == HCP_CHROMA_FORMAT_YUV420)
260 {
261 dblkRsbSizeMultiplier = (maxBitDepth > 8) ? 36 : 18;
262 dblkCsbSizeMultiplier = (maxBitDepth > 8) ? 34 : 17;
263 intraPredMultiplier = (maxBitDepth > 8) ? 4 : 2;
264 }
265 else if (chromaFormat == HCP_CHROMA_FORMAT_YUV444)
266 {
267 dblkRsbSizeMultiplier = (maxBitDepth > 8) ? 54 : 27;
268 dblkCsbSizeMultiplier = (maxBitDepth > 8) ? 50 : 25;
269 intraPredMultiplier = (maxBitDepth > 8) ? 6 : 3;
270 }
271 else
272 {
273 eStatus = MOS_STATUS_INVALID_PARAMETER;
274 MHW_ASSERTMESSAGE("Format not supported.");
275 return eStatus;
276 }
277
278 switch (bufferType)
279 {
280 case HCP_INTERNAL_BUFFER_TYPE::DBLK_LINE:
281 case HCP_INTERNAL_BUFFER_TYPE::DBLK_TILE_LINE:
282 bufferSize = widthInSb * dblkRsbSizeMultiplier * MHW_CACHELINE_SIZE;
283 break;
284 case HCP_INTERNAL_BUFFER_TYPE::DBLK_TILE_COL:
285 bufferSize = heightInSb * dblkCsbSizeMultiplier * MHW_CACHELINE_SIZE;
286 break;
287 case HCP_INTERNAL_BUFFER_TYPE::META_LINE:
288 case HCP_INTERNAL_BUFFER_TYPE::META_TILE_LINE:
289 bufferSize = widthInSb * 5 * MHW_CACHELINE_SIZE;
290 break;
291 case HCP_INTERNAL_BUFFER_TYPE::META_TILE_COL:
292 bufferSize = heightInSb * 5 * MHW_CACHELINE_SIZE;
293 break;
294 case HCP_INTERNAL_BUFFER_TYPE::CURR_MV_TEMPORAL:
295 case HCP_INTERNAL_BUFFER_TYPE::COLL_MV_TEMPORAL:
296 bufferSize = widthInSb * heightInSb * 9 * MHW_CACHELINE_SIZE;
297 break;
298 case HCP_INTERNAL_BUFFER_TYPE::SEGMENT_ID:
299 bufferSize = widthInSb * heightInSb * MHW_CACHELINE_SIZE;
300 break;
301 case HCP_INTERNAL_BUFFER_TYPE::HVD_LINE:
302 case HCP_INTERNAL_BUFFER_TYPE::HVD_TILE:
303 bufferSize = widthInSb * MHW_CACHELINE_SIZE;
304 break;
305 //scalable mode specific buffers
306 case HCP_INTERNAL_BUFFER_TYPE::INTRA_PRED_UP_RIGHT_COL:
307 case HCP_INTERNAL_BUFFER_TYPE::INTRA_PRED_LFT_RECON_COL:
308 bufferSize = intraPredMultiplier * heightInSb * MHW_CACHELINE_SIZE;
309 break;
310 case HCP_INTERNAL_BUFFER_TYPE::CABAC_STREAMOUT:
311 //From sas, cabac stream out buffer size =
312 //(#LCU) in picture * (Worst case LCU_CU_TU_info) + 1 byte aligned per LCU + Bitstream Size * 3
313 if ((chromaFormat == HCP_CHROMA_FORMAT_YUV420) && (maxBitDepth == 8))
314 {
315 bufferSize = widthInMinCb * heightInMinCb * m_hcpWorstCaseCuTuInfo + widthInMinCb * heightInMinCb + maxFrameSize * 3;
316 }
317 else
318 {
319 bufferSize = widthInMinCb * heightInMinCb * m_hcpWorstCaseCuTuInfoRext + widthInMinCb * heightInMinCb + maxFrameSize * 3;
320 }
321 bufferSize = MOS_ALIGN_CEIL(bufferSize, MHW_CACHELINE_SIZE);
322 break;
323 default:
324 eStatus = MOS_STATUS_INVALID_PARAMETER;
325 break;
326 }
327
328 hcpBufSizeParam->dwBufferSize = bufferSize;
329
330 return eStatus;
331 }
332
333 inline uint32_t GetOpLength(uint32_t uiLength)
334 {
335 #define __CODEGEN_MAX(_a, _b) (((_a) > (_b)) ? (_a) : (_b))
336 #define __CODEGEN_BITFIELD(l, h) (h) - (l) + 1
337 #define __CODEGEN_OP_LENGTH_BIAS 2
338 #define __CODEGEN_OP_LENGTH(x) (uint32_t)((__CODEGEN_MAX(x, __CODEGEN_OP_LENGTH_BIAS)) - __CODEGEN_OP_LENGTH_BIAS)
339
340 return __CODEGEN_OP_LENGTH(uiLength);
341 }
342
343 protected:
344 RowStoreCache m_hevcDatRowStoreCache = {};
345 RowStoreCache m_hevcDfRowStoreCache = {};
346 RowStoreCache m_hevcSaoRowStoreCache = {};
347 RowStoreCache m_hevcHSaoRowStoreCache = {};
348 RowStoreCache m_vp9HvdRowStoreCache = {};
349 RowStoreCache m_vp9DfRowStoreCache = {};
350 RowStoreCache m_vp9DatRowStoreCache = {};
351
352 static const uint32_t m_hcpCabacErrorFlagsMask = 0x0879; //<! Hcp CABAC error flags mask
353
354 static const HevcSliceType m_hevcBsdSliceType[3]; //!< HEVC Slice Types for Long Format
355
356 static const uint32_t m_hcpWorstCaseCuTuInfo = 4 * MHW_CACHELINE_SIZE;
357
358 static const uint32_t m_hcpWorstCaseCuTuInfoRext = 6 * MHW_CACHELINE_SIZE;
359
360 _HCP_CMD_DEF(_MHW_CMD_ALL_DEF_FOR_ITF);
361 MEDIA_CLASS_DEFINE_END(mhw__vdbox__hcp__Itf)
362 };
363 } // namespace hcp
364 } // namespace vdbox
365 } // namespace mhw
366
367 #endif // __MHW_VDBOX_AVP_ITF_H__