207bbdbcd291a65eb094485605613d83fb845295
[processor-sdk/performance-audio-sr.git] / pasdk / common / aspDecOpCircBuf_common.h
2 /*
3 Copyright (c) 2016, Texas Instruments Incorporated - http://www.ti.com/
4 All rights reserved.
6 * Redistribution and use in source and binary forms, with or without 
7 * modification, are permitted provided that the following conditions
8 * are met:
9 *
10 * Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 *
13 * Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the
16 * distribution.
17 *
18 * Neither the name of Texas Instruments Incorporated nor the names of
19 * its contributors may be used to endorse or promote products derived
20 * from this software without specific prior written permission.
21 *
22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
23 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
24 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
25 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
26 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
27 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
28 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
29 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
30 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
31 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
32 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33 *
34 */
36 #ifndef _ASP_DECOP_CB_COMMON_H_
37 #define _ASP_DECOP_CB_COMMON_H_
39 #include <xdc/std.h>
40 #include <ti/ipc/GateMP.h>
41 #include "paftyp.h"
42 #include "pafdec.h"
43 #define ASP_DECOP_CB_SOK                    ( 0 )       // ok
44 #define ASP_DECOP_CB_CTL_INIT_INV_GATE      ( ASP_DECOP_CB_SOK-1 )  // error: invalid gate handle
45 #define ASP_DECOP_CB_ERR_START              ( ASP_DECOP_CB_CTL_INIT_INV_GATE )
46 #define ASP_DECOP_CB_MAX_NUM_AF             ( 10 )       // decoder output circular buffer maximum number audio frames
47 #define ASP_DECOP_CB_MAX_NUM_PCM_CH         ( 16 )      // decoder output circular buffer maximum number audio PCM channels
48 #define ASP_DECOP_CB_MAX_NUM_PCM_FRAMES     ( 10 ) // decoder output circular buffer maximum number PCM frames //Qin - Increased to prevent cb overflow for ddp.
49 #define ASP_DECOP_CB_MAX_PCM_FRAME_LEN      ( 6*256 )   // decoder output circular buffer maximum PCM frame length
51 #define ASP_DECOP_CB_MAX_NUM_PCM_CH_DDP        ( 16 )     // decoder output circular buffer maximum number audio PCM channels for DDP
52 #define ASP_DECOP_CB_MAX_PCM_FRAME_LEN_48kDDP  ( 6*256 )  // decoder output circular buffer maximum PCM frame length at 48kHz sampling rate
54 #define ASP_DECOP_CB_MAX_NUM_PCM_CH_MAT        ( 32 )     // decoder output circular buffer maximum number audio PCM channels for MAT
55 #define ASP_DECOP_CB_MAX_PCM_FRAME_LEN_48kMAT  ( 4*256 )  // decoder output circular buffer maximum PCM frame length at 48kHz sampling rate
57 // TODO: update for dts
58 #define ASP_DECOP_CB_MAX_NUM_PCM_CH_DTS        ( 32 )      // decoder output circular buffer maximum number audio PCM channels for MAT
59 #define ASP_DECOP_CB_MAX_PCM_FRAME_LEN_48kDTS  ( 16*256 )  // decoder output circular buffer maximum PCM frame length at 48kHz sampling rate
61 #define ASP_DECOP_CB_PCM_BUF_SZ             ( ASP_DECOP_CB_MAX_NUM_PCM_CH * ASP_DECOP_CB_MAX_NUM_PCM_FRAMES * ASP_DECOP_CB_MAX_PCM_FRAME_LEN )
62 #define ASP_DECOP_CB_PCM_BUF_SZ_32CH48kMAT  ( ASP_DECOP_CB_MAX_NUM_PCM_CH_MAT * ASP_DECOP_CB_MAX_NUM_PCM_FRAMES * ASP_DECOP_CB_MAX_PCM_FRAME_LEN_48kMAT )
64 // PCM
65 #define ASP_DECOP_CB_MAX_NUM_AF_PCM         ( 4 )
66 #define ASP_DECOP_CB_INIT_LAG_PCM           ( 2 ) // 1...3
67 #define ASP_DECOP_CB_INIT_WRTIDX_PCM        ( ASP_DECOP_CB_INIT_LAG_PCM )
68 #define ASP_DECOP_CB_INIT_RDIDX_PCM         ( 0 )
70 // DDP
71 #define ASP_DECOP_CB_MAX_NUM_AF_DDP         ( 2 )
72 #define ASP_DECOP_CB_INIT_LAG_DDP           ( 4 ) // 0...5
73 #define ASP_DECOP_CB_INIT_WRTIDX_DDP        ( 1 )
74 #define ASP_DECOP_CB_INIT_RDIDX_DDP         ( 0 )
76 // MAT-THD
77 #define ASP_DECOP_CB_MAX_NUM_AF_THD         ( 10 )
78 #define ASP_DECOP_CB_INIT_LAG_THD           ( 3 )  
79 #define ASP_DECOP_CB_INIT_WRTIDX_THD        ( 1 )
80 #define ASP_DECOP_CB_INIT_RDIDX_THD         ( 0 )
82 // DTS - TODO: to update for DTS
83 #define ASP_DECOP_CB_MAX_NUM_AF_DTS         ( 10 )
84 #define ASP_DECOP_CB_INIT_LAG_DTS           ( 2 )
85 #define ASP_DECOP_CB_INIT_WRTIDX_DTS        ( 3 )
86 #define ASP_DECOP_CB_INIT_RDIDX_DTS         ( 0 )
88 #define ASP_DECODE_CB_GATE_NAME             ( "AspDecOpCbGate" )
89 #define ASP_DECODE_CB_GATE_REGION_ID        ( 0 )
92 // Decoder output circular buffer
93 typedef struct PAF_AST_DecOpCircBuf 
94 {
95     PAF_AudioFrame *afCb;   // audio frame CB
96     PAF_AudioData *pcmBuf;  // PCM buffer, contains PCM data associated with audio frames
97     UInt8 *metaBuf;         // metadata buffer, contains metadata associated with audio frames
98     Int8 sourceSel;         // selected source
99     Int8 afRdIdx;           // audio frame CB read index
100     Int8 afWrtIdx;          // audio frame CB write index
101     Int16 pcmRdIdx;         // pcm buffer read index
102     Int8 numAfCb;           // current number frames in CB
103     Int8 maxNumAfCb;        // maximum number of audio frames in CB
104     Int16 decOpFrameLen;    // selected decoder output frame length (input transaction size)
105     Int16 strFrameLen;      // stream frame length (output transaction size)
106     Int8 writerActiveFlag;  // flag indicates whether CB writer is active
107     Int8 readerActiveFlag;  // flag indicates whether CB reader is active
108     Int8 emptyFlag;         // flag indicates whether reader should empty (drain) remaining frames in CB
109     Int8 errUndCnt;         // underflow count
110     Int8 errOvrCnt;         // overflow count
111     PAF_AudioData *pcmBufEnd;  // PCM buffer, contains PCM data associated with audio frames end
112     UInt8 *metaBufEnd;         // metadata buffer, contains metadata associated with audio frames end
113     Int8 maxAFChanNum;      // maximum number of audio data channels in audio frame
114     Int16 maxAFSampCount;   // maximum number of sample counts in audio frame
115     PAF_AudioFrame lastAf;  // used to store the last valid read out audio frame info to generate mute frame
116 } PAF_AST_DecOpCircBuf;
118 // Decoder output circular buffer control
119 typedef struct PAF_AST_DecOpCircBufCtl
121     GateMP_Handle gateHandle;           // circular buffer gate handle
122     PAF_AST_DecOpCircBuf **pXDecOpCb;   // address of decoder output circular buffer base pointer
123 } PAF_AST_DecOpCircBufCtl;
125 // Initialize circular buffer control
126 Int cbCtlInit(
127     PAF_AST_DecOpCircBufCtl *pCbCtl,    // decoder output circular buffer control
128     PAF_AST_DecOpCircBuf **pXDecOpCb    // address of decoder output circular buffer base pointer
129 );
131 // Reset circular buffer
132 Int cbReset(
133     PAF_AST_DecOpCircBufCtl *pCbCtl,
134     Int8 cbIdx
135 );
137 // Output log of circular buffer control variables (debug)
138 Int cbLog(
139     PAF_AST_DecOpCircBufCtl *pCbCtl,
140     Int8 cbIdx, 
141     Int8 fullLog, 
142     char *locInfo
143 );
145 #endif /* _ASP_DECOP_CB_COMMON_H_ */