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 examples shows how to filter an analog input, so you can get the position of a knob or fader without noise.

AVR, AVR USB, Teensy 3.x, ESP32


Connect the left terminal of the potentiometer to ground, and the right one to VCC.




Written by PieterP, 2019-10-10

// Include the library
// Create a filtered analog object on pin A0:
FilteredAnalog<10, // Output precision in bits
2, // The amount of filtering
uint16_t // The integer type for the calculations
analog = A0;
// If you want more filtering, you can increase the filter shift factor.
// The number of bits required for the intermediate calculations increases if
// you do so, so you have to use a larger type as well.
FilteredAnalog<10, // Output precision in bits
6, // The amount of filtering
uint32_t // The integer type for the calculations
moreFiltering = A0;
// If you don't care about the specific settings, and just want a
// default that works, you can use the following:
FilteredAnalog<> simpleAnalog = A0;
void setup() {
while (!Serial)
// Select the correct ADC resolution
// If you want, you can add mapping functions to invert the input, for example
void loop() {
// Read the analog input every millisecond, and print if the value has changed
static Timer<millis> timer = 1; // ms
if (timer && analog.update())
// Explanation:
// analog.update() reads the analog input, applies the filters,
// saves the value, and returns true if the value has changed.
// You can then retreive the new value using analog.getValue().
// Timer is just a "Blink Without Delay" wrapper, it returns true
// every time the specified amount of time has passed.
A class that reads and filters an analog input.
Definition: FilteredAnalog.hpp:47
A class for easily managing timed events.
Definition: MillisMicrosTimer.hpp:22
The main header file that includes all Control-Surface header files.
static void setupADC()
Definition: FilteredAnalog.hpp:135