PIR library for Arduino. Supports up to 8 PIR sensors.

The PIR library implements a class to monitor 1 or more PIR sensors. The library supports default 8 PIR sensors per object, which typically are added in setup(). It is possible to add a sensor (pin) multiple times as the library accepts duplicates.

The library has two read() functions, one to read a specific sensor, and one to read all of them. The latter will return a mask indicating HIGH and LOW per PIR sensor. The first added PIR will have the LSB.

The maximum number of PIR sensors supported can be adjusted with a define in the .h file named PIR_MAX_COUNT. The default maximum is 8.

Instead of PIR sensors one can add other DigitalOut sensors or even switches.

As always feedback is welcome.

• https://github.com/RobTillaart/PIR - Simple PIR class
• https://github.com/RobTillaart/PIR8575 - 16 parallel PIR sensors
• https://github.com/RobTillaart/TCRT5000 - reflective IR sensor

#include "PIR.h"

• PIR() constructor. Default allocated room for 8 PIRs.
• uint8_t add(uint8_t pin) adds a PIR pin to the set of pins. Returns the index or PIR_ARRAY_FULL (0xFE)
• uint8_t add(uint8_t * pins, uint8_t length) adds an array of PIR pins to the set of pins if there is enough room for all pins of the array. If there is no room in the internal set to add length pins, no pin is added. Returns the (last) index or PIR_ARRAY_FULL (0xFE) in case no pin is added.
• uint8_t getPinAtIndex(uint8_t index) read back pins configured.
• bool hasPin(uint8_t pin) checks if pin is in the set of pins
• void reset() removes all pins from the internal set, reset lastRead too.
• uint8_t count() returns number of PIR sensors added.
• uint8_t free() returns number of free slots to add.

• uint8_t read() read all PIR sensors in the set. Returns a bit mask of HIGH / LOW values. Not used slots will return 0.
• uint8_t read(uint8_t index) read a specific PIR sensor. Faster than read() above. Does not affect lastValue()
• uint8_t lastValue() returns last values read (bit mask) with read().
• uint8_t changed() returns bit mask of pins that changed since last read(). This can improve processing in some cases.

• update documentation

• add examples
  • interrupts?

• one lastRead for all
• investigate dynamic allocation in constructor (0.3.0)
  • 0.2.0 has compile time define.

• PIR class based upon a PCF8574?
  • separate class (see PIR8575)
• timestamp per PIR
  • lastRead, lastTriggered?
  • taking "a lot of RAM" for every pin
• add statistics?
  • nr of calls - high% - low%
  • duration
• investigate noise (what noise)
• remove(pin)
  • difficult, more admin, expectations...

If you appreciate my libraries, you can support the development and maintenance. Improve the quality of the libraries by providing issues and Pull Requests, or donate through PayPal or GitHub sponsors.

Thank you,