Shamusworld >> Repos - ardour-manual-diverged/blob - _manual/25_using-control-surfaces/02_mackie-control-protocol/05_working-with-extenders.html

   1 ---
   2 layout: default
   3 title: Working With Extenders
   4 menu_title: Working With Extenders
   5 ---
   6
   7 <p>
   8   There are currently 5 devices preconfigured to work with extenders.
   9   Two of them are for one master and one extender with the master on the
  10   right side or master on the left side. There are three presets for a
  11   master and two extenders with the master on the left, in the center
  12   and on the right. While these files will work for many uses there may
  13   be cases where a custom device profile makes more sense.
  14   The best way is to start with the *.device file in the <a
  15   href="/appendix/files-and-directories/">
  16   sytem config sub directory mcp</a> that matches your
  17   master device and copy it to a new name such as xt+mc.device in the
  18   <a href="/appendix/files-and-directories/">
  19   user config sub directory mcp</a> and then edit that file. It is best to
  20   name the file with the order the devices are expected to be used in as
  21   the position of the master device is specified in this file.
  22 </p>
  23 <p>
  24   The three lines of interest are:
  25 <p>
  26 <pre>
  27  &lt;Name value="Device name"/&gt;
  28  &lt;Extenders value="0"/&gt;
  29  &lt;MasterPosition value="0"/&gt;
  30 </pre>
  31 <p>
  32   Add any lines that are not present.
  33 </p>
  34 <p>
  35   The <code>Name</code> value should be a unique name so it is obvious
  36   in the list of devices (so change it).
  37 </p>
  38 <p>
  39   The <code>Extenders</code>
  40   value is the number of extenders used and should not include the master in
  41   that number.
  42 </p>
  43 <p>
  44   When an <code>Extenders</code> value of greater than 0 is used, extra midi
  45   ports will appear for the extenders to be connected to. The MIDI ports
  46   for the controllers will be named <code>mackie control in/out</code> for
  47   the master, <code>mackie control in/out ext #*</code> where * is the
  48   position of the extender from left to right. So for a master in the middle
  49   with an extender on either side, the ports from left to right will be
  50   mackie control in/out ext #1, mackie control in/out and mackie control in/out ext #3.
  51 </p>
  52 <p>
  53   If using the MCP GUI to connect surfaces the top surface is the leftmost
  54   and the bottom is the rightmost. At the time of writing the top is always
  55   labeled as the main (master) surface even if the leftmost surface is an
  56   extender.
  57 </p>
  58 <p>
  59   The <code>MasterPosition</code> value is the port number the master unit
  60   (with the master fader) is connected to. So if there are three surfaces,
  61   <code>&lt;MasterPosition value="1"/&gt;</code> will expect the master on
  62   the left, <code>&lt;MasterPosition value="2"/&gt;</code> would be master
  63   in the middle and <code>&lt;MasterPosition value="3"/&gt;</code> would be
  64   master on the right.
  65 </p>
  66 <p class="note">
  67   The default value of <code>&lt;MasterPosition value="0"/&gt;</code> has
  68   the same effect as <code>&lt;MasterPosition value="1"/&gt;</code>.
  69 </p>
  70 <p>
  71   If the <code>MasterPosition</code> value does not properly match the
  72   physcal position and MIDI port, the master fader and global controls will
  73   not work. The master unit will act like an extender.
  74 </p>