Inrease the export "chunk size" to speed it up over 10% at least in some situations
[ardour.git] / libs / ardour / mtc_slave.cc
index 9a724b74d555960395bb34b93427c068396720b7..6c95730f24f6999d050b0ca5b886d5fcece66919 100644 (file)
 #include <poll.h>
 #include <sys/types.h>
 #include <unistd.h>
+
 #include "pbd/error.h"
-#include "pbd/failed_constructor.h"
-#include "pbd/pthread_utils.h"
 
 #include "midi++/port.h"
 #include "ardour/debug.h"
 #include "ardour/slave.h"
 #include "ardour/session.h"
 #include "ardour/audioengine.h"
-#include "ardour/cycles.h"
+#include "ardour/pi_controller.h"
 
 #include "i18n.h"
 
 using namespace std;
 using namespace ARDOUR;
-using namespace sigc;
 using namespace MIDI;
 using namespace PBD;
 
+/* length (in timecode frames) of the "window" that we consider legal given receipt of
+   a given timecode position. Ardour will try to chase within this window, and will
+   stop+locate+wait+chase if timecode arrives outside of it. The window extends entirely
+   in the current direction of motion, so if any timecode arrives that is before the most
+   recently received position (and without the direction of timecode reversing too), we
+   will stop+locate+wait+chase.
+*/
+
+const int MTC_Slave::frame_tolerance = 2;
+
 MTC_Slave::MTC_Slave (Session& s, MIDI::Port& p)
        : session (s)
 {
        can_notify_on_unknown_rate = true;
        did_reset_tc_format = false;
-       
+       reset_pending = 0;
+       reset_position = false;
+
+       pic = new PIChaser();
+
        last_mtc_fps_byte = session.get_mtc_timecode_bits ();
+       mtc_frame = 0;
+
+       speed_accumulator_size = 16;
+       speed_accumulator = new double[speed_accumulator_size];
 
        rebind (p);
-       reset ();
+       reset (true);
 }
 
 MTC_Slave::~MTC_Slave()
@@ -57,62 +73,56 @@ MTC_Slave::~MTC_Slave()
        if (did_reset_tc_format) {
                session.config.set_timecode_format (saved_tc_format);
        }
+
+       delete pic;
+       delete [] speed_accumulator;
+}
+
+bool
+MTC_Slave::give_slave_full_control_over_transport_speed() const
+{
+       return true; // for PiC control */
+       // return false; // for Session-level computed varispeed
 }
 
 void
 MTC_Slave::rebind (MIDI::Port& p)
 {
-       for (vector<sigc::connection>::iterator i = connections.begin(); i != connections.end(); ++i) {
-               (*i).disconnect ();
-       }
+       port_connections.drop_connections ();
 
        port = &p;
 
-       connections.push_back (port->input()->mtc_time.connect (mem_fun (*this, &MTC_Slave::update_mtc_time)));
-       connections.push_back (port->input()->mtc_qtr.connect (mem_fun (*this, &MTC_Slave::update_mtc_qtr)));
-       connections.push_back (port->input()->mtc_status.connect (mem_fun (*this, &MTC_Slave::update_mtc_status)));
+       port->parser()->mtc_time.connect_same_thread (port_connections,  boost::bind (&MTC_Slave::update_mtc_time, this, _1, _2, _3));
+       port->parser()->mtc_qtr.connect_same_thread (port_connections, boost::bind (&MTC_Slave::update_mtc_qtr, this, _1, _2, _3));
+       port->parser()->mtc_status.connect_same_thread (port_connections, boost::bind (&MTC_Slave::update_mtc_status, this, _1));
 }
 
 void
-MTC_Slave::update_mtc_qtr (Parser& /*p*/, int which_qtr)
+MTC_Slave::update_mtc_qtr (Parser& /*p*/, int which_qtr, framepos_t now)
 {
-       if (qtr_frame_messages_valid_for_time) {
-               
-               nframes64_t now = session.engine().frame_time();
-
-               if (which_qtr != 7) {
-
-                       /* leave position and speed updates for the last
-                          qtr frame message of the 8 to be taken
-                          care of in update_mtc_time(), invoked
-                          by the Parser right after this.
-                       */
-
-                       nframes_t qtr;
-                       
-                       qtr = (long) (session.frames_per_timecode_frame() / 4);
-                       mtc_frame += qtr;
-                       
-                       double speed = compute_apparent_speed (now);
-                       
-                       current.guard1++;
-                       current.position = mtc_frame;
-                       current.timestamp = now;
-                       current.speed = speed;
-                       current.guard2++;
-               }
-
-               last_inbound_frame = now;
-       }
+       DEBUG_TRACE (DEBUG::MTC, string_compose ("qtr frame %1 at %2\n", which_qtr, now));
+       maybe_reset ();
+       last_inbound_frame = now;
 }
 
 void
