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