1
/* $Id: audiotest.h 2506 2009-03-12 18:11:37Z bennylp $ */
3
* Copyright (C) 2008-2009 Teluu Inc. (http://www.teluu.com)
4
* Copyright (C) 2003-2008 Benny Prijono <benny@prijono.org>
6
* This program is free software; you can redistribute it and/or modify
7
* it under the terms of the GNU General Public License as published by
8
* the Free Software Foundation; either version 2 of the License, or
9
* (at your option) any later version.
11
* This program is distributed in the hope that it will be useful,
12
* but WITHOUT ANY WARRANTY; without even the implied warranty of
13
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14
* GNU General Public License for more details.
16
* You should have received a copy of the GNU General Public License
17
* along with this program; if not, write to the Free Software
18
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20
* Additional permission under GNU GPL version 3 section 7:
22
* If you modify this program, or any covered work, by linking or
23
* combining it with the OpenSSL project's OpenSSL library (or a
24
* modified version of that library), containing parts covered by the
25
* terms of the OpenSSL or SSLeay licenses, Teluu Inc. (http://www.teluu.com)
26
* grants you additional permission to convey the resulting work.
27
* Corresponding Source for a non-source form of such a combination
28
* shall include the source code for the parts of OpenSSL used as well
29
* as that of the covered work.
31
#ifndef __PJMEDIA_AUDIODEV_AUDIOTEST_H__
32
#define __PJMEDIA_AUDIODEV_AUDIOTEST_H__
36
* @brief Audio test utility.
38
#include <pjmedia-audiodev/audiodev.h>
44
* @defgroup s30_audio_test_utility Audio tests utility.
45
* @ingroup audio_device_api
46
* @brief Audio test utility.
51
* Statistic for each direction.
53
typedef struct pjmedia_aud_test_stat
56
* Number of frames processed during the test.
61
* Minimum inter-frame arrival time, in milliseconds
63
unsigned min_interval;
66
* Maximum inter-frame arrival time, in milliseconds
68
unsigned max_interval;
71
* Average inter-frame arrival time, in milliseconds
73
unsigned avg_interval;
76
* Standard deviation of inter-frame arrival time, in milliseconds
78
unsigned dev_interval;
81
* Maximum number of frame burst
85
} pjmedia_aud_test_stat;
91
typedef struct pjmedia_aud_test_results
94
* Recording statistic.
96
pjmedia_aud_test_stat rec;
101
pjmedia_aud_test_stat play;
104
* Clock drifts per second, in samples. Positive number indicates rec
105
* device is running faster than playback device.
107
pj_int32_t rec_drift_per_sec;
109
} pjmedia_aud_test_results;
113
* Perform audio device testing.
115
PJ_DECL(pj_status_t) pjmedia_aud_test(const pjmedia_aud_param *param,
116
pjmedia_aud_test_results *result);
125
#endif /* __PJMEDIA_AUDIODEV_AUDIOTEST_H__ */