pir.h

Go to the documentation of this file.

#pragma once
 
#include <stdint.h>
 
#include "digital_pin.h"
#include "fl/ptr.h"
#include "fl/ui.h"
#include "fl/time_alpha.h"
 
#include "fl/namespace.h"
 
 
namespace fl {
 
// A passive infrared sensor common on amazon.
// For best results set the PIR to maximum sensitive and minimum delay time before retrigger.
// Instantiating this class will create a ui UIButton when
// compiling using the FastLED web compiler.
class Pir {
  public:
    Pir(int pin, const char* button_name = nullptr);
    bool detect();
    operator bool() { return detect(); }
 
  private:
    UIButton mButton;
    DigitalPin mPin;
};
 
// An advanced PIR that incorporates time to allow for latching and transitions fx. This is useful
// for detecting motion and the increasing the brightness in response to motion.
// Example:
//   #define PIR_LATCH_MS 15000  // how long to keep the PIR sensor active after a trigger
//   #define PIR_RISING_TIME 1000  // how long to fade in the PIR sensor
//   #define PIR_FALLING_TIME 1000  // how long to fade out the PIR sensor
//   PirAdvanced pir(PIN_PIR, PIR_LATCH_MS, PIR_RISING_TIME, PIR_FALLING_TIME);
//   void loop() {
//      uint8_t bri = pir.transition(millis());
//      FastLED.setBrightness(bri * brightness.as<float>());
//   }
 
class PirAdvanced {
public:
    PirAdvanced(int pin,
                uint32_t latchMs     = 5000,
                uint32_t risingTime  = 1000,
                uint32_t fallingTime = 1000);

    bool detect(uint32_t now);

    uint8_t transition(uint32_t now);

    void activate(uint32_t now) { mRamp.trigger(now); }
 
private:
    Pir        mPir;
    TimeRamp  mRamp;
    bool       mLastState = false;
};
 
} // namespace fl