Merge branch 'master' into windows
[ardour.git] / libs / ardour / audioengine.cc
index 1e43c590a0fb8c3d7cac829607c8acf25bf2d48c..0119aa642c4e298af3595d69295eb008ba9c909d 100644 (file)
 #include "pbd/stacktrace.h"
 #include "pbd/unknown_type.h"
 
-#include <jack/weakjack.h>
-
 #include "midi++/port.h"
-#include "midi++/jack_midi_port.h"
 #include "midi++/mmc.h"
-#include "midi++/manager.h"
 
+#include "ardour/async_midi_port.h"
 #include "ardour/audio_port.h"
 #include "ardour/audio_backend.h"
 #include "ardour/audioengine.h"
@@ -50,6 +47,8 @@
 #include "ardour/internal_send.h"
 #include "ardour/meter.h"
 #include "ardour/midi_port.h"
+#include "ardour/midiport_manager.h"
+#include "ardour/mtdm.h"
 #include "ardour/port.h"
 #include "ardour/process_thread.h"
 #include "ardour/session.h"
@@ -63,71 +62,46 @@ using namespace PBD;
 gint AudioEngine::m_meter_exit;
 AudioEngine* AudioEngine::_instance = 0;
 
-AudioEngine::AudioEngine (const std::string& bcn, const std::string& bsu)
-       : _backend (0)
-       , session_remove_pending (false)
+AudioEngine::AudioEngine ()
+       : session_remove_pending (false)
        , session_removal_countdown (-1)
+       , _running (false)
+       , _freewheeling (false)
        , monitor_check_interval (INT32_MAX)
        , last_monitor_check (0)
        , _processed_frames (0)
-       , _freewheeling (false)
-       , _pre_freewheel_mmc_enabled (false)
-       , _usecs_per_cycle (0)
-       , port_remove_in_progress (false)
        , m_meter_thread (0)
        , _main_thread (0)
-       , backend_client_name (bcn)
-       , backend_session_uuid (bsu)
+       , _mtdm (0)
+       , _measuring_latency (false)
+       , _latency_input_port (0)
+       , _latency_output_port (0)
+       , _latency_flush_frames (0)
+       , _latency_signal_latency (0)
+       , _stopped_for_latency (false)
+       , _in_destructor (false)
 {
        g_atomic_int_set (&m_meter_exit, 0);
+       discover_backends ();
 }
 
 AudioEngine::~AudioEngine ()
 {
+       _in_destructor = true;
+       stop_metering_thread ();
        drop_backend ();
-
-       config_connection.disconnect ();
-
-       {
-               Glib::Threads::Mutex::Lock tm (_process_lock);
-               session_removed.signal ();
-               stop_metering_thread ();
-       }
 }
 
 AudioEngine*
-AudioEngine::create (const std::string& bcn, const std::string& bsu)
+AudioEngine::create ()
 {
        if (_instance) {
                return _instance;
        }
-       return new AudioEngine (bcn, bsu);
-}
 
-void
-AudioEngine::drop_backend ()
-{
-       if (_backend) {
-               _backend->stop ();
-               delete _backend;
-               _backend = 0;
-       }
-}
-
-int
-AudioEngine::set_backend (const std::string& name)
-{
-       BackendMap::iterator b = _backends.find (name);
-
-       if (b == _backends.end()) {
-               return -1;
-       }
-
-       drop_backend ();
-
-       _backend = b->second;
-
-       return 0;
+       _instance = new AudioEngine ();
+       
+       return _instance;
 }
 
 void
@@ -144,11 +118,9 @@ _thread_init_callback (void * /*arg*/)
 
        SessionEvent::create_per_thread_pool (X_("Audioengine"), 512);
 
-       MIDI::JackMIDIPort::set_process_thread (pthread_self());
+       AsyncMIDIPort::set_process_thread (pthread_self());
 }
 
-
-
 void
 AudioEngine::split_cycle (pframes_t offset)
 {
@@ -165,6 +137,33 @@ AudioEngine::split_cycle (pframes_t offset)
        }
 }
 
