// ----------------------------------------------------------------------------- // Event Counter Sensor // Copyright (C) 2017-2019 by Xose PĂ©rez // ----------------------------------------------------------------------------- #if SENSOR_SUPPORT && EVENTS_SUPPORT #pragma once #include "Arduino.h" #include "BaseSensor.h" // we are bound by usable GPIOs #define EVENTS_SENSORS_MAX 10 class EventSensor : public BaseSensor { public: // --------------------------------------------------------------------- // Public // --------------------------------------------------------------------- EventSensor(): BaseSensor() { _count = 1; _sensor_id = SENSOR_EVENTS_ID; } ~EventSensor() { _enableInterrupts(false); } // --------------------------------------------------------------------- void setGPIO(unsigned char gpio) { _gpio = gpio; } void setTrigger(bool trigger) { _trigger = trigger; } void setPinMode(unsigned char pin_mode) { _pin_mode = pin_mode; } void setInterruptMode(unsigned char interrupt_mode) { _interrupt_mode = interrupt_mode; } void setDebounceTime(unsigned long debounce) { _debounce = debounce; } // --------------------------------------------------------------------- unsigned char getGPIO() { return _gpio; } bool getTrigger() { return _trigger; } unsigned char getPinMode() { return _pin_mode; } unsigned char getInterruptMode() { return _interrupt_mode; } unsigned long getDebounceTime() { return _debounce; } // --------------------------------------------------------------------- // Sensors API // --------------------------------------------------------------------- // Initialization method, must be idempotent // Defined outside the class body void begin() { pinMode(_gpio, _pin_mode); _enableInterrupts(true); _count = _trigger ? 2 : 1; _ready = true; } // Descriptive name of the sensor String description() { char buffer[20]; snprintf(buffer, sizeof(buffer), "INTERRUPT @ GPIO%d", _gpio); return String(buffer); } // Descriptive name of the slot # index String slot(unsigned char index) { return description(); }; // Address of the sensor (it could be the GPIO or I2C address) String address(unsigned char index) { return String(_gpio); } // Type for slot # index unsigned char type(unsigned char index) { if (index == 0) return MAGNITUDE_COUNT; if (index == 1) return MAGNITUDE_EVENT; return MAGNITUDE_NONE; } // Current value for slot # index double value(unsigned char index) { if (index == 0) { double value = _events; _events = 0; return value; }; return 0; } // Handle interrupt calls void ICACHE_RAM_ATTR handleInterrupt(unsigned char gpio) { (void) gpio; static unsigned long last = 0; // ~27000ms when F_CPU is 80MHz // ~12000ms when F_CPU is 160MHz unsigned long ms = clockCyclesToMicroseconds(ESP.getCycleCount()) / 1000u; if (ms - last > _debounce) { last = ms; _events = _events + 1; if (_trigger) { if (_callback) _callback(MAGNITUDE_EVENT, digitalRead(gpio)); } } } protected: // --------------------------------------------------------------------- // Interrupt management // --------------------------------------------------------------------- void _attach(unsigned char gpio, unsigned char mode); void _detach(unsigned char gpio); void _enableInterrupts(bool value) { if (value) { _detach(_gpio); _attach(_gpio, _interrupt_mode); } else { _detach(_gpio); } } // --------------------------------------------------------------------- // Protected // --------------------------------------------------------------------- volatile unsigned long _events = 0; unsigned long _debounce = EVENTS_DEBOUNCE; unsigned char _gpio = GPIO_NONE; bool _trigger = false; unsigned char _pin_mode = INPUT; unsigned char _interrupt_mode = RISING; }; // ----------------------------------------------------------------------------- // Interrupt helpers // ----------------------------------------------------------------------------- EventSensor * _event_sensor_instance[EVENTS_SENSORS_MAX] = {nullptr}; void ICACHE_RAM_ATTR _event_sensor_isr(unsigned char gpio) { unsigned char index = gpio > 5 ? gpio-6 : gpio; if (_event_sensor_instance[index]) { _event_sensor_instance[index]->handleInterrupt(gpio); } } void ICACHE_RAM_ATTR _event_sensor_isr_0() { _event_sensor_isr(0); } void ICACHE_RAM_ATTR _event_sensor_isr_1() { _event_sensor_isr(1); } void ICACHE_RAM_ATTR _event_sensor_isr_2() { _event_sensor_isr(2); } void ICACHE_RAM_ATTR _event_sensor_isr_3() { _event_sensor_isr(3); } void ICACHE_RAM_ATTR _event_sensor_isr_4() { _event_sensor_isr(4); } void ICACHE_RAM_ATTR _event_sensor_isr_5() { _event_sensor_isr(5); } void ICACHE_RAM_ATTR _event_sensor_isr_12() { _event_sensor_isr(12); } void ICACHE_RAM_ATTR _event_sensor_isr_13() { _event_sensor_isr(13); } void ICACHE_RAM_ATTR _event_sensor_isr_14() { _event_sensor_isr(14); } void ICACHE_RAM_ATTR _event_sensor_isr_15() { _event_sensor_isr(15); } static void (*_event_sensor_isr_list[10])() = { _event_sensor_isr_0, _event_sensor_isr_1, _event_sensor_isr_2, _event_sensor_isr_3, _event_sensor_isr_4, _event_sensor_isr_5, _event_sensor_isr_12, _event_sensor_isr_13, _event_sensor_isr_14, _event_sensor_isr_15 }; void EventSensor::_attach(unsigned char gpio, unsigned char mode) { if (!gpioValid(gpio)) return; unsigned char index = gpio > 5 ? gpio-6 : gpio; if (_event_sensor_instance[index] == this) return; if (_event_sensor_instance[index]) detachInterrupt(gpio); _event_sensor_instance[index] = this; attachInterrupt(gpio, _event_sensor_isr_list[index], mode); #if SENSOR_DEBUG DEBUG_MSG_P(PSTR("[SENSOR] GPIO%d interrupt attached to %s\n"), gpio, this->description().c_str()); #endif } void EventSensor::_detach(unsigned char gpio) { if (!gpioValid(gpio)) return; unsigned char index = gpio > 5 ? gpio-6 : gpio; if (_event_sensor_instance[index]) { detachInterrupt(gpio); _event_sensor_instance[index] = nullptr; #if SENSOR_DEBUG DEBUG_MSG_P(PSTR("[SENSOR] GPIO%d interrupt detached from %s\n"), gpio, _event_sensor_instance[index]->description().c_str()); #endif } } #endif // SENSOR_SUPPORT && EVENTS_SUPPORT