audio_portaudio_source.h

Go to the documentation of this file.
00001 /* -*- c++ -*- */
00002 /*
00003  * Copyright 2006 Free Software Foundation, Inc.
00004  * 
00005  * This file is part of GNU Radio
00006  * 
00007  * GNU Radio is free software; you can redistribute it and/or modify
00008  * it under the terms of the GNU General Public License as published by
00009  * the Free Software Foundation; either version 3, or (at your option)
00010  * any later version.
00011  * 
00012  * GNU Radio is distributed in the hope that it will be useful,
00013  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00014  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
00015  * GNU General Public License for more details.
00016  * 
00017  * You should have received a copy of the GNU General Public License
00018  * along with GNU Radio; see the file COPYING.  If not, write to
00019  * the Free Software Foundation, Inc., 51 Franklin Street,
00020  * Boston, MA 02110-1301, USA.
00021  */
00022 #ifndef INCLUDED_AUDIO_PORTAUDIO_SOURCE_H
00023 #define INCLUDED_AUDIO_PORTAUDIO_SOURCE_H
00024 
00025 #include <gr_sync_block.h>
00026 #include <gr_buffer.h>
00027 #include <gnuradio/omnithread.h>
00028 #include <string>
00029 #include <portaudio.h>
00030 #include <stdexcept>
00031 #include <gri_logger.h>
00032 
00033 class audio_portaudio_source;
00034 typedef boost::shared_ptr<audio_portaudio_source> audio_portaudio_source_sptr;
00035 
00036 /*!
00037  * \brief PORTAUDIO audio source.
00038  *
00039  * \param sampling_rate sampling rate in Hz
00040  * \param device_name PORTAUDIO device name, e.g., "pa:"
00041  * \param ok_to_block   true if it's ok for us to block
00042  */
00043 audio_portaudio_source_sptr
00044 audio_portaudio_make_source (int sampling_rate,
00045                            const std::string device_name = "",
00046                            bool ok_to_block = true);
00047 
00048 PaStreamCallback portaudio_source_callback;
00049 
00050 
00051 /*!
00052  * \ Audio source using PORTAUDIO
00053  *
00054  * Input samples must be in the range [-1,1].
00055  */
00056 class audio_portaudio_source : public gr_sync_block {
00057   friend audio_portaudio_source_sptr
00058   audio_portaudio_make_source (int sampling_rate,
00059                              const std::string device_name,
00060                              bool ok_to_block);
00061 
00062   friend PaStreamCallback portaudio_source_callback;
00063 
00064 
00065   unsigned int          d_sampling_rate;
00066   std::string           d_device_name;
00067   bool                  d_ok_to_block;
00068   bool                  d_verbose;
00069 
00070   unsigned int          d_portaudio_buffer_size_frames; // number of frames in a portaudio buffer
00071 
00072   PaStream              *d_stream;
00073   PaStreamParameters    d_input_parameters;
00074 
00075   gr_buffer_sptr        d_writer;               // buffer used between work and callback
00076   gr_buffer_reader_sptr d_reader;
00077   omni_semaphore        d_ringbuffer_ready;     // binary semaphore
00078 
00079   // random stats
00080   int                   d_noverruns;            // count of overruns
00081   gri_logger_sptr       d_log;                  // handle to non-blocking logging instance
00082 
00083   void output_error_msg (const char *msg, int err);
00084   void bail (const char *msg, int err) throw (std::runtime_error);
00085   void create_ringbuffer();
00086 
00087 
00088  protected:
00089   audio_portaudio_source (int sampling_rate, const std::string device_name,
00090                         bool ok_to_block);
00091 
00092  public:
00093   ~audio_portaudio_source ();
00094   
00095   bool check_topology (int ninputs, int noutputs);
00096 
00097   int work (int ninput_items,
00098             gr_vector_const_void_star &input_items,
00099             gr_vector_void_star &output_items);
00100 };
00101 
00102 #endif /* INCLUDED_AUDIO_PORTAUDIO_SOURCE_H */