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.
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
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.
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.
To use Control Surface in a PlatformIO project, add the following to your platformio.ini
configuration: