git.gag.com Git - debian/gnuradio/blob - gnuradio-core/src/lib/runtime/gr_top_block_impl.h

   1 /* -*- c++ -*- */
   2 /*
   3  * Copyright 2007,2008 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 3, or (at your option)
  10  * any later version.
  11  *
  12  * GNU Radio is distributed in the 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., 51 Franklin Street,
  20  * Boston, MA 02110-1301, USA.
  21  */
  22
  23 #ifndef INCLUDED_GR_TOP_BLOCK_IMPL_H
  24 #define INCLUDED_GR_TOP_BLOCK_IMPL_H
  25
  26 #include <gr_scheduler_thread.h>
  27
  28 /*!
  29  *\brief Abstract implementation details of gr_top_block
  30  * \ingroup internal
  31  *
  32  * The actual implementation of gr_top_block. Separate class allows
  33  * decoupling of changes from dependent classes.
  34  *
  35  */
  36 class gr_top_block_impl
  37 {
  38 public:
  39   gr_top_block_impl(gr_top_block *owner);
  40   virtual ~gr_top_block_impl();
  41
  42   // Create and start scheduler threads
  43   virtual void start();
  44
  45   // Signal scheduler threads to stop
  46   virtual void stop() = 0;
  47
  48   // Wait for scheduler threads to exit
  49   virtual void wait() = 0;
  50
  51   // Lock the top block to allow reconfiguration
  52   virtual void lock();
  53
  54   // Unlock the top block at end of reconfiguration
  55   virtual void unlock();
  56
  57   // Dump the flowgraph to stdout
  58   void dump();
  59
  60   // Return true if flowgraph is running
  61   bool is_running() const { return d_running; }
  62
  63 protected:
  64
  65   gr_top_block                  *d_owner;
  66   bool                           d_running;
  67   gr_flat_flowgraph_sptr         d_ffg;
  68
  69   omni_mutex                     d_reconf;      // protects d_lock_count
  70   int                            d_lock_count;
  71
  72   virtual void start_threads() = 0;
  73   virtual void restart();
  74
  75 /*!
  76  * Make a vector of gr_block from a vector of gr_basic_block
  77  *
  78  * Pass-by-value to avoid problem with possible asynchronous modification
  79  */
  80   static gr_block_vector_t make_gr_block_vector(gr_basic_block_vector_t blocks);
  81
  82 };
  83
  84 #endif /* INCLUDED_GR_TOP_BLOCK_IMPL_H */