6#include <AH/Filters/EMA.hpp>
12#include <AH/STL/type_traits>
13#include <AH/STL/utility>
22template <u
int8_t FilterShiftFactor,
class FilterType,
class AnalogType>
24 constexpr static uint8_t value =
25 min(
sizeof(FilterType) * CHAR_BIT -
ADC_BITS - FilterShiftFactor,
26 sizeof(AnalogType) * CHAR_BIT -
ADC_BITS);
38 FilterShiftFactor, FilterType, AnalogType>::value>
52 AnalogType initial = 0)
55 AnalogType>(initial)) {}
66 void reset(AnalogType value = 0) {
68 AnalogType, AnalogType>(value);
69 filter.reset(widevalue);
70 hysteresis.setValue(widevalue);
80 AnalogType widevalue = getRawValue();
81 filter.reset(widevalue);
82 hysteresis.setValue(widevalue);
122 AnalogType input = getRawValue();
123 input = filter.filter(input);
124 input = mapFnHelper(input);
125 return hysteresis.update(input);
139 AnalogType
getValue()
const {
return hysteresis.getValue(); }
149 return getValue() * (1.0f / (ldexpf(1.0f, Precision) - 1.0f));
162 return increaseBitDepth<ADC_BITS + IncRes, ADC_BITS, AnalogType>(value);
169 return (1ul << (
ADC_BITS + IncRes)) - 1ul;
180#if HAS_ANALOG_READ_RESOLUTION
189 template <
typename M = MappingFunction>
190 typename std::enable_if<std::is_constructible<bool, M>::value,
193 return bool(mapFn) ? mapFn(input) : input;
200 template <
typename M = MappingFunction>
201 typename std::enable_if<!std::is_constructible<bool, M>::value,
214 ADC_BITS + IncRes + FilterShiftFactor <=
sizeof(FilterType) * CHAR_BIT,
215 "Error: FilterType is not wide enough to hold the maximum value");
217 ADC_BITS + IncRes <=
sizeof(AnalogType) * CHAR_BIT,
218 "Error: AnalogType is not wide enough to hold the maximum value");
221 "Error: Precision is larger than the increased ADC precision");
222 static_assert(EMA_t::supports_range(AnalogType(0), getMaxRawValue()),
223 "Error: EMA filter type doesn't support full ADC range");
263template <uint8_t Precision = 10,
267 FilterShiftFactor, FilterType, AnalogType>::value>
270 FilterShiftFactor, FilterType, AnalogType,
283 FilterShiftFactor, FilterType, AnalogType,
284 IncRes>(analogPin, nullptr, initial) {}
308 constexpr AnalogType maxval = FilteredAnalog::getMaxRawValue();
309 this->map([](AnalogType val) -> AnalogType {
return maxval - val; });
#define BEGIN_AH_NAMESPACE
analog_t(*)(analog_t) MappingFunction
#define AH_DIAGNOSTIC_POP()
#define AH_DIAGNOSTIC_WERROR()
A class that reads and filters an analog input.
FilteredAnalog(pin_t analogPin, AnalogType initial=0)
Construct a new FilteredAnalog object.
FilteredAnalog()
Construct a new FilteredAnalog object.
void invert()
Invert the analog value.
AnalogType(*)(AnalogType) MappingFunction
A function pointer to a mapping function to map analog values.
FilteredAnalog base class with generic MappingFunction.
GenericFilteredAnalog(pin_t analogPin, MappingFunction mapFn, AnalogType initial=0)
Construct a new GenericFilteredAnalog object.
void resetToCurrentValue()
Reset the filtered value to the value that's currently being measured at the analog input.
static void setupADC()
Select the configured ADC resolution.
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.
void map(MappingFunction fn)
Specify a mapping function/functor that is applied to the analog value after filtering and before app...
AnalogType getRawValue() const
Read the raw value of the analog input without any filtering or mapping applied, but with its bit dep...
void reset(AnalogType value=0)
Reset the filter to the given value.
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.
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 numb...
bool update()
Read the analog input value, apply the mapping function, and update the average.
MappingFunction & getMappingFunction()
Get a reference to the mapping function.
Hysteresis< ADC_BITS+IncRes - Precision, AnalogType, AnalogType > hysteresis
const MappingFunction & getMappingFunction() const
Get a reference to the mapping function.
static constexpr AnalogType getMaxRawValue()
Get the maximum value that can be returned from getRawValue.
Exponential moving average filter.
A class for applying hysteresis to a given input.
analog_t analogRead(pin_t pin)
An ExtIO version of the Arduino function.
constexpr auto min(const T &a, const U &b) -> decltype(b< a ? b :a)
Return the smaller of two numbers/objects.
T_out increaseBitDepth(T_in in)
Increase the bit depth of the given value from Bits_in bits wide to Bits_out bits wide,...
uint16_t analog_t
The type returned from analogRead and similar functions.
constexpr pin_t NO_PIN
A special pin number that indicates an unused or invalid pin.
constexpr uint8_t ANALOG_FILTER_SHIFT_FACTOR
The factor for the analog filter: Difference equation: where .
constexpr uint8_t ADC_BITS
The bit depth to use for the ADC (Analog to Digital Converter).
uint16_t ANALOG_FILTER_TYPE
The unsigned integer type to use for analog inputs during filtering.
uint16_t pin_t
The type for Arduino pins (and ExtendedIOElement pins).
Helper to determine how many of the remaining bits of the filter data types can be used to achieve hi...