/* Copyright (C) 2006,2007 John Anderson This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ #ifndef ardour_mackie_control_protocol_h #define ardour_mackie_control_protocol_h #include #include #include #include #include #include #include #include #include "midi_byte_array.h" #include "controls.h" #include "route_signal.h" #include "mackie_button_handler.h" #include "mackie_port.h" namespace MIDI { class Port; class Parser; } namespace Mackie { class Surface; } /** This handles the plugin duties, and the midi encoding and decoding, and the signal callbacks, mostly from ARDOUR::Route. The model of the control surface is handled by classes in controls.h What happens is that each strip on the control surface has a corresponding route in ControlProtocol::route_table. When an incoming midi message is signaled, the correct route is looked up, and the relevant changes made to it. For each route currently in route_table, there's a RouteSignal object which encapsulates the signals that indicate that there are changes to be sent to the surface. The signals are handled by this class. Calls to signal handlers pass a Route object which is used to look up the relevant Strip in Surface. Then the state is retrieved from the Route and encoded as the correct midi message. */ class MackieControlProtocol : public ARDOUR::ControlProtocol , public Mackie::MackieButtonHandler { public: MackieControlProtocol( ARDOUR::Session & ); virtual ~MackieControlProtocol(); int set_active (bool yn); XMLNode& get_state (); int set_state (const XMLNode&); static bool probe(); Mackie::Surface & surface(); // control events void handle_control_event( Mackie::SurfacePort & port, Mackie::Control & control, const Mackie::ControlState & state ); // strip/route related stuff public: /// Signal handler for Route::solo void notify_solo_changed( ARDOUR::Route *, Mackie::MackiePort * ); /// Signal handler for Route::mute void notify_mute_changed( ARDOUR::Route *, Mackie::MackiePort * ); /// Signal handler for Route::record_enable_changed void notify_record_enable_changed( ARDOUR::Route *, Mackie::MackiePort * ); /// Signal handler for Route::gain_changed ( from IO ) void notify_gain_changed( ARDOUR::Route *, Mackie::MackiePort * ); /// Signal handler for Route::name_change void notify_name_changed( void *, ARDOUR::Route *, Mackie::MackiePort * ); /// Signal handler from Panner::Change void notify_panner_changed( ARDOUR::Route *, Mackie::MackiePort * ); /// Signal handler for new routes added void notify_route_added( ARDOUR::Session::RouteList & ); /// rebuild the current bank. Called on route added/removed and /// remote id changed. void refresh_current_bank(); // global buttons (ie button not part of strips) public: // button-related signals void notify_record_state_changed(); void notify_transport_state_changed(); // mainly to pick up punch-in and punch-out void notify_parameter_changed( const char * ); void notify_solo_active_changed( bool ); // this is called to generate the midi to send in response to // a button press. void update_led( Mackie::Button & button, Mackie::LedState ); // calls update_led, but looks up the button by name void update_global_button( const std::string & name, Mackie::LedState ); // transport button handler methods from MackieButtonHandler virtual Mackie::LedState rewind_press( Mackie::Button & ); virtual Mackie::LedState rewind_release( Mackie::Button & ); virtual Mackie::LedState ffwd_press( Mackie::Button & ); virtual Mackie::LedState ffwd_release( Mackie::Button & ); virtual Mackie::LedState stop_press( Mackie::Button & ); virtual Mackie::LedState stop_release( Mackie::Button & ); virtual Mackie::LedState play_press( Mackie::Button & ); virtual Mackie::LedState play_release( Mackie::Button & ); virtual Mackie::LedState record_press( Mackie::Button & ); virtual Mackie::LedState record_release( Mackie::Button & ); virtual Mackie::LedState loop_press( Mackie::Button & ); virtual Mackie::LedState loop_release( Mackie::Button & ); virtual Mackie::LedState punch_in_press( Mackie::Button & ); virtual Mackie::LedState punch_in_release( Mackie::Button & ); virtual Mackie::LedState punch_out_press( Mackie::Button & ); virtual Mackie::LedState punch_out_release( Mackie::Button & ); virtual Mackie::LedState home_press( Mackie::Button & ); virtual Mackie::LedState home_release( Mackie::Button & ); virtual Mackie::LedState end_press( Mackie::Button & ); virtual Mackie::LedState end_release( Mackie::Button & ); // bank switching button handler methods from MackieButtonHandler virtual Mackie::LedState left_press( Mackie::Button & ); virtual Mackie::LedState left_release( Mackie::Button & ); virtual Mackie::LedState right_press( Mackie::Button & ); virtual Mackie::LedState right_release( Mackie::Button & ); virtual Mackie::LedState channel_left_press( Mackie::Button & ); virtual Mackie::LedState channel_left_release( Mackie::Button & ); virtual Mackie::LedState channel_right_press( Mackie::Button & ); virtual Mackie::LedState channel_right_release( Mackie::Button & ); protected: // create instances of MackiePort, depending on what's found in ardour.rc void create_ports(); // shut down the surface void close(); // create the Surface object, with the correct number // of strips for the currently connected ports and // hook up the control event notification void initialize_surface(); // This sets up the notifications and sets the // controls to the correct values void update_surface(); // connects global (not strip) signals from the Session to here // so the surface can be notified of changes from the other UIs. void connect_session_signals(); // set all controls to their zero position void zero_all(); /** Fetch the set of routes to be considered for control by the surface. Excluding master, hidden and control routes, and inactive routes */ typedef std::vector > Sorted; Sorted get_sorted_routes(); // bank switching void switch_banks( int initial ); void prev_track(); void next_track(); // delete all RouteSignal objects connecting Routes to Strips void clear_route_signals(); /// This is the main MCU port, ie not an extender port const Mackie::MackiePort & mcu_port() const; Mackie::MackiePort & mcu_port(); typedef std::vector RouteSignals; RouteSignals route_signals; // return which of the ports a particular route_table // index belongs to Mackie::MackiePort & port_for_id( uint32_t index ); /** Handle a button press for the control and return whether the corresponding light should be on or off. */ bool handle_strip_button( Mackie::Control &, Mackie::ButtonState, boost::shared_ptr ); // Polling midi port(s) for incoming messages static void* _monitor_work (void* arg); void* monitor_work (); /// rebuild the set of ports for this surface void update_ports(); /// Returns true if there is pending data, false otherwise bool poll_ports(); /// Trigger the MIDI::Parser void read_ports(); void add_port( MIDI::Port &, int number ); /** used by the notify_XXX methods to find a strip corresponding to the Route passed in. */ Mackie::Strip & strip_from_route( ARDOUR::Route * route ); /// notification from the MackiePorts that their status has changed void handle_port_changed( Mackie::SurfacePort *, bool active ); /** notification that the port is about to start it's init sequence. We must make sure that before this exits, the port is being polled for new data. */ void handle_port_init( Mackie::SurfacePort * ); boost::shared_ptr master_route(); Mackie::Strip & master_strip(); private: boost::shared_ptr master_route_signal; static const char * default_port_name; /// The Midi port(s) connected to the units typedef vector MackiePorts; MackiePorts _ports; // the thread that polls the ports for incoming midi data pthread_t thread; /// The initial remote_id of the currently switched in bank. uint32_t _current_initial_bank; /// protects the port list, and polling structures Glib::Mutex update_mutex; /// Protects set_active, and allows waiting on the poll thread Glib::Cond update_cond; // because sigc::trackable doesn't seem to be working std::vector _connections; std::back_insert_iterator > connections_back; /// The representation of the physical controls on the surface. Mackie::Surface * _surface; /// If a port is opened or closed, this will be /// true until the port configuration is updated; bool _ports_changed; struct pollfd * pfd; int nfds; }; #endif // ardour_mackie_control_protocol_h