Formatting changes to mackie.xml as a result of running make format
[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   <para>
10     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       If you have a BCF2000, and you'd like to use
42       <link linkend="mackie-bcf-mode">BCF mode</link>, you can also add
43       under the &lt;Config&gt; tag:
44 <programlisting>
45 &lt;Option name="mackie-emulation" value="bcf"/&gt;
46 </programlisting>
47     </para>
48
49     <para>
50       It is also possible to add MCU extenders, although this is untested
51       because nobody we know has access to one right now. To do this, add
52       the following lines to <filename>~/.ardour2/ardour.rc</filename>
53 <programlisting>
54 &lt;MIDI-port tag="mcu_xt_1" device="/dev/snd/midiC3D0" type="alsa/raw" mode="duplex"/&gt;
55 &lt;MIDI-port tag="mcu_xt_2" device="/dev/snd/midiC4D0" type="alsa/raw" mode="duplex"/&gt;
56 </programlisting>
57       and so on, one for each of your extenders, up to a maximum of 9
58       extenders.
59     </para>
60   </section>
61
62   <section id="mackie-connecting-to-ardour">
63     <title>Connecting to Ardour</title>
64     <para>
65       Start up ardour. Go to Options/Control Surfaces. You should see
66       "Mackie" as one of the menu items. Turn it on. The faders on the
67       surface should jump to the correct positions. The mackie should work
68       as normal, except that any buttons not on the BCF won't work.
69     </para>
70   </section>
71
72   <section id="mackie-bcf-mode">
73     <title>BCF mode</title>
74     <para>
75       <itemizedlist>
76         <listitem>
77           <para>
78             7 of the 8 sliders are used as route sliders, the remaining
79             right-hand one is used for the master slider
80           </para>
81         </listitem>
82
83         <listitem>
84           <para>
85             certain buttons have been remapped from the default Behringer
86             settings, which required either both hands, or one-handed
87             contortions to do simple things like rec-enable or mute a track.
88           </para>
89         </listitem>
90
91         <listitem>
92           <para>
93             The display shows the number of the first switched-in bank or Ar
94             if the first bank is in place.
95           </para>
96         </listitem>
97       </itemizedlist>
98     </para>
99
100     <para>
101       BCF mode bindings
102       <table id="tbl-mackie-bcf-key-bindings">
103         <title>BCF mode bindings</title>
104         <tgroup cols = "4">
105           <colspec colnum="1" colname="Strip" colwidth="1"/>
106           <colspec colnum="2" colname="Master Strip" colwidth= "1"/>
107           <colspec colnum="3" colname="Buttons 1" colwidth="1"/>
108           <colspec colnum="4" colname="Buttons 2" colwidth= "1"/>
109           <thead>
110             <row>
111               <entry>
112                 Strips 1-7
113               </entry>
114
115               <entry>
116                 Master Strip
117               </entry>
118
119               <entry namest="Buttons 1" nameend="Buttons 2">
120                 Buttons
121               </entry>
122             </row>
123           </thead>
124           <tbody>
125             <row>
126               <entry>
127                 pan / solo if pressed
128               </entry>
129
130               <entry>
131                 transport <footnote>
132                 <para>
133                   Making a pot pretend to be a shuttle wheel doesn't work
134                   very well.
135                 </para>
136                 </footnote> / nothing
137               </entry>
138
139               <entry namest="Buttons 1" nameend="Buttons 2">
140                 LCD display
141               </entry>
142             </row>
143
144             <row>
145               <entry>
146                 mute
147               </entry>
148
149               <entry>
150                 mute
151               </entry>
152
153               <entry>
154                 shift 1
155               </entry>
156
157               <entry>
158                 loop
159               </entry>
160             </row>
161
162             <row>
163               <entry>
164                 rec
165               </entry>
166
167               <entry>
168                 session rec
169               </entry>
170
171               <entry>
172                 shift 2
173               </entry>
174
175               <entry>
176                 click
177               </entry>
178             </row>
179
180             <row>
181               <entry morerows="4" valign="middle">
182                 slider
183               </entry>
184
185               <entry morerows="4" valign="middle">
186                 slider
187               </entry>
188
189               <entry>
190                 punch in
191               </entry>
192
193               <entry>
194                 punch out
195               </entry>
196             </row>
197
198             <row>
199               <entry>
200                 home
201               </entry>
202
203               <entry>
204                 end
205               </entry>
206             </row>
207
208             <row>
209               <entry>
210                 previous bank (shift 1 is previous route)
211               </entry>
212
213               <entry>
214                 next bank (shift 1 is next route)
215               </entry>
216             </row>
217
218             <row>
219               <entry>
220                 previous marker
221               </entry>
222
223               <entry>
224                 next marker
225               </entry>
226             </row>
227
228             <row>
229               <entry>
230                 stop
231               </entry>
232
233               <entry>
234                 play
235               </entry>
236             </row>
237           </tbody>
238         </tgroup>
239       </table>
240     </para>
241   </section>
242 <!--
243         <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
244                 href="Some_Subsection.xml" />
245         -->
246 </section>