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