Shamusworld >> Repos - ardour-manual/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="https://github.com/Ardour/ardour/tree/master/mcp">
  16   Source Tree</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</a> sub directory <code>mcp</code> 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. The GUI shows explicitly the position
  55   of the main or master surface within the group of surfaces.
  56 </p>
  57 <p><img alt="the Mackie Control Device Dialog"
  58      src="/images/mcp-extender-position.png"></p>
  59 <p>
  60   The <code>MasterPosition</code> value is the position the master unit
  61   (with the master fader) is located at within the group of surfaces.
  62   The surfaces are numbered from 1 at the left side and up. So if there
  63   are three surfaces, <code>&lt;MasterPosition value="1"/&gt;</code> will
  64   expect the master on the left, <code>&lt;MasterPosition value="2"/&gt;</code>
  65   would be master in the middle and <code>&lt;MasterPosition value="3"/&gt;</code>
  66   would be master on the right.
  67 </p>
  68 <p class="note">
  69   The default value of <code>&lt;MasterPosition value="0"/&gt;</code> has
  70   the same effect as <code>&lt;MasterPosition value="1"/&gt;</code>.
  71 </p>
  72 <p>
  73   If the <code>MasterPosition</code> value does not properly match the
  74   physical position and MIDI port, the master fader and global controls will
  75   not work. The master unit will act like an extender.
  76 </p>