ardour/manual/xml/mackie.xml

<?xml version="1.0" standalone="no"?>

<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [

]>

<section id="sn-mackie">
  <title>Using the Mackie driver for MCU and BCF2000</title>
  <para>
    For Ardour 2, this will walk you through the process of configuring and using Mackie
    MCU, or a BCF2000 in
    <ulink url="http://www.behringerdownload.de/BCF2000/BCF2000_Emulation_modes.pdf">Logic
    Control emulation mode</ulink>.
  </para>

  <section id="mackie-connecting-device">
    <title>Connecting Device</title>
    <para>
      Make sure your surface is connected and you know which
      <filename>/dev/snd/midi</filename> entry belongs to the device. You
      can do this by saying <command>cat /proc/asound/cards</command> which
      should result in something like
<screen>
 0 [EWS88MT        ]: ICE1712 - TerraTec EWS88MT
                      TerraTec EWS88MT at 0x1140, irq 21
 1 [VirMIDI        ]: VirMIDI - VirMIDI
                      Virtual MIDI Card 1
 2 [BCF2000        ]: USB-Audio - BCF2000
                      BEHRINGER BCF2000 at usb-0000:00:1a.1-1, full speed
</screen>
      in this case the BCF2000 is on <filename>/dev/snd/midiC2D0</filename>.
    </para>

    <para>
      While ardour is not running, edit your
      <filename>.ardour2/ardour.rc</filename> and add at the top, with the
      other ports:
<programlisting>
&lt;MIDI-port tag="mcu" device="/dev/snd/midiC2D0" type="alsa/raw" mode="duplex"/&gt;
</programlisting>
    </para>

    <para>
      It is also possible to add MCU extenders or other BCF2000 units,
      although this is untested because nobody we know has access to one
      right now. To do this, add the following lines to
      <filename>~/.ardour2/ardour.rc</filename>
<programlisting>
&lt;MIDI-port tag="mcu_xt_1" device="/dev/snd/midiC3D0" type="alsa/raw" mode="duplex"/&gt;
&lt;MIDI-port tag="mcu_xt_2" device="/dev/snd/midiC4D0" type="alsa/raw" mode="duplex"/&gt;
</programlisting>
      and so on, one for each of your extenders, up to a maximum of 9
      extenders.
    </para>
  </section>

  <section id="mackie-mackie-mode">
    <title>Mackie Mode</title>
    <para>
      If you have a Mackie MCU make sure that you have the following under
      the &lt;Config&gt; tag:
<programlisting>
&lt;Option name="mackie-emulation" value="mcu"/&gt;
</programlisting>
    </para>

    <para>
      In this mode, the original mappings are used. Note that many of the
      buttons have not yet been implemented.
    </para>
  </section>

  <section id="mackie-bcf-mode">
    <title>BCF mode</title>
    <para>
      If you have a BCF2000 you must add under the &lt;Config&gt; tag:
<programlisting>
&lt;Option name="mackie-emulation" value="bcf"/&gt;
</programlisting>
    </para>

    <para>
      The following are different in BCF mode:
      <itemizedlist>
        <listitem>
          <para>
            7 of the 8 sliders are used as route sliders, the remaining
            right-hand one is used for the master slider
          </para>
        </listitem>

        <listitem>
          <para>
            certain buttons have been remapped from the default Behringer
            settings, which required either both hands, or one-handed
            contortions to do simple things like rec-enable or mute a track.
          </para>
        </listitem>

        <listitem>
          <para>
            The display shows the number of the first switched-in bank or Ar
            if the first bank is in place.
          </para>
        </listitem>
      </itemizedlist>
    </para>

    <para>
      BCF mode bindings
      <table id="tbl-mackie-bcf-key-bindings">
        <title>BCF mode bindings</title>
        <tgroup cols = "4">
          <colspec colnum="1" colname="Strip" colwidth="1"/>
          <colspec colnum="2" colname="Master Strip" colwidth= "1"/>
          <colspec colnum="3" colname="Buttons 1" colwidth="1"/>
          <colspec colnum="4" colname="Buttons 2" colwidth= "1"/>
          <thead>
            <row>
              <entry>
                Strips 1-7
              </entry>

              <entry>
                Master Strip
              </entry>

              <entry namest="Buttons 1" nameend="Buttons 2">
                Buttons
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>
                pan / solo if pressed
              </entry>

              <entry>
                transport <footnote>
                <para>
                  Making a pot pretend to be a shuttle wheel doesn't work
                  very well.
                </para>
                </footnote> / global solo
              </entry>

              <entry namest="Buttons 1" nameend="Buttons 2">
                LCD display
              </entry>
            </row>

            <row>
              <entry>
                mute
              </entry>

              <entry>
                mute
              </entry>

              <entry>
                shift 1
              </entry>

              <entry>
                <para>
                  loop
                </para>

                <para>
                  shift 1: marker
                </para>

                <para>
                  shift 2: punch in
                </para>
              </entry>
            </row>

            <row>
              <entry>
                rec
              </entry>

              <entry>
                session rec
              </entry>

              <entry>
                shift 2
              </entry>

              <entry>
                <para>
                  click
                </para>

                <para>
                  shift 2: punch out
                </para>
              </entry>
            </row>

            <row>
              <entry morerows="4" valign="middle">
                slider
              </entry>

              <entry morerows="4" valign="middle">
                slider
              </entry>

              <entry>
                rewind
              </entry>

              <entry>
                ffwd
              </entry>
            </row>

            <row>
              <entry>
                home
              </entry>

              <entry>
                end
              </entry>
            </row>

            <row>
              <entry>
                <para>
                  previous bank
                </para>

                <para>
                  shift 1: previous route
                </para>
              </entry>

              <entry>
                <para>
                  next bank
                </para>

                <para>
                  shift 1: next route
                </para>
              </entry>
            </row>

            <row>
              <entry>
                previous marker
              </entry>

              <entry>
                next marker
              </entry>
            </row>

            <row>
              <entry>
                stop
              </entry>

              <entry>
                play
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </para>
  </section>

  <section id="mackie-connecting-to-ardour">
    <title>Connecting to Ardour</title>
		<note>
			<para>
				Currently (as of 18-jul-2007 and ardour-2.0.3) support for alsa/sequencer ports
				is borked. You're better off using alsa/raw as documented above.
			</para>
		</note>
    <para>
      Start up ardour. Go to Options/Control Surfaces. You should see
      "Mackie" as one of the menu items. Turn it on. The faders on the
      surface should jump to the correct positions. The mackie should work
      as normal, except that any buttons not on the BCF won't work.
    </para>
  </section>

<!--
	<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
		href="Some_Subsection.xml" />
	-->
</section>