Chris@39: /** @file patest_sync.c Chris@39: @ingroup test_src Chris@39: @brief Test time stamping and synchronization of audio and video. Chris@39: Chris@39: A high latency is used so we can hear the difference in time. Chris@39: Random durations are used so we know we are hearing the right beep Chris@39: and not the one before or after. Chris@39: Chris@39: Sequence of events: Chris@39: -# Foreground requests a beep. Chris@39: -# Background randomly schedules a beep. Chris@39: -# Foreground waits for the beep to be heard based on PaUtil_GetTime(). Chris@39: -# Foreground outputs video (printf) in sync with audio. Chris@39: -# Repeat. Chris@39: Chris@39: @author Phil Burk http://www.softsynth.com Chris@39: */ Chris@39: /* Chris@39: * $Id: patest_sync.c 1368 2008-03-01 00:38:27Z rossb $ Chris@39: * Chris@39: * This program uses the PortAudio Portable Audio Library. Chris@39: * For more information see: http://www.portaudio.com Chris@39: * Copyright (c) 1999-2000 Ross Bencina and Phil Burk Chris@39: * Chris@39: * Permission is hereby granted, free of charge, to any person obtaining Chris@39: * a copy of this software and associated documentation files Chris@39: * (the "Software"), to deal in the Software without restriction, Chris@39: * including without limitation the rights to use, copy, modify, merge, Chris@39: * publish, distribute, sublicense, and/or sell copies of the Software, Chris@39: * and to permit persons to whom the Software is furnished to do so, Chris@39: * subject to the following conditions: Chris@39: * Chris@39: * The above copyright notice and this permission notice shall be Chris@39: * included in all copies or substantial portions of the Software. Chris@39: * Chris@39: * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, Chris@39: * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF Chris@39: * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. Chris@39: * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR Chris@39: * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF Chris@39: * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION Chris@39: * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. Chris@39: */ Chris@39: Chris@39: /* Chris@39: * The text above constitutes the entire PortAudio license; however, Chris@39: * the PortAudio community also makes the following non-binding requests: Chris@39: * Chris@39: * Any person wishing to distribute modifications to the Software is Chris@39: * requested to send the modifications to the original developer so that Chris@39: * they can be incorporated into the canonical version. It is also Chris@39: * requested that these non-binding requests be included along with the Chris@39: * license above. Chris@39: */ Chris@39: Chris@39: #include Chris@39: #include Chris@39: #include "portaudio.h" Chris@39: #include "pa_util.h" Chris@39: #define NUM_BEEPS (6) Chris@39: #define SAMPLE_RATE (44100) Chris@39: #define SAMPLE_PERIOD (1.0/44100.0) Chris@39: #define FRAMES_PER_BUFFER (256) Chris@39: #define BEEP_DURATION (400) Chris@39: #define LATENCY_MSEC (2000) Chris@39: #define SLEEP_MSEC (10) Chris@39: #define TIMEOUT_MSEC (15000) Chris@39: Chris@39: #define STATE_BKG_IDLE (0) Chris@39: #define STATE_BKG_PENDING (1) Chris@39: #define STATE_BKG_BEEPING (2) Chris@39: typedef struct Chris@39: { Chris@39: float left_phase; Chris@39: float right_phase; Chris@39: int state; Chris@39: volatile int requestBeep; /* Set by foreground, cleared by background. */ Chris@39: PaTime beepTime; Chris@39: int beepCount; Chris@39: double latency; /* For debugging. */ Chris@39: } Chris@39: paTestData; Chris@39: Chris@39: static unsigned long GenerateRandomNumber( void ); Chris@39: /************************************************************/ Chris@39: /* Calculate pseudo-random 32 bit number based on linear congruential method. */ Chris@39: static unsigned long GenerateRandomNumber( void ) Chris@39: { Chris@39: static unsigned long randSeed = 99887766; /* Change this for different random sequences. */ Chris@39: randSeed = (randSeed * 196314165) + 907633515; Chris@39: return randSeed; Chris@39: } Chris@39: Chris@39: /* This routine will be called by the PortAudio engine when audio is needed. Chris@39: ** It may called at interrupt level on some machines so don't do anything Chris@39: ** that could mess up the system like calling malloc() or free(). Chris@39: */ Chris@39: static int patestCallback( const void *inputBuffer, void *outputBuffer, Chris@39: unsigned long framesPerBuffer, Chris@39: const PaStreamCallbackTimeInfo *timeInfo, Chris@39: PaStreamCallbackFlags statusFlags, void *userData ) Chris@39: { Chris@39: /* Cast data passed through stream to our structure. */ Chris@39: paTestData *data = (paTestData*)userData; Chris@39: float *out = (float*)outputBuffer; Chris@39: unsigned int i; Chris@39: (void) inputBuffer; Chris@39: Chris@39: data->latency = timeInfo->outputBufferDacTime - timeInfo->currentTime; Chris@39: Chris@39: for( i=0; istate ) Chris@39: { Chris@39: case STATE_BKG_IDLE: Chris@39: /* Schedule beep at some random time in the future. */ Chris@39: if( data->requestBeep ) Chris@39: { Chris@39: int random = GenerateRandomNumber() >> 14; Chris@39: data->beepTime = timeInfo->outputBufferDacTime + (( (double)(random + SAMPLE_RATE)) * SAMPLE_PERIOD ); Chris@39: data->state = STATE_BKG_PENDING; Chris@39: } Chris@39: *out++ = 0.0; /* left */ Chris@39: *out++ = 0.0; /* right */ Chris@39: break; Chris@39: Chris@39: case STATE_BKG_PENDING: Chris@39: if( (timeInfo->outputBufferDacTime + (i*SAMPLE_PERIOD)) >= data->beepTime ) Chris@39: { Chris@39: data->state = STATE_BKG_BEEPING; Chris@39: data->beepCount = BEEP_DURATION; Chris@39: data->left_phase = data->right_phase = 0.0; Chris@39: } Chris@39: *out++ = 0.0; /* left */ Chris@39: *out++ = 0.0; /* right */ Chris@39: break; Chris@39: Chris@39: case STATE_BKG_BEEPING: Chris@39: if( data->beepCount <= 0 ) Chris@39: { Chris@39: data->state = STATE_BKG_IDLE; Chris@39: data->requestBeep = 0; Chris@39: *out++ = 0.0; /* left */ Chris@39: *out++ = 0.0; /* right */ Chris@39: } Chris@39: else Chris@39: { Chris@39: /* Play sawtooth wave. */ Chris@39: *out++ = data->left_phase; /* left */ Chris@39: *out++ = data->right_phase; /* right */ Chris@39: /* Generate simple sawtooth phaser that ranges between -1.0 and 1.0. */ Chris@39: data->left_phase += 0.01f; Chris@39: /* When signal reaches top, drop back down. */ Chris@39: if( data->left_phase >= 1.0f ) data->left_phase -= 2.0f; Chris@39: /* higher pitch so we can distinguish left and right. */ Chris@39: data->right_phase += 0.03f; Chris@39: if( data->right_phase >= 1.0f ) data->right_phase -= 2.0f; Chris@39: } Chris@39: data->beepCount -= 1; Chris@39: break; Chris@39: Chris@39: default: Chris@39: data->state = STATE_BKG_IDLE; Chris@39: break; Chris@39: } Chris@39: } Chris@39: return 0; Chris@39: } Chris@39: /*******************************************************************/ Chris@39: int main(void); Chris@39: int main(void) Chris@39: { Chris@39: PaStream *stream; Chris@39: PaError err; Chris@39: paTestData DATA; Chris@39: int i, timeout; Chris@39: PaTime previousTime; Chris@39: PaStreamParameters outputParameters; Chris@39: printf("PortAudio Test: you should see BEEP at the same time you hear it.\n"); Chris@39: printf("Wait for a few seconds random delay between BEEPs.\n"); Chris@39: printf("BEEP %d times.\n", NUM_BEEPS ); Chris@39: /* Initialize our DATA for use by callback. */ Chris@39: DATA.left_phase = DATA.right_phase = 0.0; Chris@39: DATA.state = STATE_BKG_IDLE; Chris@39: DATA.requestBeep = 0; Chris@39: /* Initialize library before making any other calls. */ Chris@39: err = Pa_Initialize(); Chris@39: if( err != paNoError ) goto error; Chris@39: Chris@39: outputParameters.device = Pa_GetDefaultOutputDevice(); Chris@39: if (outputParameters.device == paNoDevice) { Chris@39: fprintf(stderr,"Error: No default output device.\n"); Chris@39: goto error; Chris@39: } Chris@39: outputParameters.channelCount = 2; Chris@39: outputParameters.hostApiSpecificStreamInfo = NULL; Chris@39: outputParameters.sampleFormat = paFloat32; Chris@39: outputParameters.suggestedLatency = (double)LATENCY_MSEC / 1000; Chris@39: Chris@39: /* Open an audio I/O stream. */ Chris@39: err = Pa_OpenStream( Chris@39: &stream, Chris@39: NULL, /* no input */ Chris@39: &outputParameters, Chris@39: SAMPLE_RATE, Chris@39: FRAMES_PER_BUFFER, /* frames per buffer */ Chris@39: paClipOff, /* we won't output out of range samples so don't bother clipping them */ Chris@39: patestCallback, Chris@39: &DATA ); Chris@39: if( err != paNoError ) goto error; Chris@39: Chris@39: err = Pa_StartStream( stream ); Chris@39: if( err != paNoError ) goto error; Chris@39: Chris@39: printf("started\n"); Chris@39: fflush(stdout); Chris@39: Chris@39: previousTime = Pa_GetStreamTime( stream ); Chris@39: for( i=0; i 0 ) ) Pa_Sleep(SLEEP_MSEC); Chris@39: if( timeout <= 0 ) Chris@39: { Chris@39: fprintf( stderr, "Timed out waiting for background to acknowledge request.\n" ); Chris@39: goto error; Chris@39: } Chris@39: printf("calc beep for %9.3f, latency = %6.3f\n", DATA.beepTime, DATA.latency ); Chris@39: fflush(stdout); Chris@39: Chris@39: /* Wait for scheduled beep time. */ Chris@39: timeout = TIMEOUT_MSEC + (10000/SLEEP_MSEC); Chris@39: while( (Pa_GetStreamTime( stream ) < DATA.beepTime) && (timeout-- > 0 ) ) Chris@39: { Chris@39: Pa_Sleep(SLEEP_MSEC); Chris@39: } Chris@39: if( timeout <= 0 ) Chris@39: { Chris@39: fprintf( stderr, "Timed out waiting for time. Now = %9.3f, Beep for %9.3f.\n", Chris@39: PaUtil_GetTime(), DATA.beepTime ); Chris@39: goto error; Chris@39: } Chris@39: Chris@39: /* Beep should be sounding now so print synchronized BEEP. */ Chris@39: printf("hear \"BEEP\" at %9.3f, delta = %9.3f\n", Chris@39: Pa_GetStreamTime( stream ), (DATA.beepTime - previousTime) ); Chris@39: fflush(stdout); Chris@39: Chris@39: previousTime = DATA.beepTime; Chris@39: } Chris@39: Chris@39: err = Pa_StopStream( stream ); Chris@39: if( err != paNoError ) goto error; Chris@39: Chris@39: err = Pa_CloseStream( stream ); Chris@39: if( err != paNoError ) goto error; Chris@39: Chris@39: Pa_Terminate(); Chris@39: printf("Test finished.\n"); Chris@39: return err; Chris@39: error: Chris@39: Pa_Terminate(); Chris@39: fprintf( stderr, "An error occured while using the portaudio stream\n" ); Chris@39: fprintf( stderr, "Error number: %d\n", err ); Chris@39: fprintf( stderr, "Error message: %s\n", Pa_GetErrorText( err ) ); Chris@39: return err; Chris@39: }