mirror of
https://github.com/oxen-io/session-android.git
synced 2024-12-27 02:07:42 +00:00
d83a3d71bc
Merge in RedPhone // FREEBIE
943 lines
29 KiB
C
943 lines
29 KiB
C
/*
|
|
* Copyright (c) 2012 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
/*
|
|
* Contains the API functions for the AEC.
|
|
*/
|
|
#include "webrtc/modules/audio_processing/aec/include/echo_cancellation.h"
|
|
|
|
#include <math.h>
|
|
#ifdef WEBRTC_AEC_DEBUG_DUMP
|
|
#include <stdio.h>
|
|
#endif
|
|
#include <stdlib.h>
|
|
#include <string.h>
|
|
|
|
#include "webrtc/common_audio/signal_processing/include/signal_processing_library.h"
|
|
#include "webrtc/modules/audio_processing/aec/aec_core.h"
|
|
#include "webrtc/modules/audio_processing/aec/aec_resampler.h"
|
|
#include "webrtc/modules/audio_processing/aec/echo_cancellation_internal.h"
|
|
#include "webrtc/modules/audio_processing/utility/ring_buffer.h"
|
|
#include "webrtc/typedefs.h"
|
|
|
|
// Measured delays [ms]
|
|
// Device Chrome GTP
|
|
// MacBook Air 10
|
|
// MacBook Retina 10 100
|
|
// MacPro 30?
|
|
//
|
|
// Win7 Desktop 70 80?
|
|
// Win7 T430s 110
|
|
// Win8 T420s 70
|
|
//
|
|
// Daisy 50
|
|
// Pixel (w/ preproc?) 240
|
|
// Pixel (w/o preproc?) 110 110
|
|
|
|
// The extended filter mode gives us the flexibility to ignore the system's
|
|
// reported delays. We do this for platforms which we believe provide results
|
|
// which are incompatible with the AEC's expectations. Based on measurements
|
|
// (some provided above) we set a conservative (i.e. lower than measured)
|
|
// fixed delay.
|
|
//
|
|
// WEBRTC_UNTRUSTED_DELAY will only have an impact when |extended_filter_mode|
|
|
// is enabled. See the note along with |DelayCorrection| in
|
|
// echo_cancellation_impl.h for more details on the mode.
|
|
//
|
|
// Justification:
|
|
// Chromium/Mac: Here, the true latency is so low (~10-20 ms), that it plays
|
|
// havoc with the AEC's buffering. To avoid this, we set a fixed delay of 20 ms
|
|
// and then compensate by rewinding by 10 ms (in wideband) through
|
|
// kDelayDiffOffsetSamples. This trick does not seem to work for larger rewind
|
|
// values, but fortunately this is sufficient.
|
|
//
|
|
// Chromium/Linux(ChromeOS): The values we get on this platform don't correspond
|
|
// well to reality. The variance doesn't match the AEC's buffer changes, and the
|
|
// bulk values tend to be too low. However, the range across different hardware
|
|
// appears to be too large to choose a single value.
|
|
//
|
|
// GTP/Linux(ChromeOS): TBD, but for the moment we will trust the values.
|
|
#if defined(WEBRTC_CHROMIUM_BUILD) && defined(WEBRTC_MAC)
|
|
#define WEBRTC_UNTRUSTED_DELAY
|
|
#endif
|
|
|
|
#if defined(WEBRTC_UNTRUSTED_DELAY) && defined(WEBRTC_MAC)
|
|
static const int kDelayDiffOffsetSamples = -160;
|
|
#else
|
|
// Not enabled for now.
|
|
static const int kDelayDiffOffsetSamples = 0;
|
|
#endif
|
|
|
|
#if defined(WEBRTC_MAC)
|
|
static const int kFixedDelayMs = 20;
|
|
#else
|
|
static const int kFixedDelayMs = 50;
|
|
#endif
|
|
#if !defined(WEBRTC_UNTRUSTED_DELAY)
|
|
static const int kMinTrustedDelayMs = 20;
|
|
#endif
|
|
static const int kMaxTrustedDelayMs = 500;
|
|
|
|
// Maximum length of resampled signal. Must be an integer multiple of frames
|
|
// (ceil(1/(1 + MIN_SKEW)*2) + 1)*FRAME_LEN
|
|
// The factor of 2 handles wb, and the + 1 is as a safety margin
|
|
// TODO(bjornv): Replace with kResamplerBufferSize
|
|
#define MAX_RESAMP_LEN (5 * FRAME_LEN)
|
|
|
|
static const int kMaxBufSizeStart = 62; // In partitions
|
|
static const int sampMsNb = 8; // samples per ms in nb
|
|
static const int initCheck = 42;
|
|
|
|
#ifdef WEBRTC_AEC_DEBUG_DUMP
|
|
int webrtc_aec_instance_count = 0;
|
|
#endif
|
|
|
|
// Estimates delay to set the position of the far-end buffer read pointer
|
|
// (controlled by knownDelay)
|
|
static void EstBufDelayNormal(aecpc_t* aecInst);
|
|
static void EstBufDelayExtended(aecpc_t* aecInst);
|
|
static int ProcessNormal(aecpc_t* self,
|
|
const float* near,
|
|
const float* near_high,
|
|
float* out,
|
|
float* out_high,
|
|
int16_t num_samples,
|
|
int16_t reported_delay_ms,
|
|
int32_t skew);
|
|
static void ProcessExtended(aecpc_t* self,
|
|
const float* near,
|
|
const float* near_high,
|
|
float* out,
|
|
float* out_high,
|
|
int16_t num_samples,
|
|
int16_t reported_delay_ms,
|
|
int32_t skew);
|
|
|
|
int32_t WebRtcAec_Create(void** aecInst) {
|
|
aecpc_t* aecpc;
|
|
if (aecInst == NULL) {
|
|
return -1;
|
|
}
|
|
|
|
aecpc = malloc(sizeof(aecpc_t));
|
|
*aecInst = aecpc;
|
|
if (aecpc == NULL) {
|
|
return -1;
|
|
}
|
|
|
|
if (WebRtcAec_CreateAec(&aecpc->aec) == -1) {
|
|
WebRtcAec_Free(aecpc);
|
|
aecpc = NULL;
|
|
return -1;
|
|
}
|
|
|
|
if (WebRtcAec_CreateResampler(&aecpc->resampler) == -1) {
|
|
WebRtcAec_Free(aecpc);
|
|
aecpc = NULL;
|
|
return -1;
|
|
}
|
|
// Create far-end pre-buffer. The buffer size has to be large enough for
|
|
// largest possible drift compensation (kResamplerBufferSize) + "almost" an
|
|
// FFT buffer (PART_LEN2 - 1).
|
|
aecpc->far_pre_buf =
|
|
WebRtc_CreateBuffer(PART_LEN2 + kResamplerBufferSize, sizeof(float));
|
|
if (!aecpc->far_pre_buf) {
|
|
WebRtcAec_Free(aecpc);
|
|
aecpc = NULL;
|
|
return -1;
|
|
}
|
|
|
|
aecpc->initFlag = 0;
|
|
aecpc->lastError = 0;
|
|
|
|
#ifdef WEBRTC_AEC_DEBUG_DUMP
|
|
{
|
|
char filename[64];
|
|
sprintf(filename, "aec_buf%d.dat", webrtc_aec_instance_count);
|
|
aecpc->bufFile = fopen(filename, "wb");
|
|
sprintf(filename, "aec_skew%d.dat", webrtc_aec_instance_count);
|
|
aecpc->skewFile = fopen(filename, "wb");
|
|
sprintf(filename, "aec_delay%d.dat", webrtc_aec_instance_count);
|
|
aecpc->delayFile = fopen(filename, "wb");
|
|
webrtc_aec_instance_count++;
|
|
}
|
|
#endif
|
|
|
|
return 0;
|
|
}
|
|
|
|
int32_t WebRtcAec_Free(void* aecInst) {
|
|
aecpc_t* aecpc = aecInst;
|
|
|
|
if (aecpc == NULL) {
|
|
return -1;
|
|
}
|
|
|
|
WebRtc_FreeBuffer(aecpc->far_pre_buf);
|
|
|
|
#ifdef WEBRTC_AEC_DEBUG_DUMP
|
|
fclose(aecpc->bufFile);
|
|
fclose(aecpc->skewFile);
|
|
fclose(aecpc->delayFile);
|
|
#endif
|
|
|
|
WebRtcAec_FreeAec(aecpc->aec);
|
|
WebRtcAec_FreeResampler(aecpc->resampler);
|
|
free(aecpc);
|
|
|
|
return 0;
|
|
}
|
|
|
|
int32_t WebRtcAec_Init(void* aecInst, int32_t sampFreq, int32_t scSampFreq) {
|
|
aecpc_t* aecpc = aecInst;
|
|
AecConfig aecConfig;
|
|
|
|
if (sampFreq != 8000 && sampFreq != 16000 && sampFreq != 32000) {
|
|
aecpc->lastError = AEC_BAD_PARAMETER_ERROR;
|
|
return -1;
|
|
}
|
|
aecpc->sampFreq = sampFreq;
|
|
|
|
if (scSampFreq < 1 || scSampFreq > 96000) {
|
|
aecpc->lastError = AEC_BAD_PARAMETER_ERROR;
|
|
return -1;
|
|
}
|
|
aecpc->scSampFreq = scSampFreq;
|
|
|
|
// Initialize echo canceller core
|
|
if (WebRtcAec_InitAec(aecpc->aec, aecpc->sampFreq) == -1) {
|
|
aecpc->lastError = AEC_UNSPECIFIED_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
if (WebRtcAec_InitResampler(aecpc->resampler, aecpc->scSampFreq) == -1) {
|
|
aecpc->lastError = AEC_UNSPECIFIED_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
if (WebRtc_InitBuffer(aecpc->far_pre_buf) == -1) {
|
|
aecpc->lastError = AEC_UNSPECIFIED_ERROR;
|
|
return -1;
|
|
}
|
|
WebRtc_MoveReadPtr(aecpc->far_pre_buf, -PART_LEN); // Start overlap.
|
|
|
|
aecpc->initFlag = initCheck; // indicates that initialization has been done
|
|
|
|
if (aecpc->sampFreq == 32000) {
|
|
aecpc->splitSampFreq = 16000;
|
|
} else {
|
|
aecpc->splitSampFreq = sampFreq;
|
|
}
|
|
|
|
aecpc->delayCtr = 0;
|
|
aecpc->sampFactor = (aecpc->scSampFreq * 1.0f) / aecpc->splitSampFreq;
|
|
// Sampling frequency multiplier (SWB is processed as 160 frame size).
|
|
aecpc->rate_factor = aecpc->splitSampFreq / 8000;
|
|
|
|
aecpc->sum = 0;
|
|
aecpc->counter = 0;
|
|
aecpc->checkBuffSize = 1;
|
|
aecpc->firstVal = 0;
|
|
|
|
aecpc->startup_phase = WebRtcAec_reported_delay_enabled(aecpc->aec);
|
|
aecpc->bufSizeStart = 0;
|
|
aecpc->checkBufSizeCtr = 0;
|
|
aecpc->msInSndCardBuf = 0;
|
|
aecpc->filtDelay = -1; // -1 indicates an initialized state.
|
|
aecpc->timeForDelayChange = 0;
|
|
aecpc->knownDelay = 0;
|
|
aecpc->lastDelayDiff = 0;
|
|
|
|
aecpc->skewFrCtr = 0;
|
|
aecpc->resample = kAecFalse;
|
|
aecpc->highSkewCtr = 0;
|
|
aecpc->skew = 0;
|
|
|
|
aecpc->farend_started = 0;
|
|
|
|
// Default settings.
|
|
aecConfig.nlpMode = kAecNlpModerate;
|
|
aecConfig.skewMode = kAecFalse;
|
|
aecConfig.metricsMode = kAecFalse;
|
|
aecConfig.delay_logging = kAecFalse;
|
|
|
|
if (WebRtcAec_set_config(aecpc, aecConfig) == -1) {
|
|
aecpc->lastError = AEC_UNSPECIFIED_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
// only buffer L band for farend
|
|
int32_t WebRtcAec_BufferFarend(void* aecInst,
|
|
const float* farend,
|
|
int16_t nrOfSamples) {
|
|
aecpc_t* aecpc = aecInst;
|
|
int newNrOfSamples = (int)nrOfSamples;
|
|
float new_farend[MAX_RESAMP_LEN];
|
|
const float* farend_ptr = farend;
|
|
|
|
if (farend == NULL) {
|
|
aecpc->lastError = AEC_NULL_POINTER_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
if (aecpc->initFlag != initCheck) {
|
|
aecpc->lastError = AEC_UNINITIALIZED_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
// number of samples == 160 for SWB input
|
|
if (nrOfSamples != 80 && nrOfSamples != 160) {
|
|
aecpc->lastError = AEC_BAD_PARAMETER_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
if (aecpc->skewMode == kAecTrue && aecpc->resample == kAecTrue) {
|
|
// Resample and get a new number of samples
|
|
WebRtcAec_ResampleLinear(aecpc->resampler,
|
|
farend,
|
|
nrOfSamples,
|
|
aecpc->skew,
|
|
new_farend,
|
|
&newNrOfSamples);
|
|
farend_ptr = new_farend;
|
|
}
|
|
|
|
aecpc->farend_started = 1;
|
|
WebRtcAec_SetSystemDelay(aecpc->aec,
|
|
WebRtcAec_system_delay(aecpc->aec) + newNrOfSamples);
|
|
|
|
// Write the time-domain data to |far_pre_buf|.
|
|
WebRtc_WriteBuffer(aecpc->far_pre_buf, farend_ptr, (size_t)newNrOfSamples);
|
|
|
|
// Transform to frequency domain if we have enough data.
|
|
while (WebRtc_available_read(aecpc->far_pre_buf) >= PART_LEN2) {
|
|
// We have enough data to pass to the FFT, hence read PART_LEN2 samples.
|
|
{
|
|
float* ptmp;
|
|
float tmp[PART_LEN2];
|
|
WebRtc_ReadBuffer(aecpc->far_pre_buf, (void**)&ptmp, tmp, PART_LEN2);
|
|
WebRtcAec_BufferFarendPartition(aecpc->aec, ptmp);
|
|
#ifdef WEBRTC_AEC_DEBUG_DUMP
|
|
WebRtc_WriteBuffer(
|
|
WebRtcAec_far_time_buf(aecpc->aec), &ptmp[PART_LEN], 1);
|
|
#endif
|
|
}
|
|
|
|
// Rewind |far_pre_buf| PART_LEN samples for overlap before continuing.
|
|
WebRtc_MoveReadPtr(aecpc->far_pre_buf, -PART_LEN);
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
int32_t WebRtcAec_Process(void* aecInst,
|
|
const float* nearend,
|
|
const float* nearendH,
|
|
float* out,
|
|
float* outH,
|
|
int16_t nrOfSamples,
|
|
int16_t msInSndCardBuf,
|
|
int32_t skew) {
|
|
aecpc_t* aecpc = aecInst;
|
|
int32_t retVal = 0;
|
|
if (nearend == NULL) {
|
|
aecpc->lastError = AEC_NULL_POINTER_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
if (out == NULL) {
|
|
aecpc->lastError = AEC_NULL_POINTER_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
if (aecpc->initFlag != initCheck) {
|
|
aecpc->lastError = AEC_UNINITIALIZED_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
// number of samples == 160 for SWB input
|
|
if (nrOfSamples != 80 && nrOfSamples != 160) {
|
|
aecpc->lastError = AEC_BAD_PARAMETER_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
// Check for valid pointers based on sampling rate
|
|
if (aecpc->sampFreq == 32000 && nearendH == NULL) {
|
|
aecpc->lastError = AEC_NULL_POINTER_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
if (msInSndCardBuf < 0) {
|
|
msInSndCardBuf = 0;
|
|
aecpc->lastError = AEC_BAD_PARAMETER_WARNING;
|
|
retVal = -1;
|
|
} else if (msInSndCardBuf > kMaxTrustedDelayMs) {
|
|
// The clamping is now done in ProcessExtended/Normal().
|
|
aecpc->lastError = AEC_BAD_PARAMETER_WARNING;
|
|
retVal = -1;
|
|
}
|
|
|
|
// This returns the value of aec->extended_filter_enabled.
|
|
if (WebRtcAec_delay_correction_enabled(aecpc->aec)) {
|
|
ProcessExtended(
|
|
aecpc, nearend, nearendH, out, outH, nrOfSamples, msInSndCardBuf, skew);
|
|
} else {
|
|
if (ProcessNormal(aecpc,
|
|
nearend,
|
|
nearendH,
|
|
out,
|
|
outH,
|
|
nrOfSamples,
|
|
msInSndCardBuf,
|
|
skew) != 0) {
|
|
retVal = -1;
|
|
}
|
|
}
|
|
|
|
#ifdef WEBRTC_AEC_DEBUG_DUMP
|
|
{
|
|
int16_t far_buf_size_ms = (int16_t)(WebRtcAec_system_delay(aecpc->aec) /
|
|
(sampMsNb * aecpc->rate_factor));
|
|
(void)fwrite(&far_buf_size_ms, 2, 1, aecpc->bufFile);
|
|
(void)fwrite(
|
|
&aecpc->knownDelay, sizeof(aecpc->knownDelay), 1, aecpc->delayFile);
|
|
}
|
|
#endif
|
|
|
|
return retVal;
|
|
}
|
|
|
|
int WebRtcAec_set_config(void* handle, AecConfig config) {
|
|
aecpc_t* self = (aecpc_t*)handle;
|
|
if (self->initFlag != initCheck) {
|
|
self->lastError = AEC_UNINITIALIZED_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
if (config.skewMode != kAecFalse && config.skewMode != kAecTrue) {
|
|
self->lastError = AEC_BAD_PARAMETER_ERROR;
|
|
return -1;
|
|
}
|
|
self->skewMode = config.skewMode;
|
|
|
|
if (config.nlpMode != kAecNlpConservative &&
|
|
config.nlpMode != kAecNlpModerate &&
|
|
config.nlpMode != kAecNlpAggressive) {
|
|
self->lastError = AEC_BAD_PARAMETER_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
if (config.metricsMode != kAecFalse && config.metricsMode != kAecTrue) {
|
|
self->lastError = AEC_BAD_PARAMETER_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
if (config.delay_logging != kAecFalse && config.delay_logging != kAecTrue) {
|
|
self->lastError = AEC_BAD_PARAMETER_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
WebRtcAec_SetConfigCore(
|
|
self->aec, config.nlpMode, config.metricsMode, config.delay_logging);
|
|
return 0;
|
|
}
|
|
|
|
int WebRtcAec_get_echo_status(void* handle, int* status) {
|
|
aecpc_t* self = (aecpc_t*)handle;
|
|
if (status == NULL) {
|
|
self->lastError = AEC_NULL_POINTER_ERROR;
|
|
return -1;
|
|
}
|
|
if (self->initFlag != initCheck) {
|
|
self->lastError = AEC_UNINITIALIZED_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
*status = WebRtcAec_echo_state(self->aec);
|
|
|
|
return 0;
|
|
}
|
|
|
|
int WebRtcAec_GetMetrics(void* handle, AecMetrics* metrics) {
|
|
const float kUpWeight = 0.7f;
|
|
float dtmp;
|
|
int stmp;
|
|
aecpc_t* self = (aecpc_t*)handle;
|
|
Stats erl;
|
|
Stats erle;
|
|
Stats a_nlp;
|
|
|
|
if (handle == NULL) {
|
|
return -1;
|
|
}
|
|
if (metrics == NULL) {
|
|
self->lastError = AEC_NULL_POINTER_ERROR;
|
|
return -1;
|
|
}
|
|
if (self->initFlag != initCheck) {
|
|
self->lastError = AEC_UNINITIALIZED_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
WebRtcAec_GetEchoStats(self->aec, &erl, &erle, &a_nlp);
|
|
|
|
// ERL
|
|
metrics->erl.instant = (int)erl.instant;
|
|
|
|
if ((erl.himean > kOffsetLevel) && (erl.average > kOffsetLevel)) {
|
|
// Use a mix between regular average and upper part average.
|
|
dtmp = kUpWeight * erl.himean + (1 - kUpWeight) * erl.average;
|
|
metrics->erl.average = (int)dtmp;
|
|
} else {
|
|
metrics->erl.average = kOffsetLevel;
|
|
}
|
|
|
|
metrics->erl.max = (int)erl.max;
|
|
|
|
if (erl.min < (kOffsetLevel * (-1))) {
|
|
metrics->erl.min = (int)erl.min;
|
|
} else {
|
|
metrics->erl.min = kOffsetLevel;
|
|
}
|
|
|
|
// ERLE
|
|
metrics->erle.instant = (int)erle.instant;
|
|
|
|
if ((erle.himean > kOffsetLevel) && (erle.average > kOffsetLevel)) {
|
|
// Use a mix between regular average and upper part average.
|
|
dtmp = kUpWeight * erle.himean + (1 - kUpWeight) * erle.average;
|
|
metrics->erle.average = (int)dtmp;
|
|
} else {
|
|
metrics->erle.average = kOffsetLevel;
|
|
}
|
|
|
|
metrics->erle.max = (int)erle.max;
|
|
|
|
if (erle.min < (kOffsetLevel * (-1))) {
|
|
metrics->erle.min = (int)erle.min;
|
|
} else {
|
|
metrics->erle.min = kOffsetLevel;
|
|
}
|
|
|
|
// RERL
|
|
if ((metrics->erl.average > kOffsetLevel) &&
|
|
(metrics->erle.average > kOffsetLevel)) {
|
|
stmp = metrics->erl.average + metrics->erle.average;
|
|
} else {
|
|
stmp = kOffsetLevel;
|
|
}
|
|
metrics->rerl.average = stmp;
|
|
|
|
// No other statistics needed, but returned for completeness.
|
|
metrics->rerl.instant = stmp;
|
|
metrics->rerl.max = stmp;
|
|
metrics->rerl.min = stmp;
|
|
|
|
// A_NLP
|
|
metrics->aNlp.instant = (int)a_nlp.instant;
|
|
|
|
if ((a_nlp.himean > kOffsetLevel) && (a_nlp.average > kOffsetLevel)) {
|
|
// Use a mix between regular average and upper part average.
|
|
dtmp = kUpWeight * a_nlp.himean + (1 - kUpWeight) * a_nlp.average;
|
|
metrics->aNlp.average = (int)dtmp;
|
|
} else {
|
|
metrics->aNlp.average = kOffsetLevel;
|
|
}
|
|
|
|
metrics->aNlp.max = (int)a_nlp.max;
|
|
|
|
if (a_nlp.min < (kOffsetLevel * (-1))) {
|
|
metrics->aNlp.min = (int)a_nlp.min;
|
|
} else {
|
|
metrics->aNlp.min = kOffsetLevel;
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
int WebRtcAec_GetDelayMetrics(void* handle, int* median, int* std) {
|
|
aecpc_t* self = handle;
|
|
if (median == NULL) {
|
|
self->lastError = AEC_NULL_POINTER_ERROR;
|
|
return -1;
|
|
}
|
|
if (std == NULL) {
|
|
self->lastError = AEC_NULL_POINTER_ERROR;
|
|
return -1;
|
|
}
|
|
if (self->initFlag != initCheck) {
|
|
self->lastError = AEC_UNINITIALIZED_ERROR;
|
|
return -1;
|
|
}
|
|
if (WebRtcAec_GetDelayMetricsCore(self->aec, median, std) == -1) {
|
|
// Logging disabled.
|
|
self->lastError = AEC_UNSUPPORTED_FUNCTION_ERROR;
|
|
return -1;
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
int32_t WebRtcAec_get_error_code(void* aecInst) {
|
|
aecpc_t* aecpc = aecInst;
|
|
return aecpc->lastError;
|
|
}
|
|
|
|
AecCore* WebRtcAec_aec_core(void* handle) {
|
|
if (!handle) {
|
|
return NULL;
|
|
}
|
|
return ((aecpc_t*)handle)->aec;
|
|
}
|
|
|
|
static int ProcessNormal(aecpc_t* aecpc,
|
|
const float* nearend,
|
|
const float* nearendH,
|
|
float* out,
|
|
float* outH,
|
|
int16_t nrOfSamples,
|
|
int16_t msInSndCardBuf,
|
|
int32_t skew) {
|
|
int retVal = 0;
|
|
short i;
|
|
short nBlocks10ms;
|
|
short nFrames;
|
|
// Limit resampling to doubling/halving of signal
|
|
const float minSkewEst = -0.5f;
|
|
const float maxSkewEst = 1.0f;
|
|
|
|
msInSndCardBuf =
|
|
msInSndCardBuf > kMaxTrustedDelayMs ? kMaxTrustedDelayMs : msInSndCardBuf;
|
|
// TODO(andrew): we need to investigate if this +10 is really wanted.
|
|
msInSndCardBuf += 10;
|
|
aecpc->msInSndCardBuf = msInSndCardBuf;
|
|
|
|
if (aecpc->skewMode == kAecTrue) {
|
|
if (aecpc->skewFrCtr < 25) {
|
|
aecpc->skewFrCtr++;
|
|
} else {
|
|
retVal = WebRtcAec_GetSkew(aecpc->resampler, skew, &aecpc->skew);
|
|
if (retVal == -1) {
|
|
aecpc->skew = 0;
|
|
aecpc->lastError = AEC_BAD_PARAMETER_WARNING;
|
|
}
|
|
|
|
aecpc->skew /= aecpc->sampFactor * nrOfSamples;
|
|
|
|
if (aecpc->skew < 1.0e-3 && aecpc->skew > -1.0e-3) {
|
|
aecpc->resample = kAecFalse;
|
|
} else {
|
|
aecpc->resample = kAecTrue;
|
|
}
|
|
|
|
if (aecpc->skew < minSkewEst) {
|
|
aecpc->skew = minSkewEst;
|
|
} else if (aecpc->skew > maxSkewEst) {
|
|
aecpc->skew = maxSkewEst;
|
|
}
|
|
|
|
#ifdef WEBRTC_AEC_DEBUG_DUMP
|
|
(void)fwrite(&aecpc->skew, sizeof(aecpc->skew), 1, aecpc->skewFile);
|
|
#endif
|
|
}
|
|
}
|
|
|
|
nFrames = nrOfSamples / FRAME_LEN;
|
|
nBlocks10ms = nFrames / aecpc->rate_factor;
|
|
|
|
if (aecpc->startup_phase) {
|
|
// Only needed if they don't already point to the same place.
|
|
if (nearend != out) {
|
|
memcpy(out, nearend, sizeof(*out) * nrOfSamples);
|
|
}
|
|
if (nearendH != outH) {
|
|
memcpy(outH, nearendH, sizeof(*outH) * nrOfSamples);
|
|
}
|
|
|
|
// The AEC is in the start up mode
|
|
// AEC is disabled until the system delay is OK
|
|
|
|
// Mechanism to ensure that the system delay is reasonably stable.
|
|
if (aecpc->checkBuffSize) {
|
|
aecpc->checkBufSizeCtr++;
|
|
// Before we fill up the far-end buffer we require the system delay
|
|
// to be stable (+/-8 ms) compared to the first value. This
|
|
// comparison is made during the following 6 consecutive 10 ms
|
|
// blocks. If it seems to be stable then we start to fill up the
|
|
// far-end buffer.
|
|
if (aecpc->counter == 0) {
|
|
aecpc->firstVal = aecpc->msInSndCardBuf;
|
|
aecpc->sum = 0;
|
|
}
|
|
|
|
if (abs(aecpc->firstVal - aecpc->msInSndCardBuf) <
|
|
WEBRTC_SPL_MAX(0.2 * aecpc->msInSndCardBuf, sampMsNb)) {
|
|
aecpc->sum += aecpc->msInSndCardBuf;
|
|
aecpc->counter++;
|
|
} else {
|
|
aecpc->counter = 0;
|
|
}
|
|
|
|
if (aecpc->counter * nBlocks10ms >= 6) {
|
|
// The far-end buffer size is determined in partitions of
|
|
// PART_LEN samples. Use 75% of the average value of the system
|
|
// delay as buffer size to start with.
|
|
aecpc->bufSizeStart =
|
|
WEBRTC_SPL_MIN((3 * aecpc->sum * aecpc->rate_factor * 8) /
|
|
(4 * aecpc->counter * PART_LEN),
|
|
kMaxBufSizeStart);
|
|
// Buffer size has now been determined.
|
|
aecpc->checkBuffSize = 0;
|
|
}
|
|
|
|
if (aecpc->checkBufSizeCtr * nBlocks10ms > 50) {
|
|
// For really bad systems, don't disable the echo canceller for
|
|
// more than 0.5 sec.
|
|
aecpc->bufSizeStart = WEBRTC_SPL_MIN(
|
|
(aecpc->msInSndCardBuf * aecpc->rate_factor * 3) / 40,
|
|
kMaxBufSizeStart);
|
|
aecpc->checkBuffSize = 0;
|
|
}
|
|
}
|
|
|
|
// If |checkBuffSize| changed in the if-statement above.
|
|
if (!aecpc->checkBuffSize) {
|
|
// The system delay is now reasonably stable (or has been unstable
|
|
// for too long). When the far-end buffer is filled with
|
|
// approximately the same amount of data as reported by the system
|
|
// we end the startup phase.
|
|
int overhead_elements =
|
|
WebRtcAec_system_delay(aecpc->aec) / PART_LEN - aecpc->bufSizeStart;
|
|
if (overhead_elements == 0) {
|
|
// Enable the AEC
|
|
aecpc->startup_phase = 0;
|
|
} else if (overhead_elements > 0) {
|
|
// TODO(bjornv): Do we need a check on how much we actually
|
|
// moved the read pointer? It should always be possible to move
|
|
// the pointer |overhead_elements| since we have only added data
|
|
// to the buffer and no delay compensation nor AEC processing
|
|
// has been done.
|
|
WebRtcAec_MoveFarReadPtr(aecpc->aec, overhead_elements);
|
|
|
|
// Enable the AEC
|
|
aecpc->startup_phase = 0;
|
|
}
|
|
}
|
|
} else {
|
|
// AEC is enabled.
|
|
if (WebRtcAec_reported_delay_enabled(aecpc->aec)) {
|
|
EstBufDelayNormal(aecpc);
|
|
}
|
|
|
|
// Note that 1 frame is supported for NB and 2 frames for WB.
|
|
for (i = 0; i < nFrames; i++) {
|
|
// Call the AEC.
|
|
WebRtcAec_ProcessFrame(aecpc->aec,
|
|
&nearend[FRAME_LEN * i],
|
|
&nearendH[FRAME_LEN * i],
|
|
aecpc->knownDelay,
|
|
&out[FRAME_LEN * i],
|
|
&outH[FRAME_LEN * i]);
|
|
// TODO(bjornv): Re-structure such that we don't have to pass
|
|
// |aecpc->knownDelay| as input. Change name to something like
|
|
// |system_buffer_diff|.
|
|
}
|
|
}
|
|
|
|
return retVal;
|
|
}
|
|
|
|
static void ProcessExtended(aecpc_t* self,
|
|
const float* near,
|
|
const float* near_high,
|
|
float* out,
|
|
float* out_high,
|
|
int16_t num_samples,
|
|
int16_t reported_delay_ms,
|
|
int32_t skew) {
|
|
int i;
|
|
const int num_frames = num_samples / FRAME_LEN;
|
|
const int delay_diff_offset = kDelayDiffOffsetSamples;
|
|
#if defined(WEBRTC_UNTRUSTED_DELAY)
|
|
reported_delay_ms = kFixedDelayMs;
|
|
#else
|
|
// This is the usual mode where we trust the reported system delay values.
|
|
// Due to the longer filter, we no longer add 10 ms to the reported delay
|
|
// to reduce chance of non-causality. Instead we apply a minimum here to avoid
|
|
// issues with the read pointer jumping around needlessly.
|
|
reported_delay_ms = reported_delay_ms < kMinTrustedDelayMs
|
|
? kMinTrustedDelayMs
|
|
: reported_delay_ms;
|
|
// If the reported delay appears to be bogus, we attempt to recover by using
|
|
// the measured fixed delay values. We use >= here because higher layers
|
|
// may already clamp to this maximum value, and we would otherwise not
|
|
// detect it here.
|
|
reported_delay_ms = reported_delay_ms >= kMaxTrustedDelayMs
|
|
? kFixedDelayMs
|
|
: reported_delay_ms;
|
|
#endif
|
|
self->msInSndCardBuf = reported_delay_ms;
|
|
|
|
if (!self->farend_started) {
|
|
// Only needed if they don't already point to the same place.
|
|
if (near != out) {
|
|
memcpy(out, near, sizeof(*out) * num_samples);
|
|
}
|
|
if (near_high != out_high) {
|
|
memcpy(out_high, near_high, sizeof(*out_high) * num_samples);
|
|
}
|
|
return;
|
|
}
|
|
if (self->startup_phase) {
|
|
// In the extended mode, there isn't a startup "phase", just a special
|
|
// action on the first frame. In the trusted delay case, we'll take the
|
|
// current reported delay, unless it's less then our conservative
|
|
// measurement.
|
|
int startup_size_ms =
|
|
reported_delay_ms < kFixedDelayMs ? kFixedDelayMs : reported_delay_ms;
|
|
int overhead_elements = (WebRtcAec_system_delay(self->aec) -
|
|
startup_size_ms / 2 * self->rate_factor * 8) /
|
|
PART_LEN;
|
|
WebRtcAec_MoveFarReadPtr(self->aec, overhead_elements);
|
|
self->startup_phase = 0;
|
|
}
|
|
|
|
if (WebRtcAec_reported_delay_enabled(self->aec)) {
|
|
EstBufDelayExtended(self);
|
|
}
|
|
|
|
{
|
|
// |delay_diff_offset| gives us the option to manually rewind the delay on
|
|
// very low delay platforms which can't be expressed purely through
|
|
// |reported_delay_ms|.
|
|
const int adjusted_known_delay =
|
|
WEBRTC_SPL_MAX(0, self->knownDelay + delay_diff_offset);
|
|
|
|
for (i = 0; i < num_frames; ++i) {
|
|
WebRtcAec_ProcessFrame(self->aec,
|
|
&near[FRAME_LEN * i],
|
|
&near_high[FRAME_LEN * i],
|
|
adjusted_known_delay,
|
|
&out[FRAME_LEN * i],
|
|
&out_high[FRAME_LEN * i]);
|
|
}
|
|
}
|
|
}
|
|
|
|
static void EstBufDelayNormal(aecpc_t* aecpc) {
|
|
int nSampSndCard = aecpc->msInSndCardBuf * sampMsNb * aecpc->rate_factor;
|
|
int current_delay = nSampSndCard - WebRtcAec_system_delay(aecpc->aec);
|
|
int delay_difference = 0;
|
|
|
|
// Before we proceed with the delay estimate filtering we:
|
|
// 1) Compensate for the frame that will be read.
|
|
// 2) Compensate for drift resampling.
|
|
// 3) Compensate for non-causality if needed, since the estimated delay can't
|
|
// be negative.
|
|
|
|
// 1) Compensating for the frame(s) that will be read/processed.
|
|
current_delay += FRAME_LEN * aecpc->rate_factor;
|
|
|
|
// 2) Account for resampling frame delay.
|
|
if (aecpc->skewMode == kAecTrue && aecpc->resample == kAecTrue) {
|
|
current_delay -= kResamplingDelay;
|
|
}
|
|
|
|
// 3) Compensate for non-causality, if needed, by flushing one block.
|
|
if (current_delay < PART_LEN) {
|
|
current_delay += WebRtcAec_MoveFarReadPtr(aecpc->aec, 1) * PART_LEN;
|
|
}
|
|
|
|
// We use -1 to signal an initialized state in the "extended" implementation;
|
|
// compensate for that.
|
|
aecpc->filtDelay = aecpc->filtDelay < 0 ? 0 : aecpc->filtDelay;
|
|
aecpc->filtDelay =
|
|
WEBRTC_SPL_MAX(0, (short)(0.8 * aecpc->filtDelay + 0.2 * current_delay));
|
|
|
|
delay_difference = aecpc->filtDelay - aecpc->knownDelay;
|
|
if (delay_difference > 224) {
|
|
if (aecpc->lastDelayDiff < 96) {
|
|
aecpc->timeForDelayChange = 0;
|
|
} else {
|
|
aecpc->timeForDelayChange++;
|
|
}
|
|
} else if (delay_difference < 96 && aecpc->knownDelay > 0) {
|
|
if (aecpc->lastDelayDiff > 224) {
|
|
aecpc->timeForDelayChange = 0;
|
|
} else {
|
|
aecpc->timeForDelayChange++;
|
|
}
|
|
} else {
|
|
aecpc->timeForDelayChange = 0;
|
|
}
|
|
aecpc->lastDelayDiff = delay_difference;
|
|
|
|
if (aecpc->timeForDelayChange > 25) {
|
|
aecpc->knownDelay = WEBRTC_SPL_MAX((int)aecpc->filtDelay - 160, 0);
|
|
}
|
|
}
|
|
|
|
static void EstBufDelayExtended(aecpc_t* self) {
|
|
int reported_delay = self->msInSndCardBuf * sampMsNb * self->rate_factor;
|
|
int current_delay = reported_delay - WebRtcAec_system_delay(self->aec);
|
|
int delay_difference = 0;
|
|
|
|
// Before we proceed with the delay estimate filtering we:
|
|
// 1) Compensate for the frame that will be read.
|
|
// 2) Compensate for drift resampling.
|
|
// 3) Compensate for non-causality if needed, since the estimated delay can't
|
|
// be negative.
|
|
|
|
// 1) Compensating for the frame(s) that will be read/processed.
|
|
current_delay += FRAME_LEN * self->rate_factor;
|
|
|
|
// 2) Account for resampling frame delay.
|
|
if (self->skewMode == kAecTrue && self->resample == kAecTrue) {
|
|
current_delay -= kResamplingDelay;
|
|
}
|
|
|
|
// 3) Compensate for non-causality, if needed, by flushing two blocks.
|
|
if (current_delay < PART_LEN) {
|
|
current_delay += WebRtcAec_MoveFarReadPtr(self->aec, 2) * PART_LEN;
|
|
}
|
|
|
|
if (self->filtDelay == -1) {
|
|
self->filtDelay = WEBRTC_SPL_MAX(0, 0.5 * current_delay);
|
|
} else {
|
|
self->filtDelay = WEBRTC_SPL_MAX(
|
|
0, (short)(0.95 * self->filtDelay + 0.05 * current_delay));
|
|
}
|
|
|
|
delay_difference = self->filtDelay - self->knownDelay;
|
|
if (delay_difference > 384) {
|
|
if (self->lastDelayDiff < 128) {
|
|
self->timeForDelayChange = 0;
|
|
} else {
|
|
self->timeForDelayChange++;
|
|
}
|
|
} else if (delay_difference < 128 && self->knownDelay > 0) {
|
|
if (self->lastDelayDiff > 384) {
|
|
self->timeForDelayChange = 0;
|
|
} else {
|
|
self->timeForDelayChange++;
|
|
}
|
|
} else {
|
|
self->timeForDelayChange = 0;
|
|
}
|
|
self->lastDelayDiff = delay_difference;
|
|
|
|
if (self->timeForDelayChange > 25) {
|
|
self->knownDelay = WEBRTC_SPL_MAX((int)self->filtDelay - 256, 0);
|
|
}
|
|
}
|