add new section on Push 2 use. Very incomplete for now

_manual/22_using-control-surfaces/06_Abelton_Push2.html

@@ -0,0 +1,84 @@
+---
+layout: default
+title: Using the Ableton Push 2
+menu_title: Ableton Push 2
+---                        
+
+<p>
+  Since version 5.0, Ardour has had full support for the Ableton
+  Push2. This is an expensive but well engineered control surface
+  primarily targetting the workflow found in Ableton's Live software
+  and other similar tools such as Bitwig. As of 5.0, Ardour does not
+  offer the same kind of workflow, so we have repurposed the Push 2 to
+  be used for mixing and editing, rather than the clip/scene oriented
+  approach in Live.
+</p>
+
+<h2>Connecting the Push 2</h2>
+<p>
+  Plug the USB cable from the Push 2 into a USB2 or USB3 port on your
+  computer. For brighter backlighting, also plug in the power supply
+  (this is not necessary for use). 
+</p>
+<p>
+  The Push 2 will be automatically recognized by your operating
+  system, and will appear in any of the lists of possible MIDI ports
+  in both Ardour and other similar software.
+</p>
+<p>
+  To connect the Push 2 to Ardour, open the Preferences dialog, and
+  then click on "Control Surfaces". Click on the "Enable" button
+  in the line that says "Ableton Push 2" in order to activate Ardour's
+  Push 2 support. <!-- Then double click on the line that says
+  "Ableton Push 2". A new dialog will open, containing (among other things)
+  two dropdown selectors that will allow you to identify the MIDI
+  ports where your Push 2 is connected.-->
+</p>
+<!--
+<p>
+<img alt="the Faderport configuration dialog"
+     src="/images/push2_dialog.png">
+</p>
+-->
+<p>
+  Once you select the input and output port, Ardour will initialize
+  the Push 2 and it will be ready to use. You only need do this
+  once: once these ports are connected and your session has been
+  saved, the connections will be made automatically in this and other
+  future sessions.
+</p>
+
+<h2>Using the Push 2</h2>
+<p>
+  Below we document the functionality accessible from each control on
+  the Push 2. The controls can be divided into several sections.
+  <dl>
+    <dt>Pads</dt>
+    <dd></dd>
+    <dt>Buttons</dt>
+    <dd></dd>
+    <dt>Encoders</dt>
+    <dd></dd>
+    <dt>Touch Strip</dt>
+    <dd></dd>
+  </dl>
+</p>
+<p>
+  Conceptually, Ardour dividers the controls into a set of 8 strips,
+  each consisting of an encoder (at the top), 2 buttons on either side
+  of the display, and 8 pads. All the other controls have independent
+  functions.
+<p>
+  Buttons who function is somewhat related to the label built into the
+  device will have the label illuminated.
+</p>
+<p>
+  Buttons that Ardour uses for entirely different purposes than the
+  builtin label are left unilluminated, but still provide some
+  functionality. 
+</p>
+<p>
+  The upper right encoder is used as a gain control (volume) for the
+  Master out or Monitor out busses.
+</p>
+</p>