xref: /utopia/UTPA2-700.0.x/modules/audio/hal/curry/audio/halAUDIO.h (revision 53ee8cc121a030b8d368113ac3e966b4705770ef)
1 //<MStar Software>
2 //******************************************************************************
3 // MStar Software
4 // Copyright (c) 2010 - 2012 MStar Semiconductor, Inc. All rights reserved.
5 // All software, firmware and related documentation herein ("MStar Software") are
6 // intellectual property of MStar Semiconductor, Inc. ("MStar") and protected by
7 // law, including, but not limited to, copyright law and international treaties.
8 // Any use, modification, reproduction, retransmission, or republication of all
9 // or part of MStar Software is expressly prohibited, unless prior written
10 // permission has been granted by MStar.
11 //
12 // By accessing, browsing and/or using MStar Software, you acknowledge that you
13 // have read, understood, and agree, to be bound by below terms ("Terms") and to
14 // comply with all applicable laws and regulations:
15 //
16 // 1. MStar shall retain any and all right, ownership and interest to MStar
17 //    Software and any modification/derivatives thereof.
18 //    No right, ownership, or interest to MStar Software and any
19 //    modification/derivatives thereof is transferred to you under Terms.
20 //
21 // 2. You understand that MStar Software might include, incorporate or be
22 //    supplied together with third party`s software and the use of MStar
23 //    Software may require additional licenses from third parties.
24 //    Therefore, you hereby agree it is your sole responsibility to separately
25 //    obtain any and all third party right and license necessary for your use of
26 //    such third party`s software.
27 //
28 // 3. MStar Software and any modification/derivatives thereof shall be deemed as
29 //    MStar`s confidential information and you agree to keep MStar`s
30 //    confidential information in strictest confidence and not disclose to any
31 //    third party.
32 //
33 // 4. MStar Software is provided on an "AS IS" basis without warranties of any
34 //    kind. Any warranties are hereby expressly disclaimed by MStar, including
35 //    without limitation, any warranties of merchantability, non-infringement of
36 //    intellectual property rights, fitness for a particular purpose, error free
37 //    and in conformity with any international standard.  You agree to waive any
38 //    claim against MStar for any loss, damage, cost or expense that you may
39 //    incur related to your use of MStar Software.
40 //    In no event shall MStar be liable for any direct, indirect, incidental or
41 //    consequential damages, including without limitation, lost of profit or
42 //    revenues, lost or damage of data, and unauthorized system use.
43 //    You agree that this Section 4 shall still apply without being affected
44 //    even if MStar Software has been modified by MStar in accordance with your
45 //    request or instruction for your use, except otherwise agreed by both
46 //    parties in writing.
47 //
48 // 5. If requested, MStar may from time to time provide technical supports or
49 //    services in relation with MStar Software to you for your use of
50 //    MStar Software in conjunction with your or your customer`s product
51 //    ("Services").
52 //    You understand and agree that, except otherwise agreed by both parties in
53 //    writing, Services are provided on an "AS IS" basis and the warranty
54 //    disclaimer set forth in Section 4 above shall apply.
55 //
56 // 6. Nothing contained herein shall be construed as by implication, estoppels
57 //    or otherwise:
58 //    (a) conferring any license or right to use MStar name, trademark, service
59 //        mark, symbol or any other identification;
60 //    (b) obligating MStar or any of its affiliates to furnish any person,
61 //        including without limitation, you and your customers, any assistance
62 //        of any kind whatsoever, or any information; or
63 //    (c) conferring any license or right under any intellectual property right.
64 //
65 // 7. These terms shall be governed by and construed in accordance with the laws
66 //    of Taiwan, R.O.C., excluding its conflict of law rules.
67 //    Any and all dispute arising out hereof or related hereto shall be finally
68 //    settled by arbitration referred to the Chinese Arbitration Association,
69 //    Taipei in accordance with the ROC Arbitration Law and the Arbitration
70 //    Rules of the Association by three (3) arbitrators appointed in accordance
71 //    with the said Rules.
72 //    The place of arbitration shall be in Taipei, Taiwan and the language shall
73 //    be English.
74 //    The arbitration award shall be final and binding to both parties.
75 //
76 //******************************************************************************
77 //<MStar Software>
78 ////////////////////////////////////////////////////////////////////////////////
79 //
80 // Copyright (c) 2008-2009 MStar Semiconductor, Inc.
81 // All rights reserved.
82 //
83 // Unless otherwise stipulated in writing, any and all information contained
84 // herein regardless in any format shall remain the sole proprietary of
85 // MStar Semiconductor Inc. and be kept in strict confidence
86 // ("MStar Confidential Information") by the recipient.
87 // Any unauthorized act including without limitation unauthorized disclosure,
88 // copying, use, reproduction, sale, distribution, modification, disassembling,
89 // reverse engineering and compiling of the contents of MStar Confidential
90 // Information is unlawful and strictly prohibited. MStar hereby reserves the
91 // rights to any and all damages, losses, costs and expenses resulting therefrom.
92 //
93 ////////////////////////////////////////////////////////////////////////////////
94 
95 #ifndef _DEV_AUDIO_H_
96 #define _DEV_AUDIO_H_
97 #include "MsCommon.h"
98 #include "halAUR2.h"
99 
100 
101 #include "MsTypes.h"
102 #include "drvAUDIO_if.h"
103 #include "drvAUDIO_internal.h"
104 #include "apiMBX_St.h"
105 #include "apiMBX.h"
106 
107 
108 //-------------------------------------------------------------------------------------------------
109 //  Macro and Define
110 //-------------------------------------------------------------------------------------------------
111 
112 #define AUDIO_SHM_NAME    "Linux AUDIO driver"
113 #define AUDIO_TEE_INFO_SHM_NAME    "AUDIO TEE INFO SHM"
114 
115 #define AUD_CHK_DSP_READ_RDY            0x08
116 #define AUD_CHK_DSP_WRITE_RDY           0x10
117 #define AUD_R2_DMA_BURST_BYTES          0x4C
118 
119 #define AUMASK_BIT0    0x0001
120 #define AUMASK_BIT1    0x0002
121 #define AUMASK_BIT2    0x0004
122 #define AUMASK_BIT3    0x0008
123 #define AUMASK_BIT4    0x0010
124 #define AUMASK_BIT5    0x0020
125 #define AUMASK_BIT6    0x0040
126 #define AUMASK_BIT7    0x0080
127 
128 #define au_bit0_(val)  ((MS_U8)(val & AUMASK_BIT0))
129 #define au_bit1_(val)  ((MS_U8)(val & AUMASK_BIT1))
130 #define au_bit2_(val)  ((MS_U8)(val & AUMASK_BIT2))
131 #define au_bit3_(val)  ((MS_U8)(val & AUMASK_BIT3))
132 #define au_bit4_(val)  ((MS_U8)(val & AUMASK_BIT4))
133 #define au_bit5_(val)  ((MS_U8)(val & AUMASK_BIT5))
134 #define au_bit6_(val)  ((MS_U8)(val & AUMASK_BIT6))
135 #define au_bit7_(val)  ((MS_U8)(val & AUMASK_BIT7))
136 
137 #define R1BYTE(u32Addr, u8mask) \
138     (READ_BYTE ((MS_VIRT)_gMIO_MapBase + ((u32Addr) << 1) - ((u32Addr) & 1)) & (u8mask))
139 
140 #define W1BYTE(u32Addr, u8Val, u8mask)      \
141     (WRITE_BYTE((MS_VIRT)_gMIO_MapBase + ((u32Addr) << 1) - ((u32Addr) & 1), (R1BYTE(u32Addr, 0xFF) & ~(u8mask)) | ((u8Val) & (u8mask))))
142 
143 // u32Addr must be 16bit aligned
144 #define R2BYTE(u32Addr, u16mask)  \
145     (READ_WORD ((MS_VIRT)_gMIO_MapBase + ((u32Addr) << 1)) & (u16mask))
146 
147 // u32Addr must be 16bit aligned
148 #define W2BYTE(u32Addr, u16Val, u16mask)    \
149     (WRITE_WORD((MS_VIRT)_gMIO_MapBase + ((u32Addr) << 1), (R2BYTE(u32Addr, 15:0) & ~(u16mask)) | ((u16Val) & (u16mask))))
150 
151 ///////////////////////////////////////////////////////////////
152 #define _AU_AbsWriteByte( u32Reg, u8Val )   \
153      do {   \
154      (WRITE_BYTE((MS_VIRT)_gMIO_MapBase + ((u32Reg) << 1) - ((u32Reg) & 1), u8Val)); \
155           }while(0)
156 
157 #define _AU_AbsWrite2Byte( u32Reg, u16Val ) \
158      do {   \
159      (WRITE_WORD((MS_VIRT)_gMIO_MapBase + ((u32Reg) << 1), u16Val)); \
160           }while(0)
161 
162 #define _AU_AbsWriteMaskByte( u32Reg, u8Mask, u8Val )   \
163     do {    \
164     (WRITE_BYTE((MS_VIRT)_gMIO_MapBase + ((u32Reg) << 1) - ((u32Reg) & 1), (R1BYTE((u32Reg), 0xFF) & ~(u8Mask)) | ((u8Val) & (u8Mask))));    \
165         }while(0)
166 
167 #define _AU_AbsReadByte( u32Reg) (READ_BYTE ((MS_VIRT)_gMIO_MapBase + ((u32Reg) << 1) - ((u32Reg) & 1)))
168 #define _AU_AbsRead2Byte( u32Reg)  (READ_WORD ((MS_VIRT)_gMIO_MapBase + ((u32Reg) << 1)) )
169 
170 #define HAL_AUDIO_DecReadReg    HAL_AUDIO_ReadReg
171 #define HAL_AUDIO_SeReadReg    HAL_AUDIO_ReadReg
172 #define HAL_AUDIO_DecReadByte   HAL_AUDIO_ReadByte
173 #define HAL_AUDIO_SeReadByte   HAL_AUDIO_ReadByte
174 #define HAL_AUDIO_DecWriteByte  HAL_AUDIO_WriteByte
175 #define HAL_AUDIO_SeWriteByte  HAL_AUDIO_WriteByte
176 #define HAL_AUDIO_DecWriteMaskByte  HAL_AUDIO_WriteMaskByte
177 #define HAL_AUDIO_SeWriteMaskByte  HAL_AUDIO_WriteMaskByte
178 #define HAL_AUDIO_DecWriteReg  HAL_AUDIO_WriteReg
179 #define HAL_AUDIO_SeWriteReg  HAL_AUDIO_WriteReg
180 #define HAL_AUDIO_DecWriteMaskReg  HAL_AUDIO_WriteMaskReg
181 #define HAL_AUDIO_SeWriteMaskReg  HAL_AUDIO_WriteMaskReg
182 
183 //Enable MS10 DDT Dual decode
184 #define MS10_DDT_DUAL
185 
186 #if (defined(CONFIG_MBOOT))
187     #define AUDIO_DELAY1US(x)                {int xxxx, jjjj, iiii=0; for(xxxx=0; xxxx<x; xxxx++) for(jjjj=0; jjjj<10; jjjj++) iiii++; }
188     #define AUDIO_DELAY1MS(x)                {int xxxx, jjjj, iiii=0; for(xxxx=0; xxxx<x; xxxx++) for(jjjj=0; jjjj<10000; jjjj++) iiii++; }
189 #elif (defined(MCU_AEON))
190     #define AUDIO_DELAY1US(x)                MsOS_DelayTaskUs(x)
191     #define AUDIO_DELAY1MS(x)                AUDIO_DELAY1US(x*1000)
192 #else
193     #define AUDIO_DELAY1US(x)                MsOS_DelayTaskUs(x)
194     #define AUDIO_DELAY1MS(x)                MsOS_DelayTask(x)
195 #endif
196 
197 #define AUDIO_HW_DMA_READER1_SUPPORT    1
198 #define AUDIO_HW_DMA_READER2_SUPPORT    1
199 #define AUDIO_SW_DMA_READER1_SUPPORT    0
200 #define AUDIO_R2_DMA_READER1_SUPPORT    0
201 #define AUDIO_R2_DMA_READER2_SUPPORT    0
202 #define AUDIO_PCM_CAPTURE1_SUPPORT    1
203 #define AUDIO_PCM_CAPTURE2_SUPPORT    1
204 #define AUDIO_HW_DMA_WRITER1_SUPPORT    0
205 
206 #define ASND_R2_SUPPORT    0
207 
208 #define AUDIO_AD_SUPPORT    1
209 
210 //-------------------------------------------------------------------------------------------------
211 //  Type and Structure
212 //-------------------------------------------------------------------------------------------------
213 typedef struct
214 {
215     MS_S64 curPTS;
216     MS_U32 os_Time;
217     MS_BOOL set2Clr;
218 } AUDIO_PTS_INFO;
219 
220 typedef struct
221 {
222     MS_U32 Mem_addr;
223     MS_U32 Mem_size;
224 } AUDIO_RTSP_INFO;
225 
226 /// Audio register structure
227 typedef struct
228 {
229     MS_U32  u32Addr;                    ///< Reg address
230     MS_U8   u8Mask;                     ///<Reg Mask
231     MS_U8   u8Value;                    ///<Reg Value
232 }AUDIO_REG_TYPE, *PAUDIO_REG_TYPE;
233 
234 /// Audio register structure2
235 typedef struct
236 {
237     MS_U32   u32Addr;                    ///< Reg address2
238     MS_U16   u16Mask;                     ///<Reg Mask2
239     MS_U16   u16Value;                    ///<Reg Value2
240 }AUDIO_REG_TYPE2, *PAUDIO_REG_TYPE2;
241 
242 //================================================================
243 //  Structure
244 //================================================================
245 
246 //-------------------------------------------------------------------------------------------------
247 //  Function and Variable
248 //-------------------------------------------------------------------------------------------------
249 MS_BOOL HAL_AUDIO_InitialVars(void);
250 MS_BOOL HAL_AUDIO_DeInitialVars(void);
251 void HAL_AUDIO_SET_INIT_FLAG(MS_BOOL bSet);
252 MS_BOOL HAL_AUDIO_GET_INIT_FLAG(void);
253 MS_BOOL HAL_AUDIO_Mutex_Init(void);
254 MS_BOOL HAL_AUDIO_Mutex_DeInit(void);
255 void    HAL_AUDIO_Set_MMIO_BASE(MS_VIRT _MMIO_MapBase);
256 AU_CHIP_TYPE HAL_AUDIO_GetChipType(void);
257 void HAL_AUDIO_SET_IPAUTH(MS_U32 ip_auth);
258 void HAL_AUDIO_DSPPowerSaving(HDMI_TX_OUTPUT_TYPE outType_tmp);
259 
260 //================================================================
261 //  Basic Register read/write function
262 //================================================================
263 MS_U8   HAL_AUDIO_AbsReadByte(MS_U32 u32RegAddr);
264 MS_U8   HAL_AUDIO_ReadByte(MS_U32 u32RegAddr);
265 MS_U16  HAL_AUDIO_AbsReadReg(MS_U32 u32RegAddr);
266 MS_U16  HAL_AUDIO_ReadReg(MS_U32 u32RegAddr);
267 void    HAL_AUDIO_AbsWriteByte(MS_U32 u32RegAddr, MS_U8 u8Val);
268 void    HAL_AUDIO_WriteByte(MS_U32 u32RegAddr, MS_U8 u8Val);
269 void    HAL_AUDIO_AbsWriteReg(MS_U32 u32RegAddr, MS_U16 u16Val);
270 void    HAL_AUDIO_WriteReg(MS_U32 u32RegAddr, MS_U16 u16Val);
271 void    HAL_AUDIO_AbsWriteMaskReg(MS_U32 u32RegAddr, MS_U16 u16Mask, MS_U16 u16Val);
272 void    HAL_AUDIO_WriteMaskReg(MS_U32 u32RegAddr, MS_U16 u16Mask, MS_U16 u16Val);
273 void    HAL_AUDIO_AbsWriteMaskByte(MS_U32 u32RegAddr, MS_U8 u8Mask, MS_U8 u8Val);
274 void    HAL_AUDIO_WriteMaskByte(MS_U32 u32RegAddr, MS_U8 u8Mask, MS_U8 u8Val);
275 
276 void    _HAL_AUDIO_Write4Byte(MS_U32 u32RegAddr, MS_U32 u32Val);
277 
278 void    HAL_AUDIO_WriteMailBox(MS_BOOL bDspType, MS_U8 u8ParamNum, MS_U16 u16Data);
279 MS_U16  HAL_AUDIO_ReadMailBox(MS_BOOL bDspType, MS_U8 u8ParamNum);
280 void    HAL_AUDIO_DmaReader_AllInput_Init(void);
281 
282 //================================================================
283 //  For Audio initialize
284 //================================================================
285 MS_BOOL HAL_AUDIO_Init(MS_BOOL Initype);
286 void    HAL_AUDIO_WriteInitTable(void);
287 void    HAL_AUDIO_WritePreInitTable(void);                //Refine power on sequence for earphone & DAC pop noise issue
288 void    HAL_AUDIO_WriteStopDecTable(void);                //Set stop command to R2/DSP
289 void    HAL_AUDIO_DAC_Clock_OnOff(MS_BOOL b_enable);
290 void    HAL_AUDIO_EnaEarphone_LowPower_Stage(void);        //Refine power on sequence for earphone & DAC pop noise issue
291 void    HAL_AUDIO_EnaEarphone_HighDriving_Stage(void);    //Refine power on sequence for earphone & DAC pop noise issue
292 void    HAL_AUDIO_SetPowerOn(MS_BOOL bPower_on);
293 void    HAL_AUDIO_ADCInit(void);
294 void    HAL_AUDIO_SwResetMAD(void);
295 void    HAL_AUDIO_ResetDSP(void);
296 void    HAL_AUDIO_TriggerSifPLL(void);
297 
298 void    HAL_AUDIO_DecDspISR(void);
299 void    HAL_AUDIO_SeDspISR(void);
300 
301 void    HAL_AUDIO_SetPlayFileFlag(MS_BOOL bDspType, MS_BOOL bSet);
302 MS_BOOL HAL_AUDIO_GetPlayFileFlag(MS_BOOL bDspType);
303 void    HAL_AUDIO_SetEncodeDoneFlag(MS_BOOL bSet);
304 MS_BOOL HAL_AUDIO_GetEncodeDoneFlag(void);
305 void    HAL_AUDIO_DmaWriter_Init(void);
306 MS_BOOL HAL_AUDIO_CheckBootOnInitState(void);
307 
308 //================================================================
309 // Audio I/O Config. function
310 //================================================================
311 AUDIO_PATH_GROUP_TYPE HAL_AUDIO_GetPathGroup(void);
312 void    HAL_AUDIO_SetNormalPath(AUDIO_PATH_TYPE path, AUDIO_INPUT_TYPE input, AUDIO_OUTPUT_TYPE output);
313 void    HAL_AUDIO_SetInputPath(AUDIO_INPUT_TYPE u8Input, AUDIO_PATH_TYPE u8Path);
314 void    HAL_AUDIO_SetOutputPath(AUDIO_PATH_TYPE u8Path, AUDIO_OUTPUT_TYPE u8Output);
315 void    HAL_AUDIO_SetInternalPath(AUDIO_INTERNAL_PATH_TYPE u8Path,  AUDIO_OUTPUT_TYPE u8Output);
316 void    HAL_AUDIO_FwTriggerDSP(MS_U16 u16Cmd);
317 void    HAL_AUDIO_DspBootOnDDR(MS_BOOL bEnable);
318 MS_BOOL HAL_AUDIO_GetIsDtvFlag(void);
319 void    HAL_AUDIO_SetIsDtvFlag(MS_BOOL);
320 
321 MS_U8   HAL_AUDIO_ReadDspCodeType(void);
322 MS_U8   HAL_AUDIO_Dec_Status(void);
323 MS_U8   HAL_AUDIO_Se_Status(void);
324 void    HAL_AUDIO_Set_Fading(MS_U32 u32VolFading);
325 
326 void    HAL_AUDIO_BT_SetUploadRate(MS_BOOL bEnable,MS_U8 u8Samprate);
327 void    HAL_AUDIO_BT_SetBufferCounter(MS_U32 u32Counter);
328 void    HAL_AUDIO_USBPCM_Enable(MS_BOOL bEnable);
329 MS_BOOL HAL_AUDIO_USBPCM_GetFlag(void);
330 void    HAL_AUDIO_USBPCM_SetFlag(MS_BOOL bEnable);
331 void    HAL_AUDIO_USBPCM_GetMemInfo(AUDIO_UPLOAD_INFO *uploadInfo);
332 MS_BOOL HAL_AUDIO_SetDataCaptureSource(AUDIO_DEVICE_TYPE eID, AUDIO_CAPTURE_SOURCE_TYPE eSource);
333 MS_BOOL HAL_AUDIO_PCMCapture_Init(const AUDIO_DEVICE_TYPE eID, const AUDIO_CAPTURE_SOURCE_TYPE eSource);
334 MS_BOOL HAL_AUDIO_PCMCapture_Start(const AUDIO_DEVICE_TYPE eID);
335 MS_BOOL HAL_AUDIO_PCMCapture_Stop(const AUDIO_DEVICE_TYPE eID);
336 MS_BOOL HAL_AUDIO_PCMCapture_Read(const AUDIO_DEVICE_TYPE eID, void* buffer, const MS_U32 bytes);
337 
338 void    _HAL_AUDIO_I2S_SetMode(MS_U8 u8Mode, MS_U8 u8Val);
339 
340 //=====================================================
341 // AUDIO SPDIF Relational Hal Function
342 //=====================================================
343 void    _HAL_AUDIO_SPDIF_HWEN(MS_BOOL bEnable);
344 void    _HAL_AUDIO_SPDIF_SetMute(MS_BOOL bEnMute);
345 void    HAL_AUDIO_SPDIF_SetMode(MS_U8 u8Spdif_mode, MS_U8 u8Input_src);
346 MS_U8   _HAL_AUDIO_SPDIF_GetMode(void);
347 void    _HAL_AUDIO_SPDIF_ByPassChannel(MS_BOOL bEnable);
348 void    HAL_AUDIO_SPDIF_SetSCMS(MS_U8 C_bit_en, MS_U8 L_bit_en);
349 MS_U8   HAL_AUDIO_SPDIF_GetSCMS(void);
350 void    HAL_AUDIO_SetChannelStatus(SPDIF_CS_MODE_TYPE eType, SPDIF_CS_MODE_VALUE eValue);
351 MS_BOOL HAL_AUDIO_SPDIF_ChannelStatus_CTRL(AUDIO_SPDIF_CS_TYPE cs_mode, AUDIO_SPDIF_CS_TYPE_STATUS status);
352 void    HAL_AUDIO_SPDIF_Monitor_SamplingRate(void);
353 void    HAL_AUDIO_SPDIF_SetOutputType(AUDIO_SOURCE_INFO_TYPE eSource, AUDIO_SPDIF_OUTPUT_TYPE eType);
354 
355 void HAL_AUDIO_SetDigitalOut(DIGITAL_OUTPUT_TYPE ePath, AUDIO_DIGITAL_OUTPUT_TYPE eDigitalMode);
356 MS_BOOL HAL_AUDIO_DigitalOut_SetChannelStatus(DIGITAL_OUTPUT_TYPE ePath, Digital_Out_Channel_Status_t *stChannelStatus);
357 MS_BOOL HAL_AUDIO_DigitalOut_GetChannelStatus(DIGITAL_OUTPUT_TYPE ePath, Digital_Out_Channel_Status_t *stChannelStatus);
358 void  HAL_AUDIO_Set_DecimationMode(AUDIO_OUTPUT_TYPE Output_Type, Audio_id ID);
359 
360 //=====================================================
361 // AUDIO HDMI Relational Hal Function
362 //=====================================================
363 void    _HAL_AUDIO_HDMI_Tx_SetMute(MS_BOOL bEnMute);
364 MS_BOOL HAL_AUDIO_HDMI_NonpcmMonitor(void);
365 MS_U8   HAL_AUDIO_HDMI_NonpcmMonitor2(void);
366 MS_U8   HAL_AUDIO_HDMI_DolbyMonitor(void);
367 void    HAL_AUDIO_HDMI_SetNonpcm(MS_U8 u8NonPCM_en);
368 void    HAL_AUDIO_HDMI_AC3_PathCFG(MS_U8 u8Ctrl);
369 MS_U16  HAL_AUDIO_HDMI_Get_SYNTH_FREQ(void);
370 void    HAL_AUDIO_HDMI_Set_DwonSample(MS_U8 ratio);
371 void    HAL_AUDIO_HDMIAutoMute(MS_U8 ch, MS_U8 value);
372 void    HAL_AUDIO_HDMI_Tx_GetStatus(MS_BOOL *onOff, AUDIO_FS_TYPE *hdmi_SmpFreq, HDMI_TX_OUTPUT_TYPE *outType );
373 void    HAL_AUDIO_HDMI_TX_SetMode(HDMI_TX_OUTPUT_TYPE outType, AUDIO_SOURCE_INFO_TYPE eSource);
374 MS_BOOL HAL_AUDIO_HDMI_RX_GetHdmiInAudioStatus( ST_HDMI_AUDIO_STATUS *p_hdmiAudioSts);
375 //================================================================
376 // for audio driver internal use function
377 //================================================================
378 void    _HAL_AUDIO_InitStep1(void);
379 void    HAL_AUDIO_SetDspBaseAddr(MS_U8 u8Index, MS_PHY phyBin_Base_Address, MS_PHY phyMad_Base_Buffer_Adr);
380 MS_PHY  HAL_AUDIO_GetDspMadBaseAddr(MS_U8 u8Index);
381 MS_PHY  HAL_AUDIO_GetDspBinBaseAddr(MS_U8 u8Index);
382 void    HAL_AUDIO_SetDspCodeType(AUDIO_DSP_CODE_TYPE dspCodeType, MS_BOOL bFlag);
383 AUDIO_DSP_CODE_TYPE   HAL_AUDIO_GetDspCodeType(void);
384 void    HAL_AUDIO_SetDsp2CodeType(AUDIO_DSP_CODE_TYPE dspCodeType, MS_BOOL bFlag);
385 AUDIO_DSP_CODE_TYPE   HAL_AUDIO_GetDsp2CodeType(void);
386 MS_U8   HAL_AUDIO_GetDSPalive(void);
387 void    HAL_AUDIO_SetDSPalive(MS_U8 alive);
388 void    HAL_AUDIO_SetAdvSndEffDspCodeType(AUDIO_DSP_CODE_TYPE dspCodeType, MS_BOOL bFlag);
389 AUDIO_DSP_CODE_TYPE   HAL_AUDIO_GetAdvSndEffDspCodeType(void);
390 void    HAL_AUDIO_BackupMailbox(void);
391 void    HAL_AUDIO_RestoreMailbox(void);
392 MS_U8   HAL_AUDIO_Enc_Status(void);
393 void    HAL_AUDIO_DmaReader_Init(SAMPLE_RATE sampleRate);
394 void    HAL_AUDIO_DmaReader_AllInput_Init(void);
395 MS_BOOL HAL_AUDIO_DmaReader_WritePCM(void* buffer, MS_U32 bytes);
396 void    HAL_AUDIO_SetEntertainmentMode(AUDIO_ENTERTAINMENT_MODE eMode);
397 MS_BOOL HAL_AUDIO_AlgReloadCode(AUDIO_DSP_CODE_TYPE dspCodeType);
398 MS_BOOL HAL_AUDIO_Alg2ReloadCode(AUDIO_DSP_CODE_TYPE dspCodeType);
399 MS_BOOL HAL_AUDIO_SetSystem(En_DVB_decSystemType enDecSystem);
400 MS_BOOL HAL_AUDIO_GetDecSysSupportStatus(En_DVB_decSystemType enDecSystem);
401 
402 MS_U16  HAL_AUDIO_GetUniDecodeDoneTag(void);
403 MS_U16  HAL_AUDIO_GetUniDecodeFrameCnt(AUDIO_DEC_ID eDSPId);
404 void    HAL_AUDIO_PTS_info( MS_VIRT );
405 
406 void    HAL_AUDIO_RebootDecDSP(void);
407 MS_U8   HAL_AUDIO_ReadDspCounter(AUDIO_DSP_COUNTER_TYPE  CounterType);
408 void    HAL_AUDIO_DspReboot(MS_U8 alive);
409 void    HAL_AUDIO_SetPowerDownWait(MS_BOOL bEnable);
410 void    HAL_AUDIO_SendIntrupt(MS_BOOL bDspType,MS_U16 u8Cmd);
411 MS_BOOL HAL_AUDIO_SeSystemLoadCode(void);
412 MS_BOOL HAL_AUDIO_DecoderLoadCode(void);
413 
414 extern MS_BOOL HAL_AUDSP_DspLoadCode(AUDIO_DSP_CODE_TYPE dspCodeType);
415 void    HAL_AUDIO_update_DspUsage(AUDIO_SOURCE_INFO_TYPE eSourceType);
416 Audio_id HAL_AUDIO_Convert_DecId_to_ADECId(AUDIO_DEC_ID dec_id);
417 
418 MS_U32 HAL_AUDIO_GetCaps(AUDIO_DEC_ID DecId, MS_U32 *pCaps);
419 MS_BOOL HAL_AUDIO_CheckPlayDone(void);
420 
421 MS_S32 HAL_AUDIO_InputSwitch(AUDIO_SWITCH_GROUP enGroup);
422 
423 //================================================================
424 // Audio ALSA Interface Relational Function
425 //================================================================
426 MS_BOOL HAL_AUDIO_ALSA_Check(void);
427 MS_BOOL HAL_AUDIO_ALSA_Enable(MS_BOOL bEnable);
428 
429 MS_BOOL HAL_AUDIO_ReloadCode(AUDIO_DSP_ID id, AUDIO_DSP_CODE_TYPE code_type);
430 MS_BOOL HAL_AUDIO_AlgReloadCode2(AUDIO_DSP_ID id, void * pau_info);
431 MS_BOOL HAL_AUDIO_SetSystem2(AUDIO_DEC_ID DecId, En_DVB_decSystemType Param);
432 MS_BOOL HAL_AUDIO_SetDecodeSystem(AUDIO_DEC_ID DecId, AudioDecStatus_t *p_AudioDecStatus);
433 //================================================================
434 // Audio dump debug message
435 //================================================================
436 void HAL_AUDIO_DumpDspInfo(void);
437 AUDIO_DEC_ID HAL_AUDIO_OpenDecodeSystem(AudioDecStatus_t * p_AudioDecStatus);
438 MS_PHY HAL_AUDIO_GetDDRInfo(AUDIO_DEC_ID DecId, EN_AUDIO_DDRINFO DDRInfo);
439 MS_BOOL HAL_AUDIO_CheckVersionInfo(void);
440 
441 //================================================================
442 // Audio Common PCM Interface
443 //================================================================
444 #if AUDIO_HW_DMA_READER1_SUPPORT
445 MS_S32 HAL_AUDIO_PCM_HwDma_Reader1_Open(void *pData);
446 MS_S32 HAL_AUDIO_PCM_HwDma_Reader1_Close(void);
447 MS_S32 HAL_AUDIO_PCM_HwDma_Reader1_Start(void);
448 MS_S32 HAL_AUDIO_PCM_HwDma_Reader1_Stop(void);
449 MS_S32 HAL_AUDIO_PCM_HwDma_Reader1_Set(MS_U32 u32Cmd, const void *pData);
450 MS_S32 HAL_AUDIO_PCM_HwDma_Reader1_Get(MS_U32 u32Cmd, void *pData);
451 MS_U32 HAL_AUDIO_PCM_HwDma_Reader1_Write(const void *pBuf, MS_U32 u32Size);
452 MS_S32 HAL_AUDIO_PCM_HwDma_Reader1_Flush(void);
453 #endif
454 
455 #if AUDIO_HW_DMA_READER2_SUPPORT
456 MS_S32 HAL_AUDIO_PCM_HwDma_Reader2_Open(void *pData);
457 MS_S32 HAL_AUDIO_PCM_HwDma_Reader2_Close(void);
458 MS_S32 HAL_AUDIO_PCM_HwDma_Reader2_Start(void);
459 MS_S32 HAL_AUDIO_PCM_HwDma_Reader2_Stop(void);
460 MS_S32 HAL_AUDIO_PCM_HwDma_Reader2_Set(MS_U32 u32Cmd, const void *pData);
461 MS_S32 HAL_AUDIO_PCM_HwDma_Reader2_Get(MS_U32 u32Cmd, void *pData);
462 MS_U32 HAL_AUDIO_PCM_HwDma_Reader2_Write(const void *pBuf, MS_U32 u32Size);
463 MS_S32 HAL_AUDIO_PCM_HwDma_Reader2_Flush(void);
464 #endif
465 
466 #if AUDIO_SW_DMA_READER1_SUPPORT
467 MS_S32 HAL_AUDIO_PCM_SwDma_Reader1_Open(void *pData);
468 MS_S32 HAL_AUDIO_PCM_SwDma_Reader1_Close(void);
469 MS_S32 HAL_AUDIO_PCM_SwDma_Reader1_Start(void);
470 MS_S32 HAL_AUDIO_PCM_SwDma_Reader1_Stop(void);
471 MS_S32 HAL_AUDIO_PCM_SwDma_Reader1_Set(MS_U32 u32Cmd, const void *pData);
472 MS_S32 HAL_AUDIO_PCM_SwDma_Reader1_Get(MS_U32 u32Cmd, void *pData);
473 MS_U32 HAL_AUDIO_PCM_SwDma_Reader1_Write(const void *pBuf, MS_U32 u32Size);
474 MS_S32 HAL_AUDIO_PCM_SwDma_Reader1_Flush(void);
475 #endif
476 
477 #if AUDIO_R2_DMA_READER1_SUPPORT
478 MS_S32 HAL_AUDIO_PCM_R2Dma_Reader1_Open(void *pData);
479 MS_S32 HAL_AUDIO_PCM_R2Dma_Reader1_Close(void);
480 MS_S32 HAL_AUDIO_PCM_R2Dma_Reader1_Start(void);
481 MS_S32 HAL_AUDIO_PCM_R2Dma_Reader1_Stop(void);
482 MS_S32 HAL_AUDIO_PCM_R2Dma_Reader1_Set(MS_U32 u32Cmd, const void *pData);
483 MS_S32 HAL_AUDIO_PCM_R2Dma_Reader1_Get(MS_U32 u32Cmd, void *pData);
484 MS_U32 HAL_AUDIO_PCM_R2Dma_Reader1_Write(const void *pBuf, MS_U32 u32Size);
485 MS_S32 HAL_AUDIO_PCM_R2Dma_Reader1_Flush(void);
486 #endif
487 
488 #if AUDIO_R2_DMA_READER2_SUPPORT
489 MS_S32 HAL_AUDIO_PCM_R2Dma_Reader2_Open(void *pData);
490 MS_S32 HAL_AUDIO_PCM_R2Dma_Reader2_Close(void);
491 MS_S32 HAL_AUDIO_PCM_R2Dma_Reader2_Start(void);
492 MS_S32 HAL_AUDIO_PCM_R2Dma_Reader2_Stop(void);
493 MS_S32 HAL_AUDIO_PCM_R2Dma_Reader2_Set(MS_U32 u32Cmd, const void *pData);
494 MS_S32 HAL_AUDIO_PCM_R2Dma_Reader2_Get(MS_U32 u32Cmd, void *pData);
495 MS_U32 HAL_AUDIO_PCM_R2Dma_Reader2_Write(const void *pBuf, MS_U32 u32Size);
496 MS_S32 HAL_AUDIO_PCM_R2Dma_Reader2_Flush(void);
497 #endif
498 
499 #if AUDIO_PCM_CAPTURE1_SUPPORT
500 MS_S32 HAL_AUDIO_PCM_Capture1_Open(void *pData);
501 MS_S32 HAL_AUDIO_PCM_Capture1_Close(void);
502 MS_S32 HAL_AUDIO_PCM_Capture1_Start(void);
503 MS_S32 HAL_AUDIO_PCM_Capture1_Stop(void);
504 MS_S32 HAL_AUDIO_PCM_Capture1_Set(MS_U32 u32Cmd, const void *pData);
505 MS_S32 HAL_AUDIO_PCM_Capture1_Get(MS_U32 u32Cmd, void *pData);
506 MS_U32 HAL_AUDIO_PCM_Capture1_Read(void *pBuf, MS_U32 u32Size);
507 MS_S32 HAL_AUDIO_PCM_Capture1_Flush(void);
508 #endif
509 
510 #if AUDIO_PCM_CAPTURE2_SUPPORT
511 MS_S32 HAL_AUDIO_PCM_Capture2_Open(void *pData);
512 MS_S32 HAL_AUDIO_PCM_Capture2_Close(void);
513 MS_S32 HAL_AUDIO_PCM_Capture2_Start(void);
514 MS_S32 HAL_AUDIO_PCM_Capture2_Stop(void);
515 MS_S32 HAL_AUDIO_PCM_Capture2_Set(MS_U32 u32Cmd, const void *pData);
516 MS_S32 HAL_AUDIO_PCM_Capture2_Get(MS_U32 u32Cmd, void *pData);
517 MS_U32 HAL_AUDIO_PCM_Capture2_Read(void *pBuf, MS_U32 u32Size);
518 MS_S32 HAL_AUDIO_PCM_Capture2_Flush(void);
519 #endif
520 
521 #if AUDIO_HW_DMA_WRITER1_SUPPORT
522 MS_S32 HAL_AUDIO_PCM_HwDma_Writer1_Open(void *pData);
523 MS_S32 HAL_AUDIO_PCM_HwDma_Writer1_Close(void);
524 MS_S32 HAL_AUDIO_PCM_HwDma_Writer1_Start(void);
525 MS_S32 HAL_AUDIO_PCM_HwDma_Writer1_Stop(void);
526 MS_S32 HAL_AUDIO_PCM_HwDma_Writer1_Set(MS_U32 u32Cmd, const void *pData);
527 MS_S32 HAL_AUDIO_PCM_HwDma_Writer1_Get(MS_U32 u32Cmd, void *pData);
528 MS_U32 HAL_AUDIO_PCM_HwDma_Writer1_Read(void *pBuf, MS_U32 u32Size);
529 MS_S32 HAL_AUDIO_PCM_HwDma_Writer1_Flush(void);
530 #endif
531 
532 AUDIO_SOURCE_INFO_TYPE HAL_AUDIO_ConvertInputType2SourceInfo(AUDIO_INPUT_TYPE eInputType);
533 
534 //================================================================
535 // Specific Definitions for Audio TEE
536 //================================================================
537 #define ree_to_tee_mbx_msg    pAudioTeeInfoShm->ReeToTeeMbxMsg
538 #define tee_to_ree_mbx_msg    pAudioTeeInfoShm->TeeToReeMbxMsg
539 #define tee_mbx_msg_class    pAudioTeeInfoShm->u8MbxMsgClass
540 #define audio_tee_enabled    pAudioTeeInfoShm->g_bAudioTeeEnabled
541 #define audio_tee_mbx_initialized    pAudioTeeInfoShm->g_bAudioTeeMbxInitialized
542 #define dec_dsp_secure_tee_accessed    pAudioTeeInfoShm->g_bDecDspSecureTeeAccessed
543 #define snd_dsp_secure_tee_accessed    pAudioTeeInfoShm->g_bSndDspSecureTeeAccessed
544 #define mbx_msg_ack_status    pAudioTeeInfoShm->ack_status
545 
546 #define HALAUDIO_CHECK_TEE_INFO_SHM_INIT \
547     do { \
548         if (pAudioTeeInfoShm == NULL) \
549         { \
550             if (HAL_AUDIO_AllocateTeeInfoShm() == NULL) \
551             { \
552                 MS_ASSERT(0); \
553             } \
554         } \
555     } while(0)
556 
557 #define AUDIO_TEE_INFO_SHM_CHECK_NULL \
558     do { \
559         MS_ASSERT(pAudioTeeInfoShm != NULL); \
560     } while(0)
561 
562 #define REE_TO_TEE_MBX_MSG_SET_PARAM_COUNT(count) \
563     do { \
564         ree_to_tee_mbx_msg.u8ParameterCount = count; \
565     } while(0)
566 
567 #define REE_TO_TEE_MBX_MSG_SET_PARAM(index, parameter) \
568     do { \
569         ree_to_tee_mbx_msg.u8Parameters[index] = parameter; \
570     } while(0)
571 
572 #define REE_TO_TEE_MBX_MSG_INIT \
573     do{ \
574         ree_to_tee_mbx_msg.eRoleID=E_MBX_CPU_MIPS_VPE1; \
575         ree_to_tee_mbx_msg.u8Ctrl=0; \
576         ree_to_tee_mbx_msg.eMsgType=E_MBX_MSG_TYPE_INSTANT; \
577     }while(0)
578 
579 #define TEE_TO_REE_MBX_MSG_INIT(msg) \
580     do{ \
581         msg.eRoleID=E_MBX_CPU_MIPS; \
582         msg.u8Ctrl=0; \
583         msg.eMsgType=E_MBX_MSG_TYPE_INSTANT; \
584     }while(0)
585 
586 #define MBX_MSG_SET_CLASSID(msg,classID)\
587     do{ \
588         msg.u8MsgClass = classID; \
589     }while(0)
590 
591 #define MBX_MSG_SET_CMD(msg,cmd)\
592     do{ \
593         msg.u8Index = cmd; \
594     }while(0)
595 
596 #define TEE_MBX_MSG_CLASS_SET(class) \
597     do{ \
598         tee_mbx_msg_class = class;	\
599     }while(0)
600 
601 //================================================================
602 // Audio TEE MBX Message Enum Definitions (REE side to TEE siede)
603 //================================================================
604 typedef enum
605 {
606     REE_TO_TEE_MBX_MSG_NULL                     = 0x0000,
607 
608     REE_TO_TEE_MBX_MSG_TYPE_GENERAL = 0x20,
609     REE_TO_TEE_MBX_MSG_TYPE_DEC = 0x40,
610     REE_TO_TEE_MBX_MSG_TYPE_SE = 0x80,
611     // NonDSP Specific General MBX Command
612     REE_TO_TEE_MBX_MSG_HAL_AUDIO_SetDspBaseAddr = 0x01,
613     // DSP Specific MBX Command
614     REE_TO_TEE_MBX_MSG_HAL_AUDSP_DspLoadCode    = 0x11
615 } REE_TO_TEE_MBX_MSG_TYPE;
616 
617 //================================================================
618 // Audio TEE MBX Message Enum Definitions (TEE side to REE siede)
619 //================================================================
620 typedef enum
621 {
622    TEE_TO_REE_MBX_MSG_NULL                 = 0x00,
623    TEE_TO_REE_MBX_ACK_MSG_INVALID          = 0x80,
624    TEE_TO_REE_MBX_ACK_MSG_NO_TEE           = 0x81,
625    TEE_TO_REE_MBX_ACK_MSG_ACTION_SUCCESS   = 0x90,
626    TEE_TO_REE_MBX_ACK_MSG_ACTION_FAIL      = 0x91
627 } TEE_TO_REE_MBX_ACK_MSG_TYPE;
628 
629 typedef struct
630 {
631    MS_U32 g_ShmID;
632    MS_BOOL g_bAudioTeeEnabled;
633    MS_BOOL g_bAudioTeeMbxInitialized;
634 
635    MS_BOOL g_bDecDspSecureTeeAccessed;
636    MS_BOOL g_bSndDspSecureTeeAccessed;
637 
638    MBX_Msg ReeToTeeMbxMsg;
639    MBX_Msg TeeToReeMbxMsg;
640    MS_U8 u8MbxMsgClass;
641    MS_U32 g_u32ClientCounter;
642    TEE_TO_REE_MBX_ACK_MSG_TYPE ack_status;
643 } AUDIO_TEE_INFO_SHARE_MEM;
644 
645 #ifndef MSOS_TYPE_NUTTX
646 MS_BOOL HAL_AUDIO_ResetTeeInfoShmToDefault(void);
647 AUDIO_TEE_INFO_SHARE_MEM *HAL_AUDIO_AllocateTeeInfoShm(void);
648 MS_BOOL HAL_AUDIO_DeAllocateTeeInfoShm(void);
649 
650 //================================================================
651 // Audio Mailbox Relational Function
652 //================================================================
653 MS_BOOL HAL_AUDIO_RegisterMBX(void);
654 TEE_TO_REE_MBX_ACK_MSG_TYPE HAL_AUDIO_SendMBXMsg(REE_TO_TEE_MBX_MSG_TYPE msg_type);
655 #endif
656 
657 AUDIO_DSP_CODE_TYPE HAL_AUDIO_Convert_EnDVBdecSystemType_to_AudioDspCodeType(En_DVB_decSystemType enDecSystem);
658 void HAL_AUDIO_ResetDspCodeType(void);
659 MS_S32 HAL_AUDIO_CheckHashkeyDone(MS_U32 ip_auth);
660 
661 #endif // _DEV_AUDIO_H_
662