manual/xml/mackie.xml

   1 <?xml version="1.0" standalone="no"?>
   2
   3 <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
   4
   5 ]>
   6
   7 <section id="sn-mackie">
   8   <title>Using the Mackie driver for MCU and BCF2000</title>
   9   <para>
  10                 Note: Mackie support is available only for ardour 2.0 beta12 or newer.
  11         </para>
  12   <para>
  13     This will walk you through the process of configuring and using Mackie
  14     MCU, or a BCF2000 in
  15     <ulink url="http://www.behringerdownload.de/BCF2000/BCF2000_Emulation_modes.pdf">Logic
  16     Control emulation mode</ulink>.
  17   </para>
  18
  19   <section id="mackie-connecting-device">
  20     <title>Connecting Device</title>
  21     <para>
  22       Make sure your surface is connected and you know which
  23       <filename>/dev/snd/midi</filename> entry belongs to the device. You
  24       can do this by saying <command>cat /proc/asound/cards</command> which
  25       should result in something like
  26 <screen>
  27  0 [EWS88MT        ]: ICE1712 - TerraTec EWS88MT
  28                       TerraTec EWS88MT at 0x1140, irq 21
  29  1 [VirMIDI        ]: VirMIDI - VirMIDI
  30                       Virtual MIDI Card 1
  31  2 [BCF2000        ]: USB-Audio - BCF2000
  32                       BEHRINGER BCF2000 at usb-0000:00:1a.1-1, full speed
  33 </screen>
  34       in this case the BCF2000 is on <filename>/dev/snd/midiC2D0</filename>.
  35     </para>
  36
  37     <para>
  38       While ardour is not running, edit your
  39       <filename>.ardour2/ardour.rc</filename> and add at the top, with the
  40       other ports:
  41 <programlisting>
  42 &lt;MIDI-port tag="mcu" device="/dev/snd/midiC2D0" type="alsa/raw" mode="duplex"/&gt;
  43 </programlisting>
  44       If you have a BCF2000, and you'd like to use
  45       <link linkend="mackie-bcf-mode">BCF mode</link>, you can also add
  46       under the &lt;Config&gt; tag:
  47 <programlisting>
  48 &lt;Option name="mackie-emulation" value="bcf"/&gt;
  49 </programlisting>
  50     </para>
  51
  52     <para>
  53       It is also possible to add MCU extenders, although this is untested
  54       because nobody we know has access to one right now. To do this, add
  55       the following lines to <filename>~/.ardour2/ardour.rc</filename>
  56 <programlisting>
  57 &lt;MIDI-port tag="mcu_xt_1" device="/dev/snd/midiC3D0" type="alsa/raw" mode="duplex"/&gt;
  58 &lt;MIDI-port tag="mcu_xt_2" device="/dev/snd/midiC4D0" type="alsa/raw" mode="duplex"/&gt;
  59 </programlisting>
  60       and so on, one for each of your extenders, up to a maximum of 9
  61       extenders.
  62     </para>
  63   </section>
  64
  65   <section id="mackie-connecting-to-ardour">
  66     <title>Connecting to Ardour</title>
  67     <para>
  68       Start up ardour. Go to Options/Control Surfaces. You should see
  69       "Mackie" as one of the menu items. Turn it on. The faders on the
  70       surface should jump to the correct positions. The mackie should work
  71       as normal, except that any buttons not on the BCF won't work.
  72     </para>
  73   </section>
  74
  75   <section id="mackie-bcf-mode">
  76     <title>BCF mode</title>
  77     <para>
  78       <itemizedlist>
  79         <listitem>
  80           <para>
  81             7 of the 8 sliders are used as route sliders, the remaining
  82             right-hand one is used for the master slider
  83           </para>
  84         </listitem>
  85
  86         <listitem>
  87           <para>
  88             certain buttons have been remapped from the default Behringer
  89             settings, which required either both hands, or one-handed
  90             contortions to do simple things like rec-enable or mute a track.
  91           </para>
  92         </listitem>
  93
  94         <listitem>
  95           <para>
  96             The display shows the number of the first switched-in bank or Ar
  97             if the first bank is in place.
  98           </para>
  99         </listitem>
 100       </itemizedlist>
 101     </para>
 102
 103     <para>
 104       BCF mode bindings
 105       <table id="tbl-mackie-bcf-key-bindings">
 106         <title>BCF mode bindings</title>
 107         <tgroup cols = "4">
 108           <colspec colnum="1" colname="Strip" colwidth="1"/>
 109           <colspec colnum="2" colname="Master Strip" colwidth= "1"/>
 110           <colspec colnum="3" colname="Buttons 1" colwidth="1"/>
 111           <colspec colnum="4" colname="Buttons 2" colwidth= "1"/>
 112           <thead>
 113             <row>
 114               <entry>
 115                 Strips 1-7
 116               </entry>
 117
 118               <entry>
 119                 Master Strip
 120               </entry>
 121
 122               <entry namest="Buttons 1" nameend="Buttons 2">
 123                 Buttons
 124               </entry>
 125             </row>
 126           </thead>
 127           <tbody>
 128             <row>
 129               <entry>
 130                 pan / solo if pressed
 131               </entry>
 132
 133               <entry>
 134                 transport <footnote>
 135                 <para>
 136                   Making a pot pretend to be a shuttle wheel doesn't work
 137                   very well.
 138                 </para>
 139                 </footnote> / global solo
 140               </entry>
 141
 142               <entry namest="Buttons 1" nameend="Buttons 2">
 143                 LCD display
 144               </entry>
 145             </row>
 146
 147             <row>
 148               <entry>
 149                 mute
 150               </entry>
 151
 152               <entry>
 153                 mute
 154               </entry>
 155
 156               <entry>
 157                 shift 1
 158               </entry>
 159
 160               <entry>
 161                 <para>loop</para>
 162                                                                 <para>shift 1: marker</para>
 163                                                                 <para>shift 2: punch in</para>
 164               </entry>
 165             </row>
 166
 167             <row>
 168               <entry>
 169                 rec
 170               </entry>
 171
 172               <entry>
 173                 session rec
 174               </entry>
 175
 176               <entry>
 177                 shift 2
 178               </entry>
 179
 180               <entry>
 181                 <para>click</para>
 182                                                                 <para>shift 2: punch out</para>
 183               </entry>
 184             </row>
 185
 186             <row>
 187               <entry morerows="4" valign="middle">
 188                 slider
 189               </entry>
 190
 191               <entry morerows="4" valign="middle">
 192                 slider
 193               </entry>
 194
 195               <entry>
 196                 rewind
 197               </entry>
 198
 199               <entry>
 200                 ffwd
 201               </entry>
 202             </row>
 203
 204             <row>
 205               <entry>
 206                 home
 207               </entry>
 208
 209               <entry>
 210                 end
 211               </entry>
 212             </row>
 213
 214             <row>
 215               <entry>
 216                 <para>previous bank</para>
 217                                                                 <para>shift 1: previous route</para>
 218               </entry>
 219
 220               <entry>
 221                 <para>next bank</para>
 222                                                                 <para>shift 1: next route</para>
 223               </entry>
 224             </row>
 225
 226             <row>
 227               <entry>
 228                 previous marker
 229               </entry>
 230
 231               <entry>
 232                 next marker
 233               </entry>
 234             </row>
 235
 236             <row>
 237               <entry>
 238                 stop
 239               </entry>
 240
 241               <entry>
 242                 play
 243               </entry>
 244             </row>
 245           </tbody>
 246         </tgroup>
 247       </table>
 248     </para>
 249   </section>
 250 <!--
 251         <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 252                 href="Some_Subsection.xml" />
 253         -->
 254 </section>