Removed link to MIDI on Linux page in Mackie Control setup page.

[ardour-manual] / include / using-the-ableton-push-2.html

diff --git a/include/using-the-ableton-push-2.html b/include/using-the-ableton-push-2.html
index 903ac229d7c35a55ddd47bc26e6bda554ff5dd78..daed433037d535ca69bfc265419de7000056b4b2 100644 (file)
--- a/include/using-the-ableton-push-2.html
+++ b/include/using-the-ableton-push-2.html
@@ -1,7 +1,11 @@
 
-<p>
-  <img alt="the Ableton Push 2 surface" src="/images/push2-main.jpg">
-</p>
+<figure>
+  <img src="/images/push2-main.jpg" alt="The Ableton Push 2 surface">
+  <figcaption>
+    The Ableton Push 2 surface
+  </figcaption>
+</figure>
+
 <p>
   Since version 5.4, Ardour has had extensive support for the Ableton
   Push2. This is an expensive but beautifully engineered control
@@ -24,6 +28,27 @@
   system, and will appear in any of the lists of possible MIDI ports
   in both Ardour and other similar software.
 </p>
+<div class="note">
+  <p>
+    Linux does not provide normal users access to arbitrary USB
+    devices by default (this is a security measure). To give yourself
+    access to the Push2, you need to create a file in
+    the <code>/etc/udev/rules.d</code> folder (directory). The name of
+    the should be something like "50-Ableton-Push2.rules" (the only
+    critical parts are that it ends in ".rules" and is unique). The
+    file should contain the following single line:
+  </p>
+  <p>
+  <verb>
+    SUBSYSTEM=="usb", ATTR{idVendor}=="2982", ATTR{idProduct}=="1967", MODE="0666", GROUP="audio"
+  </verb>
+  </p>
+  <p>
+  Note that you will need to be member of the group named in the
+  "GROUP" property ("audio" in the example above). 
+  </p>
+</div>
+
 <p>
   To connect the Push 2 to Ardour, open the Preferences dialog, and
   then click on "Control Surfaces". Click on the "Enable" button
@@ -44,11 +69,15 @@
   aftertouch or polyphonic pressure messages. You can alter this
   setting via the Push 2 GUI, accessed by double-clicking on the "Push
   2" entry in the control surfaces list.
-<p>
-<img alt="the Push 2 configuration dialog"
-     src="/images/push2-gui.png">
 </p>
 
+<figure>
+  <img src="/images/push2-gui.png" alt="The Push 2 configuration dialog">
+  <figcaption>
+    The Push 2 configuration dialog
+  </figcaption>
+</figure>
+
 <h2>Basic Concepts</h2>
 <p>
   With the Push 2 support in Ardour 5.4, you can do the following
@@ -99,10 +128,14 @@
   them, the video display and the 8 buttons below that are combined to
   provide a global view of the session mix.
 </p>
-<p>
-  <img alt="global mix mode on Push2 screen"
-       src="/images/push2-globalmix.png">
-</p>
+
+<figure>
+  <img src="/images/push2-globalmix.png" alt="Global mix mode on Push2 screen">
+  <figcaption>
+    Global mix mode on Push2 screen
+  </figcaption>
+</figure>
+
 <p>
   The upper buttons are labelled by text in the video display just
   below them. Pressing one of the buttons changes the function of the
@@ -231,10 +264,14 @@
   Press the Scale button to enter Scale mode. The display will look
   like this:
 </p>
-<p>
-  <img alt="track mix mode on Push2 screen"
-       src="/images/push2-scale.png">
-</p>
+
+<figure>
+  <img src="/images/push2-scale.png" alt="Track mix mode on Push2 screen">
+  <figcaption>
+    Track mix mode on Push2 screen
+  </figcaption>
+</figure>
+
 <p>
   In the center, 37 scales are presented. Scroll through them by
   either using the cursor/arrow keys to the lower right of the