Update correct and expand generic midi bindings

This commit is contained in:
Len Ovens 2019-01-24 09:23:01 -08:00
parent f10bac13a1
commit a14fc093fd

View File

@ -73,11 +73,8 @@ bindings">
So, to start, create a file with that as the initial contents. So, to start, create a file with that as the initial contents.
</p> </p>
<p> <p>
On OS X, Ardour loads midi maps from its binary-bundle folder in The file should be located in the midi_maps sub directory located in
<code>Ardour-&lt;version&gt;/midi_maps/</code> and checks the <a href="@@files-and-directories-ardour-knows-about">Ardour configuration directory</a>
various other locations as well (defined by the ARDOUR_MIDIMAPS_PATH
environment variable). On GNU/Linux the easiest is to save the file to
<code>~/.config/ardour3/midi_maps/</code>.
</p> </p>
<h3>Finding out what your MIDI control surface sends</h3> <h3>Finding out what your MIDI control surface sends</h3>
@ -116,7 +113,7 @@ bindings"&gt;
like this: like this:
</p> </p>
<code> <code>
&lt;Binding channel="1" ctl="13" &hellip;. &lt;Binding channel="1" ctl="13" &hellip;
</code> </code>
<p> <p>
This defines a binding for a MIDI Continuous Controller message involving This defines a binding for a MIDI Continuous Controller message involving
@ -135,6 +132,21 @@ bindings"&gt;
Learn more about working with encoders Learn more about working with encoders
</a>) </a>)
</p> </p>
<p>
<ul>
<li><code>&lt;Binding channel="1" enc-r="13" &hellip;</code></li>
<li><code>&lt;Binding channel="1" enc-l="13" &hellip;</code></li>
<li><code>&lt;Binding channel="1" enc-2="13" &hellip;</code></li>
<li><code>&lt;Binding channel="1" enc-b="13" &hellip;</code></li>
</ul>
The <code>enc-*</code> value is the CC number used by the encoder.
Encoders only work with CC messages.
</p>
<p class="note">
Ardour 5.12 has a bug with the encoder detection where the first
encoder message resets the control to 0. Setting "Enable Feedback"
on allows encoders to work as expected.
</p>
<p> <p>
You can also bind sysex messages: You can also bind sysex messages:
</p> </p>
@ -177,6 +189,9 @@ bindings"&gt;
A <dfn>control address</dfn> defines what the binding will actually control. A <dfn>control address</dfn> defines what the binding will actually control.
There are quite a few different things that can be specified here: There are quite a few different things that can be specified here:
</p> </p>
<p class="note">
Enable Feeback applies to these "Control Addresses" only.
</p>
<table class="dl"> <table class="dl">
<tr><th>/route/gain</th> <tr><th>/route/gain</th>
<td>the gain control ("fader") for the track/bus</td></tr> <td>the gain control ("fader") for the track/bus</td></tr>
@ -233,6 +248,9 @@ bindings"&gt;
</p> </p>
<h4>Bindings to Ardour "functions"</h4> <h4>Bindings to Ardour "functions"</h4>
<p class="note">
There is currently no feedback available for functions.
</p>
<p> <p>
Rather than binding to a specific track/bus control, it may be useful to Rather than binding to a specific track/bus control, it may be useful to
have a MIDI controller able to alter some part of Ardour's state. A have a MIDI controller able to alter some part of Ardour's state. A
@ -299,6 +317,10 @@ bindings"&gt;
</table> </table>
<h4>Binding to Ardour "actions"</h4> <h4>Binding to Ardour "actions"</h4>
<p class="note">
It is not possible to have feedback available actions because these
represent keyboard shortcuts which are send only.
</p>
<p> <p>
You can also bind a sysex or arbitrary message to any of the items You can also bind a sysex or arbitrary message to any of the items
that occur in Ardour's main menu (and its submenus). The <a that occur in Ardour's main menu (and its submenus). The <a
@ -370,6 +392,9 @@ bindings"&gt;
&lt;Binding channel="1" note="15" uri="/route/mute B1" momentary="yes"/&gt; &lt;Binding channel="1" note="15" uri="/route/mute B1" momentary="yes"/&gt;
&lt;Binding channel="1" note="16" uri="/route/mute B2" momentary="yes"/&gt; &lt;Binding channel="1" note="16" uri="/route/mute B2" momentary="yes"/&gt;
&lt;Binding channel="1" enc-r="11" uri="/route/pandirection B1"/&gt;
&lt;Binding channel="1" enc-r="12" uri="/route/pandirection B2"/&gt;
&lt;Binding sysex="f0 0 0 e 9 0 5b f7" function="transport-start"/&gt; &lt;Binding sysex="f0 0 0 e 9 0 5b f7" function="transport-start"/&gt;
&lt;Binding sysex="f0 7f 0 6 7 f7" function="rec-disable"/&gt; &lt;Binding sysex="f0 7f 0 6 7 f7" function="rec-disable"/&gt;
&lt;Binding sysex="f0 7f 0 6 6 f7" function="rec-enable"/&gt; &lt;Binding sysex="f0 7f 0 6 6 f7" function="rec-enable"/&gt;