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