1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
|
/*
* Copyright (C) 2011 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
*************************************************************************
* @file M4AD_Null.c
* @brief Implementation of the MP3 decoder public interface
* @note This file implements a "null" audio decoder, that is a decoder
* that do nothing except getting AU from the reader
*************************************************************************
*/
#include "M4OSA_Debug.h"
#include "M4OSA_Error.h"
#include "M4OSA_Debug.h"
#include "M4TOOL_VersionInfo.h"
#include "M4AD_Common.h"
#include "M4AD_Null.h"
#define M4AD_FORCE_16BITS
/**
************************************************************************
* NULL Audio Decoder version information
************************************************************************
*/
/* CHANGE_VERSION_HERE */
#define M4AD_NULL_MAJOR 1
#define M4AD_NULL_MINOR 1
#define M4AD_NULL_REVISION 4
/**
************************************************************************
* structure M4AD_NullContext
* @brief Internal null decoder context
************************************************************************
*/
typedef struct
{
/**< Pointer to the stream handler provided by the user */
M4_AudioStreamHandler* m_pAudioStreamhandler;
} M4AD_NullContext;
/**
************************************************************************
* NXP MP3 decoder functions definition
************************************************************************
*/
/**
************************************************************************
* @brief Creates an instance of the null decoder
* @note Allocates the context
*
* @param pContext: (OUT) Context of the decoder
* @param pStreamHandler: (IN) Pointer to an audio stream description
* @param pUserData: (IN) Pointer to User data
*
* @return M4NO_ERROR there is no error
* @return M4ERR_STATE State automaton is not applied
* @return M4ERR_ALLOC a memory allocation has failed
* @return M4ERR_PARAMETER at least one parameter is not properly set (in DEBUG only)
************************************************************************
*/
M4OSA_ERR M4AD_NULL_create( M4AD_Context* pContext,
M4_AudioStreamHandler *pStreamHandler,
void* pUserData)
{
M4AD_NullContext* pC;
M4OSA_DEBUG_IF1((pContext == 0), M4ERR_PARAMETER,
"M4AD_NULL_create: invalid context pointer");
M4OSA_DEBUG_IF1((pStreamHandler == 0), M4ERR_PARAMETER,
"M4AD_NULL_create: invalid pointer pStreamHandler");
pC = (M4AD_NullContext*)M4OSA_32bitAlignedMalloc(sizeof(M4AD_NullContext),
M4DECODER_AUDIO, (M4OSA_Char *)"M4AD_NullContext");
if (pC == (M4AD_NullContext*)0)
{
M4OSA_TRACE1_0("Can not allocate null decoder context");
return M4ERR_ALLOC;
}
*pContext = pC;
pC->m_pAudioStreamhandler = pStreamHandler;
return M4NO_ERROR;
}
/**
************************************************************************
* @brief Destroys the instance of the null decoder
* @note After this call the context is invalid
*
* @param context: (IN) Context of the decoder
*
* @return M4NO_ERROR There is no error
* @return M4ERR_PARAMETER The context is invalid (in DEBUG only)
************************************************************************
*/
M4OSA_ERR M4AD_NULL_destroy(M4AD_Context context)
{
M4AD_NullContext* pC = (M4AD_NullContext*)context;
M4OSA_DEBUG_IF1((context == M4OSA_NULL), M4ERR_PARAMETER, "M4AD_NULL_destroy: invalid context");
free(pC);
return M4NO_ERROR;
}
/**
************************************************************************
* @brief Simply output the given audio data
* @note
*
* @param context: (IN) Context of the decoder
* @param pInputBuffer: (IN/OUT)Input Data buffer. It contains at least one audio frame.
* The size of the buffer must be updated inside the function
* to reflect the size of the actually decoded data.
* (e.g. the first frame in pInputBuffer)
* @param pDecodedPCMBuffer: (OUT) Output PCM buffer (decoded data).
* @param jumping: (IN) M4OSA_TRUE if a jump was just done, M4OSA_FALSE otherwise.
* @return M4NO_ERROR there is no error
* @return M4ERR_PARAMETER at least one parameter is not properly set
************************************************************************
*/
M4OSA_ERR M4AD_NULL_step(M4AD_Context context, M4AD_Buffer *pInputBuffer,
M4AD_Buffer *pDecodedPCMBuffer, M4OSA_Bool jumping)
{
M4AD_NullContext* pC = (M4AD_NullContext*)context;
/*The VPS sends a zero buffer at the end*/
if (0 == pInputBuffer->m_bufferSize)
{
return M4WAR_NO_MORE_AU;
}
if (pInputBuffer->m_bufferSize > pDecodedPCMBuffer->m_bufferSize)
{
return M4ERR_PARAMETER;
}
#ifdef M4AD_FORCE_16BITS
/*if read samples are 8 bits, complete them to 16 bits*/
if (pC->m_pAudioStreamhandler->m_byteSampleSize == 1)
{
M4OSA_UInt32 i;
M4OSA_Int16 val;
for (i = 0; i < pInputBuffer->m_bufferSize; i++)
{
val = (M4OSA_Int16)((M4OSA_UInt8)(pInputBuffer->m_dataAddress[i]) - 128);
pDecodedPCMBuffer->m_dataAddress[i*2] = (M4OSA_Int8)(val>>8);
pDecodedPCMBuffer->m_dataAddress[i*2+1] = (M4OSA_Int8)(val&0x00ff);
}
}
else
{
memcpy((void *)pDecodedPCMBuffer->m_dataAddress, (void *)pInputBuffer->m_dataAddress,
pInputBuffer->m_bufferSize );
}
#else /*M4AD_FORCE_16BITS*/
memcpy((void *)pDecodedPCMBuffer->m_dataAddress, (void *)pInputBuffer->m_dataAddress,
pInputBuffer->m_bufferSize );
#endif /*M4AD_FORCE_16BITS*/
return M4NO_ERROR;
}
/**
************************************************************************
* @brief Gets the decoder version
* @note The version is given in a M4_VersionInfo structure
*
* @param pValue: (OUT) Pointer to the version structure
*
* @return M4NO_ERROR there is no error
* @return M4ERR_PARAMETER pVersionInfo pointer is null (in DEBUG only)
************************************************************************
*/
M4OSA_ERR M4AD_NULL_getVersion(M4_VersionInfo* pVersionInfo)
{
M4OSA_ERR err = M4NO_ERROR;
M4OSA_DEBUG_IF1((pVersionInfo == 0), M4ERR_PARAMETER,
"M4AD_NULL_getVersion: invalid pointer pVersionInfo");
/* Up until now, the null decoder version is not available */
/* CHANGE_VERSION_HERE */
pVersionInfo->m_major = M4AD_NULL_MAJOR; /*major version of the component*/
pVersionInfo->m_minor = M4AD_NULL_MINOR; /*minor version of the component*/
pVersionInfo->m_revision = M4AD_NULL_REVISION; /*revision version of the component*/
pVersionInfo->m_structSize=sizeof(M4_VersionInfo);
return err;
}
/**
************************************************************************
* getInterface function definitions of NXP MP3 decoder
************************************************************************
*/
/**
************************************************************************
* @brief Retrieves the interface implemented by the decoder
* @param pDecoderType : pointer on an M4AD_Type (allocated by the caller)
* that will be filled with the decoder type supported by
* this decoder
* @param pDecoderInterface : address of a pointer that will be set to the interface
* implemented by this decoder. The interface is a structure
* allocated by the function and must be un-allocated by the
* caller.
*
* @return M4NO_ERROR if OK
* @return M4ERR_ALLOC if allocation failed
************************************************************************
*/
M4OSA_ERR M4AD_NULL_getInterface( M4AD_Type *pDecoderType, M4AD_Interface **pDecoderInterface)
{
*pDecoderInterface = ( M4AD_Interface*)M4OSA_32bitAlignedMalloc( sizeof(M4AD_Interface),
M4DECODER_AUDIO, (M4OSA_Char *)"M4AD_Interface" );
if (M4OSA_NULL == *pDecoderInterface)
{
return M4ERR_ALLOC;
}
*pDecoderType = M4AD_kTypePCM;
(*pDecoderInterface)->m_pFctCreateAudioDec = M4AD_NULL_create;
(*pDecoderInterface)->m_pFctDestroyAudioDec = M4AD_NULL_destroy;
(*pDecoderInterface)->m_pFctStepAudioDec = M4AD_NULL_step;
(*pDecoderInterface)->m_pFctGetVersionAudioDec = M4AD_NULL_getVersion;
(*pDecoderInterface)->m_pFctStartAudioDec = M4OSA_NULL;
(*pDecoderInterface)->m_pFctResetAudioDec = M4OSA_NULL;
(*pDecoderInterface)->m_pFctSetOptionAudioDec = M4OSA_NULL;
(*pDecoderInterface)->m_pFctGetOptionAudioDec = M4OSA_NULL;
return M4NO_ERROR;
}
|
