xref: /utopia/UTPA2-700.0.x/mxlib/include/apiXC_Cus.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) 2006-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 /// @file  apiXC_PCMonitor.h
94 /// @brief header file
95 /// @author MStar Semiconductor Inc.
96 ///
97 ////////////////////////////////////////////////////////////////////////////////
98 #ifndef _API_XC_CUS_H_
99 #define _API_XC_CUS_H_
100 
101 #include "apiXC.h"
102 #include "apiXC_DWIN.h"
103 #include "apiXC_Adc.h"
104 #include "apiXC_Auto.h"
105 #include "apiXC_PCMonitor.h"
106 #include "apiXC_ModeParse.h"
107 #include "drvXC_HDMI_if.h"
108 
109 
110 #ifdef __cplusplus
111 extern "C"
112 {
113 #endif
114 
115 #ifdef STELLAR
116 
117 #define MAX_CUS_PQ_PARA_ELEMENT    4
118 
119 typedef enum
120 {
121     E_XC_S_DISPLAY_INITMISC_A_NULL                 = 0x0000,
122     E_XC_S_DISPLAY_INITMISC_A_FIRE_DISABLE_ML      = 0x0001,
123     E_XC_S_DISPLAY_INITMISC_A_NO_DELAY_ML          = 0x0002,
124     E_XC_S_DISPLAY_INITMISC_A_ADC_HW_AUTOGAIN      = 0x0004,
125     E_XC_S_DISPLAY_INITMISC_A_3D_ML                = 0x0008,
126     E_XC_S_DISPLAY_INITMISC_A_SKIP_ML_HTT_VTT      = 0x0010,
127     E_XC_S_DISPLAY_INITMISC_A_PC_MONITOR_MUTE      = 0x0020,
128     E_XC_S_DISPLAY_INITMISC_A_NO_DELAY_GET_VTT     = 0x0040,
129     E_XC_S_DISPLAY_INITMISC_A_ENABLE_CVBSOX_ADCX   = 0x0080,
130 } E_XC_S_DISPLAY_INIT_MISC_A;
131 
132 typedef enum
133 {
134     E_XC_S_DISPLAY_TESTPATTERN_IPMUX,
135     E_XC_S_DISPLAY_TESTPATTERN_IP1,
136     E_XC_S_DISPLAY_TESTPATTERN_VOP,
137     E_XC_S_DISPLAY_TESTPATTERN_VOP2,
138     E_XC_S_DISPLAY_TESTPATTERN_OP1,
139     E_XC_S_DISPLAY_TESTPATTERN_OP2,
140     E_XC_S_DISPLAY_TESTPATTERN_MOD,
141 }E_XC_S_DISPLAY_TESTPATTERN;
142 
143 typedef enum
144 {
145     /* Please follow Naming Rule,
146     ** EX:
147     **      E_XC_CUS_xxxx_yyyy;
148     **      xxx is the object to operate
149     **      yyy is the operation you need to take, which include [SET/GET/EN/DISE/DUMP]
150     */
151     E_XC_S_DISPLAY_ADCGainOffset_GET,
152     E_XC_S_DISPLAY_DEWin_SET,
153     E_XC_S_DISPLAY_ADCRBSwap_SET,
154     E_XC_S_DISPLAY_LRBlackBar_SET,
155     E_XC_S_DISPLAY_ScartOverlay_SET,
156     E_XC_S_DISPLAY_Resolution_GET,
157     E_XC_S_DISPLAY_TESTPATTERN_SET,
158     E_XC_S_DISPLAY_INITMISC_SET,
159     E_XC_S_DISPLAY_INITMISC_GET,
160     E_XC_S_DISPLAY_STATUS_GET,
161 
162     // Customized PQ functions
163     E_XC_S_PQ_SetICCYModelEnable = 0x100,
164     E_XC_S_PQ_SetIHCYModelEnable,
165     E_XC_S_PQ_SetIHCHueEnable,
166     E_XC_S_PQ_SetICCSaturationEnable,
167     E_XC_S_PQ_SetBlueStretchEnable,
168     E_XC_S_PQ_SetICCSaturationAdj,
169     E_XC_S_PQ_SetIHCHueAdj,
170     E_XC_S_PQ_SetIBCYAdj,
171     E_XC_S_PQ_SetIHCSkinHueAdj,
172     E_XC_S_PQ_SetICCDecreaseGainAdj,
173     E_XC_S_PQ_SetMotionCountThreshold,
174     E_XC_S_PQ_SetScaleFilter,
175     E_XC_S_PQ_DLCInit,
176     E_XC_S_PQ_SetPieceWiseEnable,
177     E_XC_S_PQ_SetColorAdaptiveRange,
178     E_XC_S_PQ_SetHistogramReqEnable,
179     E_XC_S_PQ_SetIBCYEnable,
180     E_XC_S_PQ_SetAdaptiveCGainEnable,
181     E_XC_S_PQ_SetCDNRIndex,
182     E_XC_S_PQ_SetCDNRGain,
183     E_XC_S_PQ_SetCDNREnable,
184     E_XC_S_PQ_SetAdaptiveCGain,
185     E_XC_S_PQ_OPC_GetAverage,
186     E_XC_S_PQ_PQ_OPC_GetMAXValue,
187     E_XC_S_PQ_PQ_OPC_GetLDData,
188     E_XC_S_PQ_PQ_OPC_GetMotionData,
189     E_XC_S_PQ_PQ_OPC_SetBLData,
190     E_XC_S_PQ_PQ_OPC_Enable,
191     E_XC_S_PQ_PQ_MACE_SetBlueStretchData,
192     E_XC_S_PQ_PQ_GetBlueStretchInfo,
193     E_XC_S_PQ_PQ_SET_THXMode,
194     E_XC_S_PQ_PQ_SetFilmMode_CUS,
195 }E_XC_S_DISPLAY_CTRL_ID;
196 
197 typedef struct
198 {
199     MS_U16 u16HStart;
200     MS_U16 u16HEnd;
201     MS_U16 u16VStart;
202     MS_U16 u16VEnd;
203 }XC_S_DISPLAY_DEWin_SET;
204 typedef struct
205 {
206     MS_BOOL bEnable;
207     MS_U32 u32Width;
208 }XC_S_DISPLAY_LRBlackBar_SET;
209 typedef struct
210 {
211     MS_BOOL bOverlay;
212 }XC_S_DISPLAY_ScartOverlay_SET;
213 typedef struct
214 {
215     MS_BOOL bEnable;
216     INPUT_SOURCE_TYPE_t enInputPortType;
217 }XC_S_DISPLAY_ADCRBSwap_SET;
218 
219 typedef enum
220 {
221     ADC_COLOR_RED = 0,
222     ADC_COLOR_GREEN = 1,
223     ADC_COLOR_BLUE = 2,
224     ADC_COLOR_Y = 3,
225 } HAL_ADC_COLOR_t;
226 typedef struct
227 {
228     EN_RESOLUTION_TYPE enReolution;
229     MS_MODE_RESOLUTION resl;
230 }XC_S_DISPLAY_Resolution_GET;
231 
232 typedef struct
233 {
234     SCALER_WIN eWindow;
235     MS_U16 u16Pattern_type;
236     MS_U16  u16Enable;
237     MS_U16  u16Pattern[4];
238 }XC_S_DISPLAY_TESTPATTERN_SET;
239 
240 typedef struct
241 {
242     MS_U32 u32CusMISC_A;
243     MS_U32 u32CusMISC_B;
244 } XC_S_DISPLAY_INITMISC;
245 
246 typedef struct
247 {
248     SCALER_WIN eWindow;
249     MS_U16 u16OutputVFreqAfterFRC;
250     MS_U8 u8SyncStatus;
251     MS_U16 u16InputHperiod;
252     MS_U16 u16InputVTotal;
253     MS_U16 u16InputHFreq;
254     MS_U16 u16InputVFreq;
255     MS_U32 u32InputAccurateVFreq;
256 } XC_S_DISPLAY_STATUS_GET;
257 
258 typedef struct
259 {
260     MS_U8       u8WinIdx;
261     MS_BOOL     bPara[MAX_CUS_PQ_PARA_ELEMENT];
262     MS_U8       u8Para[MAX_CUS_PQ_PARA_ELEMENT];
263     MS_S8       s8Para[MAX_CUS_PQ_PARA_ELEMENT];
264     MS_U16      u16Para[MAX_CUS_PQ_PARA_ELEMENT];
265     void*       pPara[MAX_CUS_PQ_PARA_ELEMENT];
266     void*       pReturn;
267 }XC_S_CUS_PQ_SETTINGS;
268 
269 #endif
270 
271 #ifdef __cplusplus
272 }
273 #endif
274 
275 #endif /* _API_XC_CUS_H_ */
276