libs/surfaces/mackie/mackie_control_protocol.h

   1 /*
   2     Copyright (C) 2006,2007 John Anderson
   3
   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.
   8
   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.
  13
  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.
  17 */
  18
  19 #ifndef ardour_mackie_control_protocol_h
  20 #define ardour_mackie_control_protocol_h
  21
  22 #include <vector>
  23 #include <map>
  24 #include <list>
  25 #include <set>
  26
  27 #include <sys/time.h>
  28 #include <pthread.h>
  29 #include <boost/smart_ptr.hpp>
  30
  31 #include <glibmm/thread.h>
  32
  33 #include "pbd/abstract_ui.h"
  34 #include "midi++/types.h"
  35 #include "ardour/types.h"
  36 #include "control_protocol/control_protocol.h"
  37
  38 #include "types.h"
  39 #include "midi_byte_array.h"
  40 #include "controls.h"
  41 #include "mackie_jog_wheel.h"
  42 #include "timer.h"
  43 #include "device_info.h"
  44 #include "device_profile.h"
  45
  46 namespace ARDOUR {
  47         class AutomationControl;
  48 }
  49
  50 namespace MIDI {
  51         class Port;
  52 }
  53
  54 namespace Mackie {
  55         class Surface;
  56         class Control;
  57         class SurfacePort;
  58         class Button;
  59 }
  60
  61 /**
  62         This handles the plugin duties, and the midi encoding and decoding,
  63         and the signal callbacks, mostly from ARDOUR::Route.
  64
  65         The model of the control surface is handled by classes in controls.h
  66
  67         What happens is that each strip on the control surface has
  68         a corresponding route in ControlProtocol::route_table. When
  69         an incoming midi message is signaled, the correct route
  70         is looked up, and the relevant changes made to it.
  71
  72         For each route currently in route_table, there's a RouteSignal object
  73         which encapsulates the signals that indicate that there are changes
  74         to be sent to the surface. The signals are handled by this class.
  75
  76         Calls to signal handlers pass a Route object which is used to look
  77         up the relevant Strip in Surface. Then the state is retrieved from
  78         the Route and encoded as the correct midi message.
  79 */
  80
  81 struct MackieControlUIRequest : public BaseUI::BaseRequestObject {
  82 public:
  83         MackieControlUIRequest () {}
  84         ~MackieControlUIRequest () {}
  85 };
  86
  87 class MackieControlProtocol
  88         : public ARDOUR::ControlProtocol
  89         , public AbstractUI<MackieControlUIRequest>
  90 {
  91   public:
  92         static const int MODIFIER_OPTION;
  93         static const int MODIFIER_CONTROL;
  94         static const int MODIFIER_SHIFT;
  95         static const int MODIFIER_CMDALT;
  96
  97         enum ViewMode {
  98                 Mixer,
  99                 Dynamics,
 100                 EQ,
 101                 Loop,
 102                 AudioTracks,
 103                 MidiTracks,
 104                 Busses,
 105                 Sends,
 106                 Plugins,
 107         };
 108
 109         enum FlipMode {
 110                 Normal, /* fader controls primary, vpot controls secondary */
 111                 Mirror, /* fader + vpot control secondary */
 112                 Swap,   /* fader controls secondary, vpot controls primary */
 113                 Zero,   /* fader controls primary, but doesn't move, vpot controls secondary */
 114         };
 115
 116         MackieControlProtocol(ARDOUR::Session &);
 117         virtual ~MackieControlProtocol();
 118
 119         static MackieControlProtocol* instance() { return _instance; }
 120
 121         const Mackie::DeviceInfo& device_info() const { return _device_info; }
 122         const Mackie::DeviceProfile& device_profile() const { return _device_profile; }
 123
 124         int set_active (bool yn);
 125         void set_device (const std::string&);
 126         void set_profile (const std::string&);
 127
 128         bool     flip_mode () const { return _flip_mode; }
 129         ViewMode view_mode () const { return _view_mode; }
 130
 131         void set_view_mode (ViewMode);
 132         void set_flip_mode (bool);
 133
 134         XMLNode& get_state ();
 135         int set_state (const XMLNode&, int version);
 136
 137         static bool probe();
 138
 139         typedef std::list<boost::shared_ptr<Mackie::Surface> > Surfaces;
 140         Surfaces surfaces;
 141
 142         std::list<boost::shared_ptr<ARDOUR::Bundle> > bundles ();
 143
 144         void set_master_on_surface_strip (uint32_t surface, uint32_t strip);
 145         void set_monitor_on_surface_strip (uint32_t surface, uint32_t strip);
 146
 147         uint32_t n_strips () const;
 148
 149         bool has_editor () const { return true; }
 150         void* get_gui () const;
 151         void tear_down_gui ();
 152
 153         void handle_button_event (Mackie::Surface&, Mackie::Button& button, Mackie::ButtonState);
 154
 155         void notify_route_added (ARDOUR::RouteList &);
 156         void notify_remote_id_changed();
 157
 158         /// rebuild the current bank. Called on route added/removed and
 159         /// remote id changed.
 160         void refresh_current_bank();
 161
 162         // button-related signals
 163         void notify_record_state_changed();
 164         void notify_transport_state_changed();
 165         void notify_loop_state_changed();
 166         // mainly to pick up punch-in and punch-out
 167         void notify_parameter_changed(std::string const &);
 168         void notify_solo_active_changed(bool);
 169
 170         /// Turn timecode on and beats off, or vice versa, depending
 171         /// on state of _timecode_type
 172         void update_timecode_beats_led();
 173
 174         /// this is called to generate the midi to send in response to a button press.
 175         void update_led(Mackie::Surface&, Mackie::Button & button, Mackie::LedState);
 176
 177         void update_global_button (int id, Mackie::LedState);
 178         void update_global_led (int id, Mackie::LedState);
 179
 180         ARDOUR::Session & get_session() { return *session; }
 181         framepos_t transport_frame() const;
 182
 183         int modifier_state() const { return _modifier_state; }
 184
 185         typedef std::list<boost::shared_ptr<ARDOUR::AutomationControl> > ControlList;
 186
 187         void add_down_button (ARDOUR::AutomationType, int surface, int strip);
 188         void remove_down_button (ARDOUR::AutomationType, int surface, int strip);
 189         ControlList down_controls (ARDOUR::AutomationType);
 190
 191         void add_down_select_button (int surface, int strip);
 192         void remove_down_select_button (int surface, int strip);
 193         void select_range ();
 194
 195   protected:
 196         // shut down the surface
 197         void close();
 198
 199         // This sets up the notifications and sets the
 200         // controls to the correct values
 201         void update_surfaces();
 202
 203         // connects global (not strip) signals from the Session to here
 204         // so the surface can be notified of changes from the other UIs.
 205         void connect_session_signals();
 206
 207         // set all controls to their zero position
 208         void zero_all();
 209
 210         /**
 211            Fetch the set of routes to be considered for control by the
 212            surface. Excluding master, hidden and control routes, and inactive routes
 213         */
 214         typedef std::vector<boost::shared_ptr<ARDOUR::Route> > Sorted;
 215         Sorted get_sorted_routes();
 216
 217         // bank switching
 218         void switch_banks (uint32_t first_remote_id, bool force = false);
 219         void prev_track ();
 220         void next_track ();
 221
 222         // also called from poll_automation to update timecode display
 223         void update_timecode_display();
 224
 225         std::string format_bbt_timecode (ARDOUR::framepos_t now_frame);
 226         std::string format_timecode_timecode (ARDOUR::framepos_t now_frame);
 227
 228         void do_request (MackieControlUIRequest*);
 229         int stop ();
 230
 231         void thread_init ();
 232
 233         /* handling function key presses */
 234
 235         void f_press (uint32_t fn);
 236
 237   private:
 238
 239         struct ButtonHandlers {
 240             Mackie::LedState (MackieControlProtocol::*press) (Mackie::Button&);
 241             Mackie::LedState (MackieControlProtocol::*release) (Mackie::Button&);
 242
 243             ButtonHandlers (Mackie::LedState (MackieControlProtocol::*p) (Mackie::Button&),
 244                             Mackie::LedState (MackieControlProtocol::*r) (Mackie::Button&))
 245             : press (p)
 246             , release (r) {}
 247         };
 248
 249         typedef std::map<Mackie::Button::ID,ButtonHandlers> ButtonMap;
 250         typedef std::list<GSource*> PortSources;
 251
 252         static MackieControlProtocol* _instance;
 253
 254         Mackie::DeviceInfo       _device_info;
 255         Mackie::DeviceProfile    _device_profile;
 256         sigc::connection          periodic_connection;
 257         uint32_t                 _current_initial_bank;
 258         PBD::ScopedConnectionList audio_engine_connections;
 259         PBD::ScopedConnectionList session_connections;
 260         PBD::ScopedConnectionList port_connections;
 261         PBD::ScopedConnectionList route_connections;
 262         PBD::ScopedConnectionList gui_connections;
 263         bool _transport_previously_rolling;
 264         // timer for two quick marker left presses
 265         Mackie::Timer            _frm_left_last;
 266         // last written timecode string
 267         std::string              _timecode_last;
 268         // Which timecode are we displaying? BBT or Timecode
 269         ARDOUR::AnyTime::Type    _timecode_type;
 270         // Bundle to represent our input ports
 271         boost::shared_ptr<ARDOUR::Bundle> _input_bundle;
 272         // Bundle to represent our output ports
 273         boost::shared_ptr<ARDOUR::Bundle> _output_bundle;
 274         void*                    _gui;
 275         bool                     _zoom_mode;
 276         bool                     _scrub_mode;
 277         bool                     _flip_mode;
 278         ViewMode                 _view_mode;
 279         int                      _current_selected_track;
 280         int                      _modifier_state;
 281         PortSources               port_sources;
 282         ButtonMap                 button_map;
 283
 284         void create_surfaces ();
 285         void port_connected_or_disconnected (std::string, std::string, bool);
 286         bool periodic();
 287         void build_gui ();
 288         bool midi_input_handler (Glib::IOCondition ioc, MIDI::Port* port);
 289         void clear_ports ();
 290         void force_special_route_to_strip (boost::shared_ptr<ARDOUR::Route> r, uint32_t surface, uint32_t strip_number);
 291         void build_button_map ();
 292
 293         void gui_track_selection_changed (ARDOUR::RouteNotificationListPtr);
 294
 295
 296         /* BUTTON HANDLING */
 297
 298         typedef std::set<uint32_t> DownButtonList;
 299         typedef std::map<ARDOUR::AutomationType,DownButtonList> DownButtonMap;
 300         DownButtonMap  _down_buttons;
 301         DownButtonList _down_select_buttons;
 302
 303         void pull_route_range (DownButtonList&, ARDOUR::RouteList&);
 304
 305         /* implemented button handlers */
 306         Mackie::LedState frm_left_press(Mackie::Button &);
 307         Mackie::LedState frm_left_release(Mackie::Button &);
 308         Mackie::LedState frm_right_press(Mackie::Button &);
 309         Mackie::LedState frm_right_release(Mackie::Button &);
 310         Mackie::LedState stop_press(Mackie::Button &);
 311         Mackie::LedState stop_release(Mackie::Button &);
 312         Mackie::LedState play_press(Mackie::Button &);
 313         Mackie::LedState play_release(Mackie::Button &);
 314         Mackie::LedState record_press(Mackie::Button &);
 315         Mackie::LedState record_release(Mackie::Button &);
 316         Mackie::LedState loop_press(Mackie::Button &);
 317         Mackie::LedState loop_release(Mackie::Button &);
 318         Mackie::LedState punch_in_press(Mackie::Button &);
 319         Mackie::LedState punch_in_release(Mackie::Button &);
 320         Mackie::LedState punch_out_press(Mackie::Button &);
 321         Mackie::LedState punch_out_release(Mackie::Button &);
 322         Mackie::LedState home_press(Mackie::Button &);
 323         Mackie::LedState home_release(Mackie::Button &);
 324         Mackie::LedState end_press(Mackie::Button &);
 325         Mackie::LedState end_release(Mackie::Button &);
 326         Mackie::LedState rewind_press(Mackie::Button & button);
 327         Mackie::LedState rewind_release(Mackie::Button & button);
 328         Mackie::LedState ffwd_press(Mackie::Button & button);
 329         Mackie::LedState ffwd_release(Mackie::Button & button);
 330         Mackie::LedState cursor_up_press (Mackie::Button &);
 331         Mackie::LedState cursor_up_release (Mackie::Button &);
 332         Mackie::LedState cursor_down_press (Mackie::Button &);
 333         Mackie::LedState cursor_down_release (Mackie::Button &);
 334         Mackie::LedState cursor_left_press (Mackie::Button &);
 335         Mackie::LedState cursor_left_release (Mackie::Button &);
 336         Mackie::LedState cursor_right_press (Mackie::Button &);
 337         Mackie::LedState cursor_right_release (Mackie::Button &);
 338         Mackie::LedState left_press(Mackie::Button &);
 339         Mackie::LedState left_release(Mackie::Button &);
 340         Mackie::LedState right_press(Mackie::Button &);
 341         Mackie::LedState right_release(Mackie::Button &);
 342         Mackie::LedState channel_left_press(Mackie::Button &);
 343         Mackie::LedState channel_left_release(Mackie::Button &);
 344         Mackie::LedState channel_right_press(Mackie::Button &);
 345         Mackie::LedState channel_right_release(Mackie::Button &);
 346         Mackie::LedState clicking_press(Mackie::Button &);
 347         Mackie::LedState clicking_release(Mackie::Button &);
 348         Mackie::LedState global_solo_press(Mackie::Button &);
 349         Mackie::LedState global_solo_release(Mackie::Button &);
 350         Mackie::LedState marker_press(Mackie::Button &);
 351         Mackie::LedState marker_release(Mackie::Button &);
 352         Mackie::LedState save_press(Mackie::Button &);
 353         Mackie::LedState save_release(Mackie::Button &);
 354         Mackie::LedState timecode_beats_press(Mackie::Button &);
 355         Mackie::LedState timecode_beats_release(Mackie::Button &);
 356         Mackie::LedState zoom_press(Mackie::Button &);
 357         Mackie::LedState zoom_release(Mackie::Button &);
 358         Mackie::LedState scrub_press(Mackie::Button &);
 359         Mackie::LedState scrub_release(Mackie::Button &);
 360         Mackie::LedState undo_press (Mackie::Button &);
 361         Mackie::LedState undo_release (Mackie::Button &);
 362         Mackie::LedState redo_press (Mackie::Button &);
 363         Mackie::LedState redo_release (Mackie::Button &);
 364         Mackie::LedState shift_press (Mackie::Button &);
 365         Mackie::LedState shift_release (Mackie::Button &);
 366         Mackie::LedState option_press (Mackie::Button &);
 367         Mackie::LedState option_release (Mackie::Button &);
 368         Mackie::LedState control_press (Mackie::Button &);
 369         Mackie::LedState control_release (Mackie::Button &);
 370         Mackie::LedState cmd_alt_press (Mackie::Button &);
 371         Mackie::LedState cmd_alt_release (Mackie::Button &);
 372
 373         Mackie::LedState io_press (Mackie::Button &);
 374         Mackie::LedState io_release (Mackie::Button &);
 375         Mackie::LedState sends_press (Mackie::Button &);
 376         Mackie::LedState sends_release (Mackie::Button &);
 377         Mackie::LedState pan_press (Mackie::Button &);
 378         Mackie::LedState pan_release (Mackie::Button &);
 379         Mackie::LedState plugin_press (Mackie::Button &);
 380         Mackie::LedState plugin_release (Mackie::Button &);
 381         Mackie::LedState eq_press (Mackie::Button &);
 382         Mackie::LedState eq_release (Mackie::Button &);
 383         Mackie::LedState dyn_press (Mackie::Button &);
 384         Mackie::LedState dyn_release (Mackie::Button &);
 385         Mackie::LedState flip_press (Mackie::Button &);
 386         Mackie::LedState flip_release (Mackie::Button &);
 387         Mackie::LedState edit_press (Mackie::Button &);
 388         Mackie::LedState edit_release (Mackie::Button &);
 389         Mackie::LedState name_value_press (Mackie::Button &);
 390         Mackie::LedState name_value_release (Mackie::Button &);
 391         Mackie::LedState F1_press (Mackie::Button &);
 392         Mackie::LedState F1_release (Mackie::Button &);
 393         Mackie::LedState F2_press (Mackie::Button &);
 394         Mackie::LedState F2_release (Mackie::Button &);
 395         Mackie::LedState F3_press (Mackie::Button &);
 396         Mackie::LedState F3_release (Mackie::Button &);
 397         Mackie::LedState F4_press (Mackie::Button &);
 398         Mackie::LedState F4_release (Mackie::Button &);
 399         Mackie::LedState F5_press (Mackie::Button &);
 400         Mackie::LedState F5_release (Mackie::Button &);
 401         Mackie::LedState F6_press (Mackie::Button &);
 402         Mackie::LedState F6_release (Mackie::Button &);
 403         Mackie::LedState F7_press (Mackie::Button &);
 404         Mackie::LedState F7_release (Mackie::Button &);
 405         Mackie::LedState F8_press (Mackie::Button &);
 406         Mackie::LedState F8_release (Mackie::Button &);
 407         Mackie::LedState F9_press (Mackie::Button &);
 408         Mackie::LedState F9_release (Mackie::Button &);
 409         Mackie::LedState F10_press (Mackie::Button &);
 410         Mackie::LedState F10_release (Mackie::Button &);
 411         Mackie::LedState F11_press (Mackie::Button &);
 412         Mackie::LedState F11_release (Mackie::Button &);
 413         Mackie::LedState F12_press (Mackie::Button &);
 414         Mackie::LedState F12_release (Mackie::Button &);
 415         Mackie::LedState F13_press (Mackie::Button &);
 416         Mackie::LedState F13_release (Mackie::Button &);
 417         Mackie::LedState F14_press (Mackie::Button &);
 418         Mackie::LedState F14_release (Mackie::Button &);
 419         Mackie::LedState F15_press (Mackie::Button &);
 420         Mackie::LedState F15_release (Mackie::Button &);
 421         Mackie::LedState F16_press (Mackie::Button &);
 422         Mackie::LedState F16_release (Mackie::Button &);
 423         Mackie::LedState on_press (Mackie::Button &);
 424         Mackie::LedState on_release (Mackie::Button &);
 425         Mackie::LedState rec_ready_press (Mackie::Button &);
 426         Mackie::LedState rec_ready_release (Mackie::Button &);
 427         Mackie::LedState touch_press (Mackie::Button &);
 428         Mackie::LedState touch_release (Mackie::Button &);
 429         Mackie::LedState enter_press (Mackie::Button &);
 430         Mackie::LedState enter_release (Mackie::Button &);
 431         Mackie::LedState cancel_press (Mackie::Button &);
 432         Mackie::LedState cancel_release (Mackie::Button &);
 433         Mackie::LedState mixer_press (Mackie::Button &);
 434         Mackie::LedState mixer_release (Mackie::Button &);
 435         Mackie::LedState user_a_press (Mackie::Button &);
 436         Mackie::LedState user_a_release (Mackie::Button &);
 437         Mackie::LedState user_b_press (Mackie::Button &);
 438         Mackie::LedState user_b_release (Mackie::Button &);
 439         Mackie::LedState fader_touch_press (Mackie::Button &);
 440         Mackie::LedState fader_touch_release (Mackie::Button &);
 441
 442         Mackie::LedState snapshot_press (Mackie::Button&);
 443         Mackie::LedState snapshot_release (Mackie::Button&);
 444         Mackie::LedState read_press (Mackie::Button&);
 445         Mackie::LedState read_release (Mackie::Button&);
 446         Mackie::LedState write_press (Mackie::Button&);
 447         Mackie::LedState write_release (Mackie::Button&);
 448         Mackie::LedState fdrgroup_press (Mackie::Button&);
 449         Mackie::LedState fdrgroup_release (Mackie::Button&);
 450         Mackie::LedState clearsolo_press (Mackie::Button&);
 451         Mackie::LedState clearsolo_release (Mackie::Button&);
 452         Mackie::LedState track_press (Mackie::Button&);
 453         Mackie::LedState track_release (Mackie::Button&);
 454         Mackie::LedState send_press (Mackie::Button&);
 455         Mackie::LedState send_release (Mackie::Button&);
 456         Mackie::LedState miditracks_press (Mackie::Button&);
 457         Mackie::LedState miditracks_release (Mackie::Button&);
 458         Mackie::LedState inputs_press (Mackie::Button&);
 459         Mackie::LedState inputs_release (Mackie::Button&);
 460         Mackie::LedState audiotracks_press (Mackie::Button&);
 461         Mackie::LedState audiotracks_release (Mackie::Button&);
 462         Mackie::LedState audioinstruments_press (Mackie::Button&);
 463         Mackie::LedState audioinstruments_release (Mackie::Button&);
 464         Mackie::LedState aux_press (Mackie::Button&);
 465         Mackie::LedState aux_release (Mackie::Button&);
 466         Mackie::LedState busses_press (Mackie::Button&);
 467         Mackie::LedState busses_release (Mackie::Button&);
 468         Mackie::LedState outputs_press (Mackie::Button&);
 469         Mackie::LedState outputs_release (Mackie::Button&);
 470         Mackie::LedState user_press (Mackie::Button&);
 471         Mackie::LedState user_release (Mackie::Button&);
 472         Mackie::LedState trim_press (Mackie::Button&);
 473         Mackie::LedState trim_release (Mackie::Button&);
 474         Mackie::LedState latch_press (Mackie::Button&);
 475         Mackie::LedState latch_release (Mackie::Button&);
 476         Mackie::LedState grp_press (Mackie::Button&);
 477         Mackie::LedState grp_release (Mackie::Button&);
 478         Mackie::LedState nudge_press (Mackie::Button&);
 479         Mackie::LedState nudge_release (Mackie::Button&);
 480         Mackie::LedState drop_press (Mackie::Button&);
 481         Mackie::LedState drop_release (Mackie::Button&);
 482         Mackie::LedState replace_press (Mackie::Button&);
 483         Mackie::LedState replace_release (Mackie::Button&);
 484         Mackie::LedState click_press (Mackie::Button&);
 485         Mackie::LedState click_release (Mackie::Button&);
 486         Mackie::LedState view_press (Mackie::Button&);
 487         Mackie::LedState view_release (Mackie::Button&);
 488 };
 489
 490
 491
 492 #endif // ardour_mackie_control_protocol_h