//****************************************************************************************** // File: IS_Motion.h // Authors: Dan G Ogorchock & Daniel J Ogorchock (Father and Son) // // Summary: IS_Motion is a class which implements the SmartThings "Motion Sensor" device capability. // It inherits from the st::InterruptSensor class. // // Create an instance of this class in your sketch's global variable section // For Example: st::IS_Motion sensor5(F("motion1"), PIN_MOTION, HIGH, false, 500); // // st::IS_Motion() constructor requires the following arguments // - String &name - REQUIRED - the name of the object - must match the Groovy ST_Anything DeviceType tile name // - byte pin - REQUIRED - the Arduino Pin to be used as a digital output // - bool iState - OPTIONAL - LOW or HIGH - determines which value indicates the interrupt is true // - bool internalPullup - OPTIONAL - true == INTERNAL_PULLUP // - long numReqCounts - OPTIONAL - number of counts before changing state of input (prevent false alarms) // - long inactiveTimeout - OPTIONAL - number of milliseconds motion must be inactive before sending update to hub (default = 0) // // Change History: // // Date Who What // ---- --- ---- // 2015-01-03 Dan & Daniel Original Creation // 2016-09-03 Dan Ogorchock Added optional "numReqCounts" constructor argument/capability // 2017-01-25 Dan Ogorchock Corrected issue with INPUT_PULLUP per request of Jiri Culik // 2018-08-30 Dan Ogorchock Modified comment section above to comply with new Parent/Child Device Handler requirements // 2020-01-31 Dan Ogorchock Added optional inactivity timeout // // //****************************************************************************************** #ifndef ST_IS_MOTION_H #define ST_IS_MOTION_H #include "InterruptSensor.h" namespace st { class IS_Motion: public InterruptSensor { private: //inherits everything necessary from parent InterruptSensor Class long timer; bool calibrated; long m_inactiveTimeout; bool m_inactiveTimerRunning; long m_inactiveTimer; public: //constructor - called in your sketch's global variable declaration section IS_Motion(const __FlashStringHelper *name, byte pin, bool iState, bool internalPullup = false, long numReqCounts = 0, long inactiveTimeout = 0); //(defaults to NOT using internal pullup resistors, and required counts = 0) //destructor virtual ~IS_Motion(); //initialization function virtual void init(); //called periodically by Everything class to ensure ST Cloud is kept consistent with the state of the motion sensor virtual void refresh(); //handles what to do when interrupt is triggered virtual void runInterrupt(); //handles what to do when interrupt is ended virtual void runInterruptEnded(); //override update method virtual void update(); }; } #endif