From 7cbfd88cb4bbabef6e78c681b96260ff6a87376a Mon Sep 17 00:00:00 2001 From: Shamus Hammons Date: Fri, 27 Jan 2017 17:32:57 -0600 Subject: [PATCH] Sync to master. Now sychronized to commit 781a6ac55bf5d074742319d6638668331b0b0203. --- .../03_mackie-control-setup-on-linux.html | 20 ------- .../02_mackie-control-protocol.html | 14 +++++ .../01_mackie-control-configure.html} | 52 +++++++++++-------- .../02_ssl-nucleus.html | 0 ...-devices-in-mackielogic-control-mode.html} | 0 .../04_devices-not-listed.html | 0 .../05_working-with-extenders.html | 22 ++++++-- master-doc.txt | 28 ++++------ 8 files changed, 72 insertions(+), 64 deletions(-) delete mode 100644 _manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/03_mackie-control-setup-on-linux.html create mode 100644 _manual/23_using-control-surfaces/02_mackie-control-protocol.html rename _manual/23_using-control-surfaces/{02_devices-using-mackielogic-control-protocol.html => 02_mackie-control-protocol/01_mackie-control-configure.html} (71%) rename _manual/23_using-control-surfaces/{02_devices-using-mackielogic-control-protocol => 02_mackie-control-protocol}/02_ssl-nucleus.html (100%) rename _manual/23_using-control-surfaces/{02_devices-using-mackielogic-control-protocol/01_behringer-devices-in-mackielogic-control-mode.html => 02_mackie-control-protocol/03_behringer-devices-in-mackielogic-control-mode.html} (100%) rename _manual/23_using-control-surfaces/{02_devices-using-mackielogic-control-protocol => 02_mackie-control-protocol}/04_devices-not-listed.html (100%) rename _manual/23_using-control-surfaces/{02_devices-using-mackielogic-control-protocol => 02_mackie-control-protocol}/05_working-with-extenders.html (68%) diff --git a/_manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/03_mackie-control-setup-on-linux.html b/_manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/03_mackie-control-setup-on-linux.html deleted file mode 100644 index e155e5a..0000000 --- a/_manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/03_mackie-control-setup-on-linux.html +++ /dev/null @@ -1,20 +0,0 @@ ---- -layout: default -title: Mackie Control Setup on Linux ---- - -

Devices using ipMIDI

-

- If you are using a device like the SSL Nucleus that uses ipMIDI, - no set up is required other than to ensure that your control surface - and computer are both connected to the same network. -

- -

Devices using conventional MIDI

-

- Before attempting to use a Mackie Control device that communicates via - a standard MIDI cable or a USB cable, you should ensure that - your Linux - MIDI environment is setup. -

- diff --git a/_manual/23_using-control-surfaces/02_mackie-control-protocol.html b/_manual/23_using-control-surfaces/02_mackie-control-protocol.html new file mode 100644 index 0000000..60033fe --- /dev/null +++ b/_manual/23_using-control-surfaces/02_mackie-control-protocol.html @@ -0,0 +1,14 @@ +--- +layout: default +title: Controlling Ardour with Mackie Control Devices +--- + +

+ Since Mackie and Logic made the first Logic Control Surface, Mackie + and other surface manufactures have been making control surfaces that + use the same protocol to communicate with a DAW. Ardour supports the + MCP and will + work with all these control surfaces. +

+ +{% children %} diff --git a/_manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol.html b/_manual/23_using-control-surfaces/02_mackie-control-protocol/01_mackie-control-configure.html similarity index 71% rename from _manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol.html rename to _manual/23_using-control-surfaces/02_mackie-control-protocol/01_mackie-control-configure.html index 55fe0b6..4733d6d 100644 --- a/_manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol.html +++ b/_manual/23_using-control-surfaces/02_mackie-control-protocol/01_mackie-control-configure.html @@ -1,15 +1,15 @@ --- layout: default title: Devices using Mackie/Logic Control Protocol -menu_title: Mackie/Logic Control Devices ---- +menu_title: Mackie Control Configuring +---

