1/*
2** Copyright 2011, The Android Open-Source Project
3**
4** Licensed under the Apache License, Version 2.0 (the "License");
5** you may not use this file except in compliance with the License.
6** You may obtain a copy of the License at
7**
8**     http://www.apache.org/licenses/LICENSE-2.0
9**
10** Unless required by applicable law or agreed to in writing, software
11** distributed under the License is distributed on an "AS IS" BASIS,
12** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13** See the License for the specific language governing permissions and
14** limitations under the License.
15*/
16
17#ifndef ANDROID_ECHO_REFERENCE_H
18#define ANDROID_ECHO_REFERENCE_H
19
20#include <stdint.h>
21#include <sys/time.h>
22
23__BEGIN_DECLS
24
25/** Buffer descriptor used by read() and write() methods, including the time stamp and delay. */
26struct echo_reference_buffer {
27    void *raw;                  // pointer to audio frame
28    size_t frame_count;         // number of frames in buffer
29    int32_t delay_ns;           // delay for this buffer (see comment below)
30    struct timespec time_stamp; // time stamp for this buffer (see comment below)
31                                // default ALSA gettimeofday() format
32};
33
34/**
35 * + as input:
36 *      - delay_ns is the delay introduced by playback buffers
37 *      - time_stamp is the time stamp corresponding to the delay calculation
38 * + as output:
39 *      unused
40 * when used for EchoReference::read():
41 * + as input:
42 *      - delay_ns is the delay introduced by capture buffers
43 *      - time_stamp is the time stamp corresponding to the delay calculation
44 * + as output:
45 *      - delay_ns is the delay between the returned frames and the capture time derived from
46 *      delay and time stamp indicated as input. This delay is to be communicated to the AEC.
47 *      - frame_count is updated with the actual number of frames returned
48 */
49
50struct echo_reference_itfe {
51    int (*read)(struct echo_reference_itfe *echo_reference, struct echo_reference_buffer *buffer);
52    int (*write)(struct echo_reference_itfe *echo_reference, struct echo_reference_buffer *buffer);
53};
54
55int create_echo_reference(audio_format_t rdFormat,
56                          uint32_t rdChannelCount,
57                          uint32_t rdSamplingRate,
58                          audio_format_t wrFormat,
59                          uint32_t wrChannelCount,
60                          uint32_t wrSamplingRate,
61                          struct echo_reference_itfe **);
62
63void release_echo_reference(struct echo_reference_itfe *echo_reference);
64
65__END_DECLS
66
67#endif // ANDROID_ECHO_REFERENCE_H
68