cannam@89: /** @file paqa_errs.c cannam@89: @ingroup qa_src cannam@89: @brief Self Testing Quality Assurance app for PortAudio cannam@89: Do lots of bad things to test error reporting. cannam@89: @author Phil Burk http://www.softsynth.com cannam@89: Pieter Suurmond adapted to V19 API. cannam@89: */ cannam@89: /* cannam@89: * $Id: paqa_errs.c 1756 2011-09-08 06:09:29Z philburk $ cannam@89: * cannam@89: * This program uses the PortAudio Portable Audio Library. cannam@89: * For more information see: http://www.portaudio.com cannam@89: * Copyright (c) 1999-2000 Ross Bencina and Phil Burk cannam@89: * cannam@89: * Permission is hereby granted, free of charge, to any person obtaining cannam@89: * a copy of this software and associated documentation files cannam@89: * (the "Software"), to deal in the Software without restriction, cannam@89: * including without limitation the rights to use, copy, modify, merge, cannam@89: * publish, distribute, sublicense, and/or sell copies of the Software, cannam@89: * and to permit persons to whom the Software is furnished to do so, cannam@89: * subject to the following conditions: cannam@89: * cannam@89: * The above copyright notice and this permission notice shall be cannam@89: * included in all copies or substantial portions of the Software. cannam@89: * cannam@89: * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, cannam@89: * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF cannam@89: * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. cannam@89: * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR cannam@89: * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF cannam@89: * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION cannam@89: * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. cannam@89: */ cannam@89: cannam@89: /* cannam@89: * The text above constitutes the entire PortAudio license; however, cannam@89: * the PortAudio community also makes the following non-binding requests: cannam@89: * cannam@89: * Any person wishing to distribute modifications to the Software is cannam@89: * requested to send the modifications to the original developer so that cannam@89: * they can be incorporated into the canonical version. It is also cannam@89: * requested that these non-binding requests be included along with the cannam@89: * license above. cannam@89: */ cannam@89: cannam@89: #include cannam@89: #include cannam@89: cannam@89: #include "portaudio.h" cannam@89: cannam@89: /*--------- Definitions ---------*/ cannam@89: #define MODE_INPUT (0) cannam@89: #define MODE_OUTPUT (1) cannam@89: #define FRAMES_PER_BUFFER (64) cannam@89: #define SAMPLE_RATE (44100.0) cannam@89: cannam@89: typedef struct PaQaData cannam@89: { cannam@89: unsigned long framesLeft; cannam@89: int numChannels; cannam@89: int bytesPerSample; cannam@89: int mode; cannam@89: } cannam@89: PaQaData; cannam@89: cannam@89: static int gNumPassed = 0; /* Two globals */ cannam@89: static int gNumFailed = 0; cannam@89: cannam@89: /*------------------- Macros ------------------------------*/ cannam@89: /* Print ERROR if it fails. Tally success or failure. Odd */ cannam@89: /* do-while wrapper seems to be needed for some compilers. */ cannam@89: cannam@89: #define EXPECT(_exp) \ cannam@89: do \ cannam@89: { \ cannam@89: if ((_exp)) {\ cannam@89: gNumPassed++; \ cannam@89: } \ cannam@89: else { \ cannam@89: printf("\nERROR - 0x%x - %s for %s\n", result, Pa_GetErrorText(result), #_exp ); \ cannam@89: gNumFailed++; \ cannam@89: goto error; \ cannam@89: } \ cannam@89: } while(0) cannam@89: cannam@89: #define HOPEFOR(_exp) \ cannam@89: do \ cannam@89: { \ cannam@89: if ((_exp)) {\ cannam@89: gNumPassed++; \ cannam@89: } \ cannam@89: else { \ cannam@89: printf("\nERROR - 0x%x - %s for %s\n", result, Pa_GetErrorText(result), #_exp ); \ cannam@89: gNumFailed++; \ cannam@89: } \ cannam@89: } while(0) cannam@89: cannam@89: /*-------------------------------------------------------------------------*/ cannam@89: /* This routine will be called by the PortAudio engine when audio is needed. cannam@89: It may be called at interrupt level on some machines so don't do anything cannam@89: that could mess up the system like calling malloc() or free(). cannam@89: */ cannam@89: static int QaCallback( const void* inputBuffer, cannam@89: void* outputBuffer, cannam@89: unsigned long framesPerBuffer, cannam@89: const PaStreamCallbackTimeInfo* timeInfo, cannam@89: PaStreamCallbackFlags statusFlags, cannam@89: void* userData ) cannam@89: { cannam@89: unsigned long i; cannam@89: unsigned char* out = (unsigned char *) outputBuffer; cannam@89: PaQaData* data = (PaQaData *) userData; cannam@89: cannam@89: (void)inputBuffer; /* Prevent "unused variable" warnings. */ cannam@89: cannam@89: /* Zero out buffer so we don't hear terrible noise. */ cannam@89: if( data->mode == MODE_OUTPUT ) cannam@89: { cannam@89: unsigned long numBytes = framesPerBuffer * data->numChannels * data->bytesPerSample; cannam@89: for( i=0; iframesLeft > framesPerBuffer ) cannam@89: { cannam@89: data->framesLeft -= framesPerBuffer; cannam@89: return 0; cannam@89: } cannam@89: else cannam@89: { cannam@89: data->framesLeft = 0; cannam@89: return 1; cannam@89: } cannam@89: } cannam@89: cannam@89: static PaDeviceIndex FindInputOnlyDevice(void) cannam@89: { cannam@89: PaDeviceIndex result = Pa_GetDefaultInputDevice(); cannam@89: if( result != paNoDevice && Pa_GetDeviceInfo(result)->maxOutputChannels == 0 ) cannam@89: return result; cannam@89: cannam@89: for( result = 0; result < Pa_GetDeviceCount(); ++result ) cannam@89: { cannam@89: if( Pa_GetDeviceInfo(result)->maxOutputChannels == 0 ) cannam@89: return result; cannam@89: } cannam@89: cannam@89: return paNoDevice; cannam@89: } cannam@89: cannam@89: static PaDeviceIndex FindOutputOnlyDevice(void) cannam@89: { cannam@89: PaDeviceIndex result = Pa_GetDefaultOutputDevice(); cannam@89: if( result != paNoDevice && Pa_GetDeviceInfo(result)->maxInputChannels == 0 ) cannam@89: return result; cannam@89: cannam@89: for( result = 0; result < Pa_GetDeviceCount(); ++result ) cannam@89: { cannam@89: if( Pa_GetDeviceInfo(result)->maxInputChannels == 0 ) cannam@89: return result; cannam@89: } cannam@89: cannam@89: return paNoDevice; cannam@89: } cannam@89: cannam@89: /*-------------------------------------------------------------------------------------------------*/ cannam@89: static int TestBadOpens( void ) cannam@89: { cannam@89: PaStream* stream = NULL; cannam@89: PaError result; cannam@89: PaQaData myData; cannam@89: PaStreamParameters ipp, opp; cannam@89: const PaDeviceInfo* info = NULL; cannam@89: cannam@89: cannam@89: /* Setup data for synthesis thread. */ cannam@89: myData.framesLeft = (unsigned long) (SAMPLE_RATE * 100); /* 100 seconds */ cannam@89: myData.numChannels = 1; cannam@89: myData.mode = MODE_OUTPUT; cannam@89: cannam@89: /*----------------------------- No devices specified: */ cannam@89: ipp.device = opp.device = paNoDevice; cannam@89: ipp.channelCount = opp.channelCount = 0; /* Also no channels. */ cannam@89: ipp.hostApiSpecificStreamInfo = opp.hostApiSpecificStreamInfo = NULL; cannam@89: ipp.sampleFormat = opp.sampleFormat = paFloat32; cannam@89: /* Take the low latency of the default device for all subsequent tests. */ cannam@89: info = Pa_GetDeviceInfo(Pa_GetDefaultInputDevice()); cannam@89: ipp.suggestedLatency = info ? info->defaultLowInputLatency : 0.100; cannam@89: info = Pa_GetDeviceInfo(Pa_GetDefaultOutputDevice()); cannam@89: opp.suggestedLatency = info ? info->defaultLowOutputLatency : 0.100; cannam@89: HOPEFOR(((result = Pa_OpenStream(&stream, &ipp, &opp, cannam@89: SAMPLE_RATE, FRAMES_PER_BUFFER, cannam@89: paClipOff, QaCallback, &myData )) == paInvalidDevice)); cannam@89: cannam@89: /*----------------------------- No devices specified #2: */ cannam@89: HOPEFOR(((result = Pa_OpenStream(&stream, NULL, NULL, cannam@89: SAMPLE_RATE, FRAMES_PER_BUFFER, cannam@89: paClipOff, QaCallback, &myData )) == paInvalidDevice)); cannam@89: cannam@89: /*----------------------------- Out of range input device specified: */ cannam@89: ipp.hostApiSpecificStreamInfo = opp.hostApiSpecificStreamInfo = NULL; cannam@89: ipp.sampleFormat = opp.sampleFormat = paFloat32; cannam@89: ipp.channelCount = 0; ipp.device = Pa_GetDeviceCount(); /* And no output device, and no channels. */ cannam@89: opp.channelCount = 0; opp.device = paNoDevice; cannam@89: HOPEFOR(((result = Pa_OpenStream(&stream, &ipp, NULL, cannam@89: SAMPLE_RATE, FRAMES_PER_BUFFER, cannam@89: paClipOff, QaCallback, &myData )) == paInvalidDevice)); cannam@89: cannam@89: /*----------------------------- Out of range output device specified: */ cannam@89: ipp.hostApiSpecificStreamInfo = opp.hostApiSpecificStreamInfo = NULL; cannam@89: ipp.sampleFormat = opp.sampleFormat = paFloat32; cannam@89: ipp.channelCount = 0; ipp.device = paNoDevice; /* And no input device, and no channels. */ cannam@89: opp.channelCount = 0; opp.device = Pa_GetDeviceCount(); cannam@89: HOPEFOR(((result = Pa_OpenStream(&stream, NULL, &opp, cannam@89: SAMPLE_RATE, FRAMES_PER_BUFFER, cannam@89: paClipOff, QaCallback, &myData )) == paInvalidDevice)); cannam@89: cannam@89: if (Pa_GetDefaultInputDevice() != paNoDevice) { cannam@89: /*----------------------------- Zero input channels: */ cannam@89: ipp.hostApiSpecificStreamInfo = opp.hostApiSpecificStreamInfo = NULL; cannam@89: ipp.sampleFormat = opp.sampleFormat = paFloat32; cannam@89: ipp.channelCount = 0; ipp.device = Pa_GetDefaultInputDevice(); cannam@89: opp.channelCount = 0; opp.device = paNoDevice; /* And no output device, and no output channels. */ cannam@89: HOPEFOR(((result = Pa_OpenStream(&stream, &ipp, NULL, cannam@89: SAMPLE_RATE, FRAMES_PER_BUFFER, cannam@89: paClipOff, QaCallback, &myData )) == paInvalidChannelCount)); cannam@89: } cannam@89: cannam@89: if (Pa_GetDefaultOutputDevice() != paNoDevice) { cannam@89: /*----------------------------- Zero output channels: */ cannam@89: ipp.hostApiSpecificStreamInfo = opp.hostApiSpecificStreamInfo = NULL; cannam@89: ipp.sampleFormat = opp.sampleFormat = paFloat32; cannam@89: ipp.channelCount = 0; ipp.device = paNoDevice; /* And no input device, and no input channels. */ cannam@89: opp.channelCount = 0; opp.device = Pa_GetDefaultOutputDevice(); cannam@89: HOPEFOR(((result = Pa_OpenStream(&stream, NULL, &opp, cannam@89: SAMPLE_RATE, FRAMES_PER_BUFFER, cannam@89: paClipOff, QaCallback, &myData )) == paInvalidChannelCount)); cannam@89: } cannam@89: /*----------------------------- Nonzero input and output channels but no output device: */ cannam@89: ipp.hostApiSpecificStreamInfo = opp.hostApiSpecificStreamInfo = NULL; cannam@89: ipp.sampleFormat = opp.sampleFormat = paFloat32; cannam@89: ipp.channelCount = 2; ipp.device = Pa_GetDefaultInputDevice(); /* Both stereo. */ cannam@89: opp.channelCount = 2; opp.device = paNoDevice; cannam@89: HOPEFOR(((result = Pa_OpenStream(&stream, &ipp, &opp, cannam@89: SAMPLE_RATE, FRAMES_PER_BUFFER, cannam@89: paClipOff, QaCallback, &myData )) == paInvalidDevice)); cannam@89: cannam@89: /*----------------------------- Nonzero input and output channels but no input device: */ cannam@89: ipp.hostApiSpecificStreamInfo = opp.hostApiSpecificStreamInfo = NULL; cannam@89: ipp.sampleFormat = opp.sampleFormat = paFloat32; cannam@89: ipp.channelCount = 2; ipp.device = paNoDevice; cannam@89: opp.channelCount = 2; opp.device = Pa_GetDefaultOutputDevice(); cannam@89: HOPEFOR(((result = Pa_OpenStream(&stream, &ipp, &opp, cannam@89: SAMPLE_RATE, FRAMES_PER_BUFFER, cannam@89: paClipOff, QaCallback, &myData )) == paInvalidDevice)); cannam@89: cannam@89: if (Pa_GetDefaultOutputDevice() != paNoDevice) { cannam@89: /*----------------------------- NULL stream pointer: */ cannam@89: ipp.hostApiSpecificStreamInfo = opp.hostApiSpecificStreamInfo = NULL; cannam@89: ipp.sampleFormat = opp.sampleFormat = paFloat32; cannam@89: ipp.channelCount = 0; ipp.device = paNoDevice; /* Output is more likely than input. */ cannam@89: opp.channelCount = 2; opp.device = Pa_GetDefaultOutputDevice(); /* Only 2 output channels. */ cannam@89: HOPEFOR(((result = Pa_OpenStream(NULL, &ipp, &opp, cannam@89: SAMPLE_RATE, FRAMES_PER_BUFFER, cannam@89: paClipOff, QaCallback, &myData )) == paBadStreamPtr)); cannam@89: cannam@89: /*----------------------------- Low sample rate: */ cannam@89: ipp.hostApiSpecificStreamInfo = opp.hostApiSpecificStreamInfo = NULL; cannam@89: ipp.sampleFormat = opp.sampleFormat = paFloat32; cannam@89: ipp.channelCount = 0; ipp.device = paNoDevice; cannam@89: opp.channelCount = 2; opp.device = Pa_GetDefaultOutputDevice(); cannam@89: HOPEFOR(((result = Pa_OpenStream(&stream, NULL, &opp, cannam@89: 1.0, FRAMES_PER_BUFFER, /* 1 cycle per second (1 Hz) is too low. */ cannam@89: paClipOff, QaCallback, &myData )) == paInvalidSampleRate)); cannam@89: cannam@89: /*----------------------------- High sample rate: */ cannam@89: ipp.hostApiSpecificStreamInfo = opp.hostApiSpecificStreamInfo = NULL; cannam@89: ipp.sampleFormat = opp.sampleFormat = paFloat32; cannam@89: ipp.channelCount = 0; ipp.device = paNoDevice; cannam@89: opp.channelCount = 2; opp.device = Pa_GetDefaultOutputDevice(); cannam@89: HOPEFOR(((result = Pa_OpenStream(&stream, NULL, &opp, cannam@89: 10000000.0, FRAMES_PER_BUFFER, /* 10^6 cycles per second (10 MHz) is too high. */ cannam@89: paClipOff, QaCallback, &myData )) == paInvalidSampleRate)); cannam@89: cannam@89: /*----------------------------- NULL callback: */ cannam@89: /* NULL callback is valid in V19 -- it means use blocking read/write stream cannam@89: cannam@89: ipp.hostApiSpecificStreamInfo = opp.hostApiSpecificStreamInfo = NULL; cannam@89: ipp.sampleFormat = opp.sampleFormat = paFloat32; cannam@89: ipp.channelCount = 0; ipp.device = paNoDevice; cannam@89: opp.channelCount = 2; opp.device = Pa_GetDefaultOutputDevice(); cannam@89: HOPEFOR(((result = Pa_OpenStream(&stream, NULL, &opp, cannam@89: SAMPLE_RATE, FRAMES_PER_BUFFER, cannam@89: paClipOff, cannam@89: NULL, cannam@89: &myData )) == paNullCallback)); cannam@89: */ cannam@89: cannam@89: /*----------------------------- Bad flag: */ cannam@89: ipp.hostApiSpecificStreamInfo = opp.hostApiSpecificStreamInfo = NULL; cannam@89: ipp.sampleFormat = opp.sampleFormat = paFloat32; cannam@89: ipp.channelCount = 0; ipp.device = paNoDevice; cannam@89: opp.channelCount = 2; opp.device = Pa_GetDefaultOutputDevice(); cannam@89: HOPEFOR(((result = Pa_OpenStream(&stream, NULL, &opp, cannam@89: SAMPLE_RATE, FRAMES_PER_BUFFER, cannam@89: 255, /* Is 8 maybe legal V19 API? */ cannam@89: QaCallback, &myData )) == paInvalidFlag)); cannam@89: } cannam@89: cannam@89: /*----------------------------- using input device as output device: */ cannam@89: if( FindInputOnlyDevice() != paNoDevice ) cannam@89: { cannam@89: ipp.hostApiSpecificStreamInfo = opp.hostApiSpecificStreamInfo = NULL; cannam@89: ipp.sampleFormat = opp.sampleFormat = paFloat32; cannam@89: ipp.channelCount = 0; ipp.device = paNoDevice; /* And no input device, and no channels. */ cannam@89: opp.channelCount = 2; opp.device = FindInputOnlyDevice(); cannam@89: HOPEFOR(((result = Pa_OpenStream(&stream, NULL, &opp, cannam@89: SAMPLE_RATE, FRAMES_PER_BUFFER, cannam@89: paClipOff, QaCallback, &myData )) == paInvalidChannelCount)); cannam@89: } cannam@89: cannam@89: /*----------------------------- using output device as input device: */ cannam@89: if( FindOutputOnlyDevice() != paNoDevice ) cannam@89: { cannam@89: ipp.hostApiSpecificStreamInfo = opp.hostApiSpecificStreamInfo = NULL; cannam@89: ipp.sampleFormat = opp.sampleFormat = paFloat32; cannam@89: ipp.channelCount = 2; ipp.device = FindOutputOnlyDevice(); cannam@89: opp.channelCount = 0; opp.device = paNoDevice; /* And no output device, and no channels. */ cannam@89: HOPEFOR(((result = Pa_OpenStream(&stream, &ipp, NULL, cannam@89: SAMPLE_RATE, FRAMES_PER_BUFFER, cannam@89: paClipOff, QaCallback, &myData )) == paInvalidChannelCount)); cannam@89: cannam@89: } cannam@89: cannam@89: if( stream != NULL ) Pa_CloseStream( stream ); cannam@89: return result; cannam@89: } cannam@89: cannam@89: /*-----------------------------------------------------------------------------------------*/ cannam@89: static int TestBadActions( void ) cannam@89: { cannam@89: PaStream* stream = NULL; cannam@89: const PaDeviceInfo* deviceInfo = NULL; cannam@89: PaError result = 0; cannam@89: PaQaData myData; cannam@89: PaStreamParameters opp; cannam@89: const PaDeviceInfo* info = NULL; cannam@89: cannam@89: /* Setup data for synthesis thread. */ cannam@89: myData.framesLeft = (unsigned long)(SAMPLE_RATE * 100); /* 100 seconds */ cannam@89: myData.numChannels = 1; cannam@89: myData.mode = MODE_OUTPUT; cannam@89: cannam@89: opp.device = Pa_GetDefaultOutputDevice(); /* Default output. */ cannam@89: opp.channelCount = 2; /* Stereo output. */ cannam@89: opp.hostApiSpecificStreamInfo = NULL; cannam@89: opp.sampleFormat = paFloat32; cannam@89: info = Pa_GetDeviceInfo(opp.device); cannam@89: opp.suggestedLatency = info ? info->defaultLowOutputLatency : 0.100; cannam@89: cannam@89: if (opp.device != paNoDevice) { cannam@89: HOPEFOR(((result = Pa_OpenStream(&stream, NULL, /* Take NULL as input parame- */ cannam@89: &opp, /* ters, meaning try only output. */ cannam@89: SAMPLE_RATE, FRAMES_PER_BUFFER, cannam@89: paClipOff, QaCallback, &myData )) == paNoError)); cannam@89: } cannam@89: cannam@89: HOPEFOR(((deviceInfo = Pa_GetDeviceInfo(paNoDevice)) == NULL)); cannam@89: HOPEFOR(((deviceInfo = Pa_GetDeviceInfo(87654)) == NULL)); cannam@89: HOPEFOR(((result = Pa_StartStream(NULL)) == paBadStreamPtr)); cannam@89: HOPEFOR(((result = Pa_StopStream(NULL)) == paBadStreamPtr)); cannam@89: HOPEFOR(((result = Pa_IsStreamStopped(NULL)) == paBadStreamPtr)); cannam@89: HOPEFOR(((result = Pa_IsStreamActive(NULL)) == paBadStreamPtr)); cannam@89: HOPEFOR(((result = Pa_CloseStream(NULL)) == paBadStreamPtr)); cannam@89: HOPEFOR(((result = Pa_SetStreamFinishedCallback(NULL, NULL)) == paBadStreamPtr)); cannam@89: HOPEFOR(((result = !Pa_GetStreamInfo(NULL)))); cannam@89: HOPEFOR(((result = Pa_GetStreamTime(NULL)) == 0.0)); cannam@89: HOPEFOR(((result = Pa_GetStreamCpuLoad(NULL)) == 0.0)); cannam@89: HOPEFOR(((result = Pa_ReadStream(NULL, NULL, 0)) == paBadStreamPtr)); cannam@89: HOPEFOR(((result = Pa_WriteStream(NULL, NULL, 0)) == paBadStreamPtr)); cannam@89: cannam@89: /** @todo test Pa_GetStreamReadAvailable and Pa_GetStreamWriteAvailable */ cannam@89: cannam@89: if (stream != NULL) Pa_CloseStream(stream); cannam@89: return result; cannam@89: } cannam@89: cannam@89: /*---------------------------------------------------------------------*/ cannam@89: int main(void); cannam@89: int main(void) cannam@89: { cannam@89: PaError result; cannam@89: cannam@89: EXPECT(((result = Pa_Initialize()) == paNoError)); cannam@89: TestBadOpens(); cannam@89: TestBadActions(); cannam@89: error: cannam@89: Pa_Terminate(); cannam@89: printf("QA Report: %d passed, %d failed.\n", gNumPassed, gNumFailed); cannam@89: return 0; cannam@89: }