+int
+AudioEngine::sample_rate_change (pframes_t nframes)
+{
+       /* check for monitor input change every 1/10th of second */
+
+       monitor_check_interval = nframes / 10;
+       last_monitor_check = 0;
+
+       if (_session) {
+               _session->set_frame_rate (nframes);
+       }
+
+       SampleRateChanged (nframes); /* EMIT SIGNAL */
+
+       return 0;
+}
+
+int 
+AudioEngine::buffer_size_change (pframes_t bufsiz)
+{
+       if (_session) {
+               _session->set_block_size (bufsiz);
+               last_monitor_check = 0;
+       }
+
+       return 0;
+}
 
 /** Method called by our ::process_thread when there is work to be done.
  *  @param nframes Number of frames to process.
@@ -194,6 +193,50 @@ AudioEngine::process_callback (pframes_t nframes)
                return 0;
        }
 
+       bool return_after_remove_check = false;
+
+       if (_measuring_latency && _mtdm) {
+               /* run a normal cycle from the perspective of the PortManager
+                  so that we get silence on all registered ports.
+                  
+                  we overwrite the silence on the two ports used for latency
+                  measurement.
+               */
+               
+               PortManager::cycle_start (nframes);
+               PortManager::silence (nframes);
+
+               if (_latency_input_port && _latency_output_port) {
+                       PortEngine& pe (port_engine());
+
+                       Sample* in = (Sample*) pe.get_buffer (_latency_input_port, nframes);
+                       Sample* out = (Sample*) pe.get_buffer (_latency_output_port, nframes);
+
+                       _mtdm->process (nframes, in, out);
+               }
+
+               PortManager::cycle_end (nframes);
+               return_after_remove_check = true;
+
+       } else if (_latency_flush_frames) {
+               
+               /* wait for the appropriate duration for the MTDM signal to
+                * drain from the ports before we revert to normal behaviour.
+                */
+
+               PortManager::cycle_start (nframes);
+               PortManager::silence (nframes);
+               PortManager::cycle_end (nframes);
+               
+                if (_latency_flush_frames > nframes) {
+                        _latency_flush_frames -= nframes;
+                } else {
+                        _latency_flush_frames = 0;
+                }
+
+               return_after_remove_check = true;
+       }
+
        if (session_remove_pending) {
 
                /* perform the actual session removal */
@@ -201,7 +244,7 @@ AudioEngine::process_callback (pframes_t nframes)
                if (session_removal_countdown < 0) {
 
                        /* fade out over 1 second */
-                       session_removal_countdown = _frame_rate/2;
+                       session_removal_countdown = sample_rate()/2;
                        session_removal_gain = 1.0;
                        session_removal_gain_step = 1.0/session_removal_countdown;
 
@@ -230,11 +273,15 @@ AudioEngine::process_callback (pframes_t nframes)
                }
        }
 
