Sync with master branch.

[ardour-manual-diverged] / include / working-with-extenders.html

diff --git a/include/working-with-extenders.html b/include/working-with-extenders.html
new file mode 100644 (file)
index 0000000..661d67d
--- /dev/null
+++ b/include/working-with-extenders.html
@@ -0,0 +1,49 @@
+---
+layout: default
+title: Working With Extenders
+menu_title: Working With Extenders
+---
+
+<p>
+  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
+  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.
+</p>
+<p>
+  The two lines of interest are:
+<p>
+<pre>
+ &lt;Extenders value="0"/&gt;
+ &lt;MasterPosition value="0"/&gt;
+</pre>
+<p>
+  Add these two lines if they are not present. The <code>Extenders</code>
+  value is the number of extenders used and should not include the master in
+  that number.
+</p>
+<p>
+  When an <code>Extenders</code> value of greater than 0 is used, extra midi
+  ports will appear for the extenders to be connected to. The MIDI ports
+  for the controllers will be named <code>mackie control #1</code>,
+  <code>mackie control #2</code> and up. The numbers will go from left to
+  right. That is, from lowest number channel to highest.
+</p>
+<p>
+  The <code>MasterPosition</code> value is the port number the master unit
+  (with the master fader) is connected to. So if there are three surfaces,
+  <code>&lt;MasterPosition value="1"/&gt;</code> will expect the master on
+  the left, <code>&lt;MasterPosition value="2"/&gt;</code> would be master
+  in the middle and <code>&lt;MasterPosition value="3"/&gt;</code> would be
+  master on the right. So the position matches the port name.
+</p>
+<p class="note">
+  The default value of <code>&lt;MasterPosition value="0"/&gt;</code> has
+  the same effect as <code>&lt;MasterPosition value="1"/&gt;</code>.
+</p>
+<p>
+  If the <code>MasterPosition</code> value does not properly match the
+  physcal position and MIDI port, the master fader and global controls will
+  not work. The master unit will act like an extender.
+</p>