This is an old version of the documentation. View the latest version here.
Control Surface  1.0.0
MIDI Control Surface library for Arduino


This example demonstrates the use of LEDs that respond to incoming MIDI note events. The LEDs are driven by a 74HC595 (or equivalent) shift register.

AVR, AVR USB, Teensy 3.x, ESP32


Connect eight LEDs (and series resistors) between the outputs of the shift register and ground.

Remember to connect the enable pin of the shift register to ground and the master reset pin to Vcc in order to enable it.


If a MIDI Note On event for note 0x3C (C4 or middle C) is sent, the first LED will light up, if a Note Off event for that note is sent, the LED will turn off.
If a MIDI Note On event for note 0x3D (C#4) is sent, the second LED will light up, and so on.
(A Note On event with a velocity of zero also counts as a Note Off event.)


Route the MIDI output of a MIDI keyboard to the Arduino's MIDI input. Then play some notes between middle C and middle G on the keyboard. The LEDs should light up when you press the keys.

Written by PieterP, 2019-10-09

// Include the library
// Instantiate a MIDI Interface to use
// Instantiate a shift register as output for the LEDs
10, // Latch pin (ST_CP)
MSBFIRST, // Byte order
using namespace MIDI_Notes;
// Create a range of LEDs that listens for MIDI Note messages, turning on and off
// the LEDs connected to the eight input pins of the shift register
NoteRangeLEDs<8> leds = { sreg.pins(), note(C, 4) };
// Initialize the Control Surface
void setup() {
// Update the Control Surface
void loop() {
A class for MIDI interfaces sending MIDI messages over a USB MIDI connection.
Definition: USBMIDI_Interface.hpp:43
A class for serial-in/parallel-out shift registers, like the 74HC595 that are connected to the SPI bu...
Definition: SPIShiftRegisterOut.hpp:23
The main header file that includes all Control-Surface header files.
Control_Surface_ & Control_Surface
A predefined instance of the Control Surface to use in the Arduino sketches.
Definition: Control_Surface_Class.cpp:171
constexpr int8_t note(int8_t note, int8_t numOctave)
Get the MIDI note in the given octave.
Definition: Notes.hpp:35
void begin()
Initialize the Control_Surface.
Definition: Control_Surface_Class.cpp:22
constexpr int8_t C
Definition: Notes.hpp:18
MIDI note names.
Definition: Notes.hpp:16
Array< pin_t, N > pins() const
Get an array containing all pins of the element.
Definition: StaticSizeExtendedIOElement.hpp:24
Definition: NoteCCRangeLEDs.hpp:32
void loop()
Update all MIDI elements, send MIDI events and read MIDI input.
Definition: Control_Surface_Class.cpp:45