xref: /utopia/UTPA2-700.0.x/modules/pq/hal/M7621/pq/include/mhal_pq.h (revision 53ee8cc121a030b8d368113ac3e966b4705770ef)
1*53ee8cc1Swenshuai.xi //<MStar Software>
2*53ee8cc1Swenshuai.xi //******************************************************************************
3*53ee8cc1Swenshuai.xi // MStar Software
4*53ee8cc1Swenshuai.xi // Copyright (c) 2010 - 2012 MStar Semiconductor, Inc. All rights reserved.
5*53ee8cc1Swenshuai.xi // All software, firmware and related documentation herein ("MStar Software") are
6*53ee8cc1Swenshuai.xi // intellectual property of MStar Semiconductor, Inc. ("MStar") and protected by
7*53ee8cc1Swenshuai.xi // law, including, but not limited to, copyright law and international treaties.
8*53ee8cc1Swenshuai.xi // Any use, modification, reproduction, retransmission, or republication of all
9*53ee8cc1Swenshuai.xi // or part of MStar Software is expressly prohibited, unless prior written
10*53ee8cc1Swenshuai.xi // permission has been granted by MStar.
11*53ee8cc1Swenshuai.xi //
12*53ee8cc1Swenshuai.xi // By accessing, browsing and/or using MStar Software, you acknowledge that you
13*53ee8cc1Swenshuai.xi // have read, understood, and agree, to be bound by below terms ("Terms") and to
14*53ee8cc1Swenshuai.xi // comply with all applicable laws and regulations:
15*53ee8cc1Swenshuai.xi //
16*53ee8cc1Swenshuai.xi // 1. MStar shall retain any and all right, ownership and interest to MStar
17*53ee8cc1Swenshuai.xi //    Software and any modification/derivatives thereof.
18*53ee8cc1Swenshuai.xi //    No right, ownership, or interest to MStar Software and any
19*53ee8cc1Swenshuai.xi //    modification/derivatives thereof is transferred to you under Terms.
20*53ee8cc1Swenshuai.xi //
21*53ee8cc1Swenshuai.xi // 2. You understand that MStar Software might include, incorporate or be
22*53ee8cc1Swenshuai.xi //    supplied together with third party`s software and the use of MStar
23*53ee8cc1Swenshuai.xi //    Software may require additional licenses from third parties.
24*53ee8cc1Swenshuai.xi //    Therefore, you hereby agree it is your sole responsibility to separately
25*53ee8cc1Swenshuai.xi //    obtain any and all third party right and license necessary for your use of
26*53ee8cc1Swenshuai.xi //    such third party`s software.
27*53ee8cc1Swenshuai.xi //
28*53ee8cc1Swenshuai.xi // 3. MStar Software and any modification/derivatives thereof shall be deemed as
29*53ee8cc1Swenshuai.xi //    MStar`s confidential information and you agree to keep MStar`s
30*53ee8cc1Swenshuai.xi //    confidential information in strictest confidence and not disclose to any
31*53ee8cc1Swenshuai.xi //    third party.
32*53ee8cc1Swenshuai.xi //
33*53ee8cc1Swenshuai.xi // 4. MStar Software is provided on an "AS IS" basis without warranties of any
34*53ee8cc1Swenshuai.xi //    kind. Any warranties are hereby expressly disclaimed by MStar, including
35*53ee8cc1Swenshuai.xi //    without limitation, any warranties of merchantability, non-infringement of
36*53ee8cc1Swenshuai.xi //    intellectual property rights, fitness for a particular purpose, error free
37*53ee8cc1Swenshuai.xi //    and in conformity with any international standard.  You agree to waive any
38*53ee8cc1Swenshuai.xi //    claim against MStar for any loss, damage, cost or expense that you may
39*53ee8cc1Swenshuai.xi //    incur related to your use of MStar Software.
40*53ee8cc1Swenshuai.xi //    In no event shall MStar be liable for any direct, indirect, incidental or
41*53ee8cc1Swenshuai.xi //    consequential damages, including without limitation, lost of profit or
42*53ee8cc1Swenshuai.xi //    revenues, lost or damage of data, and unauthorized system use.
43*53ee8cc1Swenshuai.xi //    You agree that this Section 4 shall still apply without being affected
44*53ee8cc1Swenshuai.xi //    even if MStar Software has been modified by MStar in accordance with your
45*53ee8cc1Swenshuai.xi //    request or instruction for your use, except otherwise agreed by both
46*53ee8cc1Swenshuai.xi //    parties in writing.
47*53ee8cc1Swenshuai.xi //
48*53ee8cc1Swenshuai.xi // 5. If requested, MStar may from time to time provide technical supports or
49*53ee8cc1Swenshuai.xi //    services in relation with MStar Software to you for your use of
50*53ee8cc1Swenshuai.xi //    MStar Software in conjunction with your or your customer`s product
51*53ee8cc1Swenshuai.xi //    ("Services").
52*53ee8cc1Swenshuai.xi //    You understand and agree that, except otherwise agreed by both parties in
53*53ee8cc1Swenshuai.xi //    writing, Services are provided on an "AS IS" basis and the warranty
54*53ee8cc1Swenshuai.xi //    disclaimer set forth in Section 4 above shall apply.
55*53ee8cc1Swenshuai.xi //
56*53ee8cc1Swenshuai.xi // 6. Nothing contained herein shall be construed as by implication, estoppels
57*53ee8cc1Swenshuai.xi //    or otherwise:
58*53ee8cc1Swenshuai.xi //    (a) conferring any license or right to use MStar name, trademark, service
59*53ee8cc1Swenshuai.xi //        mark, symbol or any other identification;
60*53ee8cc1Swenshuai.xi //    (b) obligating MStar or any of its affiliates to furnish any person,
61*53ee8cc1Swenshuai.xi //        including without limitation, you and your customers, any assistance
62*53ee8cc1Swenshuai.xi //        of any kind whatsoever, or any information; or
63*53ee8cc1Swenshuai.xi //    (c) conferring any license or right under any intellectual property right.
64*53ee8cc1Swenshuai.xi //
65*53ee8cc1Swenshuai.xi // 7. These terms shall be governed by and construed in accordance with the laws
66*53ee8cc1Swenshuai.xi //    of Taiwan, R.O.C., excluding its conflict of law rules.
67*53ee8cc1Swenshuai.xi //    Any and all dispute arising out hereof or related hereto shall be finally
68*53ee8cc1Swenshuai.xi //    settled by arbitration referred to the Chinese Arbitration Association,
69*53ee8cc1Swenshuai.xi //    Taipei in accordance with the ROC Arbitration Law and the Arbitration
70*53ee8cc1Swenshuai.xi //    Rules of the Association by three (3) arbitrators appointed in accordance
71*53ee8cc1Swenshuai.xi //    with the said Rules.
72*53ee8cc1Swenshuai.xi //    The place of arbitration shall be in Taipei, Taiwan and the language shall
73*53ee8cc1Swenshuai.xi //    be English.
74*53ee8cc1Swenshuai.xi //    The arbitration award shall be final and binding to both parties.
75*53ee8cc1Swenshuai.xi //
76*53ee8cc1Swenshuai.xi //******************************************************************************
77*53ee8cc1Swenshuai.xi //<MStar Software>
78*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
79*53ee8cc1Swenshuai.xi //
80*53ee8cc1Swenshuai.xi // Copyright (c) 2008-2009 MStar Semiconductor, Inc.
81*53ee8cc1Swenshuai.xi // All rights reserved.
82*53ee8cc1Swenshuai.xi //
83*53ee8cc1Swenshuai.xi // Unless otherwise stipulated in writing, any and all information contained
84*53ee8cc1Swenshuai.xi // herein regardless in any format shall remain the sole proprietary of
85*53ee8cc1Swenshuai.xi // MStar Semiconductor Inc. and be kept in strict confidence
86*53ee8cc1Swenshuai.xi // (!��MStar Confidential Information!�L) by the recipient.
87*53ee8cc1Swenshuai.xi // Any unauthorized act including without limitation unauthorized disclosure,
88*53ee8cc1Swenshuai.xi // copying, use, reproduction, sale, distribution, modification, disassembling,
89*53ee8cc1Swenshuai.xi // reverse engineering and compiling of the contents of MStar Confidential
90*53ee8cc1Swenshuai.xi // Information is unlawful and strictly prohibited. MStar hereby reserves the
91*53ee8cc1Swenshuai.xi // rights to any and all damages, losses, costs and expenses resulting therefrom.
92*53ee8cc1Swenshuai.xi //
93*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
94*53ee8cc1Swenshuai.xi //==============================================================================
95*53ee8cc1Swenshuai.xi #ifndef MHAL_PQ_H
96*53ee8cc1Swenshuai.xi #define MHAL_PQ_H
97*53ee8cc1Swenshuai.xi 
98*53ee8cc1Swenshuai.xi #define MEMFMT24BIT_YC10BIT_MOT     0xBB
99*53ee8cc1Swenshuai.xi #define MEMFMT24BIT_YC8BIT_MOT      0xAA
100*53ee8cc1Swenshuai.xi #define MEMFMT24BIT_YC10BIT         0x99
101*53ee8cc1Swenshuai.xi #define MEMFMT24BIT_YC8BIT          0x88
102*53ee8cc1Swenshuai.xi #define MEMFMT24BIT_CLEAR           0x00
103*53ee8cc1Swenshuai.xi 
104*53ee8cc1Swenshuai.xi #define SC_FILTER_Y_SRAM1               0x00
105*53ee8cc1Swenshuai.xi #define SC_FILTER_Y_SRAM2               0x01
106*53ee8cc1Swenshuai.xi #define SC_FILTER_Y_SRAM3               0x02
107*53ee8cc1Swenshuai.xi #define SC_FILTER_Y_SRAM4               0x03
108*53ee8cc1Swenshuai.xi #define SC_FILTER_C_SRAM1               0x04
109*53ee8cc1Swenshuai.xi #define SC_FILTER_C_SRAM2               0x05
110*53ee8cc1Swenshuai.xi #define SC_FILTER_C_SRAM3               0x06
111*53ee8cc1Swenshuai.xi #define SC_FILTER_C_SRAM4               0x07
112*53ee8cc1Swenshuai.xi #define SC_FILTER_SRAM_COLOR_INDEX      0x08
113*53ee8cc1Swenshuai.xi #define SC_FILTER_SRAM_COLOR_GAIN_SNR   0x09
114*53ee8cc1Swenshuai.xi #define SC_FILTER_SRAM_COLOR_GAIN_DNR   0x0A
115*53ee8cc1Swenshuai.xi #define SC_FILTER_SRAM_ICC_CRD          0x0B
116*53ee8cc1Swenshuai.xi #define SC_FILTER_SRAM_IHC_CRD          0x0C
117*53ee8cc1Swenshuai.xi #define SC_FILTER_SRAM_XVYCC_DE_GAMMA   0x0D
118*53ee8cc1Swenshuai.xi #define SC_FILTER_SRAM_XVYCC_GAMMA      0x0E
119*53ee8cc1Swenshuai.xi 
120*53ee8cc1Swenshuai.xi #define SUPPORT_SCMI_V2     TRUE
121*53ee8cc1Swenshuai.xi #define SUPPORT_DYNAMIC_MEM_FMT TRUE
122*53ee8cc1Swenshuai.xi 
123*53ee8cc1Swenshuai.xi #define PQ_SUPPORT_DEVICE_NUM 1
124*53ee8cc1Swenshuai.xi 
125*53ee8cc1Swenshuai.xi #define Y2Y_709_601_VERSION 1
126*53ee8cc1Swenshuai.xi 
127*53ee8cc1Swenshuai.xi #define REG_CHIP_REVISION           0x1ECF
128*53ee8cc1Swenshuai.xi 
129*53ee8cc1Swenshuai.xi #define PQ_CFD_INFO
130*53ee8cc1Swenshuai.xi 
131*53ee8cc1Swenshuai.xi void Hal_PQ_init_riu_base(void *pInstance,MS_U32 u32riu_base);
132*53ee8cc1Swenshuai.xi MS_U8 Hal_PQ_get_sync_flag(void *pInstance,MS_BOOL bMainWin);
133*53ee8cc1Swenshuai.xi MS_U8 Hal_PQ_get_input_vsync_value(void *pInstance,MS_BOOL bMainWin);
134*53ee8cc1Swenshuai.xi MS_U8 Hal_PQ_get_output_vsync_value(void *pInstance,MS_BOOL bMainWin);
135*53ee8cc1Swenshuai.xi MS_U8 Hal_PQ_get_input_vsync_polarity(void *pInstance,MS_BOOL bMainWin);
136*53ee8cc1Swenshuai.xi void Hal_PQ_set_memfmt_doublebuffer(void *pInstance,MS_BOOL bEn);
137*53ee8cc1Swenshuai.xi void Hal_PQ_set_mem_fmt(void *pInstance,MS_BOOL bMainWin, MS_U16 u16val, MS_U16 u16Mask);
138*53ee8cc1Swenshuai.xi void Hal_PQ_set_mem_fmt_en(void *pInstance,MS_BOOL bMainWin, MS_U16 u16val, MS_U16 u16Mask);
139*53ee8cc1Swenshuai.xi void Hal_PQ_set_420upSample(void *pInstance,MS_U16 u16value);
140*53ee8cc1Swenshuai.xi void Hal_PQ_set_force_y_motion(void *pInstance,MS_BOOL bMainWin, MS_U16 u16value);
141*53ee8cc1Swenshuai.xi MS_U8 Hal_PQ_get_force_y_motion(void *pInstance,MS_BOOL bMainWin);
142*53ee8cc1Swenshuai.xi void Hal_PQ_set_force_c_motion(void *pInstance,MS_BOOL bMainWin, MS_U16 u16value);
143*53ee8cc1Swenshuai.xi MS_U8 Hal_PQ_get_force_c_motion(void *pInstance,MS_BOOL bMainWin);
144*53ee8cc1Swenshuai.xi void Hal_PQ_set_dipf_temporal(void *pInstance,MS_BOOL bMainWin, MS_U16 u16val);
145*53ee8cc1Swenshuai.xi MS_U16 Hal_PQ_get_dipf_temporal(void *pInstance,MS_BOOL bMainWin);
146*53ee8cc1Swenshuai.xi void Hal_PQ_set_dipf_spatial(void *pInstance,MS_BOOL bMainWin, MS_U16 u16val);
147*53ee8cc1Swenshuai.xi MS_U8 Hal_PQ_get_dipf_spatial(void *pInstance,MS_BOOL bMainWin);
148*53ee8cc1Swenshuai.xi void Hal_PQ_set_vsp_sram_filter(void *pInstance,MS_U8 u8vale);
149*53ee8cc1Swenshuai.xi MS_U8 Hal_PQ_get_vsp_sram_filter(void *pInstance);
150*53ee8cc1Swenshuai.xi void Hal_PQ_set_dnr(void *pInstance,MS_BOOL bMainWin, MS_U8 u8val);
151*53ee8cc1Swenshuai.xi MS_U8 Hal_PQ_get_dnr(void *pInstance,MS_BOOL bMainWin);
152*53ee8cc1Swenshuai.xi void Hal_PQ_set_presnr(void *pInstance,MS_BOOL bMainWin, MS_U8 u8val);
153*53ee8cc1Swenshuai.xi MS_U8 Hal_PQ_get_presnr(void *pInstance,MS_BOOL bMainWin);
154*53ee8cc1Swenshuai.xi void Hal_PQ_set_film(void *pInstance,MS_BOOL bMainWin, MS_U16 u16val);
155*53ee8cc1Swenshuai.xi MS_U8 Hal_PQ_get_film(void *pInstance,MS_BOOL bMainWin);
156*53ee8cc1Swenshuai.xi void Hal_PQ_set_c_sram_table(void *pInstance,MS_U8 u8sramtype, void *pData);
157*53ee8cc1Swenshuai.xi void Hal_PQ_set_y_sram_table(void *pInstance,MS_U8 u8sramtype, void *pData);
158*53ee8cc1Swenshuai.xi void Hal_PQ_set_c_sram_table_Main2(void *pInstance,MS_U8 u8sramtype, void *pData);
159*53ee8cc1Swenshuai.xi void Hal_PQ_set_y_sram_table_Main2(void *pInstance,MS_U8 u8sramtype, void *pData);
160*53ee8cc1Swenshuai.xi void Hal_PQ_set_sram_color_index_table(void *pInstance,MS_U8 u8sramtype, void *pData);
161*53ee8cc1Swenshuai.xi void Hal_PQ_set_sram_color_gain_snr_table(void *pInstance,MS_U8 u8sramtype, void *pData);
162*53ee8cc1Swenshuai.xi void Hal_PQ_set_sram_color_gain_dnr_table(void *pInstance,MS_U8 u8sramtype, void *pData);
163*53ee8cc1Swenshuai.xi MS_U16 Hal_PQ_get_hnonlinear_idx(void *pInstance,MS_HNONLINEAR_TYPE etype);
164*53ee8cc1Swenshuai.xi MS_U8 Hal_PQ_get_madi_fbl_mode(void *pInstance,MS_BOOL bMemFmt422,MS_BOOL bInterlace);
165*53ee8cc1Swenshuai.xi MS_U16 Hal_PQ_get_sram_size(void *pInstance,MS_U16 u16sramtype);
166*53ee8cc1Swenshuai.xi void Hal_PQ_OPWriteOff_Enable(void *pInstance,MS_BOOL bEna);
167*53ee8cc1Swenshuai.xi void Hal_PQ_set_sram_ihc_crd_table(void *pInstance,MS_U8 u8sramtype, void *pData);
168*53ee8cc1Swenshuai.xi void Hal_PQ_set_sram_icc_crd_table(void *pInstance,MS_U8 u8sramtype, void *pData);
169*53ee8cc1Swenshuai.xi MS_U16 Hal_PQ_get_rw_method(void *pInstance,MS_BOOL bMainWin);
170*53ee8cc1Swenshuai.xi void Hal_PQ_set_rw_method(void *pInstance,MS_BOOL bMainWin, MS_U16 u16method);
171*53ee8cc1Swenshuai.xi void Hal_PQ_set_xvycc_matrix_coefficient(void *pInstance,MS_S32 pData[][3], MS_BOOL bMainWin);
172*53ee8cc1Swenshuai.xi void Hal_PQ_set_xvycc_matrix_enable(void *pInstance,MS_BOOL bEnable, MS_BOOL bMainWin);
173*53ee8cc1Swenshuai.xi MS_BOOL HAL_PQ_user_mode_control(void *pInstance);
174*53ee8cc1Swenshuai.xi void HAL_PQ_set_SelectCSC(void *pInstance,MS_U16 u16selection, MS_BOOL  bMainWin);
175*53ee8cc1Swenshuai.xi void Hal_PQ_set_sram_xvycc_gamma_table(void *pInstance,MS_U8 u8sramtype, void *pData);
176*53ee8cc1Swenshuai.xi void Hal_PQ_set_UFSC_c_sram_table(void *pInstance, MS_U8 u8sramtype, void *pData);
177*53ee8cc1Swenshuai.xi void Hal_PQ_set_UFSC_y_sram_table(void *pInstance, MS_U8 u8sramtype, void *pData);
178*53ee8cc1Swenshuai.xi void Hal_PQ_set_UFSC_sram_ihc_crd_table(void *pInstance, MS_U8 u8sramtype, void *pData);
179*53ee8cc1Swenshuai.xi void Hal_PQ_set_UFSC_sram_icc_crd_table(void *pInstance, MS_U8 u8sramtype, void *pData);
180*53ee8cc1Swenshuai.xi MS_BOOL Hal_PQ_get_cfd_info(MS_U16 u16PqIndex, MS_U8 *pu8ColorFormat, MS_U8 *pu8ColorDataFormat, MS_BOOL *pbIsFullRange, MS_U8 *pu8ColorPrimaries, MS_U8 *pu8TransferCharacteristics, MS_U8 *pu8MatrixCoefficients);
181*53ee8cc1Swenshuai.xi #endif
182*53ee8cc1Swenshuai.xi 
183*53ee8cc1Swenshuai.xi 
184