2 This file is part of PulseAudio.
4 Copyright 2010 Arun Raghavan <arun.raghavan@collabora.co.uk>
6 PulseAudio is free software; you can redistribute it and/or modify
7 it under the terms of the GNU Lesser General Public License as published
8 by the Free Software Foundation; either version 2.1 of the License,
9 or (at your option) any later version.
11 PulseAudio is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 General Public License for more details.
16 You should have received a copy of the GNU Lesser General Public License
17 along with PulseAudio; if not, write to the Free Software
18 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
22 #ifndef fooechocancelhfoo
23 #define fooechocancelhfoo
29 #include <pulse/sample.h>
30 #include <pulse/channelmap.h>
31 #include <pulsecore/core.h>
32 #include <pulsecore/macro.h>
35 #include <speex/speex_echo.h>
36 #include <speex/speex_preprocess.h>
41 /* Common data structures */
43 typedef struct pa_echo_canceller_msg pa_echo_canceller_msg;
45 typedef struct pa_echo_canceller_params pa_echo_canceller_params;
47 struct pa_echo_canceller_params {
51 SpeexEchoState *state;
52 SpeexPreprocessState *pp_state;
61 /* This is a void* so that we don't have to convert this whole file
62 * to C++ linkage. apm is a pointer to an AudioProcessing object */
65 pa_sample_spec sample_spec;
69 /* each canceller-specific structure goes here */
72 /* Set this if canceller can do drift compensation. Also see set_drift()
74 pa_bool_t drift_compensation;
77 typedef struct pa_echo_canceller pa_echo_canceller;
79 struct pa_echo_canceller {
80 /* Initialise canceller engine. */
81 pa_bool_t (*init) (pa_core *c,
82 pa_echo_canceller *ec,
83 pa_sample_spec *source_ss,
84 pa_channel_map *source_map,
85 pa_sample_spec *sink_ss,
86 pa_channel_map *sink_map,
90 /* You should have only one of play()+record() or run() set. The first
91 * works under the assumption that you'll handle buffering and matching up
92 * samples yourself. If you set run(), module-echo-cancel will handle
93 * synchronising the playback and record streams. */
95 /* Feed the engine 'blocksize' playback bytes.. */
96 void (*play) (pa_echo_canceller *ec, const uint8_t *play);
97 /* Feed the engine 'blocksize' record bytes. blocksize processed bytes are
99 void (*record) (pa_echo_canceller *ec, const uint8_t *rec, uint8_t *out);
100 /* Feed the engine blocksize playback and record streams, with a reasonable
101 * effort at keeping the two in sync. blocksize processed bytes are
102 * returned in out. */
103 void (*run) (pa_echo_canceller *ec, const uint8_t *rec, const uint8_t *play, uint8_t *out);
105 /* Optional callback to set the drift, expressed as the ratio of the
106 * difference in number of playback and capture samples to the number of
107 * capture samples, for some instant of time. This is used only if the
108 * canceller signals that it supports drift compensation, and is called
109 * before record(). The actual implementation needs to derive drift based
110 * on point samples -- the individual values are not accurate enough to use
112 /* NOTE: the semantics of this function might change in the future. */
113 void (*set_drift) (pa_echo_canceller *ec, float drift);
115 /* Free up resources. */
116 void (*done) (pa_echo_canceller *ec);
118 /* Structure with common and engine-specific canceller parameters. */
119 pa_echo_canceller_params params;
121 /* msgobject that can be used to send messages back to the main thread */
122 pa_echo_canceller_msg *msg;
125 /* Functions to be used by the canceller analog gain control routines */
126 void pa_echo_canceller_get_capture_volume(pa_echo_canceller *ec, pa_cvolume *v);
127 void pa_echo_canceller_set_capture_volume(pa_echo_canceller *ec, pa_cvolume *v);
130 /* Speex canceller functions */
131 pa_bool_t pa_speex_ec_init(pa_core *c, pa_echo_canceller *ec,
132 pa_sample_spec *source_ss, pa_channel_map *source_map,
133 pa_sample_spec *sink_ss, pa_channel_map *sink_map,
134 uint32_t *blocksize, const char *args);
135 void pa_speex_ec_run(pa_echo_canceller *ec, const uint8_t *rec, const uint8_t *play, uint8_t *out);
136 void pa_speex_ec_done(pa_echo_canceller *ec);
139 /* Adrian Andre's echo canceller */
140 pa_bool_t pa_adrian_ec_init(pa_core *c, pa_echo_canceller *ec,
141 pa_sample_spec *source_ss, pa_channel_map *source_map,
142 pa_sample_spec *sink_ss, pa_channel_map *sink_map,
143 uint32_t *blocksize, const char *args);
144 void pa_adrian_ec_run(pa_echo_canceller *ec, const uint8_t *rec, const uint8_t *play, uint8_t *out);
145 void pa_adrian_ec_done(pa_echo_canceller *ec);
148 /* WebRTC canceller functions */
150 pa_bool_t pa_webrtc_ec_init(pa_core *c, pa_echo_canceller *ec,
151 pa_sample_spec *source_ss, pa_channel_map *source_map,
152 pa_sample_spec *sink_ss, pa_channel_map *sink_map,
153 uint32_t *blocksize, const char *args);
154 void pa_webrtc_ec_play(pa_echo_canceller *ec, const uint8_t *play);
155 void pa_webrtc_ec_record(pa_echo_canceller *ec, const uint8_t *rec, uint8_t *out);
156 void pa_webrtc_ec_set_drift(pa_echo_canceller *ec, float drift);
157 void pa_webrtc_ec_run(pa_echo_canceller *ec, const uint8_t *rec, const uint8_t *play, uint8_t *out);
158 void pa_webrtc_ec_done(pa_echo_canceller *ec);
162 #endif /* fooechocancelhfoo */