An ExtIO version of the Arduino function.
-- Examples
- 1.SPI-Blink.ino, 2.BitBang-Blink.ino, 2.Button.ino, BlinkWithoutDelay-Timer.ino, Keyboard-Matrix-BCD.ino, and MIDI-Controller-Finished-Example.ino. +
- Examples
- 1.SPI-Blink.ino, 2.BitBang-Blink.ino, 2.Button.ino, BlinkWithoutDelay-Timer.ino, Keyboard-Matrix-BCD.ino, MIDI-Controller-Finished-Example.ino, and MIDI_controller-97.ino.
- Examples
- 1.SPI-Blink.ino, 2.BitBang-Blink.ino, 2.Button.ino, 2.RGB-LED-Chaser.ino, BlinkWithoutDelay-Timer.ino, Keyboard-Matrix-BCD.ino, and MIDI-Controller-Finished-Example.ino. +
- Examples
- 1.SPI-Blink.ino, 2.BitBang-Blink.ino, 2.Button.ino, 2.RGB-LED-Chaser.ino, BlinkWithoutDelay-Timer.ino, Keyboard-Matrix-BCD.ino, MIDI-Controller-Finished-Example.ino, and MIDI_controller-97.ino.
- Examples
- 1.First-Output.ino, 1.Note-LED.ino, Bank-Button-Matrix.ino, CCButton.ino, Control-Change-Potentiometer.ino, Debug-MIDI-Interface.ino, Encoder-Selector-Bank.ino, Keyboard-Matrix-BCD.ino, MIDI-Controller-Finished-Example.ino, NoteButton.ino, NoteButtonMatrix.ino, One-Pot-Both-PB-and-CC.ino, Pitch-Bend-Potentiometer.ino, and Send-MIDI-Notes.ino. +
- Examples
- 1.First-Output.ino, 1.Note-LED.ino, Bank-Button-Matrix.ino, CCButton.ino, Control-Change-Potentiometer.ino, Debug-MIDI-Interface.ino, Encoder-Selector-Bank.ino, Keyboard-Matrix-BCD.ino, MIDI-Controller-Finished-Example.ino, MIDI_controller-97.ino, NoteButton.ino, NoteButtonMatrix.ino, One-Pot-Both-PB-and-CC.ino, Pitch-Bend-Potentiometer.ino, and Send-MIDI-Notes.ino.
- Examples
- 1.First-Output.ino, and MIDI-Controller-Finished-Example.ino. +
- Examples
- 1.First-Output.ino, and MIDI-Controller-Finished-Example.ino. +
- Examples
- 1.First-Output.ino, and MIDI-Controller-Finished-Example.ino. +
- Examples
- 1.First-Output.ino. +
- Examples
- 1.First-Output.ino, and MIDI_controller-97.ino.
- Examples
- 1.First-Output.ino. +
- Examples
- 1.First-Output.ino, and MIDI_controller-97.ino.
- Examples
- 1.First-Output.ino. +
- Examples
- 1.First-Output.ino, and MIDI_controller-97.ino.
- Examples
- 1.First-Output.ino. +
- Examples
- 1.First-Output.ino, and MIDI_controller-97.ino.
- Examples
- MIDI_controller-97.ino. +
- Examples
- MIDI_controller-97.ino. +
- Examples
- MIDI_controller-97.ino. +
- Examples
- MIDI_controller-97.ino. +
- Examples
- Encoder-Selector-Bank.ino, and MIDI-Controller-Finished-Example.ino. +
- Examples
- Encoder-Selector-Bank.ino, MIDI-Controller-Finished-Example.ino, and MIDI_controller-97.ino.
- Boards:
- ESP32
- SCK: SSD1306 D0 @@ -90,15 +90,15 @@
- Note
- There seem to be some differences in the way some applications handle VU meters: some expect the hardware to decay automatically, some don't.
If you notice that the meters behave strangely, try both MCU::VUDecay::Hold and MCU::VUDecay::Default, or try a different decay time. - Boards:
- Mega
Definition at line 36 of file ExtendedInputOutput.cpp.
@@ -298,7 +298,7 @@
An ExtIO version of the Arduino function.
-
Definition at line 47 of file ExtendedInputOutput.cpp.
diff --git a/docs/Doxygen/d7/d42/Channel_8hpp.html b/docs/Doxygen/d7/d42/Channel_8hpp.html
index 282c09b615..3b27eb99b3 100644
--- a/docs/Doxygen/d7/d42/Channel_8hpp.html
+++ b/docs/Doxygen/d7/d42/Channel_8hpp.html
@@ -157,7 +157,7 @@
-
Definition at line 111 of file Channel.hpp.
@@ -183,7 +183,7 @@
-Definition at line 112 of file Channel.hpp.
@@ -209,7 +209,7 @@
-Definition at line 113 of file Channel.hpp.
@@ -235,7 +235,7 @@
-Definition at line 114 of file Channel.hpp.
@@ -261,7 +261,7 @@
-
Definition at line 115 of file Channel.hpp.
@@ -287,7 +287,7 @@
-
Definition at line 116 of file Channel.hpp.
@@ -313,7 +313,7 @@
-
Definition at line 117 of file Channel.hpp.
@@ -339,7 +339,7 @@
-
Definition at line 118 of file Channel.hpp.
@@ -365,6 +365,8 @@
+
Definition at line 119 of file Channel.hpp.
@@ -389,6 +391,8 @@
+
Definition at line 120 of file Channel.hpp.
@@ -413,6 +417,8 @@
+
Definition at line 121 of file Channel.hpp.
@@ -437,6 +443,8 @@
+
Definition at line 122 of file Channel.hpp.
diff --git a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
index 9681bb19dc..49af66362f 100644
--- a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
+++ b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
@@ -184,7 +184,7 @@
A class of MIDIOutputElements that read the analog input from a potentiometer or fader, and send out 7-bit MIDI Control Change events.
The analog input is filtered and hysteresis is applied for maximum stability.
This version can be banked.
-
Definition at line 22 of file Bankable/CCPotentiometer.hpp.
diff --git a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
index 37e5e2644f..7d230859ca 100644
--- a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
+++ b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
@@ -75,7 +75,7 @@
There are some differences in MIDI over USB implementation between different types of Arduino-compatible boards.
-
+
Arduino boards with native USB support
Arduino Due, Arduino Zero, Arduino Leonardo, Arduino Micro, Arduino LilyPad USB ...
@@ -83,14 +83,14 @@
Some of the newer boards have native USB support (i.e. the USB connection goes directly to the main MCU) this means that they can pretend to be a USB MIDI device. This is based on PluggableUSB, using the MIDIUSB library.
All you have to do to get it working, is installing the library, and upload a sketch.
The computer will then automatically detect the Arduino as a MIDI device.
-
+
Teensy
Teensy 2.0, Teensy++ 2.0, Teensy LC, Teensy 3.0, Teensy 3.1, Teensy 3.2, Teensy 3.5, Teensy 3.6
Teensy boards have native USB support as well. You don't even need to install anything, because MIDI over USB is implemented in the Teensy Core.
You just need to select the 'MIDI' USB type from Tools > USB Type > MIDI.
-
+
Arduino boards with an ATmega16U2 (ATmega8U2)
Arduino Uno, Arduino Mega
@@ -113,7 +113,7 @@
Finally, when you know that everything is working fine, you can change the baud rate to the official MIDI baud rate of 31250, by using the default USBMIDI_Interface (don't explicitly instantiate any interfaces) uploading the sketch, and flashing the HIDUINO MIDI firmware using Flip or dfu-programmer.
You can now just plug it into your computer, and it will be recognized as a MIDI device, you don't need to run Hairless anymore.
-
+
Boards with a single-purpose USB-to-TTL chip
Arduino Nano, Arduino Duemilanove, Chinese Uno & Mega clones ...
@@ -122,7 +122,7 @@
While MIDI over USB is not supported on these boards, you can still use Hairless. Just instantiate a HairlessMIDI_Interface at the top of your sketch.
-
+
Conclusion
I strongly recommend getting a Teensy 3.x for building a Control Surface. MIDI over USB is supported right of the box, and it's the only platform that currently supports USB audio output. On top of that, it has plenty of memory to create large MIDI Controllers, and drive lots of displays.
If you just want a very small MIDI Controller, the Arduino Leonardo/Micro are good choices as well, just keep in mind that they don't have a lot of RAM.
diff --git a/docs/Doxygen/d8/da8/md_pages_Installation.html b/docs/Doxygen/d8/da8/md_pages_Installation.html
index 6cbe7e740e..8f6aec0a15 100644
--- a/docs/Doxygen/d8/da8/md_pages_Installation.html
+++ b/docs/Doxygen/d8/da8/md_pages_Installation.html
@@ -77,35 +77,35 @@
This document assumes that the Arduino IDE is already installed, as well as the necessary hardware support packages, such as Teensyduino or the ESP32 Core.
You have to install the Control Surface library itself, as well as some dependencies.
If you want to keep up to date with the latest developments, or if you want an easy way to update, the git install is recommended. Otherwise, you can use the no git install.
-
+
Installation (no git)
-
+
1. Download
Download the repository as a ZIP archive by going to the home page of the repository and click the green Clone or download button on the top right.
-
+
2. Install the Library in the Arduino IDE
Open the Arduino IDE, and go to the Sketch > Include Library > Add .ZIP Library menu.
Then navigate to your downloads directory where you just downloaded the library.
Select it, and click Ok.
-
+
Installation (git)
-
+
0. Install git
If you haven't already, install git from https://git-scm.com/downloads or use your system's package manager.
On Ubuntu and other Debian-based distros:
sudo apt install git
-
+
1. Browse to your Arduino Libraries folder
Open a terminal window and change the directory to your Arduino folder.
On Linux:
mkdir -p ~/Arduino/libraries && cd $_
-
+
2. Clone the Library
git clone https://github.com/tttapa/Control-Surface
-
+
3. Updating to the latest version
If you installed the library using git, you can easily update it when a new version comes out.
To update to the latest master version:
git pull
-
+
Dependencies
If you are using an Arduino board with on-board USB capabilities, you need the MIDIUSB library. Install it as explained before, or by using the Library Manager.
The Control Surface Library depends on the PJRC Encoder library for reading the input from rotary encoders. Download and install it if you plan on using those.
diff --git a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
index 715ebb83b5..dc99fb69c3 100644
--- a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
+++ b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
@@ -74,12 +74,12 @@
VU-Meter-Bridge.ino
-
+
VU-Meter-Bridge
This is an example on how to use an OLED display to display the VU meters and mute/solo states of the eight first tracks, by using the Arduino as a Mackie Control Universal. This is an example modified to work with the ESP32 only, using MIDI over Bluetooth Low Energy.
-
+
Connections
This example drives two SSD1306 OLED displays over SPI
Add a capacitor between the reset pin of the display and ground, and a resistor from reset to 3.3V. The values are not critical, 0.1µF and 10kΩ work fine.
You do need some way to reset the display, without it, it won't work.
Alternatively, you could use an IO pin from the ESP32 to reset the display, but this just "wastes" a pin.
-
+
Behavior
The first display should now display the level meters and mute/solo states of the first 8 tracks.
-
+
Mapping
Map "Control Surface" as a Mackie Control Universal unit in your DAW.
-
+
Demo
+
+
+
+
+MIDI_controller-97.ino
+
+
+
+MIDI_controller-97
+https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602
+Many bankable potentiometers and buttons.
+
+/**
+ * <https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602>
+ *
+ * Many bankable potentiometers and buttons.
+ *
+ * @boards Mega
+ */
+
+#include <Control_Surface.h>
+
+#include <AH/STL/algorithm> // std::any_of
+
+Bank<4> bank(16);
+
+// Create a new bank selector that changes the bank setting of the bank we just
+// created.
+// It has push buttons connected to pins 21 and 20 that increment or decrement
+// the bank setting, and 4 LEDs to pins 46, 48, 50, 52 that display the current
+// bank setting.
+IncrementDecrementSelectorLEDs<4> bankSelector = {
+ bank,
+ {21, 20}, // button pins
+ {46, 48, 50, 52}, // LED pins
+};
+
+using namespace MIDI_CC;
+Bankable::CCPotentiometer potentiometers[] = {
+
+
+
+
+
+
+
+
+
+
+
+
+};
+
+Bankable::NoteButton muteButtons[] = {
+ {bank, 13, 0x14},
+ {bank, 12, 0x15},
+ {bank, 11, 0x16},
+ {bank, 10, 0x17},
+ {bank, 9, 0x18},
+ {bank, 8, 0x19},
+ {bank, 7, 0x1A},
+ {bank, 6, 0x1B},
+ {bank, 5, 0x1C},
+ {bank, 4, 0x1D},
+ {bank, 3, 0x1E},
+ {bank, 2, 0x1F},
+ {bank, 14, 0x20},
+ {bank, 15, 0x21},
+ {bank, 16, 0x22},
+ {bank, 17, 0x23},
+ {bank, 18, {0x33, CHANNEL_2}},
+ {bank, 19, {0x34, CHANNEL_2}},
+};
+
+constexpr pin_t ledPin = 22;
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void setup() {
+
+
+}
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void loop() {
+
+
+ // Function that checks if a given button is pressed
+
+ return button.getButtonState() == Button::Pressed;
+ };
+ // If any of the push buttons is pressed
+ bool pressed = std::any_of(std::begin(muteButtons), std::end(muteButtons),
+ checkButtonPressed);
+ // Turn on the LED
+ digitalWrite(ledPin, pressed);
+}
+
+A class of MIDIOutputElements that read the input of a momentary push button or switch,...Definition: Bankable/NoteButton.hpp:22
+A class that groups Bankable BankableMIDIOutputs and BankableMIDIInputs, and allows the user to chang...Definition: Bank.hpp:77
+
+
+void pinMode(pin_t pin, uint8_t mode)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:36
+
+
+Selector with two buttons (one to increment, one to decrement). This version displays the setting usi...Definition: SelectorLEDs.hpp:99
+
+
+
+The main header file that includes all Control-Surface header files.
+A class of MIDIOutputElements that read the analog input from a potentiometer or fader,...Definition: Bankable/CCPotentiometer.hpp:22
+
+Control_Surface_ & Control_SurfaceA predefined instance of the Control Surface to use in the Arduino sketches.Definition: Control_Surface_Class.cpp:174
+
+
+
+
+
+
+
+uint16_t pin_tThe type for Arduino pins (and ExtendedIOElement pins).Definition: Hardware-Types.hpp:17
+
+
+
+
+
+Names and values for all MIDI Control Change Controller Numbers.Definition: Control_Change.hpp:14
+
+
+
+
+
+
+void loop()Update all MIDI elements, send MIDI events and read MIDI input.Definition: Control_Surface_Class.cpp:48
+void digitalWrite(pin_t pin, uint8_t val)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:47
+
+
+Generated by
+
+ 1.8.16
+
+
Definition at line 47 of file ExtendedInputOutput.cpp.
diff --git a/docs/Doxygen/d7/d42/Channel_8hpp.html b/docs/Doxygen/d7/d42/Channel_8hpp.html index 282c09b615..3b27eb99b3 100644 --- a/docs/Doxygen/d7/d42/Channel_8hpp.html +++ b/docs/Doxygen/d7/d42/Channel_8hpp.html @@ -157,7 +157,7 @@
-
Definition at line 111 of file Channel.hpp.
@@ -183,7 +183,7 @@
-Definition at line 112 of file Channel.hpp.
@@ -209,7 +209,7 @@
-Definition at line 113 of file Channel.hpp.
@@ -235,7 +235,7 @@
-Definition at line 114 of file Channel.hpp.
@@ -261,7 +261,7 @@
-
Definition at line 115 of file Channel.hpp.
@@ -287,7 +287,7 @@
-
Definition at line 116 of file Channel.hpp.
@@ -313,7 +313,7 @@
-
Definition at line 117 of file Channel.hpp.
@@ -339,7 +339,7 @@
-
Definition at line 118 of file Channel.hpp.
@@ -365,6 +365,8 @@
+
Definition at line 119 of file Channel.hpp.
@@ -389,6 +391,8 @@
+
Definition at line 120 of file Channel.hpp.
@@ -413,6 +417,8 @@
+
Definition at line 121 of file Channel.hpp.
@@ -437,6 +443,8 @@
+
Definition at line 122 of file Channel.hpp.
diff --git a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
index 9681bb19dc..49af66362f 100644
--- a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
+++ b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
@@ -184,7 +184,7 @@
A class of MIDIOutputElements that read the analog input from a potentiometer or fader, and send out 7-bit MIDI Control Change events.
The analog input is filtered and hysteresis is applied for maximum stability.
This version can be banked.
-
Definition at line 22 of file Bankable/CCPotentiometer.hpp.
diff --git a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
index 37e5e2644f..7d230859ca 100644
--- a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
+++ b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
@@ -75,7 +75,7 @@
There are some differences in MIDI over USB implementation between different types of Arduino-compatible boards.
-
+
Arduino boards with native USB support
Arduino Due, Arduino Zero, Arduino Leonardo, Arduino Micro, Arduino LilyPad USB ...
@@ -83,14 +83,14 @@
Some of the newer boards have native USB support (i.e. the USB connection goes directly to the main MCU) this means that they can pretend to be a USB MIDI device. This is based on PluggableUSB, using the MIDIUSB library.
All you have to do to get it working, is installing the library, and upload a sketch.
The computer will then automatically detect the Arduino as a MIDI device.
-
+
Teensy
Teensy 2.0, Teensy++ 2.0, Teensy LC, Teensy 3.0, Teensy 3.1, Teensy 3.2, Teensy 3.5, Teensy 3.6
Teensy boards have native USB support as well. You don't even need to install anything, because MIDI over USB is implemented in the Teensy Core.
You just need to select the 'MIDI' USB type from Tools > USB Type > MIDI.
-
+
Arduino boards with an ATmega16U2 (ATmega8U2)
Arduino Uno, Arduino Mega
@@ -113,7 +113,7 @@
Finally, when you know that everything is working fine, you can change the baud rate to the official MIDI baud rate of 31250, by using the default USBMIDI_Interface (don't explicitly instantiate any interfaces) uploading the sketch, and flashing the HIDUINO MIDI firmware using Flip or dfu-programmer.
You can now just plug it into your computer, and it will be recognized as a MIDI device, you don't need to run Hairless anymore.
-
+
Boards with a single-purpose USB-to-TTL chip
Arduino Nano, Arduino Duemilanove, Chinese Uno & Mega clones ...
@@ -122,7 +122,7 @@
While MIDI over USB is not supported on these boards, you can still use Hairless. Just instantiate a HairlessMIDI_Interface at the top of your sketch.
-
+
Conclusion
I strongly recommend getting a Teensy 3.x for building a Control Surface. MIDI over USB is supported right of the box, and it's the only platform that currently supports USB audio output. On top of that, it has plenty of memory to create large MIDI Controllers, and drive lots of displays.
If you just want a very small MIDI Controller, the Arduino Leonardo/Micro are good choices as well, just keep in mind that they don't have a lot of RAM.
diff --git a/docs/Doxygen/d8/da8/md_pages_Installation.html b/docs/Doxygen/d8/da8/md_pages_Installation.html
index 6cbe7e740e..8f6aec0a15 100644
--- a/docs/Doxygen/d8/da8/md_pages_Installation.html
+++ b/docs/Doxygen/d8/da8/md_pages_Installation.html
@@ -77,35 +77,35 @@
This document assumes that the Arduino IDE is already installed, as well as the necessary hardware support packages, such as Teensyduino or the ESP32 Core.
You have to install the Control Surface library itself, as well as some dependencies.
If you want to keep up to date with the latest developments, or if you want an easy way to update, the git install is recommended. Otherwise, you can use the no git install.
-
+
Installation (no git)
-
+
1. Download
Download the repository as a ZIP archive by going to the home page of the repository and click the green Clone or download button on the top right.
-
+
2. Install the Library in the Arduino IDE
Open the Arduino IDE, and go to the Sketch > Include Library > Add .ZIP Library menu.
Then navigate to your downloads directory where you just downloaded the library.
Select it, and click Ok.
-
+
Installation (git)
-
+
0. Install git
If you haven't already, install git from https://git-scm.com/downloads or use your system's package manager.
On Ubuntu and other Debian-based distros:
sudo apt install git
-
+
1. Browse to your Arduino Libraries folder
Open a terminal window and change the directory to your Arduino folder.
On Linux:
mkdir -p ~/Arduino/libraries && cd $_
-
+
2. Clone the Library
git clone https://github.com/tttapa/Control-Surface
-
+
3. Updating to the latest version
If you installed the library using git, you can easily update it when a new version comes out.
To update to the latest master version:
git pull
-
+
Dependencies
If you are using an Arduino board with on-board USB capabilities, you need the MIDIUSB library. Install it as explained before, or by using the Library Manager.
The Control Surface Library depends on the PJRC Encoder library for reading the input from rotary encoders. Download and install it if you plan on using those.
diff --git a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
index 715ebb83b5..dc99fb69c3 100644
--- a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
+++ b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
@@ -74,12 +74,12 @@
VU-Meter-Bridge.ino
-
+
VU-Meter-Bridge
This is an example on how to use an OLED display to display the VU meters and mute/solo states of the eight first tracks, by using the Arduino as a Mackie Control Universal. This is an example modified to work with the ESP32 only, using MIDI over Bluetooth Low Energy.
-
+
Connections
This example drives two SSD1306 OLED displays over SPI
Add a capacitor between the reset pin of the display and ground, and a resistor from reset to 3.3V. The values are not critical, 0.1µF and 10kΩ work fine.
You do need some way to reset the display, without it, it won't work.
Alternatively, you could use an IO pin from the ESP32 to reset the display, but this just "wastes" a pin.
-
+
Behavior
The first display should now display the level meters and mute/solo states of the first 8 tracks.
-
+
Mapping
Map "Control Surface" as a Mackie Control Universal unit in your DAW.
-
+
Demo
+
+
+
+
+MIDI_controller-97.ino
+
+
+
+MIDI_controller-97
+https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602
+Many bankable potentiometers and buttons.
+
+/**
+ * <https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602>
+ *
+ * Many bankable potentiometers and buttons.
+ *
+ * @boards Mega
+ */
+
+#include <Control_Surface.h>
+
+#include <AH/STL/algorithm> // std::any_of
+
+Bank<4> bank(16);
+
+// Create a new bank selector that changes the bank setting of the bank we just
+// created.
+// It has push buttons connected to pins 21 and 20 that increment or decrement
+// the bank setting, and 4 LEDs to pins 46, 48, 50, 52 that display the current
+// bank setting.
+IncrementDecrementSelectorLEDs<4> bankSelector = {
+ bank,
+ {21, 20}, // button pins
+ {46, 48, 50, 52}, // LED pins
+};
+
+using namespace MIDI_CC;
+Bankable::CCPotentiometer potentiometers[] = {
+
+
+
+
+
+
+
+
+
+
+
+
+};
+
+Bankable::NoteButton muteButtons[] = {
+ {bank, 13, 0x14},
+ {bank, 12, 0x15},
+ {bank, 11, 0x16},
+ {bank, 10, 0x17},
+ {bank, 9, 0x18},
+ {bank, 8, 0x19},
+ {bank, 7, 0x1A},
+ {bank, 6, 0x1B},
+ {bank, 5, 0x1C},
+ {bank, 4, 0x1D},
+ {bank, 3, 0x1E},
+ {bank, 2, 0x1F},
+ {bank, 14, 0x20},
+ {bank, 15, 0x21},
+ {bank, 16, 0x22},
+ {bank, 17, 0x23},
+ {bank, 18, {0x33, CHANNEL_2}},
+ {bank, 19, {0x34, CHANNEL_2}},
+};
+
+constexpr pin_t ledPin = 22;
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void setup() {
+
+
+}
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void loop() {
+
+
+ // Function that checks if a given button is pressed
+
+ return button.getButtonState() == Button::Pressed;
+ };
+ // If any of the push buttons is pressed
+ bool pressed = std::any_of(std::begin(muteButtons), std::end(muteButtons),
+ checkButtonPressed);
+ // Turn on the LED
+ digitalWrite(ledPin, pressed);
+}
+
+A class of MIDIOutputElements that read the input of a momentary push button or switch,...Definition: Bankable/NoteButton.hpp:22
+A class that groups Bankable BankableMIDIOutputs and BankableMIDIInputs, and allows the user to chang...Definition: Bank.hpp:77
+
+
+void pinMode(pin_t pin, uint8_t mode)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:36
+
+
+Selector with two buttons (one to increment, one to decrement). This version displays the setting usi...Definition: SelectorLEDs.hpp:99
+
+
+
+The main header file that includes all Control-Surface header files.
+A class of MIDIOutputElements that read the analog input from a potentiometer or fader,...Definition: Bankable/CCPotentiometer.hpp:22
+
+Control_Surface_ & Control_SurfaceA predefined instance of the Control Surface to use in the Arduino sketches.Definition: Control_Surface_Class.cpp:174
+
+
+
+
+
+
+
+uint16_t pin_tThe type for Arduino pins (and ExtendedIOElement pins).Definition: Hardware-Types.hpp:17
+
+
+
+
+
+Names and values for all MIDI Control Change Controller Numbers.Definition: Control_Change.hpp:14
+
+
+
+
+
+
+void loop()Update all MIDI elements, send MIDI events and read MIDI input.Definition: Control_Surface_Class.cpp:48
+void digitalWrite(pin_t pin, uint8_t val)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:47
+
+
+Generated by
+
+ 1.8.16
+
+
Definition at line 111 of file Channel.hpp.
@@ -183,7 +183,7 @@
-Definition at line 112 of file Channel.hpp.
@@ -209,7 +209,7 @@
-Definition at line 113 of file Channel.hpp.
@@ -235,7 +235,7 @@
-Definition at line 114 of file Channel.hpp.
@@ -261,7 +261,7 @@
-
Definition at line 115 of file Channel.hpp.
@@ -287,7 +287,7 @@
-
Definition at line 116 of file Channel.hpp.
@@ -313,7 +313,7 @@
-
Definition at line 117 of file Channel.hpp.
@@ -339,7 +339,7 @@
-
Definition at line 118 of file Channel.hpp.
@@ -365,6 +365,8 @@
+
Definition at line 119 of file Channel.hpp.
@@ -389,6 +391,8 @@
+
Definition at line 120 of file Channel.hpp.
@@ -413,6 +417,8 @@
+
Definition at line 121 of file Channel.hpp.
@@ -437,6 +443,8 @@
+
Definition at line 122 of file Channel.hpp.
diff --git a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
index 9681bb19dc..49af66362f 100644
--- a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
+++ b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
@@ -184,7 +184,7 @@
A class of MIDIOutputElements that read the analog input from a potentiometer or fader, and send out 7-bit MIDI Control Change events.
The analog input is filtered and hysteresis is applied for maximum stability.
This version can be banked.
-
Definition at line 22 of file Bankable/CCPotentiometer.hpp.
diff --git a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
index 37e5e2644f..7d230859ca 100644
--- a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
+++ b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
@@ -75,7 +75,7 @@
There are some differences in MIDI over USB implementation between different types of Arduino-compatible boards.
-
+
Arduino boards with native USB support
Arduino Due, Arduino Zero, Arduino Leonardo, Arduino Micro, Arduino LilyPad USB ...
@@ -83,14 +83,14 @@
Some of the newer boards have native USB support (i.e. the USB connection goes directly to the main MCU) this means that they can pretend to be a USB MIDI device. This is based on PluggableUSB, using the MIDIUSB library.
All you have to do to get it working, is installing the library, and upload a sketch.
The computer will then automatically detect the Arduino as a MIDI device.
-
+
Teensy
Teensy 2.0, Teensy++ 2.0, Teensy LC, Teensy 3.0, Teensy 3.1, Teensy 3.2, Teensy 3.5, Teensy 3.6
Teensy boards have native USB support as well. You don't even need to install anything, because MIDI over USB is implemented in the Teensy Core.
You just need to select the 'MIDI' USB type from Tools > USB Type > MIDI.
-
+
Arduino boards with an ATmega16U2 (ATmega8U2)
Arduino Uno, Arduino Mega
@@ -113,7 +113,7 @@
Finally, when you know that everything is working fine, you can change the baud rate to the official MIDI baud rate of 31250, by using the default USBMIDI_Interface (don't explicitly instantiate any interfaces) uploading the sketch, and flashing the HIDUINO MIDI firmware using Flip or dfu-programmer.
You can now just plug it into your computer, and it will be recognized as a MIDI device, you don't need to run Hairless anymore.
-
+
Boards with a single-purpose USB-to-TTL chip
Arduino Nano, Arduino Duemilanove, Chinese Uno & Mega clones ...
@@ -122,7 +122,7 @@
While MIDI over USB is not supported on these boards, you can still use Hairless. Just instantiate a HairlessMIDI_Interface at the top of your sketch.
-
+
Conclusion
I strongly recommend getting a Teensy 3.x for building a Control Surface. MIDI over USB is supported right of the box, and it's the only platform that currently supports USB audio output. On top of that, it has plenty of memory to create large MIDI Controllers, and drive lots of displays.
If you just want a very small MIDI Controller, the Arduino Leonardo/Micro are good choices as well, just keep in mind that they don't have a lot of RAM.
diff --git a/docs/Doxygen/d8/da8/md_pages_Installation.html b/docs/Doxygen/d8/da8/md_pages_Installation.html
index 6cbe7e740e..8f6aec0a15 100644
--- a/docs/Doxygen/d8/da8/md_pages_Installation.html
+++ b/docs/Doxygen/d8/da8/md_pages_Installation.html
@@ -77,35 +77,35 @@
This document assumes that the Arduino IDE is already installed, as well as the necessary hardware support packages, such as Teensyduino or the ESP32 Core.
You have to install the Control Surface library itself, as well as some dependencies.
If you want to keep up to date with the latest developments, or if you want an easy way to update, the git install is recommended. Otherwise, you can use the no git install.
-
+
Installation (no git)
-
+
1. Download
Download the repository as a ZIP archive by going to the home page of the repository and click the green Clone or download button on the top right.
-
+
2. Install the Library in the Arduino IDE
Open the Arduino IDE, and go to the Sketch > Include Library > Add .ZIP Library menu.
Then navigate to your downloads directory where you just downloaded the library.
Select it, and click Ok.
-
+
Installation (git)
-
+
0. Install git
If you haven't already, install git from https://git-scm.com/downloads or use your system's package manager.
On Ubuntu and other Debian-based distros:
sudo apt install git
-
+
1. Browse to your Arduino Libraries folder
Open a terminal window and change the directory to your Arduino folder.
On Linux:
mkdir -p ~/Arduino/libraries && cd $_
-
+
2. Clone the Library
git clone https://github.com/tttapa/Control-Surface
-
+
3. Updating to the latest version
If you installed the library using git, you can easily update it when a new version comes out.
To update to the latest master version:
git pull
-
+
Dependencies
If you are using an Arduino board with on-board USB capabilities, you need the MIDIUSB library. Install it as explained before, or by using the Library Manager.
The Control Surface Library depends on the PJRC Encoder library for reading the input from rotary encoders. Download and install it if you plan on using those.
diff --git a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
index 715ebb83b5..dc99fb69c3 100644
--- a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
+++ b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
@@ -74,12 +74,12 @@
VU-Meter-Bridge.ino
-
+
VU-Meter-Bridge
This is an example on how to use an OLED display to display the VU meters and mute/solo states of the eight first tracks, by using the Arduino as a Mackie Control Universal. This is an example modified to work with the ESP32 only, using MIDI over Bluetooth Low Energy.
-
+
Connections
This example drives two SSD1306 OLED displays over SPI
Add a capacitor between the reset pin of the display and ground, and a resistor from reset to 3.3V. The values are not critical, 0.1µF and 10kΩ work fine.
You do need some way to reset the display, without it, it won't work.
Alternatively, you could use an IO pin from the ESP32 to reset the display, but this just "wastes" a pin.
-
+
Behavior
The first display should now display the level meters and mute/solo states of the first 8 tracks.
-
+
Mapping
Map "Control Surface" as a Mackie Control Universal unit in your DAW.
-
+
Demo
+
+
+
+
+MIDI_controller-97.ino
+
+
+
+MIDI_controller-97
+https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602
+Many bankable potentiometers and buttons.
+
+/**
+ * <https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602>
+ *
+ * Many bankable potentiometers and buttons.
+ *
+ * @boards Mega
+ */
+
+#include <Control_Surface.h>
+
+#include <AH/STL/algorithm> // std::any_of
+
+Bank<4> bank(16);
+
+// Create a new bank selector that changes the bank setting of the bank we just
+// created.
+// It has push buttons connected to pins 21 and 20 that increment or decrement
+// the bank setting, and 4 LEDs to pins 46, 48, 50, 52 that display the current
+// bank setting.
+IncrementDecrementSelectorLEDs<4> bankSelector = {
+ bank,
+ {21, 20}, // button pins
+ {46, 48, 50, 52}, // LED pins
+};
+
+using namespace MIDI_CC;
+Bankable::CCPotentiometer potentiometers[] = {
+
+
+
+
+
+
+
+
+
+
+
+
+};
+
+Bankable::NoteButton muteButtons[] = {
+ {bank, 13, 0x14},
+ {bank, 12, 0x15},
+ {bank, 11, 0x16},
+ {bank, 10, 0x17},
+ {bank, 9, 0x18},
+ {bank, 8, 0x19},
+ {bank, 7, 0x1A},
+ {bank, 6, 0x1B},
+ {bank, 5, 0x1C},
+ {bank, 4, 0x1D},
+ {bank, 3, 0x1E},
+ {bank, 2, 0x1F},
+ {bank, 14, 0x20},
+ {bank, 15, 0x21},
+ {bank, 16, 0x22},
+ {bank, 17, 0x23},
+ {bank, 18, {0x33, CHANNEL_2}},
+ {bank, 19, {0x34, CHANNEL_2}},
+};
+
+constexpr pin_t ledPin = 22;
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void setup() {
+
+
+}
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void loop() {
+
+
+ // Function that checks if a given button is pressed
+
+ return button.getButtonState() == Button::Pressed;
+ };
+ // If any of the push buttons is pressed
+ bool pressed = std::any_of(std::begin(muteButtons), std::end(muteButtons),
+ checkButtonPressed);
+ // Turn on the LED
+ digitalWrite(ledPin, pressed);
+}
+
+A class of MIDIOutputElements that read the input of a momentary push button or switch,...Definition: Bankable/NoteButton.hpp:22
+A class that groups Bankable BankableMIDIOutputs and BankableMIDIInputs, and allows the user to chang...Definition: Bank.hpp:77
+
+
+void pinMode(pin_t pin, uint8_t mode)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:36
+
+
+Selector with two buttons (one to increment, one to decrement). This version displays the setting usi...Definition: SelectorLEDs.hpp:99
+
+
+
+The main header file that includes all Control-Surface header files.
+A class of MIDIOutputElements that read the analog input from a potentiometer or fader,...Definition: Bankable/CCPotentiometer.hpp:22
+
+Control_Surface_ & Control_SurfaceA predefined instance of the Control Surface to use in the Arduino sketches.Definition: Control_Surface_Class.cpp:174
+
+
+
+
+
+
+
+uint16_t pin_tThe type for Arduino pins (and ExtendedIOElement pins).Definition: Hardware-Types.hpp:17
+
+
+
+
+
+Names and values for all MIDI Control Change Controller Numbers.Definition: Control_Change.hpp:14
+
+
+
+
+
+
+void loop()Update all MIDI elements, send MIDI events and read MIDI input.Definition: Control_Surface_Class.cpp:48
+void digitalWrite(pin_t pin, uint8_t val)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:47
+
+
+Generated by
+
+ 1.8.16
+
+
Definition at line 112 of file Channel.hpp.
@@ -209,7 +209,7 @@
-Definition at line 113 of file Channel.hpp.
@@ -235,7 +235,7 @@
-Definition at line 114 of file Channel.hpp.
@@ -261,7 +261,7 @@
-
Definition at line 115 of file Channel.hpp.
@@ -287,7 +287,7 @@
-
Definition at line 116 of file Channel.hpp.
@@ -313,7 +313,7 @@
-
Definition at line 117 of file Channel.hpp.
@@ -339,7 +339,7 @@
-
Definition at line 118 of file Channel.hpp.
@@ -365,6 +365,8 @@
+
Definition at line 119 of file Channel.hpp.
@@ -389,6 +391,8 @@
+
Definition at line 120 of file Channel.hpp.
@@ -413,6 +417,8 @@
+
Definition at line 121 of file Channel.hpp.
@@ -437,6 +443,8 @@
+
Definition at line 122 of file Channel.hpp.
diff --git a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
index 9681bb19dc..49af66362f 100644
--- a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
+++ b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
@@ -184,7 +184,7 @@
A class of MIDIOutputElements that read the analog input from a potentiometer or fader, and send out 7-bit MIDI Control Change events.
The analog input is filtered and hysteresis is applied for maximum stability.
This version can be banked.
-
Definition at line 22 of file Bankable/CCPotentiometer.hpp.
diff --git a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
index 37e5e2644f..7d230859ca 100644
--- a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
+++ b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
@@ -75,7 +75,7 @@
There are some differences in MIDI over USB implementation between different types of Arduino-compatible boards.
-
+
Arduino boards with native USB support
Arduino Due, Arduino Zero, Arduino Leonardo, Arduino Micro, Arduino LilyPad USB ...
@@ -83,14 +83,14 @@
Some of the newer boards have native USB support (i.e. the USB connection goes directly to the main MCU) this means that they can pretend to be a USB MIDI device. This is based on PluggableUSB, using the MIDIUSB library.
All you have to do to get it working, is installing the library, and upload a sketch.
The computer will then automatically detect the Arduino as a MIDI device.
-
+
Teensy
Teensy 2.0, Teensy++ 2.0, Teensy LC, Teensy 3.0, Teensy 3.1, Teensy 3.2, Teensy 3.5, Teensy 3.6
Teensy boards have native USB support as well. You don't even need to install anything, because MIDI over USB is implemented in the Teensy Core.
You just need to select the 'MIDI' USB type from Tools > USB Type > MIDI.
-
+
Arduino boards with an ATmega16U2 (ATmega8U2)
Arduino Uno, Arduino Mega
@@ -113,7 +113,7 @@
Finally, when you know that everything is working fine, you can change the baud rate to the official MIDI baud rate of 31250, by using the default USBMIDI_Interface (don't explicitly instantiate any interfaces) uploading the sketch, and flashing the HIDUINO MIDI firmware using Flip or dfu-programmer.
You can now just plug it into your computer, and it will be recognized as a MIDI device, you don't need to run Hairless anymore.
-
+
Boards with a single-purpose USB-to-TTL chip
Arduino Nano, Arduino Duemilanove, Chinese Uno & Mega clones ...
@@ -122,7 +122,7 @@
While MIDI over USB is not supported on these boards, you can still use Hairless. Just instantiate a HairlessMIDI_Interface at the top of your sketch.
-
+
Conclusion
I strongly recommend getting a Teensy 3.x for building a Control Surface. MIDI over USB is supported right of the box, and it's the only platform that currently supports USB audio output. On top of that, it has plenty of memory to create large MIDI Controllers, and drive lots of displays.
If you just want a very small MIDI Controller, the Arduino Leonardo/Micro are good choices as well, just keep in mind that they don't have a lot of RAM.
diff --git a/docs/Doxygen/d8/da8/md_pages_Installation.html b/docs/Doxygen/d8/da8/md_pages_Installation.html
index 6cbe7e740e..8f6aec0a15 100644
--- a/docs/Doxygen/d8/da8/md_pages_Installation.html
+++ b/docs/Doxygen/d8/da8/md_pages_Installation.html
@@ -77,35 +77,35 @@
This document assumes that the Arduino IDE is already installed, as well as the necessary hardware support packages, such as Teensyduino or the ESP32 Core.
You have to install the Control Surface library itself, as well as some dependencies.
If you want to keep up to date with the latest developments, or if you want an easy way to update, the git install is recommended. Otherwise, you can use the no git install.
-
+
Installation (no git)
-
+
1. Download
Download the repository as a ZIP archive by going to the home page of the repository and click the green Clone or download button on the top right.
-
+
2. Install the Library in the Arduino IDE
Open the Arduino IDE, and go to the Sketch > Include Library > Add .ZIP Library menu.
Then navigate to your downloads directory where you just downloaded the library.
Select it, and click Ok.
-
+
Installation (git)
-
+
0. Install git
If you haven't already, install git from https://git-scm.com/downloads or use your system's package manager.
On Ubuntu and other Debian-based distros:
sudo apt install git
-
+
1. Browse to your Arduino Libraries folder
Open a terminal window and change the directory to your Arduino folder.
On Linux:
mkdir -p ~/Arduino/libraries && cd $_
-
+
2. Clone the Library
git clone https://github.com/tttapa/Control-Surface
-
+
3. Updating to the latest version
If you installed the library using git, you can easily update it when a new version comes out.
To update to the latest master version:
git pull
-
+
Dependencies
If you are using an Arduino board with on-board USB capabilities, you need the MIDIUSB library. Install it as explained before, or by using the Library Manager.
The Control Surface Library depends on the PJRC Encoder library for reading the input from rotary encoders. Download and install it if you plan on using those.
diff --git a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
index 715ebb83b5..dc99fb69c3 100644
--- a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
+++ b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
@@ -74,12 +74,12 @@
VU-Meter-Bridge.ino
-
+
VU-Meter-Bridge
This is an example on how to use an OLED display to display the VU meters and mute/solo states of the eight first tracks, by using the Arduino as a Mackie Control Universal. This is an example modified to work with the ESP32 only, using MIDI over Bluetooth Low Energy.
-
+
Connections
This example drives two SSD1306 OLED displays over SPI
Add a capacitor between the reset pin of the display and ground, and a resistor from reset to 3.3V. The values are not critical, 0.1µF and 10kΩ work fine.
You do need some way to reset the display, without it, it won't work.
Alternatively, you could use an IO pin from the ESP32 to reset the display, but this just "wastes" a pin.
-
+
Behavior
The first display should now display the level meters and mute/solo states of the first 8 tracks.
-
+
Mapping
Map "Control Surface" as a Mackie Control Universal unit in your DAW.
-
+
Demo
+
+
+
+
+MIDI_controller-97.ino
+
+
+
+MIDI_controller-97
+https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602
+Many bankable potentiometers and buttons.
+
+/**
+ * <https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602>
+ *
+ * Many bankable potentiometers and buttons.
+ *
+ * @boards Mega
+ */
+
+#include <Control_Surface.h>
+
+#include <AH/STL/algorithm> // std::any_of
+
+Bank<4> bank(16);
+
+// Create a new bank selector that changes the bank setting of the bank we just
+// created.
+// It has push buttons connected to pins 21 and 20 that increment or decrement
+// the bank setting, and 4 LEDs to pins 46, 48, 50, 52 that display the current
+// bank setting.
+IncrementDecrementSelectorLEDs<4> bankSelector = {
+ bank,
+ {21, 20}, // button pins
+ {46, 48, 50, 52}, // LED pins
+};
+
+using namespace MIDI_CC;
+Bankable::CCPotentiometer potentiometers[] = {
+
+
+
+
+
+
+
+
+
+
+
+
+};
+
+Bankable::NoteButton muteButtons[] = {
+ {bank, 13, 0x14},
+ {bank, 12, 0x15},
+ {bank, 11, 0x16},
+ {bank, 10, 0x17},
+ {bank, 9, 0x18},
+ {bank, 8, 0x19},
+ {bank, 7, 0x1A},
+ {bank, 6, 0x1B},
+ {bank, 5, 0x1C},
+ {bank, 4, 0x1D},
+ {bank, 3, 0x1E},
+ {bank, 2, 0x1F},
+ {bank, 14, 0x20},
+ {bank, 15, 0x21},
+ {bank, 16, 0x22},
+ {bank, 17, 0x23},
+ {bank, 18, {0x33, CHANNEL_2}},
+ {bank, 19, {0x34, CHANNEL_2}},
+};
+
+constexpr pin_t ledPin = 22;
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void setup() {
+
+
+}
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void loop() {
+
+
+ // Function that checks if a given button is pressed
+
+ return button.getButtonState() == Button::Pressed;
+ };
+ // If any of the push buttons is pressed
+ bool pressed = std::any_of(std::begin(muteButtons), std::end(muteButtons),
+ checkButtonPressed);
+ // Turn on the LED
+ digitalWrite(ledPin, pressed);
+}
+
+A class of MIDIOutputElements that read the input of a momentary push button or switch,...Definition: Bankable/NoteButton.hpp:22
+A class that groups Bankable BankableMIDIOutputs and BankableMIDIInputs, and allows the user to chang...Definition: Bank.hpp:77
+
+
+void pinMode(pin_t pin, uint8_t mode)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:36
+
+
+Selector with two buttons (one to increment, one to decrement). This version displays the setting usi...Definition: SelectorLEDs.hpp:99
+
+
+
+The main header file that includes all Control-Surface header files.
+A class of MIDIOutputElements that read the analog input from a potentiometer or fader,...Definition: Bankable/CCPotentiometer.hpp:22
+
+Control_Surface_ & Control_SurfaceA predefined instance of the Control Surface to use in the Arduino sketches.Definition: Control_Surface_Class.cpp:174
+
+
+
+
+
+
+
+uint16_t pin_tThe type for Arduino pins (and ExtendedIOElement pins).Definition: Hardware-Types.hpp:17
+
+
+
+
+
+Names and values for all MIDI Control Change Controller Numbers.Definition: Control_Change.hpp:14
+
+
+
+
+
+
+void loop()Update all MIDI elements, send MIDI events and read MIDI input.Definition: Control_Surface_Class.cpp:48
+void digitalWrite(pin_t pin, uint8_t val)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:47
+
+
+Generated by
+
+ 1.8.16
+
+
Definition at line 113 of file Channel.hpp.
@@ -235,7 +235,7 @@
-Definition at line 114 of file Channel.hpp.
@@ -261,7 +261,7 @@
-
Definition at line 115 of file Channel.hpp.
@@ -287,7 +287,7 @@
-
Definition at line 116 of file Channel.hpp.
@@ -313,7 +313,7 @@
-
Definition at line 117 of file Channel.hpp.
@@ -339,7 +339,7 @@
-
Definition at line 118 of file Channel.hpp.
@@ -365,6 +365,8 @@
+
Definition at line 119 of file Channel.hpp.
@@ -389,6 +391,8 @@
+
Definition at line 120 of file Channel.hpp.
@@ -413,6 +417,8 @@
+
Definition at line 121 of file Channel.hpp.
@@ -437,6 +443,8 @@
+
Definition at line 122 of file Channel.hpp.
diff --git a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
index 9681bb19dc..49af66362f 100644
--- a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
+++ b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
@@ -184,7 +184,7 @@
A class of MIDIOutputElements that read the analog input from a potentiometer or fader, and send out 7-bit MIDI Control Change events.
The analog input is filtered and hysteresis is applied for maximum stability.
This version can be banked.
-
Definition at line 22 of file Bankable/CCPotentiometer.hpp.
diff --git a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
index 37e5e2644f..7d230859ca 100644
--- a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
+++ b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
@@ -75,7 +75,7 @@
There are some differences in MIDI over USB implementation between different types of Arduino-compatible boards.
-
+
Arduino boards with native USB support
Arduino Due, Arduino Zero, Arduino Leonardo, Arduino Micro, Arduino LilyPad USB ...
@@ -83,14 +83,14 @@
Some of the newer boards have native USB support (i.e. the USB connection goes directly to the main MCU) this means that they can pretend to be a USB MIDI device. This is based on PluggableUSB, using the MIDIUSB library.
All you have to do to get it working, is installing the library, and upload a sketch.
The computer will then automatically detect the Arduino as a MIDI device.
-
+
Teensy
Teensy 2.0, Teensy++ 2.0, Teensy LC, Teensy 3.0, Teensy 3.1, Teensy 3.2, Teensy 3.5, Teensy 3.6
Teensy boards have native USB support as well. You don't even need to install anything, because MIDI over USB is implemented in the Teensy Core.
You just need to select the 'MIDI' USB type from Tools > USB Type > MIDI.
-
+
Arduino boards with an ATmega16U2 (ATmega8U2)
Arduino Uno, Arduino Mega
@@ -113,7 +113,7 @@
Finally, when you know that everything is working fine, you can change the baud rate to the official MIDI baud rate of 31250, by using the default USBMIDI_Interface (don't explicitly instantiate any interfaces) uploading the sketch, and flashing the HIDUINO MIDI firmware using Flip or dfu-programmer.
You can now just plug it into your computer, and it will be recognized as a MIDI device, you don't need to run Hairless anymore.
-
+
Boards with a single-purpose USB-to-TTL chip
Arduino Nano, Arduino Duemilanove, Chinese Uno & Mega clones ...
@@ -122,7 +122,7 @@
While MIDI over USB is not supported on these boards, you can still use Hairless. Just instantiate a HairlessMIDI_Interface at the top of your sketch.
-
+
Conclusion
I strongly recommend getting a Teensy 3.x for building a Control Surface. MIDI over USB is supported right of the box, and it's the only platform that currently supports USB audio output. On top of that, it has plenty of memory to create large MIDI Controllers, and drive lots of displays.
If you just want a very small MIDI Controller, the Arduino Leonardo/Micro are good choices as well, just keep in mind that they don't have a lot of RAM.
diff --git a/docs/Doxygen/d8/da8/md_pages_Installation.html b/docs/Doxygen/d8/da8/md_pages_Installation.html
index 6cbe7e740e..8f6aec0a15 100644
--- a/docs/Doxygen/d8/da8/md_pages_Installation.html
+++ b/docs/Doxygen/d8/da8/md_pages_Installation.html
@@ -77,35 +77,35 @@
This document assumes that the Arduino IDE is already installed, as well as the necessary hardware support packages, such as Teensyduino or the ESP32 Core.
You have to install the Control Surface library itself, as well as some dependencies.
If you want to keep up to date with the latest developments, or if you want an easy way to update, the git install is recommended. Otherwise, you can use the no git install.
-
+
Installation (no git)
-
+
1. Download
Download the repository as a ZIP archive by going to the home page of the repository and click the green Clone or download button on the top right.
-
+
2. Install the Library in the Arduino IDE
Open the Arduino IDE, and go to the Sketch > Include Library > Add .ZIP Library menu.
Then navigate to your downloads directory where you just downloaded the library.
Select it, and click Ok.
-
+
Installation (git)
-
+
0. Install git
If you haven't already, install git from https://git-scm.com/downloads or use your system's package manager.
On Ubuntu and other Debian-based distros:
sudo apt install git
-
+
1. Browse to your Arduino Libraries folder
Open a terminal window and change the directory to your Arduino folder.
On Linux:
mkdir -p ~/Arduino/libraries && cd $_
-
+
2. Clone the Library
git clone https://github.com/tttapa/Control-Surface
-
+
3. Updating to the latest version
If you installed the library using git, you can easily update it when a new version comes out.
To update to the latest master version:
git pull
-
+
Dependencies
If you are using an Arduino board with on-board USB capabilities, you need the MIDIUSB library. Install it as explained before, or by using the Library Manager.
The Control Surface Library depends on the PJRC Encoder library for reading the input from rotary encoders. Download and install it if you plan on using those.
diff --git a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
index 715ebb83b5..dc99fb69c3 100644
--- a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
+++ b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
@@ -74,12 +74,12 @@
VU-Meter-Bridge.ino
-
+
VU-Meter-Bridge
This is an example on how to use an OLED display to display the VU meters and mute/solo states of the eight first tracks, by using the Arduino as a Mackie Control Universal. This is an example modified to work with the ESP32 only, using MIDI over Bluetooth Low Energy.
-
+
Connections
This example drives two SSD1306 OLED displays over SPI
Add a capacitor between the reset pin of the display and ground, and a resistor from reset to 3.3V. The values are not critical, 0.1µF and 10kΩ work fine.
You do need some way to reset the display, without it, it won't work.
Alternatively, you could use an IO pin from the ESP32 to reset the display, but this just "wastes" a pin.
-
+
Behavior
The first display should now display the level meters and mute/solo states of the first 8 tracks.
-
+
Mapping
Map "Control Surface" as a Mackie Control Universal unit in your DAW.
-
+
Demo
+
+
+
+
+MIDI_controller-97.ino
+
+
+
+MIDI_controller-97
+https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602
+Many bankable potentiometers and buttons.
+
+/**
+ * <https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602>
+ *
+ * Many bankable potentiometers and buttons.
+ *
+ * @boards Mega
+ */
+
+#include <Control_Surface.h>
+
+#include <AH/STL/algorithm> // std::any_of
+
+Bank<4> bank(16);
+
+// Create a new bank selector that changes the bank setting of the bank we just
+// created.
+// It has push buttons connected to pins 21 and 20 that increment or decrement
+// the bank setting, and 4 LEDs to pins 46, 48, 50, 52 that display the current
+// bank setting.
+IncrementDecrementSelectorLEDs<4> bankSelector = {
+ bank,
+ {21, 20}, // button pins
+ {46, 48, 50, 52}, // LED pins
+};
+
+using namespace MIDI_CC;
+Bankable::CCPotentiometer potentiometers[] = {
+
+
+
+
+
+
+
+
+
+
+
+
+};
+
+Bankable::NoteButton muteButtons[] = {
+ {bank, 13, 0x14},
+ {bank, 12, 0x15},
+ {bank, 11, 0x16},
+ {bank, 10, 0x17},
+ {bank, 9, 0x18},
+ {bank, 8, 0x19},
+ {bank, 7, 0x1A},
+ {bank, 6, 0x1B},
+ {bank, 5, 0x1C},
+ {bank, 4, 0x1D},
+ {bank, 3, 0x1E},
+ {bank, 2, 0x1F},
+ {bank, 14, 0x20},
+ {bank, 15, 0x21},
+ {bank, 16, 0x22},
+ {bank, 17, 0x23},
+ {bank, 18, {0x33, CHANNEL_2}},
+ {bank, 19, {0x34, CHANNEL_2}},
+};
+
+constexpr pin_t ledPin = 22;
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void setup() {
+
+
+}
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void loop() {
+
+
+ // Function that checks if a given button is pressed
+
+ return button.getButtonState() == Button::Pressed;
+ };
+ // If any of the push buttons is pressed
+ bool pressed = std::any_of(std::begin(muteButtons), std::end(muteButtons),
+ checkButtonPressed);
+ // Turn on the LED
+ digitalWrite(ledPin, pressed);
+}
+
+A class of MIDIOutputElements that read the input of a momentary push button or switch,...Definition: Bankable/NoteButton.hpp:22
+A class that groups Bankable BankableMIDIOutputs and BankableMIDIInputs, and allows the user to chang...Definition: Bank.hpp:77
+
+
+void pinMode(pin_t pin, uint8_t mode)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:36
+
+
+Selector with two buttons (one to increment, one to decrement). This version displays the setting usi...Definition: SelectorLEDs.hpp:99
+
+
+
+The main header file that includes all Control-Surface header files.
+A class of MIDIOutputElements that read the analog input from a potentiometer or fader,...Definition: Bankable/CCPotentiometer.hpp:22
+
+Control_Surface_ & Control_SurfaceA predefined instance of the Control Surface to use in the Arduino sketches.Definition: Control_Surface_Class.cpp:174
+
+
+
+
+
+
+
+uint16_t pin_tThe type for Arduino pins (and ExtendedIOElement pins).Definition: Hardware-Types.hpp:17
+
+
+
+
+
+Names and values for all MIDI Control Change Controller Numbers.Definition: Control_Change.hpp:14
+
+
+
+
+
+
+void loop()Update all MIDI elements, send MIDI events and read MIDI input.Definition: Control_Surface_Class.cpp:48
+void digitalWrite(pin_t pin, uint8_t val)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:47
+
+
+Generated by
+
+ 1.8.16
+
+
Definition at line 114 of file Channel.hpp.
@@ -261,7 +261,7 @@
-
Definition at line 115 of file Channel.hpp.
@@ -287,7 +287,7 @@
-
Definition at line 116 of file Channel.hpp.
@@ -313,7 +313,7 @@
-
Definition at line 117 of file Channel.hpp.
@@ -339,7 +339,7 @@
-
Definition at line 118 of file Channel.hpp.
@@ -365,6 +365,8 @@
+
Definition at line 119 of file Channel.hpp.
@@ -389,6 +391,8 @@
+
Definition at line 120 of file Channel.hpp.
@@ -413,6 +417,8 @@
+
Definition at line 121 of file Channel.hpp.
@@ -437,6 +443,8 @@
+
Definition at line 122 of file Channel.hpp.
diff --git a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
index 9681bb19dc..49af66362f 100644
--- a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
+++ b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
@@ -184,7 +184,7 @@
A class of MIDIOutputElements that read the analog input from a potentiometer or fader, and send out 7-bit MIDI Control Change events.
The analog input is filtered and hysteresis is applied for maximum stability.
This version can be banked.
-
Definition at line 22 of file Bankable/CCPotentiometer.hpp.
diff --git a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
index 37e5e2644f..7d230859ca 100644
--- a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
+++ b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
@@ -75,7 +75,7 @@
There are some differences in MIDI over USB implementation between different types of Arduino-compatible boards.
-
+
Arduino boards with native USB support
Arduino Due, Arduino Zero, Arduino Leonardo, Arduino Micro, Arduino LilyPad USB ...
@@ -83,14 +83,14 @@
Some of the newer boards have native USB support (i.e. the USB connection goes directly to the main MCU) this means that they can pretend to be a USB MIDI device. This is based on PluggableUSB, using the MIDIUSB library.
All you have to do to get it working, is installing the library, and upload a sketch.
The computer will then automatically detect the Arduino as a MIDI device.
-
+
Teensy
Teensy 2.0, Teensy++ 2.0, Teensy LC, Teensy 3.0, Teensy 3.1, Teensy 3.2, Teensy 3.5, Teensy 3.6
Teensy boards have native USB support as well. You don't even need to install anything, because MIDI over USB is implemented in the Teensy Core.
You just need to select the 'MIDI' USB type from Tools > USB Type > MIDI.
-
+
Arduino boards with an ATmega16U2 (ATmega8U2)
Arduino Uno, Arduino Mega
@@ -113,7 +113,7 @@
Finally, when you know that everything is working fine, you can change the baud rate to the official MIDI baud rate of 31250, by using the default USBMIDI_Interface (don't explicitly instantiate any interfaces) uploading the sketch, and flashing the HIDUINO MIDI firmware using Flip or dfu-programmer.
You can now just plug it into your computer, and it will be recognized as a MIDI device, you don't need to run Hairless anymore.
-
+
Boards with a single-purpose USB-to-TTL chip
Arduino Nano, Arduino Duemilanove, Chinese Uno & Mega clones ...
@@ -122,7 +122,7 @@
While MIDI over USB is not supported on these boards, you can still use Hairless. Just instantiate a HairlessMIDI_Interface at the top of your sketch.
-
+
Conclusion
I strongly recommend getting a Teensy 3.x for building a Control Surface. MIDI over USB is supported right of the box, and it's the only platform that currently supports USB audio output. On top of that, it has plenty of memory to create large MIDI Controllers, and drive lots of displays.
If you just want a very small MIDI Controller, the Arduino Leonardo/Micro are good choices as well, just keep in mind that they don't have a lot of RAM.
diff --git a/docs/Doxygen/d8/da8/md_pages_Installation.html b/docs/Doxygen/d8/da8/md_pages_Installation.html
index 6cbe7e740e..8f6aec0a15 100644
--- a/docs/Doxygen/d8/da8/md_pages_Installation.html
+++ b/docs/Doxygen/d8/da8/md_pages_Installation.html
@@ -77,35 +77,35 @@
This document assumes that the Arduino IDE is already installed, as well as the necessary hardware support packages, such as Teensyduino or the ESP32 Core.
You have to install the Control Surface library itself, as well as some dependencies.
If you want to keep up to date with the latest developments, or if you want an easy way to update, the git install is recommended. Otherwise, you can use the no git install.
-
+
Installation (no git)
-
+
1. Download
Download the repository as a ZIP archive by going to the home page of the repository and click the green Clone or download button on the top right.
-
+
2. Install the Library in the Arduino IDE
Open the Arduino IDE, and go to the Sketch > Include Library > Add .ZIP Library menu.
Then navigate to your downloads directory where you just downloaded the library.
Select it, and click Ok.
-
+
Installation (git)
-
+
0. Install git
If you haven't already, install git from https://git-scm.com/downloads or use your system's package manager.
On Ubuntu and other Debian-based distros:
sudo apt install git
-
+
1. Browse to your Arduino Libraries folder
Open a terminal window and change the directory to your Arduino folder.
On Linux:
mkdir -p ~/Arduino/libraries && cd $_
-
+
2. Clone the Library
git clone https://github.com/tttapa/Control-Surface
-
+
3. Updating to the latest version
If you installed the library using git, you can easily update it when a new version comes out.
To update to the latest master version:
git pull
-
+
Dependencies
If you are using an Arduino board with on-board USB capabilities, you need the MIDIUSB library. Install it as explained before, or by using the Library Manager.
The Control Surface Library depends on the PJRC Encoder library for reading the input from rotary encoders. Download and install it if you plan on using those.
diff --git a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
index 715ebb83b5..dc99fb69c3 100644
--- a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
+++ b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
@@ -74,12 +74,12 @@
VU-Meter-Bridge.ino
-
+
VU-Meter-Bridge
This is an example on how to use an OLED display to display the VU meters and mute/solo states of the eight first tracks, by using the Arduino as a Mackie Control Universal. This is an example modified to work with the ESP32 only, using MIDI over Bluetooth Low Energy.
-
+
Connections
This example drives two SSD1306 OLED displays over SPI
Add a capacitor between the reset pin of the display and ground, and a resistor from reset to 3.3V. The values are not critical, 0.1µF and 10kΩ work fine.
You do need some way to reset the display, without it, it won't work.
Alternatively, you could use an IO pin from the ESP32 to reset the display, but this just "wastes" a pin.
-
+
Behavior
The first display should now display the level meters and mute/solo states of the first 8 tracks.
-
+
Mapping
Map "Control Surface" as a Mackie Control Universal unit in your DAW.
-
+
Demo
+
+
+
+
+MIDI_controller-97.ino
+
+
+
+MIDI_controller-97
+https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602
+Many bankable potentiometers and buttons.
+
+/**
+ * <https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602>
+ *
+ * Many bankable potentiometers and buttons.
+ *
+ * @boards Mega
+ */
+
+#include <Control_Surface.h>
+
+#include <AH/STL/algorithm> // std::any_of
+
+Bank<4> bank(16);
+
+// Create a new bank selector that changes the bank setting of the bank we just
+// created.
+// It has push buttons connected to pins 21 and 20 that increment or decrement
+// the bank setting, and 4 LEDs to pins 46, 48, 50, 52 that display the current
+// bank setting.
+IncrementDecrementSelectorLEDs<4> bankSelector = {
+ bank,
+ {21, 20}, // button pins
+ {46, 48, 50, 52}, // LED pins
+};
+
+using namespace MIDI_CC;
+Bankable::CCPotentiometer potentiometers[] = {
+
+
+
+
+
+
+
+
+
+
+
+
+};
+
+Bankable::NoteButton muteButtons[] = {
+ {bank, 13, 0x14},
+ {bank, 12, 0x15},
+ {bank, 11, 0x16},
+ {bank, 10, 0x17},
+ {bank, 9, 0x18},
+ {bank, 8, 0x19},
+ {bank, 7, 0x1A},
+ {bank, 6, 0x1B},
+ {bank, 5, 0x1C},
+ {bank, 4, 0x1D},
+ {bank, 3, 0x1E},
+ {bank, 2, 0x1F},
+ {bank, 14, 0x20},
+ {bank, 15, 0x21},
+ {bank, 16, 0x22},
+ {bank, 17, 0x23},
+ {bank, 18, {0x33, CHANNEL_2}},
+ {bank, 19, {0x34, CHANNEL_2}},
+};
+
+constexpr pin_t ledPin = 22;
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void setup() {
+
+
+}
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void loop() {
+
+
+ // Function that checks if a given button is pressed
+
+ return button.getButtonState() == Button::Pressed;
+ };
+ // If any of the push buttons is pressed
+ bool pressed = std::any_of(std::begin(muteButtons), std::end(muteButtons),
+ checkButtonPressed);
+ // Turn on the LED
+ digitalWrite(ledPin, pressed);
+}
+
+A class of MIDIOutputElements that read the input of a momentary push button or switch,...Definition: Bankable/NoteButton.hpp:22
+A class that groups Bankable BankableMIDIOutputs and BankableMIDIInputs, and allows the user to chang...Definition: Bank.hpp:77
+
+
+void pinMode(pin_t pin, uint8_t mode)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:36
+
+
+Selector with two buttons (one to increment, one to decrement). This version displays the setting usi...Definition: SelectorLEDs.hpp:99
+
+
+
+The main header file that includes all Control-Surface header files.
+A class of MIDIOutputElements that read the analog input from a potentiometer or fader,...Definition: Bankable/CCPotentiometer.hpp:22
+
+Control_Surface_ & Control_SurfaceA predefined instance of the Control Surface to use in the Arduino sketches.Definition: Control_Surface_Class.cpp:174
+
+
+
+
+
+
+
+uint16_t pin_tThe type for Arduino pins (and ExtendedIOElement pins).Definition: Hardware-Types.hpp:17
+
+
+
+
+
+Names and values for all MIDI Control Change Controller Numbers.Definition: Control_Change.hpp:14
+
+
+
+
+
+
+void loop()Update all MIDI elements, send MIDI events and read MIDI input.Definition: Control_Surface_Class.cpp:48
+void digitalWrite(pin_t pin, uint8_t val)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:47
+
+
+Generated by
+
+ 1.8.16
+
+
Definition at line 115 of file Channel.hpp.
@@ -287,7 +287,7 @@
-
Definition at line 116 of file Channel.hpp.
@@ -313,7 +313,7 @@
-
Definition at line 117 of file Channel.hpp.
@@ -339,7 +339,7 @@
-
Definition at line 118 of file Channel.hpp.
@@ -365,6 +365,8 @@
+
Definition at line 119 of file Channel.hpp.
@@ -389,6 +391,8 @@
+
Definition at line 120 of file Channel.hpp.
@@ -413,6 +417,8 @@
+
Definition at line 121 of file Channel.hpp.
@@ -437,6 +443,8 @@
+
Definition at line 122 of file Channel.hpp.
diff --git a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
index 9681bb19dc..49af66362f 100644
--- a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
+++ b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
@@ -184,7 +184,7 @@
A class of MIDIOutputElements that read the analog input from a potentiometer or fader, and send out 7-bit MIDI Control Change events.
The analog input is filtered and hysteresis is applied for maximum stability.
This version can be banked.
-
Definition at line 22 of file Bankable/CCPotentiometer.hpp.
diff --git a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
index 37e5e2644f..7d230859ca 100644
--- a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
+++ b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
@@ -75,7 +75,7 @@
There are some differences in MIDI over USB implementation between different types of Arduino-compatible boards.
-
+
Arduino boards with native USB support
Arduino Due, Arduino Zero, Arduino Leonardo, Arduino Micro, Arduino LilyPad USB ...
@@ -83,14 +83,14 @@
Some of the newer boards have native USB support (i.e. the USB connection goes directly to the main MCU) this means that they can pretend to be a USB MIDI device. This is based on PluggableUSB, using the MIDIUSB library.
All you have to do to get it working, is installing the library, and upload a sketch.
The computer will then automatically detect the Arduino as a MIDI device.
-
+
Teensy
Teensy 2.0, Teensy++ 2.0, Teensy LC, Teensy 3.0, Teensy 3.1, Teensy 3.2, Teensy 3.5, Teensy 3.6
Teensy boards have native USB support as well. You don't even need to install anything, because MIDI over USB is implemented in the Teensy Core.
You just need to select the 'MIDI' USB type from Tools > USB Type > MIDI.
-
+
Arduino boards with an ATmega16U2 (ATmega8U2)
Arduino Uno, Arduino Mega
@@ -113,7 +113,7 @@
Finally, when you know that everything is working fine, you can change the baud rate to the official MIDI baud rate of 31250, by using the default USBMIDI_Interface (don't explicitly instantiate any interfaces) uploading the sketch, and flashing the HIDUINO MIDI firmware using Flip or dfu-programmer.
You can now just plug it into your computer, and it will be recognized as a MIDI device, you don't need to run Hairless anymore.
-
+
Boards with a single-purpose USB-to-TTL chip
Arduino Nano, Arduino Duemilanove, Chinese Uno & Mega clones ...
@@ -122,7 +122,7 @@
While MIDI over USB is not supported on these boards, you can still use Hairless. Just instantiate a HairlessMIDI_Interface at the top of your sketch.
-
+
Conclusion
I strongly recommend getting a Teensy 3.x for building a Control Surface. MIDI over USB is supported right of the box, and it's the only platform that currently supports USB audio output. On top of that, it has plenty of memory to create large MIDI Controllers, and drive lots of displays.
If you just want a very small MIDI Controller, the Arduino Leonardo/Micro are good choices as well, just keep in mind that they don't have a lot of RAM.
diff --git a/docs/Doxygen/d8/da8/md_pages_Installation.html b/docs/Doxygen/d8/da8/md_pages_Installation.html
index 6cbe7e740e..8f6aec0a15 100644
--- a/docs/Doxygen/d8/da8/md_pages_Installation.html
+++ b/docs/Doxygen/d8/da8/md_pages_Installation.html
@@ -77,35 +77,35 @@
This document assumes that the Arduino IDE is already installed, as well as the necessary hardware support packages, such as Teensyduino or the ESP32 Core.
You have to install the Control Surface library itself, as well as some dependencies.
If you want to keep up to date with the latest developments, or if you want an easy way to update, the git install is recommended. Otherwise, you can use the no git install.
-
+
Installation (no git)
-
+
1. Download
Download the repository as a ZIP archive by going to the home page of the repository and click the green Clone or download button on the top right.
-
+
2. Install the Library in the Arduino IDE
Open the Arduino IDE, and go to the Sketch > Include Library > Add .ZIP Library menu.
Then navigate to your downloads directory where you just downloaded the library.
Select it, and click Ok.
-
+
Installation (git)
-
+
0. Install git
If you haven't already, install git from https://git-scm.com/downloads or use your system's package manager.
On Ubuntu and other Debian-based distros:
sudo apt install git
-
+
1. Browse to your Arduino Libraries folder
Open a terminal window and change the directory to your Arduino folder.
On Linux:
mkdir -p ~/Arduino/libraries && cd $_
-
+
2. Clone the Library
git clone https://github.com/tttapa/Control-Surface
-
+
3. Updating to the latest version
If you installed the library using git, you can easily update it when a new version comes out.
To update to the latest master version:
git pull
-
+
Dependencies
If you are using an Arduino board with on-board USB capabilities, you need the MIDIUSB library. Install it as explained before, or by using the Library Manager.
The Control Surface Library depends on the PJRC Encoder library for reading the input from rotary encoders. Download and install it if you plan on using those.
diff --git a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
index 715ebb83b5..dc99fb69c3 100644
--- a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
+++ b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
@@ -74,12 +74,12 @@
VU-Meter-Bridge.ino
-
+
VU-Meter-Bridge
This is an example on how to use an OLED display to display the VU meters and mute/solo states of the eight first tracks, by using the Arduino as a Mackie Control Universal. This is an example modified to work with the ESP32 only, using MIDI over Bluetooth Low Energy.
-
+
Connections
This example drives two SSD1306 OLED displays over SPI
Add a capacitor between the reset pin of the display and ground, and a resistor from reset to 3.3V. The values are not critical, 0.1µF and 10kΩ work fine.
You do need some way to reset the display, without it, it won't work.
Alternatively, you could use an IO pin from the ESP32 to reset the display, but this just "wastes" a pin.
-
+
Behavior
The first display should now display the level meters and mute/solo states of the first 8 tracks.
-
+
Mapping
Map "Control Surface" as a Mackie Control Universal unit in your DAW.
-
+
Demo
+
+
+
+
+MIDI_controller-97.ino
+
+
+
+MIDI_controller-97
+https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602
+Many bankable potentiometers and buttons.
+
+/**
+ * <https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602>
+ *
+ * Many bankable potentiometers and buttons.
+ *
+ * @boards Mega
+ */
+
+#include <Control_Surface.h>
+
+#include <AH/STL/algorithm> // std::any_of
+
+Bank<4> bank(16);
+
+// Create a new bank selector that changes the bank setting of the bank we just
+// created.
+// It has push buttons connected to pins 21 and 20 that increment or decrement
+// the bank setting, and 4 LEDs to pins 46, 48, 50, 52 that display the current
+// bank setting.
+IncrementDecrementSelectorLEDs<4> bankSelector = {
+ bank,
+ {21, 20}, // button pins
+ {46, 48, 50, 52}, // LED pins
+};
+
+using namespace MIDI_CC;
+Bankable::CCPotentiometer potentiometers[] = {
+
+
+
+
+
+
+
+
+
+
+
+
+};
+
+Bankable::NoteButton muteButtons[] = {
+ {bank, 13, 0x14},
+ {bank, 12, 0x15},
+ {bank, 11, 0x16},
+ {bank, 10, 0x17},
+ {bank, 9, 0x18},
+ {bank, 8, 0x19},
+ {bank, 7, 0x1A},
+ {bank, 6, 0x1B},
+ {bank, 5, 0x1C},
+ {bank, 4, 0x1D},
+ {bank, 3, 0x1E},
+ {bank, 2, 0x1F},
+ {bank, 14, 0x20},
+ {bank, 15, 0x21},
+ {bank, 16, 0x22},
+ {bank, 17, 0x23},
+ {bank, 18, {0x33, CHANNEL_2}},
+ {bank, 19, {0x34, CHANNEL_2}},
+};
+
+constexpr pin_t ledPin = 22;
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void setup() {
+
+
+}
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void loop() {
+
+
+ // Function that checks if a given button is pressed
+
+ return button.getButtonState() == Button::Pressed;
+ };
+ // If any of the push buttons is pressed
+ bool pressed = std::any_of(std::begin(muteButtons), std::end(muteButtons),
+ checkButtonPressed);
+ // Turn on the LED
+ digitalWrite(ledPin, pressed);
+}
+
+A class of MIDIOutputElements that read the input of a momentary push button or switch,...Definition: Bankable/NoteButton.hpp:22
+A class that groups Bankable BankableMIDIOutputs and BankableMIDIInputs, and allows the user to chang...Definition: Bank.hpp:77
+
+
+void pinMode(pin_t pin, uint8_t mode)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:36
+
+
+Selector with two buttons (one to increment, one to decrement). This version displays the setting usi...Definition: SelectorLEDs.hpp:99
+
+
+
+The main header file that includes all Control-Surface header files.
+A class of MIDIOutputElements that read the analog input from a potentiometer or fader,...Definition: Bankable/CCPotentiometer.hpp:22
+
+Control_Surface_ & Control_SurfaceA predefined instance of the Control Surface to use in the Arduino sketches.Definition: Control_Surface_Class.cpp:174
+
+
+
+
+
+
+
+uint16_t pin_tThe type for Arduino pins (and ExtendedIOElement pins).Definition: Hardware-Types.hpp:17
+
+
+
+
+
+Names and values for all MIDI Control Change Controller Numbers.Definition: Control_Change.hpp:14
+
+
+
+
+
+
+void loop()Update all MIDI elements, send MIDI events and read MIDI input.Definition: Control_Surface_Class.cpp:48
+void digitalWrite(pin_t pin, uint8_t val)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:47
+
+
+Generated by
+
+ 1.8.16
+
+
Definition at line 116 of file Channel.hpp.
@@ -313,7 +313,7 @@
-
Definition at line 117 of file Channel.hpp.
@@ -339,7 +339,7 @@
-
Definition at line 118 of file Channel.hpp.
@@ -365,6 +365,8 @@
+
Definition at line 119 of file Channel.hpp.
@@ -389,6 +391,8 @@
+
Definition at line 120 of file Channel.hpp.
@@ -413,6 +417,8 @@
+
Definition at line 121 of file Channel.hpp.
@@ -437,6 +443,8 @@
+
Definition at line 122 of file Channel.hpp.
diff --git a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
index 9681bb19dc..49af66362f 100644
--- a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
+++ b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
@@ -184,7 +184,7 @@
A class of MIDIOutputElements that read the analog input from a potentiometer or fader, and send out 7-bit MIDI Control Change events.
The analog input is filtered and hysteresis is applied for maximum stability.
This version can be banked.
-
Definition at line 22 of file Bankable/CCPotentiometer.hpp.
diff --git a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
index 37e5e2644f..7d230859ca 100644
--- a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
+++ b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
@@ -75,7 +75,7 @@
There are some differences in MIDI over USB implementation between different types of Arduino-compatible boards.
-
+
Arduino boards with native USB support
Arduino Due, Arduino Zero, Arduino Leonardo, Arduino Micro, Arduino LilyPad USB ...
@@ -83,14 +83,14 @@
Some of the newer boards have native USB support (i.e. the USB connection goes directly to the main MCU) this means that they can pretend to be a USB MIDI device. This is based on PluggableUSB, using the MIDIUSB library.
All you have to do to get it working, is installing the library, and upload a sketch.
The computer will then automatically detect the Arduino as a MIDI device.
-
+
Teensy
Teensy 2.0, Teensy++ 2.0, Teensy LC, Teensy 3.0, Teensy 3.1, Teensy 3.2, Teensy 3.5, Teensy 3.6
Teensy boards have native USB support as well. You don't even need to install anything, because MIDI over USB is implemented in the Teensy Core.
You just need to select the 'MIDI' USB type from Tools > USB Type > MIDI.
-
+
Arduino boards with an ATmega16U2 (ATmega8U2)
Arduino Uno, Arduino Mega
@@ -113,7 +113,7 @@
Finally, when you know that everything is working fine, you can change the baud rate to the official MIDI baud rate of 31250, by using the default USBMIDI_Interface (don't explicitly instantiate any interfaces) uploading the sketch, and flashing the HIDUINO MIDI firmware using Flip or dfu-programmer.
You can now just plug it into your computer, and it will be recognized as a MIDI device, you don't need to run Hairless anymore.
-
+
Boards with a single-purpose USB-to-TTL chip
Arduino Nano, Arduino Duemilanove, Chinese Uno & Mega clones ...
@@ -122,7 +122,7 @@
While MIDI over USB is not supported on these boards, you can still use Hairless. Just instantiate a HairlessMIDI_Interface at the top of your sketch.
-
+
Conclusion
I strongly recommend getting a Teensy 3.x for building a Control Surface. MIDI over USB is supported right of the box, and it's the only platform that currently supports USB audio output. On top of that, it has plenty of memory to create large MIDI Controllers, and drive lots of displays.
If you just want a very small MIDI Controller, the Arduino Leonardo/Micro are good choices as well, just keep in mind that they don't have a lot of RAM.
diff --git a/docs/Doxygen/d8/da8/md_pages_Installation.html b/docs/Doxygen/d8/da8/md_pages_Installation.html
index 6cbe7e740e..8f6aec0a15 100644
--- a/docs/Doxygen/d8/da8/md_pages_Installation.html
+++ b/docs/Doxygen/d8/da8/md_pages_Installation.html
@@ -77,35 +77,35 @@
This document assumes that the Arduino IDE is already installed, as well as the necessary hardware support packages, such as Teensyduino or the ESP32 Core.
You have to install the Control Surface library itself, as well as some dependencies.
If you want to keep up to date with the latest developments, or if you want an easy way to update, the git install is recommended. Otherwise, you can use the no git install.
-
+
Installation (no git)
-
+
1. Download
Download the repository as a ZIP archive by going to the home page of the repository and click the green Clone or download button on the top right.
-
+
2. Install the Library in the Arduino IDE
Open the Arduino IDE, and go to the Sketch > Include Library > Add .ZIP Library menu.
Then navigate to your downloads directory where you just downloaded the library.
Select it, and click Ok.
-
+
Installation (git)
-
+
0. Install git
If you haven't already, install git from https://git-scm.com/downloads or use your system's package manager.
On Ubuntu and other Debian-based distros:
sudo apt install git
-
+
1. Browse to your Arduino Libraries folder
Open a terminal window and change the directory to your Arduino folder.
On Linux:
mkdir -p ~/Arduino/libraries && cd $_
-
+
2. Clone the Library
git clone https://github.com/tttapa/Control-Surface
-
+
3. Updating to the latest version
If you installed the library using git, you can easily update it when a new version comes out.
To update to the latest master version:
git pull
-
+
Dependencies
If you are using an Arduino board with on-board USB capabilities, you need the MIDIUSB library. Install it as explained before, or by using the Library Manager.
The Control Surface Library depends on the PJRC Encoder library for reading the input from rotary encoders. Download and install it if you plan on using those.
diff --git a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
index 715ebb83b5..dc99fb69c3 100644
--- a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
+++ b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
@@ -74,12 +74,12 @@
VU-Meter-Bridge.ino
-
+
VU-Meter-Bridge
This is an example on how to use an OLED display to display the VU meters and mute/solo states of the eight first tracks, by using the Arduino as a Mackie Control Universal. This is an example modified to work with the ESP32 only, using MIDI over Bluetooth Low Energy.
-
+
Connections
This example drives two SSD1306 OLED displays over SPI
Add a capacitor between the reset pin of the display and ground, and a resistor from reset to 3.3V. The values are not critical, 0.1µF and 10kΩ work fine.
You do need some way to reset the display, without it, it won't work.
Alternatively, you could use an IO pin from the ESP32 to reset the display, but this just "wastes" a pin.
-
+
Behavior
The first display should now display the level meters and mute/solo states of the first 8 tracks.
-
+
Mapping
Map "Control Surface" as a Mackie Control Universal unit in your DAW.
-
+
Demo
+
+
+
+
+MIDI_controller-97.ino
+
+
+
+MIDI_controller-97
+https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602
+Many bankable potentiometers and buttons.
+
+/**
+ * <https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602>
+ *
+ * Many bankable potentiometers and buttons.
+ *
+ * @boards Mega
+ */
+
+#include <Control_Surface.h>
+
+#include <AH/STL/algorithm> // std::any_of
+
+Bank<4> bank(16);
+
+// Create a new bank selector that changes the bank setting of the bank we just
+// created.
+// It has push buttons connected to pins 21 and 20 that increment or decrement
+// the bank setting, and 4 LEDs to pins 46, 48, 50, 52 that display the current
+// bank setting.
+IncrementDecrementSelectorLEDs<4> bankSelector = {
+ bank,
+ {21, 20}, // button pins
+ {46, 48, 50, 52}, // LED pins
+};
+
+using namespace MIDI_CC;
+Bankable::CCPotentiometer potentiometers[] = {
+
+
+
+
+
+
+
+
+
+
+
+
+};
+
+Bankable::NoteButton muteButtons[] = {
+ {bank, 13, 0x14},
+ {bank, 12, 0x15},
+ {bank, 11, 0x16},
+ {bank, 10, 0x17},
+ {bank, 9, 0x18},
+ {bank, 8, 0x19},
+ {bank, 7, 0x1A},
+ {bank, 6, 0x1B},
+ {bank, 5, 0x1C},
+ {bank, 4, 0x1D},
+ {bank, 3, 0x1E},
+ {bank, 2, 0x1F},
+ {bank, 14, 0x20},
+ {bank, 15, 0x21},
+ {bank, 16, 0x22},
+ {bank, 17, 0x23},
+ {bank, 18, {0x33, CHANNEL_2}},
+ {bank, 19, {0x34, CHANNEL_2}},
+};
+
+constexpr pin_t ledPin = 22;
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void setup() {
+
+
+}
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void loop() {
+
+
+ // Function that checks if a given button is pressed
+
+ return button.getButtonState() == Button::Pressed;
+ };
+ // If any of the push buttons is pressed
+ bool pressed = std::any_of(std::begin(muteButtons), std::end(muteButtons),
+ checkButtonPressed);
+ // Turn on the LED
+ digitalWrite(ledPin, pressed);
+}
+
+A class of MIDIOutputElements that read the input of a momentary push button or switch,...Definition: Bankable/NoteButton.hpp:22
+A class that groups Bankable BankableMIDIOutputs and BankableMIDIInputs, and allows the user to chang...Definition: Bank.hpp:77
+
+
+void pinMode(pin_t pin, uint8_t mode)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:36
+
+
+Selector with two buttons (one to increment, one to decrement). This version displays the setting usi...Definition: SelectorLEDs.hpp:99
+
+
+
+The main header file that includes all Control-Surface header files.
+A class of MIDIOutputElements that read the analog input from a potentiometer or fader,...Definition: Bankable/CCPotentiometer.hpp:22
+
+Control_Surface_ & Control_SurfaceA predefined instance of the Control Surface to use in the Arduino sketches.Definition: Control_Surface_Class.cpp:174
+
+
+
+
+
+
+
+uint16_t pin_tThe type for Arduino pins (and ExtendedIOElement pins).Definition: Hardware-Types.hpp:17
+
+
+
+
+
+Names and values for all MIDI Control Change Controller Numbers.Definition: Control_Change.hpp:14
+
+
+
+
+
+
+void loop()Update all MIDI elements, send MIDI events and read MIDI input.Definition: Control_Surface_Class.cpp:48
+void digitalWrite(pin_t pin, uint8_t val)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:47
+
+
+Generated by
+
+ 1.8.16
+
+
Definition at line 117 of file Channel.hpp.
@@ -339,7 +339,7 @@
-
Definition at line 118 of file Channel.hpp.
@@ -365,6 +365,8 @@
+
Definition at line 119 of file Channel.hpp.
@@ -389,6 +391,8 @@
+
Definition at line 120 of file Channel.hpp.
@@ -413,6 +417,8 @@
+
Definition at line 121 of file Channel.hpp.
@@ -437,6 +443,8 @@
+
Definition at line 122 of file Channel.hpp.
diff --git a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
index 9681bb19dc..49af66362f 100644
--- a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
+++ b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
@@ -184,7 +184,7 @@
A class of MIDIOutputElements that read the analog input from a potentiometer or fader, and send out 7-bit MIDI Control Change events.
The analog input is filtered and hysteresis is applied for maximum stability.
This version can be banked.
-
Definition at line 22 of file Bankable/CCPotentiometer.hpp.
diff --git a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
index 37e5e2644f..7d230859ca 100644
--- a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
+++ b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
@@ -75,7 +75,7 @@
There are some differences in MIDI over USB implementation between different types of Arduino-compatible boards.
-
+
Arduino boards with native USB support
Arduino Due, Arduino Zero, Arduino Leonardo, Arduino Micro, Arduino LilyPad USB ...
@@ -83,14 +83,14 @@
Some of the newer boards have native USB support (i.e. the USB connection goes directly to the main MCU) this means that they can pretend to be a USB MIDI device. This is based on PluggableUSB, using the MIDIUSB library.
All you have to do to get it working, is installing the library, and upload a sketch.
The computer will then automatically detect the Arduino as a MIDI device.
-
+
Teensy
Teensy 2.0, Teensy++ 2.0, Teensy LC, Teensy 3.0, Teensy 3.1, Teensy 3.2, Teensy 3.5, Teensy 3.6
Teensy boards have native USB support as well. You don't even need to install anything, because MIDI over USB is implemented in the Teensy Core.
You just need to select the 'MIDI' USB type from Tools > USB Type > MIDI.
-
+
Arduino boards with an ATmega16U2 (ATmega8U2)
Arduino Uno, Arduino Mega
@@ -113,7 +113,7 @@
Finally, when you know that everything is working fine, you can change the baud rate to the official MIDI baud rate of 31250, by using the default USBMIDI_Interface (don't explicitly instantiate any interfaces) uploading the sketch, and flashing the HIDUINO MIDI firmware using Flip or dfu-programmer.
You can now just plug it into your computer, and it will be recognized as a MIDI device, you don't need to run Hairless anymore.
-
+
Boards with a single-purpose USB-to-TTL chip
Arduino Nano, Arduino Duemilanove, Chinese Uno & Mega clones ...
@@ -122,7 +122,7 @@
While MIDI over USB is not supported on these boards, you can still use Hairless. Just instantiate a HairlessMIDI_Interface at the top of your sketch.
-
+
Conclusion
I strongly recommend getting a Teensy 3.x for building a Control Surface. MIDI over USB is supported right of the box, and it's the only platform that currently supports USB audio output. On top of that, it has plenty of memory to create large MIDI Controllers, and drive lots of displays.
If you just want a very small MIDI Controller, the Arduino Leonardo/Micro are good choices as well, just keep in mind that they don't have a lot of RAM.
diff --git a/docs/Doxygen/d8/da8/md_pages_Installation.html b/docs/Doxygen/d8/da8/md_pages_Installation.html
index 6cbe7e740e..8f6aec0a15 100644
--- a/docs/Doxygen/d8/da8/md_pages_Installation.html
+++ b/docs/Doxygen/d8/da8/md_pages_Installation.html
@@ -77,35 +77,35 @@
This document assumes that the Arduino IDE is already installed, as well as the necessary hardware support packages, such as Teensyduino or the ESP32 Core.
You have to install the Control Surface library itself, as well as some dependencies.
If you want to keep up to date with the latest developments, or if you want an easy way to update, the git install is recommended. Otherwise, you can use the no git install.
-
+
Installation (no git)
-
+
1. Download
Download the repository as a ZIP archive by going to the home page of the repository and click the green Clone or download button on the top right.
-
+
2. Install the Library in the Arduino IDE
Open the Arduino IDE, and go to the Sketch > Include Library > Add .ZIP Library menu.
Then navigate to your downloads directory where you just downloaded the library.
Select it, and click Ok.
-
+
Installation (git)
-
+
0. Install git
If you haven't already, install git from https://git-scm.com/downloads or use your system's package manager.
On Ubuntu and other Debian-based distros:
sudo apt install git
-
+
1. Browse to your Arduino Libraries folder
Open a terminal window and change the directory to your Arduino folder.
On Linux:
mkdir -p ~/Arduino/libraries && cd $_
-
+
2. Clone the Library
git clone https://github.com/tttapa/Control-Surface
-
+
3. Updating to the latest version
If you installed the library using git, you can easily update it when a new version comes out.
To update to the latest master version:
git pull
-
+
Dependencies
If you are using an Arduino board with on-board USB capabilities, you need the MIDIUSB library. Install it as explained before, or by using the Library Manager.
The Control Surface Library depends on the PJRC Encoder library for reading the input from rotary encoders. Download and install it if you plan on using those.
diff --git a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
index 715ebb83b5..dc99fb69c3 100644
--- a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
+++ b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
@@ -74,12 +74,12 @@
VU-Meter-Bridge.ino
-
+
VU-Meter-Bridge
This is an example on how to use an OLED display to display the VU meters and mute/solo states of the eight first tracks, by using the Arduino as a Mackie Control Universal. This is an example modified to work with the ESP32 only, using MIDI over Bluetooth Low Energy.
-
+
Connections
This example drives two SSD1306 OLED displays over SPI
Add a capacitor between the reset pin of the display and ground, and a resistor from reset to 3.3V. The values are not critical, 0.1µF and 10kΩ work fine.
You do need some way to reset the display, without it, it won't work.
Alternatively, you could use an IO pin from the ESP32 to reset the display, but this just "wastes" a pin.
-
+
Behavior
The first display should now display the level meters and mute/solo states of the first 8 tracks.
-
+
Mapping
Map "Control Surface" as a Mackie Control Universal unit in your DAW.
-
+
Demo
+
+
+
+
+MIDI_controller-97.ino
+
+
+
+MIDI_controller-97
+https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602
+Many bankable potentiometers and buttons.
+
+/**
+ * <https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602>
+ *
+ * Many bankable potentiometers and buttons.
+ *
+ * @boards Mega
+ */
+
+#include <Control_Surface.h>
+
+#include <AH/STL/algorithm> // std::any_of
+
+Bank<4> bank(16);
+
+// Create a new bank selector that changes the bank setting of the bank we just
+// created.
+// It has push buttons connected to pins 21 and 20 that increment or decrement
+// the bank setting, and 4 LEDs to pins 46, 48, 50, 52 that display the current
+// bank setting.
+IncrementDecrementSelectorLEDs<4> bankSelector = {
+ bank,
+ {21, 20}, // button pins
+ {46, 48, 50, 52}, // LED pins
+};
+
+using namespace MIDI_CC;
+Bankable::CCPotentiometer potentiometers[] = {
+
+
+
+
+
+
+
+
+
+
+
+
+};
+
+Bankable::NoteButton muteButtons[] = {
+ {bank, 13, 0x14},
+ {bank, 12, 0x15},
+ {bank, 11, 0x16},
+ {bank, 10, 0x17},
+ {bank, 9, 0x18},
+ {bank, 8, 0x19},
+ {bank, 7, 0x1A},
+ {bank, 6, 0x1B},
+ {bank, 5, 0x1C},
+ {bank, 4, 0x1D},
+ {bank, 3, 0x1E},
+ {bank, 2, 0x1F},
+ {bank, 14, 0x20},
+ {bank, 15, 0x21},
+ {bank, 16, 0x22},
+ {bank, 17, 0x23},
+ {bank, 18, {0x33, CHANNEL_2}},
+ {bank, 19, {0x34, CHANNEL_2}},
+};
+
+constexpr pin_t ledPin = 22;
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void setup() {
+
+
+}
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void loop() {
+
+
+ // Function that checks if a given button is pressed
+
+ return button.getButtonState() == Button::Pressed;
+ };
+ // If any of the push buttons is pressed
+ bool pressed = std::any_of(std::begin(muteButtons), std::end(muteButtons),
+ checkButtonPressed);
+ // Turn on the LED
+ digitalWrite(ledPin, pressed);
+}
+
+A class of MIDIOutputElements that read the input of a momentary push button or switch,...Definition: Bankable/NoteButton.hpp:22
+A class that groups Bankable BankableMIDIOutputs and BankableMIDIInputs, and allows the user to chang...Definition: Bank.hpp:77
+
+
+void pinMode(pin_t pin, uint8_t mode)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:36
+
+
+Selector with two buttons (one to increment, one to decrement). This version displays the setting usi...Definition: SelectorLEDs.hpp:99
+
+
+
+The main header file that includes all Control-Surface header files.
+A class of MIDIOutputElements that read the analog input from a potentiometer or fader,...Definition: Bankable/CCPotentiometer.hpp:22
+
+Control_Surface_ & Control_SurfaceA predefined instance of the Control Surface to use in the Arduino sketches.Definition: Control_Surface_Class.cpp:174
+
+
+
+
+
+
+
+uint16_t pin_tThe type for Arduino pins (and ExtendedIOElement pins).Definition: Hardware-Types.hpp:17
+
+
+
+
+
+Names and values for all MIDI Control Change Controller Numbers.Definition: Control_Change.hpp:14
+
+
+
+
+
+
+void loop()Update all MIDI elements, send MIDI events and read MIDI input.Definition: Control_Surface_Class.cpp:48
+void digitalWrite(pin_t pin, uint8_t val)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:47
+
+
+Generated by
+
+ 1.8.16
+
+
Definition at line 118 of file Channel.hpp.
@@ -365,6 +365,8 @@
+
Definition at line 119 of file Channel.hpp.
@@ -389,6 +391,8 @@
+
Definition at line 120 of file Channel.hpp.
@@ -413,6 +417,8 @@
+
Definition at line 121 of file Channel.hpp.
@@ -437,6 +443,8 @@
+
Definition at line 122 of file Channel.hpp.
diff --git a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
index 9681bb19dc..49af66362f 100644
--- a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
+++ b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
@@ -184,7 +184,7 @@
A class of MIDIOutputElements that read the analog input from a potentiometer or fader, and send out 7-bit MIDI Control Change events.
The analog input is filtered and hysteresis is applied for maximum stability.
This version can be banked.
-
Definition at line 22 of file Bankable/CCPotentiometer.hpp.
diff --git a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
index 37e5e2644f..7d230859ca 100644
--- a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
+++ b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
@@ -75,7 +75,7 @@
There are some differences in MIDI over USB implementation between different types of Arduino-compatible boards.
-
+
Arduino boards with native USB support
Arduino Due, Arduino Zero, Arduino Leonardo, Arduino Micro, Arduino LilyPad USB ...
@@ -83,14 +83,14 @@
Some of the newer boards have native USB support (i.e. the USB connection goes directly to the main MCU) this means that they can pretend to be a USB MIDI device. This is based on PluggableUSB, using the MIDIUSB library.
All you have to do to get it working, is installing the library, and upload a sketch.
The computer will then automatically detect the Arduino as a MIDI device.
-
+
Teensy
Teensy 2.0, Teensy++ 2.0, Teensy LC, Teensy 3.0, Teensy 3.1, Teensy 3.2, Teensy 3.5, Teensy 3.6
Teensy boards have native USB support as well. You don't even need to install anything, because MIDI over USB is implemented in the Teensy Core.
You just need to select the 'MIDI' USB type from Tools > USB Type > MIDI.
-
+
Arduino boards with an ATmega16U2 (ATmega8U2)
Arduino Uno, Arduino Mega
@@ -113,7 +113,7 @@
Finally, when you know that everything is working fine, you can change the baud rate to the official MIDI baud rate of 31250, by using the default USBMIDI_Interface (don't explicitly instantiate any interfaces) uploading the sketch, and flashing the HIDUINO MIDI firmware using Flip or dfu-programmer.
You can now just plug it into your computer, and it will be recognized as a MIDI device, you don't need to run Hairless anymore.
-
+
Boards with a single-purpose USB-to-TTL chip
Arduino Nano, Arduino Duemilanove, Chinese Uno & Mega clones ...
@@ -122,7 +122,7 @@
While MIDI over USB is not supported on these boards, you can still use Hairless. Just instantiate a HairlessMIDI_Interface at the top of your sketch.
-
+
Conclusion
I strongly recommend getting a Teensy 3.x for building a Control Surface. MIDI over USB is supported right of the box, and it's the only platform that currently supports USB audio output. On top of that, it has plenty of memory to create large MIDI Controllers, and drive lots of displays.
If you just want a very small MIDI Controller, the Arduino Leonardo/Micro are good choices as well, just keep in mind that they don't have a lot of RAM.
diff --git a/docs/Doxygen/d8/da8/md_pages_Installation.html b/docs/Doxygen/d8/da8/md_pages_Installation.html
index 6cbe7e740e..8f6aec0a15 100644
--- a/docs/Doxygen/d8/da8/md_pages_Installation.html
+++ b/docs/Doxygen/d8/da8/md_pages_Installation.html
@@ -77,35 +77,35 @@
This document assumes that the Arduino IDE is already installed, as well as the necessary hardware support packages, such as Teensyduino or the ESP32 Core.
You have to install the Control Surface library itself, as well as some dependencies.
If you want to keep up to date with the latest developments, or if you want an easy way to update, the git install is recommended. Otherwise, you can use the no git install.
-
+
Installation (no git)
-
+
1. Download
Download the repository as a ZIP archive by going to the home page of the repository and click the green Clone or download button on the top right.
-
+
2. Install the Library in the Arduino IDE
Open the Arduino IDE, and go to the Sketch > Include Library > Add .ZIP Library menu.
Then navigate to your downloads directory where you just downloaded the library.
Select it, and click Ok.
-
+
Installation (git)
-
+
0. Install git
If you haven't already, install git from https://git-scm.com/downloads or use your system's package manager.
On Ubuntu and other Debian-based distros:
sudo apt install git
-
+
1. Browse to your Arduino Libraries folder
Open a terminal window and change the directory to your Arduino folder.
On Linux:
mkdir -p ~/Arduino/libraries && cd $_
-
+
2. Clone the Library
git clone https://github.com/tttapa/Control-Surface
-
+
3. Updating to the latest version
If you installed the library using git, you can easily update it when a new version comes out.
To update to the latest master version:
git pull
-
+
Dependencies
If you are using an Arduino board with on-board USB capabilities, you need the MIDIUSB library. Install it as explained before, or by using the Library Manager.
The Control Surface Library depends on the PJRC Encoder library for reading the input from rotary encoders. Download and install it if you plan on using those.
diff --git a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
index 715ebb83b5..dc99fb69c3 100644
--- a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
+++ b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
@@ -74,12 +74,12 @@
VU-Meter-Bridge.ino
-
+
VU-Meter-Bridge
This is an example on how to use an OLED display to display the VU meters and mute/solo states of the eight first tracks, by using the Arduino as a Mackie Control Universal. This is an example modified to work with the ESP32 only, using MIDI over Bluetooth Low Energy.
-
+
Connections
This example drives two SSD1306 OLED displays over SPI
Add a capacitor between the reset pin of the display and ground, and a resistor from reset to 3.3V. The values are not critical, 0.1µF and 10kΩ work fine.
You do need some way to reset the display, without it, it won't work.
Alternatively, you could use an IO pin from the ESP32 to reset the display, but this just "wastes" a pin.
-
+
Behavior
The first display should now display the level meters and mute/solo states of the first 8 tracks.
-
+
Mapping
Map "Control Surface" as a Mackie Control Universal unit in your DAW.
-
+
Demo
+
+
+
+
+MIDI_controller-97.ino
+
+
+
+MIDI_controller-97
+https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602
+Many bankable potentiometers and buttons.
+
+/**
+ * <https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602>
+ *
+ * Many bankable potentiometers and buttons.
+ *
+ * @boards Mega
+ */
+
+#include <Control_Surface.h>
+
+#include <AH/STL/algorithm> // std::any_of
+
+Bank<4> bank(16);
+
+// Create a new bank selector that changes the bank setting of the bank we just
+// created.
+// It has push buttons connected to pins 21 and 20 that increment or decrement
+// the bank setting, and 4 LEDs to pins 46, 48, 50, 52 that display the current
+// bank setting.
+IncrementDecrementSelectorLEDs<4> bankSelector = {
+ bank,
+ {21, 20}, // button pins
+ {46, 48, 50, 52}, // LED pins
+};
+
+using namespace MIDI_CC;
+Bankable::CCPotentiometer potentiometers[] = {
+
+
+
+
+
+
+
+
+
+
+
+
+};
+
+Bankable::NoteButton muteButtons[] = {
+ {bank, 13, 0x14},
+ {bank, 12, 0x15},
+ {bank, 11, 0x16},
+ {bank, 10, 0x17},
+ {bank, 9, 0x18},
+ {bank, 8, 0x19},
+ {bank, 7, 0x1A},
+ {bank, 6, 0x1B},
+ {bank, 5, 0x1C},
+ {bank, 4, 0x1D},
+ {bank, 3, 0x1E},
+ {bank, 2, 0x1F},
+ {bank, 14, 0x20},
+ {bank, 15, 0x21},
+ {bank, 16, 0x22},
+ {bank, 17, 0x23},
+ {bank, 18, {0x33, CHANNEL_2}},
+ {bank, 19, {0x34, CHANNEL_2}},
+};
+
+constexpr pin_t ledPin = 22;
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void setup() {
+
+
+}
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void loop() {
+
+
+ // Function that checks if a given button is pressed
+
+ return button.getButtonState() == Button::Pressed;
+ };
+ // If any of the push buttons is pressed
+ bool pressed = std::any_of(std::begin(muteButtons), std::end(muteButtons),
+ checkButtonPressed);
+ // Turn on the LED
+ digitalWrite(ledPin, pressed);
+}
+
+A class of MIDIOutputElements that read the input of a momentary push button or switch,...Definition: Bankable/NoteButton.hpp:22
+A class that groups Bankable BankableMIDIOutputs and BankableMIDIInputs, and allows the user to chang...Definition: Bank.hpp:77
+
+
+void pinMode(pin_t pin, uint8_t mode)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:36
+
+
+Selector with two buttons (one to increment, one to decrement). This version displays the setting usi...Definition: SelectorLEDs.hpp:99
+
+
+
+The main header file that includes all Control-Surface header files.
+A class of MIDIOutputElements that read the analog input from a potentiometer or fader,...Definition: Bankable/CCPotentiometer.hpp:22
+
+Control_Surface_ & Control_SurfaceA predefined instance of the Control Surface to use in the Arduino sketches.Definition: Control_Surface_Class.cpp:174
+
+
+
+
+
+
+
+uint16_t pin_tThe type for Arduino pins (and ExtendedIOElement pins).Definition: Hardware-Types.hpp:17
+
+
+
+
+
+Names and values for all MIDI Control Change Controller Numbers.Definition: Control_Change.hpp:14
+
+
+
+
+
+
+void loop()Update all MIDI elements, send MIDI events and read MIDI input.Definition: Control_Surface_Class.cpp:48
+void digitalWrite(pin_t pin, uint8_t val)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:47
+
+
+Generated by
+
+ 1.8.16
+
+
Definition at line 120 of file Channel.hpp.
@@ -413,6 +417,8 @@
+
Definition at line 121 of file Channel.hpp.
@@ -437,6 +443,8 @@
+
Definition at line 122 of file Channel.hpp.
diff --git a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
index 9681bb19dc..49af66362f 100644
--- a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
+++ b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html
@@ -184,7 +184,7 @@
A class of MIDIOutputElements that read the analog input from a potentiometer or fader, and send out 7-bit MIDI Control Change events.
The analog input is filtered and hysteresis is applied for maximum stability.
This version can be banked.
-
Definition at line 22 of file Bankable/CCPotentiometer.hpp.
diff --git a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
index 37e5e2644f..7d230859ca 100644
--- a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
+++ b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html
@@ -75,7 +75,7 @@
There are some differences in MIDI over USB implementation between different types of Arduino-compatible boards.
-
+
Arduino boards with native USB support
Arduino Due, Arduino Zero, Arduino Leonardo, Arduino Micro, Arduino LilyPad USB ...
@@ -83,14 +83,14 @@
Some of the newer boards have native USB support (i.e. the USB connection goes directly to the main MCU) this means that they can pretend to be a USB MIDI device. This is based on PluggableUSB, using the MIDIUSB library.
All you have to do to get it working, is installing the library, and upload a sketch.
The computer will then automatically detect the Arduino as a MIDI device.
-
+
Teensy
Teensy 2.0, Teensy++ 2.0, Teensy LC, Teensy 3.0, Teensy 3.1, Teensy 3.2, Teensy 3.5, Teensy 3.6
Teensy boards have native USB support as well. You don't even need to install anything, because MIDI over USB is implemented in the Teensy Core.
You just need to select the 'MIDI' USB type from Tools > USB Type > MIDI.
-
+
Arduino boards with an ATmega16U2 (ATmega8U2)
Arduino Uno, Arduino Mega
@@ -113,7 +113,7 @@
Finally, when you know that everything is working fine, you can change the baud rate to the official MIDI baud rate of 31250, by using the default USBMIDI_Interface (don't explicitly instantiate any interfaces) uploading the sketch, and flashing the HIDUINO MIDI firmware using Flip or dfu-programmer.
You can now just plug it into your computer, and it will be recognized as a MIDI device, you don't need to run Hairless anymore.
-
+
Boards with a single-purpose USB-to-TTL chip
Arduino Nano, Arduino Duemilanove, Chinese Uno & Mega clones ...
@@ -122,7 +122,7 @@
While MIDI over USB is not supported on these boards, you can still use Hairless. Just instantiate a HairlessMIDI_Interface at the top of your sketch.
-
+
Conclusion
I strongly recommend getting a Teensy 3.x for building a Control Surface. MIDI over USB is supported right of the box, and it's the only platform that currently supports USB audio output. On top of that, it has plenty of memory to create large MIDI Controllers, and drive lots of displays.
If you just want a very small MIDI Controller, the Arduino Leonardo/Micro are good choices as well, just keep in mind that they don't have a lot of RAM.
diff --git a/docs/Doxygen/d8/da8/md_pages_Installation.html b/docs/Doxygen/d8/da8/md_pages_Installation.html
index 6cbe7e740e..8f6aec0a15 100644
--- a/docs/Doxygen/d8/da8/md_pages_Installation.html
+++ b/docs/Doxygen/d8/da8/md_pages_Installation.html
@@ -77,35 +77,35 @@
This document assumes that the Arduino IDE is already installed, as well as the necessary hardware support packages, such as Teensyduino or the ESP32 Core.
You have to install the Control Surface library itself, as well as some dependencies.
If you want to keep up to date with the latest developments, or if you want an easy way to update, the git install is recommended. Otherwise, you can use the no git install.
-
+
Installation (no git)
-
+
1. Download
Download the repository as a ZIP archive by going to the home page of the repository and click the green Clone or download button on the top right.
-
+
2. Install the Library in the Arduino IDE
Open the Arduino IDE, and go to the Sketch > Include Library > Add .ZIP Library menu.
Then navigate to your downloads directory where you just downloaded the library.
Select it, and click Ok.
-
+
Installation (git)
-
+
0. Install git
If you haven't already, install git from https://git-scm.com/downloads or use your system's package manager.
On Ubuntu and other Debian-based distros:
sudo apt install git
-
+
1. Browse to your Arduino Libraries folder
Open a terminal window and change the directory to your Arduino folder.
On Linux:
mkdir -p ~/Arduino/libraries && cd $_
-
+
2. Clone the Library
git clone https://github.com/tttapa/Control-Surface
-
+
3. Updating to the latest version
If you installed the library using git, you can easily update it when a new version comes out.
To update to the latest master version:
git pull
-
+
Dependencies
If you are using an Arduino board with on-board USB capabilities, you need the MIDIUSB library. Install it as explained before, or by using the Library Manager.
The Control Surface Library depends on the PJRC Encoder library for reading the input from rotary encoders. Download and install it if you plan on using those.
diff --git a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
index 715ebb83b5..dc99fb69c3 100644
--- a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
+++ b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html
@@ -74,12 +74,12 @@
VU-Meter-Bridge.ino
-
+
VU-Meter-Bridge
This is an example on how to use an OLED display to display the VU meters and mute/solo states of the eight first tracks, by using the Arduino as a Mackie Control Universal. This is an example modified to work with the ESP32 only, using MIDI over Bluetooth Low Energy.
-
+
Connections
This example drives two SSD1306 OLED displays over SPI
Add a capacitor between the reset pin of the display and ground, and a resistor from reset to 3.3V. The values are not critical, 0.1µF and 10kΩ work fine.
You do need some way to reset the display, without it, it won't work.
Alternatively, you could use an IO pin from the ESP32 to reset the display, but this just "wastes" a pin.
-
+
Behavior
The first display should now display the level meters and mute/solo states of the first 8 tracks.
-
+
Mapping
Map "Control Surface" as a Mackie Control Universal unit in your DAW.
-
+
Demo
+
+
+
+
+MIDI_controller-97.ino
+
+
+
+MIDI_controller-97
+https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602
+Many bankable potentiometers and buttons.
+
+/**
+ * <https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602>
+ *
+ * Many bankable potentiometers and buttons.
+ *
+ * @boards Mega
+ */
+
+#include <Control_Surface.h>
+
+#include <AH/STL/algorithm> // std::any_of
+
+Bank<4> bank(16);
+
+// Create a new bank selector that changes the bank setting of the bank we just
+// created.
+// It has push buttons connected to pins 21 and 20 that increment or decrement
+// the bank setting, and 4 LEDs to pins 46, 48, 50, 52 that display the current
+// bank setting.
+IncrementDecrementSelectorLEDs<4> bankSelector = {
+ bank,
+ {21, 20}, // button pins
+ {46, 48, 50, 52}, // LED pins
+};
+
+using namespace MIDI_CC;
+Bankable::CCPotentiometer potentiometers[] = {
+
+
+
+
+
+
+
+
+
+
+
+
+};
+
+Bankable::NoteButton muteButtons[] = {
+ {bank, 13, 0x14},
+ {bank, 12, 0x15},
+ {bank, 11, 0x16},
+ {bank, 10, 0x17},
+ {bank, 9, 0x18},
+ {bank, 8, 0x19},
+ {bank, 7, 0x1A},
+ {bank, 6, 0x1B},
+ {bank, 5, 0x1C},
+ {bank, 4, 0x1D},
+ {bank, 3, 0x1E},
+ {bank, 2, 0x1F},
+ {bank, 14, 0x20},
+ {bank, 15, 0x21},
+ {bank, 16, 0x22},
+ {bank, 17, 0x23},
+ {bank, 18, {0x33, CHANNEL_2}},
+ {bank, 19, {0x34, CHANNEL_2}},
+};
+
+constexpr pin_t ledPin = 22;
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void setup() {
+
+
+}
+
+// :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: //
+
+void loop() {
+
+
+ // Function that checks if a given button is pressed
+
+ return button.getButtonState() == Button::Pressed;
+ };
+ // If any of the push buttons is pressed
+ bool pressed = std::any_of(std::begin(muteButtons), std::end(muteButtons),
+ checkButtonPressed);
+ // Turn on the LED
+ digitalWrite(ledPin, pressed);
+}
+
+A class of MIDIOutputElements that read the input of a momentary push button or switch,...Definition: Bankable/NoteButton.hpp:22
+A class that groups Bankable BankableMIDIOutputs and BankableMIDIInputs, and allows the user to chang...Definition: Bank.hpp:77
+
+
+void pinMode(pin_t pin, uint8_t mode)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:36
+
+
+Selector with two buttons (one to increment, one to decrement). This version displays the setting usi...Definition: SelectorLEDs.hpp:99
+
+
+
+The main header file that includes all Control-Surface header files.
+A class of MIDIOutputElements that read the analog input from a potentiometer or fader,...Definition: Bankable/CCPotentiometer.hpp:22
+
+Control_Surface_ & Control_SurfaceA predefined instance of the Control Surface to use in the Arduino sketches.Definition: Control_Surface_Class.cpp:174
+
+
+
+
+
+
+
+uint16_t pin_tThe type for Arduino pins (and ExtendedIOElement pins).Definition: Hardware-Types.hpp:17
+
+
+
+
+
+Names and values for all MIDI Control Change Controller Numbers.Definition: Control_Change.hpp:14
+
+
+
+
+
+
+void loop()Update all MIDI elements, send MIDI events and read MIDI input.Definition: Control_Surface_Class.cpp:48
+void digitalWrite(pin_t pin, uint8_t val)An ExtIO version of the Arduino function.Definition: ExtendedInputOutput.cpp:47
+
+
+Generated by
+
+ 1.8.16
+
+
Definition at line 122 of file Channel.hpp.
diff --git a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html index 9681bb19dc..49af66362f 100644 --- a/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html +++ b/docs/Doxygen/d7/dc0/classBankable_1_1CCPotentiometer.html @@ -184,7 +184,7 @@A class of MIDIOutputElements that read the analog input from a potentiometer or fader, and send out 7-bit MIDI Control Change events.
The analog input is filtered and hysteresis is applied for maximum stability.
This version can be banked.
Definition at line 22 of file Bankable/CCPotentiometer.hpp.
diff --git a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html index 37e5e2644f..7d230859ca 100644 --- a/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html +++ b/docs/Doxygen/d8/d4a/md_pages_MIDI-over-USB.html @@ -75,7 +75,7 @@There are some differences in MIDI over USB implementation between different types of Arduino-compatible boards.
-
+
Arduino boards with native USB support
Arduino Due, Arduino Zero, Arduino Leonardo, Arduino Micro, Arduino LilyPad USB ...
Some of the newer boards have native USB support (i.e. the USB connection goes directly to the main MCU) this means that they can pretend to be a USB MIDI device. This is based on PluggableUSB, using the MIDIUSB library.
All you have to do to get it working, is installing the library, and upload a sketch.
The computer will then automatically detect the Arduino as a MIDI device.
+
Teensy
Teensy 2.0, Teensy++ 2.0, Teensy LC, Teensy 3.0, Teensy 3.1, Teensy 3.2, Teensy 3.5, Teensy 3.6
Teensy boards have native USB support as well. You don't even need to install anything, because MIDI over USB is implemented in the Teensy Core.
You just need to select the 'MIDI' USB type from Tools > USB Type > MIDI.
+
Arduino boards with an ATmega16U2 (ATmega8U2)
Arduino Uno, Arduino Mega
@@ -113,7 +113,7 @@
Finally, when you know that everything is working fine, you can change the baud rate to the official MIDI baud rate of 31250, by using the default USBMIDI_Interface (don't explicitly instantiate any interfaces) uploading the sketch, and flashing the HIDUINO MIDI firmware using Flip or dfu-programmer.
You can now just plug it into your computer, and it will be recognized as a MIDI device, you don't need to run Hairless anymore.
+
Boards with a single-purpose USB-to-TTL chip
Arduino Nano, Arduino Duemilanove, Chinese Uno & Mega clones ...
@@ -122,7 +122,7 @@
While MIDI over USB is not supported on these boards, you can still use Hairless. Just instantiate a HairlessMIDI_Interface at the top of your sketch.
-
+
Conclusion
Conclusion
I strongly recommend getting a Teensy 3.x for building a Control Surface. MIDI over USB is supported right of the box, and it's the only platform that currently supports USB audio output. On top of that, it has plenty of memory to create large MIDI Controllers, and drive lots of displays.
If you just want a very small MIDI Controller, the Arduino Leonardo/Micro are good choices as well, just keep in mind that they don't have a lot of RAM.
diff --git a/docs/Doxygen/d8/da8/md_pages_Installation.html b/docs/Doxygen/d8/da8/md_pages_Installation.html index 6cbe7e740e..8f6aec0a15 100644 --- a/docs/Doxygen/d8/da8/md_pages_Installation.html +++ b/docs/Doxygen/d8/da8/md_pages_Installation.html @@ -77,35 +77,35 @@This document assumes that the Arduino IDE is already installed, as well as the necessary hardware support packages, such as Teensyduino or the ESP32 Core.
You have to install the Control Surface library itself, as well as some dependencies.
If you want to keep up to date with the latest developments, or if you want an easy way to update, the git install is recommended. Otherwise, you can use the no git install.
-
+
Installation (no git)
-
+
1. Download
1. Download
Download the repository as a ZIP archive by going to the home page of the repository and click the green Clone or download button on the top right.
-
+
2. Install the Library in the Arduino IDE
Open the Arduino IDE, and go to the Sketch > Include Library > Add .ZIP Library menu.
Then navigate to your downloads directory where you just downloaded the library.
Select it, and click Ok.
+
Installation (git)
-
+
0. Install git
0. Install git
If you haven't already, install git from https://git-scm.com/downloads or use your system's package manager.
On Ubuntu and other Debian-based distros:
+
1. Browse to your Arduino Libraries folder
Open a terminal window and change the directory to your Arduino folder.
On Linux:
+
2. Clone the Library
+
3. Updating to the latest version
If you installed the library using git, you can easily update it when a new version comes out.
To update to the latest master version:
+
Dependencies
If you are using an Arduino board with on-board USB capabilities, you need the MIDIUSB library. Install it as explained before, or by using the Library Manager.
The Control Surface Library depends on the PJRC Encoder library for reading the input from rotary encoders. Download and install it if you plan on using those.
diff --git a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html index 715ebb83b5..dc99fb69c3 100644 --- a/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html +++ b/docs/Doxygen/d8/de6/VU-Meter-Bridge_8ino-example.html @@ -74,12 +74,12 @@
+
VU-Meter-Bridge
This is an example on how to use an OLED display to display the VU meters and mute/solo states of the eight first tracks, by using the Arduino as a Mackie Control Universal. This is an example modified to work with the ESP32 only, using MIDI over Bluetooth Low Energy.
+
Connections
This example drives two SSD1306 OLED displays over SPI
Add a capacitor between the reset pin of the display and ground, and a resistor from reset to 3.3V. The values are not critical, 0.1µF and 10kΩ work fine.
You do need some way to reset the display, without it, it won't work.
Alternatively, you could use an IO pin from the ESP32 to reset the display, but this just "wastes" a pin.
+
Behavior
The first display should now display the level meters and mute/solo states of the first 8 tracks.
-
+
Mapping
Map "Control Surface" as a Mackie Control Universal unit in your DAW.
+
Demo
+
+MIDI_controller-97
+https://github.com/tttapa/MIDI_controller/issues/97#issuecomment-564247602
+Many bankable potentiometers and buttons.
++Generated by +
+ 1.8.16
+
+