+       if (return_after_remove_check) {
+               return 0;
+       }
+
        if (_session == 0) {
 
                if (!_freewheeling) {
-                       MIDI::Manager::instance()->cycle_start(nframes);
-                       MIDI::Manager::instance()->cycle_end();
+                       PortManager::cycle_start (nframes);
+                       PortManager::cycle_end (nframes);
                }
 
                _processed_frames = next_processed_frames;
@@ -245,34 +292,22 @@ AudioEngine::process_callback (pframes_t nframes)
        /* tell all relevant objects that we're starting a new cycle */
 
        InternalSend::CycleStart (nframes);
-       Port::set_global_port_buffer_offset (0);
-        Port::set_cycle_framecnt (nframes);
 
        /* tell all Ports that we're starting a new cycle */
 
-       boost::shared_ptr<Ports> p = ports.reader();
-
-       for (Ports::iterator i = p->begin(); i != p->end(); ++i) {
-               i->second->cycle_start (nframes);
-       }
+       PortManager::cycle_start (nframes);
 
        /* test if we are freewheeling and there are freewheel signals connected.
            ardour should act normally even when freewheeling unless /it/ is
-           exporting 
+           exporting (which is what Freewheel.empty() tests for).
        */
 
        if (_freewheeling && !Freewheel.empty()) {
-
                 Freewheel (nframes);
-
        } else {
-               MIDI::Manager::instance()->cycle_start(nframes);
-
                if (_session) {
                        _session->process (nframes);
                }
-
-               MIDI::Manager::instance()->cycle_end();
        }
 
        if (_freewheeling) {
@@ -285,52 +320,18 @@ AudioEngine::process_callback (pframes_t nframes)
        }
 
        if (last_monitor_check + monitor_check_interval < next_processed_frames) {
-
-               boost::shared_ptr<Ports> p = ports.reader();
-
-               for (Ports::iterator i = p->begin(); i != p->end(); ++i) {
-
-                       bool x;
-
-                       if (i->second->last_monitor() != (x = i->second->monitoring_input ())) {
-                               i->second->set_last_monitor (x);
-                               /* XXX I think this is dangerous, due to
-                                  a likely mutex in the signal handlers ...
-                               */
-                               i->second->MonitorInputChanged (x); /* EMIT SIGNAL */
-                       }
-               }
+               
+               PortManager::check_monitoring ();
                last_monitor_check = next_processed_frames;
        }
 
        if (_session->silent()) {
-
-               for (Ports::iterator i = p->begin(); i != p->end(); ++i) {
-
-                       if (i->second->sends_output()) {
-                               i->second->get_buffer(nframes).silence(nframes);
-                       }
-               }
+               PortManager::silence (nframes);
        }
 
        if (session_remove_pending && session_removal_countdown) {
 
-               for (Ports::iterator i = p->begin(); i != p->end(); ++i) {
-
-                       if (i->second->sends_output()) {
-
-                               boost::shared_ptr<AudioPort> ap = boost::dynamic_pointer_cast<AudioPort> (i->second);
-                               if (ap) {
-                                       Sample* s = ap->engine_get_whole_audio_buffer ();
-                                       gain_t g = session_removal_gain;
-                                       
-                                       for (pframes_t n = 0; n < nframes; ++n) {
-                                               *s++ *= g;
-                                               g -= session_removal_gain_step;
-                                       }
-                               }
-                       }
-               }
+               PortManager::fade_out (session_removal_gain, session_removal_gain_step, nframes);
                
                if (session_removal_countdown > nframes) {
                        session_removal_countdown -= nframes;
@@ -341,11 +342,7 @@ AudioEngine::process_callback (pframes_t nframes)
                session_removal_gain -= (nframes * session_removal_gain_step);
        }
 
-       // Finalize ports
-
-       for (Ports::iterator i = p->begin(); i != p->end(); ++i) {
-               i->second->cycle_end (nframes);
-       }
+       PortManager::cycle_end (nframes);
 
        _processed_frames = next_processed_frames;
 
@@ -397,19 +394,9 @@ AudioEngine::set_session (Session *s)
 
        if (_session) {
 
-               start_metering_thread ();
-
-               pframes_t blocksize = _backend->get_buffer_size ();
-
-               /* page in as much of the session process code as we
-                  can before we really start running.
-               */
-
-               boost::shared_ptr<Ports> p = ports.reader();
+               pframes_t blocksize = samples_per_cycle ();
 
-               for (Ports::iterator i = p->begin(); i != p->end(); ++i) {
-                       i->second->cycle_start (blocksize);
-               }
+               PortManager::cycle_start (blocksize);
 
                _session->process (blocksize);
                _session->process (blocksize);
@@ -420,9 +407,7 @@ AudioEngine::set_session (Session *s)
                _session->process (blocksize);
                _session->process (blocksize);
 
-               for (Ports::iterator i = p->begin(); i != p->end(); ++i) {
-                       i->second->cycle_end (blocksize);
-               }
+               PortManager::cycle_end (blocksize);
        }
 }
 
@@ -433,10 +418,9 @@ AudioEngine::remove_session ()
 
        if (_running) {
 
-               stop_metering_thread ();
-
                if (_session) {
                        session_remove_pending = true;
+                       session_removal_countdown = 0;
                        session_removed.wait(_process_lock);
                }
 
@@ -456,8 +440,6 @@ AudioEngine::died ()
        stop_metering_thread ();
 
         _running = false;
-       _buffer_size = 0;
-       _frame_rate = 0;
 }
 
 int
@@ -485,12 +467,12 @@ int
 AudioEngine::discover_backends ()
 {
        vector<std::string> backend_modules;
-       AudioBackend* backend;
 
        _backends.clear ();
 
-       Glib::PatternSpec so_extension_pattern("*.so");
-       Glib::PatternSpec dylib_extension_pattern("*.dylib");
+       Glib::PatternSpec so_extension_pattern("*backend.so");
+       Glib::PatternSpec dylib_extension_pattern("*backend.dylib");
+       Glib::PatternSpec dll_extension_pattern("*backend.dll");
 
        find_matching_files_in_search_path (backend_search_path (),
                                            so_extension_pattern, backend_modules);
@@ -498,93 +480,184 @@ AudioEngine::discover_backends ()
        find_matching_files_in_search_path (backend_search_path (),
                                            dylib_extension_pattern, backend_modules);
 
-       DEBUG_TRACE (DEBUG::Panning, string_compose (_("looking for backends in %1"), backend_search_path().to_string()));
+       find_matching_files_in_search_path (backend_search_path (),
+                                           dll_extension_pattern, backend_modules);
+
+       DEBUG_TRACE (DEBUG::Panning, string_compose (_("looking for backends in %1\n"), backend_search_path().to_string()));
 
        for (vector<std::string>::iterator i = backend_modules.begin(); i != backend_modules.end(); ++i) {
-               if ((backend = backend_discover (*i)) != 0) {
-                       _backends.insert (make_pair (backend->name(), backend));
+
+               AudioBackendInfo* info;
+
+               if ((info = backend_discover (*i)) != 0) {
+                       _backends.insert (make_pair (info->name, info));
                }
        }
 
        return _backends.size();
 }
 
-AudioBackend*
+AudioBackendInfo*
 AudioEngine::backend_discover (const string& path)
 {
-       Glib::Module* module = new Glib::Module(path);
-       AudioBackend* (*dfunc)(void);
+       Glib::Module module (path);
+       AudioBackendInfo* info;
+       AudioBackendInfo* (*dfunc)(void);
        void* func = 0;
 
        if (!module) {
                error << string_compose(_("AudioEngine: cannot load module \"%1\" (%2)"), path,
-                               Glib::Module::get_last_error()) << endmsg;
-               delete module;
+                                       Glib::Module::get_last_error()) << endmsg;
                return 0;
        }
-
-       if (!module->get_symbol("backend_factory", func)) {
-               error << string_compose(_("AudioEngine: module \"%1\" has no factory function."), path) << endmsg;
+       
+       if (!module.get_symbol ("descriptor", func)) {
+               error << string_compose(_("AudioEngine: backend at \"%1\" has no descriptor function."), path) << endmsg;
                error << Glib::Module::get_last_error() << endmsg;
-               delete module;
                return 0;
        }
 
-       dfunc = (AudioBackend* (*)(void))func;
-       AudioBackend* backend = dfunc();
+       module.make_resident ();
+       
+       dfunc = (AudioBackendInfo* (*)(void))func;
+       info = dfunc();
+       
+       return info;
+}
 
-       return backend;
+vector<const AudioBackendInfo*>
+AudioEngine::available_backends() const
+{
+       vector<const AudioBackendInfo*> r;
+       
+       for (BackendMap::const_iterator i = _backends.begin(); i != _backends.end(); ++i) {
+               r.push_back (i->second);
+       }
+
+       return r;
 }
 
-/* BACKEND PROXY WRAPPERS */
+string
+AudioEngine::current_backend_name() const
+{
+       if (_backend) {
+               return _backend->name();
+       } 
+       return string();
+}
 
-int
-AudioEngine::start ()
+void
+AudioEngine::drop_backend ()
 {
-       if (!_backend) {
-               return -1;
+       if (_backend) {
+               _backend->stop ();
+               _backend.reset ();
        }
+}
 
-       if (!_running) {
+boost::shared_ptr<AudioBackend>
+AudioEngine::set_default_backend ()
+{
+       if (_backends.empty()) {
+               return boost::shared_ptr<AudioBackend>();
+       }
 
-               if (_session) {
-                       BootMessage (_("Connect session to engine"));
-                       _session->set_frame_rate (_backend->sample_rate());
-               }
+       return set_backend (_backends.begin()->first, "", "");
+}
 
-               _processed_frames = 0;
-               last_monitor_check = 0;
+boost::shared_ptr<AudioBackend>
+AudioEngine::set_backend (const std::string& name, const std::string& arg1, const std::string& arg2)
+{
+       BackendMap::iterator b = _backends.find (name);
 
-               if (_backend->start() == 0) {
-                       _running = true;
-                       _has_run = true;
-                       Running(); /* EMIT SIGNAL */
-               } else {
-                       /* should report error? */
+       if (b == _backends.end()) {
+               return boost::shared_ptr<AudioBackend>();
+       }
+
+       drop_backend ();
+       
+       try {
+               if (b->second->instantiate (arg1, arg2)) {
+                       throw failed_constructor ();
                }
+
+               _backend = b->second->factory (*this);
+
+       } catch (exception& e) {
+               error << string_compose (_("Could not create backend for %1: %2"), name, e.what()) << endmsg;
+               return boost::shared_ptr<AudioBackend>();
        }
-               
-       return _running ? 0 : -1;
+
+       return _backend;
 }
 
+/* BACKEND PROXY WRAPPERS */
+
 int
-AudioEngine::stop ()
+AudioEngine::start (bool for_latency)
 {
        if (!_backend) {
+               return -1;
+       }
+
+       if (_running) {
                return 0;
        }
+
+       _processed_frames = 0;
+       last_monitor_check = 0;
+       
+       if (_backend->start (for_latency)) {
+               return -1;
+       }
+
+       _running = true;
+       
+       if (_session) {
+               _session->set_frame_rate (_backend->sample_rate());
+               
+               if (_session->config.get_jack_time_master()) {
+                       _backend->set_time_master (true);
+               }
+       }
+       
+       start_metering_thread ();
+       
+       if (!for_latency) {
+               Running(); /* EMIT SIGNAL */
+       }
        
-       return _backend->stop ();
+       return 0;
 }
 
 int
-AudioEngine::pause ()
+AudioEngine::stop (bool for_latency)
 {
        if (!_backend) {
                return 0;
        }
+
+       Glib::Threads::Mutex::Lock lm (_process_lock);
+
+       if (_backend->stop ()) {
+               return -1;
+       }
+       
+       _running = false;
+       _processed_frames = 0;
+       _measuring_latency = false;
+       _latency_output_port = 0;
+       _latency_input_port = 0;
+       _started_for_latency = false;
+       stop_metering_thread ();
+       
+       Port::PortDrop ();
+
+       if (!for_latency) {
+               Stopped (); /* EMIT SIGNAL */
+       }
        
-       return _backend->pause ();
+       return 0;
 }
 
 int
@@ -605,7 +678,27 @@ AudioEngine::get_cpu_load() const
        if (!_backend) {
                return 0.0;
        }
-       return _backend->get_cpu_load ();
+       return _backend->cpu_load ();
+}
+
+bool
+AudioEngine::is_realtime() const 
+{
+       if (!_backend) {
+               return false;
+       }
+
+       return _backend->is_realtime();
+}
+
+bool
+AudioEngine::connected() const 
+{
+       if (!_backend) {
+               return false;
+       }
+
+       return _backend->available();
 }
 
 void
@@ -668,7 +761,7 @@ AudioEngine::samples_per_cycle () const
        if (!_backend) {
                return 0;
        }
-       return _backend->samples_per_cycle ();
+       return _backend->buffer_size ();
 }
 
 int
@@ -677,7 +770,7 @@ AudioEngine::usecs_per_cycle () const
        if (!_backend) {
                return -1;
        }
-       return _backend->start ();
+       return _backend->usecs_per_cycle ();
 }
 
 size_t
@@ -726,11 +819,330 @@ AudioEngine::get_sync_offset (pframes_t& offset) const
 }
 
 int
-AudioEngine::create_process_thread (boost::function<void()> func, pthread_t* thr, size_t stacksize)
+AudioEngine::create_process_thread (boost::function<void()> func)
+{
+       if (!_backend) {
+               return -1;
+       }
+       return _backend->create_process_thread (func);
+}
+
+int
+AudioEngine::join_process_threads ()
+{
+       if (!_backend) {
+               return -1;
+       }
+       return _backend->join_process_threads ();
+}
+
+bool
+AudioEngine::in_process_thread ()
+{
+       if (!_backend) {
+               return false;
+       }
+       return _backend->in_process_thread ();
+}
+
+uint32_t
+AudioEngine::process_thread_count ()
+{
+       if (!_backend) {
+               return 0;
+       }
+       return _backend->process_thread_count ();
+}
+
+int
+AudioEngine::set_device_name (const std::string& name)
+{
+       if (!_backend) {
+               return -1;
+       }
+       return _backend->set_device_name  (name);
+}
+
+int
+AudioEngine::set_sample_rate (float sr)
+{
+       if (!_backend) {
+               return -1;
+       }
+       return _backend->set_sample_rate  (sr);
+}
+
+int
+AudioEngine::set_buffer_size (uint32_t bufsiz)
+{
+       if (!_backend) {
+               return -1;
+       }
+       return _backend->set_buffer_size  (bufsiz);
+}
+
+int
+AudioEngine::set_sample_format (SampleFormat sf)
+{
+       if (!_backend) {
+               return -1;
+       }
+       return _backend->set_sample_format  (sf);
+}
+
+int
+AudioEngine::set_interleaved (bool yn)
 {
        if (!_backend) {
                return -1;
        }
-       return _backend->create_process_thread (func, thr, stacksize);
+       return _backend->set_interleaved  (yn);
 }
 
+int
+AudioEngine::set_input_channels (uint32_t ic)
+{
+       if (!_backend) {
+               return -1;
+       }
+       return _backend->set_input_channels  (ic);
+}
+
+int
+AudioEngine::set_output_channels (uint32_t oc)
+{
+       if (!_backend) {
+               return -1;
+       }
+       return _backend->set_output_channels (oc);
+}
+
+int
+AudioEngine::set_systemic_input_latency (uint32_t il)
+{
+       if (!_backend) {
+               return -1;
+       }
+       return _backend->set_systemic_input_latency  (il);
+}
+
+int
+AudioEngine::set_systemic_output_latency (uint32_t ol)
+{
+       if (!_backend) {
+               return -1;
+       }
+       return _backend->set_systemic_output_latency  (ol);
+}
+
+/* END OF BACKEND PROXY API */
+
+void
+AudioEngine::thread_init_callback (void* arg)
+{
+       /* make sure that anybody who needs to know about this thread
+          knows about it.
+       */
+
+       pthread_set_name (X_("audioengine"));
+
+       PBD::notify_gui_about_thread_creation ("gui", pthread_self(), X_("AudioEngine"), 4096);
+       PBD::notify_gui_about_thread_creation ("midiui", pthread_self(), X_("AudioEngine"), 128);
+
+       SessionEvent::create_per_thread_pool (X_("AudioEngine"), 512);
+
+       AsyncMIDIPort::set_process_thread (pthread_self());
+
+       if (arg) {
+               /* the special thread created/managed by the backend */
+               AudioEngine::instance()->_main_thread = new ProcessThread;
+       }
+}
+
+int
+AudioEngine::sync_callback (TransportState state, framepos_t position)
+{
+       if (_session) {
+               return _session->backend_sync_callback (state, position);
+       }
+       return 0;
+}
+
+void
+AudioEngine::freewheel_callback (bool onoff)
+{
+       _freewheeling = onoff;
+}
+
+void
+AudioEngine::latency_callback (bool for_playback)
+{
+        if (_session) {
+                _session->update_latency (for_playback);
+        }
+}
+
+void
+AudioEngine::update_latencies ()
+{
+       if (_backend) {
+               _backend->update_latencies ();
+       }
+}
+
+void
+AudioEngine::halted_callback (const char* why)
+{
+       if (_in_destructor) {
+               /* everything is under control */
+               return;
+       }
+
+        stop_metering_thread ();
+       _running = false;
+
+       Port::PortDrop (); /* EMIT SIGNAL */
+
+       if (!_started_for_latency) {
+               Halted (why);      /* EMIT SIGNAL */
+       }
+}
+
+bool
+AudioEngine::setup_required () const
+{
+       /* If there is only a single backend and it claims to be configured
+        * already there is no setup to be done.
+        *
+        * Primarily for a case where there is only a JACK backend and
+        * JACK is already running.
+        */
+        
+       if (_backends.size() == 1 && _backends.begin()->second->already_configured()) {
+               return false;
+       }
+
+       return true;
+}
+
+MTDM*
+AudioEngine::mtdm() 
+{
+       return _mtdm;
+}
+
+int
+AudioEngine::prepare_for_latency_measurement ()
+{
+       if (running()) {
+               _stopped_for_latency = true;
+               stop (true);
+       }
+
+       if (start (true)) {
+               _started_for_latency = true;
+               return -1;
+       }
+
+       return 0;
+}
+
+int
+AudioEngine::start_latency_detection ()
+{
+       if (!running()) {
+               if (prepare_for_latency_measurement ()) {
+                       return -1;
+               }
+       }
+
+       PortEngine& pe (port_engine());
+
+       delete _mtdm;
+       _mtdm = 0;
+
+       /* find the ports we will connect to */
+
+       PortEngine::PortHandle out = pe.get_port_by_name (_latency_output_name);
+       PortEngine::PortHandle in = pe.get_port_by_name (_latency_input_name);
+
+       if (!out || !in) {
+               stop (true);
+               return -1;
+       }
+
+       /* create the ports we will use to read/write data */
+       
+       if ((_latency_output_port = pe.register_port ("latency_out", DataType::AUDIO, IsOutput)) == 0) {
+               stop (true);
+               return -1;
+       }
+       if (pe.connect (_latency_output_port, _latency_output_name)) {
+               pe.unregister_port (_latency_output_port);
+               stop (true);
+               return -1;
+       }
+
+       const string portname ("latency_in");
+       if ((_latency_input_port = pe.register_port (portname, DataType::AUDIO, IsInput)) == 0) {
+               pe.unregister_port (_latency_output_port);
+               stop (true);
+               return -1;
+       }
+       if (pe.connect (_latency_input_name, make_port_name_non_relative (portname))) {
+               pe.unregister_port (_latency_output_port);
+               stop (true);
+               return -1;
+       }
+
+       LatencyRange lr;
+       _latency_signal_latency = 0;
+       lr = pe.get_latency_range (in, false);
+       _latency_signal_latency = lr.max;
+       lr = pe.get_latency_range (out, true);
+       _latency_signal_latency += lr.max;
+
+       /* all created and connected, lets go */
+
+       _mtdm = new MTDM (sample_rate());
+       _measuring_latency = true;
+        _latency_flush_frames = samples_per_cycle();
+
+       return 0;
+}
+
+void
+AudioEngine::stop_latency_detection ()
+{
+       _measuring_latency = false;
+
+       if (_latency_output_port) {
+               port_engine().unregister_port (_latency_output_port);
+               _latency_output_port = 0;
+       }
+       if (_latency_input_port) {
+               port_engine().unregister_port (_latency_input_port);
+               _latency_input_port = 0;
+       }
+
+       stop (true);
+
+       if (_stopped_for_latency) {
+               start ();
+       }
+
+       _stopped_for_latency = false;
+       _started_for_latency = false;
+}
+
+void
+AudioEngine::set_latency_output_port (const string& name)
+{
+       _latency_output_name = name;
+}
+
+void
+AudioEngine::set_latency_input_port (const string& name)
+{
+       _latency_input_name = name;
+}