Move section on soloing tracks to separate file
[ardour.git] / 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>.ardour2/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>~/.ardour2/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>