git.gag.com Git - debian/gnuradio/blob - gr-audio-portaudio/src/audio_portaudio_sink.cc

   1 /* -*- c++ -*- */
   2 /*
   3  * Copyright 2006 Free Software Foundation, Inc.
   4  *
   5  * This file is part of GNU Radio
   6  *
   7  * GNU Radio is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; either version 2, or (at your option)
  10  * any later version.
  11  *
  12  * GNU Radio is distributed in he hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License
  18  * along with GNU Radio; see the file COPYING.  If not, write to
  19  * the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  20  * Boston, MA 02111-1307, USA.
  21  */
  22
  23 #ifdef HAVE_CONFIG_H
  24 #include "config.h"
  25 #endif
  26
  27 #include <audio_portaudio_sink.h>
  28 #include <gr_io_signature.h>
  29 #include <gr_prefs.h>
  30 #include <stdio.h>
  31 #include <iostream>
  32 #include <unistd.h>
  33 #include <stdexcept>
  34 #include <gri_portaudio.h>
  35 #include <omnithread.h>
  36
  37 #define LOGGING   0             // define to 0 or 1
  38
  39 #define SAMPLE_FORMAT           paFloat32
  40 typedef float sample_t;
  41
  42 // Number of portaudio buffers in the ringbuffer
  43 static const unsigned int N_BUFFERS = 4;
  44
  45 static std::string
  46 default_device_name ()
  47 {
  48   return gr_prefs::singleton()->get_string("audio_portaudio", "default_output_device", "");
  49 }
  50
  51 void
  52 audio_portaudio_sink::create_ringbuffer(void)
  53 {
  54   int bufsize_samples = d_portaudio_buffer_size_frames * d_output_parameters.channelCount;
  55
  56   if (d_verbose)
  57     fprintf(stderr,"ring buffer size  = %d frames\n",
  58             N_BUFFERS*bufsize_samples/d_output_parameters.channelCount);
  59
  60   // FYI, the buffer indicies are in units of samples.
  61   d_writer = gr_make_buffer(N_BUFFERS * bufsize_samples, sizeof(sample_t));
  62   d_reader = gr_buffer_add_reader(d_writer, 0);
  63 }
  64
  65 /*
  66  * This routine will be called by the PortAudio engine when audio is needed.
  67  * It may called at interrupt level on some machines so don't do anything
  68  * that could mess up the system like calling malloc() or free().
  69  *
  70  * Our job is to write framesPerBuffer frames into outputBuffer.
  71  */
  72 int
  73 portaudio_sink_callback (const void *inputBuffer,
  74                          void *outputBuffer,
  75                          unsigned long framesPerBuffer,
  76                          const PaStreamCallbackTimeInfo* timeInfo,
  77                          PaStreamCallbackFlags statusFlags,
  78                          void *arg)
  79 {
  80   audio_portaudio_sink *self = (audio_portaudio_sink *)arg;
  81   int nreqd_samples =
  82     framesPerBuffer * self->d_output_parameters.channelCount;
  83
  84   int navail_samples = self->d_reader->items_available();
  85
  86   if (nreqd_samples <= navail_samples){  // We've got enough data...
  87     if (LOGGING)
  88       self->d_log->printf("PAsink cb: f/b = %4ld\n", framesPerBuffer);
  89     // copy from ringbuffer into output buffer
  90     memcpy(outputBuffer,
  91            self->d_reader->read_pointer(),
  92            nreqd_samples * sizeof(sample_t));
  93     self->d_reader->update_read_pointer(nreqd_samples);
  94
  95     // Tell the sink thread there is new room in the ringbuffer.
  96     self->d_ringbuffer_ready.post();
  97     return paContinue;
  98   }
  99
 100   else {                        // underrun
 101     if (LOGGING)
 102       self->d_log->printf("PAsink cb: f/b = %4ld UNDERRUN\n", framesPerBuffer);
 103
 104     self->d_nunderuns++;
 105     ::write(2, "aU", 2);        // FIXME change to non-blocking call
 106
 107     // FIXME we should transfer what we've got and pad the rest
 108     memset(outputBuffer, 0, nreqd_samples * sizeof(sample_t));
 109
 110     self->d_ringbuffer_ready.post();  // Tell the sink to get going!
 111     return paContinue;
 112   }
 113 }
 114
 115
 116 // ----------------------------------------------------------------
 117
 118 audio_portaudio_sink_sptr
 119 audio_portaudio_make_sink (int sampling_rate, const std::string dev, bool ok_to_block)
 120 {
 121   return audio_portaudio_sink_sptr (new audio_portaudio_sink (sampling_rate,
 122                                                               dev, ok_to_block));
 123 }
 124
 125 audio_portaudio_sink::audio_portaudio_sink(int sampling_rate,
 126                                            const std::string device_name,
 127                                            bool ok_to_block)
 128   : gr_sync_block ("audio_portaudio_sink",
 129                    gr_make_io_signature(0, 0, 0),
 130                    gr_make_io_signature(0, 0, 0)),
 131     d_sampling_rate(sampling_rate),
 132     d_device_name(device_name.empty() ? default_device_name() : device_name),
 133     d_ok_to_block(ok_to_block),
 134     d_verbose(gr_prefs::singleton()->get_bool("audio_portaudio", "verbose", false)),
 135     d_portaudio_buffer_size_frames(0),
 136     d_stream(0),
 137     d_ringbuffer_ready(1, 1),           // binary semaphore
 138     d_nunderuns(0)
 139 {
 140   memset(&d_output_parameters, 0, sizeof(d_output_parameters));
 141   if (LOGGING)
 142     d_log = gri_logger::singleton();
 143
 144   PaError             err;
 145   int                 i, numDevices;
 146   PaDeviceIndex       device = 0;
 147   const PaDeviceInfo *deviceInfo = NULL;
 148
 149   err = Pa_Initialize();
 150   if (err != paNoError) {
 151     bail ("Initialize failed", err);
 152   }
 153
 154   if (d_verbose)
 155     gri_print_devices();
 156
 157   numDevices = Pa_GetDeviceCount();
 158   if (numDevices < 0)
 159     bail("Pa Device count failed", 0);
 160   if (numDevices == 0)
 161     bail("no devices available", 0);
 162
 163   if (d_device_name.empty())
 164   {
 165     // FIXME Get smarter about picking something
 166     fprintf(stderr,"\nUsing Default Device\n");
 167     device = Pa_GetDefaultOutputDevice();
 168     deviceInfo = Pa_GetDeviceInfo(device);
 169     fprintf(stderr,"%s is the chosen device using %s as the host\n",
 170             deviceInfo->name, Pa_GetHostApiInfo(deviceInfo->hostApi)->name);
 171   }
 172   else
 173   {
 174     bool found = false;
 175     fprintf(stderr,"\nTest Devices\n");
 176     for (i=0;i<numDevices;i++) {
 177       deviceInfo = Pa_GetDeviceInfo( i );
 178       fprintf(stderr,"Testing device name: %s",deviceInfo->name);
 179       if (strstr(deviceInfo->name, d_device_name.c_str())){
 180         fprintf(stderr,"  Chosen!\n");
 181         device = gri_pa_find_device_by_name(deviceInfo->name);
 182         fprintf(stderr,"%s using %s as the host\n",d_device_name.c_str(),
 183                 Pa_GetHostApiInfo(deviceInfo->hostApi)->name), fflush(stderr);
 184         found = true;
 185         deviceInfo = Pa_GetDeviceInfo(device);
 186         i = numDevices;         // force loop exit
 187       }
 188       fprintf(stderr,"\n"),fflush(stderr);
 189     }
 190
 191     if (!found){
 192       bail("Failed to find specified device name", 0);
 193       exit(1);
 194     }
 195   }
 196
 197
 198   d_output_parameters.device = device;
 199   d_output_parameters.channelCount     = deviceInfo->maxOutputChannels;
 200   d_output_parameters.sampleFormat     = SAMPLE_FORMAT;
 201   d_output_parameters.suggestedLatency = deviceInfo->defaultLowOutputLatency;
 202   d_output_parameters.hostApiSpecificStreamInfo = NULL;
 203
 204   // We fill in the real channelCount in check_topology when we know
 205   // how many inputs are connected to us.
 206
 207   // Now that we know the maximum number of channels (allegedly)
 208   // supported by the h/w, we can compute a reasonable input
 209   // signature.  The portaudio specs say that they'll accept any
 210   // number of channels from 1 to max.
 211   set_input_signature(gr_make_io_signature(1, deviceInfo->maxOutputChannels,
 212                                            sizeof (sample_t)));
 213 }
 214
 215
 216 bool
 217 audio_portaudio_sink::check_topology (int ninputs, int noutputs)
 218 {
 219   PaError err;
 220
 221   if (Pa_IsStreamActive(d_stream))
 222   {
 223       Pa_CloseStream(d_stream);
 224       d_stream = 0;
 225       d_reader.reset();         // boost::shared_ptr for d_reader = 0
 226       d_writer.reset();         // boost::shared_ptr for d_write = 0
 227   }
 228
 229   d_output_parameters.channelCount = ninputs;   // # of channels we're really using
 230
 231 #if 1
 232   d_portaudio_buffer_size_frames = (int)(0.0213333333  * d_sampling_rate + 0.5);  // Force 1024 frame buffers at 48000
 233   fprintf(stderr, "Latency = %8.5f, requested sampling_rate = %g\n", // Force latency to 21.3333333.. ms
 234           0.0213333333, (double)d_sampling_rate);
 235 #endif
 236   err = Pa_OpenStream(&d_stream,
 237                       NULL,                     // No input
 238                       &d_output_parameters,
 239                       d_sampling_rate,
 240                       d_portaudio_buffer_size_frames,
 241                       paClipOff,
 242                       &portaudio_sink_callback,
 243                       (void*)this);
 244
 245   if (err != paNoError) {
 246     output_error_msg ("OpenStream failed", err);
 247     return false;
 248   }
 249
 250 #if 0
 251   const PaStreamInfo *psi = Pa_GetStreamInfo(d_stream);
 252
 253   d_portaudio_buffer_size_frames = (int)(d_output_parameters.suggestedLatency  * psi->sampleRate);
 254   fprintf(stderr, "Latency = %7.4f, psi->sampleRate = %g\n",
 255           d_output_parameters.suggestedLatency, psi->sampleRate);
 256 #endif
 257
 258   fprintf(stderr, "d_portaudio_buffer_size_frames = %d\n", d_portaudio_buffer_size_frames);
 259
 260   assert(d_portaudio_buffer_size_frames != 0);
 261
 262   create_ringbuffer();
 263
 264   err = Pa_StartStream(d_stream);
 265   if (err != paNoError) {
 266     output_error_msg ("StartStream failed", err);
 267     return false;
 268   }
 269
 270   return true;
 271 }
 272
 273 audio_portaudio_sink::~audio_portaudio_sink ()
 274 {
 275   Pa_StopStream(d_stream);      // wait for output to drain
 276   Pa_CloseStream(d_stream);
 277   Pa_Terminate();
 278 }
 279
 280 /*
 281  * This version consumes everything sent to it, blocking if required.
 282  * I think this will allow us better control of the total buffering/latency
 283  * in the audio path.
 284  */
 285 int
 286 audio_portaudio_sink::work (int noutput_items,
 287                             gr_vector_const_void_star &input_items,
 288                             gr_vector_void_star &output_items)
 289 {
 290   const float **in = (const float **) &input_items[0];
 291   const unsigned nchan = d_output_parameters.channelCount; // # of channels == samples/frame
 292
 293   int k;
 294   for (k = 0; k < noutput_items; ){
 295
 296     int nframes = d_writer->space_available() / nchan;  // How much space in ringbuffer
 297     if (nframes == 0){                  // no room...
 298       if (d_ok_to_block){
 299         d_ringbuffer_ready.wait();      // block here, then try again
 300         continue;
 301       }
 302       else {
 303         // There's no room and we're not allowed to block.
 304         // (A USRP is most likely controlling the pacing through the pipeline.)
 305         // We drop the samples on the ground, and say we processed them all ;)
 306         //
 307         // FIXME, there's probably room for a bit more finesse here.
 308         return noutput_items;
 309       }
 310     }
 311
 312     // We can write the smaller of the request and the room we've got
 313     int nf = std::min(noutput_items - k, nframes);
 314
 315     float *p = (float *) d_writer->write_pointer();
 316     for (int i = 0; i < nf; i++){
 317       for (unsigned int c = 0; c < nchan; c++){
 318         *p++ = in[c][k + i];
 319       }
 320     }
 321     d_writer->update_write_pointer(nf * nchan);
 322     k += nf;
 323   }
 324
 325   return k;  // tell how many we actually did
 326 }
 327
 328 void
 329 audio_portaudio_sink::output_error_msg (const char *msg, int err)
 330 {
 331   fprintf (stderr, "audio_portaudio_sink[%s]: %s: %s\n",
 332            d_device_name.c_str (), msg, Pa_GetErrorText(err));
 333 }
 334
 335 void
 336 audio_portaudio_sink::bail (const char *msg, int err) throw (std::runtime_error)
 337 {
 338   output_error_msg (msg, err);
 339   throw std::runtime_error ("audio_portaudio_sink");
 340 }