cannam@124: /** @file paqa_devs.c cannam@124: @ingroup qa_src cannam@124: @brief Self Testing Quality Assurance app for PortAudio cannam@124: Try to open each device and run through all the cannam@124: possible configurations. This test does not verify cannam@124: that the configuration works well. It just verifies cannam@124: that it does not crash. It requires a human to listen to cannam@124: the outputs. cannam@124: cannam@124: @author Phil Burk http://www.softsynth.com cannam@124: cannam@124: Pieter adapted to V19 API. Test now relies heavily on cannam@124: Pa_IsFormatSupported(). Uses same 'standard' sample rates cannam@124: as in test pa_devs.c. cannam@124: */ cannam@124: /* cannam@124: * $Id: paqa_devs.c 1910 2013-09-07 10:14:52Z gineera $ cannam@124: * cannam@124: * This program uses the PortAudio Portable Audio Library. cannam@124: * For more information see: http://www.portaudio.com cannam@124: * Copyright (c) 1999-2000 Ross Bencina and Phil Burk cannam@124: * cannam@124: * Permission is hereby granted, free of charge, to any person obtaining cannam@124: * a copy of this software and associated documentation files cannam@124: * (the "Software"), to deal in the Software without restriction, cannam@124: * including without limitation the rights to use, copy, modify, merge, cannam@124: * publish, distribute, sublicense, and/or sell copies of the Software, cannam@124: * and to permit persons to whom the Software is furnished to do so, cannam@124: * subject to the following conditions: cannam@124: * cannam@124: * The above copyright notice and this permission notice shall be cannam@124: * included in all copies or substantial portions of the Software. cannam@124: * cannam@124: * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, cannam@124: * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF cannam@124: * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. cannam@124: * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR cannam@124: * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF cannam@124: * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION cannam@124: * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. cannam@124: */ cannam@124: cannam@124: /* cannam@124: * The text above constitutes the entire PortAudio license; however, cannam@124: * the PortAudio community also makes the following non-binding requests: cannam@124: * cannam@124: * Any person wishing to distribute modifications to the Software is cannam@124: * requested to send the modifications to the original developer so that cannam@124: * they can be incorporated into the canonical version. It is also cannam@124: * requested that these non-binding requests be included along with the cannam@124: * license above. cannam@124: */ cannam@124: cannam@124: #include cannam@124: #include cannam@124: #include "portaudio.h" cannam@124: #include "pa_trace.h" cannam@124: cannam@124: /****************************************** Definitions ***********/ cannam@124: #define MODE_INPUT (0) cannam@124: #define MODE_OUTPUT (1) cannam@124: #define MAX_TEST_CHANNELS 4 cannam@124: cannam@124: typedef struct PaQaData cannam@124: { cannam@124: unsigned long framesLeft; cannam@124: int numChannels; cannam@124: int bytesPerSample; cannam@124: int mode; cannam@124: short sawPhase; cannam@124: PaSampleFormat format; cannam@124: } cannam@124: PaQaData; cannam@124: cannam@124: /****************************************** Prototypes ***********/ cannam@124: static void TestDevices( int mode ); cannam@124: static void TestFormats( int mode, PaDeviceIndex deviceID, double sampleRate, cannam@124: int numChannels ); cannam@124: static int TestAdvance( int mode, PaDeviceIndex deviceID, double sampleRate, cannam@124: int numChannels, PaSampleFormat format ); cannam@124: static int QaCallback( const void *inputBuffer, void *outputBuffer, cannam@124: unsigned long framesPerBuffer, cannam@124: const PaStreamCallbackTimeInfo* timeInfo, cannam@124: PaStreamCallbackFlags statusFlags, cannam@124: void *userData ); cannam@124: cannam@124: /****************************************** Globals ***********/ cannam@124: static int gNumPassed = 0; cannam@124: static int gNumFailed = 0; cannam@124: cannam@124: /****************************************** Macros ***********/ cannam@124: /* Print ERROR if it fails. Tally success or failure. */ cannam@124: /* Odd do-while wrapper seems to be needed for some compilers. */ cannam@124: #define EXPECT(_exp) \ cannam@124: do \ cannam@124: { \ cannam@124: if ((_exp)) {\ cannam@124: /* printf("SUCCESS for %s\n", #_exp ); */ \ cannam@124: gNumPassed++; \ cannam@124: } \ cannam@124: else { \ cannam@124: printf("ERROR - 0x%x - %s for %s\n", result, \ cannam@124: ((result == 0) ? "-" : Pa_GetErrorText(result)), \ cannam@124: #_exp ); \ cannam@124: gNumFailed++; \ cannam@124: goto error; \ cannam@124: } \ cannam@124: } while(0) cannam@124: cannam@124: /*******************************************************************/ cannam@124: /* This routine will be called by the PortAudio engine when audio is needed. cannam@124: ** It may be called at interrupt level on some machines so don't do anything cannam@124: ** that could mess up the system like calling malloc() or free(). cannam@124: */ cannam@124: static int QaCallback( const void *inputBuffer, void *outputBuffer, cannam@124: unsigned long framesPerBuffer, cannam@124: const PaStreamCallbackTimeInfo* timeInfo, cannam@124: PaStreamCallbackFlags statusFlags, cannam@124: void *userData ) cannam@124: { cannam@124: unsigned long i; cannam@124: short phase; cannam@124: PaQaData *data = (PaQaData *) userData; cannam@124: (void) inputBuffer; cannam@124: cannam@124: /* Play simple sawtooth wave. */ cannam@124: if( data->mode == MODE_OUTPUT ) cannam@124: { cannam@124: phase = data->sawPhase; cannam@124: switch( data->format ) cannam@124: { cannam@124: case paFloat32: cannam@124: { cannam@124: float *out = (float *) outputBuffer; cannam@124: for( i=0; inumChannels == 2 ) cannam@124: { cannam@124: *out++ = (float) (phase * (1.0 / 32768.0)); cannam@124: } cannam@124: } cannam@124: } cannam@124: break; cannam@124: cannam@124: case paInt32: cannam@124: { cannam@124: int *out = (int *) outputBuffer; cannam@124: for( i=0; inumChannels == 2 ) cannam@124: { cannam@124: *out++ = ((int) phase ) << 16; cannam@124: } cannam@124: } cannam@124: } cannam@124: break; cannam@124: cannam@124: case paInt16: cannam@124: { cannam@124: short *out = (short *) outputBuffer; cannam@124: for( i=0; inumChannels == 2 ) cannam@124: { cannam@124: *out++ = phase; cannam@124: } cannam@124: } cannam@124: } cannam@124: break; cannam@124: cannam@124: default: cannam@124: { cannam@124: unsigned char *out = (unsigned char *) outputBuffer; cannam@124: unsigned long numBytes = framesPerBuffer * data->numChannels * data->bytesPerSample; cannam@124: for( i=0; isawPhase = phase; cannam@124: } cannam@124: /* Are we through yet? */ cannam@124: if( data->framesLeft > framesPerBuffer ) cannam@124: { cannam@124: PaUtil_AddTraceMessage("QaCallback: running. framesLeft", data->framesLeft ); cannam@124: data->framesLeft -= framesPerBuffer; cannam@124: return 0; cannam@124: } cannam@124: else cannam@124: { cannam@124: PaUtil_AddTraceMessage("QaCallback: DONE! framesLeft", data->framesLeft ); cannam@124: data->framesLeft = 0; cannam@124: return 1; cannam@124: } cannam@124: } cannam@124: cannam@124: /*******************************************************************/ cannam@124: int main(void); cannam@124: int main(void) cannam@124: { cannam@124: PaError result; cannam@124: EXPECT( ((result=Pa_Initialize()) == 0) ); cannam@124: printf("Test OUTPUT ---------------\n"); cannam@124: TestDevices( MODE_OUTPUT ); cannam@124: printf("Test INPUT ---------------\n"); cannam@124: TestDevices( MODE_INPUT ); cannam@124: error: cannam@124: Pa_Terminate(); cannam@124: printf("QA Report: %d passed, %d failed.\n", gNumPassed, gNumFailed ); cannam@124: return (gNumFailed > 0) ? 1 : 0; cannam@124: } cannam@124: cannam@124: /******************************************************************* cannam@124: * Try each output device, through its full range of capabilities. */ cannam@124: static void TestDevices( int mode ) cannam@124: { cannam@124: int id, jc, i; cannam@124: int maxChannels; cannam@124: const PaDeviceInfo *pdi; cannam@124: static double standardSampleRates[] = { 8000.0, 9600.0, 11025.0, 12000.0, cannam@124: 16000.0, 22050.0, 24000.0, cannam@124: 32000.0, 44100.0, 48000.0, cannam@124: 88200.0, 96000.0, cannam@124: -1.0 }; /* Negative terminated list. */ cannam@124: int numDevices = Pa_GetDeviceCount(); cannam@124: for( id=0; idmaxInputChannels : pdi->maxOutputChannels); cannam@124: if( maxChannels > MAX_TEST_CHANNELS ) cannam@124: maxChannels = MAX_TEST_CHANNELS; cannam@124: cannam@124: for( jc=1; jc<=maxChannels; jc++ ) cannam@124: { cannam@124: printf("\n========================================================================\n"); cannam@124: printf(" Device = %s\n", pdi->name ); cannam@124: printf("========================================================================\n"); cannam@124: /* Try each standard sample rate. */ cannam@124: for( i=0; standardSampleRates[i] > 0; i++ ) cannam@124: { cannam@124: TestFormats( mode, (PaDeviceIndex)id, standardSampleRates[i], jc ); cannam@124: } cannam@124: } cannam@124: } cannam@124: } cannam@124: cannam@124: /*******************************************************************/ cannam@124: static void TestFormats( int mode, PaDeviceIndex deviceID, double sampleRate, cannam@124: int numChannels ) cannam@124: { cannam@124: TestAdvance( mode, deviceID, sampleRate, numChannels, paFloat32 ); cannam@124: TestAdvance( mode, deviceID, sampleRate, numChannels, paInt16 ); cannam@124: TestAdvance( mode, deviceID, sampleRate, numChannels, paInt32 ); cannam@124: /* TestAdvance( mode, deviceID, sampleRate, numChannels, paInt24 ); */ cannam@124: } cannam@124: cannam@124: /*******************************************************************/ cannam@124: static int TestAdvance( int mode, PaDeviceIndex deviceID, double sampleRate, cannam@124: int numChannels, PaSampleFormat format ) cannam@124: { cannam@124: PaStreamParameters inputParameters, outputParameters, *ipp, *opp; cannam@124: PaStream *stream = NULL; cannam@124: PaError result = paNoError; cannam@124: PaQaData myData; cannam@124: #define FRAMES_PER_BUFFER (64) cannam@124: const int kNumSeconds = 100; cannam@124: cannam@124: /* Setup data for synthesis thread. */ cannam@124: myData.framesLeft = (unsigned long) (sampleRate * kNumSeconds); cannam@124: myData.numChannels = numChannels; cannam@124: myData.mode = mode; cannam@124: myData.format = format; cannam@124: switch( format ) cannam@124: { cannam@124: case paFloat32: cannam@124: case paInt32: cannam@124: case paInt24: cannam@124: myData.bytesPerSample = 4; cannam@124: break; cannam@124: /* case paPackedInt24: cannam@124: myData.bytesPerSample = 3; cannam@124: break; */ cannam@124: default: cannam@124: myData.bytesPerSample = 2; cannam@124: break; cannam@124: } cannam@124: cannam@124: if( mode == MODE_INPUT ) cannam@124: { cannam@124: inputParameters.device = deviceID; cannam@124: inputParameters.channelCount = numChannels; cannam@124: inputParameters.sampleFormat = format; cannam@124: inputParameters.suggestedLatency = Pa_GetDeviceInfo( inputParameters.device )->defaultLowInputLatency; cannam@124: inputParameters.hostApiSpecificStreamInfo = NULL; cannam@124: ipp = &inputParameters; cannam@124: } cannam@124: else cannam@124: { cannam@124: ipp = NULL; cannam@124: } cannam@124: cannam@124: if( mode == MODE_OUTPUT ) cannam@124: { cannam@124: outputParameters.device = deviceID; cannam@124: outputParameters.channelCount = numChannels; cannam@124: outputParameters.sampleFormat = format; cannam@124: outputParameters.suggestedLatency = Pa_GetDeviceInfo( outputParameters.device )->defaultLowOutputLatency; cannam@124: outputParameters.hostApiSpecificStreamInfo = NULL; cannam@124: opp = &outputParameters; cannam@124: } cannam@124: else cannam@124: { cannam@124: opp = NULL; cannam@124: } cannam@124: cannam@124: if(paFormatIsSupported == Pa_IsFormatSupported( ipp, opp, sampleRate )) cannam@124: { cannam@124: printf("------ TestAdvance: %s, device = %d, rate = %g, numChannels = %d, format = %lu -------\n", cannam@124: ( mode == MODE_INPUT ) ? "INPUT" : "OUTPUT", cannam@124: deviceID, sampleRate, numChannels, (unsigned long)format); cannam@124: EXPECT( ((result = Pa_OpenStream( &stream, cannam@124: ipp, cannam@124: opp, cannam@124: sampleRate, cannam@124: FRAMES_PER_BUFFER, cannam@124: paClipOff, /* we won't output out of range samples so don't bother clipping them */ cannam@124: QaCallback, cannam@124: &myData ) ) == 0) ); cannam@124: if( stream ) cannam@124: { cannam@124: PaTime oldStamp, newStamp; cannam@124: unsigned long oldFrames; cannam@124: int minDelay = ( mode == MODE_INPUT ) ? 1000 : 400; cannam@124: /* Was: cannam@124: int minNumBuffers = Pa_GetMinNumBuffers( FRAMES_PER_BUFFER, sampleRate ); cannam@124: int msec = (int) ((minNumBuffers * 3 * 1000.0 * FRAMES_PER_BUFFER) / sampleRate); cannam@124: */ cannam@124: int msec = (int)( 3.0 * cannam@124: (( mode == MODE_INPUT ) ? inputParameters.suggestedLatency : outputParameters.suggestedLatency )); cannam@124: if( msec < minDelay ) msec = minDelay; cannam@124: printf("msec = %d\n", msec); /**/ cannam@124: EXPECT( ((result=Pa_StartStream( stream )) == 0) ); cannam@124: /* Check to make sure PortAudio is advancing timeStamp. */ cannam@124: oldStamp = Pa_GetStreamTime(stream); cannam@124: Pa_Sleep(msec); cannam@124: newStamp = Pa_GetStreamTime(stream); cannam@124: printf("oldStamp = %9.6f, newStamp = %9.6f\n", oldStamp, newStamp ); /**/ cannam@124: EXPECT( (oldStamp < newStamp) ); cannam@124: /* Check to make sure callback is decrementing framesLeft. */ cannam@124: oldFrames = myData.framesLeft; cannam@124: Pa_Sleep(msec); cannam@124: printf("oldFrames = %lu, myData.framesLeft = %lu\n", oldFrames, myData.framesLeft ); /**/ cannam@124: EXPECT( (oldFrames > myData.framesLeft) ); cannam@124: EXPECT( ((result=Pa_CloseStream( stream )) == 0) ); cannam@124: stream = NULL; cannam@124: } cannam@124: } cannam@124: return 0; cannam@124: error: cannam@124: if( stream != NULL ) Pa_CloseStream( stream ); cannam@124: return -1; cannam@124: }