2 Copyright (C) 2006,2007 John Anderson
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
26 #define __STDC_FORMAT_MACROS
33 #include <boost/shared_array.hpp>
35 #include <midi++/types.h>
36 #include <midi++/port.h>
37 #include <midi++/manager.h>
38 #include <pbd/pthread_utils.h>
39 #include <pbd/error.h>
40 #include <pbd/memento_command.h>
41 #include <pbd/convert.h>
43 #include <ardour/route.h>
44 #include <ardour/session.h>
45 #include <ardour/location.h>
46 #include <ardour/dB.h>
47 #include <ardour/panner.h>
48 #include <ardour/tempo.h>
49 #include <ardour/types.h>
51 #include "mackie_control_protocol.h"
53 #include "midi_byte_array.h"
54 #include "mackie_control_exception.h"
55 #include "route_signal.h"
56 #include "mackie_midi_builder.h"
57 #include "surface_port.h"
59 #include "bcf_surface.h"
60 #include "mackie_surface.h"
62 using namespace ARDOUR;
65 using namespace Mackie;
68 using boost::shared_ptr;
72 MackieMidiBuilder builder;
74 MackieControlProtocol::MackieControlProtocol (Session& session)
75 : ControlProtocol (session, X_("Mackie"))
76 , _current_initial_bank( 0 )
77 , connections_back( _connections )
79 , _ports_changed( false )
84 , _timecode_type( ARDOUR::AnyTime::BBT )
87 cout << "MackieControlProtocol::MackieControlProtocol" << endl;
89 // will start reading from ports, as soon as there are some
90 pthread_create_and_store (X_("mackie monitor"), &thread, 0, _monitor_work, this);
93 MackieControlProtocol::~MackieControlProtocol()
96 cout << "~MackieControlProtocol::MackieControlProtocol" << endl;
102 catch ( exception & e )
104 cout << "~MackieControlProtocol caught " << e.what() << endl;
108 cout << "~MackieControlProtocol caught unknown" << endl;
111 cout << "finished ~MackieControlProtocol::MackieControlProtocol" << endl;
115 Mackie::Surface & MackieControlProtocol::surface()
119 throw MackieControlException( "_surface is 0 in MackieControlProtocol::surface" );
124 const Mackie::SurfacePort & MackieControlProtocol::mcu_port() const
126 if ( _ports.size() < 1 )
132 return dynamic_cast<const MackiePort &>( *_ports[0] );
136 Mackie::SurfacePort & MackieControlProtocol::mcu_port()
138 if ( _ports.size() < 1 )
144 return dynamic_cast<MackiePort &>( *_ports[0] );
148 // go to the previous track.
149 // Assume that get_sorted_routes().size() > route_table.size()
150 void MackieControlProtocol::prev_track()
152 if ( _current_initial_bank >= 1 )
154 session->set_dirty();
155 switch_banks( _current_initial_bank - 1 );
159 // go to the next track.
160 // Assume that get_sorted_routes().size() > route_table.size()
161 void MackieControlProtocol::next_track()
163 Sorted sorted = get_sorted_routes();
164 if ( _current_initial_bank + route_table.size() < sorted.size() )
166 session->set_dirty();
167 switch_banks( _current_initial_bank + 1 );
171 void MackieControlProtocol::clear_route_signals()
173 for( RouteSignals::iterator it = route_signals.begin(); it != route_signals.end(); ++it )
177 route_signals.clear();
180 // return the port for a given id - 0 based
181 // throws an exception if no port found
182 MackiePort & MackieControlProtocol::port_for_id( uint32_t index )
184 uint32_t current_max = 0;
185 for( MackiePorts::iterator it = _ports.begin(); it != _ports.end(); ++it )
187 current_max += (*it)->strips();
188 if ( index < current_max ) return **it;
191 // oops - no matching port
193 os << "No port for index " << index;
194 throw MackieControlException( os.str() );
197 // predicate for sort call in get_sorted_routes
198 struct RouteByRemoteId
200 bool operator () ( const shared_ptr<Route> & a, const shared_ptr<Route> & b ) const
202 return a->remote_control_id() < b->remote_control_id();
205 bool operator () ( const Route & a, const Route & b ) const
207 return a.remote_control_id() < b.remote_control_id();
210 bool operator () ( const Route * a, const Route * b ) const
212 return a->remote_control_id() < b->remote_control_id();
216 MackieControlProtocol::Sorted MackieControlProtocol::get_sorted_routes()
221 boost::shared_ptr<Session::RouteList> routes = session->get_routes();
222 set<uint32_t> remote_ids;
224 // routes with remote_id 0 should never be added
225 // TODO verify this with ardour devs
226 // remote_ids.insert( 0 );
228 // sort in remote_id order, and exclude master, control and hidden routes
229 // and any routes that are already set.
230 for ( Session::RouteList::iterator it = routes->begin(); it != routes->end(); ++it )
232 Route & route = **it;
238 && remote_ids.find( route.remote_control_id() ) == remote_ids.end()
241 sorted.push_back( *it );
242 remote_ids.insert( route.remote_control_id() );
245 sort( sorted.begin(), sorted.end(), RouteByRemoteId() );
249 void MackieControlProtocol::refresh_current_bank()
251 switch_banks( _current_initial_bank );
254 void MackieControlProtocol::switch_banks( int initial )
256 // DON'T prevent bank switch if initial == _current_initial_bank
257 // because then this method can't be used as a refresh
260 Sorted sorted = get_sorted_routes();
261 int delta = sorted.size() - route_table.size();
262 if ( initial < 0 || ( delta > 0 && initial > delta ) )
265 cout << "not switching to " << initial << endl;
269 _current_initial_bank = initial;
271 // first clear the signals from old routes
272 // taken care of by the RouteSignal destructors
273 clear_route_signals();
275 // now set the signals for new routes
276 if ( _current_initial_bank <= sorted.size() )
278 // fetch the bank start and end to switch to
279 uint32_t end_pos = min( route_table.size(), sorted.size() );
280 Sorted::iterator it = sorted.begin() + _current_initial_bank;
281 Sorted::iterator end = sorted.begin() + _current_initial_bank + end_pos;
283 cout << "switch to " << _current_initial_bank << ", " << end_pos << endl;
286 // link routes to strips
288 for ( ; it != end && it != sorted.end(); ++it, ++i )
290 boost::shared_ptr<Route> route = *it;
291 Strip & strip = *surface().strips[i];
293 cout << "remote id " << route->remote_control_id() << " connecting " << route->name() << " to " << strip.name() << " with port " << port_for_id(i) << endl;
295 route_table[i] = route;
296 RouteSignal * rs = new RouteSignal( *route, *this, strip, port_for_id(i) );
297 route_signals.push_back( rs );
298 // update strip from route
302 // create dead strips if there aren't enough routes to
304 for ( ; i < route_table.size(); ++i )
306 Strip & strip = *surface().strips[i];
307 // send zero for this strip
308 MackiePort & port = port_for_id(i);
309 port.write( builder.zero_strip( port, strip ) );
313 // display the current start bank.
314 surface().display_bank_start( mcu_port(), builder, _current_initial_bank );
317 void MackieControlProtocol::zero_all()
319 // TODO turn off SMPTE displays
322 for ( Surface::Strips::iterator it = surface().strips.begin(); it != surface().strips.end(); ++it )
324 MackiePort & port = port_for_id( (*it)->index() );
325 port.write( builder.zero_strip( port, **it ) );
328 // and the master strip
329 mcu_port().write( builder.zero_strip( dynamic_cast<MackiePort&>( mcu_port() ), master_strip() ) );
331 // turn off global buttons and leds
332 // global buttons are only ever on mcu_port, so we don't have
333 // to figure out which port.
334 for ( Surface::Controls::iterator it = surface().controls.begin(); it != surface().controls.end(); ++it )
336 Control & control = **it;
337 if ( !control.group().is_strip() && control.accepts_feedback() )
339 mcu_port().write( builder.zero_control( control ) );
343 // any hardware-specific stuff
344 surface().zero_all( mcu_port(), builder );
347 int MackieControlProtocol::set_active( bool yn )
353 // the reason for the locking and unlocking is that
354 // glibmm can't do a condition wait on a RecMutex
357 // TODO what happens if this fails half way?
359 // create MackiePorts
361 Glib::Mutex::Lock lock( update_mutex );
365 // make sure the ports are being listened to
368 // wait until poll thread is running, with ports to poll
369 // the mutex is only there because conditions require a mutex
371 Glib::Mutex::Lock lock( update_mutex );
372 while ( nfds == 0 ) update_cond.wait( update_mutex );
375 // now initialise MackiePorts - ie exchange sysex messages
376 for( MackiePorts::iterator it = _ports.begin(); it != _ports.end(); ++it )
381 // wait until all ports are active
382 // TODO a more sophisticated approach would
383 // allow things to start up with only an MCU, even if
384 // extenders were specified but not responding.
385 for( MackiePorts::iterator it = _ports.begin(); it != _ports.end(); ++it )
387 (*it)->wait_for_init();
390 // create surface object. This depends on the ports being
391 // correctly initialised
392 initialize_surface();
393 connect_session_signals();
398 // send current control positions to surface
399 // must come after _active = true otherwise it won't run
408 catch( exception & e )
411 cout << "set_active to false because exception caught: " << e.what() << endl;
421 bool MackieControlProtocol::handle_strip_button( Control & control, ButtonState bs, boost::shared_ptr<Route> route )
427 if ( control.name() == "recenable" )
429 state = !route->record_enabled();
430 route->set_record_enable( state, this );
432 else if ( control.name() == "mute" )
434 state = !route->muted();
435 route->set_mute( state, this );
437 else if ( control.name() == "solo" )
439 state = !route->soloed();
440 route->set_solo( state, this );
442 else if ( control.name() == "select" )
444 // TODO make the track selected. Whatever that means.
445 //state = default_button_press( dynamic_cast<Button&>( control ) );
447 else if ( control.name() == "vselect" )
449 // TODO could be used to select different things to apply the pot to?
450 //state = default_button_press( dynamic_cast<Button&>( control ) );
454 if ( control.name() == "fader_touch" )
457 control.strip().gain().in_use( state );
463 void MackieControlProtocol::update_led( Mackie::Button & button, Mackie::LedState ls )
467 SurfacePort * port = 0;
468 if ( button.group().is_strip() )
470 if ( button.group().is_master() )
476 port = &port_for_id( dynamic_cast<const Strip&>( button.group() ).index() );
483 port->write( builder.build_led( button, ls ) );
487 void MackieControlProtocol::update_smpte_beats_led()
489 switch ( _timecode_type )
491 case ARDOUR::AnyTime::BBT:
492 update_global_led( "beats", on );
493 update_global_led( "smpte", off );
495 case ARDOUR::AnyTime::SMPTE:
496 update_global_led( "smpte", on );
497 update_global_led( "beats", off );
501 os << "Unknown Anytime::Type " << _timecode_type;
502 throw runtime_error( os.str() );
506 void MackieControlProtocol::update_global_button( const string & name, LedState ls )
508 if ( surface().controls_by_name.find( name ) != surface().controls_by_name.end() )
510 Button * button = dynamic_cast<Button*>( surface().controls_by_name[name] );
511 mcu_port().write( builder.build_led( button->led(), ls ) );
516 cout << "Button " << name << " not found" << endl;
521 void MackieControlProtocol::update_global_led( const string & name, LedState ls )
523 if ( surface().controls_by_name.find( name ) != surface().controls_by_name.end() )
525 Led * led = dynamic_cast<Led*>( surface().controls_by_name[name] );
526 mcu_port().write( builder.build_led( *led, ls ) );
531 cout << "Led " << name << " not found" << endl;
536 // send messages to surface to set controls to correct values
537 void MackieControlProtocol::update_surface()
541 // do the initial bank switch to connect signals
542 // _current_initial_bank is initialised by set_state
543 switch_banks( _current_initial_bank );
545 // create a RouteSignal for the master route
546 boost::shared_ptr<Route> mr = master_route ();
548 master_route_signal = shared_ptr<RouteSignal> (new RouteSignal (mr, *this, master_strip(), mcu_port()) );
549 // update strip from route
550 master_route_signal->notify_all();
553 // sometimes the jog wheel is a pot
554 surface().blank_jog_ring( mcu_port(), builder );
556 // update global buttons and displays
557 notify_record_state_changed();
558 notify_transport_state_changed();
559 update_smpte_beats_led();
563 void MackieControlProtocol::connect_session_signals()
565 // receive routes added
566 connections_back = session->RouteAdded.connect( ( mem_fun (*this, &MackieControlProtocol::notify_route_added) ) );
567 // receive record state toggled
568 connections_back = session->RecordStateChanged.connect( ( mem_fun (*this, &MackieControlProtocol::notify_record_state_changed) ) );
569 // receive transport state changed
570 connections_back = session->TransportStateChange.connect( ( mem_fun (*this, &MackieControlProtocol::notify_transport_state_changed) ) );
571 // receive punch-in and punch-out
572 connections_back = Config->ParameterChanged.connect( ( mem_fun (*this, &MackieControlProtocol::notify_parameter_changed) ) );
573 // receive rude solo changed
574 connections_back = session->SoloActive.connect( ( mem_fun (*this, &MackieControlProtocol::notify_solo_active_changed) ) );
576 // make sure remote id changed signals reach here
577 // see also notify_route_added
578 Sorted sorted = get_sorted_routes();
579 for ( Sorted::iterator it = sorted.begin(); it != sorted.end(); ++it )
581 connections_back = (*it)->RemoteControlIDChanged.connect( ( mem_fun (*this, &MackieControlProtocol::notify_remote_id_changed) ) );
585 void MackieControlProtocol::add_port( MIDI::Port & midi_port, int number )
588 cout << "add port " << midi_port.name() << ", " << midi_port.device() << ", " << midi_port.type() << endl;
589 cout << "MIDI::Port::ALSA_Sequencer " << MIDI::Port::ALSA_Sequencer << endl;
590 cout << "MIDI::Port::Unknown " << MIDI::Port::Unknown << endl;
592 if ( string( midi_port.device() ) == string( "ardour" ) )
594 throw MackieControlException( "The Mackie MCU driver will not use a port with device=ardour" );
596 else if ( midi_port.type() == MIDI::Port::ALSA_Sequencer )
598 throw MackieControlException( "alsa/sequencer ports don't work with the Mackie MCU driver right now" );
602 MackiePort * sport = new MackiePort( *this, midi_port, number );
603 _ports.push_back( sport );
605 connections_back = sport->init_event.connect(
607 mem_fun (*this, &MackieControlProtocol::handle_port_init)
612 connections_back = sport->active_event.connect(
614 mem_fun (*this, &MackieControlProtocol::handle_port_active)
619 connections_back = sport->inactive_event.connect(
621 mem_fun (*this, &MackieControlProtocol::handle_port_inactive)
626 _ports_changed = true;
630 void MackieControlProtocol::create_ports()
632 MIDI::Manager * mm = MIDI::Manager::instance();
636 MIDI::Port * midi_port = mm->port( default_port_name );
638 if ( midi_port == 0 ) {
640 os << string_compose( _("no MIDI port named \"%1\" exists - Mackie control disabled"), default_port_name );
641 error << os.str() << endmsg;
642 throw MackieControlException( os.str() );
644 add_port( *midi_port, 0 );
647 // open extender ports. Up to 9. Should be enough.
648 // could also use mm->get_midi_ports()
649 string ext_port_base = "mcu_xt_";
650 for ( int index = 1; index <= 9; ++index )
653 os << ext_port_base << index;
654 MIDI::Port * midi_port = mm->port( os.str() );
655 if ( midi_port != 0 ) add_port( *midi_port, index );
659 shared_ptr<Route> MackieControlProtocol::master_route()
661 return session->master_out ();
664 Strip & MackieControlProtocol::master_strip()
666 return dynamic_cast<Strip&>( *surface().groups["master"] );
669 void MackieControlProtocol::initialize_surface()
671 // set up the route table
673 for( MackiePorts::iterator it = _ports.begin(); it != _ports.end(); ++it )
675 strips += (*it)->strips();
678 set_route_table_size( strips );
680 // TODO same as code in mackie_port.cc
681 string emulation = ARDOUR::Config->get_mackie_emulation();
682 if ( emulation == "bcf" )
684 _surface = new BcfSurface( strips );
686 else if ( emulation == "mcu" )
688 _surface = new MackieSurface( strips );
693 os << "no Surface class found for emulation: " << emulation;
694 throw MackieControlException( os.str() );
699 // Connect events. Must be after route table otherwise there will be trouble
700 for( MackiePorts::iterator it = _ports.begin(); it != _ports.end(); ++it )
702 connections_back = (*it)->control_event.connect( ( mem_fun (*this, &MackieControlProtocol::handle_control_event) ) );
706 void MackieControlProtocol::close()
708 // stop polling, and wait for it...
709 // must be before other shutdown otherwise polling loop
710 // calls methods on objects that are deleted
712 pthread_join( thread, 0 );
714 // TODO disconnect port active/inactive signals
715 // Or at least put a lock here
717 // disconnect global signals from Session
718 // TODO Since *this is a sigc::trackable, this shouldn't be necessary
719 // but it is for some reason
721 for( vector<sigc::connection>::iterator it = _connections.begin(); it != _connections.end(); ++it )
729 // These will fail if the port has gone away.
730 // So catch the exception and do the rest of the
732 // because the bcf doesn't respond to the next 3 sysex messages
737 catch ( exception & e )
740 cout << "MackieControlProtocol::close caught exception: " << e.what() << endl;
744 for( MackiePorts::iterator it = _ports.begin(); it != _ports.end(); ++it )
748 MackiePort & port = **it;
750 port.write_sysex( 0x61 );
752 port.write_sysex( 0x62 );
753 // Reset (reboot into offline mode)
754 port.write_sysex( 0x63 );
756 catch ( exception & e )
759 cout << "MackieControlProtocol::close caught exception: " << e.what() << endl;
764 // disconnect routes from strips
765 clear_route_signals();
771 // shut down MackiePorts
772 for( MackiePorts::iterator it = _ports.begin(); it != _ports.end(); ++it )
778 // this is done already in monitor_work. But it's here so we know.
784 void* MackieControlProtocol::_monitor_work (void* arg)
786 return static_cast<MackieControlProtocol*>(arg)->monitor_work ();
789 XMLNode & MackieControlProtocol::get_state()
792 cout << "MackieControlProtocol::get_state" << endl;
795 // add name of protocol
796 XMLNode* node = new XMLNode( X_("Protocol") );
797 node->add_property( X_("name"), _name );
801 os << _current_initial_bank;
802 node->add_property( X_("bank"), os.str() );
807 int MackieControlProtocol::set_state( const XMLNode & node )
810 cout << "MackieControlProtocol::set_state: active " << _active << endl;
814 // fetch current bank
815 if ( node.property( X_("bank") ) != 0 )
817 string bank = node.property( X_("bank") )->value();
821 uint32_t new_bank = atoi( bank.c_str() );
822 if ( _current_initial_bank != new_bank ) switch_banks( new_bank );
824 catch ( exception & e )
827 cout << "exception in MackieControlProtocol::set_state: " << e.what() << endl;
836 void MackieControlProtocol::handle_control_event( SurfacePort & port, Control & control, const ControlState & state )
838 // find the route for the control, if there is one
839 boost::shared_ptr<Route> route;
840 if ( control.group().is_strip() )
842 if ( control.group().is_master() )
844 route = master_route();
848 uint32_t index = control.ordinal() - 1 + ( port.number() * port.strips() );
849 if ( index < route_table.size() )
850 route = route_table[index];
852 cerr << "Warning: index is " << index << " which is not in the route table, size: " << route_table.size() << endl;
856 // This handles control element events from the surface
857 // the state of the controls on the surface is usually updated
859 switch ( control.type() )
861 case Control::type_fader:
862 // find the route in the route table for the id
863 // if the route isn't available, skip it
864 // at which point the fader should just reset itself
867 route->gain_control().set_value( state.pos );
869 // must echo bytes back to slider now, because
870 // the notifier only works if the fader is not being
871 // touched. Which it is if we're getting input.
872 port.write( builder.build_fader( (Fader&)control, state.pos ) );
876 case Control::type_button:
877 if ( control.group().is_strip() )
882 handle_strip_button( control, state.button_state, route );
886 // no route so always switch the light off
887 // because no signals will be emitted by a non-route
888 port.write( builder.build_led( control.led(), off ) );
891 else if ( control.group().is_master() )
893 // master fader touch
896 handle_strip_button( control, state.button_state, route );
901 // handle all non-strip buttons
902 surface().handle_button( *this, state.button_state, dynamic_cast<Button&>( control ) );
906 // pot (jog wheel, external control)
907 case Control::type_pot:
908 if ( control.group().is_strip() )
912 // pan for mono input routes, or stereo linked panners
913 if ( route->panner().size() == 1 || ( route->panner().size() == 2 && route->panner().linked() ) )
915 // assume pan for now
917 route->panner()[0]->get_effective_position (xpos);
919 // calculate new value, and trim
920 xpos += state.delta * state.sign;
923 else if ( xpos < 0.0 )
926 route->panner()[0]->set_position( xpos );
931 // it's a pot for an umnapped route, so turn all the lights off
932 port.write( builder.build_led_ring( dynamic_cast<Pot &>( control ), off ) );
937 if ( control.is_jog() )
939 _jog_wheel.jog_event( port, control, state );
943 cout << "external controller" << state.ticks * state.sign << endl;
949 cout << "Control::type not handled: " << control.type() << endl;
953 /////////////////////////////////////////////////
954 // handlers for Route signals
955 // TODO should these be part of RouteSignal?
956 // They started off as sigc handlers for signals
957 // from Route, but they're also used in polling for automation
958 /////////////////////////////////////////////////
960 void MackieControlProtocol::notify_solo_changed( RouteSignal * route_signal )
964 Button & button = route_signal->strip().solo();
965 route_signal->port().write( builder.build_led( button, route_signal->route().soloed() ) );
967 catch( exception & e )
969 cout << e.what() << endl;
973 void MackieControlProtocol::notify_mute_changed( RouteSignal * route_signal )
977 Button & button = route_signal->strip().mute();
978 route_signal->port().write( builder.build_led( button, route_signal->route().muted() ) );
980 catch( exception & e )
982 cout << e.what() << endl;
986 void MackieControlProtocol::notify_record_enable_changed( RouteSignal * route_signal )
990 Button & button = route_signal->strip().recenable();
991 route_signal->port().write( builder.build_led( button, route_signal->route().record_enabled() ) );
993 catch( exception & e )
995 cout << e.what() << endl;
999 void MackieControlProtocol::notify_active_changed( RouteSignal * route_signal )
1004 cout << "MackieControlProtocol::notify_active_changed" << endl;
1006 refresh_current_bank();
1008 catch( exception & e )
1010 cout << e.what() << endl;
1014 void MackieControlProtocol::notify_gain_changed( RouteSignal * route_signal, bool force_update )
1018 Fader & fader = route_signal->strip().gain();
1019 if ( !fader.in_use() )
1021 float gain_value = route_signal->route().gain_control().get_value();
1022 // check that something has actually changed
1023 if ( force_update || gain_value != route_signal->last_gain_written() )
1025 route_signal->port().write( builder.build_fader( fader, gain_value ) );
1026 route_signal->last_gain_written( gain_value );
1030 catch( exception & e )
1032 cout << e.what() << endl;
1036 void MackieControlProtocol::notify_name_changed( void *, RouteSignal * route_signal )
1040 Strip & strip = route_signal->strip();
1041 if ( !strip.is_master() )
1044 string fullname = route_signal->route().name();
1046 if ( fullname.length() <= 6 )
1052 line1 = PBD::short_version( fullname, 6 );
1055 SurfacePort & port = route_signal->port();
1056 port.write( builder.strip_display( port, strip, 0, line1 ) );
1057 port.write( builder.strip_display_blank( port, strip, 1 ) );
1060 catch( exception & e )
1062 cout << e.what() << endl;
1066 void MackieControlProtocol::notify_panner_changed( RouteSignal * route_signal, bool force_update )
1070 Pot & pot = route_signal->strip().vpot();
1071 const Panner & panner = route_signal->route().panner();
1072 if ( panner.size() == 1 || ( panner.size() == 2 && panner.linked() ) )
1075 route_signal->route().panner()[0]->get_effective_position( pos );
1077 // cache the MidiByteArray here, because the mackie led control is much lower
1078 // resolution than the panner control. So we save lots of byte
1079 // sends in spite of more work on the comparison
1080 MidiByteArray bytes = builder.build_led_ring( pot, ControlState( on, pos ), MackieMidiBuilder::midi_pot_mode_dot );
1081 // check that something has actually changed
1082 if ( force_update || bytes != route_signal->last_pan_written() )
1084 route_signal->port().write( bytes );
1085 route_signal->last_pan_written( bytes );
1090 route_signal->port().write( builder.zero_control( pot ) );
1093 catch( exception & e )
1095 cout << e.what() << endl;
1099 // TODO handle plugin automation polling
1100 void MackieControlProtocol::update_automation( RouteSignal & rs )
1102 ARDOUR::AutoState gain_state = rs.route().gain_automation_state();
1103 if ( gain_state == Touch || gain_state == Play )
1105 notify_gain_changed( &rs, false );
1108 ARDOUR::AutoState panner_state = rs.route().panner().automation_state();
1109 if ( panner_state == Touch || panner_state == Play )
1111 notify_panner_changed( &rs, false );
1113 _automation_last.start();
1116 string MackieControlProtocol::format_bbt_timecode( nframes_t now_frame )
1119 session->bbt_time( now_frame, bbt_time );
1121 // According to the Logic docs
1122 // digits: 888/88/88/888
1123 // BBT mode: Bars/Beats/Subdivisions/Ticks
1125 os << setw(3) << setfill('0') << bbt_time.bars;
1126 os << setw(2) << setfill('0') << bbt_time.beats;
1128 // figure out subdivisions per beat
1129 const Meter & meter = session->tempo_map().meter_at( now_frame );
1131 if ( meter.note_divisor() == 8 && (meter.beats_per_bar() == 12.0 || meter.beats_per_bar() == 9.0 || meter.beats_per_bar() == 6.0) )
1136 uint32_t subdivisions = bbt_time.ticks / uint32_t( Meter::ticks_per_beat / subdiv );
1137 uint32_t ticks = bbt_time.ticks % uint32_t( Meter::ticks_per_beat / subdiv );
1139 os << setw(2) << setfill('0') << subdivisions + 1;
1140 os << setw(3) << setfill('0') << ticks;
1145 string MackieControlProtocol::format_smpte_timecode( nframes_t now_frame )
1148 session->smpte_time( now_frame, smpte );
1150 // According to the Logic docs
1151 // digits: 888/88/88/888
1152 // SMPTE mode: Hours/Minutes/Seconds/Frames
1154 os << setw(3) << setfill('0') << smpte.hours;
1155 os << setw(2) << setfill('0') << smpte.minutes;
1156 os << setw(2) << setfill('0') << smpte.seconds;
1157 os << setw(3) << setfill('0') << smpte.frames;
1162 void MackieControlProtocol::update_timecode_display()
1164 if ( surface().has_timecode_display() )
1166 // do assignment here so current_frame is fixed
1167 nframes_t current_frame = session->transport_frame();
1170 switch ( _timecode_type )
1172 case ARDOUR::AnyTime::BBT:
1173 timecode = format_bbt_timecode( current_frame );
1175 case ARDOUR::AnyTime::SMPTE:
1176 timecode = format_smpte_timecode( current_frame );
1180 os << "Unknown timecode: " << _timecode_type;
1181 throw runtime_error( os.str() );
1184 // only write the timecode string to the MCU if it's changed
1185 // since last time. This is to reduce midi bandwidth used.
1186 if ( timecode != _timecode_last )
1188 surface().display_timecode( mcu_port(), builder, timecode, _timecode_last );
1189 _timecode_last = timecode;
1194 void MackieControlProtocol::poll_session_data()
1196 if ( _active && _automation_last.elapsed() >= 20 )
1198 // do all currently mapped routes
1199 for( RouteSignals::iterator it = route_signals.begin(); it != route_signals.end(); ++it )
1201 update_automation( **it );
1204 // and the master strip
1205 if ( master_route_signal != 0 )
1207 update_automation( *master_route_signal );
1210 update_timecode_display();
1212 _automation_last.start();
1216 /////////////////////////////////////
1217 // Transport Buttons
1218 /////////////////////////////////////
1220 LedState MackieControlProtocol::frm_left_press( Button & button )
1222 // can use first_mark_before/after as well
1223 unsigned long elapsed = _frm_left_last.restart();
1225 Location * loc = session->locations()->first_location_before (
1226 session->transport_frame()
1229 // allow a quick double to go past a previous mark
1230 if ( session->transport_rolling() && elapsed < 500 && loc != 0 )
1232 Location * loc_two_back = session->locations()->first_location_before ( loc->start() );
1233 if ( loc_two_back != 0 )
1239 // move to the location, if it's valid
1242 session->request_locate( loc->start(), session->transport_rolling() );
1248 LedState MackieControlProtocol::frm_left_release( Button & button )
1253 LedState MackieControlProtocol::frm_right_press( Button & button )
1255 // can use first_mark_before/after as well
1256 Location * loc = session->locations()->first_location_after (
1257 session->transport_frame()
1259 if ( loc != 0 ) session->request_locate( loc->start(), session->transport_rolling() );
1263 LedState MackieControlProtocol::frm_right_release( Button & button )
1268 LedState MackieControlProtocol::stop_press( Button & button )
1270 session->request_stop();
1274 LedState MackieControlProtocol::stop_release( Button & button )
1276 return session->transport_stopped();
1279 LedState MackieControlProtocol::play_press( Button & button )
1281 session->request_transport_speed( 1.0 );
1285 LedState MackieControlProtocol::play_release( Button & button )
1287 return session->transport_rolling();
1290 LedState MackieControlProtocol::record_press( Button & button )
1292 if ( session->get_record_enabled() )
1293 session->disable_record( false );
1295 session->maybe_enable_record();
1299 LedState MackieControlProtocol::record_release( Button & button )
1301 if ( session->get_record_enabled() )
1303 if ( session->transport_rolling() )
1312 LedState MackieControlProtocol::rewind_press( Button & button )
1314 _jog_wheel.push( JogWheel::speed );
1315 _jog_wheel.transport_direction( -1 );
1316 session->request_transport_speed( -_jog_wheel.transport_speed() );
1320 LedState MackieControlProtocol::rewind_release( Button & button )
1323 _jog_wheel.transport_direction( 0 );
1324 if ( _transport_previously_rolling )
1325 session->request_transport_speed( 1.0 );
1327 session->request_stop();
1331 LedState MackieControlProtocol::ffwd_press( Button & button )
1333 _jog_wheel.push( JogWheel::speed );
1334 _jog_wheel.transport_direction( 1 );
1335 session->request_transport_speed( _jog_wheel.transport_speed() );
1339 LedState MackieControlProtocol::ffwd_release( Button & button )
1342 _jog_wheel.transport_direction( 0 );
1343 if ( _transport_previously_rolling )
1344 session->request_transport_speed( 1.0 );
1346 session->request_stop();
1350 LedState MackieControlProtocol::loop_press( Button & button )
1352 session->request_play_loop( !session->get_play_loop() );
1356 LedState MackieControlProtocol::loop_release( Button & button )
1358 return session->get_play_loop();
1361 LedState MackieControlProtocol::punch_in_press( Button & button )
1363 bool state = !Config->get_punch_in();
1364 Config->set_punch_in( state );
1368 LedState MackieControlProtocol::punch_in_release( Button & button )
1370 return Config->get_punch_in();
1373 LedState MackieControlProtocol::punch_out_press( Button & button )
1375 bool state = !Config->get_punch_out();
1376 Config->set_punch_out( state );
1380 LedState MackieControlProtocol::punch_out_release( Button & button )
1382 return Config->get_punch_out();
1385 LedState MackieControlProtocol::home_press( Button & button )
1387 session->goto_start();
1391 LedState MackieControlProtocol::home_release( Button & button )
1396 LedState MackieControlProtocol::end_press( Button & button )
1398 session->goto_end();
1402 LedState MackieControlProtocol::end_release( Button & button )
1407 LedState MackieControlProtocol::clicking_press( Button & button )
1409 bool state = !Config->get_clicking();
1410 Config->set_clicking( state );
1414 LedState MackieControlProtocol::clicking_release( Button & button )
1416 return Config->get_clicking();
1419 LedState MackieControlProtocol::global_solo_press( Button & button )
1421 bool state = !session->soloing();
1422 session->set_all_solo ( state );
1426 LedState MackieControlProtocol::global_solo_release( Button & button )
1428 return session->soloing();
1431 ///////////////////////////////////////////
1433 ///////////////////////////////////////////
1435 void MackieControlProtocol::notify_parameter_changed( const char * name_str )
1437 string name( name_str );
1438 if ( name == "punch-in" )
1440 update_global_button( "punch_in", Config->get_punch_in() );
1442 else if ( name == "punch-out" )
1444 update_global_button( "punch_out", Config->get_punch_out() );
1446 else if ( name == "clicking" )
1448 update_global_button( "clicking", Config->get_clicking() );
1453 cout << "parameter changed: " << name << endl;
1458 // RouteList is the set of routes that have just been added
1459 void MackieControlProtocol::notify_route_added( ARDOUR::Session::RouteList & rl )
1461 // currently assigned banks are less than the full set of
1462 // strips, so activate the new strip now.
1463 if ( route_signals.size() < route_table.size() )
1465 refresh_current_bank();
1467 // otherwise route added, but current bank needs no updating
1469 // make sure remote id changes in the new route are handled
1470 typedef ARDOUR::Session::RouteList ARS;
1471 for ( ARS::iterator it = rl.begin(); it != rl.end(); ++it )
1473 connections_back = (*it)->RemoteControlIDChanged.connect( ( mem_fun (*this, &MackieControlProtocol::notify_remote_id_changed) ) );
1477 void MackieControlProtocol::notify_solo_active_changed( bool active )
1479 Button * rude_solo = reinterpret_cast<Button*>( surface().controls_by_name["solo"] );
1480 mcu_port().write( builder.build_led( *rude_solo, active ? flashing : off ) );
1483 void MackieControlProtocol::notify_remote_id_changed()
1485 Sorted sorted = get_sorted_routes();
1487 // if a remote id has been moved off the end, we need to shift
1488 // the current bank backwards.
1489 if ( sorted.size() - _current_initial_bank < route_signals.size() )
1491 // but don't shift backwards past the zeroth channel
1492 switch_banks( max((Sorted::size_type) 0, sorted.size() - route_signals.size() ) );
1494 // Otherwise just refresh the current bank
1497 refresh_current_bank();
1501 ///////////////////////////////////////////
1502 // Transport signals
1503 ///////////////////////////////////////////
1505 void MackieControlProtocol::notify_record_state_changed()
1507 // switch rec button on / off / flashing
1508 Button * rec = reinterpret_cast<Button*>( surface().controls_by_name["record"] );
1509 mcu_port().write( builder.build_led( *rec, record_release( *rec ) ) );
1512 void MackieControlProtocol::notify_transport_state_changed()
1514 // switch various play and stop buttons on / off
1515 update_global_button( "play", session->transport_rolling() );
1516 update_global_button( "stop", !session->transport_rolling() );
1517 update_global_button( "loop", session->get_play_loop() );
1519 _transport_previously_rolling = session->transport_rolling();
1521 // rec is special because it's tristate
1522 Button * rec = reinterpret_cast<Button*>( surface().controls_by_name["record"] );
1523 mcu_port().write( builder.build_led( *rec, record_release( *rec ) ) );
1526 /////////////////////////////////////
1528 /////////////////////////////////////
1529 LedState MackieControlProtocol::left_press( Button & button )
1531 Sorted sorted = get_sorted_routes();
1532 if ( sorted.size() > route_table.size() )
1534 int new_initial = _current_initial_bank - route_table.size();
1535 if ( new_initial < 0 ) new_initial = 0;
1536 if ( new_initial != int( _current_initial_bank ) )
1538 session->set_dirty();
1539 switch_banks( new_initial );
1550 LedState MackieControlProtocol::left_release( Button & button )
1555 LedState MackieControlProtocol::right_press( Button & button )
1557 Sorted sorted = get_sorted_routes();
1558 if ( sorted.size() > route_table.size() )
1560 uint32_t delta = sorted.size() - ( route_table.size() + _current_initial_bank );
1561 if ( delta > route_table.size() ) delta = route_table.size();
1564 session->set_dirty();
1565 switch_banks( _current_initial_bank + delta );
1576 LedState MackieControlProtocol::right_release( Button & button )
1581 LedState MackieControlProtocol::channel_left_press( Button & button )
1583 Sorted sorted = get_sorted_routes();
1584 if ( sorted.size() > route_table.size() )
1595 LedState MackieControlProtocol::channel_left_release( Button & button )
1600 LedState MackieControlProtocol::channel_right_press( Button & button )
1602 Sorted sorted = get_sorted_routes();
1603 if ( sorted.size() > route_table.size() )
1614 LedState MackieControlProtocol::channel_right_release( Button & button )
1619 /////////////////////////////////////
1621 /////////////////////////////////////
1622 LedState MackieControlProtocol::marker_press( Button & button )
1624 // cut'n'paste from LocationUI::add_new_location()
1626 nframes_t where = session->audible_frame();
1627 session->locations()->next_available_name(markername,"mcu");
1628 Location *location = new Location (where, where, markername, Location::IsMark);
1629 session->begin_reversible_command (_("add marker"));
1630 XMLNode &before = session->locations()->get_state();
1631 session->locations()->add (location, true);
1632 XMLNode &after = session->locations()->get_state();
1633 session->add_command (new MementoCommand<Locations>(*(session->locations()), &before, &after));
1634 session->commit_reversible_command ();
1638 LedState MackieControlProtocol::marker_release( Button & button )
1643 void jog_wheel_state_display( JogWheel::State state, SurfacePort & port )
1647 case JogWheel::zoom: port.write( builder.two_char_display( "Zm" ) ); break;
1648 case JogWheel::scroll: port.write( builder.two_char_display( "Sc" ) ); break;
1649 case JogWheel::scrub: port.write( builder.two_char_display( "Sb" ) ); break;
1650 case JogWheel::shuttle: port.write( builder.two_char_display( "Sh" ) ); break;
1651 case JogWheel::speed: port.write( builder.two_char_display( "Sp" ) ); break;
1652 case JogWheel::select: port.write( builder.two_char_display( "Se" ) ); break;
1656 Mackie::LedState MackieControlProtocol::zoom_press( Mackie::Button & )
1658 _jog_wheel.zoom_state_toggle();
1659 update_global_button( "scrub", _jog_wheel.jog_wheel_state() == JogWheel::scrub );
1660 jog_wheel_state_display( _jog_wheel.jog_wheel_state(), mcu_port() );
1661 return _jog_wheel.jog_wheel_state() == JogWheel::zoom;
1664 Mackie::LedState MackieControlProtocol::zoom_release( Mackie::Button & )
1666 return _jog_wheel.jog_wheel_state() == JogWheel::zoom;
1669 Mackie::LedState MackieControlProtocol::scrub_press( Mackie::Button & )
1671 _jog_wheel.scrub_state_cycle();
1672 update_global_button( "zoom", _jog_wheel.jog_wheel_state() == JogWheel::zoom );
1673 jog_wheel_state_display( _jog_wheel.jog_wheel_state(), mcu_port() );
1675 _jog_wheel.jog_wheel_state() == JogWheel::scrub
1677 _jog_wheel.jog_wheel_state() == JogWheel::shuttle
1681 Mackie::LedState MackieControlProtocol::scrub_release( Mackie::Button & )
1684 _jog_wheel.jog_wheel_state() == JogWheel::scrub
1686 _jog_wheel.jog_wheel_state() == JogWheel::shuttle
1690 LedState MackieControlProtocol::drop_press( Button & button )
1692 session->remove_last_capture();
1696 LedState MackieControlProtocol::drop_release( Button & button )
1701 LedState MackieControlProtocol::save_press( Button & button )
1703 session->save_state( "" );
1707 LedState MackieControlProtocol::save_release( Button & button )
1712 LedState MackieControlProtocol::smpte_beats_press( Button & )
1714 switch ( _timecode_type )
1716 case ARDOUR::AnyTime::BBT:
1717 _timecode_type = ARDOUR::AnyTime::SMPTE;
1719 case ARDOUR::AnyTime::SMPTE:
1720 _timecode_type = ARDOUR::AnyTime::BBT;
1724 os << "Unknown Anytime::Type " << _timecode_type;
1725 throw runtime_error( os.str() );
1727 update_smpte_beats_led();
1731 LedState MackieControlProtocol::smpte_beats_release( Button & )