-MTC_Slave::update_mtc_time (const byte *msg, bool was_full)
+MTC_Slave::update_mtc_time (const byte *msg, bool was_full, framepos_t now)
 {
-       nframes64_t now = session.engine().frame_time();
+       /* "now" can be zero if this is called from a context where we do not have or do not want
+          to use a timestamp indicating when this MTC time was received. example: when we received
+          a locate command via MMC.
+       */
+
+       if (now) {
+               maybe_reset ();
+       }
+
        Timecode::Time timecode;
        TimecodeFormat tc_format;
        bool reset_tc = true;
+       framepos_t window_root = -1;
+
+       DEBUG_TRACE (DEBUG::MTC, string_compose ("full mtc time known at %1, full ? %2\n", now, was_full));
 
        timecode.hours = msg[3];
        timecode.minutes = msg[2];
@@ -167,83 +177,134 @@ MTC_Slave::update_mtc_time (const byte *msg, bool was_full)
                session.config.set_timecode_format (tc_format);
        }
 
-       DEBUG_TRACE (DEBUG::MTC, string_compose ("MTC time timestamp = %1 TC %2 = frame %3 (from full message ? %4)\n", 
+       DEBUG_TRACE (DEBUG::MTC, string_compose ("MTC time timestamp = %1 TC %2 = frame %3 (from full message ? %4)\n",
                                                 now, timecode, mtc_frame, was_full));
 
-       if (was_full) {
+       if (was_full || outside_window (mtc_frame)) {
 
                session.timecode_to_sample (timecode, mtc_frame, true, false);
                session.request_locate (mtc_frame, false);
                session.request_transport_speed (0);
-               update_mtc_status (MIDI::Parser::MTC_Stopped);
-
-               reset ();
+               update_mtc_status (MIDI::MTC_Stopped);
+               reset (false);
+               reset_window (mtc_frame);
 
        } else {
 
-                       
                /* we've had the first set of 8 qtr frame messages, determine position
-                          and allow continuing qtr frame messages to provide position
-                          and speed information.
+                  and allow continuing qtr frame messages to provide position
+                  and speed information.
                */
-               
-               qtr_frame_messages_valid_for_time = true;
+
+               /* do a careful conversion of the timecode value to a position
+                  so that we take drop/nondrop and all that nonsense into
+                  consideration.
+               */
+
                session.timecode_to_sample (timecode, mtc_frame, true, false);
-               
+
                /* We received the last quarter frame 7 quarter frames (1.75 mtc
                   frames) after the instance when the contents of the mtc quarter
                   frames were decided. Add time to compensate for the elapsed 1.75
                   frames. Also compensate for audio latency.
                */
-               
-               mtc_frame += (long) (1.75 * session.frames_per_timecode_frame()) + session.worst_output_latency();
-               
-               double speed = compute_apparent_speed (now);
-               
-               current.guard1++;
-               current.position = mtc_frame;
-               current.timestamp = now;
-               current.speed = speed;
-               current.guard2++;
+
+               mtc_frame += (long) (1.75 * session.frames_per_timecode_frame()) + session.worst_playback_latency();
+
+
+               if (now) {
+
+                       if (last_mtc_timestamp == 0) {
+
+                               last_mtc_timestamp = now;
+                               last_mtc_frame = mtc_frame;
+
+                       } else {
+
+                               if (give_slave_full_control_over_transport_speed()) {
+                                       /* PIC
+                                        *
+                                        * its not the average, but we will assign it to current.speed below
+                                        */
+
+                                   static framepos_t last_seen_timestamp = 0;
+                                   static framepos_t last_seen_position = 0;
+
+                                   if ((now - last_seen_timestamp) < 300) {
+                                       mtc_frame = (mtc_frame + last_seen_position)/2;
+                                   }
+
+                                   last_seen_timestamp = now;
+                                   last_seen_position = mtc_frame;
+
+
+
+                               } else {
+
+                                       /* Non-PiC
+                                        */
+
+                                       framepos_t time_delta = (now - last_mtc_timestamp);
+
+                                       if (time_delta != 0) {
+                                               double apparent_speed = (mtc_frame - last_mtc_frame) / (double) (time_delta);
+
+                                               process_apparent_speed (apparent_speed);
+                                               DEBUG_TRACE (DEBUG::Slave, string_compose ("apparent speed was %1 average is now %2\n", apparent_speed, average_speed));
+                                       } else {
+                                               DEBUG_TRACE (DEBUG::Slave, string_compose ("no apparent calc, average is %1\n", average_speed));
+                                       }
+
+                                       /* every second, recalibrate the starting point for the speed measurement */
+                                       if (mtc_frame - last_mtc_frame > session.frame_rate()) {
+                                               last_mtc_timestamp = now;
+                                               last_mtc_frame = mtc_frame;
+                                       }
+                               }
+                       }
+
+                       current.guard1++;
+                       current.position = mtc_frame;
+                       current.timestamp = now;
+                       current.speed = average_speed;
+                       current.guard2++;
+                       window_root = mtc_frame;
+               }
        }
 
-       last_inbound_frame = now;
+       if (now) {
+               last_inbound_frame = now;
+       }
+
+       if (window_root >= 0) {
+               reset_window (window_root);
+       }
 }
 
-double
-MTC_Slave::compute_apparent_speed (nframes64_t now)
+void
+MTC_Slave::process_apparent_speed (double this_speed)
 {
-       if (current.timestamp != 0) {
-               
-               double speed = (double) ((mtc_frame - current.position) / (double) (now - current.timestamp));
-               DEBUG_TRACE (DEBUG::MTC, string_compose ("instantaneous speed = %1 from %2 - %3 / %4 - %5\n",
-                                                        speed, mtc_frame, current.position, now, current.timestamp));
-               
-               /* crude low pass filter/smoother for speed */
-
-               accumulator[accumulator_index++] = speed;
-               
-               if (accumulator_index >= accumulator_size) {
-                       have_first_accumulated_speed = true;
-                       accumulator_index = 0;
-               }
-               
-               if (have_first_accumulated_speed) {
-                       double total = 0;
-                       
-                       for (int32_t i = 0; i < accumulator_size; ++i) {
-                               total += accumulator[i];
-                       }
-                       
-                       speed = total / accumulator_size;
-                       DEBUG_TRACE (DEBUG::MTC, string_compose ("speed smoothed to %1\n", speed));
-               } 
+       DEBUG_TRACE (DEBUG::MTC, string_compose ("speed cnt %1 sz %2 have %3\n", speed_accumulator_cnt, speed_accumulator_size, have_first_speed_accumulator));
 
-               return speed;
-               
-       } else {
-               
-               return 0;
+       /* clamp to an expected range */
+
+       if (this_speed > 4.0 || this_speed < -4.0) {
+               this_speed = average_speed;
+       }
+
+       if (speed_accumulator_cnt >= speed_accumulator_size) {
+               have_first_speed_accumulator = true;
+               speed_accumulator_cnt = 0;
+       }
+
+       speed_accumulator[speed_accumulator_cnt++] = this_speed;
+
+       if (have_first_speed_accumulator) {
+               average_speed = 0.0;
+               for (size_t i = 0; i < speed_accumulator_size; ++i) {
+                       average_speed += speed_accumulator[i];
+               }
+               average_speed /= speed_accumulator_size;
        }
 }
 
@@ -258,11 +319,11 @@ MTC_Slave::handle_locate (const MIDI::byte* mmc_tc)
        mtc[1] = mmc_tc[2];
        mtc[0] = mmc_tc[3];
 
-       update_mtc_time (mtc, true);
+       update_mtc_time (mtc, true, 0);
 }
 
 void
-MTC_Slave::update_mtc_status (MIDI::Parser::MTC_Status status)
+MTC_Slave::update_mtc_status (MIDI::MTC_Status status)
 {
        /* XXX !!! thread safety ... called from MIDI I/O context
           and process() context (via ::speed_and_position())
@@ -270,8 +331,6 @@ MTC_Slave::update_mtc_status (MIDI::Parser::MTC_Status status)
 
        switch (status) {
        case MTC_Stopped:
-               mtc_frame = 0;
-
                current.guard1++;
                current.position = mtc_frame;
                current.timestamp = 0;
@@ -281,27 +340,22 @@ MTC_Slave::update_mtc_status (MIDI::Parser::MTC_Status status)
                break;
 
        case MTC_Forward:
-               mtc_frame = 0;
-
                current.guard1++;
                current.position = mtc_frame;
                current.timestamp = 0;
                current.speed = 0;
                current.guard2++;
-
                break;
 
        case MTC_Backward:
-               mtc_frame = 0;
-
                current.guard1++;
                current.position = mtc_frame;
                current.timestamp = 0;
                current.speed = 0;
                current.guard2++;
-
                break;
        }
+
 }
 
 void
@@ -324,7 +378,7 @@ MTC_Slave::read_current (SafeTime *st) const
 bool
 MTC_Slave::locked () const
 {
-       return port->input()->mtc_locked();
+       return port->parser()->mtc_locked();
 }
 
 bool
@@ -334,11 +388,12 @@ MTC_Slave::ok() const
 }
 
 bool
-MTC_Slave::speed_and_position (double& speed, nframes64_t& pos)
+MTC_Slave::speed_and_position (double& speed, framepos_t& pos)
 {
-       nframes64_t now = session.engine().frame_time();
+       framepos_t now = session.engine().frame_time();
        SafeTime last;
-       nframes_t elapsed;
+       framecnt_t elapsed;
+       bool in_control = false;
 
        read_current (&last);
 
@@ -356,14 +411,33 @@ MTC_Slave::speed_and_position (double& speed, nframes64_t& pos)
                pos = last.position;
                session.request_locate (pos, false);
                session.request_transport_speed (0);
-               update_mtc_status (MIDI::Parser::MTC_Stopped);
-               reset();
-               DEBUG_TRACE (DEBUG::MTC, "MTC not seen for 1/4 second - reset\n");
+               queue_reset (false);
+               DEBUG_TRACE (DEBUG::MTC, "MTC not seen for 1/4 second - reset pending\n");
                return false;
        }
 
        DEBUG_TRACE (DEBUG::MTC, string_compose ("MTC::speed_and_position %1 %2\n", last.speed, last.position));
 
+       if (give_slave_full_control_over_transport_speed()) {
+               in_control = (session.slave_state() == Session::Running);
+               framepos_t pic_want_locate = 0;
+               //framepos_t slave_pos = session.audible_frame();
+               framepos_t slave_pos = session.transport_frame();
+               static double average_speed = 0;
+
+               framepos_t ref_now = session.engine().frame_time_at_cycle_start();
+               average_speed = pic->get_ratio (last.timestamp, last.position, ref_now, slave_pos, in_control, session.engine().frames_per_cycle());
+
+               pic_want_locate = pic->want_locate();
+
+               if (in_control && pic_want_locate) {
+                       last.speed = average_speed + (double) (pic_want_locate - session.transport_frame()) / (double)session.get_block_size();
+                       std::cout << "locate req " << pic_want_locate << " speed: " << average_speed << "\n";
+               } else {
+                       last.speed = average_speed;
+               }
+       }
+
        if (last.speed == 0.0f) {
 
                elapsed = 0;
@@ -373,9 +447,9 @@ MTC_Slave::speed_and_position (double& speed, nframes64_t& pos)
                /* scale elapsed time by the current MTC speed */
 
                if (last.timestamp && (now > last.timestamp)) {
-                       elapsed = (nframes_t) floor (last.speed * (now - last.timestamp));
-                       DEBUG_TRACE (DEBUG_MTC, string_compose ("last timecode received @ %1, now = %2, elapsed frames = %3 w/speed= %4\n",
-                                                               last.timestamp, now, elapsed, speed);
+                       elapsed = (framecnt_t) floor (last.speed * (now - last.timestamp));
+                       DEBUG_TRACE (DEBUG::MTC, string_compose ("last timecode received @ %1, now = %2, elapsed frames = %3 w/speed= %4\n",
+                                                                last.timestamp, now, elapsed, last.speed));
                } else {
                        elapsed = 0; /* XXX is this right? */
                }
@@ -383,37 +457,136 @@ MTC_Slave::speed_and_position (double& speed, nframes64_t& pos)
 
        /* now add the most recent timecode value plus the estimated elapsed interval */
 
-       pos =  elapsed + last.position;
+       if (in_control) {
+               pos = session.transport_frame();
+       } else {
+               pos = last.position + elapsed;
+       }
+
        speed = last.speed;
 
        DEBUG_TRACE (DEBUG::MTC, string_compose ("MTC::speed_and_position FINAL %1 %2\n", last.speed, pos));
 
+
+       DEBUG_TRACE (DEBUG::MTC, string_compose ("last = %1 elapsed = %2 pos = %3 speed = %4\n", last.position, elapsed, pos, speed));
+
        return true;
 }
 
-ARDOUR::nframes_t
-MTC_Slave::resolution() const
+ARDOUR::framecnt_t
+MTC_Slave::resolution () const
+{
+       return (framecnt_t) session.frames_per_timecode_frame();
+}
+
+void
+MTC_Slave::queue_reset (bool reset_pos)
+{
+       Glib::Mutex::Lock lm (reset_lock);
+       reset_pending++;
+       if (reset_pos) {
+               reset_position = true;
+       }
+}
+
+void
+MTC_Slave::maybe_reset ()
 {
-       return (nframes_t) session.frames_per_timecode_frame();
+       Glib::Mutex::Lock lm (reset_lock);
+
+       if (reset_pending) {
+               reset (reset_position);
+               reset_pending = 0;
+               reset_position = false;
+       }
 }
 
 void
-MTC_Slave::reset ()
+MTC_Slave::reset (bool with_position)
 {
-       /* XXX massive thread safety issue here. MTC could
-          be being updated as we call this. but this
-          supposed to be a realtime-safe call.
+       if (with_position) {
+               last_inbound_frame = 0;
+               current.guard1++;
+               current.position = 0;
+               current.timestamp = 0;
+               current.speed = 0;
+               current.guard2++;
+       } else {
+               last_inbound_frame = 0;
+               current.guard1++;
+               current.timestamp = 0;
+               current.speed = 0;
+               current.guard2++;
+       }
+
+       window_begin = 0;
+       window_end = 0;
+       last_mtc_frame = 0;
+       last_mtc_timestamp = 0;
+
+       average_speed = 0;
+       have_first_speed_accumulator = false;
+       speed_accumulator_cnt = 0;
+
+       pic->reset();
+}
+
+void
+MTC_Slave::reset_window (framepos_t root)
+{
+
+       /* if we're waiting for the master to catch us after seeking ahead, keep the window
+          of acceptable MTC frames wide open. otherwise, shrink it down to just 2 video frames
+          ahead of the window root (taking direction into account).
        */
 
-       port->input()->reset_mtc_state ();
-
-       last_inbound_frame = 0;
-       current.guard1++;
-       current.position = 0;
-       current.timestamp = 0;
-       current.speed = 0;
-       current.guard2++;
-       accumulator_index = 0;
-       have_first_accumulated_speed = false;
-       qtr_frame_messages_valid_for_time = false;
+       switch (port->parser()->mtc_running()) {
+       case MTC_Forward:
+               window_begin = root;
+               if (session.slave_state() == Session::Running) {
+                       window_end = root + (session.frames_per_timecode_frame() * frame_tolerance);
+               } else {
+                       window_end = root + seekahead_distance ();
+               }
+               break;
+
+       case MTC_Backward:
+               if (session.slave_state() == Session::Running) {
+                       framecnt_t const d = session.frames_per_timecode_frame() * frame_tolerance;
+                       if (root > d) {
+                               window_begin = root - d;
+                               window_end = root;
+                       } else {
+                               window_begin = 0;
+                       }
+               } else {
+                       framecnt_t const d = seekahead_distance ();
+                       if (root > d) {
+                               window_begin = root - d;
+                       } else {
+                               window_begin = 0;
+                       }
+               }
+               window_end = root;
+               break;
+
+       default:
+               /* do nothing */
+               break;
+       }
+
+       DEBUG_TRACE (DEBUG::MTC, string_compose ("legal MTC window now %1 .. %2\n", window_begin, window_end));
+}
+
+ARDOUR::framecnt_t
+MTC_Slave::seekahead_distance () const
+{
+       /* 1 second */
+       return session.frame_rate();
+}
+
+bool
+MTC_Slave::outside_window (framepos_t pos) const
+{
+       return ((pos < window_begin) || (pos > window_end));
 }