Control Surface main
MIDI Control Surface library for Arduino
No Matches


This example demonstrates the use of absolute MIDI CC rotary encoders that can be used for changing effect parameters, volumes, pan and balance controls, etc.

The absolute here means that the Arduino keeps track of the position of the encoder, and it sends this absolute position over MIDI.
Usually, encoders send relative messages ("5 ticks to the left", "1 tick to the right").

Similar to the CCAbsoluteEncoder, there's also PBAbsoluteEncoder that sends absolute MIDI Pitch Bend messages.

Boards: 🛈
AVR, AVR USB, Nano Every, Due, Nano 33 IoT, Nano 33 BLE, UNO R4, Pi Pico, Teensy 3.x


Connect the common terminal of the encoder to ground. The built-in pullup resistors will be enabled.



Select the Arduino as a custom MIDI controller in your DAW, and map it like a normal CC controller (not a relative one).

Written by PieterP, 2019-12-18

#include <Control_Surface.h> // Include the Control Surface library
// Instantiate a MIDI over USB interface.
// Instantiate a CCAbsoluteEncoder object
{2, 3}, // pins
MIDI_CC::Pan, // MIDI address (CC number + optional channel)
1, // optional multiplier if the control isn't fast enough
// Similarly, for Pitch Bend
// PBAbsoluteEncoder enc {
// {2, 3}, // pins
// Channel_1, // MIDI channel
// 127, // large multiplier because Pitch Bend has high resolution
// };
void setup() {
Control_Surface.begin(); // Initialize Control Surface
void loop() {
Control_Surface.loop(); // Update the Control Surface
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.
A class of MIDIOutputElements that read the input of a quadrature (rotary) encoder and send out absol...
void begin()
Initialize the Control_Surface.
void loop()
Update all MIDI elements, send MIDI events and read MIDI input.
A class for MIDI interfaces sending MIDI messages over a USB MIDI connection.
constexpr uint8_t Pan