14f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* ------------------------------------------------------------------ 24f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * Copyright (C) 1998-2009 PacketVideo 34f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * 44f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * Licensed under the Apache License, Version 2.0 (the "License"); 54f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * you may not use this file except in compliance with the License. 64f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * You may obtain a copy of the License at 74f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * 84f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * http://www.apache.org/licenses/LICENSE-2.0 94f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * 104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * Unless required by applicable law or agreed to in writing, software 114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * distributed under the License is distributed on an "AS IS" BASIS, 124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either 134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * express or implied. 144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * See the License for the specific language governing permissions 154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * and limitations under the License. 164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * ------------------------------------------------------------------- 174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber */ 184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/**************************************************************************************** 194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas HuberPortions of this file are derived from the following 3GPP standard: 204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3GPP TS 26.073 224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ANSI-C code for the Adaptive Multi-Rate (AMR) speech codec 234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Available from http://www.3gpp.org 244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber(C) 2004, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TTA, TTC) 264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas HuberPermission to distribute, modify and use this file under the standard license 274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huberterms listed above has been obtained from the copyright holder. 284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber****************************************************************************************/ 294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* 304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Pathname: ./audio/gsm-amr/c/src/ec_gain.c 364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Funtions: 374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Date: 01/28/2002 394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REVISION HISTORY 424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Description: Removed the functions ec_gain_code_init, ec_gain_pitch_init, 444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ech_gain_code_exit, and ec_gain_pitch_exit. 454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber The ec_gains related structures are no longer dynamically allocated. 474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Description: Updated include files and input/output sections. 494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Description: Replaced OSCL mem type functions and eliminated include 514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber files that now are chosen by OSCL definitions 524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Description: Replaced "int" and/or "char" with OSCL defined types. 544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Description: Added #ifdef __cplusplus around extern'ed table. 564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Description: 584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber MODULE DESCRIPTION 614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber These modules execute the code book gains for error concealment. This module 634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber contains the init, reset, exit, and "main" functions in this process. 644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber*/ 674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/*---------------------------------------------------------------------------- 704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber; INCLUDES 714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber----------------------------------------------------------------------------*/ 724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#include "ec_gains.h" 734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#include "typedef.h" 744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#include "cnst.h" 754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#include "gmed_n.h" 764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#include "gc_pred.h" 774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#include "basic_op.h" 784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/*--------------------------------------------------------------------------*/ 814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#ifdef __cplusplus 824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huberextern "C" 834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#endif 854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /*---------------------------------------------------------------------------- 874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; MACROS 884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; Define module specific macros here 894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ----------------------------------------------------------------------------*/ 904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /*---------------------------------------------------------------------------- 934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; DEFINES 944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; Include all pre-processor statements here. Include conditional 954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; compile variables also. 964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ----------------------------------------------------------------------------*/ 974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /*---------------------------------------------------------------------------- 1004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; LOCAL FUNCTION DEFINITIONS 1014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; Function Prototype declaration 1024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ----------------------------------------------------------------------------*/ 1034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /*---------------------------------------------------------------------------- 1064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; LOCAL VARIABLE DEFINITIONS 1074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; Variable declaration - defined here and used outside this module 1084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ----------------------------------------------------------------------------*/ 1094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber extern const Word16 qua_gain_pitch[]; 1114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber extern const Word16 qua_gain_code[]; 1124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /*--------------------------------------------------------------------------*/ 1154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#ifdef __cplusplus 1164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 1174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#endif 1184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* 1204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION NAME: ec_gain_code_reset 1224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber INPUT AND OUTPUT DEFINITIONS 1244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Inputs: 1264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state = pointer to a pointer to a structure containing code state data of 1274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber stucture type ec_gain_codeState 1284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Outputs: 1304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 1314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Returns: 1334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None 1344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Global Variables Used: 1364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 1374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Local Variables Needed: 1394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 1404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION DESCRIPTION 1434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber This function resets the state data for the ec_gain module. 1454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REQUIREMENTS 1484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None 1504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REFERENCES 1534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None 1554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber PSEUDO-CODE 1584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huberint ec_gain_code_reset (ec_gain_codeState *state) 1604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 1614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 i; 1624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (state == (ec_gain_codeState *) NULL){ 1644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // fprintf(stderr, "ec_gain_code_reset: invalid parameter\n"); 1654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return -1; 1664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 1674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber for ( i = 0; i < 5; i++) 1694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state->gbuf[i] = 1; 1704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state->past_gain_code = 0; 1714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state->prev_gc = 1; 1724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return 0; 1744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 1754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RESOURCES USED [optional] 1784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber When the code is written for a specific target processor the 1804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber the resources used should be documented below. 1814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber HEAP MEMORY USED: x bytes 1834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber STACK MEMORY USED: x bytes 1854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 1874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber used to represent cycle count for each subroutine 1884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber called) 1894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber where: (cycle count variable) = cycle count for [subroutine 1904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber name] 1914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CAUTION [optional] 1944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber [State any special notes, constraints or cautions for users of this function] 1954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber*/ 1984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas HuberWord16 ec_gain_code_reset(ec_gain_codeState *state) 2004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 2014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 i; 2024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (state == (ec_gain_codeState *) NULL) 2044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 2054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* fprintf(stderr, "ec_gain_code_reset: invalid parameter\n"); */ 2064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return -1; 2074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 2084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber for (i = 0; i < 5; i++) 2104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state->gbuf[i] = 1; 2114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state->past_gain_code = 0; 2124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state->prev_gc = 1; 2134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return 0; 2154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 2164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* 2184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 2194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION NAME: ec_gain_code 2204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 2214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber INPUT AND OUTPUT DEFINITIONS 2224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Inputs: 2244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st = pointer to a pointer to a structure containing code state data of 2254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber stucture type ec_gain_codeState 2264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pred_state = pointer to MA predictor state of type gc_predState 2274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state = state of the state machine of type Word16 2284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain_code = pointer to decoded innovation gain of type Word16 2294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = pointer to overflow indicator of type Flag 2304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Outputs: 2324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st = pointer to a pointer to a structure containing code state data of 2334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber stucture type ec_gain_codeState 2344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pred_state = pointer to MA predictor state of type gc_predState 2354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = 1 if there is an overflow else it is zero. 2364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Returns: 2384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 2394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Global Variables Used: 2414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 2424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Local Variables Needed: 2444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 2454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 2474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION DESCRIPTION 2484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas HuberThis function does error concealment using the codebook. Call this function 2504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huberonly in BFI (instead of normal gain decoding function). 2514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 2534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REQUIREMENTS 2544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 2564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 2584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REFERENCES 2594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ec_gain.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 2614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 2634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber PSEUDO-CODE 2644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber static const Word16 cdown[7] = 2664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 2674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 32767, 32112, 32112, 32112, 2684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 32112, 32112, 22937 2694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber }; 2704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 tmp; 2724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 qua_ener_MR122; 2734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 qua_ener; 2744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // calculate median of last five gain values 2764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber tmp = gmed_n (st->gbuf,5); 2774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // new gain = minimum(median, past_gain) * cdown[state] 2794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (sub (tmp, st->past_gain_code) > 0) 2804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 2814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber tmp = st->past_gain_code; 2824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 2834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber tmp = mult (tmp, cdown[state]); 2844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber *gain_code = tmp; 2854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // update table of past quantized energies with average of 2874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // current values 2884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gc_pred_average_limited(pred_state, &qua_ener_MR122, &qua_ener); 2904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gc_pred_update(pred_state, qua_ener_MR122, qua_ener); 2914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 2924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 2944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RESOURCES USED [optional] 2954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber When the code is written for a specific target processor the 2974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber the resources used should be documented below. 2984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber HEAP MEMORY USED: x bytes 3004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber STACK MEMORY USED: x bytes 3024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 3044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber used to represent cycle count for each subroutine 3054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber called) 3064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber where: (cycle count variable) = cycle count for [subroutine 3074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber name] 3084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 3104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CAUTION [optional] 3114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber [State any special notes, constraints or cautions for users of this function] 3124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 3144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber*/ 3154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Hubervoid ec_gain_code( 3164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ec_gain_codeState *st, /* i/o : State struct */ 3174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gc_predState *pred_state, /* i/o : MA predictor state */ 3184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 state, /* i : state of the state machine */ 3194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *gain_code, /* o : decoded innovation gain */ 3204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Flag *pOverflow 3214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber) 3224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 3234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber static const Word16 cdown[7] = 3244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 3254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 32767, 32112, 32112, 32112, 3264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 32112, 32112, 22937 3274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber }; 3284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 tmp; 3304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 qua_ener_MR122; 3314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 qua_ener; 3324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* calculate median of last five gain values */ 3344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber tmp = gmed_n(st->gbuf, 5); 3354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* new gain = minimum(median, past_gain) * cdown[state] */ 3374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (sub(tmp, st->past_gain_code, pOverflow) > 0) 3384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 3394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber tmp = st->past_gain_code; 3404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 3414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber tmp = mult(tmp, cdown[state], pOverflow); 3424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber *gain_code = tmp; 3434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* update table of past quantized energies with average of 3454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * current values 3464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber */ 3474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gc_pred_average_limited(pred_state, &qua_ener_MR122, &qua_ener, pOverflow); 3484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gc_pred_update(pred_state, qua_ener_MR122, qua_ener); 3494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 3504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/****************************************************************************/ 3524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* 3544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 3554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION NAME: ec_gain_code_update 3564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 3574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber INPUT AND OUTPUT DEFINITIONS 3584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Inputs: 3604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st = pointer to a pointer to a structure containing code state data of 3614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber stucture type ec_gain_codeState 3624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber bfi = a flag that indicates if the frame is bad of type Word16 3634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber prev_bf = a flag that indicates if the previous frame was bad of type Word16 3644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain_code = pointer to decoded innovation gain of type Word16 3654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = pointer to overflow indicator of type Flag 3664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Outputs: 3684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st = pointer to a pointer to a structure containing code state data of 3694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber stucture type ec_gain_codeState 3704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain_code = pointer to decoded innovation gain of type Word16 3714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = 1 if there is an overflow else it is zero. 3724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Returns: 3744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 3754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Global Variables Used: 3774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 3784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Local Variables Needed: 3804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 3814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 3834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION DESCRIPTION 3844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Purpose : update the codebook gain concealment state; 3864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber limit gain_code if the previous frame was bad 3874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Call this function always after decoding (or concealing) 3884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber the gain 3894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 3914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REQUIREMENTS 3924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 3944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 3964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REFERENCES 3974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ec_gain.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 3994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 4014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber PSEUDO-CODE 4024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 i; 4044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // limit gain_code by previous good gain if previous frame was bad 4064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (bfi == 0) 4074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 4084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (prev_bf != 0) 4094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 4104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (sub (*gain_code, st->prev_gc) > 0) 4114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 4124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber *gain_code = st->prev_gc; 4134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 4144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 4154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->prev_gc = *gain_code; 4164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 4174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // update EC states: previous gain, gain buffer 4194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->past_gain_code = *gain_code; 4204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber for (i = 1; i < 5; i++) 4224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 4234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->gbuf[i - 1] = st->gbuf[i]; 4244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 4254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->gbuf[4] = *gain_code; 4264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return; 4284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 4294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 4314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RESOURCES USED [optional] 4324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber When the code is written for a specific target processor the 4344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber the resources used should be documented below. 4354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber HEAP MEMORY USED: x bytes 4374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber STACK MEMORY USED: x bytes 4394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 4414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber used to represent cycle count for each subroutine 4424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber called) 4434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber where: (cycle count variable) = cycle count for [subroutine 4444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber name] 4454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 4474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CAUTION [optional] 4484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber [State any special notes, constraints or cautions for users of this function] 4494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 4514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber*/ 4524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Hubervoid ec_gain_code_update( 4534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ec_gain_codeState *st, /* i/o : State struct */ 4544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 bfi, /* i : flag: frame is bad */ 4554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 prev_bf, /* i : flag: previous frame was bad */ 4564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *gain_code, /* i/o : decoded innovation gain */ 4574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Flag *pOverflow 4584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber) 4594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 4604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 i; 4614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* limit gain_code by previous good gain if previous frame was bad */ 4634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (bfi == 0) 4644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 4654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (prev_bf != 0) 4664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 4674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (sub(*gain_code, st->prev_gc, pOverflow) > 0) 4684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 4694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber *gain_code = st->prev_gc; 4704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 4714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 4724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->prev_gc = *gain_code; 4734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 4744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* update EC states: previous gain, gain buffer */ 4764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->past_gain_code = *gain_code; 4774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber for (i = 1; i < 5; i++) 4794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 4804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->gbuf[i - 1] = st->gbuf[i]; 4814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 4824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->gbuf[4] = *gain_code; 4834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return; 4854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 4864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/****************************************************************************/ 4884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* 4904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 4914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION NAME: ec_gain_pitch 4924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 4934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber INPUT AND OUTPUT DEFINITIONS 4944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Inputs: 4964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st = pointer to a pointer to a structure containing code 4974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state data of stucture type ec_gain_pitchState 4984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state = state of the state machine of type Word16 4994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = pointer to overflow indicator of type Flag 5004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Outputs: 5024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state = pointer to a pointer to a structure containing code 5034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state data of stucture type ec_gain_pitchState 5044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain_pitch = pointer to pitch gain (Q14) of type Word16 5054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = 1 if there is an overflow else it is zero. 5064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Returns: 5084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 5094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Global Variables Used: 5114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 5124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Local Variables Needed: 5144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 5154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION DESCRIPTION 5184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber This function conceals the error using code gain implementation in this 5204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber function. 5214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REQUIREMENTS 5244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 5264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REFERENCES 5294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ec_gain.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 5314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber PSEUDO-CODE 5344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber static const Word16 pdown[7] = 5374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 5384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 32767, 32112, 32112, 26214, 5394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9830, 6553, 6553 5404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber }; 5414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 tmp; 5434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // calculate median of last five gains 5454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber tmp = gmed_n (st->pbuf, 5); 5464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // new gain = minimum(median, past_gain) * pdown[state] 5484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (sub (tmp, st->past_gain_pit) > 0) 5494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 5504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber tmp = st->past_gain_pit; 5514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 5524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber *gain_pitch = mult (tmp, pdown[state]); 5534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RESOURCES USED [optional] 5574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber When the code is written for a specific target processor the 5594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber the resources used should be documented below. 5604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber HEAP MEMORY USED: x bytes 5624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber STACK MEMORY USED: x bytes 5644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 5664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber used to represent cycle count for each subroutine 5674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber called) 5684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber where: (cycle count variable) = cycle count for [subroutine 5694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber name] 5704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CAUTION [optional] 5734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber [State any special notes, constraints or cautions for users of this function] 5744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber*/ 5774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Hubervoid ec_gain_pitch( 5784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ec_gain_pitchState *st, /* i/o : state variables */ 5794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 state, /* i : state of the state machine */ 5804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *gain_pitch, /* o : pitch gain (Q14) */ 5814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Flag *pOverflow 5824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber) 5834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 5844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber static const Word16 pdown[7] = 5854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 5864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 32767, 32112, 32112, 26214, 5874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9830, 6553, 6553 5884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber }; 5894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 tmp; 5914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* calculate median of last five gains */ 5934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber tmp = gmed_n(st->pbuf, 5); 5944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* new gain = minimum(median, past_gain) * pdown[state] */ 5964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (sub(tmp, st->past_gain_pit, pOverflow) > 0) 5974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 5984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber tmp = st->past_gain_pit; 5994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 6004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber *gain_pitch = mult(tmp, pdown[state], pOverflow); 6014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 6024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/****************************************************************************/ 6044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* 6054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 6064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION NAME: ec_gain_pitch_reset 6074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 6084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber INPUT AND OUTPUT DEFINITIONS 6094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Inputs: 6114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state = state of the state machine of type Word16 6124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = pointer to overflow indicator of type Flag 6134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Outputs: 6154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state = pointer to a pointer to a structure containing code 6164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state data of stucture type ec_gain_pitchState 6174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = 1 if there is an overflow else it is zero. 6184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Returns: 6204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 6214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Global Variables Used: 6234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 6244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Local Variables Needed: 6264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 6274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 6294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION DESCRIPTION 6304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Function: ec_gain_pitch_reset 6324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Purpose: Resets state memory 6334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 6354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REQUIREMENTS 6364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 6384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 6404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REFERENCES 6414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ec_gain.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 6434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 6454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber PSEUDO-CODE 6464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huberint ec_gain_pitch_reset (ec_gain_pitchState *state) 6484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 6494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 i; 6504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (state == (ec_gain_pitchState *) NULL){ 6524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // fprintf(stderr, "ec_gain_pitch_reset: invalid parameter\n"); 6534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return -1; 6544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 6554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber for(i = 0; i < 5; i++) 6574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state->pbuf[i] = 1640; 6584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state->past_gain_pit = 0; 6594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state->prev_gp = 16384; 6604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return 0; 6624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 6634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 6654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RESOURCES USED [optional] 6664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber When the code is written for a specific target processor the 6684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber the resources used should be documented below. 6694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber HEAP MEMORY USED: x bytes 6714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber STACK MEMORY USED: x bytes 6734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 6754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber used to represent cycle count for each subroutine 6764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber called) 6774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber where: (cycle count variable) = cycle count for [subroutine 6784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber name] 6794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 6814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CAUTION [optional] 6824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber [State any special notes, constraints or cautions for users of this function] 6834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 6854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber*/ 6864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas HuberWord16 ec_gain_pitch_reset(ec_gain_pitchState *state) 6874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 6884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 i; 6894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (state == (ec_gain_pitchState *) NULL) 6914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 6924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* fprintf(stderr, "ec_gain_pitch_reset: invalid parameter\n"); */ 6934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return -1; 6944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 6954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber for (i = 0; i < 5; i++) 6974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state->pbuf[i] = 1640; 6984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state->past_gain_pit = 0; 6994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state->prev_gp = 16384; 7004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return 0; 7024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 7034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/****************************************************************************/ 7054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* 7084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 7094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION NAME: ec_gain_pitch_update 7104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 7114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber INPUT AND OUTPUT DEFINITIONS 7124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Inputs: 7144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st = pointer to a pointer to a structure containing code 7154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state data of stucture type ec_gain_pitchState 7164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber bfi = flag indicating the frame is bad of type Word16 7174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber prev_bf = flag indicating the previous frame was bad of type Word16 7184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain_pitch = pointer to pitch gain of type Word16 7194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = pointer to overflow indicator of type Flag 7204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Outputs: 7224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state = pointer to a pointer to a structure containing code 7234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state data of stucture type ec_gain_pitchState 7244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain_pitch = pointer to pitch gain of type Word16 7254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = 1 if there is an overflow else it is zero. 7264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Returns: 7284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 7294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Global Variables Used: 7314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 7324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Local Variables Needed: 7344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 7354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 7374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION DESCRIPTION 7384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Purpose : update the pitch gain concealment state; 7404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber limit gain_pitch if the previous frame was bad 7414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Call this function always after decoding (or concealing) 7424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber the gain 7434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 7454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REQUIREMENTS 7464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 7484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 7504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REFERENCES 7514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ec_gain.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 7534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 7554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber PSEUDO-CODE 7564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 i; 7584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (bfi == 0) 7604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 7614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (prev_bf != 0) 7624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 7634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (sub (*gain_pitch, st->prev_gp) > 0) 7644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 7654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber *gain_pitch = st->prev_gp; 7664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 7674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 7684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->prev_gp = *gain_pitch; 7694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 7704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->past_gain_pit = *gain_pitch; 7724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (sub (st->past_gain_pit, 16384) > 0) // if (st->past_gain_pit > 1.0) 7744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 7754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->past_gain_pit = 16384; 7764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 7774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber for (i = 1; i < 5; i++) 7784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 7794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->pbuf[i - 1] = st->pbuf[i]; 7804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 7814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->pbuf[4] = st->past_gain_pit; 7824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 7854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RESOURCES USED [optional] 7864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber When the code is written for a specific target processor the 7884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber the resources used should be documented below. 7894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber HEAP MEMORY USED: x bytes 7914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber STACK MEMORY USED: x bytes 7934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 7954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber used to represent cycle count for each subroutine 7964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber called) 7974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber where: (cycle count variable) = cycle count for [subroutine 7984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber name] 7994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 8014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CAUTION [optional] 8024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber [State any special notes, constraints or cautions for users of this function] 8034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 8054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber*/ 8064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Hubervoid ec_gain_pitch_update( 8074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ec_gain_pitchState *st, /* i/o : state variables */ 8084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 bfi, /* i : flag: frame is bad */ 8094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 prev_bf, /* i : flag: previous frame was bad */ 8104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *gain_pitch, /* i/o : pitch gain */ 8114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Flag *pOverflow 8124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber) 8134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 8144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 i; 8154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (bfi == 0) 8174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 8184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (prev_bf != 0) 8194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 8204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (sub(*gain_pitch, st->prev_gp, pOverflow) > 0) 8214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 8224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber *gain_pitch = st->prev_gp; 8234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 8244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 8254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->prev_gp = *gain_pitch; 8264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 8274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->past_gain_pit = *gain_pitch; 8294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (sub(st->past_gain_pit, 16384, pOverflow) > 0) 8314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* if (st->past_gain_pit > 1.0) */ 8324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 8334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->past_gain_pit = 16384; 8344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 8354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber for (i = 1; i < 5; i++) 8364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 8374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->pbuf[i - 1] = st->pbuf[i]; 8384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 8394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->pbuf[4] = st->past_gain_pit; 8404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 8414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 843