xref: /utopia/UTPA2-700.0.x/mxlib/include/drvDMD_DTMB.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_DTMB.h
98*53ee8cc1Swenshuai.xi /// @brief  DTMB Driver Interface
99*53ee8cc1Swenshuai.xi /// @author MStar Semiconductor Inc.
100*53ee8cc1Swenshuai.xi ///////////////////////////////////////////////////////////////////////////////////////////////////
101*53ee8cc1Swenshuai.xi 
102*53ee8cc1Swenshuai.xi /*! \defgroup Demod Demod interface
103*53ee8cc1Swenshuai.xi 
104*53ee8cc1Swenshuai.xi  *! \defgroup DTMB DTMB interface (drvDMD_DTMB.h)
105*53ee8cc1Swenshuai.xi  *  \ingroup Demod
106*53ee8cc1Swenshuai.xi 
107*53ee8cc1Swenshuai.xi     \brief
108*53ee8cc1Swenshuai.xi 
109*53ee8cc1Swenshuai.xi     DTMB is the demodulator of supporting DTMB(6/7/8/9M) standard.
110*53ee8cc1Swenshuai.xi     Receive RF signal from Tuner and transmit demodulated data to TS module.
111*53ee8cc1Swenshuai.xi 
112*53ee8cc1Swenshuai.xi     <b>Features</b>
113*53ee8cc1Swenshuai.xi 
114*53ee8cc1Swenshuai.xi     - Support DTMB(6/7/8/9M) standard.
115*53ee8cc1Swenshuai.xi     - Pass CHINA SPEC.
116*53ee8cc1Swenshuai.xi     - Pass the field stream.
117*53ee8cc1Swenshuai.xi 
118*53ee8cc1Swenshuai.xi     <b> DTMB Block Diagram: </b> \n
119*53ee8cc1Swenshuai.xi     \image html drvDMD_DTMB_pic01.png
120*53ee8cc1Swenshuai.xi 
121*53ee8cc1Swenshuai.xi     <b> Operation Code Flow: </b> \n
122*53ee8cc1Swenshuai.xi     -# Initialize DTMB parameters and load DEMOD FW
123*53ee8cc1Swenshuai.xi     -# Enable DEMOD state machine
124*53ee8cc1Swenshuai.xi     -# Monitor lock status
125*53ee8cc1Swenshuai.xi 
126*53ee8cc1Swenshuai.xi  *! \defgroup DTMB_BASIC DTMB basic control
127*53ee8cc1Swenshuai.xi  *  \ingroup DTMB
128*53ee8cc1Swenshuai.xi 
129*53ee8cc1Swenshuai.xi  *! \defgroup DTMB_INFO DTMB information
130*53ee8cc1Swenshuai.xi  *  \ingroup DTMB
131*53ee8cc1Swenshuai.xi 
132*53ee8cc1Swenshuai.xi  *! \defgroup DTMB_STR DTMB STR
133*53ee8cc1Swenshuai.xi  *  \ingroup DTMB
134*53ee8cc1Swenshuai.xi 
135*53ee8cc1Swenshuai.xi  *! \defgroup DTMB_ToBeRemoved DTMB API to be removed
136*53ee8cc1Swenshuai.xi  *  \ingroup DTMB
137*53ee8cc1Swenshuai.xi  */
138*53ee8cc1Swenshuai.xi 
139*53ee8cc1Swenshuai.xi #ifndef _DRV_DTMB_H_
140*53ee8cc1Swenshuai.xi #define _DRV_DTMB_H_
141*53ee8cc1Swenshuai.xi 
142*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
143*53ee8cc1Swenshuai.xi //  Driver Capability
144*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
145*53ee8cc1Swenshuai.xi 
146*53ee8cc1Swenshuai.xi #if !defined UTPA2
147*53ee8cc1Swenshuai.xi #define DMD_DTMB_UTOPIA_EN                  1
148*53ee8cc1Swenshuai.xi #define DMD_DTMB_UTOPIA2_EN                 0
149*53ee8cc1Swenshuai.xi #else
150*53ee8cc1Swenshuai.xi #define DMD_DTMB_UTOPIA_EN                  0
151*53ee8cc1Swenshuai.xi #define DMD_DTMB_UTOPIA2_EN                 1
152*53ee8cc1Swenshuai.xi #endif
153*53ee8cc1Swenshuai.xi 
154*53ee8cc1Swenshuai.xi #define DMD_DTMB_STR_EN                     1
155*53ee8cc1Swenshuai.xi #define DMD_DTMB_MULTI_THREAD_SAFE          0
156*53ee8cc1Swenshuai.xi #define DMD_DTMB_MULTI_DMD_EN               1
157*53ee8cc1Swenshuai.xi 
158*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
159*53ee8cc1Swenshuai.xi //  Include Files
160*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
161*53ee8cc1Swenshuai.xi 
162*53ee8cc1Swenshuai.xi #include "MsTypes.h"
163*53ee8cc1Swenshuai.xi #if DMD_DTMB_UTOPIA_EN || DMD_DTMB_UTOPIA2_EN
164*53ee8cc1Swenshuai.xi #ifndef MSIF_TAG
165*53ee8cc1Swenshuai.xi #include "MsVersion.h"
166*53ee8cc1Swenshuai.xi #endif
167*53ee8cc1Swenshuai.xi #include "MsCommon.h"
168*53ee8cc1Swenshuai.xi #endif
169*53ee8cc1Swenshuai.xi #if DMD_DTMB_UTOPIA2_EN || DMD_DTMB_STR_EN
170*53ee8cc1Swenshuai.xi #include "utopia.h"
171*53ee8cc1Swenshuai.xi #endif
172*53ee8cc1Swenshuai.xi 
173*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
174*53ee8cc1Swenshuai.xi //  Driver Capability
175*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
176*53ee8cc1Swenshuai.xi 
177*53ee8cc1Swenshuai.xi 
178*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
179*53ee8cc1Swenshuai.xi //  Macro and Define
180*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
181*53ee8cc1Swenshuai.xi 
182*53ee8cc1Swenshuai.xi #ifndef DLL_PUBLIC
183*53ee8cc1Swenshuai.xi #define DLL_PUBLIC
184*53ee8cc1Swenshuai.xi #endif
185*53ee8cc1Swenshuai.xi 
186*53ee8cc1Swenshuai.xi #if DMD_DTMB_MULTI_DMD_EN
187*53ee8cc1Swenshuai.xi #define DMD_DTMB_MAX_DEMOD_NUM          2
188*53ee8cc1Swenshuai.xi #else
189*53ee8cc1Swenshuai.xi #define DMD_DTMB_MAX_DEMOD_NUM          1
190*53ee8cc1Swenshuai.xi #endif
191*53ee8cc1Swenshuai.xi 
192*53ee8cc1Swenshuai.xi #if DMD_DTMB_UTOPIA_EN || DMD_DTMB_UTOPIA2_EN
193*53ee8cc1Swenshuai.xi #define MSIF_DMD_DTMB_LIB_CODE          {'D','M','D','_','D','T', 'M','B','_'} //Lib code
194*53ee8cc1Swenshuai.xi #define MSIF_DMD_DTMB_LIBVER            {'0','0'}                              //LIB version
195*53ee8cc1Swenshuai.xi #define MSIF_DMD_DTMB_BUILDNUM          {'0','0' }                             //Build Number
196*53ee8cc1Swenshuai.xi #define MSIF_DMD_DTMB_CHANGELIST        {'0','0','0','0','0','0','0','0'}      //P4 ChangeList Number
197*53ee8cc1Swenshuai.xi 
198*53ee8cc1Swenshuai.xi #define DMD_DTMB_VER                    /* Character String for DRV/API version             */  \
199*53ee8cc1Swenshuai.xi     MSIF_TAG,                           /* 'MSIF'                                           */  \
200*53ee8cc1Swenshuai.xi     MSIF_CLASS,                         /* '00'                                             */  \
201*53ee8cc1Swenshuai.xi     MSIF_CUS,                           /* 0x0000                                           */  \
202*53ee8cc1Swenshuai.xi     MSIF_MOD,                           /* 0x0000                                           */  \
203*53ee8cc1Swenshuai.xi     MSIF_CHIP,                                                                                  \
204*53ee8cc1Swenshuai.xi     MSIF_CPU,                                                                                   \
205*53ee8cc1Swenshuai.xi     MSIF_DMD_DTMB_LIB_CODE,             /* IP__                                             */  \
206*53ee8cc1Swenshuai.xi     MSIF_DMD_DTMB_LIBVER,               /* 0.0 ~ Z.Z                                        */  \
207*53ee8cc1Swenshuai.xi     MSIF_DMD_DTMB_BUILDNUM,             /* 00 ~ 99                                          */  \
208*53ee8cc1Swenshuai.xi     MSIF_DMD_DTMB_CHANGELIST,           /* CL#                                              */  \
209*53ee8cc1Swenshuai.xi     MSIF_OS
210*53ee8cc1Swenshuai.xi #endif // #if DMD_DTMB_UTOPIA_EN || DMD_DTMB_UTOPIA2_EN
211*53ee8cc1Swenshuai.xi 
212*53ee8cc1Swenshuai.xi #ifndef BIT_
213*53ee8cc1Swenshuai.xi #define BIT_(n)                                 (1 << (n))
214*53ee8cc1Swenshuai.xi #endif
215*53ee8cc1Swenshuai.xi 
216*53ee8cc1Swenshuai.xi #define DMD_DTMB_LOCK_DTMB_PNP_LOCK             BIT_(0)
217*53ee8cc1Swenshuai.xi #define DMD_DTMB_LOCK_DTMB_FEC_LOCK             BIT_(1)
218*53ee8cc1Swenshuai.xi 
219*53ee8cc1Swenshuai.xi #define DMD_DTMB_LOCK_DVBC_AGC_LOCK             BIT_(8)
220*53ee8cc1Swenshuai.xi #define DMD_DTMB_LOCK_DVBC_PRE_LOCK             BIT_(9)
221*53ee8cc1Swenshuai.xi #define DMD_DTMB_LOCK_DVBC_MAIN_LOCK            BIT_(10)
222*53ee8cc1Swenshuai.xi 
223*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
224*53ee8cc1Swenshuai.xi //  Type and Structure
225*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
226*53ee8cc1Swenshuai.xi 
227*53ee8cc1Swenshuai.xi typedef enum
228*53ee8cc1Swenshuai.xi {
229*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_Exit = 0,
230*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_InitClk,
231*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_Download,
232*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_FWVERSION,
233*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_SoftReset,
234*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_SetACICoef,
235*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_SetDTMBMode,
236*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_SetModeClean,
237*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_Set_QAM_SR,
238*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_Active,
239*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_AGCLock,
240*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_DTMB_PNP_Lock,
241*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_DTMB_FEC_Lock,
242*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_DVBC_PreLock,
243*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_DVBC_Main_Lock,
244*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_GetModulation,
245*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_ReadIFAGC,
246*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_ReadFrequencyOffset,
247*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_ReadSNRPercentage,
248*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_GetPreLdpcBer,
249*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_GetPreViterbiBer,
250*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_GetPostViterbiBer,
251*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_GetSNR,
252*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_TS_INTERFACE_CONFIG,
253*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_IIC_Bypass_Mode,
254*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_SSPI_TO_GPIO,
255*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_GPIO_GET_LEVEL,
256*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_GPIO_SET_LEVEL,
257*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_GPIO_OUT_ENABLE,
258*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_DoIQSwap,
259*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_GET_REG,
260*53ee8cc1Swenshuai.xi     DMD_DTMB_HAL_CMD_SET_REG
261*53ee8cc1Swenshuai.xi } DMD_DTMB_HAL_COMMAND;
262*53ee8cc1Swenshuai.xi 
263*53ee8cc1Swenshuai.xi typedef enum
264*53ee8cc1Swenshuai.xi {
265*53ee8cc1Swenshuai.xi     DMD_DTMB_DEMOD_DTMB,
266*53ee8cc1Swenshuai.xi     DMD_DTMB_DEMOD_DTMB_7M,
267*53ee8cc1Swenshuai.xi     DMD_DTMB_DEMOD_DTMB_6M,
268*53ee8cc1Swenshuai.xi     DMD_DTMB_DEMOD_DTMB_5M,
269*53ee8cc1Swenshuai.xi     DMD_DTMB_DEMOD_DVBC_64QAM,
270*53ee8cc1Swenshuai.xi     DMD_DTMB_DEMOD_DVBC_256QAM,
271*53ee8cc1Swenshuai.xi     DMD_DTMB_DEMOD_DVBC_16QAM,
272*53ee8cc1Swenshuai.xi     DMD_DTMB_DEMOD_DVBC_32QAM,
273*53ee8cc1Swenshuai.xi     DMD_DTMB_DEMOD_DVBC_128QAM,
274*53ee8cc1Swenshuai.xi     DMD_DTMB_DEMOD_MAX,
275*53ee8cc1Swenshuai.xi     DMD_DTMB_DEMOD_NULL = DMD_DTMB_DEMOD_MAX,
276*53ee8cc1Swenshuai.xi } DMD_DTMB_DEMOD_TYPE;
277*53ee8cc1Swenshuai.xi 
278*53ee8cc1Swenshuai.xi typedef struct DLL_PACKED
279*53ee8cc1Swenshuai.xi {
280*53ee8cc1Swenshuai.xi     union
281*53ee8cc1Swenshuai.xi     {
282*53ee8cc1Swenshuai.xi         #ifdef UTPA2
283*53ee8cc1Swenshuai.xi         MS_U16 fSiCodeRate; //0.4, 0.6, 0.8
284*53ee8cc1Swenshuai.xi         MS_U16 fDvbcSymRateL;
285*53ee8cc1Swenshuai.xi         #else
286*53ee8cc1Swenshuai.xi         float fSiCodeRate; //0.4, 0.6, 0.8
287*53ee8cc1Swenshuai.xi         float fDvbcSymRateL;
288*53ee8cc1Swenshuai.xi         #endif
289*53ee8cc1Swenshuai.xi     };
290*53ee8cc1Swenshuai.xi     union
291*53ee8cc1Swenshuai.xi     {
292*53ee8cc1Swenshuai.xi         MS_U16 u8SiInterLeaver; //240, 720
293*53ee8cc1Swenshuai.xi         MS_U16 u8DvbcSymRateH;
294*53ee8cc1Swenshuai.xi     };
295*53ee8cc1Swenshuai.xi     union
296*53ee8cc1Swenshuai.xi     {
297*53ee8cc1Swenshuai.xi         MS_U8 u8SiQamMode; //4QAM, 16QAM, 32QAM, 64QAM
298*53ee8cc1Swenshuai.xi         MS_U8 u8DvbcQamMode;
299*53ee8cc1Swenshuai.xi     };
300*53ee8cc1Swenshuai.xi     MS_U8  u8SiNR;
301*53ee8cc1Swenshuai.xi     MS_U8  u8SiCarrierMode; //0: multiple carrier, 1:single carrier
302*53ee8cc1Swenshuai.xi     MS_U16 u16PNM; //420, 595, 945
303*53ee8cc1Swenshuai.xi     MS_U8  u8PNC; //0: variable, 1: constant
304*53ee8cc1Swenshuai.xi     DMD_DTMB_DEMOD_TYPE eDemodType; //DTMB or DVBC
305*53ee8cc1Swenshuai.xi } DMD_DTMB_MODULATION_INFO;
306*53ee8cc1Swenshuai.xi 
307*53ee8cc1Swenshuai.xi #ifdef UTPA2
308*53ee8cc1Swenshuai.xi typedef struct DLL_PACKED
309*53ee8cc1Swenshuai.xi {
310*53ee8cc1Swenshuai.xi     MS_S16 fftfirstCfo;
311*53ee8cc1Swenshuai.xi     MS_S8  fftSecondCfo;
312*53ee8cc1Swenshuai.xi     MS_S16 sr;
313*53ee8cc1Swenshuai.xi } DMD_DTMB_CFO_DATA;
314*53ee8cc1Swenshuai.xi 
315*53ee8cc1Swenshuai.xi typedef struct DLL_PACKED
316*53ee8cc1Swenshuai.xi {
317*53ee8cc1Swenshuai.xi     MS_U32 BitErr;
318*53ee8cc1Swenshuai.xi     MS_U16 Error_window;
319*53ee8cc1Swenshuai.xi } DMD_DTMB_BER_DATA;
320*53ee8cc1Swenshuai.xi 
321*53ee8cc1Swenshuai.xi typedef struct DLL_PACKED
322*53ee8cc1Swenshuai.xi {
323*53ee8cc1Swenshuai.xi     MS_U32 snr;
324*53ee8cc1Swenshuai.xi     MS_U16 sym_num;
325*53ee8cc1Swenshuai.xi } DMD_DTMB_SNR_DATA;
326*53ee8cc1Swenshuai.xi #endif
327*53ee8cc1Swenshuai.xi 
328*53ee8cc1Swenshuai.xi typedef struct DLL_PACKED
329*53ee8cc1Swenshuai.xi {
330*53ee8cc1Swenshuai.xi     MS_U8 u8Pin;
331*53ee8cc1Swenshuai.xi     union
332*53ee8cc1Swenshuai.xi     {
333*53ee8cc1Swenshuai.xi         MS_BOOL bLevel;
334*53ee8cc1Swenshuai.xi         MS_BOOL bIsOut;
335*53ee8cc1Swenshuai.xi     };
336*53ee8cc1Swenshuai.xi } DMD_DTMB_GPIO_PIN_DATA;
337*53ee8cc1Swenshuai.xi 
338*53ee8cc1Swenshuai.xi typedef struct DLL_PACKED
339*53ee8cc1Swenshuai.xi {
340*53ee8cc1Swenshuai.xi     MS_U16 u16Addr;
341*53ee8cc1Swenshuai.xi     MS_U8  u8Data;
342*53ee8cc1Swenshuai.xi } DMD_DTMB_REG_DATA;
343*53ee8cc1Swenshuai.xi 
344*53ee8cc1Swenshuai.xi typedef enum
345*53ee8cc1Swenshuai.xi {
346*53ee8cc1Swenshuai.xi     DMD_DTMB_DBGLV_NONE,    // disable all the debug message
347*53ee8cc1Swenshuai.xi     DMD_DTMB_DBGLV_INFO,    // information
348*53ee8cc1Swenshuai.xi     DMD_DTMB_DBGLV_NOTICE,  // normal but significant condition
349*53ee8cc1Swenshuai.xi     DMD_DTMB_DBGLV_WARNING, // warning conditions
350*53ee8cc1Swenshuai.xi     DMD_DTMB_DBGLV_ERR,     // error conditions
351*53ee8cc1Swenshuai.xi     DMD_DTMB_DBGLV_CRIT,    // critical conditions
352*53ee8cc1Swenshuai.xi     DMD_DTMB_DBGLV_ALERT,   // action must be taken immediately
353*53ee8cc1Swenshuai.xi     DMD_DTMB_DBGLV_EMERG,   // system is unusable
354*53ee8cc1Swenshuai.xi     DMD_DTMB_DBGLV_DEBUG,   // debug-level messages
355*53ee8cc1Swenshuai.xi } DMD_DTMB_DbgLv;
356*53ee8cc1Swenshuai.xi 
357*53ee8cc1Swenshuai.xi typedef enum
358*53ee8cc1Swenshuai.xi {
359*53ee8cc1Swenshuai.xi     DMD_DTMB_GETLOCK,
360*53ee8cc1Swenshuai.xi     DMD_DTMB_GETLOCK_DTMB_AGCLOCK,
361*53ee8cc1Swenshuai.xi     DMD_DTMB_GETLOCK_DTMB_PNPLOCK,
362*53ee8cc1Swenshuai.xi     DMD_DTMB_GETLOCK_DTMB_FECLOCK,
363*53ee8cc1Swenshuai.xi     DMD_DTMB_GETLOCK_DVBC_AGCLOCK,
364*53ee8cc1Swenshuai.xi     DMD_DTMB_GETLOCK_DVBC_PRELOCK,
365*53ee8cc1Swenshuai.xi     DMD_DTMB_GETLOCK_DVBC_MAINLOCK,
366*53ee8cc1Swenshuai.xi } DMD_DTMB_GETLOCK_TYPE;
367*53ee8cc1Swenshuai.xi 
368*53ee8cc1Swenshuai.xi typedef enum
369*53ee8cc1Swenshuai.xi {
370*53ee8cc1Swenshuai.xi     DMD_DTMB_LOCK,
371*53ee8cc1Swenshuai.xi     DMD_DTMB_CHECKING,
372*53ee8cc1Swenshuai.xi     DMD_DTMB_CHECKEND,
373*53ee8cc1Swenshuai.xi     DMD_DTMB_UNLOCK,
374*53ee8cc1Swenshuai.xi     DMD_DTMB_NULL,
375*53ee8cc1Swenshuai.xi } DMD_DTMB_LOCK_STATUS;
376*53ee8cc1Swenshuai.xi 
377*53ee8cc1Swenshuai.xi /// For demod init
378*53ee8cc1Swenshuai.xi typedef struct DLL_PACKED
379*53ee8cc1Swenshuai.xi {
380*53ee8cc1Swenshuai.xi     // init
381*53ee8cc1Swenshuai.xi     MS_U16 u16DTMBAGCLockCheckTime;//50
382*53ee8cc1Swenshuai.xi     MS_U16 u16DTMBPreLockCheckTime;//300
383*53ee8cc1Swenshuai.xi     MS_U16 u16DTMBPNMLockCheckTime;//1200
384*53ee8cc1Swenshuai.xi     MS_U16 u16DTMBFECLockCheckTime;//5000
385*53ee8cc1Swenshuai.xi 
386*53ee8cc1Swenshuai.xi     MS_U16 u16QAMAGCLockCheckTime;//50
387*53ee8cc1Swenshuai.xi     MS_U16 u16QAMPreLockCheckTime;//1000
388*53ee8cc1Swenshuai.xi     MS_U16 u16QAMMainLockCheckTime;//3000
389*53ee8cc1Swenshuai.xi 
390*53ee8cc1Swenshuai.xi     // register init
391*53ee8cc1Swenshuai.xi     MS_U8 *u8DMD_DTMB_DSPRegInitExt; // TODO use system variable type
392*53ee8cc1Swenshuai.xi     MS_U8 u8DMD_DTMB_DSPRegInitSize;
393*53ee8cc1Swenshuai.xi     MS_U8 *u8DMD_DTMB_InitExt; // TODO use system variable type
394*53ee8cc1Swenshuai.xi 
395*53ee8cc1Swenshuai.xi     //By Tuners:
396*53ee8cc1Swenshuai.xi     MS_U16  u16IF_KHZ;//By Tuners
397*53ee8cc1Swenshuai.xi     MS_BOOL bIQSwap;//0
398*53ee8cc1Swenshuai.xi     MS_U16  u16AGC_REFERENCE;//0
399*53ee8cc1Swenshuai.xi     MS_BOOL bTunerGainInvert;//0
400*53ee8cc1Swenshuai.xi 
401*53ee8cc1Swenshuai.xi     //By IC:
402*53ee8cc1Swenshuai.xi     MS_U8   u8IS_DUAL;//0
403*53ee8cc1Swenshuai.xi     MS_BOOL bIsExtDemod;//0
404*53ee8cc1Swenshuai.xi 
405*53ee8cc1Swenshuai.xi     //By TS (Only for MCP or ext demod):
406*53ee8cc1Swenshuai.xi     MS_U8 u1TsConfigByte_SerialMode : 1;
407*53ee8cc1Swenshuai.xi     MS_U8 u1TsConfigByte_DataSwap   : 1;
408*53ee8cc1Swenshuai.xi     MS_U8 u1TsConfigByte_ClockInv   : 1;
409*53ee8cc1Swenshuai.xi     MS_U8 u5TsConfigByte_DivNum     : 5;
410*53ee8cc1Swenshuai.xi 
411*53ee8cc1Swenshuai.xi     //By SYS I2C (Only for MCP or ext demod):
412*53ee8cc1Swenshuai.xi     MS_U8 u8I2CSlaveAddr;
413*53ee8cc1Swenshuai.xi     MS_U8 u8I2CSlaveBus;
414*53ee8cc1Swenshuai.xi     MS_BOOL (*I2C_WriteBytes)(MS_U16 u16BusNumSlaveID, MS_U8 u8addrcount, MS_U8* pu8addr, MS_U16 u16size, MS_U8* pu8data);
415*53ee8cc1Swenshuai.xi     MS_BOOL (*I2C_ReadBytes)(MS_U16 u16BusNumSlaveID, MS_U8 u8AddrNum, MS_U8* paddr, MS_U16 u16size, MS_U8* pu8data);
416*53ee8cc1Swenshuai.xi 
417*53ee8cc1Swenshuai.xi     //By SYS MSPI (Only for MCP or ext demod):
418*53ee8cc1Swenshuai.xi     MS_BOOL bIsUseSspiLoadCode;
419*53ee8cc1Swenshuai.xi     MS_BOOL bIsSspiUseTsPin;
420*53ee8cc1Swenshuai.xi 
421*53ee8cc1Swenshuai.xi     //By SYS memory mapping (Only for int demod):
422*53ee8cc1Swenshuai.xi     MS_U32 u32TdiStartAddr;
423*53ee8cc1Swenshuai.xi 
424*53ee8cc1Swenshuai.xi     #if !DMD_DTMB_UTOPIA_EN && !DMD_DTMB_UTOPIA2_EN
425*53ee8cc1Swenshuai.xi     MS_U32  (*GetSystemTimeMS)(void);      // Get sys time (unit: ms)
426*53ee8cc1Swenshuai.xi     void    (*DelayMS)(MS_U32 ms);         // Delay time (unit: ms)
427*53ee8cc1Swenshuai.xi     MS_BOOL (*CreateMutex)(MS_BOOL enable); // Create&Delete mutex
428*53ee8cc1Swenshuai.xi     void    (*LockDMD)(MS_BOOL enable);    // Enter&Leave mutex
429*53ee8cc1Swenshuai.xi     #endif
430*53ee8cc1Swenshuai.xi } DMD_DTMB_InitData;
431*53ee8cc1Swenshuai.xi 
432*53ee8cc1Swenshuai.xi typedef struct DLL_PACKED
433*53ee8cc1Swenshuai.xi {
434*53ee8cc1Swenshuai.xi     MS_VIRT virtDMDBaseAddr;
435*53ee8cc1Swenshuai.xi 
436*53ee8cc1Swenshuai.xi     MS_BOOL bInit;
437*53ee8cc1Swenshuai.xi     MS_BOOL bDownloaded;
438*53ee8cc1Swenshuai.xi 
439*53ee8cc1Swenshuai.xi     #if DMD_DTMB_STR_EN
440*53ee8cc1Swenshuai.xi     MS_BOOL             bIsDTV;
441*53ee8cc1Swenshuai.xi     EN_POWER_MODE       eLastState;
442*53ee8cc1Swenshuai.xi     #endif
443*53ee8cc1Swenshuai.xi     DMD_DTMB_DEMOD_TYPE eLastType;
444*53ee8cc1Swenshuai.xi     MS_U16              u16SymRate;
445*53ee8cc1Swenshuai.xi 
446*53ee8cc1Swenshuai.xi     MS_BOOL bIsQPad;
447*53ee8cc1Swenshuai.xi     MS_U16  u16ChipID;
448*53ee8cc1Swenshuai.xi 
449*53ee8cc1Swenshuai.xi     MS_BOOL (*HAL_DMD_DTMB_IOCTL_CMD)(DMD_DTMB_HAL_COMMAND eCmd, void *pPara);
450*53ee8cc1Swenshuai.xi } DMD_DTMB_PriData;
451*53ee8cc1Swenshuai.xi 
452*53ee8cc1Swenshuai.xi typedef struct DLL_PACKED
453*53ee8cc1Swenshuai.xi {
454*53ee8cc1Swenshuai.xi     MS_U8  u8Version;
455*53ee8cc1Swenshuai.xi     MS_U32 u32DTMBScanTimeStart;
456*53ee8cc1Swenshuai.xi     MS_U32 u32DTMBFECLockTime;
457*53ee8cc1Swenshuai.xi     MS_U32 u32DTMBLockStatus;
458*53ee8cc1Swenshuai.xi } DMD_DTMB_Info;
459*53ee8cc1Swenshuai.xi 
460*53ee8cc1Swenshuai.xi typedef struct DLL_PACKED
461*53ee8cc1Swenshuai.xi {
462*53ee8cc1Swenshuai.xi     DMD_DTMB_InitData  sDMD_DTMB_InitData;
463*53ee8cc1Swenshuai.xi     DMD_DTMB_PriData   sDMD_DTMB_PriData;
464*53ee8cc1Swenshuai.xi     DMD_DTMB_Info      sDMD_DTMB_Info;
465*53ee8cc1Swenshuai.xi } DMD_DTMB_ResData;
466*53ee8cc1Swenshuai.xi 
467*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
468*53ee8cc1Swenshuai.xi //  Function and Variable
469*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
470*53ee8cc1Swenshuai.xi 
471*53ee8cc1Swenshuai.xi #ifdef __cplusplus
472*53ee8cc1Swenshuai.xi extern "C"
473*53ee8cc1Swenshuai.xi {
474*53ee8cc1Swenshuai.xi #endif
475*53ee8cc1Swenshuai.xi 
476*53ee8cc1Swenshuai.xi #ifndef MSOS_TYPE_LINUX_KERNEL
477*53ee8cc1Swenshuai.xi 
478*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
479*53ee8cc1Swenshuai.xi /// Set detailed level of DTMB driver debug message
480*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
481*53ee8cc1Swenshuai.xi /// @param u8DbgLevel    \b IN: debug level for Parallel Flash driver
482*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
483*53ee8cc1Swenshuai.xi /// @return FALSE : fail
484*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
485*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_SetDbgLevel(DMD_DTMB_DbgLv u8DbgLevel);
486*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
487*53ee8cc1Swenshuai.xi /// Get the information of DTMB driver
488*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
489*53ee8cc1Swenshuai.xi /// @return : the pointer to the driver information
490*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
491*53ee8cc1Swenshuai.xi DLL_PUBLIC extern DMD_DTMB_Info* MDrv_DMD_DTMB_GetInfo(void);
492*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
493*53ee8cc1Swenshuai.xi /// Get DTMB driver version
494*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
495*53ee8cc1Swenshuai.xi /// @param ppVersion    \b OUT: the pointer to the driver version
496*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
497*53ee8cc1Swenshuai.xi /// @return FALSE : fail
498*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
499*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_GetLibVer(const MSIF_Version **ppVersion);
500*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
501*53ee8cc1Swenshuai.xi /// Initialize HAL interface
502*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
503*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
504*53ee8cc1Swenshuai.xi /// @return FALSE : fail
505*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
506*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_Initial_Hal_Interface(void);
507*53ee8cc1Swenshuai.xi 
508*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
509*53ee8cc1Swenshuai.xi ///                            SINGLE DEMOD API                              ///
510*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
511*53ee8cc1Swenshuai.xi 
512*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
513*53ee8cc1Swenshuai.xi /// Initialize DTMB Demod
514*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
515*53ee8cc1Swenshuai.xi /// @param pDMD_DTMB_InitData    \b IN: DTMB initial parameters
516*53ee8cc1Swenshuai.xi /// @param u32InitDataLen        \b IN: size of DTMB initial parameters
517*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
518*53ee8cc1Swenshuai.xi /// @return FALSE : fail
519*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
520*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_Init(DMD_DTMB_InitData *pDMD_DTMB_InitData, MS_U32 u32InitDataLen);
521*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
522*53ee8cc1Swenshuai.xi /// Exit DTMB DTV mode
523*53ee8cc1Swenshuai.xi /// @ingroup DTMB_STR
524*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
525*53ee8cc1Swenshuai.xi /// @return FALSE : fail
526*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
527*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_Exit(void);
528*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
529*53ee8cc1Swenshuai.xi /// Get Initial Data
530*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
531*53ee8cc1Swenshuai.xi /// @param psDMD_DTMB_InitData    \b IN: DTMB initial parameters
532*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
533*53ee8cc1Swenshuai.xi /// @return FALSE : fail
534*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
535*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_U32 MDrv_DMD_DTMB_GetConfig(DMD_DTMB_InitData *psDMD_DTMB_InitData);
536*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
537*53ee8cc1Swenshuai.xi /// Set Demod mode and restart Demod
538*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
539*53ee8cc1Swenshuai.xi /// @param eType    \b IN: Select DTMB modulation type
540*53ee8cc1Swenshuai.xi /// @param bEnable  \b IN: Enable SetConfig function
541*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
542*53ee8cc1Swenshuai.xi /// @return FALSE : fail
543*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
544*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_SetConfig(DMD_DTMB_DEMOD_TYPE eType, MS_BOOL bEnable);
545*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
546*53ee8cc1Swenshuai.xi /// Reset FW state machine
547*53ee8cc1Swenshuai.xi /// @ingroup DTMB_ToBeRemoved
548*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
549*53ee8cc1Swenshuai.xi /// @return FALSE : fail
550*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
551*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_SetReset(void);
552*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
553*53ee8cc1Swenshuai.xi /// Set QAM Type and symbol rate
554*53ee8cc1Swenshuai.xi /// @ingroup DTMB_ToBeRemoved
555*53ee8cc1Swenshuai.xi /// @param eType    \b IN: QAM type
556*53ee8cc1Swenshuai.xi /// @param symbol_rate    \b IN: symbol rate
557*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
558*53ee8cc1Swenshuai.xi /// @return FALSE : fail
559*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
560*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_Set_QAM_SR(DMD_DTMB_DEMOD_TYPE eType, MS_U16 symbol_rate);
561*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
562*53ee8cc1Swenshuai.xi /// Active Demod
563*53ee8cc1Swenshuai.xi /// @ingroup DTMB_ToBeRemoved
564*53ee8cc1Swenshuai.xi /// @param bEnable    \b IN: Active Demod if TRUE
565*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
566*53ee8cc1Swenshuai.xi /// @return FALSE : fail
567*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
568*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_SetActive(MS_BOOL bEnable);
569*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
570*53ee8cc1Swenshuai.xi /// Support DTMB STR function
571*53ee8cc1Swenshuai.xi /// @ingroup DTMB_STR
572*53ee8cc1Swenshuai.xi /// @param u16PowerState    \b IN: Set STR status
573*53ee8cc1Swenshuai.xi /// @return : STR status
574*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
575*53ee8cc1Swenshuai.xi #if DMD_DTMB_STR_EN
576*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_U32 MDrv_DMD_DTMB_SetPowerState(EN_POWER_MODE u16PowerState);
577*53ee8cc1Swenshuai.xi #endif
578*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
579*53ee8cc1Swenshuai.xi /// Get lock status
580*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
581*53ee8cc1Swenshuai.xi /// @param eType    \b IN: select lock type
582*53ee8cc1Swenshuai.xi /// @return : lock status
583*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
584*53ee8cc1Swenshuai.xi DLL_PUBLIC extern DMD_DTMB_LOCK_STATUS MDrv_DMD_DTMB_GetLock(DMD_DTMB_GETLOCK_TYPE eType);
585*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
586*53ee8cc1Swenshuai.xi /// Get modulation mode
587*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
588*53ee8cc1Swenshuai.xi /// @return : modulation mode
589*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
590*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_GetModulationMode(DMD_DTMB_MODULATION_INFO *sDtmbModulationMode);
591*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
592*53ee8cc1Swenshuai.xi /// Get Demod signal strength (IF AGC gain)
593*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
594*53ee8cc1Swenshuai.xi /// @param u16Strength    \b OUT: the pointer to signal strength
595*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
596*53ee8cc1Swenshuai.xi /// @return FALSE : fail
597*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
598*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_GetSignalStrength(MS_U16 *u16Strength);
599*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
600*53ee8cc1Swenshuai.xi /// Get Demod frequency offset
601*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
602*53ee8cc1Swenshuai.xi /// @param cfo    \b OUT: the pointer to CFO
603*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
604*53ee8cc1Swenshuai.xi /// @return FALSE : fail
605*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
606*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_ReadFrequencyOffset(MS_S16 *cfo);
607*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
608*53ee8cc1Swenshuai.xi /// Get signal quality
609*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
610*53ee8cc1Swenshuai.xi /// @return : signal quality
611*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
612*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_U8 MDrv_DMD_DTMB_GetSignalQuality(void);
613*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
614*53ee8cc1Swenshuai.xi /// Get pre LDPC data
615*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
616*53ee8cc1Swenshuai.xi /// @param pber    \b OUT: the pointer to pre LDPC data
617*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
618*53ee8cc1Swenshuai.xi /// @return FALSE : fail
619*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
620*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_GetPreLdpcBer(float *pber);
621*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
622*53ee8cc1Swenshuai.xi /// Get Demod pre Viterbi number
623*53ee8cc1Swenshuai.xi /// @ingroup DTMB_ToBeRemoved
624*53ee8cc1Swenshuai.xi /// @param ber    \b OUT: the pointer to pre Viterbi BER
625*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
626*53ee8cc1Swenshuai.xi /// @return FALSE : fail
627*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
628*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_GetPreViterbiBer(float *ber);
629*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
630*53ee8cc1Swenshuai.xi /// Get Demod post Viterbi number
631*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
632*53ee8cc1Swenshuai.xi /// @param ber    \b OUT: the pointer to post Viterbi BER
633*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
634*53ee8cc1Swenshuai.xi /// @return FALSE : fail
635*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
636*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_GetPostViterbiBer(float *ber);
637*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
638*53ee8cc1Swenshuai.xi /// Get SNR
639*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
640*53ee8cc1Swenshuai.xi /// @param snr    \b OUT: the pointer to SNR
641*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
642*53ee8cc1Swenshuai.xi /// @return FALSE : fail
643*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
644*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_GetSNR(float *snr);
645*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
646*53ee8cc1Swenshuai.xi /// Set TS output mode
647*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
648*53ee8cc1Swenshuai.xi /// @param u8TsConfigData    \b IN: TS configuration
649*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
650*53ee8cc1Swenshuai.xi /// @return FALSE : fail
651*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
652*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_SetSerialControl(MS_U8 u8TsConfigData);
653*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
654*53ee8cc1Swenshuai.xi /// Enable I2C bypass mode
655*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
656*53ee8cc1Swenshuai.xi /// @param bEnable    \b IN: Enable bypass mode
657*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
658*53ee8cc1Swenshuai.xi /// @return FALSE : fail
659*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
660*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_IIC_BYPASS_MODE(MS_BOOL bEnable);
661*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
662*53ee8cc1Swenshuai.xi /// Set SSPI pin as GPIO function
663*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
664*53ee8cc1Swenshuai.xi /// @param bEnable    \b IN: Switch to GPIO if TRUE, otherwise SSPI
665*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
666*53ee8cc1Swenshuai.xi /// @return FALSE : fail
667*53ee8cc1Swenshuai.xi //------------------------------------------------------------------------------------------------
668*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_SWITCH_SSPI_GPIO(MS_BOOL bEnable);
669*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
670*53ee8cc1Swenshuai.xi /// Get GPIO level
671*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
672*53ee8cc1Swenshuai.xi /// @param u8Pin    \b IN: Select pin number
673*53ee8cc1Swenshuai.xi /// @param bLevel    \b OUT: the pointer to GPIO level
674*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
675*53ee8cc1Swenshuai.xi /// @return FALSE : fail
676*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
677*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_GPIO_GET_LEVEL(MS_U8 u8Pin, MS_BOOL *bLevel);
678*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
679*53ee8cc1Swenshuai.xi /// Set GPIO level
680*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
681*53ee8cc1Swenshuai.xi /// @param u8Pin    \b IN: Select pin number
682*53ee8cc1Swenshuai.xi /// @param bLevel    \b IN: Set GPIO level
683*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
684*53ee8cc1Swenshuai.xi /// @return FALSE : fail
685*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
686*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_GPIO_SET_LEVEL(MS_U8 u8Pin, MS_BOOL bLevel);
687*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
688*53ee8cc1Swenshuai.xi /// Set GPIO as output or input
689*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
690*53ee8cc1Swenshuai.xi /// @param u8Pin    \b IN: Select pin number
691*53ee8cc1Swenshuai.xi /// @param bEnableOut    \b IN: output if TRUE, otherwise input
692*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
693*53ee8cc1Swenshuai.xi /// @return FALSE : fail
694*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
695*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_GPIO_OUT_ENABLE(MS_U8 u8Pin, MS_BOOL bEnableOut);
696*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
697*53ee8cc1Swenshuai.xi /// Swap ADC input
698*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
699*53ee8cc1Swenshuai.xi /// @param bIsQPad    \b IN: Q pad if TRUE, otherwise I pad
700*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
701*53ee8cc1Swenshuai.xi /// @return FALSE : fail
702*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
703*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_DoIQSwap(MS_BOOL bIsQPad);
704*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
705*53ee8cc1Swenshuai.xi /// Get Demod register value
706*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
707*53ee8cc1Swenshuai.xi /// @param u16Addr    \b IN: register address
708*53ee8cc1Swenshuai.xi /// @param pu8Data    \b OUT: the pointer to register data
709*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
710*53ee8cc1Swenshuai.xi /// @return FALSE : fail
711*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
712*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_GetReg(MS_U16 u16Addr, MS_U8 *pu8Data);
713*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
714*53ee8cc1Swenshuai.xi /// Set Demod register value
715*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
716*53ee8cc1Swenshuai.xi /// @param u16Addr    \b IN: register address
717*53ee8cc1Swenshuai.xi /// @param u8Data    \b IN: register data
718*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
719*53ee8cc1Swenshuai.xi /// @return FALSE : fail
720*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
721*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_SetReg(MS_U16 u16Addr, MS_U8 u8Data);
722*53ee8cc1Swenshuai.xi 
723*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
724*53ee8cc1Swenshuai.xi ///                            MULTI DEMOD API                               ///
725*53ee8cc1Swenshuai.xi ////////////////////////////////////////////////////////////////////////////////
726*53ee8cc1Swenshuai.xi 
727*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
728*53ee8cc1Swenshuai.xi /// Initialize multiple DTMB Demod
729*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
730*53ee8cc1Swenshuai.xi /// @param id                    \b IN: Select Demod number
731*53ee8cc1Swenshuai.xi /// @param pDMD_DTMB_InitData    \b IN: DTMB initial parameters
732*53ee8cc1Swenshuai.xi /// @param u32InitDataLen        \b IN: size of DTMB initial parameters
733*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
734*53ee8cc1Swenshuai.xi /// @return FALSE : fail
735*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
736*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_Init(MS_U8 id, DMD_DTMB_InitData *pDMD_DTMB_InitData, MS_U32 u32InitDataLen);
737*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
738*53ee8cc1Swenshuai.xi /// Support multiple Demod of exiting DTMB DTV mode
739*53ee8cc1Swenshuai.xi /// @ingroup DTMB_STR
740*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
741*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
742*53ee8cc1Swenshuai.xi /// @return FALSE : fail
743*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
744*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_Exit(MS_U8 id);
745*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
746*53ee8cc1Swenshuai.xi /// Get Initial Data
747*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
748*53ee8cc1Swenshuai.xi /// @param @param id              \b IN: Select Demod number
749*53ee8cc1Swenshuai.xi /// @param psDMD_DTMB_InitData    \b IN: DTMB initial parameters
750*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
751*53ee8cc1Swenshuai.xi /// @return FALSE : fail
752*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
753*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_U32 MDrv_DMD_DTMB_MD_GetConfig(MS_U8 id, DMD_DTMB_InitData *psDMD_DTMB_InitData);
754*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
755*53ee8cc1Swenshuai.xi /// Support multiple Demod of setting and restarting Demod
756*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
757*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
758*53ee8cc1Swenshuai.xi /// @param eType    \b IN: Select DTMB modulation type
759*53ee8cc1Swenshuai.xi /// @param bEnable  \b IN: Enable SetConfig function
760*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
761*53ee8cc1Swenshuai.xi /// @return FALSE : fail
762*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
763*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_SetConfig(MS_U8 id, DMD_DTMB_DEMOD_TYPE eType, MS_BOOL bEnable);
764*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
765*53ee8cc1Swenshuai.xi /// Support multiple Demod of reset FW state machine
766*53ee8cc1Swenshuai.xi /// @ingroup DTMB_ToBeRemoved
767*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
768*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
769*53ee8cc1Swenshuai.xi /// @return FALSE : fail
770*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
771*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_SetReset(MS_U8 id);
772*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
773*53ee8cc1Swenshuai.xi /// Support multiple Demod of setting QAM Type and symbol rate
774*53ee8cc1Swenshuai.xi /// @ingroup DTMB_ToBeRemoved
775*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
776*53ee8cc1Swenshuai.xi /// @param eType    \b IN: QAM type
777*53ee8cc1Swenshuai.xi /// @param symbol_rate    \b IN: symbol rate
778*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
779*53ee8cc1Swenshuai.xi /// @return FALSE : fail
780*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
781*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_Set_QAM_SR(MS_U8 id, DMD_DTMB_DEMOD_TYPE eType, MS_U16 symbol_rate);
782*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
783*53ee8cc1Swenshuai.xi /// Support multiple Demod of active Demod
784*53ee8cc1Swenshuai.xi /// @ingroup DTMB_ToBeRemoved
785*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
786*53ee8cc1Swenshuai.xi /// @param bEnable    \b IN: Active Demod if TRUE
787*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
788*53ee8cc1Swenshuai.xi /// @return FALSE : fail
789*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
790*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_SetActive(MS_U8 id, MS_BOOL bEnable);
791*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
792*53ee8cc1Swenshuai.xi /// Support multiple Demod of DTMB STR function
793*53ee8cc1Swenshuai.xi /// @ingroup DTMB_STR
794*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
795*53ee8cc1Swenshuai.xi /// @param u16PowerState    \b IN: Set STR status
796*53ee8cc1Swenshuai.xi /// @return : STR status
797*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
798*53ee8cc1Swenshuai.xi #if DMD_DTMB_STR_EN
799*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_U32 MDrv_DMD_DTMB_MD_SetPowerState(MS_U8 id, EN_POWER_MODE u16PowerState);
800*53ee8cc1Swenshuai.xi #endif
801*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
802*53ee8cc1Swenshuai.xi /// Support multiple Demod of getting lock status
803*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
804*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
805*53ee8cc1Swenshuai.xi /// @param eType    \b IN: select lock type
806*53ee8cc1Swenshuai.xi /// @return : lock status
807*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
808*53ee8cc1Swenshuai.xi DLL_PUBLIC extern DMD_DTMB_LOCK_STATUS MDrv_DMD_DTMB_MD_GetLock(MS_U8 id, DMD_DTMB_GETLOCK_TYPE eType);
809*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
810*53ee8cc1Swenshuai.xi /// Support multiple Demod of getting modulation mode
811*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
812*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
813*53ee8cc1Swenshuai.xi /// @return : modulation mode
814*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
815*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_GetModulationMode(MS_U8 id, DMD_DTMB_MODULATION_INFO *sDtmbModulationMode);
816*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
817*53ee8cc1Swenshuai.xi /// Support multiple Demod of getting Demod signal strength (IF AGC gain)
818*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
819*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
820*53ee8cc1Swenshuai.xi /// @param u16Strength    \b OUT: the pointer to signal strength
821*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
822*53ee8cc1Swenshuai.xi /// @return FALSE : fail
823*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
824*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_GetSignalStrength(MS_U8 id, MS_U16 *u16Strength);
825*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
826*53ee8cc1Swenshuai.xi /// Support multiple Demod of getting Demod fequency offset
827*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
828*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
829*53ee8cc1Swenshuai.xi /// @param cfo    \b OUT: the pointer to CFO
830*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
831*53ee8cc1Swenshuai.xi /// @return FALSE : fail
832*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
833*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_ReadFrequencyOffset(MS_U8 id, MS_S16 *cfo);
834*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
835*53ee8cc1Swenshuai.xi /// Support multiple Demod of getting Demod signal quality
836*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
837*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
838*53ee8cc1Swenshuai.xi /// @return : signal quality
839*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
840*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_U8 MDrv_DMD_DTMB_MD_GetSignalQuality(MS_U8 id);
841*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
842*53ee8cc1Swenshuai.xi /// Support multiple Demod of getting pre LDPC data
843*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
844*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
845*53ee8cc1Swenshuai.xi /// @param pber    \b OUT: the pointer to pre LDPC data
846*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
847*53ee8cc1Swenshuai.xi /// @return FALSE : fail
848*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
849*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_GetPreLdpcBer(MS_U8 id, float *pber);
850*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
851*53ee8cc1Swenshuai.xi /// Support multiple Demod of getting Demod pre Viterbi number
852*53ee8cc1Swenshuai.xi /// @ingroup DTMB_ToBeRemoved
853*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
854*53ee8cc1Swenshuai.xi /// @param ber    \b OUT: the pointer to BER
855*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
856*53ee8cc1Swenshuai.xi /// @return FALSE : fail
857*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
858*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_GetPreViterbiBer(MS_U8 id, float *ber);
859*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
860*53ee8cc1Swenshuai.xi /// Support multiple Demod of getting Demod post Viterbi number
861*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
862*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
863*53ee8cc1Swenshuai.xi /// @param ber    \b OUT: the pointer to BER
864*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
865*53ee8cc1Swenshuai.xi /// @return FALSE : fail
866*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
867*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_GetPostViterbiBer(MS_U8 id, float *ber);
868*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
869*53ee8cc1Swenshuai.xi /// Support multiple Demod of getting SNR
870*53ee8cc1Swenshuai.xi /// @ingroup DTMB_INFO
871*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
872*53ee8cc1Swenshuai.xi /// @param snr    \b OUT: the pointer to SNR
873*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
874*53ee8cc1Swenshuai.xi /// @return FALSE : fail
875*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
876*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_GetSNR(MS_U8 id, float *snr);
877*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
878*53ee8cc1Swenshuai.xi /// Support multiple Demod of setting TS output mode
879*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
880*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
881*53ee8cc1Swenshuai.xi /// @param u8TsConfigData    \b IN: TS configuration
882*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
883*53ee8cc1Swenshuai.xi /// @return FALSE : fail
884*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
885*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_SetSerialControl(MS_U8 id, MS_U8 u8TsConfigData);
886*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
887*53ee8cc1Swenshuai.xi /// Support multiple Demod of enabling I2C bypass mode
888*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
889*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
890*53ee8cc1Swenshuai.xi /// @param bEnable    \b IN: Enable bypass mode
891*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
892*53ee8cc1Swenshuai.xi /// @return FALSE : fail
893*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
894*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_IIC_BYPASS_MODE(MS_U8 id, MS_BOOL bEnable);
895*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
896*53ee8cc1Swenshuai.xi /// Support multiple Demod of setting SSPI pin as GPIO function
897*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
898*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
899*53ee8cc1Swenshuai.xi /// @param bEnable    \b IN: Switch to GPIO if TRUE, otherwise SSPI
900*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
901*53ee8cc1Swenshuai.xi /// @return FALSE : fail
902*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
903*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_SWITCH_SSPI_GPIO(MS_U8 id, MS_BOOL bEnable);
904*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
905*53ee8cc1Swenshuai.xi /// Support multiple Demod of getting GPIO level
906*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
907*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
908*53ee8cc1Swenshuai.xi /// @param u8Pin    \b IN: Select pin number
909*53ee8cc1Swenshuai.xi /// @param bLevel    \b OUT: the pointer to GPIO level
910*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
911*53ee8cc1Swenshuai.xi /// @return FALSE : fail
912*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
913*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_GPIO_GET_LEVEL(MS_U8 id, MS_U8 u8Pin, MS_BOOL *bLevel);
914*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
915*53ee8cc1Swenshuai.xi /// Support multiple Demod of setting GPIO level
916*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
917*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
918*53ee8cc1Swenshuai.xi /// @param u8Pin    \b IN: Select pin number
919*53ee8cc1Swenshuai.xi /// @param bLevel    \b IN: Set GPIO level
920*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
921*53ee8cc1Swenshuai.xi /// @return FALSE : fail
922*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
923*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_GPIO_SET_LEVEL(MS_U8 id, MS_U8 u8Pin, MS_BOOL bLevel);
924*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
925*53ee8cc1Swenshuai.xi /// Support multiple Demod of setting GPIO as output or input
926*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
927*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
928*53ee8cc1Swenshuai.xi /// @param u8Pin    \b IN: Select pin number
929*53ee8cc1Swenshuai.xi /// @param bEnableOut    \b IN: output if TRUE, otherwise input
930*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
931*53ee8cc1Swenshuai.xi /// @return FALSE : fail
932*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
933*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_GPIO_OUT_ENABLE(MS_U8 id, MS_U8 u8Pin, MS_BOOL bEnableOut);
934*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
935*53ee8cc1Swenshuai.xi /// Support multiple Demod of swapping ADC input
936*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
937*53ee8cc1Swenshuai.xi /// @param bIsQPad    \b IN: Q pad if TRUE, otherwise I pad
938*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
939*53ee8cc1Swenshuai.xi /// @return FALSE : fail
940*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
941*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_DoIQSwap(MS_U8 id, MS_BOOL bIsQPad);
942*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
943*53ee8cc1Swenshuai.xi /// Support multiple Demod of getting Demod register value
944*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
945*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
946*53ee8cc1Swenshuai.xi /// @param u16Addr    \b IN: register address
947*53ee8cc1Swenshuai.xi /// @param pu8Data    \b OUT: the pointer to get register data
948*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
949*53ee8cc1Swenshuai.xi /// @return FALSE : fail
950*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
951*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_GetReg(MS_U8 id, MS_U16 u16Addr, MS_U8 *pu8Data);
952*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
953*53ee8cc1Swenshuai.xi /// Support multiple Demod of setting Demod register value
954*53ee8cc1Swenshuai.xi /// @ingroup DTMB_BASIC
955*53ee8cc1Swenshuai.xi /// @param id    \b IN: Select Demod number
956*53ee8cc1Swenshuai.xi /// @param u16Addr    \b IN: register address
957*53ee8cc1Swenshuai.xi /// @param u8Data    \b IN: register data
958*53ee8cc1Swenshuai.xi /// @return TRUE : succeed
959*53ee8cc1Swenshuai.xi /// @return FALSE : fail
960*53ee8cc1Swenshuai.xi //-------------------------------------------------------------------------------------------------
961*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL MDrv_DMD_DTMB_MD_SetReg(MS_U8 id, MS_U16 u16Addr, MS_U8 u8Data);
962*53ee8cc1Swenshuai.xi 
963*53ee8cc1Swenshuai.xi #endif // #ifndef MSOS_TYPE_LINUX_KERNEL
964*53ee8cc1Swenshuai.xi 
965*53ee8cc1Swenshuai.xi #ifdef UTPA2
966*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_SetDbgLevel(DMD_DTMB_DbgLv u8DbgLevel);
967*53ee8cc1Swenshuai.xi DLL_PUBLIC extern DMD_DTMB_Info* _MDrv_DMD_DTMB_GetInfo(void);
968*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_GetLibVer(const MSIF_Version **ppVersion);
969*53ee8cc1Swenshuai.xi 
970*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_Init(MS_U8 id, DMD_DTMB_InitData *pDMD_DTMB_InitData, MS_U32 u32InitDataLen);
971*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_Exit(MS_U8 id);
972*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_U32 _MDrv_DMD_DTMB_MD_GetConfig(MS_U8 id, DMD_DTMB_InitData *psDMD_DTMB_InitData);
973*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_SetConfig(MS_U8 id, DMD_DTMB_DEMOD_TYPE eType, MS_BOOL bEnable);
974*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_SetReset(MS_U8 id);
975*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_Set_QAM_SR(MS_U8 id, DMD_DTMB_DEMOD_TYPE eType, MS_U16 symbol_rate);
976*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_SetActive(MS_U8 id, MS_BOOL bEnable);
977*53ee8cc1Swenshuai.xi #if DMD_DTMB_STR_EN
978*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_U32 _MDrv_DMD_DTMB_MD_SetPowerState(MS_U8 id, EN_POWER_MODE u16PowerState);
979*53ee8cc1Swenshuai.xi #endif
980*53ee8cc1Swenshuai.xi DLL_PUBLIC extern DMD_DTMB_LOCK_STATUS _MDrv_DMD_DTMB_MD_GetLock(MS_U8 id, DMD_DTMB_GETLOCK_TYPE eType);
981*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_GetModulationMode(MS_U8 id, DMD_DTMB_MODULATION_INFO *sDtmbModulationMode);
982*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_GetSignalStrength(MS_U8 id, MS_U16 *u16Strength);
983*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_ReadFrequencyOffset(MS_U8 id, DMD_DTMB_CFO_DATA *cfo);
984*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_U8 _MDrv_DMD_DTMB_MD_GetSignalQuality(MS_U8 id);
985*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_GetPreLdpcBer(MS_U8 id, DMD_DTMB_BER_DATA *pber);
986*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_GetPreViterbiBer(MS_U8 id, DMD_DTMB_BER_DATA *ber);
987*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_GetPostViterbiBer(MS_U8 id, DMD_DTMB_BER_DATA *ber);
988*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_GetSNR(MS_U8 id, DMD_DTMB_SNR_DATA *snr);
989*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_SetSerialControl(MS_U8 id, MS_U8 u8TsConfigData);
990*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_IIC_BYPASS_MODE(MS_U8 id, MS_BOOL bEnable);
991*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_SWITCH_SSPI_GPIO(MS_U8 id, MS_BOOL bEnable);
992*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_GPIO_GET_LEVEL(MS_U8 id, MS_U8 u8Pin, MS_BOOL *bLevel);
993*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_GPIO_SET_LEVEL(MS_U8 id, MS_U8 u8Pin, MS_BOOL bLevel);
994*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_GPIO_OUT_ENABLE(MS_U8 id, MS_U8 u8Pin, MS_BOOL bEnableOut);
995*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_DoIQSwap(MS_U8 id, MS_BOOL bIsQPad);
996*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_GetReg(MS_U8 id, MS_U16 u16Addr, MS_U8 *pu8Data);
997*53ee8cc1Swenshuai.xi DLL_PUBLIC extern MS_BOOL _MDrv_DMD_DTMB_MD_SetReg(MS_U8 id, MS_U16 u16Addr, MS_U8 u8Data);
998*53ee8cc1Swenshuai.xi #endif // #ifdef UTPA2
999*53ee8cc1Swenshuai.xi 
1000*53ee8cc1Swenshuai.xi #ifdef __cplusplus
1001*53ee8cc1Swenshuai.xi }
1002*53ee8cc1Swenshuai.xi #endif
1003*53ee8cc1Swenshuai.xi 
1004*53ee8cc1Swenshuai.xi #endif // _DRV_DTMB_H_
1005