Control Surface main
MIDI Control Surface library for Arduino
Loading...
Searching...
No Matches
Public Member Functions | Static Public Member Functions | Private Types | Private Member Functions | Private Attributes | List of all members
GenericFilteredAnalog< MappingFunction, Precision, FilterShiftFactor, FilterType, AnalogType, IncRes > Class Template Reference

#include <AH/Hardware/FilteredAnalog.hpp>

Detailed Description

template<class MappingFunction, uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
class AH::GenericFilteredAnalog< MappingFunction, Precision, FilterShiftFactor, FilterType, AnalogType, IncRes >

FilteredAnalog base class with generic MappingFunction.

See also
FilteredAnalog

Definition at line 36 of file FilteredAnalog.hpp.

+ Inheritance diagram for GenericFilteredAnalog< MappingFunction, Precision, FilterShiftFactor, FilterType, AnalogType, IncRes >:
+ Collaboration diagram for GenericFilteredAnalog< MappingFunction, Precision, FilterShiftFactor, FilterType, AnalogType, IncRes >:

Public Member Functions

 GenericFilteredAnalog (pin_t analogPin, MappingFunction mapFn, AnalogType initial=0)
 Construct a new GenericFilteredAnalog object.
 
 GenericFilteredAnalog (ArduinoPin_t analogPin, MappingFunction mapFn, AnalogType initial=0)
 Construct a new GenericFilteredAnalog object.
 
void reset (AnalogType value=0)
 Reset the filter to the given value.
 
void resetToCurrentValue ()
 Reset the filtered value to the value that's currently being measured at the analog input.
 
void map (MappingFunction fn)
 Specify a mapping function/functor that is applied to the analog value after filtering and before applying hysteresis.
 
MappingFunctiongetMappingFunction ()
 Get a reference to the mapping function.
 
const MappingFunctiongetMappingFunction () const
 Get a reference to the mapping function.
 
bool update ()
 Read the analog input value, apply the mapping function, and update the average.
 
AnalogType getValue () const
 Get the filtered value of the analog input (with the mapping function applied).
 
float getFloatValue () const
 Get the filtered value of the analog input with the mapping function applied as a floating point number from 0.0 to 1.0.
 
AnalogType getRawValue () const
 Read the raw value of the analog input without any filtering or mapping applied, but with its bit depth increased by IncRes.
 

Static Public Member Functions

static constexpr AnalogType getMaxRawValue ()
 Get the maximum value that can be returned from getRawValue.
 
static void setupADC ()
 Select the configured ADC resolution.
 

Private Types

using EMA_t = EMA<FilterShiftFactor, AnalogType, FilterType>
 

Private Member Functions

template<typename M = MappingFunction>
std::enable_if< std::is_constructible< bool, M >::value, AnalogType >::type mapFnHelper (AnalogType input)
 Helper function that applies the mapping function if it's enabled.
 
template<typename M = MappingFunction>
std::enable_if<!std::is_constructible< bool, M >::value, AnalogType >::type mapFnHelper (AnalogType input)
 Helper function that applies the mapping function without checking if it's enabled.
 

Private Attributes

pin_t analogPin
 
MappingFunction mapFn
 
EMA_t filter
 
Hysteresis< ADC_BITS+IncRes - Precision, AnalogType, AnalogTypehysteresis
 

Member Typedef Documentation

◆ EMA_t

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
using EMA_t = EMA<FilterShiftFactor, AnalogType, FilterType>
private

Definition at line 215 of file FilteredAnalog.hpp.

Constructor & Destructor Documentation

◆ GenericFilteredAnalog() [1/2]

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
GenericFilteredAnalog ( pin_t analogPin,
MappingFunction mapFn,
AnalogType initial = 0 )
inline

Construct a new GenericFilteredAnalog object.

Parameters
analogPinThe analog pin to read from.
mapFnThe mapping function
initialThe initial value of the filter.

Definition at line 48 of file FilteredAnalog.hpp.

◆ GenericFilteredAnalog() [2/2]

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
GenericFilteredAnalog ( ArduinoPin_t analogPin,
MappingFunction mapFn,
AnalogType initial = 0 )
inline

Construct a new GenericFilteredAnalog object.

Parameters
analogPinThe analog pin to read from.
mapFnThe mapping function
initialThe initial value of the filter.

Definition at line 55 of file FilteredAnalog.hpp.

Member Function Documentation

◆ reset()

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
void reset ( AnalogType value = 0)
inline

Reset the filter to the given value.

Parameters
valueThe value to reset the filter state to.

Definition at line 70 of file FilteredAnalog.hpp.

