Control Surface main
MIDI Control Surface library for Arduino
Loading...
Searching...
No Matches
Installation

Arduino

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, if you're not using a standard board.
See the Arduino website for more details.

You'll have to install the Control Surface library itself, as well as some dependencies.

1. Download

Download the repository as a ZIP archive by going to the home page of the repository and clicking the green Code button in the top right, then choosing “Download ZIP”.

Alternatively, click the following direct download link: https://github.com/tttapa/Control-Surface/archive/refs/heads/main.zip

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.

3. 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.

For MIDI over BLE support, some boards may require the installation of the ArduinoBLE library.
Some of the examples may also depend on any of the following libraries: Adafruit SSD1306, FastLED, Arduino AppleMIDI Library.

PlatformIO

To use Control Surface in a PlatformIO project, add the following to your platformio.ini configuration:

lib_deps = https://github.com/tttapa/Control-Surface.git#main
lib_ignore = MIDIUSB