xref: /utopia/UTPA2-700.0.x/modules/demodulator/drv/dvb_extdemod/drvDMD_EXTERN_MSB201X.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") 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 ///////////////////////////////////////////////////////////////////////////////////////////////////
96*53ee8cc1Swenshuai.xi ///
97*53ee8cc1Swenshuai.xi /// @file   drvDMD_EXTERN_MSB201X.h
98*53ee8cc1Swenshuai.xi /// @brief  MSB201X Driver Interface
99*53ee8cc1Swenshuai.xi /// @author MStar Semiconductor Inc.
100*53ee8cc1Swenshuai.xi ///////////////////////////////////////////////////////////////////////////////////////////////////
101*53ee8cc1Swenshuai.xi 
102*53ee8cc1Swenshuai.xi #ifndef _DRV_DVBC_H_
103*53ee8cc1Swenshuai.xi #define _DRV_DVBC_H_
104*53ee8cc1Swenshuai.xi 
105*53ee8cc1Swenshuai.xi #include "MsCommon.h"
106*53ee8cc1Swenshuai.xi //#include "drvDMD_common.h"
107*53ee8cc1Swenshuai.xi #ifdef __cplusplus
108*53ee8cc1Swenshuai.xi extern "C"
109*53ee8cc1Swenshuai.xi {
110*53ee8cc1Swenshuai.xi #endif
111*53ee8cc1Swenshuai.xi 
112*53ee8cc1Swenshuai.xi 
113*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
114*53ee8cc1Swenshuai.xi //  Driver Capability
115*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
116*53ee8cc1Swenshuai.xi #define SUPPORT_MULTI_DEMOD      1  //0
117*53ee8cc1Swenshuai.xi 
118*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
119*53ee8cc1Swenshuai.xi //  Macro and Define
120*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
121*53ee8cc1Swenshuai.xi #define MSIF_DMD_MSB201X_INTERN_LIB_CODE           {'1','2', '4','x'} //Lib code
122*53ee8cc1Swenshuai.xi #define MSIF_DMD_MSB201X_INTERN_LIBVER             {'0','1'}      //LIB version
123*53ee8cc1Swenshuai.xi #define MSIF_DMD_MSB201X_INTERN_BUILDNUM           {'0','0' }    //Build Number
124*53ee8cc1Swenshuai.xi #define MSIF_DMD_MSB201X_INTERN_CHANGELIST         {'0','0','0','0','0','0','0','0'} //P4 ChangeList Number
125*53ee8cc1Swenshuai.xi 
126*53ee8cc1Swenshuai.xi #define DEMOD_MAX_INSTANCE 2
127*53ee8cc1Swenshuai.xi #define DEMOD_MAX_CHANNEL 2
128*53ee8cc1Swenshuai.xi 
129*53ee8cc1Swenshuai.xi #define DMD_MSB201X_EXTERN_VER                 /* Character String for DRV/API version             */  \
130*53ee8cc1Swenshuai.xi     MSIF_TAG,                           /* 'MSIF'                                           */  \
131*53ee8cc1Swenshuai.xi     MSIF_CLASS,                         /* '00'                                             */  \
132*53ee8cc1Swenshuai.xi     MSIF_CUS,                           /* 0x0000                                           */  \
133*53ee8cc1Swenshuai.xi     MSIF_MOD,                           /* 0x0000                                           */  \
134*53ee8cc1Swenshuai.xi     MSIF_CHIP,                                                                                  \
135*53ee8cc1Swenshuai.xi     MSIF_CPU,                                                                                   \
136*53ee8cc1Swenshuai.xi     MSIF_DMD_MSB201X_INTERN_LIB_CODE,      /* IP__                                             */  \
137*53ee8cc1Swenshuai.xi     MSIF_DMD_MSB201X_INTERN_LIBVER,        /* 0.0 ~ Z.Z                                        */  \
138*53ee8cc1Swenshuai.xi     MSIF_DMD_MSB201X_INTERN_BUILDNUM,      /* 00 ~ 99                                          */  \
139*53ee8cc1Swenshuai.xi     MSIF_DMD_MSB201X_INTERN_CHANGELIST,    /* CL#                                              */  \
140*53ee8cc1Swenshuai.xi     MSIF_OS
141*53ee8cc1Swenshuai.xi 
142*53ee8cc1Swenshuai.xi #define IS_BITS_SET(val, bits)                  (((val)&(bits)) == (bits))
143*53ee8cc1Swenshuai.xi 
144*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
145*53ee8cc1Swenshuai.xi //  Type and Structure
146*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
147*53ee8cc1Swenshuai.xi 
148*53ee8cc1Swenshuai.xi typedef enum
149*53ee8cc1Swenshuai.xi {
150*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DBGLV_NONE,    // disable all the debug message
151*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DBGLV_INFO,    // information
152*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DBGLV_NOTICE,  // normal but significant condition
153*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DBGLV_WARNING, // warning conditions
154*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DBGLV_ERR,     // error conditions
155*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DBGLV_CRIT,    // critical conditions
156*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DBGLV_ALERT,   // action must be taken immediately
157*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DBGLV_EMERG,   // system is unusable
158*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DBGLV_DEBUG,   // debug-level messages
159*53ee8cc1Swenshuai.xi } eDMD_MSB201X_DbgLv;
160*53ee8cc1Swenshuai.xi 
161*53ee8cc1Swenshuai.xi typedef enum
162*53ee8cc1Swenshuai.xi {
163*53ee8cc1Swenshuai.xi     E_DMD_DVBC_PARAM_VERSION,           //0x00
164*53ee8cc1Swenshuai.xi     E_DMD_DVBC_OP_AUTO_IQ,
165*53ee8cc1Swenshuai.xi     E_DMD_DVBC_OP_AUTO_SCAN_SYM_RATE,
166*53ee8cc1Swenshuai.xi     E_DMD_DVBC_OP_AUTO_SCAN_QAM,
167*53ee8cc1Swenshuai.xi     E_DMD_DVBC_OP_ZIF_EN,
168*53ee8cc1Swenshuai.xi     E_DMD_DVBC_OP_LIF_EN,
169*53ee8cc1Swenshuai.xi     E_DMD_DVBC_IF_INV_PWM_OUT_EN,
170*53ee8cc1Swenshuai.xi     E_DMD_DVBC_CFG_FIF_L,
171*53ee8cc1Swenshuai.xi     E_DMD_DVBC_CFG_FIF_H,
172*53ee8cc1Swenshuai.xi     E_DMD_DVBC_CFG_BW0_L,
173*53ee8cc1Swenshuai.xi     E_DMD_DVBC_CFG_BW0_H,
174*53ee8cc1Swenshuai.xi     E_DMD_DVBC_CFG_QAM,
175*53ee8cc1Swenshuai.xi     E_DMD_DVBC_CFG_IQ_SWAP,
176*53ee8cc1Swenshuai.xi     E_DMD_DVBC_CFG_CCI,
177*53ee8cc1Swenshuai.xi     E_DMD_DVBC_AGC_REF_L,
178*53ee8cc1Swenshuai.xi     E_DMD_DVBC_AGC_REF_H,
179*53ee8cc1Swenshuai.xi     E_DMD_DVBC_NO_SIGNAL_NUM_TH,
180*53ee8cc1Swenshuai.xi     E_DMD_DVBC_NO_SIGNAL_GAIN_TH_L,
181*53ee8cc1Swenshuai.xi     E_DMD_DVBC_NO_SIGNAL_GAIN_TH_H,
182*53ee8cc1Swenshuai.xi     E_DMD_DVBC_NO_SIGNAL_ERR_TH_L,
183*53ee8cc1Swenshuai.xi     E_DMD_DVBC_NO_SIGNAL_ERR_TH_H,
184*53ee8cc1Swenshuai.xi     E_DMD_DVBC_CHIP_VERSION,	//0x10
185*53ee8cc1Swenshuai.xi }  eDMD_MSB201X_Param;
186*53ee8cc1Swenshuai.xi 
187*53ee8cc1Swenshuai.xi typedef enum
188*53ee8cc1Swenshuai.xi {
189*53ee8cc1Swenshuai.xi     DMD_DVBC_QAM16 = 0,
190*53ee8cc1Swenshuai.xi     DMD_DVBC_QAM32 = 1,
191*53ee8cc1Swenshuai.xi     DMD_DVBC_QAM64 = 2,
192*53ee8cc1Swenshuai.xi     DMD_DVBC_QAM128 = 3,
193*53ee8cc1Swenshuai.xi     DMD_DVBC_QAM256 = 4,
194*53ee8cc1Swenshuai.xi     DMD_DVBC_QAMAUTO = 128,
195*53ee8cc1Swenshuai.xi } eDMD_MSB201X_MODULATION_TYPE;
196*53ee8cc1Swenshuai.xi 
197*53ee8cc1Swenshuai.xi typedef enum
198*53ee8cc1Swenshuai.xi {
199*53ee8cc1Swenshuai.xi     DMD_DVBC_GETLOCK,
200*53ee8cc1Swenshuai.xi     DMD_DVBC_GETLOCK_FEC_LOCK,
201*53ee8cc1Swenshuai.xi     DMD_DVBC_GETLOCK_PSYNC_LOCK,
202*53ee8cc1Swenshuai.xi     DMD_DVBC_GETLOCK_TPS_LOCK,
203*53ee8cc1Swenshuai.xi     DMD_DVBC_GETLOCK_DCR_LOCK,
204*53ee8cc1Swenshuai.xi     DMD_DVBC_GETLOCK_AGC_LOCK,
205*53ee8cc1Swenshuai.xi     DMD_DVBC_GETLOCK_MODE_DET,
206*53ee8cc1Swenshuai.xi     DMD_DVBC_GETLOCK_NO_CHANNEL,
207*53ee8cc1Swenshuai.xi     DMD_DVBC_GETLOCK_ATV_DETECT,
208*53ee8cc1Swenshuai.xi     DMD_DVBC_GETLOCK_TR_LOCK,
209*53ee8cc1Swenshuai.xi     DMD_DVBC_GETLOCK_TR_EVER_LOCK,
210*53ee8cc1Swenshuai.xi } eDMD_MSB201X_GETLOCK_TYPE;
211*53ee8cc1Swenshuai.xi 
212*53ee8cc1Swenshuai.xi typedef enum
213*53ee8cc1Swenshuai.xi {
214*53ee8cc1Swenshuai.xi     DMD_DVBC_LOCK,
215*53ee8cc1Swenshuai.xi     DMD_DVBC_CHECKING,
216*53ee8cc1Swenshuai.xi     DMD_DVBC_CHECKEND,
217*53ee8cc1Swenshuai.xi     DMD_DVBC_UNLOCK,
218*53ee8cc1Swenshuai.xi     DMD_DVBC_NULL,
219*53ee8cc1Swenshuai.xi } eDMD_MSB201X_LOCK_STATUS;
220*53ee8cc1Swenshuai.xi 
221*53ee8cc1Swenshuai.xi typedef enum
222*53ee8cc1Swenshuai.xi {
223*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DEMOD_I2C_DYNAMIC_SLAVE_ID_1,
224*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DEMOD_I2C_DYNAMIC_SLAVE_ID_2,
225*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DEMOD_I2C_DYNAMIC_SLAVE_ID_3,
226*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DEMOD_I2C_DYNAMIC_SLAVE_ID_4
227*53ee8cc1Swenshuai.xi } eDMD_MSB201X_DemodI2CSlaveID;
228*53ee8cc1Swenshuai.xi 
229*53ee8cc1Swenshuai.xi typedef enum
230*53ee8cc1Swenshuai.xi {
231*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DEMOD_I2C_READ_BYTES,
232*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DEMOD_I2C_WRITE_BYTES
233*53ee8cc1Swenshuai.xi } eDMD_MSB201X_DemodI2CMethod;
234*53ee8cc1Swenshuai.xi 
235*53ee8cc1Swenshuai.xi 
236*53ee8cc1Swenshuai.xi typedef enum
237*53ee8cc1Swenshuai.xi {
238*53ee8cc1Swenshuai.xi     DEMOD0,
239*53ee8cc1Swenshuai.xi     DEMOD1,
240*53ee8cc1Swenshuai.xi     ALL_DEMOD
241*53ee8cc1Swenshuai.xi } eDMD_MSB201X_Demod_Index;
242*53ee8cc1Swenshuai.xi 
243*53ee8cc1Swenshuai.xi typedef struct
244*53ee8cc1Swenshuai.xi {
245*53ee8cc1Swenshuai.xi     float   power_db;
246*53ee8cc1Swenshuai.xi     MS_U8   agc_val;
247*53ee8cc1Swenshuai.xi }sDMD_MSB201X_IFAGC_SSI;
248*53ee8cc1Swenshuai.xi 
249*53ee8cc1Swenshuai.xi typedef struct
250*53ee8cc1Swenshuai.xi {
251*53ee8cc1Swenshuai.xi     float   attn_db;
252*53ee8cc1Swenshuai.xi     MS_U8   agc_err;
253*53ee8cc1Swenshuai.xi }sDMD_MSB201X_IFAGC_ERR;
254*53ee8cc1Swenshuai.xi 
255*53ee8cc1Swenshuai.xi typedef struct
256*53ee8cc1Swenshuai.xi {
257*53ee8cc1Swenshuai.xi     MS_U16 u16Version;
258*53ee8cc1Swenshuai.xi     MS_U16 u16SymbolRate;
259*53ee8cc1Swenshuai.xi     eDMD_MSB201X_MODULATION_TYPE eQamMode;
260*53ee8cc1Swenshuai.xi     MS_U32 u32IFFreq;
261*53ee8cc1Swenshuai.xi     MS_BOOL bSpecInv;
262*53ee8cc1Swenshuai.xi     MS_BOOL bSerialTS;
263*53ee8cc1Swenshuai.xi     MS_U8 u8SarValue;
264*53ee8cc1Swenshuai.xi     MS_U32 u32ChkScanTimeStart;
265*53ee8cc1Swenshuai.xi     MS_U16 u16Strength;
266*53ee8cc1Swenshuai.xi     MS_U16 u16Quality;
267*53ee8cc1Swenshuai.xi     MS_U32 u32Intp; //
268*53ee8cc1Swenshuai.xi     MS_U32 u32FcFs; //
269*53ee8cc1Swenshuai.xi     MS_U8 u8Qam; //
270*53ee8cc1Swenshuai.xi     MS_U16 u16SymbolRateHal; //
271*53ee8cc1Swenshuai.xi } sDMD_MSB201X_Info;
272*53ee8cc1Swenshuai.xi 
273*53ee8cc1Swenshuai.xi typedef struct
274*53ee8cc1Swenshuai.xi {
275*53ee8cc1Swenshuai.xi     sDMD_MSB201X_IFAGC_SSI *pIFAGC_SSI;
276*53ee8cc1Swenshuai.xi     sDMD_MSB201X_IFAGC_ERR *pIFAGC_ERR;
277*53ee8cc1Swenshuai.xi     MS_U16 IFAGC_SSI_Length;
278*53ee8cc1Swenshuai.xi     MS_U16 IFAGC_ERR_Length;
279*53ee8cc1Swenshuai.xi } sDMD_MSB201X_IFAGC;
280*53ee8cc1Swenshuai.xi 
281*53ee8cc1Swenshuai.xi /// For demod init
282*53ee8cc1Swenshuai.xi typedef struct
283*53ee8cc1Swenshuai.xi {
284*53ee8cc1Swenshuai.xi     MS_U8 u8WO_SPI_Flash;
285*53ee8cc1Swenshuai.xi     MS_BOOL bPreloadDSPCodeFromMainCHIPI2C;
286*53ee8cc1Swenshuai.xi     MS_BOOL bFlashWPEnable;
287*53ee8cc1Swenshuai.xi     void (*fpGPIOReset)(MS_BOOL bOnOff);
288*53ee8cc1Swenshuai.xi     MS_BOOL (*fpMSB201X_I2C_Access)(MS_U8 u8DevID, eDMD_MSB201X_DemodI2CMethod eMethod, MS_U8 u8AddrSize, MS_U8 *pu8Addr, MS_U16 u16Size, MS_U8 *pu8Data);
289*53ee8cc1Swenshuai.xi     MS_U8* pDVBC_DSP_REG;
290*53ee8cc1Swenshuai.xi     MS_U8 DVBC_DSP_REG_Length;
291*53ee8cc1Swenshuai.xi     sDMD_MSB201X_IFAGC IFAGC_Data[DEMOD_MAX_CHANNEL];
292*53ee8cc1Swenshuai.xi     MS_BOOL bEnableSPILoadCode;
293*53ee8cc1Swenshuai.xi     void (*fpMSB201X_SPIPAD_En)(MS_BOOL bOnOff);
294*53ee8cc1Swenshuai.xi     MS_U8 u8WO_Sdram;// 1 means no sdram on board
295*53ee8cc1Swenshuai.xi } sDMD_MSB201X_InitData;
296*53ee8cc1Swenshuai.xi 
297*53ee8cc1Swenshuai.xi 
298*53ee8cc1Swenshuai.xi typedef enum
299*53ee8cc1Swenshuai.xi {
300*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DEMOD_NONE,
301*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_DEMOD_DVBC,
302*53ee8cc1Swenshuai.xi } eDMD_MSB201X_DemodulatorType;
303*53ee8cc1Swenshuai.xi 
304*53ee8cc1Swenshuai.xi 
305*53ee8cc1Swenshuai.xi //TS parameter area
306*53ee8cc1Swenshuai.xi typedef enum
307*53ee8cc1Swenshuai.xi {
308*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_PARALLEL,
309*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_3_WIRE_REMUX2TS0,
310*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_3_WIRE_REMUX2TS1,
311*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_3_WIRE_REMUX2TS2,
312*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_3_WIRE_REMUX2TS3,
313*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_3_WIRE_REMUX2TS4,
314*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_3_WIRE_REMUX2TS5,
315*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_3_WIRE_REMUX2TS6,
316*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_3_WIRE_REMUX2TS7,
317*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_3_WIRE_DMD0_TS0_DMD1_TS1,
318*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_3_WIRE_DMD0_TS1_DMD1_TS0,
319*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_4_WIRE_REMUX2TS0,
320*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_4_WIRE_REMUX2TS1,
321*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_4_WIRE_REMUX2TS2,
322*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_4_WIRE_REMUX2TS3,
323*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_4_WIRE_REMUX2TS4,
324*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_4_WIRE_REMUX2TS5,
325*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_4_WIRE_DMD0_TS0_DMD1_TS1,
326*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_4_WIRE_DMD0_TS1_DMD1_TS0,
327*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_TS_MODE_MAX
328*53ee8cc1Swenshuai.xi }eDMD_MSB201X_TS_MODE;
329*53ee8cc1Swenshuai.xi 
330*53ee8cc1Swenshuai.xi typedef enum
331*53ee8cc1Swenshuai.xi {
332*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_TS_CLK_AUTO   ,
333*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_TS_CLK_216MHz ,
334*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_TS_CLK_108MHz ,
335*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_TS_CLK_72MHz  ,
336*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_TS_CLK_54MHz  ,
337*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_TS_CLK_43p2MHz,
338*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_TS_CLK_36MHz  ,
339*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_TS_CLK_30p8MHz,
340*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_TS_CLK_27MHz  ,
341*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_TS_CLK_24MHz  ,
342*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_TS_CLK_21p6MHz,
343*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_TS_CLK_19p6MHz,
344*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_TS_CLK_18MHz  ,
345*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_TS_CLK_16p6MHz,
346*53ee8cc1Swenshuai.xi 		E_DMD_MSB201X_TS_CLK_15p4MHz,
347*53ee8cc1Swenshuai.xi 		E_DMD_MSB201X_TS_CLK_14p4MHz,
348*53ee8cc1Swenshuai.xi 		E_DMD_MSB201X_TS_CLK_13p5MHz,
349*53ee8cc1Swenshuai.xi 		E_DMD_MSB201X_TS_CLK_MAX    ,
350*53ee8cc1Swenshuai.xi } eDMD_MSB201X_TS_CLK;
351*53ee8cc1Swenshuai.xi 
352*53ee8cc1Swenshuai.xi typedef enum
353*53ee8cc1Swenshuai.xi {
354*53ee8cc1Swenshuai.xi 		E_DMD_MSB201X_TS_DRVING_LO,    //4mA
355*53ee8cc1Swenshuai.xi 		E_DMD_MSB201X_TS_DRVING_HI,    //8mA
356*53ee8cc1Swenshuai.xi     E_DMD_MSB201X_TS_DRVING_MAX    //8mA
357*53ee8cc1Swenshuai.xi } eDMD_MSB201X_TS_DRVING;
358*53ee8cc1Swenshuai.xi 
359*53ee8cc1Swenshuai.xi typedef enum
360*53ee8cc1Swenshuai.xi {
361*53ee8cc1Swenshuai.xi     E_MSB201X_I2C_READ_WRITE,
362*53ee8cc1Swenshuai.xi     E_MSB201X_SPI_READ_WRITE,
363*53ee8cc1Swenshuai.xi } e_MSB201X_DSP_ReadWrite;
364*53ee8cc1Swenshuai.xi 
365*53ee8cc1Swenshuai.xi typedef struct
366*53ee8cc1Swenshuai.xi {
367*53ee8cc1Swenshuai.xi   MS_BOOL  bEnable[DEMOD_MAX_CHANNEL];
368*53ee8cc1Swenshuai.xi   eDMD_MSB201X_TS_MODE eTSMode;
369*53ee8cc1Swenshuai.xi   eDMD_MSB201X_TS_CLK eTSClk;
370*53ee8cc1Swenshuai.xi   eDMD_MSB201X_TS_DRVING eTSDrv;
371*53ee8cc1Swenshuai.xi   MS_BOOL bLSB1st[DEMOD_MAX_CHANNEL];
372*53ee8cc1Swenshuai.xi   MS_BOOL bRemuxLSB1st;
373*53ee8cc1Swenshuai.xi   MS_BOOL bCLKInverse;
374*53ee8cc1Swenshuai.xi } sDMD_MSB201X_TS_Param;
375*53ee8cc1Swenshuai.xi 
376*53ee8cc1Swenshuai.xi typedef struct
377*53ee8cc1Swenshuai.xi {
378*53ee8cc1Swenshuai.xi     MS_U8 *pHeaderPtr;
379*53ee8cc1Swenshuai.xi     MS_U8 u8HeaderSize;
380*53ee8cc1Swenshuai.xi     MS_BOOL bEnable;
381*53ee8cc1Swenshuai.xi } sDMD_MSB201X_extHeader;
382*53ee8cc1Swenshuai.xi 
383*53ee8cc1Swenshuai.xi typedef struct
384*53ee8cc1Swenshuai.xi {
385*53ee8cc1Swenshuai.xi     MS_U8 *pHeaderPtr;
386*53ee8cc1Swenshuai.xi     MS_BOOL bEnable;
387*53ee8cc1Swenshuai.xi } sDMD_MSB201X_CIHeader;
388*53ee8cc1Swenshuai.xi 
389*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
390*53ee8cc1Swenshuai.xi //  Function and Variable
391*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
392*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
393*53ee8cc1Swenshuai.xi //------------------------------------------------------------------------------
394*53ee8cc1Swenshuai.xi /// Set detailed level of DVBT driver debug message
395*53ee8cc1Swenshuai.xi /// u8DbgLevel : debug level for Parallel Flash driver\n
396*53ee8cc1Swenshuai.xi /// AVD_DBGLV_NONE,    ///< disable all the debug message\n
397*53ee8cc1Swenshuai.xi /// AVD_DBGLV_INFO,    ///< information\n
398*53ee8cc1Swenshuai.xi /// AVD_DBGLV_NOTICE,  ///< normal but significant condition\n
399*53ee8cc1Swenshuai.xi /// AVD_DBGLV_WARNING, ///< warning conditions\n
400*53ee8cc1Swenshuai.xi /// AVD_DBGLV_ERR,     ///< error conditions\n
401*53ee8cc1Swenshuai.xi /// AVD_DBGLV_CRIT,    ///< critical conditions\n
402*53ee8cc1Swenshuai.xi /// AVD_DBGLV_ALERT,   ///< action must be taken immediately\n
403*53ee8cc1Swenshuai.xi /// AVD_DBGLV_EMERG,   ///< system is unusable\n
404*53ee8cc1Swenshuai.xi /// AVD_DBGLV_DEBUG,   ///< debug-level messages\n
405*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
406*53ee8cc1Swenshuai.xi /// @return FALSE : failed to set the debug level
407*53ee8cc1Swenshuai.xi //------------------------------------------------------------------------------
408*53ee8cc1Swenshuai.xi //extern MS_BOOL MDrv_DMD_MSB201X_SetDbgLevel(eDMD_MSB201X_DbgLv u8DbgLevel);
409*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
410*53ee8cc1Swenshuai.xi /// Get the information of DVBT driver\n
411*53ee8cc1Swenshuai.xi /// @return the pointer to the driver information
412*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
413*53ee8cc1Swenshuai.xi //extern DMD_DVBT_Info* MDrv_DMD_DVBT_GetInfo(DMD_DVBT_INFO_TYPE eInfoType);
414*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
415*53ee8cc1Swenshuai.xi /// Get DVBT driver version
416*53ee8cc1Swenshuai.xi /// when get ok, return the pointer to the driver version
417*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
418*53ee8cc1Swenshuai.xi //extern MS_BOOL MDrv_DMD_MSB201X_GetLibVer(const MSIF_Version **ppVersion);
419*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
420*53ee8cc1Swenshuai.xi /// Get DVBT FW version
421*53ee8cc1Swenshuai.xi /// u16Addr       : the address of DVBT's register\n
422*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
423*53ee8cc1Swenshuai.xi //extern MS_BOOL MDrv_DMD_MSB201X_GetFWVer(MS_U16 *ver);
424*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
425*53ee8cc1Swenshuai.xi /// To get DVBT's register  value, only for special purpose.\n
426*53ee8cc1Swenshuai.xi /// u16Addr       : the address of DVBT's register\n
427*53ee8cc1Swenshuai.xi /// return the value of AFEC's register\n
428*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
429*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_GetReg(MS_U8 devID, MS_U32 u32Addr, MS_U8 *pu8Data);
430*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
431*53ee8cc1Swenshuai.xi /// To set DVBT's register value, only for special purpose.\n
432*53ee8cc1Swenshuai.xi /// u16Addr       : the address of DVBT's register\n
433*53ee8cc1Swenshuai.xi /// u8Value        : the value to be set\n
434*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
435*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_SetReg(MS_U8 devID, MS_U32 u32Addr, MS_U8 u8Data);
436*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
437*53ee8cc1Swenshuai.xi /// To set DVBT's register value, only for special purpose.\n
438*53ee8cc1Swenshuai.xi /// u16Addr       : the address of DVBT's register\n
439*53ee8cc1Swenshuai.xi /// u8Value        : the value to be set\n
440*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
441*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_SetRegs(MS_U8 devID, MS_U32 u32Addr, MS_U8* u8pData, MS_U16 data_size);
442*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
443*53ee8cc1Swenshuai.xi /// To set DVBT's register value, only for special purpose.\n
444*53ee8cc1Swenshuai.xi /// u16Addr       : the address of DVBT's register\n
445*53ee8cc1Swenshuai.xi /// u8Value        : the value to be set\n
446*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
447*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_SetReg2Bytes(MS_U8 devID, MS_U32 u32Addr, MS_U16 u16Data);
448*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
449*53ee8cc1Swenshuai.xi /// To get DVBT's register  value, only for special purpose.\n
450*53ee8cc1Swenshuai.xi /// u16Addr       : the address of DVBT's register\n
451*53ee8cc1Swenshuai.xi /// return the value of AFEC's register\n
452*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
453*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_GetDSPReg(MS_U8 devID, MS_U8 u8DemodIndex, MS_U16 u16Addr, MS_U8 *pu8Data);
454*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
455*53ee8cc1Swenshuai.xi /// To set DVBT's register value, only for special purpose.\n
456*53ee8cc1Swenshuai.xi /// u16Addr       : the address of DVBT's register\n
457*53ee8cc1Swenshuai.xi /// u8Value        : the value to be set\n
458*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
459*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_SetDSPReg(MS_U8 devID, MS_U8 u8DemodIndex, MS_U16 u16Addr, MS_U8 u8Data);
460*53ee8cc1Swenshuai.xi 
461*53ee8cc1Swenshuai.xi /// MDrv_DMD_MSB201X_LoadDSPCode
462*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
463*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_LoadDSPCode(MS_U8 devID);
464*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
465*53ee8cc1Swenshuai.xi /// Get lock
466*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_Demod_GetLock(MS_U8 devID, MS_U8 u8DemodIndex);
467*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////////
468*53ee8cc1Swenshuai.xi /// Demod init
469*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_Init(MS_U8 devID, MS_U8 u8DemodIndex, sDMD_MSB201X_InitData *pDMD_MSB201X_InitData, MS_U32 u32InitDataLen);
470*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////////
471*53ee8cc1Swenshuai.xi /// power on init
472*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
473*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_Power_On_Initialization(MS_U8 devID, MS_U8 u8DemodIndex);
474*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
475*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_GetPacketErr(MS_U8 devID,MS_U8 u8DemodIndex, MS_U16 *pktErr);
476*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_Restart(MS_U8 devID, MS_U8 u8DemodIndex);
477*53ee8cc1Swenshuai.xi //extern MS_BOOL MDrv_DMD_MSB201X_CfgExtHeader(MS_U8 devID, MS_U8 u8DemodIndex,  MS_U8 u8HeaderSize, MS_U8* pHeaderPtr, MS_U8 u8HeaderEnable);
478*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_Exit(MS_U8 devID);
479*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_SetActive(MS_U8 devID, MS_U8 u8DemodIndex, MS_BOOL bEnable);
480*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_GetFWVer(MS_U8 devID, MS_U8 u8DemodIndex, MS_U16 *ver);
481*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_GetPacketErr(MS_U8 devID,MS_U8 u8DemodIndex, MS_U16 *pktErr);
482*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_GetPostViterbiBer(MS_U8 devID,MS_U8 u8DemodIndex, float *ber);
483*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_GetSNR(MS_U8 devID,MS_U8 u8DemodIndex, float *fSNR);
484*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_GetLock(MS_U8 devID, MS_U8 u8DemodIndex, eDMD_MSB201X_GETLOCK_TYPE eType, eDMD_MSB201X_LOCK_STATUS *eLockStatus);
485*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_GetLockWithRFPower(MS_U8 devID, MS_U8 u8DemodIndex, eDMD_MSB201X_GETLOCK_TYPE eType, eDMD_MSB201X_LOCK_STATUS *eLockStatus, float fCurrRFPowerDbm, float fNoChannelRFPowerDbm);
486*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_GetRFLevel(MS_U8 devID, MS_U8 u8DemodIndex, float *fRFPowerDbmResult, float fRFPowerDbm);
487*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_GetStatus(MS_U8 devID, MS_U8 u8DemodIndex, eDMD_MSB201X_MODULATION_TYPE *pQAMMode, MS_U16 *u16SymbolRate, float *pFreqOff);
488*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_I2C_BYPASS(MS_U8 devID,MS_U8 bypass_en);
489*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_SetConfig(MS_U8 devID, MS_U8 u8DemodIndex, MS_U16 u16SymbolRate, eDMD_MSB201X_MODULATION_TYPE eQamMode, MS_U32 u32IFFreq, MS_BOOL bSpecInv);
490*53ee8cc1Swenshuai.xi 
491*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_CfgExtHeader(MS_U8 devID, MS_U8 u8DemodIndex,  sDMD_MSB201X_extHeader *pDMD_MSB201X_extHeader_Param);
492*53ee8cc1Swenshuai.xi extern MS_BOOL MDrv_DMD_MSB201X_Set_TSOut(MS_U8 devID, sDMD_MSB201X_TS_Param *pDMD_MSB201X_TS_Param);
493*53ee8cc1Swenshuai.xi #ifdef __cplusplus
494*53ee8cc1Swenshuai.xi }
495*53ee8cc1Swenshuai.xi #endif
496*53ee8cc1Swenshuai.xi 
497*53ee8cc1Swenshuai.xi 
498*53ee8cc1Swenshuai.xi #endif
499*53ee8cc1Swenshuai.xi 
500