Chris@39: /** @file paqa_devs.c Chris@39: @ingroup qa_src Chris@39: @brief Self Testing Quality Assurance app for PortAudio Chris@39: Try to open each device and run through all the Chris@39: possible configurations. This test does not verify Chris@39: that the configuration works well. It just verifies Chris@39: that it does not crash. It requires a human to listen to Chris@39: the outputs. Chris@39: Chris@39: @author Phil Burk http://www.softsynth.com Chris@39: Chris@39: Pieter adapted to V19 API. Test now relies heavily on Chris@39: Pa_IsFormatSupported(). Uses same 'standard' sample rates Chris@39: as in test pa_devs.c. Chris@39: */ Chris@39: /* Chris@39: * $Id: paqa_devs.c 1910 2013-09-07 10:14:52Z gineera $ 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_trace.h" Chris@39: Chris@39: /****************************************** Definitions ***********/ Chris@39: #define MODE_INPUT (0) Chris@39: #define MODE_OUTPUT (1) Chris@39: #define MAX_TEST_CHANNELS 4 Chris@39: Chris@39: typedef struct PaQaData Chris@39: { Chris@39: unsigned long framesLeft; Chris@39: int numChannels; Chris@39: int bytesPerSample; Chris@39: int mode; Chris@39: short sawPhase; Chris@39: PaSampleFormat format; Chris@39: } Chris@39: PaQaData; Chris@39: Chris@39: /****************************************** Prototypes ***********/ Chris@39: static void TestDevices( int mode ); Chris@39: static void TestFormats( int mode, PaDeviceIndex deviceID, double sampleRate, Chris@39: int numChannels ); Chris@39: static int TestAdvance( int mode, PaDeviceIndex deviceID, double sampleRate, Chris@39: int numChannels, PaSampleFormat format ); Chris@39: static int QaCallback( const void *inputBuffer, void *outputBuffer, Chris@39: unsigned long framesPerBuffer, Chris@39: const PaStreamCallbackTimeInfo* timeInfo, Chris@39: PaStreamCallbackFlags statusFlags, Chris@39: void *userData ); Chris@39: Chris@39: /****************************************** Globals ***********/ Chris@39: static int gNumPassed = 0; Chris@39: static int gNumFailed = 0; Chris@39: Chris@39: /****************************************** Macros ***********/ Chris@39: /* Print ERROR if it fails. Tally success or failure. */ Chris@39: /* Odd do-while wrapper seems to be needed for some compilers. */ Chris@39: #define EXPECT(_exp) \ Chris@39: do \ Chris@39: { \ Chris@39: if ((_exp)) {\ Chris@39: /* printf("SUCCESS for %s\n", #_exp ); */ \ Chris@39: gNumPassed++; \ Chris@39: } \ Chris@39: else { \ Chris@39: printf("ERROR - 0x%x - %s for %s\n", result, \ Chris@39: ((result == 0) ? "-" : Pa_GetErrorText(result)), \ Chris@39: #_exp ); \ Chris@39: gNumFailed++; \ Chris@39: goto error; \ Chris@39: } \ Chris@39: } while(0) Chris@39: Chris@39: /*******************************************************************/ Chris@39: /* This routine will be called by the PortAudio engine when audio is needed. Chris@39: ** It may be 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 QaCallback( const void *inputBuffer, void *outputBuffer, Chris@39: unsigned long framesPerBuffer, Chris@39: const PaStreamCallbackTimeInfo* timeInfo, Chris@39: PaStreamCallbackFlags statusFlags, Chris@39: void *userData ) Chris@39: { Chris@39: unsigned long i; Chris@39: short phase; Chris@39: PaQaData *data = (PaQaData *) userData; Chris@39: (void) inputBuffer; Chris@39: Chris@39: /* Play simple sawtooth wave. */ Chris@39: if( data->mode == MODE_OUTPUT ) Chris@39: { Chris@39: phase = data->sawPhase; Chris@39: switch( data->format ) Chris@39: { Chris@39: case paFloat32: Chris@39: { Chris@39: float *out = (float *) outputBuffer; Chris@39: for( i=0; inumChannels == 2 ) Chris@39: { Chris@39: *out++ = (float) (phase * (1.0 / 32768.0)); Chris@39: } Chris@39: } Chris@39: } Chris@39: break; Chris@39: Chris@39: case paInt32: Chris@39: { Chris@39: int *out = (int *) outputBuffer; Chris@39: for( i=0; inumChannels == 2 ) Chris@39: { Chris@39: *out++ = ((int) phase ) << 16; Chris@39: } Chris@39: } Chris@39: } Chris@39: break; Chris@39: Chris@39: case paInt16: Chris@39: { Chris@39: short *out = (short *) outputBuffer; Chris@39: for( i=0; inumChannels == 2 ) Chris@39: { Chris@39: *out++ = phase; Chris@39: } Chris@39: } Chris@39: } Chris@39: break; Chris@39: Chris@39: default: Chris@39: { Chris@39: unsigned char *out = (unsigned char *) outputBuffer; Chris@39: unsigned long numBytes = framesPerBuffer * data->numChannels * data->bytesPerSample; Chris@39: for( i=0; isawPhase = phase; Chris@39: } Chris@39: /* Are we through yet? */ Chris@39: if( data->framesLeft > framesPerBuffer ) Chris@39: { Chris@39: PaUtil_AddTraceMessage("QaCallback: running. framesLeft", data->framesLeft ); Chris@39: data->framesLeft -= framesPerBuffer; Chris@39: return 0; Chris@39: } Chris@39: else Chris@39: { Chris@39: PaUtil_AddTraceMessage("QaCallback: DONE! framesLeft", data->framesLeft ); Chris@39: data->framesLeft = 0; Chris@39: return 1; Chris@39: } Chris@39: } Chris@39: Chris@39: /*******************************************************************/ Chris@39: int main(void); Chris@39: int main(void) Chris@39: { Chris@39: PaError result; Chris@39: EXPECT( ((result=Pa_Initialize()) == 0) ); Chris@39: printf("Test OUTPUT ---------------\n"); Chris@39: TestDevices( MODE_OUTPUT ); Chris@39: printf("Test INPUT ---------------\n"); Chris@39: TestDevices( MODE_INPUT ); Chris@39: error: Chris@39: Pa_Terminate(); Chris@39: printf("QA Report: %d passed, %d failed.\n", gNumPassed, gNumFailed ); Chris@39: return (gNumFailed > 0) ? 1 : 0; Chris@39: } Chris@39: Chris@39: /******************************************************************* Chris@39: * Try each output device, through its full range of capabilities. */ Chris@39: static void TestDevices( int mode ) Chris@39: { Chris@39: int id, jc, i; Chris@39: int maxChannels; Chris@39: const PaDeviceInfo *pdi; Chris@39: static double standardSampleRates[] = { 8000.0, 9600.0, 11025.0, 12000.0, Chris@39: 16000.0, 22050.0, 24000.0, Chris@39: 32000.0, 44100.0, 48000.0, Chris@39: 88200.0, 96000.0, Chris@39: -1.0 }; /* Negative terminated list. */ Chris@39: int numDevices = Pa_GetDeviceCount(); Chris@39: for( id=0; idmaxInputChannels : pdi->maxOutputChannels); Chris@39: if( maxChannels > MAX_TEST_CHANNELS ) Chris@39: maxChannels = MAX_TEST_CHANNELS; Chris@39: Chris@39: for( jc=1; jc<=maxChannels; jc++ ) Chris@39: { Chris@39: printf("\n========================================================================\n"); Chris@39: printf(" Device = %s\n", pdi->name ); Chris@39: printf("========================================================================\n"); Chris@39: /* Try each standard sample rate. */ Chris@39: for( i=0; standardSampleRates[i] > 0; i++ ) Chris@39: { Chris@39: TestFormats( mode, (PaDeviceIndex)id, standardSampleRates[i], jc ); Chris@39: } Chris@39: } Chris@39: } Chris@39: } Chris@39: Chris@39: /*******************************************************************/ Chris@39: static void TestFormats( int mode, PaDeviceIndex deviceID, double sampleRate, Chris@39: int numChannels ) Chris@39: { Chris@39: TestAdvance( mode, deviceID, sampleRate, numChannels, paFloat32 ); Chris@39: TestAdvance( mode, deviceID, sampleRate, numChannels, paInt16 ); Chris@39: TestAdvance( mode, deviceID, sampleRate, numChannels, paInt32 ); Chris@39: /* TestAdvance( mode, deviceID, sampleRate, numChannels, paInt24 ); */ Chris@39: } Chris@39: Chris@39: /*******************************************************************/ Chris@39: static int TestAdvance( int mode, PaDeviceIndex deviceID, double sampleRate, Chris@39: int numChannels, PaSampleFormat format ) Chris@39: { Chris@39: PaStreamParameters inputParameters, outputParameters, *ipp, *opp; Chris@39: PaStream *stream = NULL; Chris@39: PaError result = paNoError; Chris@39: PaQaData myData; Chris@39: #define FRAMES_PER_BUFFER (64) Chris@39: const int kNumSeconds = 100; Chris@39: Chris@39: /* Setup data for synthesis thread. */ Chris@39: myData.framesLeft = (unsigned long) (sampleRate * kNumSeconds); Chris@39: myData.numChannels = numChannels; Chris@39: myData.mode = mode; Chris@39: myData.format = format; Chris@39: switch( format ) Chris@39: { Chris@39: case paFloat32: Chris@39: case paInt32: Chris@39: case paInt24: Chris@39: myData.bytesPerSample = 4; Chris@39: break; Chris@39: /* case paPackedInt24: Chris@39: myData.bytesPerSample = 3; Chris@39: break; */ Chris@39: default: Chris@39: myData.bytesPerSample = 2; Chris@39: break; Chris@39: } Chris@39: Chris@39: if( mode == MODE_INPUT ) Chris@39: { Chris@39: inputParameters.device = deviceID; Chris@39: inputParameters.channelCount = numChannels; Chris@39: inputParameters.sampleFormat = format; Chris@39: inputParameters.suggestedLatency = Pa_GetDeviceInfo( inputParameters.device )->defaultLowInputLatency; Chris@39: inputParameters.hostApiSpecificStreamInfo = NULL; Chris@39: ipp = &inputParameters; Chris@39: } Chris@39: else Chris@39: { Chris@39: ipp = NULL; Chris@39: } Chris@39: Chris@39: if( mode == MODE_OUTPUT ) Chris@39: { Chris@39: outputParameters.device = deviceID; Chris@39: outputParameters.channelCount = numChannels; Chris@39: outputParameters.sampleFormat = format; Chris@39: outputParameters.suggestedLatency = Pa_GetDeviceInfo( outputParameters.device )->defaultLowOutputLatency; Chris@39: outputParameters.hostApiSpecificStreamInfo = NULL; Chris@39: opp = &outputParameters; Chris@39: } Chris@39: else Chris@39: { Chris@39: opp = NULL; Chris@39: } Chris@39: Chris@39: if(paFormatIsSupported == Pa_IsFormatSupported( ipp, opp, sampleRate )) Chris@39: { Chris@39: printf("------ TestAdvance: %s, device = %d, rate = %g, numChannels = %d, format = %lu -------\n", Chris@39: ( mode == MODE_INPUT ) ? "INPUT" : "OUTPUT", Chris@39: deviceID, sampleRate, numChannels, (unsigned long)format); Chris@39: EXPECT( ((result = Pa_OpenStream( &stream, Chris@39: ipp, Chris@39: opp, Chris@39: sampleRate, Chris@39: FRAMES_PER_BUFFER, Chris@39: paClipOff, /* we won't output out of range samples so don't bother clipping them */ Chris@39: QaCallback, Chris@39: &myData ) ) == 0) ); Chris@39: if( stream ) Chris@39: { Chris@39: PaTime oldStamp, newStamp; Chris@39: unsigned long oldFrames; Chris@39: int minDelay = ( mode == MODE_INPUT ) ? 1000 : 400; Chris@39: /* Was: Chris@39: int minNumBuffers = Pa_GetMinNumBuffers( FRAMES_PER_BUFFER, sampleRate ); Chris@39: int msec = (int) ((minNumBuffers * 3 * 1000.0 * FRAMES_PER_BUFFER) / sampleRate); Chris@39: */ Chris@39: int msec = (int)( 3.0 * Chris@39: (( mode == MODE_INPUT ) ? inputParameters.suggestedLatency : outputParameters.suggestedLatency )); Chris@39: if( msec < minDelay ) msec = minDelay; Chris@39: printf("msec = %d\n", msec); /**/ Chris@39: EXPECT( ((result=Pa_StartStream( stream )) == 0) ); Chris@39: /* Check to make sure PortAudio is advancing timeStamp. */ Chris@39: oldStamp = Pa_GetStreamTime(stream); Chris@39: Pa_Sleep(msec); Chris@39: newStamp = Pa_GetStreamTime(stream); Chris@39: printf("oldStamp = %9.6f, newStamp = %9.6f\n", oldStamp, newStamp ); /**/ Chris@39: EXPECT( (oldStamp < newStamp) ); Chris@39: /* Check to make sure callback is decrementing framesLeft. */ Chris@39: oldFrames = myData.framesLeft; Chris@39: Pa_Sleep(msec); Chris@39: printf("oldFrames = %lu, myData.framesLeft = %lu\n", oldFrames, myData.framesLeft ); /**/ Chris@39: EXPECT( (oldFrames > myData.framesLeft) ); Chris@39: EXPECT( ((result=Pa_CloseStream( stream )) == 0) ); Chris@39: stream = NULL; Chris@39: } Chris@39: } Chris@39: return 0; Chris@39: error: Chris@39: if( stream != NULL ) Pa_CloseStream( stream ); Chris@39: return -1; Chris@39: }