- This will walk you through the process of configuring and using + This will walk you through the process of configuring and using a MIDI control surface with Ardour that uses the Mackie Control - protocol (MCP) or Logic Control protocol. Devices that - have been tested and are known to work include the SSL Nucleus, Mackie - Control Pro (plus extenders), Behringer devices in Mackie/Logic mode, + protocol (MCP) or Logic Control protocol. Devices that + have been tested and are known to work include the SSL Nucleus, Mackie + Control Pro (plus extenders), Behringer devices in Mackie/Logic mode, and Steinberg CMC devices.

@@ -20,48 +20,54 @@ menu_title: Mackie/Logic Control Devices

Mackie Control Setup Dialog

- From the selector at the top, choose the type of device you are using. + From the selector at the top, choose the type of device you are using. ( What to do if your device is not listed).

- Once your setup is complete, click "OK" to close the dialog. Now click + Once your setup is complete, click "OK" to close the dialog. Now click on the enable checkbox for "Mackie Control".

- -

Connecting control surface and Ardour MIDI ports

+

Devices using ipMIDI

- If you are using a device that uses ipMIDI, such as the SSL Nucleus, no - MIDI port connections are required — Ardour and your control - surface will be able to talk to each other automatically. + If you are using a device that uses ipMIDI, such as the SSL Nucleus, no + MIDI port connections are required — Ardour and your control + surface will be able to talk to each other automatically so long as + your control surface and computer are both connected to the same network.

+

Connecting control surface and Ardour MIDI ports

- If you are using a device that uses normal MIDI (via a standard MIDI or - USB cable), you need to connect Ardour's Mackie Control in and out ports + Before attempting to use a Mackie Control device that communicates via + a standard MIDI cable or a USB cable, you should ensure that + your Linux + MIDI environment is setup. + If you are using a device that uses normal MIDI (via a standard MIDI or + USB cable), you need to connect Ardour's Mackie Control in and out ports to the MIDI ports leading to and coming from the control surface.

- When you have made these connections once, Ardour will recreate them + When you have made these connections once, Ardour will recreate them for you in the future, as long as you leave Mackie Control enabled.

Customizing your control surface

- Every possible Mackie Control button can be bound to any action present - in Ardour's GUI. Please check your control surface page for suggestions. + Every possible global Mackie Control button can be bound to any + action present in Ardour's GUI. Please check your control surface + page for suggestions.

Preparing your device for use with Ardour

- Most interfaces will require some configuration to send and respond to + Most interfaces will require some configuration to send and respond to MCP. -

+

When setting up the control surface, do not use "Pro Tools" mode. Pro Tools is the only DAW that still requires HUI. The rest of - world uses Mackie Control Protocol. Ardour does not support HUI. + world uses Mackie Control Protocol. Ardour does not support HUI at + this time.

- -{% children %} diff --git a/_manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/02_ssl-nucleus.html b/_manual/23_using-control-surfaces/02_mackie-control-protocol/02_ssl-nucleus.html similarity index 100% rename from _manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/02_ssl-nucleus.html rename to _manual/23_using-control-surfaces/02_mackie-control-protocol/02_ssl-nucleus.html diff --git a/_manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/01_behringer-devices-in-mackielogic-control-mode.html b/_manual/23_using-control-surfaces/02_mackie-control-protocol/03_behringer-devices-in-mackielogic-control-mode.html similarity index 100% rename from _manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/01_behringer-devices-in-mackielogic-control-mode.html rename to _manual/23_using-control-surfaces/02_mackie-control-protocol/03_behringer-devices-in-mackielogic-control-mode.html diff --git a/_manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/04_devices-not-listed.html b/_manual/23_using-control-surfaces/02_mackie-control-protocol/04_devices-not-listed.html similarity index 100% rename from _manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/04_devices-not-listed.html rename to _manual/23_using-control-surfaces/02_mackie-control-protocol/04_devices-not-listed.html diff --git a/_manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/05_working-with-extenders.html b/_manual/23_using-control-surfaces/02_mackie-control-protocol/05_working-with-extenders.html similarity index 68% rename from _manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/05_working-with-extenders.html rename to _manual/23_using-control-surfaces/02_mackie-control-protocol/05_working-with-extenders.html index 661d67d..9f0fe73 100644 --- a/_manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/05_working-with-extenders.html +++ b/_manual/23_using-control-surfaces/02_mackie-control-protocol/05_working-with-extenders.html @@ -5,21 +5,35 @@ menu_title: Working With Extenders ---

