From 91d18f81d220d30c3986ae625a68d114285a70c9 Mon Sep 17 00:00:00 2001
From: Len Ovens <len@ovenwerks.net>
Date: Sat, 25 Jul 2015 11:16:07 -0700
Subject: [PATCH] Added info about using encoders with generic midi surfaces.

---
 .../03_midi-binding-maps.html                 |  9 +++
 .../01_working-with-encoders.html             | 56 +++++++++++++++++++
 2 files changed, 65 insertions(+)
 create mode 100644 _manual/22_using-control-surfaces/03_midi-binding-maps/01_working-with-encoders.html

diff --git a/_manual/22_using-control-surfaces/03_midi-binding-maps.html b/_manual/22_using-control-surfaces/03_midi-binding-maps.html
index e42b3c6..cda1d59 100644
--- a/_manual/22_using-control-surfaces/03_midi-binding-maps.html
+++ b/_manual/22_using-control-surfaces/03_midi-binding-maps.html
@@ -114,6 +114,14 @@ bindings"&gt;
   use <code>note</code> (to create binding for a Note On message) or 
   <code>pgm</code>  (to create a binding for a Program Change message).
 </p>
+<p>
+  <code>enc-r</code>, <code>enc-l</code>, <code>enc-2</code> and
+  <code>enc-b</code> may be used for surfaces that have encoders that send
+  offsets rather than values. These accept Continuous Controller messages
+  but treat them as offsets. These are good for banked controls as they are
+  always at the right spot to start adjusting. See the link at the bottom of
+  the page for a longer explanation.
+</p>
 <p>
   You can also bind sysex messages:
 </p>
@@ -359,3 +367,4 @@ bindings"&gt;
   (the channel range may change at some point).
 </p>
   
+{% children %}
diff --git a/_manual/22_using-control-surfaces/03_midi-binding-maps/01_working-with-encoders.html b/_manual/22_using-control-surfaces/03_midi-binding-maps/01_working-with-encoders.html
new file mode 100644
index 0000000..91eea21
--- /dev/null
+++ b/_manual/22_using-control-surfaces/03_midi-binding-maps/01_working-with-encoders.html
@@ -0,0 +1,56 @@
+---
+layout: default
+title: Working With Encoders in Ardour
+menu_title: Working With Encoders
+---
+
+<p>
+  Encoders are showing up more frequently on controllers. However, they use
+  the same MIDI events as Continuous Controllers and they have no standard
+  way of working. Ardour has implemented 4 of the more common ways of
+  sending encoder information.
+</p>
+<p>
+  Encoders that send the same continuous values as a pot would are not
+  discussed here as they work the same.
+</p>
+<P>
+  Encoders as this page talks about them send direction and offset that the
+  DAW will add to or subtract from the current value.
+</p>
+<p>
+  The 4 kinds of encoder supported are:
+</p>
+<ul>
+<li>
+  enc-r - On the bcr/bcf2000 this is called "Relative Signed Bit". The most
+  significant bit sets positive and the lower 6 signifcant bits are the
+  offset.
+</li>
+<li>
+  enc-l - The bcr2000 calls this "Relative Signed Bit 2". The most
+  significant bit sets negative and the lower 6 signifcant bits are the
+  offset. If you are using one of these two and the values are right but
+  reversed, use the other. This one is the one the Mackie Control Protocol
+  uses.
+</li>
+<li>
+  enc-2 - The bcr2000 calls this one "Relative 2s Complement". Positive
+  offsets are sent as normal from 1 to 64 and negative offsets are sent as
+  2s complement negative numbers.
+</li>
+<li>
+  enc-b - The bcr2000 calls this one "Relative Binary Offset". Positive
+  offsets are sent as offset plus 64 and negative offsets are sent as 64
+  minus offset.
+</li>
+<p>
+  If the wrong one is chosen, either the positive or negative side will act
+  incorrectly. It is not really possible to auto detect which one the
+  controller is using. Trial and error is the only way if the specification
+  of the controller is not known.
+</p>
+<p>
+  Many controllers have more than one choice as well, check the manual for
+  the surface.
+</p>
-- 
2.37.2