echo_steve.c File Reference

#include <inttypes.h>
#include <stdlib.h>
#include "floating_fudge.h"
#include <string.h>
#include <stdio.h>
#include "spandsp/telephony.h"
#include "spandsp/logging.h"
#include "spandsp/dc_restore.h"
#include "spandsp/saturated.h"
#include "spandsp/bit_operations.h"
#include "spandsp/echo.h"

Defines
#define	NULL   (void *) 0
#define	NONUPDATE_DWELL_TIME   600
#define	MIN_TX_POWER_FOR_ADAPTION   64*64
#define	MIN_RX_POWER_FOR_ADAPTION   64*64
Functions
echo_can_state_t *	echo_can_create (int len, int adaption_mode)
void	echo_can_free (echo_can_state_t *ec)
void	echo_can_adaption_mode (echo_can_state_t *ec, int adaption_mode)
void	echo_can_flush (echo_can_state_t *ec)
void	echo_can_snapshot (echo_can_state_t *ec)
int16_t	echo_can_update (echo_can_state_t *ec, int16_t tx, int16_t rx)
int16_t	echo_can_hpf_tx (echo_can_state_t *ec, int16_t tx)
Variables
int	sample_no = 0

---

Detailed Description

---

Function Documentation

void echo_can_adaption_mode	(	echo_can_state_t *	ec,
		int	adaption_mode
	)

Set the adaption mode of a voice echo canceller context.

Parameters:

	ec	The echo canceller context.
	adaption_mode	The mode.

References echo_can_state_t::adaption_mode.

echo_can_state_t* echo_can_create	(	int	len,
		int	adaption_mode
	)

Create a voice echo canceller context.

Parameters:

len

The length of the canceller, in samples.

Returns:

The new canceller context, or NULL if the canceller could not be created.

References echo_can_state_t::cng_level, echo_can_state_t::curr_pos, echo_can_state_t::dtd_onset, echo_can_adaption_mode(), echo_can_state_t::fir_state, echo_can_state_t::fir_taps16, echo_can_state_t::fir_taps32, echo_can_state_t::geigel_lag, echo_can_state_t::geigel_max, echo_can_state_t::rx_power_threshold, echo_can_state_t::tap_mask, echo_can_state_t::tap_rotate_counter, echo_can_state_t::tap_set, and echo_can_state_t::taps.

void echo_can_flush

(

echo_can_state_t *

ec

)

Flush (reinitialise) a voice echo canceller context.

Parameters:

ec

The echo canceller context.

References echo_can_state_t::clean_rx_power, echo_can_state_t::cng_filter, echo_can_state_t::cng_level, echo_can_state_t::curr_pos, fir16_state_t::curr_pos, echo_can_state_t::dtd_onset, echo_can_state_t::fir_state, echo_can_state_t::fir_taps16, echo_can_state_t::fir_taps32, echo_can_state_t::geigel_lag, echo_can_state_t::geigel_max, echo_can_state_t::last_acf, echo_can_state_t::latest_correction, echo_can_state_t::narrowband_count, echo_can_state_t::narrowband_score, echo_can_state_t::nonupdate_dwell, echo_can_state_t::rx_power, echo_can_state_t::supp1, echo_can_state_t::supp2, echo_can_state_t::supp_test1, echo_can_state_t::supp_test2, echo_can_state_t::tap_rotate_counter, echo_can_state_t::tap_set, echo_can_state_t::taps, echo_can_state_t::tx_power, and echo_can_state_t::vad.

void echo_can_free

(

echo_can_state_t *

ec

)

Free a voice echo canceller context.

Parameters:

ec

The echo canceller context.

References echo_can_state_t::fir_state, echo_can_state_t::fir_taps16, and echo_can_state_t::fir_taps32.

int16_t echo_can_hpf_tx	(	echo_can_state_t *	ec,
		int16_t	tx
	)

Process to high pass filter the tx signal.

Parameters:

	ec	The echo canceller context.
	tx	The transmitted auio sample.

Returns:

The HP filtered transmit sample, send this to your D/A.

References echo_can_state_t::adaption_mode, and echo_can_state_t::tx_hpf.

int16_t echo_can_update	(	echo_can_state_t *	ec,
		int16_t	tx,
		int16_t	rx
	)

Process a sample through a voice echo canceller.

Parameters:

	ec	The echo canceller context.
	tx	The transmitted audio sample.
	rx	The received audio sample.

Returns:

The clean (echo cancelled) received sample.

References echo_can_state_t::adaption_mode, echo_can_state_t::clean_rx_power, echo_can_state_t::cng, echo_can_state_t::cng_filter, echo_can_state_t::cng_level, echo_can_state_t::cng_rndnum, fir16_state_t::coeffs, echo_can_state_t::curr_pos, echo_can_state_t::dtd_onset, echo_can_state_t::fir_state, echo_can_state_t::fir_taps16, echo_can_state_t::fir_taps32, fir16_state_t::history, echo_can_state_t::latest_correction, echo_can_state_t::narrowband_count, echo_can_state_t::narrowband_score, echo_can_state_t::nonupdate_dwell, echo_can_state_t::rx_hpf, echo_can_state_t::rx_power, echo_can_state_t::supp1, echo_can_state_t::supp2, echo_can_state_t::supp_test1, echo_can_state_t::supp_test2, echo_can_state_t::tap_mask, echo_can_state_t::tap_rotate_counter, echo_can_state_t::tap_set, echo_can_state_t::taps, echo_can_state_t::tx_power, and echo_can_state_t::vad.