- Extenders will require a custom file as there are no combinations listed - at this time. The best way is to start with the mc.device file and copy it + There are currently 5 devices preconfigured to work with extenders. + Two of them are for one master and one extender with the master on the + right side or master on the left side. There are three presets for a + master and two extenders with the master on the left, in the center + and on the right. While these files will work for many uses there may + be cases where a custom device profile makes more sense. + The best way is to start with the *.device file that matches your + master device and copy it to a new name such as xt+mc.device and then edit that file. It is best to name the file with the order the devices are expected to be used in as the position of the master device is specified in this file.

- The two lines of interest are: + The three lines of interest are: 

+ <Name value="Device name"/>
  <Extenders value="0"/>
  <MasterPosition value="0"/>

- Add these two lines if they are not present. The Extenders + Add any lines that are not present. +

+

+ The Name value should be a unique name so it is obvious + in the list of devices. +

+

+ The Extenders value is the number of extenders used and should not include the master in that number.

diff --git a/master-doc.txt b/master-doc.txt index f2997ab..7d2c720 100644 --- a/master-doc.txt +++ b/master-doc.txt @@ -24,12 +24,6 @@ include: _manual/01_welcome-to-ardour.html part: subchapter --- ---- -title: About Ardour -include: _manual/01_welcome-to-ardour/01_about-ardour.html -part: subchapter ---- - --- title: Isn't This A Really Complicated Program? include: _manual/01_welcome-to-ardour/01_about-ardour/01_isnt-this-a-really-complicated-program.html @@ -1779,38 +1773,38 @@ part: subchapter --- --- -title: Devices using Mackie/Logic Control Protocol -include: _manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol.html +title: Controlling Ardour with Mackie Control Devices +include: _manual/23_using-control-surfaces/02_mackie-control-protocol.html exclude: yes part: chapter --- --- -title: Behringer devices in Mackie/Logic Control Mode -menu_title: Behringer devices -include: _manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/01_behringer-devices-in-mackielogic-control-mode.html +title: Devices Using Mackie/Logic Control Protocol +include: _manual/23_using-control-surfaces/02_mackie-control-protocol/01_mackie-control-configure.html exclude: yes part: subchapter --- --- title: SSL Nucleus -include: _manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/02_ssl-nucleus.html +include: _manual/23_using-control-surfaces/02_mackie-control-protocol/02_ssl-nucleus.html exclude: yes part: subchapter --- --- -title: Mackie Control Setup on Linux -include: _manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/03_mackie-control-setup-on-linux.html +title: Behringer Devices in Mackie/Logic Control Mode +menu_title: Behringer Devices +include: _manual/23_using-control-surfaces/02_mackie-control-protocol/03_behringer-devices-in-mackielogic-control-mode.html exclude: yes part: subchapter --- --- title: What to do if your Device is not Listed -menu_title: Unlisted devices -include: _manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/04_devices-not-listed.html +menu_title: Unlisted Devices +include: _manual/23_using-control-surfaces/02_mackie-control-protocol/04_devices-not-listed.html exclude: yes part: subchapter --- @@ -1818,7 +1812,7 @@ part: subchapter --- title: Working With Extenders menu_title: Working With Extenders -include: _manual/23_using-control-surfaces/02_devices-using-mackielogic-control-protocol/05_working-with-extenders.html +include: _manual/23_using-control-surfaces/02_mackie-control-protocol/05_working-with-extenders.html exclude: yes part: subchapter --- -- 2.37.2