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.
21 #include "surface_port.h"
23 #include <midi++/types.h>
24 #include <boost/signals2.hpp>
26 #include <glibmm/thread.h>
28 #include "midi_byte_array.h"
36 class MackieControlProtocol;
41 class MackiePort : public SurfacePort
44 enum port_type_t { mcu, ext };
45 enum emulation_t { none, mackie, bcf2000 };
47 MackiePort( MackieControlProtocol & mcp, MIDI::Port & port, int number, port_type_t = mcu );
53 /// MCU and extenders have different sysex headers
54 virtual const MidiByteArray & sysex_hdr() const;
56 /// Handle device initialisation
57 void handle_midi_sysex( MIDI::Parser &, MIDI::byte *, size_t count );
59 /// Handle all control messags
60 void handle_midi_any( MIDI::Parser &, MIDI::byte *, size_t count );
62 Control & lookup_control( MIDI::byte *, size_t count );
64 /// return the number of strips associated with this port
65 virtual int strips() const;
67 /// Block until the port has finished initialising, and then return
68 /// whether the intialisation succeeded
71 emulation_t emulation() const { return _emulation; }
73 /// Connect the any signal from the parser to handle_midi_any
74 /// unless it's already connected
79 The initialisation sequence is fairly complex. First a lock is acquired
80 so that a condition can be used to signal the end of the init process.
81 Then a sysex is sent to the device. The response to the sysex
82 is handled by a switch in handle_midi_sysex which calls one of the
85 However, windows DAWs ignore the documented init sequence and so we
86 do too. Thanks to Essox for helping with this.
88 So we use the version firmware to figure out what device is on
89 the other end of the cable.
94 Once the device is initialised, finalise_init(true) is called, which
95 releases the lock and signals the condition, and starts handling incoming
96 messages. finalise_init(false) will also release the lock but doesn't
97 start handling messages.
99 void finalise_init( bool yn );
101 MidiByteArray host_connection_query( MidiByteArray & bytes );
102 MidiByteArray host_connection_confirmation( const MidiByteArray & bytes );
105 Will set _emulation to what it thinks is correct, based
106 on responses from the device. Or get/set parameters. Or
107 environment variables. Or existence of a file.
109 void probe_emulation( const MidiByteArray & bytes );
111 /// Handle timeout events set for controls that don't emit
113 bool handle_control_timeout_event ( Control * );
116 MackieControlProtocol & _mcp;
117 port_type_t _port_type;
118 boost::signals2::scoped_connection _any;
119 boost::signals2::scoped_connection _sysex;
120 emulation_t _emulation;
123 Glib::Cond init_cond;
124 Glib::Mutex init_mutex;