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