]> Shamusworld >> Repos - ardour-manual/blob - include/devices-using-mackielogic-control-protocol.html
whitespace change to test commit hook
[ardour-manual] / include / devices-using-mackielogic-control-protocol.html
1
2 <p>
3   This will walk you through the process of configuring and using
4   a MIDI control surface with Ardour that uses the <dfn>Mackie Control
5   protocol</dfn> (MCP) or <dfn>Logic Control protocol</dfn>. Devices that
6   have been tested and are known to work include the SSL Nucleus, Mackie
7   Control Pro (plus extenders), Behringer devices in Mackie/Logic mode,
8   and Steinberg CMC devices.
9 </p>
10
11 <h2>Enabling Mackie Control in Ardour</h2>
12 <p>
13   Navigate to <kbd class="menu">Edit &gt; Preferences &gt; Control Surfaces</kbd>.
14   Tick the <kbd class="option">Mackie</kbd> option and click on the
15   <kbd class="menu">Show Protocol Settings</kbd> button to see the setup dialog:
16 </p>
17
18 <figure>
19   <img src="/images/mackie-control-protocol-settings.png" alt="The Mackie Control Setup Dialog">
20   <figcaption>
21     The Mackie Control Setup Dialog
22   </figcaption>
23 </figure>
24
25 <p>
26   From the selector at the top, choose the type of device you are using.
27   (<a href="@@what-to-do-if-your-device-is-not-listed">
28   What to do if your device is not listed</a>).
29 </p>
30
31 <p class="fixme">Update the controls description</p>
32
33 <p>
34   Once your setup is complete, click "OK" to close the dialog. Now click
35   on the enable checkbox for "Mackie Control".
36 </p>
37 <h2>Devices using ipMIDI</h2>
38 <p>
39   If you are using a device that uses ipMIDI, such as the SSL Nucleus, no
40   MIDI port connections are required&mdash;Ardour and your control
41   surface will be able to talk to each other automatically so long as
42   your control surface and computer are both connected to the same network.
43 </p>
44 <h2>Connecting control surface and Ardour MIDI ports</h2>
45 <p>
46   Before attempting to use a Mackie Control device that communicates via
47   a standard MIDI cable or a USB cable, you should ensure that
48   <a href="@@midi-on-linux">your Linux
49   MIDI environment is setup</a>.
50   If you are using a device that uses normal MIDI (via a standard MIDI or
51   USB cable), you need to connect Ardour's Mackie Control in and out ports
52   to the MIDI ports leading to and coming from the control surface.
53 </p>
54 <p>
55   When you have made these connections once, Ardour will recreate them
56   for you in the future, as long as you leave Mackie Control enabled.
57 </p>
58
59 <h2>Customizing your control surface</h2>
60 <p>
61   Every possible global Mackie Control button can be bound to any <a
62   href="@@list-of-menu-actions">
63   action</a> present in Ardour's GUI. Please check your control surface
64   page for suggestions.
65 </p>
66
67 <h2>Preparing your device for use with Ardour</h2>
68 <p>
69   Most interfaces will require some configuration to send and respond to
70   MCP.
71 </p>
72
73 <p class="note">
74   When setting up the control surface, do <em>not</em> use "Pro Tools"
75   mode. Pro Tools is the only DAW that still requires HUI. The rest of
76   world uses Mackie Control Protocol. Ardour does not support HUI at
77   this time.
78 </p>
79