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/pre_proc.c 35b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Funtions: Pre_Process_init 36b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_Process_reset 37b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_Process_exit 38b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_Process 39b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 40b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Date: 05/17/2000 41b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 42b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 43b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REVISION HISTORY 44b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 45b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: Put the file into our template structure. 46b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 47b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: First pass optimization. 48b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 49b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: Made changes based on comments from review meeting. 50b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 51b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: Synchronized file with UMTS version 3.2.0. Updated coding 52b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber template. Removed unnecessary include files. 53b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 54b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: Removed basic_op.h from the Include section. It is not used. 55b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 56b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: Made the following changes per comments from Phase 2/3 review: 57b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 1. Fixed typecasting issue with TI C compiler. 58b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 2. Modified FOR loop to count down. 59b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 3. Cosmetic changes to the code to make address post-increment 60b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber clearer. 61b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 4. Removed unnecessary typecasting in the multiply-accumulate 62b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber portion of FOR loop body. 63b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 5. Removed "static" in table definitions. 64b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 6. Updated copyright year. 65b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 66b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: For Pre_Process() 67b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 1. Replaced variables (containing filter coefficients) with 68b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber constants, to avoid extra register swaping. 69b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 2. Changed to decrement loop 70b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 71b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: Replaced OSCL mem type functions and eliminated include 72b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber files that now are chosen by OSCL definitions 73b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 74b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: Replaced "int" and/or "char" with OSCL defined types. 75b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 76b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: Changed round function name to pv_round to avoid conflict with 77b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber round function in C standard library. 78b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 79b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: 80b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 81b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 82b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber MODULE DESCRIPTION 83b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 84b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber These modules handle the preprocessing of input speech. 85b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 86b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 87b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber*/ 88b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 89b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 90b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/*---------------------------------------------------------------------------- 91b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; INCLUDES 92b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber----------------------------------------------------------------------------*/ 93b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#include <stdlib.h> 94b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 95b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#include "pre_proc.h" 96b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#include "typedef.h" 97b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 98b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/*---------------------------------------------------------------------------- 99b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; MACROS 100b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; Define module specific macros here 101b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber----------------------------------------------------------------------------*/ 102b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 103b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 104b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/*---------------------------------------------------------------------------- 105b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; DEFINES 106b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; Include all pre-processor statements here. Include conditional 107b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; compile variables also. 108b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber----------------------------------------------------------------------------*/ 109b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 110b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 111b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/*---------------------------------------------------------------------------- 112b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; LOCAL FUNCTION DEFINITIONS 113b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; Function Prototype declaration 114b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber----------------------------------------------------------------------------*/ 115b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 116b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/*---------------------------------------------------------------------------- 117b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; LOCAL VARIABLE DEFINITIONS 118b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; Variable declaration - defined here and used outside this module 119b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber----------------------------------------------------------------------------*/ 120b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 121b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 122b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 123b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 124b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/* 125b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 126b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION NAME: Pre_Process_init 127b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 128b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber INPUT AND OUTPUT DEFINITIONS 129b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 130b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Inputs: 131b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state = pointer to an array of pointer to structures of type 132b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_ProcessState 133b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 134b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Outputs: 135b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Structure pointed to by the pointer pointed to by state is 136b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber initialized to its reset value 137b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state points to the allocated memory 138b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 139b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Returns: 140b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return_value = 0 if memory was successfully initialized, 141b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber otherwise returns -1. 142b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 143b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Global Variables Used: 144b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 145b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 146b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Local Variables Needed: 147b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 148b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 149b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 150b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION DESCRIPTION 151b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 152b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Allocates state memory and initializes state memory. 153b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 154b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 155b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REQUIREMENTS 156b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 157b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 158b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 159b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 160b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REFERENCES 161b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 162b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber pre_proc.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 163b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 164b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 165b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber PSEUDO-CODE 166b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 167b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huberint Pre_Process_init (Pre_ProcessState **state) 168b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 169b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_ProcessState* s; 170b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 171b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if (state == (Pre_ProcessState **) NULL){ 172b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber fprintf(stderr, "Pre_Process_init: invalid parameter\n"); 173b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return -1; 174b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 175b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber *state = NULL; 176b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 177b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber // allocate memory 178b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if ((s= (Pre_ProcessState *) malloc(sizeof(Pre_ProcessState))) == NULL){ 179b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber fprintf(stderr, "Pre_Process_init: can not malloc state structure\n"); 180b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return -1; 181b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 182b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 183b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_Process_reset(s); 184b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber *state = s; 185b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 186b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return 0; 187b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 188b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 189b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 190b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber RESOURCES USED [optional] 191b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 192b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber When the code is written for a specific target processor the 193b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber the resources used should be documented below. 194b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 195b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber HEAP MEMORY USED: x bytes 196b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 197b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber STACK MEMORY USED: x bytes 198b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 199b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 200b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber used to represent cycle count for each subroutine 201b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber called) 202b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber where: (cycle count variable) = cycle count for [subroutine 203b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber name] 204b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 205b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 206b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CAUTION [optional] 207b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber [State any special notes, constraints or cautions for users of this function] 208b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 209b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 210b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber*/ 211b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 212b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas HuberWord16 Pre_Process_init(Pre_ProcessState **state) 213b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 214b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_ProcessState* s; 215b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 216b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if (state == (Pre_ProcessState **) NULL) 217b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 218b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* fprintf(stderr, "Pre_Process_init: invalid parameter\n"); */ 219b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return(-1); 220b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 221b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber *state = NULL; 222b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 223b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* allocate memory */ 224b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if ((s = (Pre_ProcessState *) malloc(sizeof(Pre_ProcessState))) == NULL) 225b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 226b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* fprintf(stderr, "Pre_Process_init: 227b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber can not malloc state structure\n"); */ 228b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return(-1); 229b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 230b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 231b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_Process_reset(s); 232b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber *state = s; 233b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 234b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return(0); 235b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 236b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 237b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/****************************************************************************/ 238b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 239b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 240b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/* 241b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 242b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION NAME: Pre_Process_reset 243b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 244b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber INPUT AND OUTPUT DEFINITIONS 245b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 246b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Inputs: 247b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state = pointer to structure of type Pre_ProcessState 248b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 249b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Outputs: 250b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Structure pointed to by state is initialized to zero. 251b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 252b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Returns: 253b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return_value = 0 if memory was successfully reset, 254b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber otherwise returns -1. 255b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 256b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Global Variables Used: 257b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 258b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 259b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Local Variables Needed: 260b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 261b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 262b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 263b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION DESCRIPTION 264b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 265b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Initializes state memory to zero. 266b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 267b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 268b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REQUIREMENTS 269b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 270b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 271b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 272b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 273b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REFERENCES 274b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 275b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber pre_proc.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 276b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 277b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 278b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber PSEUDO-CODE 279b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 280b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huberint Pre_Process_reset (Pre_ProcessState *state) 281b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 282b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if (state == (Pre_ProcessState *) NULL){ 283b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber fprintf(stderr, "Pre_Process_reset: invalid parameter\n"); 284b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return -1; 285b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 286b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 287b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state->y2_hi = 0; 288b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state->y2_lo = 0; 289b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state->y1_hi = 0; 290b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state->y1_lo = 0; 291b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state->x0 = 0; 292b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state->x1 = 0; 293b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 294b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return 0; 295b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 296b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 297b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 298b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber RESOURCES USED [optional] 299b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 300b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber When the code is written for a specific target processor the 301b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber the resources used should be documented below. 302b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 303b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber HEAP MEMORY USED: x bytes 304b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 305b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber STACK MEMORY USED: x bytes 306b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 307b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 308b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber used to represent cycle count for each subroutine 309b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber called) 310b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber where: (cycle count variable) = cycle count for [subroutine 311b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber name] 312b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 313b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 314b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CAUTION [optional] 315b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber [State any special notes, constraints or cautions for users of this function] 316b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 317b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 318b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber*/ 319b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 320b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas HuberWord16 Pre_Process_reset(Pre_ProcessState *state) 321b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 322b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if (state == (Pre_ProcessState *) NULL) 323b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 324b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* fprintf(stderr, "Pre_Process_reset: invalid parameter\n"); */ 325b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return(-1); 326b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 327b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 328b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state->y2_hi = 0; 329b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state->y2_lo = 0; 330b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state->y1_hi = 0; 331b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state->y1_lo = 0; 332b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state->x0 = 0; 333b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state->x1 = 0; 334b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 335b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return(0); 336b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 337b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 338b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/****************************************************************************/ 339b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 340b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 341b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/* 342b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 343b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION NAME: Pre_Process_exit 344b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 345b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber INPUT AND OUTPUT DEFINITIONS 346b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 347b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Inputs: 348b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state = a pointer to an array of pointers to structures of 349b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber type Pre_ProcessState 350b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 351b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Outputs: 352b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber state points to a NULL address 353b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 354b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Returns: 355b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 356b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 357b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Global Variables Used: 358b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 359b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 360b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Local Variables Needed: 361b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 362b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 363b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 364b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION DESCRIPTION 365b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 366b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber The memory used for state memory is freed. 367b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 368b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 369b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REQUIREMENTS 370b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 371b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 372b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 373b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 374b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REFERENCES 375b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 376b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber pre_proc.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 377b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 378b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 379b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber PSEUDO-CODE 380b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 381b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Hubervoid Pre_Process_exit (Pre_ProcessState **state) 382b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 383b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if (state == NULL || *state == NULL) 384b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return; 385b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 386b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber // deallocate memory 387b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber free(*state); 388b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber *state = NULL; 389b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 390b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return; 391b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 392b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 393b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 394b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber RESOURCES USED [optional] 395b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 396b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber When the code is written for a specific target processor the 397b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber the resources used should be documented below. 398b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 399b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber HEAP MEMORY USED: x bytes 400b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 401b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber STACK MEMORY USED: x bytes 402b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 403b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 404b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber used to represent cycle count for each subroutine 405b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber called) 406b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber where: (cycle count variable) = cycle count for [subroutine 407b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber name] 408b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 409b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 410b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CAUTION [optional] 411b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber [State any special notes, constraints or cautions for users of this function] 412b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 413b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 414b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber*/ 415b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 416b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Hubervoid Pre_Process_exit(Pre_ProcessState **state) 417b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 418b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber if (state == NULL || *state == NULL) 419b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 420b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return; 421b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 422b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 423b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* deallocate memory */ 424b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber free(*state); 425b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber *state = NULL; 426b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 427b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return; 428b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 429b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 430b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/****************************************************************************/ 431b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 432b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/* 433b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 434b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION NAME: Pre_Process 435b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 436b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber INPUT AND OUTPUT DEFINITIONS 437b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 438b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Inputs: 439b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber st = a pointer to a structure of type Pre_ProcessState 440b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber signal = input/output signal (Word16) 441b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber lg = length of signal (Word16) 442b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 443b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Outputs: 444b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber st points to the updated structure 445b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 446b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Returns: 447b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return_value = 0 (int) 448b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 449b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Global Variables Used: 450b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber a = points to a buffer of filter coefficients 451b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber b = points to a buffer of filter coefficients 452b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 453b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Local Variables Needed: 454b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 455b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 456b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 457b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber FUNCTION DESCRIPTION 458b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 459b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber This module performs the preprocessing of the input speech. 460b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber The signal is passed through a 2nd order high pass filtering with cut off 461b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber frequency at 80 Hz. The input is divided by two in the filtering process. 462b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 463b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber y[i] = b[0]*x[i]/2 + b[1]*x[i-1]/2 + b[2]*x[i-2]/2 464b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber + a[1]*y[i-1] + a[2]*y[i-2]; 465b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 466b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 467b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REQUIREMENTS 468b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 469b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber None. 470b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 471b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 472b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REFERENCES 473b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 474b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber pre_proc.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 475b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 476b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 477b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber PSEUDO-CODE 478b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 479b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huberint Pre_Process ( 480b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_ProcessState *st, 481b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 signal[], // input/output signal 482b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 lg) // lenght of signal 483b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 484b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 i, x2; 485b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word32 L_tmp; 486b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 487b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber for (i = 0; i < lg; i++) 488b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 489b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber x2 = st->x1; 490b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber st->x1 = st->x0; 491b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber st->x0 = signal[i]; 492b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 493b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber // y[i] = b[0]*x[i]/2 + b[1]*x[i-1]/2 + b140[2]*x[i-2]/2 494b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber // + a[1]*y[i-1] + a[2] * y[i-2]; 495b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 496b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber L_tmp = Mpy_32_16 (st->y1_hi, st->y1_lo, a[1]); 497b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber L_tmp = L_add (L_tmp, Mpy_32_16 (st->y2_hi, st->y2_lo, a[2])); 498b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber L_tmp = L_mac (L_tmp, st->x0, b[0]); 499b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber L_tmp = L_mac (L_tmp, st->x1, b[1]); 500b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber L_tmp = L_mac (L_tmp, x2, b[2]); 501b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber L_tmp = L_shl (L_tmp, 3); 502b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber signal[i] = pv_round (L_tmp); 503b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 504b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber st->y2_hi = st->y1_hi; 505b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber st->y2_lo = st->y1_lo; 506b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber L_Extract (L_tmp, &st->y1_hi, &st->y1_lo); 507b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 508b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return 0; 509b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 510b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 511b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 512b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber RESOURCES USED [optional] 513b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 514b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber When the code is written for a specific target processor the 515b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber the resources used should be documented below. 516b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 517b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber HEAP MEMORY USED: x bytes 518b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 519b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber STACK MEMORY USED: x bytes 520b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 521b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 522b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber used to represent cycle count for each subroutine 523b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber called) 524b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber where: (cycle count variable) = cycle count for [subroutine 525b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber name] 526b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 527b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 528b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber CAUTION [optional] 529b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber [State any special notes, constraints or cautions for users of this function] 530b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 531b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 532b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber*/ 533b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/* 534b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber filter coefficients (fc = 80 Hz, coeff. b[] is divided by 2) 535b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber const Word16 b[3] = {1899, -3798, 1899}; 536b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber const Word16 a[3] = {4096, 7807, -3733}; 537b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 538b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber*/ 539b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 540b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Hubervoid Pre_Process( 541b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Pre_ProcessState *st, 542b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 signal[], /* input/output signal */ 543b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 lg) /* length of signal */ 544b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 545b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber register Word16 i; 546b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 x_n_2; 547b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 x_n_1; 548b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word32 L_tmp; 549b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 *p_signal = signal; 550b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 551b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber x_n_2 = st->x1; 552b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber x_n_1 = st->x0; 553b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 554b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber for (i = lg; i != 0; i--) 555b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 556b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 557b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 558b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* y[i] = b[0]*x[i]/2 + b[1]*x[i-1]/2 + b140[2]*x[i-2]/2 */ 559b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* + a[1]*y[i-1] + a[2] * y[i-2]; */ 560b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 561b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber L_tmp = ((Word32) st->y1_hi) * 7807; 562b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber L_tmp += (Word32)(((Word32) st->y1_lo * 7807) >> 15); 563b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 564b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber L_tmp += ((Word32) st->y2_hi) * (-3733); 565b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber st->y2_hi = st->y1_hi; 566b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber L_tmp += (Word32)(((Word32) st->y2_lo * (-3733)) >> 15); 567b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber st->y2_lo = st->y1_lo; 568b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 569b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber L_tmp += ((Word32) x_n_2) * 1899; 570b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber x_n_2 = x_n_1; 571b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber L_tmp += ((Word32) x_n_1) * (-3798); 572b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber x_n_1 = *(p_signal); 573b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber L_tmp += ((Word32) x_n_1) * 1899; 574b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 575b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 576b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber *(p_signal++) = (Word16)((L_tmp + 0x0000800L) >> 12); 577b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 578b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber st->y1_hi = (Word16)(L_tmp >> 12); 579b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber st->y1_lo = (Word16)((L_tmp << 3) - ((Word32)(st->y1_hi) << 15)); 580b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 581b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } 582b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 583b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber st->x1 = x_n_2; 584b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber st->x0 = x_n_1; 585b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 586b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber return; 587b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 588b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 589b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 590