1b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/* ------------------------------------------------------------------ 2b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * Copyright (C) 1998-2009 PacketVideo 3b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * 4b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * Licensed under the Apache License, Version 2.0 (the "License"); 5b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * you may not use this file except in compliance with the License. 6b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * You may obtain a copy of the License at 7b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * 8b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * http://www.apache.org/licenses/LICENSE-2.0 9b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * 10b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * Unless required by applicable law or agreed to in writing, software 11b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * distributed under the License is distributed on an "AS IS" BASIS, 12b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either 13b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * express or implied. 14b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * See the License for the specific language governing permissions 15b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * and limitations under the License. 16b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * ------------------------------------------------------------------- 17b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber */ 18b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/**************************************************************************************** 19b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas HuberPortions of this file are derived from the following 3GPP standard: 20b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 21b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 3GPP TS 26.073 22b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ANSI-C code for the Adaptive Multi-Rate (AMR) speech codec 23b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Available from http://www.3gpp.org 24b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 25b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber(C) 2004, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TTA, TTC) 26b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas HuberPermission to distribute, modify and use this file under the standard license 27b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huberterms listed above has been obtained from the copyright holder. 28b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber****************************************************************************************/ 29b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/* 30b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 31b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 32b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 33b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 34b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pathname: ./audio/gsm-amr/c/src/sp_enc.c 35b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Funtions: GSMInitEncode 36b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Encode_Frame_reset 37b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber GSMEncodeFrameExit 38b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Encode_Frame_First 39b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber GSMEncodeFrame 40b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 41b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Date: 02/07/2002 42b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 43b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 44b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REVISION HISTORY 45b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 46b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: Cleaned up INCLUDES. removed inclusion of basic_op.h and count.h. 47b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 48b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 49b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: Revert back to Speech_Encode_Frame_reset() and 50b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Encode_Frame_First 51b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 52b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: Replaced OSCL mem type functions and eliminated include 53b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber files that now are chosen by OSCL definitions 54b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 55b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: Replaced "int" and/or "char" with OSCL defined types. 56b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 57b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: 58b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 59b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 60b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber MODULE DESCRIPTION 61b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 62b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber These functions comprise the pre filtering and encoding of one speech frame. 63b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 64b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 65b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber*/ 66b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 67b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 68b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/*---------------------------------------------------------------------------- 69b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; INCLUDES 70b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber----------------------------------------------------------------------------*/ 71b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#include <stdlib.h> 72b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 73b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#include "sp_enc.h" 74b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#include "typedef.h" 75b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#include "cnst.h" 76b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#include "set_zero.h" 77b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#include "pre_proc.h" 78b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#include "prm2bits.h" 79b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#include "mode.h" 80b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#include "cod_amr.h" 81b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 82b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/*---------------------------------------------------------------------------- 83b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; MACROS 84b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; Define module specific macros here 85b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber----------------------------------------------------------------------------*/ 86b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 87b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 88b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/*---------------------------------------------------------------------------- 89b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; DEFINES 90b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; Include all pre-processor statements here. Include conditional 91b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; compile variables also. 92b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber----------------------------------------------------------------------------*/ 93b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 94b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/*---------------------------------------------------------------------------- 95b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; LOCAL FUNCTION DEFINITIONS 96b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; Function Prototype declaration 97b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber----------------------------------------------------------------------------*/ 98b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 99b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/*---------------------------------------------------------------------------- 100b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; LOCAL VARIABLE DEFINITIONS 101b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; Variable declaration - defined here and used outside this module 102b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber----------------------------------------------------------------------------*/ 103b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 104b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/* 105b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 106b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION NAME: GSMInitEncode 107b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 108b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber INPUT AND OUTPUT DEFINITIONS 109b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Inputs: 110b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state = pointer to an array of pointers to structures of type 111b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Decode_FrameState 112b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber dtx = flag to turn off or turn on DTX (Flag) 113b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber id = pointer to an array whose contents are of type char 114b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 115b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Outputs: 116b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber pre_state field of the structure pointed to by the pointer pointed to 117b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber by state is set to NULL 118b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber cod_amr_state field of the structure pointed to by the pointer pointed to 119b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber by state is set to NULL 120b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber dtx field of the structure pointed to by the pointer pointed to by state 121b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber is set to the input dtx 122b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 123b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Returns: 124b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return_value = set to zero, if initialization was successful; -1, 125b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber otherwise (int) 126b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 127b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Global Variables Used: 128b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None 129b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 130b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Local Variables Needed: 131b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None 132b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 133b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 134b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION DESCRIPTION 135b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 136b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber This function allocates memory for filter structure and initializes state 137b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber memory 138b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 139b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 140b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REQUIREMENTS 141b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 142b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 143b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 144b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 145b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REFERENCES 146b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 147b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber sp_enc.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 148b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 149b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 150b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber PSEUDO-CODE 151b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Note: Original function name of Speech_Encode_Frame_init was changed to 152b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber GSMInitEncode in the Code section. 153b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 154b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huberint Speech_Encode_Frame_init (void **state_data, 155b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Flag dtx, 156b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber char *id) 157b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 158b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Encode_FrameState* s; 159b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 160b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if (state_data == NULL){ 161b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber fprintf(stderr, "Speech_Encode_Frame_init: invalid parameter\n"); 162b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return -1; 163b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 164b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber *state_data = NULL; 165b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 166b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber // allocate memory 167b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if ((s= (Speech_Encode_FrameState *) malloc(sizeof(Speech_Encode_FrameState))) == NULL){ 168b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber fprintf(stderr, "Speech_Encode_Frame_init: can not malloc state " 169b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber "structure\n"); 170b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return -1; 171b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 172b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 173b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber s->complexityCounter = getCounterId(id); 174b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 175b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber s->pre_state = NULL; 176b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber s->cod_amr_state = NULL; 177b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber s->dtx = dtx; 178b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 179b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if (Pre_Process_init(&s->pre_state) || 180b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber cod_amr_init(&s->cod_amr_state, s->dtx)) { 181b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber GSMEncodeFrameExit(&s); 182b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return -1; 183b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 184b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 185b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Encode_Frame_reset(s); 186b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber *state_data = (void *)s; 187b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 188b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return 0; 189b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 190b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 191b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 192b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 193b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber RESOURCES USED [optional] 194b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 195b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber When the code is written for a specific target processor the 196b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber the resources used should be documented below. 197b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 198b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber HEAP MEMORY USED: x bytes 199b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 200b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber STACK MEMORY USED: x bytes 201b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 202b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 203b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber used to represent cycle count for each subroutine 204b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber called) 205b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber where: (cycle count variable) = cycle count for [subroutine 206b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber name] 207b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 208b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 209b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CAUTION [optional] 210b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber [State any special notes, constraints or cautions for users of this function] 211b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 212b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 213b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber*/ 214b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 215b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas HuberWord16 GSMInitEncode(void **state_data, 216b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Flag dtx, 217b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word8 *id) 218b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 219b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Encode_FrameState* s; 220b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 221b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber OSCL_UNUSED_ARG(id); 222b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 223b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if (state_data == NULL) 224b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 225b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* fprintf(stderr, "Speech_Encode_Frame_init: invalid parameter\n"); */ 226b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return -1; 227b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 228b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber *state_data = NULL; 229b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 230b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* allocate memory */ 231b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if ((s = (Speech_Encode_FrameState *) malloc(sizeof(Speech_Encode_FrameState))) == NULL) 232b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 233b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* fprintf(stderr, "Speech_Encode_Frame_init: can not malloc state " 234b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber "structure\n"); */ 235b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return -1; 236b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 237b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 238b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber s->pre_state = NULL; 239b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber s->cod_amr_state = NULL; 240b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber s->dtx = dtx; 241b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 242b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if (Pre_Process_init(&s->pre_state) || 243b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber cod_amr_init(&s->cod_amr_state, s->dtx)) 244b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 245b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Encode_FrameState** temp = &s; 246b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber GSMEncodeFrameExit((void**)temp); 247b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return -1; 248b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 249b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 250b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Encode_Frame_reset(s); 251b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber *state_data = (void *)s; 252b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 253b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return 0; 254b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 255b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 256b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 257b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/* 258b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 259b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION NAME: Speech_Encode_Frame_reset 260b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 261b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber INPUT AND OUTPUT DEFINITIONS 262b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 263b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Inputs: 264b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state = pointer to structures of type Speech_Decode_FrameState 265b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 266b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Outputs: 267b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None 268b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 269b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Returns: 270b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return_value = set to zero if reset was successful; -1, otherwise (int) 271b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 272b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Global Variables Used: 273b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None 274b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 275b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Local Variables Needed: 276b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None 277b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 278b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 279b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION DESCRIPTION 280b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 281b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber This function resets state memory 282b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 283b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 284b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REQUIREMENTS 285b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 286b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 287b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 288b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 289b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REFERENCES 290b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 291b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber sp_enc.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 292b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 293b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 294b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber PSEUDO-CODE 295b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 296b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huberint Speech_Encode_Frame_reset (void *state_data) 297b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 298b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 299b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Encode_FrameState *state = 300b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber (Speech_Encode_FrameState *) state_data; 301b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 302b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if (state_data == NULL){ 303b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber fprintf(stderr, "Speech_Encode_Frame_reset 304b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber : invalid parameter\n"); 305b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return -1; 306b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 307b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 308b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_Process_reset(state->pre_state); 309b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber cod_amr_reset(state->cod_amr_state); 310b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 311b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber setCounter(state->complexityCounter); 312b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Init_WMOPS_counter(); 313b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber setCounter(0); // set counter to global counter 314b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 315b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return 0; 316b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 317b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 318b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 319b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber RESOURCES USED [optional] 320b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 321b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber When the code is written for a specific target processor the 322b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber the resources used should be documented below. 323b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 324b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber HEAP MEMORY USED: x bytes 325b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 326b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber STACK MEMORY USED: x bytes 327b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 328b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 329b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber used to represent cycle count for each subroutine 330b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber called) 331b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber where: (cycle count variable) = cycle count for [subroutine 332b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber name] 333b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 334b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 335b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CAUTION [optional] 336b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber [State any special notes, constraints or cautions for users of this function] 337b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 338b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 339b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber*/ 340b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 341b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas HuberWord16 Speech_Encode_Frame_reset(void *state_data) 342b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 343b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 344b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Encode_FrameState *state = 345b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber (Speech_Encode_FrameState *) state_data; 346b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 347b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if (state_data == NULL) 348b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 349b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* fprintf(stderr, "Speech_Encode_Frame_reset 350b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber : invalid parameter\n"); */ 351b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return -1; 352b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 353b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 354b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_Process_reset(state->pre_state); 355b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber cod_amr_reset(state->cod_amr_state); 356b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 357b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return 0; 358b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 359b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 360b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/****************************************************************************/ 361b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 362b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/* 363b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 364b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION NAME: GSMEncodeFrameExit 365b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 366b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber INPUT AND OUTPUT DEFINITIONS 367b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 368b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Inputs: 369b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state = pointer to a pointer to a structure of type cod_amrState 370b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 371b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Outputs: 372b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state points to a NULL address 373b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 374b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Returns: 375b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 376b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 377b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Global Variables Used: 378b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 379b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 380b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Local Variables Needed: 381b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 382b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 383b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 384b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION DESCRIPTION 385b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 386b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber This function frees the memory used for state memory. 387b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 388b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 389b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REQUIREMENTS 390b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 391b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 392b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 393b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 394b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REFERENCES 395b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 396b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber sp_enc.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 397b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 398b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 399b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber PSEUDO-CODE 400b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 401b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Note: Original function name of Speech_Encode_Frame_exit was changed to 402b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber GSMEncodeFrameExit in the Code section. 403b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 404b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Hubervoid Speech_Encode_Frame_exit (void **state_data) 405b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 406b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 407b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Encode_FrameState **state = 408b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber (Speech_Encode_FrameState **) state_data; 409b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 410b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if (state == NULL || *state == NULL) 411b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return; 412b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 413b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_Process_exit(&(*state)->pre_state); 414b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber cod_amr_exit(&(*state)->cod_amr_state); 415b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 416b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber setCounter((*state)->complexityCounter); 417b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber WMOPS_output(0); 418b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber setCounter(0); // set counter to global counter 419b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 420b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber // deallocate memory 421b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber free(*state); 422b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber *state = NULL; 423b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 424b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return; 425b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 426b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 427b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 428b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber RESOURCES USED [optional] 429b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 430b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber When the code is written for a specific target processor the 431b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber the resources used should be documented below. 432b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 433b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber HEAP MEMORY USED: x bytes 434b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 435b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber STACK MEMORY USED: x bytes 436b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 437b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 438b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber used to represent cycle count for each subroutine 439b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber called) 440b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber where: (cycle count variable) = cycle count for [subroutine 441b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber name] 442b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 443b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 444b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CAUTION [optional] 445b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber [State any special notes, constraints or cautions for users of this function] 446b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 447b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 448b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber*/ 449b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 450b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Hubervoid GSMEncodeFrameExit(void **state_data) 451b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 452b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 453b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Encode_FrameState **state = 454b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber (Speech_Encode_FrameState **) state_data; 455b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 456b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if (state == NULL || *state == NULL) 457b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return; 458b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 459b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_Process_exit(&(*state)->pre_state); 460b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber cod_amr_exit(&(*state)->cod_amr_state); 461b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 462b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* deallocate memory */ 463b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber free(*state); 464b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber *state = NULL; 465b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 466b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return; 467b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 468b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 469b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/****************************************************************************/ 470b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 471b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/* 472b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 473b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION NAME: Speech_Encode_Frame_First 474b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 475b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 476b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber INPUT AND OUTPUT DEFINITIONS 477b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 478b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Inputs: 479b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber st = pointer to a structure of type Speech_Encode_FrameState that contains 480b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber the post filter states 481b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber new_speech = pointer to buffer of length L_FRAME that contains 482b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber the speech input (Word16) 483b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 484b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Outputs: 485b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber The structure of type Speech_Encode_FrameState pointed to by st is updated. 486b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 487b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Returns: 488b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return_value = 0 (int) 489b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 490b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Global Variables Used: 491b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 492b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 493b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Local Variables Needed: 494b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 495b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 496b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 497b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION DESCRIPTION 498b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 499b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber This function encodes the first frame of speech. It calls the pre-processing 500b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber filter and the first frame encoder. 501b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 502b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 503b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REQUIREMENTS 504b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 505b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 506b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 507b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 508b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REFERENCES 509b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 510b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber sp_enc.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 511b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 512b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 513b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber PSEUDO-CODE 514b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 515b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huberint Speech_Encode_Frame_First ( 516b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Encode_FrameState *st, // i/o : post filter states 517b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 *new_speech) // i : speech input 518b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 519b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#if !defined(NO13BIT) 520b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 i; 521b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#endif 522b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 523b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber setCounter(st->complexityCounter); 524b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 525b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#if !defined(NO13BIT) 526b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber // Delete the 3 LSBs (13-bit input) 527b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber for (i = 0; i < L_NEXT; i++) 528b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 529b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber new_speech[i] = new_speech[i] & 0xfff8; 530b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 531b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#endif 532b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 533b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber // filter + downscaling 534b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_Process (st->pre_state, new_speech, L_NEXT); 535b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 536b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber cod_amr_first(st->cod_amr_state, new_speech); 537b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 538b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Init_WMOPS_counter (); // reset WMOPS counter for the new frame 539b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 540b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return 0; 541b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 542b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 543b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 544b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 545b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber RESOURCES USED [optional] 546b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 547b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber When the code is written for a specific target processor the 548b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber the resources used should be documented below. 549b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 550b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber HEAP MEMORY USED: x bytes 551b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 552b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber STACK MEMORY USED: x bytes 553b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 554b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 555b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber used to represent cycle count for each subroutine 556b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber called) 557b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber where: (cycle count variable) = cycle count for [subroutine 558b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber name] 559b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 560b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 561b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CAUTION [optional] 562b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber [State any special notes, constraints or cautions for users of this function] 563b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 564b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 565b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber*/ 566b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 567b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Hubervoid Speech_Encode_Frame_First( 568b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Encode_FrameState *st, /* i/o : post filter states */ 569b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 *new_speech) /* i : speech input */ 570b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 571b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#if !defined(NO13BIT) 572b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 i; 573b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#endif 574b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 575b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#if !defined(NO13BIT) 576b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* Delete the 3 LSBs (13-bit input) */ 577b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber for (i = 0; i < L_NEXT; i++) 578b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 579b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber new_speech[i] = new_speech[i] & 0xfff8; 580b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 581b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#endif 582b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 583b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* filter + downscaling */ 584b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_Process(st->pre_state, new_speech, L_NEXT); 585b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 586b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber cod_amr_first(st->cod_amr_state, new_speech); 587b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 588b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return; 589b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 590b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 591b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/* 592b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 593b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION NAME: cod_amr 594b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 595b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber INPUT AND OUTPUT DEFINITIONS 596b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 597b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Inputs: 598b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state_data = a void pointer to the post filter states 599b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber mode = AMR mode of type enum Mode 600b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber new_speech = pointer to buffer of length L_FRAME that contains 601b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber the speech input of type Word16 602b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber serial = pointer to the serial bit stream of type Word16 603b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber usedMode = pointer to the used mode of type enum Mode 604b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 605b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Outputs: 606b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber serial -> encoded serial bit stream 607b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber The value pointed to by usedMode is updated. 608b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 609b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Returns: 610b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return_value = 0 (int) 611b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 612b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Global Variables Used: 613b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 614b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 615b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Local Variables Needed: 616b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 617b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 618b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 619b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION DESCRIPTION 620b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 621b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber This function is the entry point to the GSM AMR encoder. The following 622b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber operations are performed to generate one encoded frame: First, the incoming 623b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber audio samples are passed through the pre-processing filter where they are 624b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber filtered and downscaled. A call is then made to the main encoder cod_amr(). 625b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber This generates the set of encoded parameters which include the LSP, adaptive 626b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber codebook, and fixed codebook quantization indices (addresses and gains). The 627b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber generated parameters are then converted to serial bits. 628b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 629b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 630b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REQUIREMENTS 631b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 632b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 633b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 634b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 635b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REFERENCES 636b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 637b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber sp_enc.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 638b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 639b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 640b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber PSEUDO-CODE 641b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Note: Original function name of Speech_Encode_Frame was changed to 642b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber GSMEncodeFrame in the Code section. 643b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 644b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huberint Speech_Encode_Frame ( 645b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber void *state_data, // i/o : post filter states 646b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber enum Mode mode, // i : speech coder mode 647b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 *new_speech, // i : speech input 648b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 *serial, // o : serial bit stream 649b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber enum Mode *usedMode // o : used speech coder mode 650b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ) 651b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 652b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 653b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Encode_FrameState *st = 654b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber (Speech_Encode_FrameState *) state_data; 655b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 656b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 prm[MAX_PRM_SIZE]; // Analysis parameters 657b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 syn[L_FRAME]; // Buffer for synthesis speech 658b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 i; 659b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 660b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber setCounter(st->complexityCounter); 661b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Reset_WMOPS_counter (); // reset WMOPS counter for the new frame 662b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber // initialize the serial output frame to zero 663b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber for (i = 0; i < MAX_SERIAL_SIZE; i++) 664b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 665b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber serial[i] = 0; 666b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 667b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#if !defined(NO13BIT) 668b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber // Delete the 3 LSBs (13-bit input) 669b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber for (i = 0; i < L_FRAME; i++) 670b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 671b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber new_speech[i] = new_speech[i] & 0xfff8; 672b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 673b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 674b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 675b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#endif 676b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 677b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber // filter + downscaling 678b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_Process (st->pre_state, new_speech, L_FRAME); 679b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 680b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber // Call the speech encoder 681b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber cod_amr(st->cod_amr_state, mode, new_speech, prm, usedMode, syn); 682b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 683b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber // Parameters to serial bits 684b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Prm2bits (*usedMode, prm, &serial[0]); 685b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 686b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber fwc(); 687b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber setCounter(0); // set counter to global counter 688b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 689b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return 0; 690b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 691b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 692b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 693b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber RESOURCES USED [optional] 694b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 695b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber When the code is written for a specific target processor the 696b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber the resources used should be documented below. 697b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 698b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber HEAP MEMORY USED: x bytes 699b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 700b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber STACK MEMORY USED: x bytes 701b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 702b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 703b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber used to represent cycle count for each subroutine 704b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber called) 705b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber where: (cycle count variable) = cycle count for [subroutine 706b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber name] 707b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 708b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 709b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CAUTION [optional] 710b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber [State any special notes, constraints or cautions for users of this function] 711b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 712b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 713b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber*/ 714b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 715b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Hubervoid GSMEncodeFrame( 716b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber void *state_data, /* i/o : post filter states */ 717b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber enum Mode mode, /* i : speech coder mode */ 718b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 *new_speech, /* i : speech input */ 719b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 *serial, /* o : serial bit stream */ 720b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber enum Mode *usedMode /* o : used speech coder mode */ 721b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber) 722b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 723b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 724b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Speech_Encode_FrameState *st = 725b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber (Speech_Encode_FrameState *) state_data; 726b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 727b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 prm[MAX_PRM_SIZE]; /* Analysis parameters. */ 728b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 syn[L_FRAME]; /* Buffer for synthesis speech */ 729b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 i; 730b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 731b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* initialize the serial output frame to zero */ 732b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber for (i = 0; i < MAX_SERIAL_SIZE; i++) 733b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 734b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber serial[i] = 0; 735b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 736b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#if !defined(NO13BIT) 737b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* Delete the 3 LSBs (13-bit input) */ 738b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber for (i = 0; i < L_FRAME; i++) 739b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 740b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber new_speech[i] = new_speech[i] & 0xfff8; 741b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 742b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#endif 743b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 744b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* filter + downscaling */ 745b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_Process(st->pre_state, new_speech, L_FRAME); 746b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 747b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* Call the speech encoder */ 748b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber cod_amr(st->cod_amr_state, mode, new_speech, prm, usedMode, syn); 749b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 750b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* Parameters to serial bits */ 751b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Prm2bits(*usedMode, prm, &serial[0]); 752b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 753b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return; 754b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 755