1 /*
2  *  Copyright (c) 2011 The WebRTC project authors. All Rights Reserved.
3  *
4  *  Use of this source code is governed by a BSD-style license
5  *  that can be found in the LICENSE file in the root of the source
6  *  tree. An additional intellectual property rights grant can be found
7  *  in the file PATENTS.  All contributing project authors may
8  *  be found in the AUTHORS file in the root of the source tree.
9  */
10 
11 #ifndef WEBRTC_MODULES_AUDIO_PROCESSING_AGC_LEGACY_DIGITAL_AGC_H_
12 #define WEBRTC_MODULES_AUDIO_PROCESSING_AGC_LEGACY_DIGITAL_AGC_H_
13 
14 #ifdef WEBRTC_AGC_DEBUG_DUMP
15 #include <stdio.h>
16 #endif
17 #include "webrtc/common_audio/signal_processing/include/signal_processing_library.h"
18 #include "webrtc/typedefs.h"
19 
20 // the 32 most significant bits of A(19) * B(26) >> 13
21 #define AGC_MUL32(A, B)             (((B)>>13)*(A) + ( ((0x00001FFF & (B))*(A)) >> 13 ))
22 // C + the 32 most significant bits of A * B
23 #define AGC_SCALEDIFF32(A, B, C)    ((C) + ((B)>>16)*(A) + ( ((0x0000FFFF & (B))*(A)) >> 16 ))
24 
25 typedef struct
26 {
27     int32_t downState[8];
28     int16_t HPstate;
29     int16_t counter;
30     int16_t logRatio; // log( P(active) / P(inactive) ) (Q10)
31     int16_t meanLongTerm; // Q10
32     int32_t varianceLongTerm; // Q8
33     int16_t stdLongTerm; // Q10
34     int16_t meanShortTerm; // Q10
35     int32_t varianceShortTerm; // Q8
36     int16_t stdShortTerm; // Q10
37 } AgcVad;  // total = 54 bytes
38 
39 typedef struct
40 {
41     int32_t capacitorSlow;
42     int32_t capacitorFast;
43     int32_t gain;
44     int32_t gainTable[32];
45     int16_t gatePrevious;
46     int16_t agcMode;
47     AgcVad vadNearend;
48     AgcVad vadFarend;
49 #ifdef WEBRTC_AGC_DEBUG_DUMP
50     FILE* logFile;
51     int frameCounter;
52 #endif
53 } DigitalAgc;
54 
55 int32_t WebRtcAgc_InitDigital(DigitalAgc* digitalAgcInst, int16_t agcMode);
56 
57 int32_t WebRtcAgc_ProcessDigital(DigitalAgc* digitalAgcInst,
58                                  const int16_t* const* inNear,
59                                  size_t num_bands,
60                                  int16_t* const* out,
61                                  uint32_t FS,
62                                  int16_t lowLevelSignal);
63 
64 int32_t WebRtcAgc_AddFarendToDigital(DigitalAgc* digitalAgcInst,
65                                      const int16_t* inFar,
66                                      size_t nrSamples);
67 
68 void WebRtcAgc_InitVad(AgcVad* vadInst);
69 
70 int16_t WebRtcAgc_ProcessVad(AgcVad* vadInst,     // (i) VAD state
71                              const int16_t* in,   // (i) Speech signal
72                              size_t nrSamples);  // (i) number of samples
73 
74 int32_t WebRtcAgc_CalculateGainTable(int32_t *gainTable, // Q16
75                                      int16_t compressionGaindB, // Q0 (in dB)
76                                      int16_t targetLevelDbfs,// Q0 (in dB)
77                                      uint8_t limiterEnable,
78                                      int16_t analogTarget);
79 
80 #endif // WEBRTC_MODULES_AUDIO_PROCESSING_AGC_LEGACY_DIGITAL_AGC_H_
81