xref: /utopia/UTPA2-700.0.x/modules/vdec_v3/hal/messi/hvd_v3/fwHVD_if.h (revision 53ee8cc121a030b8d368113ac3e966b4705770ef)
1 //<MStar Software>
2 //******************************************************************************
3 // MStar Software
4 // Copyright (c) 2010 - 2012 MStar Semiconductor, Inc. All rights reserved.
5 // All software, firmware and related documentation herein ("MStar Software") are
6 // intellectual property of MStar Semiconductor, Inc. ("MStar") and protected by
7 // law, including, but not limited to, copyright law and international treaties.
8 // Any use, modification, reproduction, retransmission, or republication of all
9 // or part of MStar Software is expressly prohibited, unless prior written
10 // permission has been granted by MStar.
11 //
12 // By accessing, browsing and/or using MStar Software, you acknowledge that you
13 // have read, understood, and agree, to be bound by below terms ("Terms") and to
14 // comply with all applicable laws and regulations:
15 //
16 // 1. MStar shall retain any and all right, ownership and interest to MStar
17 //    Software and any modification/derivatives thereof.
18 //    No right, ownership, or interest to MStar Software and any
19 //    modification/derivatives thereof is transferred to you under Terms.
20 //
21 // 2. You understand that MStar Software might include, incorporate or be
22 //    supplied together with third party`s software and the use of MStar
23 //    Software may require additional licenses from third parties.
24 //    Therefore, you hereby agree it is your sole responsibility to separately
25 //    obtain any and all third party right and license necessary for your use of
26 //    such third party`s software.
27 //
28 // 3. MStar Software and any modification/derivatives thereof shall be deemed as
29 //    MStar`s confidential information and you agree to keep MStar`s
30 //    confidential information in strictest confidence and not disclose to any
31 //    third party.
32 //
33 // 4. MStar Software is provided on an "AS IS" basis without warranties of any
34 //    kind. Any warranties are hereby expressly disclaimed by MStar, including
35 //    without limitation, any warranties of merchantability, non-infringement of
36 //    intellectual property rights, fitness for a particular purpose, error free
37 //    and in conformity with any international standard.  You agree to waive any
38 //    claim against MStar for any loss, damage, cost or expense that you may
39 //    incur related to your use of MStar Software.
40 //    In no event shall MStar be liable for any direct, indirect, incidental or
41 //    consequential damages, including without limitation, lost of profit or
42 //    revenues, lost or damage of data, and unauthorized system use.
43 //    You agree that this Section 4 shall still apply without being affected
44 //    even if MStar Software has been modified by MStar in accordance with your
45 //    request or instruction for your use, except otherwise agreed by both
46 //    parties in writing.
47 //
48 // 5. If requested, MStar may from time to time provide technical supports or
49 //    services in relation with MStar Software to you for your use of
50 //    MStar Software in conjunction with your or your customer`s product
51 //    ("Services").
52 //    You understand and agree that, except otherwise agreed by both parties in
53 //    writing, Services are provided on an "AS IS" basis and the warranty
54 //    disclaimer set forth in Section 4 above shall apply.
55 //
56 // 6. Nothing contained herein shall be construed as by implication, estoppels
57 //    or otherwise:
58 //    (a) conferring any license or right to use MStar name, trademark, service
59 //        mark, symbol or any other identification;
60 //    (b) obligating MStar or any of its affiliates to furnish any person,
61 //        including without limitation, you and your customers, any assistance
62 //        of any kind whatsoever, or any information; or
63 //    (c) conferring any license or right under any intellectual property right.
64 //
65 // 7. These terms shall be governed by and construed in accordance with the laws
66 //    of Taiwan, R.O.C., excluding its conflict of law rules.
67 //    Any and all dispute arising out hereof or related hereto shall be finally
68 //    settled by arbitration referred to the Chinese Arbitration Association,
69 //    Taipei in accordance with the ROC Arbitration Law and the Arbitration
70 //    Rules of the Association by three (3) arbitrators appointed in accordance
71 //    with the said Rules.
72 //    The place of arbitration shall be in Taipei, Taiwan and the language shall
73 //    be English.
74 //    The arbitration award shall be final and binding to both parties.
75 //
76 //******************************************************************************
77 //<MStar Software>
78 ////////////////////////////////////////////////////////////////////////////////
79 //
80 // Copyright (c) 2008-2009 MStar Semiconductor, Inc.
81 // All rights reserved.
82 //
83 // Unless otherwise stipulated in writing, any and all information contained
84 // herein regardless in any format shall remain the sole proprietary of
85 // MStar Semiconductor Inc. and be kept in strict confidence
86 // ("MStar Confidential Information") by the recipient.
87 // Any unauthorized act including without limitation unauthorized disclosure,
88 // copying, use, reproduction, sale, distribution, modification, disassembling,
89 // reverse engineering and compiling of the contents of MStar Confidential
90 // Information is unlawful and strictly prohibited. MStar hereby reserves the
91 // rights to any and all damages, losses, costs and expenses resulting therefrom.
92 //
93 ////////////////////////////////////////////////////////////////////////////////
94 
95 #ifndef _FW_HVD_IF_H_
96 #define _FW_HVD_IF_H_
97 
98 #include "controller.h"
99 //-------------------------------------------------------------------------------------------------
100 //  Hardware Capability
101 //-------------------------------------------------------------------------------------------------
102 #define HVD_FW_VERSION 0x00001491
103 #define HVD_FW_IF_VERSION 0x00740191
104 
105 //-------------------------------------------------------------------------------------------------
106 //  Macro and Define
107 //-------------------------------------------------------------------------------------------------
108 // TOP
109 //#if (!(defined( MSOS_TYPE_NOS) ||defined( MSOS_TYPE_ECOS) || defined( MSOS_TYPE_LINUX)))
110 #if (!defined( _MS_TYPES_H_)  && (!defined(_DRVHVD_COMMON_H_)))
111 typedef unsigned char               MS_BOOL;                            // 1 byte
112 /// data type unsigned char, data length 1 byte
113 typedef unsigned char               MS_U8;                              // 1 byte
114 /// data type unsigned short, data length 2 byte
115 typedef unsigned short              MS_U16;                             // 2 bytes
116 /// data type unsigned int, data length 4 byte
117 typedef unsigned long               MS_U32;                             // 4 bytes
118 /// data type unsigned int64, data length 8 byte
119 typedef unsigned long long          MS_U64;                             // 8 bytes
120 /// data type signed char, data length 1 byte
121 typedef signed char                 MS_S8;                              // 1 byte
122 /// data type signed short, data length 2 byte
123 typedef signed short                MS_S16;                             // 2 bytes
124 /// data type signed int, data length 4 byte
125 typedef signed long                 MS_S32;                             // 4 bytes
126 /// data type signed int64, data length 8 byte
127 typedef signed long long            MS_S64;                             // 8 bytes
128 #endif
129 
130 // HW settings (Offset base is code buffer address.)
131 #define HVD_SRAM_START                  0x20000000UL
132 
133 #define HVD_DRAM_SIZE    0x40000       // Default HVD DRAM heap size, 256k
134 #define EVD_DRAM_SIZE    0xD0000       // Default EVD DRAM heap size, 832k
135 #define EVD_DV_DRAM_SIZE 0x1A0000      // Default Dolby vision EVD DRAM heap size, 1664k
136 
137 #define TEE_ONE_TASK_SHM_SIZE          0x30000  // 192K
138 
139 #define HVD_SHARE_MEM_ST_SIZE           (0x1000)
140 
141 #ifdef VDEC3
142 #define HVD_DRAM_CMDQ_CMD_SIZE 4
143 #define HVD_DRAM_CMDQ_ARG_SIZE 4
144 #endif
145 
146 #if defined(VDEC3)
147 #define HVD_VBBU_DRAM_ST_SIZE           (0x2000)
148 #define HVD_DISP_FRM_INFO_EXT_ST_SIZE   (0x1D00)
149 #define HVD_CMDQ_DRAM_ST_SIZE           (0x100) //Command Queue must align (CMD + ARG) length, ex. 8 bytes, or will encounter bug when use circular buff
150 #define HVD_DISPCMDQ_DRAM_ST_SIZE   (0x200) //Command Queue must align (CMD + ARG) length, ex. 8 bytes, or will encounter bug when use circular buff
151 #define HVD_PTS_TABLE_ST_SIZE           (0x4000)
152 #else
153 #define HVD_VBBU_DRAM_ST_SIZE           (0x0)
154 #define HVD_CMDQ_DRAM_ST_SIZE           (0x0) //Command Queue must align (CMD + ARG) length, ex. 8 bytes, or will encounter bug when use circular buff
155 #define HVD_DISPCMDQ_DRAM_ST_SIZE   (0x0) //Command Queue must align (CMD + ARG) length, ex. 8 bytes, or will encounter bug when use circular buff
156 #define HVD_PTS_TABLE_ST_SIZE           (0x8000)
157 #endif
158 #define HVD_BBU_DRAM_ST_SIZE            (0x2000)
159 #define HVD_BBU2_DRAM_ST_SIZE           (0x3000)
160 #define HVD_AVC_DTVINFO_SIZE            (0x1000)
161 #define HVD_AVC_INFO608_SIZE            (0x1000)
162 #define HVD_AVC_INFO708_SIZE            (0x4800)
163 #define HVD_AVC_USERDATA_SIZE           (0x2900)
164 
165 #define MIN_4K2K_WIDTH  3800
166 #define MIN_4K2K_HEIGHT 2000
167 
168 #define VDEC_MIUSEL_MASK                  (0x3)
169 #define VDEC_BS_MIUSEL                    (0)
170 #define VDEC_LUMA8_MIUSEL                 (2)
171 #define VDEC_LUMA2_MIUSEL                 (4)
172 #define VDEC_CHROMA8_MIUSEL               (6)
173 #define VDEC_CHROMA2_MIUSEL               (8)
174 #define VDEC_HWBUF_MIUSEL                 (10)
175 #define VDEC_BUF1_MIUSEL                  (12)
176 #define VDEC_BUF2_MIUSEL                  (14)
177 #define VDEC_PPIN_MIUSEL                  (16)
178 
179 #define HVD_DisplayColourVolume_SEI_SIZE  (sizeof(HVD_MasteringDisplayColourVolume))
180 #define HVD_DisplayColourVolume_SEI_NUM   (2)
181 #define HVD_ContentLightLevel_SEI_SIZE    (sizeof(HVD_ContentLightLevelInfo))
182 #define HVD_ContentLightLevel_SEI_NUM     (0x2)
183 
184 #if defined(SUPPORT_NEW_MEM_LAYOUT)
185 
186 #define HVD_SHARE_INFO_DEFAULT_OFFSET   (0x0)
187 
188 #if defined(VDEC3)
189 #define MAX_PTS_TABLE_SIZE              1024
190 #else
191 #define MAX_PTS_TABLE_SIZE              2048 // max (reserve 0xE0000~0xE8000) //1024
192 #endif
193 #define AVOID_PTS_TABLE_OVERFLOW_THRESHOLD   24
194 #define HVD_BYTE_COUNT_MASK             0x1FFFFFFF // hvd fw reg_byte_pos 29bit
195 #if defined(VDEC3)
196 #define HVD_BBU_DRAM_TBL_ENTRY          (0x2000/8) // bbu entry. 64bits(8 bytes) every entry. This variable should consist with "EVD_HVD_BBU_NAL_TABLE_SZIE" in controller.h
197 #else
198 #define HVD_BBU_DRAM_TBL_ENTRY          (0x4000/8) // bbu entry. 64bits(8 bytes) every entry.
199 #endif
200 #define HVD_BBU_DRAM_TBL_ENTRY_TH       (HVD_BBU_DRAM_TBL_ENTRY-4)    // bbu entry. 64bits(8 bytes) every entry.
201 
202 /// HVD_BBU_DRAM_ST_ADDR + 0x2000 for test MVC dual-bbu mode
203 #define HVD_BBU2_DRAM_TBL_ENTRY          (0x1000/8) // bbu entry. 64bits(8 bytes) every entry.
204 #define HVD_BBU2_DRAM_TBL_ENTRY_TH       (HVD_BBU2_DRAM_TBL_ENTRY-4)    // bbu entry. 64bits(8 bytes) every entry.
205 
206 #if 1 /// SUPPORT_MVC
207 #define MVC_BBU_DRAM_ST_SIZE            (0x2000)
208 #define MVC_BBU_DRAM_TBL_ENTRY          (0x1000/8) // bbu entry. 64bits(8 bytes) every entry.
209 #define MVC_BBU_DRAM_TBL_ENTRY_TH       (MVC_BBU_DRAM_TBL_ENTRY-4)    // bbu entry. 64bits(8 bytes) every entry.
210 
211 #define MVC_BBU2_DRAM_TBL_ENTRY         (0x1000/8) // bbu entry. 64bits(8 bytes) every entry.
212 #define MVC_BBU2_DRAM_TBL_ENTRY_TH      (MVC_BBU2_DRAM_TBL_ENTRY-4)    // bbu entry. 64bits(8 bytes) every entry.
213 #endif // SUPPORT_MVC
214 
215 #if defined(VDEC3)
216 #define RVD_BBU_DRAM_TBL_ENTRY          (0x2000/8) // bbu entry. 64bits(8 bytes) every entry. This variable should consist with "EVD_HVD_BBU_NAL_TABLE_SZIE" in controller.h
217 #else
218 #define RVD_BBU_DRAM_TBL_ENTRY          (0x4000/8) // bbu entry. 64bits(8 bytes) every entry.
219 #endif
220 #define RVD_BBU_DRAM_TBL_ENTRY_TH       (RVD_BBU_DRAM_TBL_ENTRY-4)    // bbu entry. 64bits(8 bytes) every entry.
221 
222 #define VP8_BBU_DRAM_ST_SIZE            (0x2000)
223 #define VP8_BBU_DRAM_TBL_ENTRY          (0x1000/8) // bbu entry. 64bits(8 bytes) every entry.
224 #define VP8_BBU_DRAM_TBL_ENTRY_TH       (VP8_BBU_DRAM_TBL_ENTRY-4)    // bbu entry. 64bits(8 bytes) every entry.
225 
226 #if defined(SUPPORT_EVD) && (SUPPORT_EVD==1)
227 #define HVD_SHARE_MEM_ST_OFFSET         0xB0000
228 #define VSYNC_BRIGE_SHM_ADDR            0xCFA00
229 #define VSYNC_BRIGE_EXT_SHM_ADDR        0xD0000
230 #else
231 #define HVD_SHARE_MEM_ST_OFFSET         0xA0000
232 #define VSYNC_BRIGE_SHM_ADDR            0xBFA00
233 #define VSYNC_BRIGE_EXT_SHM_ADDR        0xC0000
234 #endif
235 
236 #define HVD_DYNAMIC_SCALING_SIZE         0x1F00
237 #define HVD_DYNAMIC_SCALING_SIZE_3K       0xC00 // allocate 6k.   actually use: 16 align => 3k
238 #define HVD_DYNAMIC_SCALING_SIZE_6K      0x1800 // allocate 6k.   actually use: 32 align => 6k
239 #define HVD_DYNAMIC_SCALING_SIZE_8K      0x1F00
240 #define HVD_DYNAMIC_SCALING_DEPTH          0x10
241 #define HVD_DYNAMIC_SCALING_3D_DEPTH       0x18 /// 3D Dynamic scaling use 24.
242 #define HVD_SCALER_INFO_SIZE              0x100
243 
244 #define HVD_AVC_FRAME_PACKING_SEI_SIZE  0x100
245 #define HVD_AVC_FRAME_PACKING_SEI_NUM   2
246 
247 //DBG
248 #define HVD_DBG_DUMP_SIZE               0x06500
249 #define HVD_DUMMY_WRITE_MAX_SIZE        0x200
250 
251 #define VSYNC_BRIGE_SHM_MAX_SIZE        0x600
252 #define MAX_VSYNC_BRIDGE_DISPQ_NUM      8
253 
254 #define HVD_DISP_QUEUE_MAX_SIZE         42
255 // AVC
256 #define HVD_FW_AVC_DUMMY_FIFO           256     // bytes
257 #define HVD_FW_AVC_MAX_DECODE_TICK      100000  // tick ???
258 #define HVD_FW_AVC_MAX_VIDEO_DELAY      1000    // ms ; based on ???
259 #define HVD_FW_AVC_ES_MIN_TSP_DATA_SIZE 0x100
260 #define HVD_FW_AVC_ES_MIN_TSP_DATA_SIZE2 0x1800
261 #define HVD_FW_BROKEN_BY_US_MIN_DATA_SIZE    0x1800
262 
263 #define HVD_FW_AVC_ES_UNDER_THRESHOLD   0x800   // 2048
264 #define HVD_FW_AVC_ES_OVER_THRESHOLD    0x40000 // 256*1024
265 
266 // User CC
267 #define USER_CC_DATA_SIZE               38
268 #define USER_CC_IDX_SIZE                12
269 
270 // AVS
271 #define HVD_FW_AVS_DUMMY_FIFO           2048 //BYTES
272 
273 // RM
274 #define HVD_FW_RM_DUMMY_FIFO            256  // ??
275 #define HVD_RM_INIT_PICTURE_SIZE_NUMBER 8
276 
277 #define EXT_CC_INFO_LENGTH            16
278 #define EXT_608_CC_PACKET_LENGTH     16
279 #define EXT_608_CC_DATA_ALIGN   EXT_608_CC_PACKET_LENGTH
280 #define EXT_708_CC_PACKET_LENGTH     128
281 #define EXT_708_CC_DATA_ALIGN   EXT_708_CC_PACKET_LENGTH
282 
283 #else // if not defined (SUPPORT_NEW_MEM_LAYOUT)
284 
285 #define HVD_SHARE_INFO_DEFAULT_OFFSET  0xE0000
286 #define HVD_OLD_LAYOUT_SHARE_MEM_BIAS   0xD000
287 
288 /* New Memory Layout */
289 #if 1
290 #ifdef VDEC3
291 #define INPUT_QUEUE_OFFSET              0xE0000
292 #define HVD_PTS_TABLE_ST_OFFSET         0xE4000
293 #define MAX_PTS_TABLE_SIZE              1024
294 #else
295 #define HVD_PTS_TABLE_ST_OFFSET         0xE0000
296 #define MAX_PTS_TABLE_SIZE              2048 // max (reserve 0xE0000~0xE8000) //1024
297 #endif
298 #define AVOID_PTS_TABLE_OVERFLOW_THRESHOLD   24
299 #define HVD_BYTE_COUNT_MASK             0x1FFFFFFF // hvd fw reg_byte_pos 29bit
300 
301 #define HVD_BBU_DRAM_ST_ADDR            0xE8000    // bbu table from dram starting address
302 #define HVD_BBU_DRAM_TBL_ENTRY          (0x4000/8) // bbu entry. 64bits(8 bytes) every entry.
303 #define HVD_BBU_DRAM_TBL_ENTRY_TH       (HVD_BBU_DRAM_TBL_ENTRY-4)    // bbu entry. 64bits(8 bytes) every entry.
304 
305 /// HVD_BBU_DRAM_ST_ADDR + 0x2000 for test MVC dual-bbu mode
306 #define HVD_BBU2_DRAM_ST_ADDR            (HVD_BBU_DRAM_ST_ADDR + 0x2000) //0xEA000    // bbu table from dram starting address
307 #define HVD_BBU2_DRAM_TBL_ENTRY          (0x1000/8) // bbu entry. 64bits(8 bytes) every entry.
308 #define HVD_BBU2_DRAM_TBL_ENTRY_TH       (HVD_BBU2_DRAM_TBL_ENTRY-4)    // bbu entry. 64bits(8 bytes) every entry.
309 
310 #if 1 /// SUPPORT_MVC
311 #define MVC_BBU_DRAM_ST_ADDR            0xE8000    // bbu table from dram starting address
312 #define MVC_BBU_DRAM_TBL_ENTRY          (0x1000/8) // bbu entry. 64bits(8 bytes) every entry.
313 #define MVC_BBU_DRAM_TBL_ENTRY_TH       (MVC_BBU_DRAM_TBL_ENTRY-4)    // bbu entry. 64bits(8 bytes) every entry.
314 
315 #define MVC_BBU2_DRAM_ST_ADDR            (MVC_BBU_DRAM_ST_ADDR + 0x2000)    // bbu table from dram starting address
316 #define MVC_BBU2_DRAM_TBL_ENTRY          (0x1000/8) // bbu entry. 64bits(8 bytes) every entry.
317 #define MVC_BBU2_DRAM_TBL_ENTRY_TH       (MVC_BBU2_DRAM_TBL_ENTRY-4)    // bbu entry. 64bits(8 bytes) every entry.
318 #endif // SUPPORT_MVC
319 
320 #define RVD_BBU_DRAM_TBL_ENTRY          (0x4000/8) // bbu entry. 64bits(8 bytes) every entry.
321 #define RVD_BBU_DRAM_TBL_ENTRY_TH       (RVD_BBU_DRAM_TBL_ENTRY-4)    // bbu entry. 64bits(8 bytes) every entry.
322 #define VP8_BBU_DRAM_ST_ADDR_BS3        HVD_BBU_DRAM_ST_ADDR    // bbu table from dram starting address
323 #define VP8_BBU_DRAM_ST_ADDR_BS4        (HVD_BBU_DRAM_ST_ADDR + 0x2000)   // bbu table from dram starting address
324 #define VP8_BBU_DRAM_TBL_ENTRY          (0x1000/8) // bbu entry. 64bits(8 bytes) every entry.
325 #define VP8_BBU_DRAM_TBL_ENTRY_TH       (VP8_BBU_DRAM_TBL_ENTRY-4)    // bbu entry. 64bits(8 bytes) every entry.
326 
327 #define HVD_SHARE_MEM_ST_OFFSET         0xED000
328 
329 #define HVD_DYNAMIC_SCALING_ADDR        0xEE000
330 #define HVD_DYNAMIC_SCALING_SIZE         0x1F00
331 #define HVD_DYNAMIC_SCALING_SIZE_3K       0xC00 // allocate 6k.   actually use: 16 align => 3k
332 #define HVD_DYNAMIC_SCALING_SIZE_6K      0x1800 // allocate 6k.   actually use: 32 align => 6k
333 #define HVD_DYNAMIC_SCALING_SIZE_8K      0x1F00
334 #define HVD_DYNAMIC_SCALING_DEPTH          0x10
335 #define HVD_DYNAMIC_SCALING_3D_DEPTH       0x18 /// 3D Dynamic scaling use 24.
336 #define HVD_SCALER_INFO_ADDR            0xEFF00
337 #define HVD_SCALER_INFO_SIZE              0x100
338 
339 #define HVD_AVC_DTVINFO                 0xF0000
340 #define HVD_AVC_INFO608                 0xF1000
341 #define HVD_AVC_INFO708                 0xF2000
342 #define HVD_AVC_USERDATA                0xF6800
343 #define HVD_AVC_FRAME_PACKING_SEI       0xF9100
344 #define HVD_AVC_FRAME_PACKING_SEI_SIZE  0x100
345 #define HVD_AVC_FRAME_PACKING_SEI_NUM   2
346 
347 //DBG
348 #define HVD_DBG_DUMP_ADDR               0xF9300
349 #define HVD_DBG_DUMP_SIZE               0x06500
350 
351 #define HVD_DUMMY_WRITE_ADDR            0xFF800
352 #define HVD_DUMMY_WRITE_MAX_SIZE        0x200
353 
354 #define VSYNC_BRIGE_SHM_ADDR            0xFFA00
355 #define VSYNC_BRIGE_SHM_MAX_SIZE        0x600
356 #define MAX_VSYNC_BRIDGE_DISPQ_NUM      8
357 
358 #define HVD_DISP_QUEUE_MAX_SIZE         42
359 // AVC
360 #define HVD_FW_AVC_DUMMY_FIFO           256     // bytes
361 #define HVD_FW_AVC_MAX_DECODE_TICK      100000  // tick ???
362 #define HVD_FW_AVC_MAX_VIDEO_DELAY      1000    // ms ; based on ???
363 #define HVD_FW_AVC_ES_MIN_TSP_DATA_SIZE 0x100
364 #define HVD_FW_AVC_ES_MIN_TSP_DATA_SIZE2 0x1800
365 #define HVD_FW_BROKEN_BY_US_MIN_DATA_SIZE    0x1800
366 
367 #define HVD_FW_AVC_ES_UNDER_THRESHOLD   0x800   // 2048
368 #define HVD_FW_AVC_ES_OVER_THRESHOLD    0x12C00 // 75*1024
369 
370 // User CC
371 #define USER_CC_DATA_SIZE               38
372 #define USER_CC_IDX_SIZE                12
373 
374 // AVS
375 #define HVD_FW_AVS_DUMMY_FIFO           2048 //BYTES
376 
377 // RM
378 #define HVD_FW_RM_DUMMY_FIFO            256  // ??
379 #define HVD_RM_INIT_PICTURE_SIZE_NUMBER 8
380 
381 
382 #define EXT_CC_INFO_LENGTH            16
383 #define EXT_608_CC_PACKET_LENGTH     16
384 #define EXT_608_CC_DATA_ALIGN   EXT_608_CC_PACKET_LENGTH
385 #define EXT_708_CC_PACKET_LENGTH     128
386 #define EXT_708_CC_DATA_ALIGN   EXT_708_CC_PACKET_LENGTH
387 
388 #endif
389 #endif // #if deifned(SUPPORT_NEW_MEM_LAYOUT)
390 
391 /* Old Memory Layout */
392 #if 0
393 #define HVD_PTS_TABLE_ST_OFFSET         0x70000
394 #define MAX_PTS_TABLE_SIZE              2048 // max (reserve 0x70000~0x78000) //1024
395 #define HVD_BYTE_COUNT_MASK             0x1FFFFFFF // hvd fw reg_byte_pos 29bit
396 
397 #define HVD_BBU_DRAM_ST_ADDR            0x78000    // bbu table from dram starting address
398 #define HVD_BBU_DRAM_TBL_ENTRY          (0x1000/8) // bbu entry. 64bits(8 bytes) every entry.
399 #define HVD_BBU_DRAM_TBL_ENTRY_TH       (HVD_BBU_DRAM_TBL_ENTRY-4)    // bbu entry. 64bits(8 bytes) every entry.
400 #if 1 /// SUPPORT_MVC
401 /// HVD_BBU_DRAM_ST_ADDR + 0x2000 for test MVC dual-bbu mode
402 #define HVD_BBU2_DRAM_ST_ADDR            HVD_BBU_DRAM_ST_ADDR + 0x2000 //0x7A000    // bbu table from dram starting address
403 #define HVD_BBU2_DRAM_TBL_ENTRY          (0x1000/8) // bbu entry. 64bits(8 bytes) every entry.
404 #define HVD_BBU2_DRAM_TBL_ENTRY_TH       (HVD_BBU2_DRAM_TBL_ENTRY-4)    // bbu entry. 64bits(8 bytes) every entry.
405 #endif // SUPPORT_MVC
406 #define RVD_BBU_DRAM_TBL_ENTRY          (0x4000/8) // bbu entry. 64bits(8 bytes) every entry.
407 #define RVD_BBU_DRAM_TBL_ENTRY_TH       (RVD_BBU_DRAM_TBL_ENTRY-4)    // bbu entry. 64bits(8 bytes) every entry.
408 #define VP8_BBU_DRAM_ST_ADDR_BS3        HVD_BBU_DRAM_ST_ADDR    // bbu table from dram starting address
409 #define VP8_BBU_DRAM_ST_ADDR_BS4        (HVD_BBU_DRAM_ST_ADDR + 0x2000)   // bbu table from dram starting address
410 #define VP8_BBU_DRAM_TBL_ENTRY          (0x1000/8) // bbu entry. 64bits(8 bytes) every entry.
411 #define VP8_BBU_DRAM_TBL_ENTRY_TH       (HVD_BBU_DRAM_TBL_ENTRY-4)    // bbu entry. 64bits(8 bytes) every entry.
412 
413 #define HVD_SHARE_MEM_ST_OFFSET         0x7D000
414 
415 #define HVD_DYNAMIC_SCALING_ADDR        0x7E000
416 #define HVD_DYNAMIC_SCALING_SIZE         0x1F00
417 #define HVD_DYNAMIC_SCALING_SIZE_3K       0xC00 // allocate 6k.   actually use: 16 align => 3k
418 #define HVD_DYNAMIC_SCALING_SIZE_6K      0x1800 // allocate 6k.   actually use: 32 align => 6k
419 #define HVD_DYNAMIC_SCALING_SIZE_8K      0x1F00
420 #define HVD_DYNAMIC_SCALING_DEPTH          0x10
421 #define HVD_SCALER_INFO_ADDR            0x7FF00
422 #define HVD_SCALER_INFO_SIZE              0x100
423 
424 #define HVD_AVC_DTVINFO                 0x80000
425 #define HVD_AVC_INFO608                 0x81000
426 #define HVD_AVC_INFO708                 0x82000
427 #define HVD_AVC_USERDATA                0x86800
428 #define HVD_AVC_FRAME_PACKING_SEI       0x88000
429 #define HVD_AVC_FRAME_PACKING_SEI_SIZE  0x100
430 #define HVD_AVC_FRAME_PACKING_SEI_NUM   2
431 
432 #define HVD_DUMMY_WRITE_ADDR            0x8FE00
433 #define HVD_DUMMY_WRITE_MAX_SIZE        0x200
434 
435 #define HVD_DBG_DUMP_ADDR               0xD0000
436 #define HVD_DBG_DUMP_SIZE               0x20000
437 
438 #define HVD_DISP_QUEUE_MAX_SIZE         36
439 // AVC
440 #define HVD_FW_AVC_DUMMY_FIFO           256     // bytes
441 #define HVD_FW_AVC_MAX_DECODE_TICK      100000  // tick ???
442 #define HVD_FW_AVC_MAX_VIDEO_DELAY      1000    // ms ; based on ???
443 #define HVD_FW_AVC_ES_MIN_TSP_DATA_SIZE 0x100
444 #define HVD_FW_AVC_ES_UNDER_THRESHOLD   0x800   // 2048
445 #define HVD_FW_AVC_ES_OVER_THRESHOLD    0x12C00 // 75*1024
446 
447 // User CC
448 #define USER_CC_DATA_SIZE               24
449 #define USER_CC_IDX_SIZE                12
450 
451 // AVS
452 #define HVD_FW_AVS_DUMMY_FIFO           2048 //BYTES
453 
454 // RM
455 #define HVD_FW_RM_DUMMY_FIFO            256  // ??
456 #define HVD_RM_INIT_PICTURE_SIZE_NUMBER 8
457 #endif
458 
459 // Debug
460 #define HVD_FW_AVS_OUTPUT_INFO_ADDR     0x20001F00UL
461 #define HVD_FW_AVC_OUTPUT_INFO_ADDR     0x20001F00UL
462 
463 #define HVD_HW_PREFETCH_SIZE            128
464 #define HVD_DUMMY_PACKET_SIZE           (HVD_HW_PREFETCH_SIZE << 1)
465 #define HVD_DUMMY_PACKET_DATA           0x0
466 #define HVD_DUMMY_PACKET_OFFSET         0x0
467 
468 #define PRESET_ONE_PENDING_BUFFER       (1 << 0)  /// For AVC, one pending buffer mode, reduce from two to one
469 #define PRESET_IAP_GN_SHARE_BW_MODE     (1 << 1)  /// For AVC 4K2K, move IAP GN buffer to another miu to share BW mode  //johnny.ko
470 #define PRESET_DUMMY_PACKET_READY       (1 << 2)  /// For checking HW BBU status after filling nal table
471 #define PRESET_4K2K_CHECK               (1 << 3)  /// For checking 4k2k need support or not
472 #define PRESET_FORCE_START_NON_I_SLICE  (1 << 4)  /// For force start decode frame when 1st slice is not I slice.
473 #define PRESET_CONNECT_DISPLAY_PATH     (1 << 5)  ///
474 #define PRESET_CAL_FRAMERATE             (1 << 6)  ///For HVD,calculate framerate
475 
476 #define MFCODEC_INFO_UNCOMPRESS_OFFSET  28
477 #define MFCODEC_INFO_MIU_SELECT_OFFSET  24
478 #define MFCODEC_INFO_PITCH_OFFSET       16
479 
480 // For Git Changes
481 #define GIT_TIMESTAMP 1472564636
482 
483 typedef enum
484 {
485     E_HVD_IQMEM_INIT_NONE = 0,
486     E_HVD_IQMEM_INIT_LOADING,   //HK -> FW
487     E_HVD_IQMEM_INIT_LOADED,    //FW -> HK
488     E_HVD_IQMEM_INIT_FINISH     //HK -> FW
489 
490 }HVD_IQMEM_INIT_STATUS;
491 
492 
493 
494 typedef enum
495 {
496     E_HVD_FLUSH_NONE = 0,
497     E_HVD_FLUSH_RUNNING,     //HK -> FW
498     E_HVD_FLUSH_DONE         //FW -> HK
499 
500 }HVD_FLUSH_STATUS;
501 
502 typedef enum
503 {
504     E_HVD_ISR_EVENT_NONE = 0,                        ///< disable ISR
505     E_HVD_ISR_EVENT_DISP_ONE = BIT(0),               ///< HVD display one frame on screen.
506     E_HVD_ISR_EVENT_DISP_REPEAT = BIT(1),            ///< The current displayed frame is repeated frame.
507     E_HVD_ISR_EVENT_DISP_WITH_CC = BIT(2),           ///< Current displayed frame should be displayed with user data.
508     E_HVD_ISR_EVENT_DISP_FIRST_FRM = BIT(3),         ///< HVD display first frame on screen.
509 
510     E_HVD_ISR_EVENT_DEC_CMA_ACTION = BIT(7),         ///< HVD CMA allocate/release memory ISR
511     E_HVD_ISR_EVENT_DEC_ONE = BIT(8),                ///< HVD decoded one frame done.
512     E_HVD_ISR_EVENT_DEC_I = BIT(9),                  ///< HVD decoded one I frame done.
513     E_HVD_ISR_EVENT_DEC_HW_ERR = BIT(10),            ///< HVD HW found decode error.
514     E_HVD_ISR_EVENT_DEC_CC_FOUND = BIT(11),          ///< HVD found one user data with decoded frame(with display order).
515     E_HVD_ISR_EVENT_DEC_DISP_INFO_CHANGE = BIT(12),  ///< HVD found display information change.
516     E_HVD_ISR_EVENT_DEC_DATA_ERR = BIT(13),          ///< HVD HW found decode error.
517     E_HVD_ISR_EVENT_DEC_FIRST_FRM = BIT(14),         ///< HVD decode first frame.
518     E_HVD_ISR_EVENT_DEC_SEQ_HDR_FOUND = BIT(15),     ///< HVD found sequence header.
519 } HVD_ISR_Event_Type;
520 
521 typedef enum
522 {
523     E_HVD_USER_DATA_MODE_DVB_NORMAL                 = 0x00,
524     E_HVD_USER_DATA_MODE_DIRECTTV_CC                = 0x01,
525     E_HVD_USER_DATA_MODE_FRM_PACKING_ARRANGEMENT    = 0x02,
526     E_HVD_USER_DATA_MODE_ATSC_CC_RAW                = 0x04,
527     E_HVD_USER_DATA_MODE_CC_UNTIL_START_CODE        = 0x08
528 } HVD_USER_DATA_MODE;
529 
530 
531 typedef enum
532 {
533     E_HVD_DRV_AUTO_BBU_MODE = 0x00,
534     E_HVD_FW_AUTO_BBU_MODE  = 0x01,
535 } HVD_BBU_MODE;
536 
537 typedef enum
538 {
539     E_HVD_FW_STATUS_NONE = 0,               ///< NONE Flag
540     E_HVD_FW_STATUS_SEEK_TO_I = BIT(0),     ///< Seek to I slice/frame flag
541 } HVD_FW_STATUS_FLAG;
542 
543 typedef enum
544 {
545     //sharemem u32CodecMiscInfo bit assignment
546     E_VIDEO_FULL_RANGE = BIT(0),
547 } CODEC_MISC_INFO;
548 
549 typedef enum
550 {
551     E_DIVX_PROFILE_NONE = 0,
552     E_DIVX_PROFILE_DIVX_PLUS,
553     E_DIVX_PROFILE_DIVX_HEVC
554 } DIVX_PROFILE;
555 
556 /*
557 //interupt flag  , value is in VPU RISC MBOX 1 ( for LG GP DTV only)
558 #define HVD_ISR_USER_DATA               (1 << 0)
559 #define HVD_ISR_DATA_ERR                (1 << 1)
560 #define HVD_ISR_PIC_DEC_ERR             (1 << 2)
561 #define HVD_ISR_DEC_OVER                (1 << 3)
562 #define HVD_ISR_DEC_UNDER               (1 << 4)
563 #define HVD_ISR_DEC_I                   (1 << 5)
564 #define HVD_ISR_DIS_READY               (1 << 6)
565 #define HVD_ISR_SEQ_INFO                (1 << 7)
566 #define HVD_ISR_VIDEO_SKIP              (1 << 8)
567 #define HVD_ISR_VIDEO_REPEAT            (1 << 9)
568 #define HVD_ISR_VIDEO_FREERUN           (1 << 10)
569 #define HVD_ISR_INVALID_STREAM          (1 << 11)
570 #define HVD_ISR_VIDEO_AVSYNC_DONE       (1 << 12)
571 #define HVD_ISR_VIDEO_VSYNC             (1 << 31)
572 */
573 
574 //-------------------------------------------------------------------------------------------------
575 //  Type and Structure
576 //-------------------------------------------------------------------------------------------------
577 // User CC
578 #define USR_BUF_SIZE (256)
579 
580 typedef struct _DTV_BUF_type
581 {
582     MS_U8 type;                 // 0xCC:continue, 0:P 1:B 2:I
583     MS_U8 len;                  // size byte of buf
584     MS_U8 active;               // 0:free 1:already dma out or not assign 2:assign
585     MS_U8 pic_struct;           // pic_struct, Reserved when 0, Top Field when 1, Bottom Field when 2, and Frame picture when 3.
586     MS_U32 pts;
587     MS_U16 u16TempRefCnt;       // Temp Ref Count for UserData ,Value that increases by 1 for each frame (like time stamp)
588     MS_U16 u16Res;              // Reserved
589     MS_U32 u32Res;              // Reserved
590     MS_U8 buf[USR_BUF_SIZE];       //user data
591 } DTV_BUF_type;                 //size must <= 276, currently only use 272
592 
593 #define HVD_FRM_PACKIMG_PAYLOAD_SIZE ((HVD_AVC_FRAME_PACKING_SEI_SIZE/HVD_AVC_FRAME_PACKING_SEI_NUM)-20)  /// 20: HVD_Frame_packing_SEI size expect payload data
594 
595 typedef struct
596 {
597     MS_BOOL bUsed;
598     MS_BOOL bvaild;
599     MS_U8   u8Frm_packing_arr_cnl_flag;         // u(1)
600     MS_U8   u8Frm_packing_arr_type;             // u(7)
601     MS_U8   u8content_interpretation_type;      // u(6)
602     MS_U8   u1Quincunx_sampling_flag:1;         // u(1)
603     MS_U8   u1Spatial_flipping_flag:1;          // u(1)
604     MS_U8   u1Frame0_flipping_flag:1;           // u(1)
605     MS_U8   u1Field_views_flag:1;               // u(1)
606     MS_U8   u1Current_frame_is_frame0_flag:1;   // u(1)
607     MS_U8   u1Frame0_self_contained_flag:1;     // u(1)
608     MS_U8   u1Frame1_self_contained_flag:1;     // u(1)
609     MS_U8   u1Reserved1:1;                      // u(1)
610     MS_U8   u4Frame0_grid_position_x:4;         // u(4)
611     MS_U8   u4Frame0_grid_position_y:4;         // u(4)
612     MS_U8   u4Frame1_grid_position_x:4;         // u(4)
613     MS_U8   u4Frame1_grid_position_y:4;         // u(4)
614     MS_U16  u16CropRight;
615     MS_U16  u16CropLeft;
616     MS_U16  u16CropBottom;
617     MS_U16  u16CropTop;
618     MS_U8   u8payload_len;
619     MS_U8   u8WaitSPS;
620     MS_U8   u8Reserved[2];
621     MS_U8   u8payload[HVD_FRM_PACKIMG_PAYLOAD_SIZE];
622 } HVD_Frame_packing_SEI;
623 
624 typedef struct
625 {
626     MS_BOOL bUsed;
627     MS_BOOL colourVolumeSEIEnabled;
628     MS_U32 maxLuminance;
629     MS_U32 minLuminance;
630     MS_U16 primaries[3][2];
631     MS_U16 whitePoint[2];
632 } HVD_MasteringDisplayColourVolume;
633 
634 typedef struct
635 {
636     MS_BOOL bUsed;
637     MS_BOOL ContentLightLevelEnabled;
638     MS_U16  maxContentLightLevel;
639     MS_U16  maxPicAverageLightLevel;
640 } HVD_ContentLightLevelInfo;
641 
642 // stuct
643 typedef struct
644 {
645     MS_U16 u16HorSize;
646     MS_U16 u16VerSize;
647     MS_U32 u32FrameRate;                // Unit: ms
648     MS_U8 u8AspectRate;                 // aspect ration ID; for AVC only
649     MS_U8 u8Interlace;
650     MS_U8 u8AFD;
651     //MS_U8 u8par_width;
652     //MS_U8 u8par_height;
653     MS_U8 bChroma_idc_Mono;             // 1: mono 0: colorful, not mono ; AVC only currently. AVS,RM??
654     MS_U16 u16DispWidth;                // Display width or aspect ratio width
655     MS_U16 u16DispHeight;               // Display height or aspect ratio height
656     MS_U16 u16CropRight;
657     MS_U16 u16CropLeft;
658     MS_U16 u16CropBottom;
659     MS_U16 u16CropTop;
660     MS_U16 u16Pitch;                    // ???
661     MS_U8  u8ColourPrimaries;           // Color Primaries in VUI
662     //****************************
663     MS_U8 u8IsOriginInterlace;          // Is Original Interlace mode
664     //******************************
665     // MS_U16 u16PTSInterval;           // ??? not fill
666     // MS_U8 u8MPEG1;                   // may be removed
667     // MS_U8 u8PlayMode;                // ??? not fill
668     // MS_U8 u8FrcMode;                 // may be removed
669 } HVD_Display_Info;                     //  bytes
670 
671 typedef struct
672 {
673     MS_U8 bIsShowErrFrm;
674     MS_U8 bIsRepeatLastField;
675     MS_U8 bIsErrConceal;
676     MS_U8 bIsSyncOn;
677     MS_U8 bIsPlaybackFinish;
678     MS_U8 u8SyncType;                   // HVD_Sync_Tbl_Type
679     MS_U8 u8SkipMode;                   // HVD_Skip_Decode_Type
680     MS_U8 u8DropMode;                   // HVD_Drop_Disp_Type
681     MS_S8 s8DisplaySpeed;               // HVD_Disp_Speed
682     MS_U8 u8FrcMode;                    // HVD_FRC_Mode
683     MS_U8 bIsBlueScreen;
684     MS_U8 bIsFreezeImg;
685     MS_U8 bShowOneField;
686     //*****************************
687     MS_U8 u8reserve8_1;
688     MS_U16 u16reserve16_1;
689     //*****************************
690 } HVD_Mode_Status;                      // 12 bytes
691 
692 typedef struct
693 {
694     MS_U16 u16Width;
695     MS_U16 u16Height;
696 } HVD_PictureSize;
697 
698 typedef struct
699 {
700     MS_U32 u32LumaAddr;                 ///< The start offset of luma data. Unit: byte.
701     MS_U32 u32ChromaAddr;               ///< The start offset of chroma data. Unit: byte.
702     MS_U32 u32PpInLumaAddr;             ///< Luma address (For post-process use)
703     MS_U32 u32PpInChromaAddr;           ///< Chroma address (For post-process use)
704     MS_U32 u32TimeStamp;                ///< Time stamp(DTS, PTS) of current displayed frame. Unit: 90khz.
705     MS_U32 u32ID_L;                     ///< low part of ID number decided by MDrv_HVD_PushQueue().
706     MS_U32 u32ID_H;                     ///< high part of ID number decided by MDrv_HVD_PushQueue().
707     MS_U8  u8FrmType;                   ///< HVD_Picture_Type, picture type: I, P, B frame
708     MS_U8  u8FieldType;                 ///< HVD_Field_Type, none, top , bottom, both field
709     MS_U16 u16Pitch;
710     MS_U16 u16Width;
711     MS_U16 u16Height;
712     MS_U32 u32Status;                   ///< 0:None, 1:Init, 2:View, 3:Disp, 4:Free
713     MS_U32 u32PrivateData;              ///[STB]only for AVC
714     MS_U32 u32LumaAddr_2bit;            ///< The start offset of 2bit luma data. Unit: byte.
715     MS_U32 u32ChromaAddr_2bit;          ///< The start offset of 2bit chroma data. Unit: byte.
716     MS_U16 u16Pitch_2bit;
717     MS_U8  u8LumaBitdepth;
718     MS_U8  u8ChromaBitdepth;
719     MS_U8  u2Luma0Miu:2;
720     MS_U8  u2Luma1Miu:2;
721     MS_U8  u2Chroma0Miu:2;
722     MS_U8  u2Chroma1Miu:2;
723     MS_U8  reserved8[3];
724 } HVD_Frm_Information;
725 
726 typedef enum
727 {
728     HVD_FRM_INFO_EXT_TYPE_10BIT,           // 2bits in 10 bits case
729     HVD_FRM_INFO_EXT_TYPE_INTERLACE,       // 2nd field 8bits in interlace case
730     HVD_FRM_INFO_EXT_TYPE_10BIT_INTERLACE, // 2nd field 2bits in 10bits interlace case
731     HVD_FRM_INFO_EXT_TYPE_MFCBITLEN,       // bit length in MFC case
732     HVD_FRM_INFO_EXT_TYPE_MAX,
733 } HVD_FRM_INFO_EXT_TYPE;
734 
735 typedef enum
736 {
737     E_DISP_PATH_DEFAULT = 0,
738     E_DISP_PATH_DYNMC_DISCONNECT,
739     E_DISP_PATH_DYNMC_HANDLING,
740     E_DISP_PATH_DYNMC_CONNECTTED
741 
742 }DISP_PATH_CONNECT_STATUS;
743 /****************************************************************************************
744                                   MFCodecInfo
745           +---------------------------------------------------------------+
746           |Uncompress|BitLen Miu Select|  Pitch  |   MFCodec Version      |
747           |   4 bits |      4 bits     |  8 bits |       16 bits          |
748           +---------------------------------------------------------------+
749 ***************************************************************************************/
750 typedef struct
751 {
752     MS_U32 u32LumaAddrExt[HVD_FRM_INFO_EXT_TYPE_MAX];
753     MS_U32 u32ChromaAddrExt[HVD_FRM_INFO_EXT_TYPE_MAX];
754     MS_U32 MFCodecInfo;
755     // SEI start //
756     MS_U32 maxLuminance;
757     MS_U32 minLuminance;
758     MS_U16 primaries[3][2];
759     MS_U16 whitePoint[2];
760     // SEI end //
761     MS_U8 Frm_Info_Ext_avail; ///bit[2]: DV_Enabled, bit[1]: SEI_Enabled,  bit[0]: colur_description_present_flag
762     // colour_description start //
763     MS_U8 colour_primaries;                            // u(8)
764     MS_U8 transfer_characteristics;                    // u(8)
765     MS_U8 matrix_coefficients;                         // u(8)
766     ////Dolby_Vision////////////
767     MS_U8 u8DVMode; // bit[0:1] 0: Disable 1:Single layer 2: Dual layer, bit[2] 0:Base Layer 1:Enhance Layer
768     MS_U32 u32DVMetadataAddr;
769     MS_U32 u32DVDMSize;
770     MS_U32 u32DVCompSize;
771 
772     //qos
773     MS_S16 s16MinQp;
774     MS_S16 s16AvgQp;
775     MS_S16 s16MaxQp;
776     MS_S16 s16MinMV;
777     MS_S16 s16AvgMV;
778     MS_S16 s16MaxMV;
779     MS_U32 u32SkipMV;
780     MS_U32 u32NonSkipMV;
781 } HVD_Frm_Information_EXT_Entry;
782 
783 typedef struct
784 {
785     HVD_Frm_Information_EXT_Entry stEntry[HVD_DISP_QUEUE_MAX_SIZE];
786 } HVD_Frm_Information_EXT;
787 
788 typedef struct
789 {
790     MS_BOOL aspect_ratio_info_present_flag;            // u(1)
791     MS_U8 aspect_ratio_idc;                            // u(8)
792     MS_U16 sar_width;                                  // u(16)
793     MS_U16 sar_height;                                 // u(16)
794     MS_BOOL overscan_info_present_flag;                // u(1)
795     MS_BOOL overscan_appropriate_flag;                 // u(1)
796     MS_BOOL video_signal_type_present_flag;            // u(1)
797     MS_U8 video_format;                                // u(3)
798     MS_BOOL video_full_range_flag;                     // u(1)
799     MS_BOOL colour_description_present_flag;           // u(1)
800     MS_U8 colour_primaries;                            // u(8)
801     MS_U8 transfer_characteristics;                    // u(8)
802     MS_U8 matrix_coefficients;                         // u(8)
803     MS_BOOL chroma_location_info_present_flag;         // u(1)
804     MS_U8 chroma_sample_loc_type_top_field;            // ue(v) 0~5
805     MS_U8 chroma_sample_loc_type_bottom_field;         // ue(v) 0~5
806     MS_BOOL timing_info_present_flag;                  // u(1)
807     MS_BOOL fixed_frame_rate_flag;                     // u(1)
808     MS_U32 num_units_in_tick;                          // u(32)
809     MS_U32 time_scale;                                 // u(32)
810 } HVD_AVC_VUI_DISP_INFO;
811 
812 typedef struct
813 {
814     MS_U32 u32FrmrateUpBound;       //Framerate filter upper bound
815     MS_U32 u32FrmrateLowBound;      //Framerate filter lower bound
816     MS_U32 u32MvopUpBound;          //mvop filter upper bound
817     MS_U32 u32MvopLowBound;         //mvop filter lower bound
818 } HVD_DISP_THRESHOLD;
819 
820 typedef struct tDynmcDispPath
821 {
822     MS_U8 u8Connect; //TRUE: connect , FALSE: disconnect
823     /*DISPLAY_PATH*/
824     MS_U8 u8DispPath;
825     /*DISP_PATH_CONNECT_STATUS*/
826     MS_U8 u8ConnectStatus;
827 } DynmcDispPath;
828 
829 typedef struct
830 {
831     // switch
832     MS_U32 u32CodecType;                //0x0000
833     MS_U32 u32FrameBufAddr;             //0x0004
834     MS_U32 u32FrameBufSize;             //0x0008
835     MS_U32 u32CPUClock;                 //0x000C
836     HVD_Display_Info DispInfo;          //0x0010
837 
838     // FW -> HK
839     // report info
840     //AFD_Info AFDInfo;
841     MS_U32 u32DispSTC;                  //0x002C // Current Display Frame STC
842     MS_U32 u32DecodeCnt;                //0x0030 // Decoded picture count
843     MS_U32 u32DecErrCnt;                //0x0034 // HW decode err or not finish.
844     MS_U32 u32DataErrCnt;               //0x0038 // FW process data error, like SPS, slice header .etc.
845     MS_U16 u16ErrCode;                  //0x003C // Drv/FW error code ; HVD_Err_Code
846     MS_U8  u8FrameMbsOnlyFlag;          //0x003E // frame_mbs_only_flag of AVC SPS.
847     MS_U8  u8ForceBreakCnt;             //0x003F //
848     MS_U32 u32VPUIdleCnt;               //0x0040 // VPU idle count
849     MS_U32 u32FrameRate;                //0x0044 // Input Frame Rate
850     MS_U32 u32FrameRateBase;            //0x0048 // Input Frame Rate Base
851     HVD_Mode_Status ModeStatus;         //0x004C // FW mode
852     HVD_Frm_Information DispFrmInfo;    //0x005C // current displayed frame information.
853     HVD_Frm_Information DecoFrmInfo;    //0x0098 // specified decoded frame information.
854     //MS_U8 u8DecPictType;                // Current decode picture type: E_HVD_PICT_TYPE_I: I frm, E_HVD_PICT_TYPE_P: ref(P) , E_HVD_PICT_TYPE_B: non-ref(B) (GP2 need only)
855 #if defined(INTERLEAVE_SW_SEEK) || defined(SW_GETBITS) || defined(INTERLEAVE_SW_PARSE)
856     MS_U32 u32BBUReadPtr;
857 #endif
858     // internal control info
859     MS_U8 bInitDone;                    //0x00D4
860     MS_U8 bIs1stFrameRdy;               //0x00D5 // first frame are showed on screen
861     MS_U8 bIsIFrmFound;                 //0x00D6 // 1: First I frame found. 0: fw should set to zero after user cmd, "Flush"
862     MS_U8 bIsSyncStart;                 //0x00D7 // under sync mode, 1: FW start doing sync action. 0: FW freerun or freerun mode.
863     MS_U8 bIsSyncReach;                 //0x00D8 // under sync mode, 1: FW sync reach. 0: FW freerun or sync not reach.
864 
865     //****************************************
866 
867     MS_U8 u8SrcMode;                    //0x00D9
868     MS_U8 bEnableDispQueue;             //0x00DA
869     MS_U8 bEnableDispOutSide;           //0x00DB
870     //****************************************
871     MS_U32 u32FWVersionID;              //0x00DC // FW version ID
872     MS_U32 u32FWIfVersionID;            //0x00E0 // FW IF version ID
873     MS_U32 u32ESWritePtr;               //0x00E4 // the write pointer of bitstream buffer.
874     MS_U16 u16DecQNumb;                 //0x00E8 // current decoded queue total entry number. old oq size
875     MS_U16 u16DispQNumb;                //0x00EA // current display queue total entry number. old Used Size
876     MS_U32 u32PTStableWptrAddr;         //0x00EC // The address of PTS table write pointer.
877     MS_U32 u32PTStableRptrAddr;         //0x00F0 // The address of PTS table read pointer.
878     MS_U32 u32PTStableByteCnt;          //0x00F4 // The value of byte count of TSP. FW update it after init() and flush().
879 
880     // debug info
881     MS_U32 u32SkipCnt;                  //0x00F8 // skipped picture count count by command: E_HVD_DECODE_ALL, E_HVD_DECODE_I, E_HVD_DECODE_IP
882     MS_U32 u32DropCnt;                  //0x00FC // dorpped decoded picture counter by command: drop_auto or drop_once
883     MS_U32 u32CCBase;                   //0x0100 // CC Ring Base Address
884     MS_U32 u32CCSize;                   //0x0104 // CC Ring Size
885     MS_U32 u32CCWrtPtr;                 //0x0108 // CC Ring Write Pointer
886     MS_U32 u32NtscCCBase;               //0x010C // NTSC CC Ring Base Address
887     MS_U32 u32NtscCCSize;               //0x0110 // NTSC CC Ring Size
888     MS_U32 u32NtscCCWrtPtr;             //0x0114 // NTSC CC Ring Write Pointer
889     //****************************************
890     MS_U32 u32CurrentPts;               //0x0118 // only useful when Jump to pts command is activated
891     MS_U32 u32DispCnt;                  //0x011C // Display picture count
892     MS_U32 u32FWBaseAddr;               //0x0120
893     //****************************************
894     MS_U32 u32UserCCBase;               //0x0124 // User CC Base Address
895     MS_U32 u32UserCCIdxWrtPtr;          //0x0128 // User CC Idx Write Pointer
896     MS_U8 u8UserCCIdx[USER_CC_IDX_SIZE];//0x012C // User CC Idx
897     //****************************************
898     MS_U32 u32VirtualBoxWidth;          //0x0138 // Dynamic Scale: DRV -> FW
899     MS_U32 u32VirtualBoxHeight;         //0x013C // Dynamic Scale: DRV -> FW
900     MS_U32 u32SrcWidth;                 //0x0140 // Dynamic Scale: Source Width
901     MS_U32 u32SrcHeight;                //0x0144 // Dynamic Scale: Source Height
902     //****************************************
903     MS_U8 u8DivxProfile;                //0x0148  // see DIVX_PROFILE, E_DIVX_PROFILE_NONE is not a DivX stream
904     //****************************************
905 
906     // -------- AVC info --------
907     //MS_U32 u32AVC_NalCnt;             // Decoded nal count >> change to SRAM
908     MS_U8  u8AVC_SPS_LowDelayHrdFlag;   //0x0149 // VUI low_delay_hrd_flag
909     MS_U16 u16AVC_SPS_LevelIDC;         //0x014A // sps level idc
910     MS_U32 u32AVC_VUIDispInfo_Addr;     //0x014C // VUI Display Info Address
911     //MS_U32 u32AVC_SPS_Addr;           // FW sps structure start address
912 
913     // -------- AVS info --------
914     // .....
915     //MS_U32 u32AVS_xxx;
916 
917     // -------- RM info --------
918     // HK -> FW
919     MS_U8 u8RM_Version;                 //0x0150
920     MS_U8 u8RM_NumSizes;                //0x0151
921     MS_U8 u8BitDepth;                   //0x0152 Bit0~3 Y bitdepth, Bit4~7 UV bitdepth
922     //****************************************
923     MS_U8 reserved8_2;                  //0x0153
924     //****************************************
925     HVD_PictureSize  pRM_PictureSize[HVD_RM_INIT_PICTURE_SIZE_NUMBER];  //0x0154
926     MS_U32 u32RM_VLCTableAddr;          //0x0174
927 
928     // -------- common info --------
929     MS_U32 u32MainLoopCnt;              //0x0178
930     MS_U32 u32VsyncCnt;                 //0x017C
931     HVD_DISP_THRESHOLD DispThreshold;   //0x0180
932     MS_U32 u32ESReadPtr;                //0x0190 // the read pointer of bitstream buffer.
933     MS_U32 u32SeqChangeInfo;            //0x0194
934     MS_S64 s64PtsStcDiff;               //0x0198 // 90Khz
935     MS_U16 u16ChipID;                   //0x01A0 // enum MSTAR_CHIP_ID
936     MS_U16 u16ChipECONum;               //0x01A2 // ECO num of chip
937     MS_U32 u32NextPTS;                  //0x01A4 // ms
938 
939 
940     MS_U16 u16DispQSize;                //0x01A8
941     MS_U16 u16DispQPtr;                 //0x01AA
942     HVD_Frm_Information DispQueue[HVD_DISP_QUEUE_MAX_SIZE];   //0x01AC
943     //----------------------------------------------------------------------
944     MS_U32 u32RealFrameRate;            //0x0B84
945 
946     MS_U8 bSpsChange;                   //0x0B88
947     MS_U8 bEnableDispCtrl;              //0x0B89
948     MS_U8 bIsTrigDisp;                  //0x0B8A
949     MS_U8 bHVDUseTlbMode;               //0x0B8B //0: default to disable TLB , 1: use TLB (HK->FW)
950     MS_U32 u32FwState;                  //0x0B8C
951     MS_U32 u32FwInfo;                   //0x0B90
952     MS_U32 u32IntCount;                 //0x0B94
953 
954     //----------------------------------------------------------------------
955     MS_U16 u16FreeQWtPtr;              //0x0B98
956     MS_U16 u16FreeQRdPtr;              //0x0B9A
957     MS_U32 FreeQueue[HVD_DISP_QUEUE_MAX_SIZE];  //0x0B9C
958 
959     // --------- MVC info (Sub view buffer and 2nd input pointer) ---------
960     HVD_Frm_Information DispFrmInfo_Sub;    //0x0C44  // current displayed Sub frame information.
961     HVD_Frm_Information DecoFrmInfo_Sub;    //0x0C80  // specified decoded Sub frame information.
962     MS_U32 u32ES2WritePtr;              //0x0CBC
963     MS_U32 u32ES2ReadPtr;               //0x0C08
964 
965     // --------- MJPEG share memory ------------------------------------------
966     MS_U32 u32MJPEGFrameBuffIdx;        //0x0CC4 <----LOUIS DONE
967     MS_U32 u32MJPEGTimeStamp;           //0x0CC8
968     MS_U32 u32MJPEGID_L;                //0x0CCC
969     MS_U32 u32MJPEGID_H;                //0x0CD0
970     MS_U32 u32MJPEG_NextFrameBuffIdx;   //0x0CD4
971     MS_U8 u8MJPEG_bStepPlay;            //0x0CD8
972     MS_U8 u8MJPEG_bPlaying;             //0x0CD9
973     MS_U8 u8MJPEG_bIsAVSyncOn;          //0x0CDA
974     MS_U8 u8MJPEG_bIsReachAVSync;       //0x0CDB
975     MS_U8 u8MJPEG_bFlushQueue;          //0x0CDC
976     MS_U8 u8MJPEG_bIsDispFinish;        //0x0CDD
977     MS_U8 u8MJPEG_bQueueFull;           //0x0CDE
978     MS_U8 bIsLeastDispQSize;            //0x0CDF
979 
980     // --------- SEI: frame packing ------------------------------------------
981     MS_U32 u32Frm_packing_arr_data_addr;  //0x0CE0
982 
983     //---------- report 3k/6k for 16/32 Mem-Align DS --------------------------
984     MS_U32 u32DSBuffSize;               //0x0CE4  // Dynamic Scale Buffer Size actually used for different DS Mem Align
985     MS_U8 bDSIsRunning;                 //0x0CE8
986     volatile MS_U8 u8IQmemCtrl;         //0x0CE9
987     MS_U8 bIsIQMEMSupport;              //0x0CEA
988     MS_U8 bIQmemEnableIfSupport;        //0x0CEB
989     MS_U8 u8FlushStatus;                //0x0CEC
990     MS_U8 u8DSBufferDepth;              //0x0CED
991 
992     //---------- TemporalScalability -----------------------------------------
993     MS_U8 u8TemporalScalabilty;         //0x0CEE
994     MS_U8 u8MaxTemporalLayer;           //0x0CEF
995 
996     MS_U16 u16DispQWptr[2];             //0x0CF0
997     MS_U8 u8ESBufStatus;                //0x0CF4
998     MS_U8 u8FieldPicFlag;               //0x0CF5
999     MS_U8 u8CMAAllocationStatus;        //0x0CF6
1000     MS_U8 u8CMAReleaseStatus;           //0x0CF7
1001 
1002     // reserved for MJPEG
1003     MS_U32 u32MJPEGDbg_DispStatus;      //0x0CF8
1004     MS_U8 u8MJPEGDbg_ReadFbIdx;         //0x0CFC
1005     MS_U8 u8MJPEGDbg_WriteFbIdx;        //0x0CFD
1006     MS_U8 u8MJPEGDbg_SkipRepeat;        //0x0CFE
1007     MS_U8 u8MJPEGDbg_reserved8_1;       //0x0CFF
1008     MS_U32 u32MJPEGDbg_SysTime;         //0x0D00
1009     MS_U32 u32MJPEGDbg_VideoPts;        //0x0D04
1010     MS_U32 u32MJPEGDbg_SkipRepeatTime;  //0x0D08
1011 
1012     MS_U32 u32DSbufferAddr;             //0x0D0C
1013     MS_U32 u32DispRepeatCnt;            //0x0D10
1014 
1015     MS_U32 u32ColocateBBUReadPtr;       //0x0D14 FW->HK
1016     MS_U32 u32ColocateBBUWritePtr;      //0x0D18 HK->FW
1017     MS_U8  u8BBUMode;                   //0x0D1C  0: driver auto bbu mode, 1: fw auto bbu mode(colocate bbu mode)
1018     MS_U8  bUseTSPInBBUMode;            //0x0D1D  0: disable, 1: enable
1019     MS_U8  bUseWbMvop;                  //0x0D1E  0: use original MVOP, 1: use WB MVOP (HK->FW)
1020     MS_U8  bHVDIMIEnable;               //0x0D1F
1021 
1022     MS_U32 u32DmxFrameRate;             //0x0D20 // Demuxer Prefered Input Frame Rate
1023     MS_U32 u32DmxFrameRateBase;         //0x0D24 // Demuxer Prefered Input Frame Rate Base
1024     MS_U32 u32PTSTblRd;                 //0x0D28 // PTS table read ptr
1025     MS_U32 u32PTSTblWr;                 //0x0D2C // PTS table write ptr
1026     MS_U32 u32PreSetControl;            //0x0D30 // PreSetControl
1027     MS_U32 u32IapGnBufAddr;             //0x0D34
1028     MS_U32 u32IapGnBufSize;             //0x0D38
1029     MS_U32 u32SeamlessTSStatus;         //0x0D3C
1030     MS_U32 u32FWStatusFlag;             //0x0D40
1031     MS_U32 u32ESBufLevel;               //0x0D44
1032     MS_U32 u32ESBuf2Level;              //0x0D48
1033     MS_U32 u32FrameBuf2Addr;            //0x0D4C
1034     MS_U32 u32FrameBuf2Size;            //0x0D50
1035     MS_U8  bCMA_Use;                    //0x0D54
1036     MS_U8  bCMA_AllocDone;              //0x0D55
1037     MS_U8  bCMA_TwoMIU;                 //0x0D56
1038     MS_U8  u8FrmPostProcSupport;        //0x0D57
1039     MS_U8  u8PpQueueSize;               //0x0D58
1040     MS_U8  u8PpQueueWPtr;               //0x0D59
1041     MS_U8  u8PpQueueRPtr;               //0x0D5A
1042     MS_U8  u8CodecFeature;              //0x0D5B // Bit0: For AP to force vdec allocate 8bit framebuffer even decoding 10bit stream Bit1: Enable MFCODEC Bit2: Force MFCODEC nncompress mode
1043     MS_U32 u32DISPQUEUE_EXT_ST_ADDR;    //0x0D5C
1044     MS_U64 u64SeamlessTargetPTS;        //0x0D60
1045     MS_U32 u32SeamlessTargetPOC;        //0x0D68
1046     MS_U32 u32CodecMiscInfo;            //0x0D6C //Bit0: video full range bit
1047     MS_U32 u32RDPTR_PTS_LOW;            //0x0D70
1048     MS_U32 u32RDPTR_PTS_HIGH;           //0x0D74
1049     MS_U32 u32WRPTR_PTS_LOW;            //0x0D78
1050     MS_U32 u32WRPTR_PTS_HIGH;           //0x0D7C
1051     MS_U32 u32DisplayColourVolume_addr;    //0x0D80
1052     MS_U32 u32HVD_DisplayColourVolume_SEI; //0x0D84
1053     MS_U32 u32ContentLightLevel_addr;    //0x0D88
1054     MS_U32 u32HVD_ContentLightLevel_SEI;    //0x0D8C
1055     MS_U32 u32AllocateCMABuffAddr[2];      //0x0D90
1056     MS_U32 u32AllocateCMABuffSize[2];      //0x0D98
1057     PENDING_RELEASE_QUEUE pending_release_queue[2][2]; //0x0DA0~0x0DD0
1058     MS_U32 u32MaxCMAFrameBufSize;          //0x0DD0
1059     MS_U32 u32MaxCMAFrameBuf2Size;         //0x0DD4
1060     MS_U32 u32DirectStcInMs;               //0x0DD8
1061 
1062     //vdec plus info
1063     MS_U32 u32VdecPlusDecCnt;           //0x0DDC
1064     MS_U32 u32VdecPlusDropCnt;          //0x0DE0
1065     MS_U32 u32VdecPlusDispPicCnt;       //0x0DE4
1066     MS_U8  u8VdecPlusDropRatio;         //0x0DE8
1067     MS_U8  bIsTSPIn;                    //0x0DE9
1068     MS_U8  u8NumRefFrame;               //0x0DEA
1069     MS_U8  bUseCorrectVlcAddr;          //0x0DEB
1070     DynmcDispPath    stDynmcDispPath;   //0x0DEC
1071     MS_U8 reserved8_8[1];                   // 0x0DEF
1072     MS_U32 u32NotSupportInfo;       // 0x0DF0
1073     MS_U32 u32CurMinTspDataSize;        //0x0DF4 //byte
1074     MS_U8  reserved8_9[0xF9C-0xDF8];    //0x0DF8
1075 
1076     MS_U32 u32VDEC_MIU_SEL;             //0x0F9C
1077     MS_U32 u32MaxVideoWidth;            //0x0FA0 // for VDEC3_FB usage
1078     MS_U32 u32MaxVideoHeight;           //0x0FA4 // for VDEC3_FB usage
1079     CMD_QUEUE cmd_queue;                //0x0FA8~0x0FBC DISPCMDQ and normal CMDQ
1080     MS_U32 u32HVD_VBBU_DRAM_ST_ADDR;    //0x0FC0
1081     MS_U32 u32HVD_PTS_TABLE_ST_OFFSET;  //0x0FC4
1082     MS_U32 u32HVD_BBU_DRAM_ST_ADDR;     //0x0FC8
1083     MS_U32 u32HVD_BBU2_DRAM_ST_ADDR;    //0x0FCC
1084     MS_U32 u32HVD_DYNAMIC_SCALING_ADDR; //0x0FD0
1085     MS_U32 u32HVD_SCALER_INFO_ADDR;     //0x0FD4
1086     MS_U32 u32HVD_AVC_DTVINFO;          //0x0FD8
1087     MS_U32 u32HVD_AVC_INFO608;          //0x0FDC
1088     MS_U32 u32HVD_AVC_INFO708;          //0x0FE0
1089     MS_U32 u32HVD_AVC_USERDATA;         //0x0FE4
1090     MS_U32 u32HVD_AVC_FRAME_PACKING_SEI;//0x0FE8
1091     MS_U32 u32HVD_DBG_DUMP_ADDR;        //0x0FEC
1092     MS_U32 u32HVD_DUMMY_WRITE_ADDR;     //0x0FF0
1093     MS_U32 u32VSYNC_BRIGE_SHM_ADDR;     //0x0FF4
1094     MS_U32 u32COMPARE_INFO_ADDR;        //0x0FF8
1095     MS_U32 u32COMPARE_MD5_ADDR;         //0x0FFC
1096 } HVD_ShareMem;
1097 
1098 typedef struct
1099 {
1100     MS_U8 u8Version;
1101     MS_U8 u8Current_index;
1102     MS_U32 u32DM_length;
1103     MS_U32 u32DM_addr;
1104     MS_U8 u8Compse_enable;
1105     MS_U32 u32Comp_length;
1106     MS_U32 u32Comp_addr;
1107     MS_U8 u8Reserved[13];
1108 } HVD_DV_XC_ShareMem;
1109 
1110 typedef struct
1111 {
1112     MS_U32 u32LumaAddr0;                 ///< The start offset of luma data. Unit: byte.
1113     MS_U32 u32ChromaAddr0;               ///< The start offset of chroma data. Unit: byte.
1114     MS_U32 u32LumaAddr1;                 ///< The start offset of luma data. Unit: byte.
1115     MS_U32 u32ChromaAddr1;               ///< The start offset of chroma data. Unit: byte.
1116     MS_U32 u32PriData;                   ///< Index for SEC release frame buffer
1117     MS_U32 u32PriData1;                  ///< Index for SEC release frame buffer
1118     MS_U32 u32Status;
1119     MS_U16 u16Pitch;
1120     MS_U16 u16Width;
1121     MS_U16 u16Height;
1122     MS_U16 u16CropLeft;
1123     MS_U16 u16CropRight;
1124     MS_U16 u16CropBottom;
1125     MS_U16 u16CropTop;
1126     MS_U8  u1BottomFieldFirst:1;
1127     MS_U8  u1DSIndex1Valid:1;
1128     MS_U8  u2Reserved:6;
1129     MS_U8  u8FieldType;                 ///< HVD_Field_Type, none, top , bottom, both field
1130     MS_U8  u8Interlace;
1131     MS_U8  u8ColorFormat;               // 0 -> 420, 1 -> 422, 2 -> 420 10 bit
1132     MS_U8  u8FrameNum;                  // if 2, u32LumaAddr1 and u32ChromaAddr1 should be use
1133     MS_U8  u8RangeMapY;                 // for VC1 or 10 BIT frame, 2 bit Y depth
1134     MS_U8  u8RangeMapUV;                // for VC1 or 10 BIT frame, 2 bit UV depth
1135     MS_U8  u8TB_toggle;                 // 0 -> TOP then BOTTOM
1136     MS_U8  u8Tog_Time;
1137     MS_U8  u2Luma0Miu:2;
1138     MS_U8  u2Luma1Miu:2;
1139     MS_U8  u2Chroma0Miu:2;
1140     MS_U8  u2Chroma1Miu:2;
1141     MS_U8  u8FieldCtrl;                 // 0-> Normal, 1->always top, 2->always bot
1142     union {
1143         MS_U8 u8DSIndex;
1144         struct
1145         {
1146             MS_U8 u4DSIndex0:4;
1147             MS_U8 u4DSIndex1:4;         // it is DS index for sFrames[1] (HEVC Dolby EL frame)
1148         };
1149     };
1150     union {
1151         MS_U16 u16Pitch1;               // for 10 BIT, the 2 bit frame buffer pitch
1152         MS_U16 u16DispCnt;              // when this display queue is show finish, record the display conut for debug if frame repeat
1153     };
1154 } DISP_FRM_INFO;
1155 
1156 typedef struct
1157 {
1158     // for vsync bridge dispQ bridge
1159     MS_U8  u8DispQueNum;
1160     MS_U8  u8McuDispSwitch;
1161     MS_U8  u8McuDispQWPtr;
1162     MS_U8  u8McuDispQRPtr;
1163     DISP_FRM_INFO McuDispQueue[MAX_VSYNC_BRIDGE_DISPQ_NUM];
1164     MS_U8  u8DisableFDMask;
1165     MS_U8  u8FdMaskField;
1166     MS_U8  u8ToggledTime;
1167     MS_U8  u8ToggleMethod;
1168     MS_U8  u8Reserve[2];
1169     MS_U8  u5FRCMode:5;
1170     MS_U8  u1FBLMode:1;
1171     MS_U8  u2MirrorMode:2;
1172     MS_U8  u8Reserve2;
1173 } MCU_DISPQ_INFO;
1174 
1175 typedef enum
1176 {
1177     MS_DISP_FRM_INFO_EXT_TYPE_10BIT,
1178     MS_DISP_FRM_INFO_EXT_TYPE_INTERLACE = 1, // interlace bottom 8bit will share the same enum value
1179     MS_DISP_FRM_INFO_EXT_TYPE_DOLBY_EL = 1,  // with dolby enhance layer 8bit
1180     MS_DISP_FRM_INFO_EXT_TYPE_10BIT_INTERLACE = 2, // interlace bottom 2bit will share the same enum
1181     MS_DISP_FRM_INFO_EXT_TYPE_10BIT_DOLBY_EL = 2,  // value with dolby enhance layer 2bit
1182     MS_DISP_FRM_INFO_EXT_TYPE_10BIT_MVC,
1183     MS_DISP_FRM_INFO_EXT_TYPE_INTERLACE_MVC,
1184     MS_DISP_FRM_INFO_EXT_TYPE_10BIT_INTERLACE_MVC = 5, // MVC interlace R-View 2bit will share the
1185     MS_DISP_FRM_INFO_EXT_TYPE_DOLBY_META = 5,          // same enum with dolby meta data
1186     MS_DISP_FRM_INFO_EXT_TYPE_MFCBITLEN,
1187     MS_DISP_FRM_INFO_EXT_TYPE_MFCBITLEN_MVC,
1188     MS_DISP_FRM_INFO_EXT_TYPE_MAX,
1189 } DISP_FRM_INFO_EXT_TYPE;
1190 
1191 /****************************************************************************************
1192                                   MFCodecInfo
1193           +---------------------------------------------------------------+
1194           |Uncompress|BitLen Miu Select|  Pitch  |   MFCodec Version      |
1195           |   4 bits |      4 bits     |  8 bits |       16 bits          |
1196           +---------------------------------------------------------------+
1197 ***************************************************************************************/
1198 typedef struct
1199 {
1200     MS_U32 u32LumaAddrExt[MS_DISP_FRM_INFO_EXT_TYPE_MAX];
1201     MS_U32 u32ChromaAddrExt[MS_DISP_FRM_INFO_EXT_TYPE_MAX];
1202     MS_U32 MFCodecInfo;
1203     MS_U16 u16Width;      // the width of second frame
1204     MS_U16 u16Height;     // the height of second frame
1205     MS_U16 u16Pitch[2];   // the pitch of second frame
1206 } DISP_FRM_INFO_EXT;
1207 
1208 typedef struct
1209 {
1210     MS_U8 u8Pattern[4];
1211     MS_U32 u32Version;
1212     MS_U32 u32Debug;
1213     MS_U16 u16VsyncCnt;
1214     MS_U16 u16Debug;
1215     DISP_FRM_INFO_EXT McuDispQueue[MAX_VSYNC_BRIDGE_DISPQ_NUM];
1216 } MCU_DISPQ_INFO_EXT;
1217 
1218 typedef struct
1219 {
1220     MS_U32 u32ByteCnt;
1221     MS_U32 u32PTS;
1222     MS_U32 u32ID_L;
1223     MS_U32 u32ID_H;
1224 } HVD_PTS_Entry;
1225 
1226 // enum
1227 typedef enum
1228 {
1229     E_MSTAR_CHIP_NONE = 0,
1230     E_MSTAR_CHIP_U3,        //remove
1231     E_MSTAR_CHIP_T3,        //remove
1232     E_MSTAR_CHIP_T4,        //remove
1233     E_MSTAR_CHIP_JANUS,     //remove
1234     E_MSTAR_CHIP_U4,        //remove
1235     E_MSTAR_CHIP_T8,        //remove
1236     E_MSTAR_CHIP_T9,        //remove
1237     E_MSTAR_CHIP_M10,       //remove
1238     E_MSTAR_CHIP_T12,       //remove
1239     E_MSTAR_CHIP_T13,       //remove
1240     E_MSTAR_CHIP_J2,        //remove
1241     E_MSTAR_CHIP_K1,
1242     E_MSTAR_CHIP_A1,        //remove
1243     E_MSTAR_CHIP_A5,        //remove
1244     E_MSTAR_CHIP_A7,        //remove
1245     E_MSTAR_CHIP_K2,
1246     E_MSTAR_CHIP_A3,        //remove
1247     E_MSTAR_CHIP_A7P,       //remove
1248     E_MSTAR_CHIP_AGATE,     //remove
1249     E_MSTAR_CHIP_M12,
1250     E_MSTAR_CHIP_EAGLE,     //remove
1251     E_MSTAR_CHIP_EMERALD,    //remove
1252     E_MSTAR_CHIP_EDISON,    //remove
1253     E_MSTAR_CHIP_EIFFEL,    //remove
1254     E_MSTAR_CHIP_CEDRIC,
1255     E_MSTAR_CHIP_NUGGET,    //remove
1256     E_MSTAR_CHIP_KAISER,
1257     E_MSTAR_CHIP_NIKE,    //remove
1258     E_MSTAR_CHIP_KENYA,
1259     E_MSTAR_CHIP_EINSTEIN,    //remove
1260     E_MSTAR_CHIP_NIKON,    //remove
1261     E_MSTAR_CHIP_NAPOLI,
1262     E_MSTAR_CHIP_MADISON,
1263     E_MSTAR_CHIP_MONACO,
1264     E_MSTAR_CHIP_KERES,
1265     E_MSTAR_CHIP_CLIPPERS,
1266     E_MSTAR_CHIP_MUJI,
1267     E_MSTAR_CHIP_MUNICH,
1268     E_MSTAR_CHIP_MONET,
1269     E_MSTAR_CHIP_MULAN,
1270     E_MSTAR_CHIP_MANHATTAN,
1271     E_MSTAR_CHIP_KRATOS,
1272     E_MSTAR_CHIP_KANO,
1273     E_MSTAR_CHIP_MESSI,
1274     E_MSTAR_CHIP_MILAN,
1275     E_MSTAR_CHIP_MASERATI,
1276     E_MSTAR_CHIP_MACAN,
1277     E_MSTAR_CHIP_KIWI,
1278     E_MSTAR_CHIP_CURRY,
1279     E_MSTAR_CHIP_OTHER = 0xFF,
1280 } MSTAR_CHIP_ID;
1281 
1282 typedef enum
1283 {
1284     E_HVD_SRC_MODE_DTV = 0,
1285     E_HVD_SRC_MODE_TS_FILE,
1286     E_HVD_SRC_MODE_FILE,
1287     E_HVD_SRC_MODE_TS_FILE_DUAL_ES,
1288     E_HVD_SRC_MODE_FILE_DUAL_ES,
1289 } HVD_SRC_MODE;
1290 
1291 typedef enum
1292 {
1293     E_VDEC_FORCE_8BITS_MASK          = BMASK(0:0),       ///< 8BITS YUV Mode
1294     E_VDEC_FORCE_8BITS_MODE          = BIT(0),
1295     E_VDEC_MFCODEC_MASK              = BMASK(2:1),       ///< MFCodec Mode
1296         E_VDEC_MFCODEC_DEFAULT       = BITS(2:1, 0),     ///< deflaut: 0x00
1297         E_VDEC_MFCODEC_FORCE_ENABLE  = BITS(2:1, 1),     ///< force enable: 0x01
1298         E_VDEC_MFCODEC_FORCE_DISABLE = BITS(2:1, 2),     ///< force disable:0x10
1299     E_VDEC_MFCODEC_UNCOMPRESS_MODE   = BIT(3),
1300     E_VDEC_FORCE_MAIN_PROFILE_MASK = BMASK(4:4),
1301     E_VDEC_FORCE_MAIN_PROFILE   = BIT(4),     // HEVC: Only Support Main profile even this chip support Main10
1302     E_VDEC_DYNAMIC_CMA_MODE     = BIT(5),     // Enable Dynamic CMA mechanism
1303     E_VDEC_TEMPORAL_SCALABILITY_MODE = BIT(6),   //Enable/Disable Temporal Scalability Mode
1304     E_VDEC_DOLBY_VISION_SINGLE_LAYER_MODE = BIT(7)   //Enable/Disable dolby vision single layer Mode
1305 } VDEC_CODEC_FEATURE;
1306 
1307 typedef enum
1308 {
1309     E_HVD_Codec_AVC = 0,
1310     E_HVD_Codec_AVS,
1311     E_HVD_Codec_RM,
1312     E_HVD_Codec_MVC,
1313     E_HVD_Codec_VP8,
1314     E_HVD_Codec_MJPEG,
1315     E_HVD_Codec_VP6,
1316     E_HVD_Codec_HEVC,
1317     E_HVD_Codec_VP9,
1318     E_HVD_Codec_HEVC_DV,
1319     E_HVD_Codec_UNKNOWN
1320 } HVD_Codec_Type;
1321 
1322 typedef enum
1323 {
1324     E_HVD_PICT_TYPE_I,
1325     E_HVD_PICT_TYPE_P,
1326     E_HVD_PICT_TYPE_B,
1327 } HVD_Picture_Type;
1328 
1329 typedef enum
1330 {
1331     E_HVD_FIELD_TYPE_NONE = 0,
1332     E_HVD_FIELD_TYPE_TOP,
1333     E_HVD_FIELD_TYPE_BOTTOM,
1334     E_HVD_FIELD_TYPE_BOTH,
1335 } HVD_Field_Type;
1336 
1337 typedef enum
1338 {
1339     EVD_TOP_FIELD = 1,
1340     EVD_BOTTOM_FIELD = 2,
1341     EVD_TOP_BOTTOM_ORDER = 3,
1342     EVD_BOTTOM_TOP_ORDER = 4,
1343     EVD_TOP_WITH_PREV = 9,
1344     EVD_BOTTOM_WITH_PREV = 10,
1345     EVD_TOP_WITH_NEXT = 11,
1346     EVD_BOTTOM_WITH_NEXT = 12,
1347     EVD_UNKNOWN_TYPE = 0xFF,
1348 } HEVC_PIC_STRUCT;
1349 
1350 typedef enum
1351 {
1352     E_HVD_DECODE_ALL,
1353     E_HVD_DECODE_I,
1354     E_HVD_DECODE_IP,
1355 } HVD_Skip_Decode_Type;
1356 
1357 typedef enum
1358 {
1359     E_HVD_CMA_ALLOCATION_NONE,
1360     E_HVD_CMA_ALLOCATION_WAITING,
1361     E_HVD_CMA_ALLOCATION_DONE,
1362     E_HVD_CMA_ALLOCATION_FAILED,
1363 } HVD_CMA_Allocation_Status;
1364 
1365 typedef enum
1366 {
1367     E_HVD_CMA_RELEASE_NONE,
1368     E_HVD_CMA_RELEASE_WAITING,
1369     E_HVD_CMA_RELEASE_DONE,
1370 } HVD_CMA_Release_Status;
1371 
1372 typedef enum
1373 {
1374     E_HVD_DROP_DISP_AUTO = (1<<0),
1375     E_HVD_DROP_DISP_ONCE = (1<<1),
1376 } HVD_Drop_Disp_Type;
1377 
1378 typedef enum
1379 {
1380     E_HVD_FRC_NORMAL = 0,
1381     E_HVD_FRC_32PULLDOWN,               //3:2 pulldown mode (ex. 24p a 60i or 60p)
1382     E_HVD_FRC_PAL2NTSC ,                //PALaNTSC conversion (50i a 60i)
1383     E_HVD_FRC_NTSC2PAL,                 //NTSCaPAL conversion (60i a 50i)
1384     E_HVD_FRC_DISP_2X,                  //output rate is twice of input rate (ex. 30p a 60p)
1385     E_HVD_FRC_24_50,                    //output rate 24P->50P 48I->50I
1386     E_HVD_FRC_50P_60P,                  //output rate 50P ->60P
1387     E_HVD_FRC_60P_50P,                  //output rate 60P ->50P
1388     E_HVD_FRC_HALF_I,                   //output rate 120i -> 60i, 100i -> 50i
1389     E_HVD_FRC_120I_50I,                 //output rate 120i -> 60i
1390     E_HVD_FRC_100I_60I,                 //output rate 100i -> 60i
1391     E_HVD_FRC_DISP_4X,                  //output rate is four times of input rate (ex. 15P a 60P)
1392     E_HVD_FRC_15_50,                    //output rate 15P->50P, 30i -> 50i
1393     E_HVD_FRC_30_50,                    //output rate  30p->50p, 60i->50i
1394     E_HVD_FRC_30_24,                    //output rate 30p->24p, 60i->24i
1395     E_HVD_FRC_60_24,                    //output rate 60p->24p, 120i -> 24i
1396     E_HVD_FRC_60_25,                    //output rate 60p->25p , 120i -> 50i
1397     E_HVD_FRC_HALF_P,                   //output rate 60p-> 30p, 50p -> 25p
1398     E_HVD_FRC_25_30,                    //output rate 25p->30p , 50 i-> 30i
1399     E_HVD_FRC_50_30,                    //output rate 25p->30p ,  100i -> 30i
1400     E_HVD_FRC_24_30,                    //output rate 24p->30p , 48i -> 30i
1401 } HVD_FRC_Mode;
1402 
1403 typedef enum
1404 {
1405     E_HVD_FRC_DROP_FRAME = 0,
1406     E_HVD_FRC_DROP_FIELD = 1,
1407 } HVD_FRC_Drop_Mode;
1408 
1409 typedef enum
1410 {
1411     E_HVD_DISP_SPEED_F_32X = 32,
1412     E_HVD_DISP_SPEED_F_16X = 16,
1413     E_HVD_DISP_SPEED_F_8X = 8,
1414     E_HVD_DISP_SPEED_F_4X = 4,
1415     E_HVD_DISP_SPEED_F_2X = 2,
1416     E_HVD_DISP_SPEED_1X = 1,
1417     E_HVD_DISP_SPEED_S_2X = -2,
1418     E_HVD_DISP_SPEED_S_4X = -4,
1419     E_HVD_DISP_SPEED_S_8X = -8,
1420     E_HVD_DISP_SPEED_S_16X = -16,
1421     E_HVD_DISP_SPEED_S_32X = -32,
1422 } HVD_Disp_Speed;
1423 
1424 typedef enum
1425 {
1426     E_HVD_SYNC_TBL_TYPE_NON,
1427     E_HVD_SYNC_TBL_TYPE_PTS,
1428     E_HVD_SYNC_TBL_TYPE_DTS,
1429     E_HVD_SYNC_TBL_TYPE_STS,            //Sorted TimeStamp
1430 } HVD_Sync_Tbl_Type;                    //only for file mode. Ts , ts file mode always has PTS table
1431 
1432 typedef enum
1433 {
1434     E_HVD_FIELD_CTRL_OFF=0,
1435     E_HVD_FIELD_CTRL_TOP,       // Always Show Top Field
1436     E_HVD_FIELD_CTRL_BOTTOM,    // Always Show Bottom Field
1437 } HVD_Field_Ctrl;
1438 
1439 typedef enum
1440 {
1441     E_HVD_BURST_CNT_LV0 = 0,  // U3,T3:32 cycle  T4~U4: 16 cycle
1442     E_HVD_BURST_CNT_LV1 = 1,  // U3,T3:64 cycle  T4~U4: 32 cycle
1443     E_HVD_BURST_CNT_LV2 = 2,  // U3,T3:96 cycle  T4~U4: 48 cycle
1444     E_HVD_BURST_CNT_LV3 = 3,  // U3,T3:128 cycle  T4~U4: 64 cycle
1445     E_HVD_BURST_CNT_LV4 = 4,  // U3,T3:160 cycle  T4~U4: 80 cycle
1446     E_HVD_BURST_CNT_LV5 = 5,  // U3,T3:192 cycle  T4~U4: 96 cycle
1447     E_HVD_BURST_CNT_LV6 = 6,  // U3,T3:224 cycle  T4~U4: 112 cycle
1448     E_HVD_BURST_CNT_LV7 = 7,  // U3,T3:256 cycle  T4~U4: 128 cycle
1449     E_HVD_BURST_CNT_DISABLE = 0xFFFFFFFF,
1450 } HVD_MIU_Burst_Cnt_Ctrl;
1451 
1452 typedef enum
1453 {
1454     E_HVD_DISPQ_STATUS_NONE = 0,            //FW
1455     E_HVD_DISPQ_STATUS_INIT,                //FW
1456     E_HVD_DISPQ_STATUS_VIEW,                //HK
1457     E_HVD_DISPQ_STATUS_DISP,                //HK
1458     E_HVD_DISPQ_STATUS_FREE,                //HK
1459 } HVD_DISPQ_STATUS;
1460 
1461 typedef enum
1462 {
1463     // invalid cmd
1464     E_HVD_CMD_INVALID_CMD = 0xFFFFFFFFUL,
1465 
1466     // SVD old cmd
1467     E_HVD_CMD_SVD_BASE = 0x00010000,
1468     /*0x10001*/E_HVD_CMD_PARSER_BYPASS,             // 1 : on :for raw file mode; AVCHVD_CMD_PARSER_BYPASS ; 0: off: TS file mode and live stream
1469     /*0x10002*/E_HVD_CMD_BBU_RESIZE,                // svd only;  AVCHVD_CMD_BBU_SIZE
1470     /*0x10003*/E_HVD_CMD_FRAME_BUF_RESIZE,          // svd only; AVCHVD_CMD_RESIZE_MEM
1471     /*0x10004*/E_HVD_CMD_IGNORE_ERR_REF,            // 1: ignore ref error, 0: enable ref error handle; AVCHVD_CMD_IGNORE_LIST + AVCHVD_CMD_OPEN_GOP
1472     /*0x10005*/E_HVD_CMD_ES_FULL_STOP,              // ES auto stop: 1: AVCHVD_CMD_ES_STOP; ES not stop 0: AVCHVD_CMD_HANDSHAKE
1473     /*0x10006*/E_HVD_CMD_DROP_DISP_AUTO,            // 1:on AVCHVD_CMD_DISP_DROP, 0:off AVCHVD_CMD_DIS_DISP_DROP
1474     /*0x10007*/E_HVD_CMD_DROP_DISP_ONCE,            // AVCHVD_CMD_DROP_CNT
1475     /*0x10008*/E_HVD_CMD_FLUSH_DEC_Q,               // AVCHVD_CMD_FLUSH_QUEUE
1476 
1477     // HVD new cmd
1478     E_HVD_CMD_NEW_BASE = 0x00020000,
1479     // Action
1480     E_HVD_CMD_TYPE_ACTION_MASK = (0x0100|E_HVD_CMD_NEW_BASE),
1481 
1482     // state machine action
1483     /*0x20101*/E_HVD_CMD_INIT ,                     // Init FW type: E_HVD_Codec_AVC ; E_HVD_Codec_AVS;  E_HVD_Codec_RM
1484     /*0x20102*/E_HVD_CMD_PLAY,                      // AVCHVD_CMD_GO
1485     /*0x20103*/E_HVD_CMD_PAUSE,                     // AVCHVD_CMD_PAUSE
1486     /*0x20104*/E_HVD_CMD_STOP,                      // AVCHVD_CMD_STOP
1487     // run-time action
1488     /*0x20105*/E_HVD_CMD_STEP_DECODE,               // AVCHVD_CMD_STEP
1489     /*0x20106*/E_HVD_CMD_FLUSH,                     // Arg: 1 show last decode, 0 show current diaplay.FW need to clear read pointer of PTS table under SYNC_PTS, SYNC_DTS. ; BBU: AVCHVD_CMD_DROP ,  DISP: AVCHVD_CMD_FLUSH_DISPLAY , AVCHVD_CMD_SKIPTOI
1490     /*0x20107*/E_HVD_CMD_BLUE_SCREEN,               // only for AVC. remove auto blue screen before show first frame on screen
1491     /*0x20108*/E_HVD_CMD_RESET_PTS,                 // reset PTS table for TS file mode. AVCHVD_CMD_RE_SYNC
1492     /*0x20109*/E_HVD_CMD_FREEZE_IMG,                // FW showes the same frame at every Vsync, but background decode process can not stop. 1: freeze image; 0: normal diaplay
1493     /*0x2010A*/E_HVD_CMD_JUMP_TO_PTS,               // Arg: PTS(unit: 90kHz). 0: disable this mode. Any not zero value: enable. FW decode to specified PTS by using full speed. During the decoding, FW need not show any decoded frames, just maitain the last frame before get this command.
1494     /*0x2010B*/E_HVD_CMD_SYNC_TOLERANCE,            // Arg: any not zero number(unit: 90kHz). AVCHVD_CMD_SLOW_SYNC
1495     /*0x2010C*/E_HVD_CMD_SYNC_VIDEO_DELAY,          // Arg: 0~MAX_VIDEO_DELAY(unit: 90kHz): use Arg of video delay. AVCHVD_CMD_AVSYNC
1496     /*0x2010D*/E_HVD_CMD_DISP_ONE_FIELD,            // for AVS, AVC only, Arg: HVD_Field_Ctrl. AVCH264_CMD_ONE_FIELD
1497     /*0x2010E*/E_HVD_CMD_FAST_DISP,                 // Arg: 0: disable, Any not zero value: enable. Always return first frame ready. Don't care the first frame av-sync.
1498     /*0x2010F*/E_HVD_CMD_SKIP_TO_PTS,               // Arg: PTS(unit: 90kHz). 0: disable this mode. Any not zero value: enable. FW decode to specified PTS by using full speed. FW need not to decode frame until the first I after the specified PTS.
1499     /*0x20110*/E_HVD_CMD_SYNC_THRESHOLD,            // Arg: 0x01~0xFF , frame repeat time. If arg == 0xFF, fw will always repeat last frame when PTS > STC.
1500     /*0x20111*/E_HVD_CMD_FREERUN_THRESHOLD,         // Arg: (unit: 90KHz) 0: use default 5 sec (90000 x 5).
1501     /*0x20112*/E_HVD_CMD_FLUSH_FRM_BUF,             // Arg: 1 show last decode frame, 0 show current diaplay frame. FW will clear all frame buffer then skip to next I frame.
1502     /*0x20113*/E_HVD_CMD_FORCE_INTERLACE,           // Arg: 0; Diable. Arg: 1; Force interlace only support DTV and TS file mode with framerate 25 or 30 (all resolution, under FHD)
1503                                                     // Arg: 2; Force interlace support DTV and TS file mode with framerate 25 or 30,but only works on 1080P (width large less 1920)
1504                                                     // Arg: 3; Force interlace support DTV and TS file mode with framerate 23 to 30 and all resolution.
1505                                                     // Arg: 4; Force interlace support DTV and TS file mode with under 30 fps and all resolution.
1506                                                     // Arg: 5; Force interlace support DTV and TS file mode with with framerate 25 or 30 (under FHD and width large less 720)
1507                                                     // Arg: 6: Force interlace support all mode with under all fps and all resolution.
1508     /*0x20114*/E_HVD_CMD_DUAL_NON_BLOCK_MODE,       // Arg: 0 disable Arg:1 For dual decode case, force switch to another task when current task is idle
1509     /*0x20115*/E_HVD_CMD_INPUT_PTS_FREERUN_MODE,    // Arg: 0 disable. Arg:1, video free run when the difference between input PTS and current STC is large than E_HVD_CMD_FREERUN_THRESHOLD + 1s;
1510     /*0x20116*/E_HVD_CMD_FREEZE_TO_CHASE,           // Arg: 1 enable, 0 disable. Freeze current image when PTS < STC and decode drop / skip frame to sync stc.
1511 
1512     // internal control action
1513 
1514     // FW settings ( only for driver init)
1515     E_HVD_CMD_SETTINGS_MASK = (0x0200|E_HVD_CMD_NEW_BASE),
1516     /*0x20201*/E_HVD_CMD_PITCH,                     // Arg:any non-zero number. AVCHVD_CMD_PITCH_1952, AVCHVD_CMD_PITCH_1984
1517     /*0x20202*/E_HVD_CMD_SYNC_EACH_FRM,             // 1: TS file mode: on ; 0: live mode: off AVCHVD_CMD_SYNC
1518     /*0x20203*/E_HVD_CMD_MAX_DEC_TICK,              // 0: off ; not 0 : in fw.h  new value AVCHVD_CMD_MAXT
1519     /*0x20204*/E_HVD_CMD_AUTO_FREE_ES,              // 1: on ; 0: off ; for live stream only AVCHVD_CMD_AUTO_FREE
1520     /*0x20205*/E_HVD_CMD_DIS_VDEAD,                 // 1: on :For PVR , file mode only ; 0 : off: AVCHVD_CMD_DIS_VDEAD
1521     /*0x20206*/E_HVD_CMD_MIN_FRAME_GAP,             // Arg: 0~n, 0xFFFFFFFF: don't care frame gap; For file mode only; AVCHVD_CMD_MIN_FRAME_GAP
1522     /*0x20207*/E_HVD_CMD_SYNC_TYPE,                 // Arg: HVD_Sync_Tbl_Type. //only for file mode. Ts , ts file mode always has PTS table
1523     /*0x20208*/E_HVD_CMD_TIME_UNIT_TYPE,            // Set Time unit: 0: 90Khz, 1: 1ms
1524     /*0x20209*/E_HVD_CMD_ISR_TYPE,                  // Add ISR trigger timing.
1525     /*0x2020A*/E_HVD_CMD_DYNAMIC_SCALE,             // 0: disable; 1: enable
1526     /*0x2020B*/E_HVD_CMD_SCALER_INFO_NOTIFY,
1527     /*0x2020C*/E_HVD_CMD_MIU_BURST_CNT,             // Arg 0~7 burst cnt level , 0xFFFFFFFF = Disable
1528     /*0x2020D*/E_HVD_CMD_FDMASK_DELAY_CNT,          // Arg: 0~0xFF, Fdmask delay count, arg >= 0xFF -> use default.
1529     /*0x2020E*/E_HVD_CMD_FRC_OUTPUT_FRAMERATE,      // unit: vsync cnt
1530     /*0x2020F*/E_HVD_CMD_FRC_OUTPUT_INTERLACE,      // 0: progressive; 1: interlace
1531     /*0x20210*/E_HVD_CMD_ENABLE_DISP_QUEUE,         // 0: Disable; 1:Enable
1532     /*0x20211*/E_HVD_CMD_FORCE_DTV_SPEC,            // 0: Disable; 1:Enable, Force to follow H264 DTV Spec, if res>720p && framerate>50, force progessive
1533                                                        // 2: Disable, if frame_mbs_only_flag == TRUE, it's progressive.
1534     /*0x20212*/E_HVD_CMD_SET_USERDATA_MODE,         // Arg: HVD_USER_DATA_MODE, use "OR", 0x00: Normal DVB user_data mode; 0x01: ATSC DirectTV CC mode
1535                                                     // 0x02: FPA CallBack, 0x04: ATSC_CC_RAW mode
1536     /*0x20213*/E_HVD_CMD_ENABLE_DISP_OUTSIDE,       // 0: Disable; 1:Enable
1537     /*0x20214*/E_HVD_CMD_SUPPORT_AVC_TO_MVC,        // Arg: 0: Disable AVC to MVC, 1: Enable AVC to MVC but non-support DS, 2:Enable AVC to MVC and support DS,
1538     /*0x20215*/E_HVD_CMD_ENABLE_NEW_SLOW_MOTION,    // Arg: 0: Disable New Slow Motion, 1: Enable New Slow Motion.
1539     /*0x20216*/E_HVD_CMD_FORCE_ALIGN_VSIZE,         // Arg: 0: Disable and 3D ouput is frame packing mode. 1: Enable VSIZE would be 4 align and Crop Botton would be additional size; 3D output would not be frame packing mode.
1540     /*0x20217*/E_HVD_CMD_PUSH_DISPQ_WITH_REF_NUM,   // Arg: 0: Disable; 1:Enable
1541     /*0x20218*/E_HVD_CMD_GET_MORE_FRM_BUF,          // Arg: 0: Disable; 1:Enable. If buffer size is enough, intial more frame buffer to use.
1542     /*0x20219*/E_HVD_CMD_RM_ENABLE_PTS_TBL,         // Arg, 0:disable, 1:enable. this command is only used by RM, when enable==1, RM will search pts table and return matched u32ID_L
1543     /*0x2021A*/E_HVD_CMD_DYNAMIC_SCALE_RESV_N_BUFFER,   // Arg, 0:disable, 1:enable. use init_dpb_and_frame_buffer_layout_3 to do dynamic layout other than fixed layout
1544     /*0x2021B*/E_HVD_CMD_DS_RESET_XC_DISP_WIN,      // Arg, 0: Disable, 1:enable. When Dynamic scaling enable, report the display information change and re-set XC display window.
1545     /*0x2021C*/E_HVD_CMD_AVC_SUPPORT_REF_NUM_OVER_MAX_DPB_SIZE,     /// Arg, 0: Disable; 1:enable. AVC support reference number is more than maximum DPB size when frame buffer size was enough.
1546     /*0x2021D*/E_HVD_CMD_FRAMERATE_HANDLING,        // Arg 0~60000, 0: Disable, 1000 ~ 60000: Used the arg to set frame rate when the sequence did not have frame rate info. and arg is not zero. (The frame unit is (arg/1000)fps, Exp: 30000 = 30.000 fps), others: Do not thing.
1547     /*0x2021E*/E_HVD_CMD_AUTO_EXHAUST_ES_MODE,      // Arg, 0: disable, [31:16]= Upper bound, [15:0] = Lower bound, Unit is 1KBytes, // Auto drop display to consume ES data as soon as possible when ES level is higher than upper bound
1548     /*0x2021F*/E_HVD_CMD_RETURN_INVALID_AFD,        // Arg, 0: Disable, 1:enable, return 0 when AFD is invalid
1549                                                     // Arg, 2: Enable, return 0 when AFD is invalid at I frame. (GOP)
1550     /*0x20220*/E_HVD_CMD_AVC_FORCE_BROKEN_BY_US,    // Arg, 0: Disable, 1:enable, force enable broken by us mode. FW does need it anymore.
1551     /*0x20221*/E_HVD_CMD_EXTERNAL_DS_BUF,           // Arg, 0: Disable, 1:Enable.
1552     /*0x20222*/E_HVD_CMD_SHOW_FIRST_FRAME_DIRECT,   // Arg: 0: Disable; 1:Enable. Push first I frame to display queue directly..
1553     /*0x20223*/E_HVD_CMD_AVC_RESIZE_DOS_DISP_PEND_BUF,  //Arg: Resize disp pending buffer size for display outside mode(dos), default dos disp pending buf size = 4
1554     /*0x20224*/E_HVD_CMD_SET_MIN_TSP_DATA_SIZE,         //Arg: Resize HVD_FW_AVC_ES_MIN_TSP_DATA_SIZE
1555     /*0x20225*/E_HVD_CMD_DYNAMIC_SCALE_ENHANCE_SETTINGS,    //Arg: 0:None, 1:MHP,...
1556     /*0x20226*/E_HVD_CMD_ONE_PENDING_BUFFER_MODE,   // Arg: 0: Disable; 1:Enable. Use only one pending buffer instead of two.
1557     /*0x20227*/E_HVD_CMD_ENABLE_EXTERNAL_CC_608_BUF, // Arg: [7:0] =size, [31:8]= start address,  unit =1k bytes , Enable: length/address != 0, Disable: length/address == 0
1558     /*0x20228*/E_HVD_CMD_ENABLE_EXTERNAL_CC_708_BUF, // Arg: [7:0] =size, [31:8]= start address,  unit =1k bytes , Enable: length/address != 0, Disable: length/address == 0
1559     /*0x20229*/E_HVD_CMD_SET_DISP_ERROR_TOLERANCE,   // Arg: //[15:8]+[7:0] = (err_tolerance(0%~100%)+enable or disable)
1560     /*0x2022A*/E_HVD_CMD_SET_PTS_US_MODE,            // Arg: //0: Disable; 1:Enable. return micro seconds PTS in PTS mode
1561     /*0x2022B*/E_HVD_CMD_SET_DV_XC_SHM_ADDR,        // Arg, address for dolby vision xc DM/composer shm
1562     /*0x2022C*/E_HVD_CMD_G2VP9_FHD_BW_BALANCE_MODE, // Arg, 0:disable, 1:enable.G2_VP9 will do bandwidth balance mechanism when resolution greater than FHD. Otherwise, it would be 2560*1400
1563 
1564     // Mode ( for AP run-time)
1565     E_HVD_CMD_MODE_MASK = (0x0300|E_HVD_CMD_NEW_BASE),
1566     /*0x20301*/E_HVD_CMD_SKIP_DEC,                  // E_HVD_DECODE_ALL ;E_HVD_DECODE_I;E_HVD_DECODE_IP; AVCHVD_CMD_DEC_I , AVCHVD_CMD_SKIP_NONREF
1567     /*0x20302*/E_HVD_CMD_DISP_SPEED,                // HVD_Disp_Speed  ;  AVCHVD_CMD_TRICKY  0,1: normal speed N(>0): show N times, slow motion Nx(-2,-4...) ; N(<0): FF speed Nx(2,4,...) AVCHVD_CMD_2X_SPEED
1568     /*0x20303*/E_HVD_CMD_DISP_ERR_FRM,              // True: display and error frame; FALSE: not show error frame ; AVCHVD_CMD_ERR_TH
1569     /*0x20304*/E_HVD_CMD_ERR_CONCEAL,               // 1: on ; 0: off ; AVCHVD_CMD_PASTE
1570     /*0x20305*/E_HVD_CMD_REPEAT_LAST_FIELD,         // 1: ON ; 0: OFF
1571     /*0x20306*/E_HVD_CMD_FRC_MODE,                  // Arg:HVD_FRC_Mode. AVCHVD_CMD_FRAME_CVT
1572     /*0x20307*/E_HVD_CMD_SYNC_ACTIVE,               // Arg: 0: sync off. AVCHVD_CMD_FREE_RUN ;  1: sync on. AVCHVD_CMD_AVSYNC
1573     /*0x20308*/E_HVD_CMD_PLAYBACK_FINISH,           // 1: no more input data, FW need to show frame by itself until all buffers being empty. 0: close this mode.
1574     /*0x20309*/E_HVD_CMD_BALANCE_BW,                // Arg: Byte0: Quarter Pixel Off Level, Byte1: Deblock Off Level >> 0: off, 1~255: count threshold to enter, Byte2: Upper Bound value. i.e.: Byte0: 1,Byte1: 10,Byte2: 20.
1575     /*0x2030A*/E_HVD_CMD_POWER_SAVING,              // Arg: 0: Power Saving Off, 1: Power Saving On
1576     /*0x2030B*/E_HVD_CMD_DIS_DBF,                   // Disable deblock, Arg: 0: off, 1: disable all frame, 2: only disable non-ref frame
1577     /*0x2030C*/E_HVD_CMD_DIS_QUART_PIXEL,           // Disable quarter pixel, Arg: 0: off, 1: disable for all frame, 2: only dsiable non-ref frame
1578     /*0x2030D*/E_HVD_CMD_DPO_CC,                    // Display Order User Data Command, Arg: 0: off, 1: on.
1579     /*0x2030E*/E_HVD_CMD_DISP_I_DIRECT,             // Display I directly, Arg: 0: off, 1: on
1580     /*0x2030F*/E_HVD_CMD_FORCE_RESET_HW,            // Arg, 0:disable, 1:enable. Force reset hw when frame start
1581     /*0x20310*/E_HVD_CMD_UPDATE_DISP_THRESHOLD,     // Arg, none
1582     /*0x20311*/E_HVD_CMD_FRC_DROP_MODE,             // Arg, E_HVD_FRC_DROP_FRAME (0), E_HVD_FRC_DROP_FIELD (1)
1583     /*0x20312*/E_HVD_CMD_UPDATE_DISPQ,              // Arg, none. Update Frame Status in Display Queue
1584     /*0x20313*/E_HVD_CMD_SHOW_DECODE_ORDER,         // Arg, 0:disable, 1:enable. Show decoder order or display order
1585     /*0x20314*/E_HVD_CMD_3DLR_VIEW_EXCHANGE,        // Arg, 0: off, do not thing. 1: on, exchange the L/R views
1586     /*0x20315*/E_HVD_CMD_DISP_IGNORE_CROP,          // Arg, 0:disable, 1:enable. Ignore crop information when set V-sync to display
1587     /*0x20316*/E_HVD_CMD_STOP_MVD_PARSER,           // Arg, 1:stop mvd parser
1588     /*0x20317*/E_HVD_CMD_SUSPEND_DYNAMIC_SCALE,     // Arg, 0:disable, 1:enable. Suspend dynamic scale and raise interrupt.
1589     /*0x20318*/E_HVD_CMD_AVOID_PTS_TBL_OVERFLOW,    // Arg, 0:disable, 1:enable. for hw tsp mode, mvd parser will stop when pts table is close to overflow and restart when enough pts is consumed.
1590     /*0x20319*/E_HVD_CMD_IGNORE_PIC_OVERRUN,        // Arg, 0:disable, 1:enable. Ignore hw error: PIC overrun error.
1591     /*0x2031A*/E_HVD_CMD_RVU_SETTING_MODE,          // Arg, 0:disable, 1:Drop B frame and force IDR.
1592     /*0x2031B*/E_HVD_CMD_RELEASE_DISPQ,             // Arg, none. Unlock frame status.
1593     /*0x2031C*/E_HVD_CMD_CTRL_SPEED_IN_DISP_ONLY,   // Arg, 0:disable, control in decoding and displaying time; 1:enable, control speed in displaying time only.
1594     /*0x2031D*/E_HVD_CMD_IGNORE_PIC_STRUCT_DISPLAY, // Arg, 0:disable, 1:Ignore Pic_struct when display progressive frame.
1595     /*0x2031E*/E_HVD_CMD_ERR_CONCEAL_SLICE_1ST_MB,  // Arg, 0:disable, Error concealment from current/last MB position; 1:enale, Error concealment from current slice first MB.(Need enable E_HVD_CMD_ERR_CONCEAL)
1596     /*0x2031F*/E_HVD_CMD_AUTO_DROP_ES_DATA,         // Arg, 0:disable, [31:16]= Upper bound, [15:0] = Lower bound; Unit is 1%~100%: Drop ES data when ES buffer threshold more than 1%~100%.
1597     /*0x20320*/E_HVD_CMD_AUTO_DROP_DISP_QUEUE,      // Arg, 0:disable, N = 1~16: Drop display queue when display queue above than N frames. It only support Display Queue mode. (bEnableDispQueue = TRUE)
1598     /*0x20321*/E_HVD_CMD_USE_CPB_REMOVAL_DEALY,     // Arg, 0:disable, 1:enable. Use Cpb_Removal_Delay of Picture timing SEI to control PTS.
1599     /*0x20322*/E_HVD_CMD_SKIP_N_FRAME,              // Arg, 0:disable, N = 1~63. Skip N frame.
1600     /*0x20323*/E_HVD_CMD_PVR_SEAMLESS_TIMESHIFT,    // Arg, 0:disable, 1:pause decode, 2:reset hw and wait for playback with target data, 3:seek_to_I after play
1601     /*0x20324*/E_HVD_CMD_STOP_PARSER_BY_PTS_TABLE_LEVEL,    // Arg, 0:disable, [31:16]= Upper bound, [15:0] = Lower bound; Stop parser when PTS table size is more than upper bound. Resume parser when PTS table size is less than low bound.
1602     /*0x20325*/E_HVD_CMD_INC_DISPQ_NUM,             // Arg, none. Increase DispQ Num (SW detile case)
1603     /*0x20326*/E_HVD_CMD_THUMBNAIL_MODE,            // Arg, 0:disable, 1:enable. Use small frame buffer to decode thumbnail
1604     /*0x20327*/E_HVD_CMD_CMA_FRMBUFF_ALLOCATE_STATUS,
1605     /*0x20328*/E_HVD_CMD_CMA_FRMBUFF_RELEASE_STATUS,
1606     /*0x20329*/E_HVD_CMD_FRC_ONLY_SHOW_TOP_FIELD,   // Arg, 0:disable, 1:enable. only show top filed for FRC mode
1607     /*0x2032A*/E_HVD_CMD_DIRECT_STC_MODE,           // Arg, 0:disable, 1:enable. vdec fw use g_shm->u32DirectStcInMs as stc
1608     /*0x2032B*/E_HVD_CMD_DROP_ONLY_FIELD_FRAME,     // Arg, 0:disable, 1:enable. Drop only field frame when insert to display queue and enable drop error frame.
1609     /*0x2032C*/E_HVD_CMD_DYNAMIC_CONNECT_DISP_PATH, // Arg, bit[0]: connect/disconnect, bit[4:1]: display path, [31:5]: reserved.
1610     /*0x2032D*/E_HVD_CMD_AVSYNC_DISP_AUTO_DROP,     // Arg, 0:disable, 1:enable.
1611     /*0x2032E*/E_HVD_CMD_SET_SLOW_SYNC,                  // Arg, bits[31:16]: reserved, bits[15:8]: slow repeat frequency (0: disable slow repeat), bits[7:0]: slow drop frequency (0: disable slow drop).
1612     /*0x2032F*/E_HVD_CMD_ENABLE_QOS_INFO,           // Arg, 0:disable, 1:enable. report qos info
1613 
1614     // test cmd
1615     E_HVD_CMD_TEST_MASK = (0x0400|E_HVD_CMD_NEW_BASE),
1616     /*0x20401*/E_HVD_CMD_INIT_STREAM,               // Initialize this stream
1617     /*0x20402*/E_HVD_CMD_RELEASE_STREAM,            // Release this stream
1618 
1619     // HVD new cmd Max
1620     E_HVD_CMD_NEW_MAX = (0xFFFF|E_HVD_CMD_NEW_BASE),
1621 
1622 
1623     // Dual Stream Command
1624     E_DUAL_CMD_BASE = 0x00030000,             // pass the DRAM offset from argument
1625 
1626     E_DUAL_CMD_MODE_MASK = (0x0100|E_DUAL_CMD_BASE),
1627     /*0x30101*/E_DUAL_CMD_TASK0_HVD_TSP,
1628     /*0x30102*/E_DUAL_CMD_TASK0_HVD_BBU,
1629     /*0x30103*/E_DUAL_CMD_TASK0_MVD_TSP,
1630     /*0x30104*/E_DUAL_CMD_TASK0_MVD_SLQ,
1631 
1632     /*0x30105*/E_DUAL_CMD_TASK1_HVD_TSP,
1633     /*0x30106*/E_DUAL_CMD_TASK1_HVD_BBU,
1634     /*0x30107*/E_DUAL_CMD_TASK1_MVD_TSP,
1635     /*0x30108*/E_DUAL_CMD_TASK1_MVD_SLQ,
1636 
1637     /*0x30109*/E_DUAL_CMD_SINGLE_TASK,      //argument: 0:multi(default) 1:single // first cmd
1638 
1639     /*0x3010A*/E_DUAL_CMD_MODE,             //argument: 0:normal(default) 1:3D wmv 2:Korea 3D 3:Korea 3D Progressive 4:sub view sync main STC
1640                                             //          5:switch target STC , main view sync sub stc and sub view sync main stc //first cmd
1641 
1642     /*0x3010B*/E_DUAL_BURST_MODE,           //argument: 0:normal(default) 1:burst command to controller(lots of cmd)
1643 
1644     /*0x3010C*/E_DUAL_VERSION,              //argument: 0:controller 1:mvd fw 2:hvd fw 3:mvd interface 4:hvd interface
1645     /*0x3010D*/E_DUAL_R2_CMD_EXIT,          //for WIN32 testing and let R2 FW return directly.
1646     /*0x3010E*/E_DUAL_R2_CMD_FBADDR,        //frame buffer address
1647     /*0x3010F*/E_DUAL_R2_CMD_FBSIZE,        //frame buffer size
1648     /*0x30110*/E_DUAL_R2_CMD_FB2ADDR,       //frame buffer2 address
1649     /*0x30111*/E_DUAL_R2_CMD_FB2SIZE,       //frame buffer2 size
1650     /*0x30112*/E_DUAL_CMD_COMMON,           //argument: 0:dymanic fb management
1651     /*0x30113*/E_DUAL_CMD_STC_MODE,         //set STC index
1652     E_DUAL_CMD_CTL_MASK = (0x0200|E_DUAL_CMD_BASE), // argument is the id : 0 or 1
1653     /*0x30201*/E_DUAL_CMD_DEL_TASK,
1654 
1655     // Dual Stream cmd Max
1656     E_DUAL_CMD_MAX = (0xFFFF|E_DUAL_CMD_BASE),
1657 
1658     // N Stream Command
1659     E_NST_CMD_BASE = 0x00040000,  // pass the DRAM offset from argument
1660 
1661     E_NST_CMD_MODE_MASK = (0x0100|E_NST_CMD_BASE),
1662 #ifdef VDEC3
1663     /*0x40101*/E_NST_CMD_TASK_HVD_TSP,
1664     /*0x40102*/E_NST_CMD_TASK_HVD_BBU,
1665     /*0x40103*/E_NST_CMD_TASK_MVD_TSP,
1666     /*0x40104*/E_NST_CMD_TASK_MVD_SLQ,
1667 #endif
1668 
1669     E_NST_CMD_CTL_MASK = (0x0200|E_NST_CMD_BASE),  // argument is the id : 0 ,1 or 2
1670     /*0x40201*/E_NST_CMD_DEL_TASK,
1671 
1672     E_NST_CMD_COMMON_MASK = (0x0300|E_NST_CMD_BASE),
1673     /*0x40301*/E_NST_CMD_COMMON_CMD1,
1674     /*0x40302*/E_NST_CMD_COMMON_CMD2,
1675 
1676     // N Stream cmd Max
1677     E_NST_CMD_MAX = (0xFFFF|E_NST_CMD_BASE),
1678 
1679     // CMD MASK
1680     E_CMD_MASK = 0x00FFFFFF,
1681 
1682     // TASK ID MASK
1683     E_ID_CMD_MASK = 0xFF000000,
1684 
1685 } HVD_User_Cmd;
1686 
1687 // Command
1688 typedef enum
1689 {
1690     // Invalid cmd
1691     E_JPD_CMD_INVALID                        = 0xffffffffUL,
1692 
1693     E_JPD_CMD_GO                             = 0x00, // Start to show
1694     E_JPD_CMD_SET_FRAME_BUFF_START_ADDR      = 0x01, // Set frame buffer address
1695     E_JPD_CMD_SET_FRAME_BUFF_UNIT_SIZE       = 0x02, // Set frame buffer size
1696     E_JPD_CMD_SET_FRAME_BUFF_TOTAL_NUM       = 0x03, // Set total number of frame buffer
1697     E_JPD_CMD_SET_FRAME_BUFF_IDX             = 0x04, // Set frame buffer index
1698     E_JPD_CMD_SET_FRAME_BUFF_IDX_READY       = 0x05, // Set frame buffer index ready for display
1699     E_JPD_CMD_SET_WIDTH                      = 0x06, // Set frame width
1700     E_JPD_CMD_SET_HEIGHT                     = 0x07, // Set frame height
1701     E_JPD_CMD_SET_PITCH                      = 0x08, // Set pitch
1702     E_JPD_CMD_SET_FRAME_ID_L                 = 0x09, // Set frame ID_L
1703     E_JPD_CMD_SET_FRAME_ID_H                 = 0x0A, // Set frame ID_H
1704     E_JPD_CMD_SET_TIMESTAMP                  = 0x0B, // Set Time Stamp
1705     E_JPD_CMD_SET_FRAMERATE                  = 0x0C, // Set FrameRate
1706     E_JPD_CMD_SET_FRAMERATE_BASE             = 0x0D, // Set FrameRate Base
1707     E_JPD_CMD_SET_FRAME_BUFF_IDX_VALID       = 0x0E, // Set frame buffer index available
1708     E_JPD_CMD_SET_CHIP_ID                    = 0x0F, // Set Chip ID
1709 
1710     E_JPD_CMD_PLAY                           = 0x20, // Play
1711     E_JPD_CMD_PAUSE                          = 0x21, // Pause
1712     E_JPD_CMD_RESUME                         = 0x22, // Resume
1713     E_JPD_CMD_STEP_PLAY                      = 0x23, // Step play
1714     E_JPD_CMD_SET_SPEED_TYPE                 = 0x24, // Set play speed type: default, fast, slow
1715     E_JPD_CMD_SET_SPEED                      = 0x25, // Set play speed
1716     E_JPD_CMD_FLUSH_DISP_QUEUE               = 0X26, // Flush display queue
1717     E_JPD_CMD_FREEZE_DISP                    = 0x27, // Freeze display
1718     E_JPD_CMD_ENABLE_AVSYNC                  = 0x28, // Enable AV Sync
1719     E_JPD_CMD_SET_AVSYNC_DELAY               = 0x29, // Set AV sync delay
1720     E_JPD_CMD_SET_AVSYNC_TOLERENCE           = 0x2A, // Set AV sync tolerence
1721     E_JPD_CMD_SET_PTS_BASE                   = 0x2B, // Set PTS base
1722     E_JPD_CMD_SET_STC_BASE                   = 0x2C, // Set STC base
1723     E_JPD_CMD_SET_BLUE_SCREEN                = 0x2D, // Set Blue Screen
1724     E_JPD_CMD_PUSH_QUEUE_PARA_SETTING        = 0x2E,
1725     E_JPD_CMD_SET_DISPLAY_OUTSIDE_MODE       = 0x2F,
1726 
1727     E_JPD_CMD_GET_NEXT_FREE_FRAME_BUFF_IDX   = 0x40, // Get next free frame buffer index
1728     E_JPD_CMD_COMPENSATE_PTS                 = 0x41, // Ask firmware to compensate PTS
1729 
1730 
1731 #ifdef VDEC3
1732     E_JPD_CMD_GET_FRAME_BUFFER               = 0x50, // Ask firmware to get frame buffer
1733     E_JPD_CMD_FREE_FRAME_BUFFER              = 0x51, // Ask firmware to free frame buffer
1734 #endif
1735     E_JPD_CMD_DYNAMIC_CONNECT_DISP_PATH      = 0x61, // Arg, bit[0]: connect/disconnect, bit[4:1]: display path, [31:5]: reserved.
1736 
1737     // Display Command Queue
1738     E_JPD_CMD_ENABLE_DISP_CMD_QUEUE          = 0x80, // Enable Display Command Queue
1739     E_JPD_CMD_PUSH_DISP_CMD                  = 0x81, // Push Display Command
1740     E_JPD_CMD_GET_DISP_CMD_Q_VACANCY         = 0x82, // Check if the display command queue full or not
1741 
1742     E_JPD_CMD_IS_STEP_PLAY_DONE              = 0xFF, //
1743     E_JPD_CMD_IS_DISP_FINISH                 = 0xFE, //
1744     E_JPD_CMD_IS_PLAYING                     = 0xFC, //
1745     E_JPD_CMD_IS_DISPLAY_QUEUE_FULL          = 0xFB, //
1746     E_JPD_CMD_IS_AVSYNC_ON                   = 0xFA, //
1747     E_JPD_CMD_IS_REACH_AVSYNC                = 0xF9, //
1748     E_JPD_CMD_IS_FLUSH_DONE                  = 0xF8, // Check if flush done
1749 
1750 } JPD_User_Cmd;
1751 
1752 // Firmware State
1753 typedef enum
1754 {
1755     E_JPD_FW_STATE_MASK = 0xF000,
1756 } JPD_FW_State;
1757 
1758 // Error Code
1759 typedef enum
1760 {
1761     // Error code base
1762     E_JPD_ERR_BASE= 0x01000000,
1763 } JPD_Err_Code;
1764 
1765 typedef enum
1766 {
1767     E_HVD_FW_STATE_MASK = 0xF000,
1768 
1769     // state: INIT
1770     E_HVD_FW_INIT = 0x1000,
1771     E_HVD_FW_INIT_START,
1772     E_HVD_FW_INIT_DONE,
1773 
1774     // state: PLAY
1775     E_HVD_FW_PLAY = 0x2000,
1776     E_HVD_FW_PLAY_TYPE_MASK = 0x0C00,
1777 
1778     // AVC
1779     E_HVD_FW_PLAY_AVC = (0x0000|E_HVD_FW_PLAY),
1780     E_HVD_FW_AVC_READ_NAL,
1781     E_HVD_FW_AVC_READ_NEW_SLICE,
1782     E_HVD_FW_AVC_PREPARE_SLICE_HEADER,
1783     E_HVD_FW_AVC_DECODE_ONE_SLICE,
1784     E_HVD_FW_AVC_EXIT_PICTURE,
1785 
1786     // AVS
1787     E_HVD_FW_PLAY_AVS = (0x0400|E_HVD_FW_PLAY),
1788 
1789     // RM
1790     E_HVD_FW_PLAY_RM = (0x0800|E_HVD_FW_PLAY),
1791 
1792     // state: PAUSE
1793     E_HVD_FW_PAUSE = 0x3000,
1794 
1795     // state: STOP
1796     E_HVD_FW_STOP = 0x4000,
1797     E_HVD_FW_STOP_START,
1798     E_HVD_FW_STOP_DONE,
1799 } HVD_FW_State;
1800 
1801 
1802 typedef enum
1803 {
1804     // Error code base
1805     E_HVD_ERR_BASE = 0x0000,
1806 
1807     // General
1808     E_HVD_ERR_GENERAL_BASE = (0x0000|E_HVD_ERR_BASE),
1809     E_HVD_ERR_OUT_OF_SPEC,
1810     E_HVD_ERR_UNKNOW_ERR,
1811     E_HVD_ERR_HW_BREAK_DOWN,
1812     // TIMEOUT
1813     E_HVD_ERR_HW_DEC_TIMEOUT,
1814     // NOT SUPPORT
1815     E_HVD_ERR_OUT_OF_MEMORY,        // required memory size is over frame buffer size.
1816     E_HVD_ERR_UNKNOWN_CODEC,        // unknown media codec
1817     E_HVD_ERR_CMA_FAILED,
1818     E_HVD_ERR_RES_NOT_SUPPORT,      // out of supported resolution
1819 
1820     // AVC
1821     E_HVD_ERR_AVC_BASE = (0x1000|E_HVD_ERR_BASE),
1822     // decode error
1823     E_HVD_ERR_AVC_SPS_BROKEN,           // SPS is not valid
1824     E_HVD_ERR_AVC_SPS_NOT_IN_SPEC,
1825     E_HVD_ERR_AVC_SPS_NOT_ENOUGH_FRM,   // DPB size at specified level is smaller than the specified number of reference frames. This is not allowed
1826     E_HVD_ERR_AVC_PPS_BROKEN,           // PPS is not valid
1827     E_HVD_ERR_AVC_REF_LIST,
1828     E_HVD_ERR_AVC_NO_REF,
1829     E_HVD_ERR_AVC_RES,                  // out of supported resolution
1830 
1831     // AVS
1832     E_HVD_ERR_AVS_BASE = (0x2000|E_HVD_ERR_BASE),
1833     E_HVD_ERR_AVS_RES,                  // out of supported resolution
1834 
1835     // RM
1836     E_HVD_ERR_RM_BASE = (0x3000|E_HVD_ERR_BASE),
1837     E_HVD_ERR_RM_PACKET_HEADER,
1838     E_HVD_ERR_RM_FRAME_HEADER,
1839     E_HVD_ERR_RM_SLICE_HEADER,
1840     E_HVD_ERR_RM_BYTE_CNT,
1841     E_HVD_ERR_RM_DISP_TIMEOUT,
1842     E_HVD_ERR_RM_NO_REF,
1843     E_HVD_ERR_RM_RES,                   // out of supported resolution
1844     E_HVD_ERR_RM_VLC,
1845     E_HVD_ERR_RM_SIZE_OUT_FB_LAYOUT,
1846 
1847     // VP8
1848     E_HVD_ERR_VP8_BASE = (0x4000|E_HVD_ERR_BASE),
1849     E_HVD_ERR_VP8_RES,                  // out of supported resolution
1850 
1851     // HEVC
1852     E_HVD_ERR_HEVC_BASE = (0x5000|E_HVD_ERR_BASE),
1853     E_HVD_ERR_HEVC_RES,                  // out of supported resolution
1854 
1855     // VP9
1856     E_HVD_ERR_VP9_BASE = (0x6000|E_HVD_ERR_BASE),
1857     E_HVD_ERR_VP9_RES,                  // out of supported resolution
1858 } HVD_Err_Code;
1859 
1860 typedef enum
1861 {
1862     E_HVD_ES_BUF_STATUS_UNKNOWN   = 0,
1863     E_HVD_ES_BUF_STATUS_UNDERFLOW = 1,
1864     E_HVD_ES_BUF_STATUS_OVERFLOW  = 2,
1865     E_HVD_ES_BUF_STATUS_NORMAL    = 3,
1866 
1867 }HVD_ES_Buf_Status;
1868 
1869 typedef enum {
1870     E_PVR_SEAMLESS_TIMESHIFT_NONE = 0,
1871     E_PVR_SEAMLESS_TIMESHIFT_PAUSE_DECODE,          // initialize timeshift record, pause decode and set target POC/pts
1872     E_PVR_SEAMLESS_TIMESHIFT_RESET_AND_FINE_TARGET, // resume and try to find picture with target POC/pts, drop before we find it
1873     E_PVR_SEAMLESS_TIMESHIFT_SEEK_TO_I              // stop finding target, decode from next I
1874 } HVD_Seamless_Mode;
1875 
1876 typedef enum
1877 {
1878     E_HVD_FREEZE_AT_CUR_PIC = 1,
1879     E_HVD_FREEZE_AT_LAST_PIC = 2,
1880     E_HVD_FREEZE_AT_CUR_PIC_AND_CLEAR_DECODE_INFO = 3,
1881 }HVD_Flush_Mode;
1882 
1883 typedef enum
1884 {
1885     E_HVD_SEAMLESS_PAUSE_DECODE      = BIT(0),
1886     E_HVD_SEAMLESS_DISPLAY_REPEATING = BIT(1),
1887     E_HVD_SEAMLESS_RESET_HW_DONE     = BIT(2),
1888     E_HVD_SEAMLESS_TARGET_FRM_FOUND  = BIT(3),
1889     E_HVD_SEAMLESS_DISPLAY_RESUME    = BIT(4),
1890 }HVD_Seamless_Status;
1891 
1892 typedef enum
1893 {
1894     E_HVD_POST_PROC_NONE     = 0,
1895     E_HVD_POST_PROC_DETILE   = BIT(0),
1896 } HVD_Post_Process;
1897 
1898 typedef enum
1899 {
1900     E_HVD_CHIP_U01   = 0,
1901     E_HVD_CHIP_U02   = 1,
1902 } HVD_CHIP_ECO_NUM;
1903 
1904 typedef enum
1905 {
1906     // unknown sequence change info
1907     VDEC_SEQ_CHANGE_NONE              = 0x00,
1908     // sequence chagne first time
1909     VDEC_SEQ_CHANGE_FIRST_TIME        = BIT(0),
1910     // sequence chagne due to resolution
1911     VDEC_SEQ_CHANGE_RESOLUTION        = BIT(1),
1912     // sequence chagne due to picture type
1913     VDEC_SEQ_CHANGE_PICTURE_TYPE      = BIT(2),
1914     // sequence chagne due to aspect ratio
1915     VDEC_SEQ_CHANGE_ASPECT_RATIO      = BIT(3),
1916     // sequence chagne due to frame rate
1917     VDEC_SEQ_CHANGE_FRAME_RATE        = BIT(4),
1918     // sequence chagne due to HDR info
1919     VDEC_SEQ_CHANGE_HDR_INFO          = BIT(5),
1920 } VDEC_SeqChangeInfo;
1921 
1922 typedef enum
1923 {
1924     E_HVD_NOT_SUPPORT_PROFILE      = BIT(0),
1925     E_HVD_NOT_SUPPORT_SPS_ID        = BIT(1),
1926     E_HVD_NOT_SUPPORT_CHROMA_FORMAT = BIT(2),
1927     E_HVD_NOT_SUPPORT_MAX_FRAME_NUM = BIT(3),
1928 } HVD_NOT_SUPPORT_INFO;
1929 
1930 #endif // _FW_HVD_IF_H_
1931 
1932