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