◆ resetToCurrentValue()

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
void resetToCurrentValue ( )
inline

Reset the filtered value to the value that's currently being measured at the analog input.

This is useful to avoid transient effects upon initialization.

Definition at line 83 of file FilteredAnalog.hpp.

◆ map()

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
void map ( MappingFunction fn)
inline

Specify a mapping function/functor that is applied to the analog value after filtering and before applying hysteresis.

Parameters
fnThis functor should have a call operator that takes the filtered value (of ADC_BITS + IncRes bits wide) as a parameter, and returns a value of ADC_BITS + IncRes bits wide.
Note
Applying the mapping function before filtering could result in the noise being amplified to such an extent that filtering it afterwards would be ineffective.
Applying it after hysteresis would result in a lower resolution.
That's why the mapping function is applied after filtering and before hysteresis.

Definition at line 105 of file FilteredAnalog.hpp.

◆ getMappingFunction() [1/2]

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
MappingFunction & getMappingFunction ( )
inline

Get a reference to the mapping function.

Definition at line 110 of file FilteredAnalog.hpp.

◆ getMappingFunction() [2/2]

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
const MappingFunction & getMappingFunction ( ) const
inline

Get a reference to the mapping function.

Definition at line 114 of file FilteredAnalog.hpp.

◆ update()

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
bool update ( )
inline

Read the analog input value, apply the mapping function, and update the average.

Return values
trueThe value changed since last time it was updated.
falseThe value is still the same.

Definition at line 125 of file FilteredAnalog.hpp.

◆ getValue()

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
AnalogType getValue ( ) const
inline

Get the filtered value of the analog input (with the mapping function applied).

Note
This function just returns the value from the last call to update, it doesn't read the analog input again.
Returns
The filtered value of the analog input, as a number of Precision bits wide.

Definition at line 143 of file FilteredAnalog.hpp.

◆ getFloatValue()

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
float getFloatValue ( ) const
inline

Get the filtered value of the analog input with the mapping function applied as a floating point number from 0.0 to 1.0.

Returns
The filtered value of the analog input, as a number from 0.0 to 1.0.

Definition at line 152 of file FilteredAnalog.hpp.

◆ getRawValue()

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
AnalogType getRawValue ( ) const
inline

Read the raw value of the analog input without any filtering or mapping applied, but with its bit depth increased by IncRes.

Definition at line 160 of file FilteredAnalog.hpp.

◆ getMaxRawValue()

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
static constexpr AnalogType getMaxRawValue ( )
inlinestaticconstexpr

Get the maximum value that can be returned from getRawValue.

Definition at line 172 of file FilteredAnalog.hpp.

◆ setupADC()

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
static void setupADC ( )
inlinestatic

Select the configured ADC resolution.

By default, it is set to the maximum resolution supported by the hardware.

See also
ADC_BITS
ADCConfig.hpp

Definition at line 183 of file FilteredAnalog.hpp.

◆ mapFnHelper() [1/2]

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
template<typename M = MappingFunction>
std::enable_if< std::is_constructible< bool, M >::value, AnalogType >::type mapFnHelper ( AnalogType input)
inlineprivate

Helper function that applies the mapping function if it's enabled.

This function is only enabled if MappingFunction is explicitly convertible to bool.

Definition at line 196 of file FilteredAnalog.hpp.

◆ mapFnHelper() [2/2]

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
template<typename M = MappingFunction>
std::enable_if<!std::is_constructible< bool, M >::value, AnalogType >::type mapFnHelper ( AnalogType input)
inlineprivate

Helper function that applies the mapping function without checking if it's enabled.

This function is only enabled if MappingFunction is not convertible to bool.

Definition at line 207 of file FilteredAnalog.hpp.

Member Data Documentation

◆ analogPin

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
pin_t analogPin
private

Definition at line 212 of file FilteredAnalog.hpp.

◆ mapFn

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
MappingFunction mapFn
private

Definition at line 213 of file FilteredAnalog.hpp.

◆ filter

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
EMA_t filter
private

Definition at line 229 of file FilteredAnalog.hpp.

◆ hysteresis

template<class MappingFunction , uint8_t Precision = 10, uint8_t FilterShiftFactor = ANALOG_FILTER_SHIFT_FACTOR, class FilterType = ANALOG_FILTER_TYPE, class AnalogType = analog_t, uint8_t IncRes = MaximumFilteredAnalogIncRes< FilterShiftFactor, FilterType, AnalogType>::value>
Hysteresis<ADC_BITS + IncRes - Precision, AnalogType, AnalogType> hysteresis
private

Definition at line 231 of file FilteredAnalog.hpp.


The documentation for this class was generated from the following file: