Shamusworld >> Repos - ardour-manual-diverged/blob - _manual/23_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 that matches your
  15   master device and copy it
  16   to a new name such as xt+mc.device and then edit that file. It is best to
  17   name the file with the order the devices are expected to be used in as
  18   the position of the master device is specified in this file.
  19 </p>
  20 <p>
  21   The three lines of interest are:
  22 <p>
  23 <pre>
  24  &lt;Name value="Device name"/&gt;
  25  &lt;Extenders value="0"/&gt;
  26  &lt;MasterPosition value="0"/&gt;
  27 </pre>
  28 <p>
  29   Add any lines that are not present.
  30 </p>
  31 <p>
  32   The <code>Name</code> value should be a unique name so it is obvious
  33   in the list of devices.
  34 </p>
  35 <p>
  36   The <code>Extenders</code>
  37   value is the number of extenders used and should not include the master in
  38   that number.
  39 </p>
  40 <p>
  41   When an <code>Extenders</code> value of greater than 0 is used, extra midi
  42   ports will appear for the extenders to be connected to. The MIDI ports
  43   for the controllers will be named <code>mackie control #1</code>,
  44   <code>mackie control #2</code> and up. The numbers will go from left to
  45   right. That is, from lowest number channel to highest.
  46 </p>
  47 <p>
  48   The <code>MasterPosition</code> value is the port number the master unit
  49   (with the master fader) is connected to. So if there are three surfaces,
  50   <code>&lt;MasterPosition value="1"/&gt;</code> will expect the master on
  51   the left, <code>&lt;MasterPosition value="2"/&gt;</code> would be master
  52   in the middle and <code>&lt;MasterPosition value="3"/&gt;</code> would be
  53   master on the right. So the position matches the port name.
  54 </p>
  55 <p class="note">
  56   The default value of <code>&lt;MasterPosition value="0"/&gt;</code> has
  57   the same effect as <code>&lt;MasterPosition value="1"/&gt;</code>.
  58 </p>
  59 <p>
  60   If the <code>MasterPosition</code> value does not properly match the
  61   physcal position and MIDI port, the master fader and global controls will
  62   not work. The master unit will act like an extender.
  63 </p>