From 3695701a13ad83640630f372c9d8d1b15991c54b Mon Sep 17 00:00:00 2001
From: Alexandre Prokoudine <alexandre.prokoudine@gmail.com>
Date: Sun, 1 Jan 2023 22:52:51 +0300
Subject: [PATCH] First shot at CC121 documentation

---
 include/control-surfaces-steinberg-cc121.html | 63 +++++++++++++++++++
 master-doc.txt                                |  9 +++
 2 files changed, 72 insertions(+)
 create mode 100644 include/control-surfaces-steinberg-cc121.html

diff --git a/include/control-surfaces-steinberg-cc121.html b/include/control-surfaces-steinberg-cc121.html
new file mode 100644
index 00000000..6ae701a0
--- /dev/null
+++ b/include/control-surfaces-steinberg-cc121.html
@@ -0,0 +1,63 @@
+<p>
+	Steinberg CC121 is a compact control surface originally designed for use with
+	the Cubase&trade; digital audio workstation.
+</p>
+
+<h2>Connecting the CC121</h2>
+
+<p>
+	Plug the USB cable from the CC121 into a USB2 or USB3 port on your computer.
+	The device will be automatically recognized by your operating system and will
+	appear in any of the lists of possible MIDI ports in Ardour.
+</p>
+
+<p>
+	To connect the CC121 to Ardour, open the <kbd class="window">Preferences</kbd>
+	dialog, and then click <kbd>Control Surfaces</kbd>. Tick the
+	<kbd class="option">Enable</kbd> checkbox opposite to "Steinberg CC121" to
+	activate Ardour's CC121 support.
+</p>
+
+<p>
+	Once the device is activated, click <kbd>Show Protocol Settings</kbd> and in
+	the newly opened window select the device in the drop-down lists for incoming
+	and outgoing MIDI events.
+</p>
+
+<p>
+	Once you select the input and output port, Ardour will initialize CC121 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>CC121 Configuration</h2>
+
+<p>
+	Ardour supports a subset of features available in the CC121. Various actions
+	in the program can be mapped to the following buttons and encoders on the
+	device:
+</p>
+
+<ul>
+	<li>
+		<kbd class="button">Function 1</kbd> through
+		<kbd class="button">Function 4</kbd> buttons
+	</li>
+	<li>
+		<kbd class="button">Value</kbd> encoder
+	</li>
+	<li>
+		<kbd class="button">Lock</kbd> button
+	</li>
+	<li>
+		<kbd class="button">EQ type</kbd> button
+	</li>
+	<li>
+		<kbd class="button">All Bypass</kbd> button
+	</li>
+	<li>
+		<kbd class="button">EQ1</kbd> through
+		<kbd class="button">EQ4</kbd> toggles
+	</li>
+</ul>
diff --git a/master-doc.txt b/master-doc.txt
index eea7d4f2..f663c908 100644
--- a/master-doc.txt
+++ b/master-doc.txt
@@ -2284,6 +2284,15 @@ uri: using-control-surfaces/PreSonus_FaderPort8
 part: chapter
 ---
 
+---
+title: Using the Steinberg CC121
+menu_title: Steinberg CC121
+include: control-surfaces-steinberg-cc121.html
+link: control-surfaces-steinberg-cc121
+uri: using-control-surfaces/Steinberg_CC121
+part: chapter
+---
+
 ---
 title: Using the Ableton Push 2
 menu_title: Ableton Push 2