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