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> / nothing
 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                 loop
 162               </entry>
 163             </row>
 164
 165             <row>
 166               <entry>
 167                 rec
 168               </entry>
 169
 170               <entry>
 171                 session rec
 172               </entry>
 173
 174               <entry>
 175                 shift 2
 176               </entry>
 177
 178               <entry>
 179                 click
 180               </entry>
 181             </row>
 182
 183             <row>
 184               <entry morerows="4" valign="middle">
 185                 slider
 186               </entry>
 187
 188               <entry morerows="4" valign="middle">
 189                 slider
 190               </entry>
 191
 192               <entry>
 193                 punch in
 194               </entry>
 195
 196               <entry>
 197                 punch out
 198               </entry>
 199             </row>
 200
 201             <row>
 202               <entry>
 203                 home
 204               </entry>
 205
 206               <entry>
 207                 end
 208               </entry>
 209             </row>
 210
 211             <row>
 212               <entry>
 213                 previous bank (shift 1 is previous route)
 214               </entry>
 215
 216               <entry>
 217                 next bank (shift 1 is next route)
 218               </entry>
 219             </row>
 220
 221             <row>
 222               <entry>
 223                 previous marker
 224               </entry>
 225
 226               <entry>
 227                 next marker
 228               </entry>
 229             </row>
 230
 231             <row>
 232               <entry>
 233                 stop
 234               </entry>
 235
 236               <entry>
 237                 play
 238               </entry>
 239             </row>
 240           </tbody>
 241         </tgroup>
 242       </table>
 243     </para>
 244   </section>
 245 <!--
 246         <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 247                 href="Some_Subsection.xml" />
 248         -->
 249 </section>