Control Surface master
MIDI Control Surface library for Arduino


This example demonstrates the use of LEDs that respond to incoming MIDI note events by changing the brightness of an LED using PWM.

AVR, AVR USB, Nano Every, Due, Nano 33 IoT, Nano 33 BLE, Teensy 3.x


Connect an LED (+ current limiting resistor) to any PWM pin. Then change the pin number in the ledPin constant to match the pin with your LED connected.


If a MIDI Note On event for note 0x3C (C4 or middle C) is sent, the LED will light up, with the brightness depending on the velocity.
If a Note Off event for that note is sent, the LED will turn off.
(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 a middle C on the keyboard.

Written by PieterP, 2020-01-03

#include <Control_Surface.h> // Include the Control Surface library
// Instantiate a MIDI over USB interface.
const pin_t ledPin = LED_BUILTIN; // Change this to your PWM pin <------
// Instantiate the LED that will light up when middle C is playing
ledPin, // Pin of the LED, must be PWM pin
{MIDI_Notes::C(4), CHANNEL_1}, // Note C4 on MIDI channel 1
void setup() {
Control_Surface.begin(); // Initialize Control Surface
void loop() {
Control_Surface.loop(); // Update the Control Surface
constexpr Channel CHANNEL_1
Definition: Channel.hpp:118
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.
void begin()
Initialize the Control_Surface.
void loop()
Update all MIDI elements, send MIDI events and read MIDI input.
Generic base class for classes that listen for MIDI Note, Control Change and Key Pressure events on a...
A class for MIDI interfaces sending MIDI messages over a USB MIDI connection.
uint16_t pin_t
The type for Arduino pins (and ExtendedIOElement pins).
constexpr Note C
C (Do)
Definition: Notes.hpp:40