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 Pathname: ./audio/gsm-amr/c/src/agc.c 354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Funtions: energy_old 364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber energy_new 374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber agc_init 384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber agc_reset 394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber agc_exit 404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber agc 414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber agc2 424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber MODULE DESCRIPTION 454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber This set of modules scale the excitation level and output of the speech 474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber signals. 484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber*/ 514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/*---------------------------------------------------------------------------- 544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber; INCLUDES 554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber----------------------------------------------------------------------------*/ 564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#include "agc.h" 584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#include "cnst.h" 594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#include "inv_sqrt.h" 604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#include "basic_op.h" 614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/*---------------------------------------------------------------------------- 634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber; MACROS 644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber; Define module specific macros here 654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber----------------------------------------------------------------------------*/ 664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/*---------------------------------------------------------------------------- 694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber; DEFINES 704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber; Include all pre-processor statements here. Include conditional 714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber; compile variables also. 724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber----------------------------------------------------------------------------*/ 734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/*---------------------------------------------------------------------------- 754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber; LOCAL FUNCTION DEFINITIONS 764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber; Function Prototype declaration 774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber----------------------------------------------------------------------------*/ 784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/*---------------------------------------------------------------------------- 804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber; LOCAL VARIABLE DEFINITIONS 814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber; Variable declaration - defined here and used outside this module 824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber----------------------------------------------------------------------------*/ 834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* 854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION NAME: energy_old 874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber INPUT AND OUTPUT DEFINITIONS 894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Inputs: 914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber in = input signal (Word16) 924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber l_trm = input signal length (Word16) 934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = address of overflow (Flag) 944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Outputs: 964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow -> 1 if the energy computation saturates 974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Returns: 994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = return energy of signal (Word32) 1004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Global Variables Used: 1024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 1034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Local Variables Needed: 1054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 1064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION DESCRIPTION 1094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Returns the energy of the signal. 1114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REQUIREMENTS 1144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 1164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REFERENCES 1194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber agc.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 1214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber PSEUDO-CODE 1244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huberstatic Word32 energy_old( // o : return energy of signal 1264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 in[], // i : input signal (length l_trm) 1274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 l_trm // i : signal length 1284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber) 1294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 1304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word32 s; 1314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 i, temp; 1324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber temp = shr (in[0], 2); 1344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = L_mult (temp, temp); 1354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber for (i = 1; i < l_trm; i++) 1374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 1384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber temp = shr (in[i], 2); 1394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = L_mac (s, temp, temp); 1404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 1414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return s; 1434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 1444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RESOURCES USED [optional] 1474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber When the code is written for a specific target processor the 1494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber the resources used should be documented below. 1504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber HEAP MEMORY USED: x bytes 1524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber STACK MEMORY USED: x bytes 1544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 1564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber used to represent cycle count for each subroutine 1574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber called) 1584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber where: (cycle count variable) = cycle count for [subroutine 1594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber name] 1604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CAUTION [optional] 1634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber [State any special notes, constraints or cautions for users of this function] 1644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber*/ 1674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huberstatic Word32 energy_old( /* o : return energy of signal */ 1694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 in[], /* i : input signal (length l_trm) */ 1704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 l_trm, /* i : signal length */ 1714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Flag *pOverflow /* overflow: flag to indicate overflow */ 1724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber) 1734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 1754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word32 s = 0; 1764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 i; 1774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 temp; 1784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber for (i = 0; i < l_trm; i++) 1804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 1814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber temp = in[i] >> 2; 1824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = L_mac(s, temp, temp, pOverflow); 1834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 1844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return(s); 1864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 1874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/*----------------------------------------------------------------------------*/ 1894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* 1904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION NAME: energy_old__Wrapper 1924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 1934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber INPUT AND OUTPUT DEFINITIONS 1944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Inputs: 1964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber in = input signal (Word16) 1974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber l_trm = input signal length (Word16) 1984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = address of overflow (Flag) 1994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Outputs: 2004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow -> 1 if the energy computation saturates 2014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Returns: 2034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = return energy of signal (Word32) 2044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Global Variables Used: 2064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 2074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Local Variables Needed: 2094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 2104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 2124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION DESCRIPTION 2134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber This function provides external access to the static function energy_old. 2154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 2174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REQUIREMENTS 2184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None 2204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 2224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REFERENCES 2234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None 2254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 2274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber PSEUDO-CODE 2284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CALL energy_old ( in = in 2304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber l_trm = l_trm 2314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = pOverflow ) 2324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber MODIFYING(nothing) 2334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RETURNING(energy_old_value = s) 2344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 2364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RESOURCES USED [optional] 2374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber When the code is written for a specific target processor the 2394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber the resources used should be documented below. 2404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber HEAP MEMORY USED: x bytes 2424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber STACK MEMORY USED: x bytes 2444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 2464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber used to represent cycle count for each subroutine 2474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber called) 2484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber where: (cycle count variable) = cycle count for [subroutine 2494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber name] 2504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 2524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CAUTION [optional] 2534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber [State any special notes, constraints or cautions for users of this function] 2544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 2564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber*/ 2574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas HuberWord32 energy_old_Wrapper(Word16 in[], Word16 l_trm, Flag *pOverflow) 2594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 2604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word32 energy_old_value; 2614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /*---------------------------------------------------------------------------- 2634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CALL energy_old ( in = in 2644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber l_trm = l_trm 2654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = pOverflow ) 2664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber MODIFYING(nothing) 2684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RETURNING(energy_old_value = s) 2694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ----------------------------------------------------------------------------*/ 2704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber energy_old_value = energy_old(in, l_trm, pOverflow); 2714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return(energy_old_value); 2724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 2734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/*--------------------------------------------------------------------------*/ 2744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* 2764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber----------------------------------------------------------------------------- 2774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION NAME: energy_new 2784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 2794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber INPUT AND OUTPUT DEFINITIONS 2804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Inputs: 2824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber in = input signal 2834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber l_trm = input signal length 2844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = address of overflow (Flag) 2854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Outputs: 2874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow -> 1 if the energy computation saturates 2884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Returns: 2904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = return energy of signal 2914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Global Variables Used: 2934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 2944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Local Variables Needed: 2964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 2974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 2984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 2994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION DESCRIPTION 3004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Returns the energy of the signal. 3024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 3044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REQUIREMENTS 3054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 3074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 3094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REFERENCES 3104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber agc.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 3124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 3144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber PSEUDO-CODE 3154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huberstatic Word32 energy_new( // o : return energy of signal 3174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 in[], // i : input signal (length l_trm) 3184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 l_trm ) // i : signal length 3194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 3214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word32 s; 3224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 i; 3234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Flag ov_save; 3244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ov_save = Overflow; //save overflow flag in case energy_old 3264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // must be called 3274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = L_mult(in[0], in[0]); 3284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber for (i = 1; i < l_trm; i++) 3294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 3304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = L_mac(s, in[i], in[i]); 3314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 3324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // check for overflow 3344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (L_sub (s, MAX_32) == 0L) 3354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 3364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Overflow = ov_save; // restore overflow flag 3374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = energy_old (in, l_trm); // function result 3384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 3394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber else 3404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 3414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = L_shr(s, 4); 3424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 3434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return(s); 3454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 3464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 3484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RESOURCES USED [optional] 3494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber When the code is written for a specific target processor the 3514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber the resources used should be documented below. 3524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber HEAP MEMORY USED: x bytes 3544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber STACK MEMORY USED: x bytes 3564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 3584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber used to represent cycle count for each subroutine 3594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber called) 3604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber where: (cycle count variable) = cycle count for [subroutine 3614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber name] 3624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 3644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CAUTION [optional] 3654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber [State any special notes, constraints or cautions for users of this function] 3664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 3684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber*/ 3694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huberstatic Word32 energy_new( /* o : return energy of signal */ 3714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 in[], /* i : input signal (length l_trm) */ 3724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 l_trm, /* i : signal length */ 3734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Flag *pOverflow /* i : overflow flag */ 3744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber) 3754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 3774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word32 s = 0; 3784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 i; 3794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Flag ov_save; 3804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ov_save = *(pOverflow); /* save overflow flag in case energy_old */ 3824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* must be called */ 3834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber for (i = 0; i < l_trm; i++) 3864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 3874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = L_mac(s, in[i], in[i], pOverflow); 3884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 3894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* check for overflow */ 3914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (s != MAX_32) 3924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 3934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* s is a sum of squares, so it won't be negative */ 3944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = s >> 4; 3954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 3964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber else 3974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 3984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber *(pOverflow) = ov_save; /* restore overflow flag */ 3994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = energy_old(in, l_trm, pOverflow); /* function result */ 4004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 4014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return (s); 4034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 4044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/*--------------------------------------------------------------------------*/ 4064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* 4074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 4084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION NAME: energy_new__Wrapper 4094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 4104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber INPUT AND OUTPUT DEFINITIONS 4114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Inputs: 4134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber in = input signal (Word16) 4144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber l_trm = input signal length (Word16) 4154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber overflow = address of overflow (Flag) 4164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Outputs: 4184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow -> 1 if the energy computation saturates 4194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Returns: 4214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = return energy of signal (Word32) 4224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Global Variables Used: 4244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 4254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Local Variables Needed: 4274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 4284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 4304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION DESCRIPTION 4314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber This function provides external access to the static function energy_new. 4334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 4354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REQUIREMENTS 4364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None 4384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 4404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REFERENCES 4414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None 4434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 4454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber PSEUDO-CODE 4464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CALL energy_new ( in = in 4484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber l_trm = l_trm 4494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = pOverflow ) 4504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber MODIFYING(nothing) 4524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RETURNING(energy_new_value = s) 4544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 4564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RESOURCES USED [optional] 4574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber When the code is written for a specific target processor the 4594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber the resources used should be documented below. 4604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber HEAP MEMORY USED: x bytes 4624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber STACK MEMORY USED: x bytes 4644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 4664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber used to represent cycle count for each subroutine 4674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber called) 4684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber where: (cycle count variable) = cycle count for [subroutine 4694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber name] 4704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 4724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CAUTION [optional] 4734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber [State any special notes, constraints or cautions for users of this function] 4744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 4764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber*/ 4774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas HuberWord32 energy_new_Wrapper(Word16 in[], Word16 l_trm, Flag *pOverflow) 4794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 4804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word32 energy_new_value; 4814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /*---------------------------------------------------------------------------- 4834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CALL energy_new ( in = in 4844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber l_trm = l_trm 4854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = pOverflow ) 4864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber MODIFYING(nothing) 4884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RETURNING(energy_new_value = s) 4894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ----------------------------------------------------------------------------*/ 4914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber energy_new_value = energy_new(in, l_trm, pOverflow); 4924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return(energy_new_value); 4944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 4964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/*--------------------------------------------------------------------------*/ 4984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 4994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* 5024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION NAME: agc_reset 5044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber INPUT AND OUTPUT DEFINITIONS 5064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Inputs: 5084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state = pointer to a structure of type agcState 5094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Outputs: 5114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Structure pointed to by state is initialized to zeros 5124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Returns: 5144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Returns 0 if memory was successfully initialized, 5154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber otherwise returns -1. 5164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Global Variables Used: 5184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 5194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Local Variables Needed: 5214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 5224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION DESCRIPTION 5254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Reset of agc (i.e. set state memory to 1.0). 5274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REQUIREMENTS 5304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 5324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REFERENCES 5354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber agc.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 5374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber PSEUDO-CODE 5404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huberint agc_reset (agcState *state) 5424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 5434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (state == (agcState *) NULL) 5444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 5454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber fprintf(stderr, "agc_reset: invalid parameter\n"); 5464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return -1; 5474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 5484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state->past_gain = 4096; // initial value of past_gain = 1.0 5504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return 0; 5524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 5534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RESOURCES USED [optional] 5564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber When the code is written for a specific target processor the 5584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber the resources used should be documented below. 5594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber HEAP MEMORY USED: x bytes 5614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber STACK MEMORY USED: x bytes 5634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 5654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber used to represent cycle count for each subroutine 5664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber called) 5674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber where: (cycle count variable) = cycle count for [subroutine 5684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber name] 5694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CAUTION [optional] 5724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber [State any special notes, constraints or cautions for users of this function] 5734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber*/ 5764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas HuberWord16 agc_reset(agcState *state) 5784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 5794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (state == (agcState *) NULL) 5804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 5814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* fprintf(stderr, "agc_reset: invalid parameter\n"); */ 5824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return(-1); 5834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 5844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber state->past_gain = 4096; /* initial value of past_gain = 1.0 */ 5864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return(0); 5884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 5894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/*--------------------------------------------------------------------------*/ 5914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* 5934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION NAME: agc 5954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 5964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber INPUT AND OUTPUT DEFINITIONS 5974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 5984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Inputs: 5994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st = pointer to agc state 6004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber sig_in = pointer to a buffer containing the postfilter input signal 6014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber sig_out = pointer to a buffer containing the postfilter output signal 6024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber agc_fac = AGC factor 6034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber l_trm = subframe size 6044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = pointer to the overflow flag 6054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Outputs: 6074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->past_gain = gain 6084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber buffer pointed to by sig_out contains the new postfilter output signal 6094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow -> 1 if the agc computation saturates 6104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Returns: 6124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return = 0 6134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Global Variables Used: 6154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber none. 6164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Local Variables Needed: 6184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber none. 6194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 6214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION DESCRIPTION 6224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Scales the postfilter output on a subframe basis using: 6244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber sig_out[n] = sig_out[n] * gain[n] 6264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain[n] = agc_fac * gain[n-1] + (1 - agc_fac) g_in/g_out 6274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber where: gain[n] = gain at the nth sample given by 6294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber g_in/g_out = square root of the ratio of energy at 6304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber the input and output of the postfilter. 6314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 6334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REQUIREMENTS 6344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 6364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 6384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REFERENCES 6394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber agc.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 6414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 6434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber PSEUDO-CODE 6444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huberint agc ( 6464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber agcState *st, // i/o : agc state 6474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *sig_in, // i : postfilter input signal (l_trm) 6484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *sig_out, // i/o : postfilter output signal (l_trm) 6494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 agc_fac, // i : AGC factor 6504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 l_trm // i : subframe size 6514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber) 6524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 6534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 i, exp; 6544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 gain_in, gain_out, g0, gain; 6554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word32 s; 6564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // calculate gain_out with exponent 6584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = energy_new(sig_out, l_trm); // function result 6594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (s == 0) 6614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 6624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->past_gain = 0; 6634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return 0; 6644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 6654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber exp = sub (norm_l (s), 1); 6664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain_out = pv_round (L_shl (s, exp)); 6674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // calculate gain_in with exponent 6694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = energy_new(sig_in, l_trm); // function result 6704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (s == 0) 6724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 6734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber g0 = 0; 6744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 6754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber else 6764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 6774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber i = norm_l (s); 6784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain_in = pv_round (L_shl (s, i)); 6794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber exp = sub (exp, i); 6804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber *---------------------------------------------------* 6824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * g0 = (1-agc_fac) * sqrt(gain_in/gain_out); * 6834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber *---------------------------------------------------* 6844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = L_deposit_l (div_s (gain_out, gain_in)); 6864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = L_shl (s, 7); // s = gain_out / gain_in 6874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = L_shr (s, exp); // add exponent 6884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = Inv_sqrt (s); // function result 6904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber i = pv_round (L_shl (s, 9)); 6914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // g0 = i * (1-agc_fac) 6934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber g0 = mult (i, sub (32767, agc_fac)); 6944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 6954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 6964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // compute gain[n] = agc_fac * gain[n-1] 6974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber + (1-agc_fac) * sqrt(gain_in/gain_out) 6984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // sig_out[n] = gain[n] * sig_out[n] 6994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain = st->past_gain; 7014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber for (i = 0; i < l_trm; i++) 7034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 7044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain = mult (gain, agc_fac); 7054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain = add (gain, g0); 7064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber sig_out[i] = extract_h (L_shl (L_mult (sig_out[i], gain), 3)); 7074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 7084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->past_gain = gain; 7104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return 0; 7124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 7134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 7154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RESOURCES USED [optional] 7164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber When the code is written for a specific target processor the 7184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber the resources used should be documented below. 7194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber HEAP MEMORY USED: x bytes 7214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber STACK MEMORY USED: x bytes 7234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 7254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber used to represent cycle count for each subroutine 7264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber called) 7274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber where: (cycle count variable) = cycle count for [subroutine 7284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber name] 7294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 7314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CAUTION [optional] 7324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber [State any special notes, constraints or cautions for users of this function] 7334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 7354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber*/ 7364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Hubervoid agc( 7384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber agcState *st, /* i/o : agc state */ 7394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *sig_in, /* i : postfilter input signal (l_trm) */ 7404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *sig_out, /* i/o : postfilter output signal (l_trm) */ 7414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 agc_fac, /* i : AGC factor */ 7424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 l_trm, /* i : subframe size */ 7434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Flag *pOverflow /* i : overflow Flag */ 7444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber) 7464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 7484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 i; 7494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 exp; 7504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 gain_in; 7514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 gain_out; 7524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 g0; 7534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 gain; 7544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word32 s; 7554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word32 L_temp; 7564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 temp; 7574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *p_sig_out; 7594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* calculate gain_out with exponent */ 7614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = energy_new(sig_out, l_trm, pOverflow); /* function result */ 7624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (s == 0) 7644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 7654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->past_gain = 0; 7664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return; 7674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 7684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber exp = norm_l(s) - 1; 7694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber L_temp = L_shl(s, exp, pOverflow); 7714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain_out = pv_round(L_temp, pOverflow); 7724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* calculate gain_in with exponent */ 7744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = energy_new(sig_in, l_trm, pOverflow); /* function result */ 7754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (s == 0) 7774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 7784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber g0 = 0; 7794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 7804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber else 7814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 7824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber i = norm_l(s); 7834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* L_temp = L_shl(s, i, pOverflow); */ 7854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber L_temp = s << i; 7864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain_in = pv_round(L_temp, pOverflow); 7884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber exp -= i; 7904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /*---------------------------------------------------* 7924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * g0 = (1-agc_fac) * sqrt(gain_in/gain_out); * 7934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber *---------------------------------------------------*/ 7944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* s = gain_out / gain_in */ 7964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber temp = div_s(gain_out, gain_in); 7974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 7984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* s = L_deposit_l (temp); */ 7994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = (Word32) temp; 8004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = s << 7; 8014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = L_shr(s, exp, pOverflow); /* add exponent */ 8024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = Inv_sqrt(s, pOverflow); /* function result */ 8044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber L_temp = s << 9; 8054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber i = (Word16)((L_temp + (Word32) 0x00008000L) >> 16); 8074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* g0 = i * (1-agc_fac) */ 8094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber temp = 32767 - agc_fac; 8104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber g0 = (Word16)(((Word32) i * temp) >> 15); 8124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 8144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* compute gain[n] = agc_fac * gain[n-1] 8164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber + (1-agc_fac) * sqrt(gain_in/gain_out) */ 8174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* sig_out[n] = gain[n] * sig_out[n] */ 8184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain = st->past_gain; 8204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber p_sig_out = sig_out; 8214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber for (i = 0; i < l_trm; i++) 8234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 8244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* gain = mult (gain, agc_fac, pOverflow); */ 8254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain = (Word16)(((Word32) gain * agc_fac) >> 15); 8264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* gain = add (gain, g0, pOverflow); */ 8284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain += g0; 8294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* L_temp = L_mult (sig_out[i], gain, pOverflow); */ 8314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber L_temp = ((Word32)(*(p_sig_out)) * gain) << 1; 8324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber *(p_sig_out++) = (Word16)(L_temp >> 13); 8344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 8354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber st->past_gain = gain; 8374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return; 8394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 8404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/*--------------------------------------------------------------------------*/ 8424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* 8444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 8454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION NAME: agc2 8464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 8474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber INPUT AND OUTPUT DEFINITIONS 8484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Inputs: 8504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber sig_in = pointer to a buffer containing the postfilter input signal 8514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber sig_out = pointer to a buffer containing the postfilter output signal 8524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber l_trm = subframe size 8534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow = pointer to overflow flag 8544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Outputs: 8564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber sig_out points to a buffer containing the new scaled output signal. 8574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber pOverflow -> 1 if the agc computation saturates 8584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Returns: 8604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 8614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Global Variables Used: 8634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 8644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Local Variables Needed: 8664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 8674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 8694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber FUNCTION DESCRIPTION 8704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Scales the excitation on a subframe basis. 8724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 8744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REQUIREMENTS 8754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber None. 8774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 8794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REFERENCES 8804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber agc.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 8824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 8844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber PSEUDO-CODE 8854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Hubervoid agc2 ( 8874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *sig_in, // i : postfilter input signal 8884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *sig_out, // i/o : postfilter output signal 8894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 l_trm // i : subframe size 8904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber) 8914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 8924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 i, exp; 8934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 gain_in, gain_out, g0; 8944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word32 s; 8954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // calculate gain_out with exponent 8974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = energy_new(sig_out, l_trm); // function result 8984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 8994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (s == 0) 9004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 9014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return; 9024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 9034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber exp = sub (norm_l (s), 1); 9044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain_out = pv_round (L_shl (s, exp)); 9054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // calculate gain_in with exponent 9074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = energy_new(sig_in, l_trm); // function result 9084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (s == 0) 9104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 9114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber g0 = 0; 9124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 9134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber else 9144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 9154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber i = norm_l (s); 9164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain_in = pv_round (L_shl (s, i)); 9174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber exp = sub (exp, i); 9184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber *---------------------------------------------------* 9204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * g0 = sqrt(gain_in/gain_out); * 9214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber *---------------------------------------------------* 9224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = L_deposit_l (div_s (gain_out, gain_in)); 9244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = L_shl (s, 7); // s = gain_out / gain_in 9254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = L_shr (s, exp); // add exponent 9264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = Inv_sqrt (s); // function result 9284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber g0 = pv_round (L_shl (s, 9)); 9294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 9304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber // sig_out(n) = gain(n) sig_out(n) 9324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber for (i = 0; i < l_trm; i++) 9344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 9354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber sig_out[i] = extract_h (L_shl (L_mult (sig_out[i], g0), 3)); 9364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 9374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return; 9394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 9404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 9414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber RESOURCES USED [optional] 9424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber When the code is written for a specific target processor the 9444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber the resources used should be documented below. 9454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber HEAP MEMORY USED: x bytes 9474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber STACK MEMORY USED: x bytes 9494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CLOCK CYCLES: (cycle count equation for this function) + (variable 9514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber used to represent cycle count for each subroutine 9524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber called) 9534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber where: (cycle count variable) = cycle count for [subroutine 9544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber name] 9554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 9574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber CAUTION [optional] 9584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber [State any special notes, constraints or cautions for users of this function] 9594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 9614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber*/ 9624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Hubervoid agc2( 9644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *sig_in, /* i : postfilter input signal */ 9654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *sig_out, /* i/o : postfilter output signal */ 9664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 l_trm, /* i : subframe size */ 9674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Flag *pOverflow /* i : overflow flag */ 9684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber) 9694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 9714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 i; 9724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 exp; 9734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 gain_in; 9744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 gain_out; 9754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 g0; 9764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word32 s; 9774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word32 L_temp; 9784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 temp; 9794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* calculate gain_out with exponent */ 9814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = energy_new(sig_out, l_trm, pOverflow); /* function result */ 9824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (s == 0) 9844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 9854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return; 9864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 9874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber exp = norm_l(s) - 1; 9884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber L_temp = L_shl(s, exp, pOverflow); 9894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain_out = pv_round(L_temp, pOverflow); 9904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* calculate gain_in with exponent */ 9924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = energy_new(sig_in, l_trm, pOverflow); /* function result */ 9934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 9944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (s == 0) 9954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 9964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber g0 = 0; 9974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 9984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber else 9994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 10004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber i = norm_l(s); 10014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber L_temp = L_shl(s, i, pOverflow); 10024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gain_in = pv_round(L_temp, pOverflow); 10034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber exp -= i; 10044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 10054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /*---------------------------------------------------* 10064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * g0 = sqrt(gain_in/gain_out); * 10074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber *---------------------------------------------------*/ 10084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 10094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* s = gain_out / gain_in */ 10104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber temp = div_s(gain_out, gain_in); 10114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 10124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* s = L_deposit_l (temp); */ 10134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = (Word32)temp; 10144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 10154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (s > (Word32) 0x00FFFFFFL) 10164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 10174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = MAX_32; 10184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 10194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber else if (s < (Word32) 0xFF000000L) 10204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 10214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = MIN_32; 10224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 10234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber else 10244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 10254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = s << 7; 10264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 10274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = L_shr(s, exp, pOverflow); /* add exponent */ 10284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 10294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber s = Inv_sqrt(s, pOverflow); /* function result */ 10304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 10314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (s > (Word32) 0x003FFFFFL) 10324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 10334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber L_temp = MAX_32; 10344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 10354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber else if (s < (Word32) 0xFFC00000L) 10364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 10374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber L_temp = MIN_32; 10384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 10394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber else 10404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 10414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber L_temp = s << 9; 10424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 10434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber g0 = pv_round(L_temp, pOverflow); 10444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 10454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 10464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* sig_out(n) = gain(n) sig_out(n) */ 10474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 10484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber for (i = l_trm - 1; i >= 0; i--) 10494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 10504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber L_temp = L_mult(sig_out[i], g0, pOverflow); 10514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber if (L_temp > (Word32) 0x0FFFFFFFL) 10524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 10534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber sig_out[i] = MAX_16; 10544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 10554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber else if (L_temp < (Word32) 0xF0000000L) 10564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 10574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber sig_out[i] = MIN_16; 10584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 10594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber else 10604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 10614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber sig_out[i] = (Word16)(L_temp >> 13); 10624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 10634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } 10644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 10654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber return; 10664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 1067