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

# FilteredAnalog

This examples shows how to filter an analog input, so you can get the position of a knob or fader without noise.

Boards:
AVR, AVR USB, Teensy 3.x, ESP32

## Connections

• A0: wiper of a potentiometer

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

## Behavior

• Upload the sketch to the Arduino, and open the Serial Monitor (CTRL+Shift+M)
• When you turn the potentiometer, you should see the position of the potentiometer being printed as a number between 0 and 1023.
• The analog input is filtered, so there shouldn't be any noise on the position. If there is, check your wiring, and make sure that the resistance of the potentiometer isn't too high (10 kΩ is ideal).

## Mapping

None.

Written by PieterP, 2019-10-10
https://github.com/tttapa/Control-Surface

// 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() {
Serial.begin(115200);
while (!Serial)
;
// Select the correct ADC resolution
// If you want, you can add mapping functions to invert the input, for example
analog.invert();
}
void loop() {
static Timer<millis> timer = 1; // ms
if (timer && analog.update())
Serial.println(analog.getValue());
// Explanation:
//
// 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.
}
FilteredAnalog