com.diozero.sandpit

Class MotionSensor

java.lang.Object

com.diozero.api.GpioDevice

com.diozero.api.GpioInputDevice<DigitalInputEvent>

com.diozero.api.AbstractDigitalInputDevice

com.diozero.api.DigitalInputDevice

com.diozero.api.WaitableDigitalInputDevice

com.diozero.api.SmoothedInputDevice

com.diozero.sandpit.MotionSensor

All Implemented Interfaces:

DigitalInputDeviceInterface, InputEventListener<DigitalInputEvent>, Closeable, AutoCloseable

public class MotionSensor
extends SmoothedInputDevice

A Passive Infra-Red (PIR) motion sensor.

A typical PIR device has a small circuit board with three pins: VCC, OUT, and GND. VCC should be connected to the Pi's +5V pin, GND to one of the Pi's ground pins, and finally OUT to the GPIO specified as the value of the 'pin' parameter in the constructor.

Field Summary

Fields inherited from class com.diozero.api.DigitalInputDevice

device

Fields inherited from class com.diozero.api.AbstractDigitalInputDevice

activeHigh

Fields inherited from class com.diozero.api.GpioDevice

gpio

Constructor Summary

Constructors

Constructor and Description
MotionSensor(int gpio) Defaults 'threshold' to 1, eventAge t0 20ms and eventDetectPeriod to 10ms.
MotionSensor(int gpio, GpioPullUpDown pud, int threshold, int eventAge, int eventDetectPeriod)
MotionSensor(int gpio, int threshold, int eventAge, int eventDetectPeriod)

Method Summary

Methods inherited from class com.diozero.api.SmoothedInputDevice

getEventAge, getEventDetectPeriod, getThreshold, setEventAge, setThreshold, valueChanged

Methods inherited from class com.diozero.api.WaitableDigitalInputDevice

disableDeviceListener, waitForActive, waitForActive, waitForInactive, waitForInactive, waitForValue

Methods inherited from class com.diozero.api.DigitalInputDevice

close, getPullUpDown, getTrigger, getValue, isActive, removeListener, setListener

Methods inherited from class com.diozero.api.AbstractDigitalInputDevice

enableDeviceListener, isActiveHigh, whenActivated, whenDeactivated

Methods inherited from class com.diozero.api.GpioInputDevice

addListener, removeAllListeners, removeListener

Methods inherited from class com.diozero.api.GpioDevice

getGpio

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MotionSensor

public MotionSensor(int gpio)
             throws RuntimeIOException

Defaults 'threshold' to 1, eventAge t0 20ms and eventDetectPeriod to 10ms.

If your PIR sensor has a short fall time and is particularly "jittery" you may wish to set this to a higher value (e.g. 5) to mitigate this.

Parameters:

gpio - The GPIO which the motion sensor is attached.

Throws:

RuntimeIOException - If an I/O error occurred.

MotionSensor

public MotionSensor(int gpio,
                    int threshold,
                    int eventAge,
                    int eventDetectPeriod)
             throws RuntimeIOException

Parameters:

gpio - The GPIO to which the motion sensor is attached.

threshold - The value above which the device will be considered "on".

eventAge - The time in milliseconds to keep active events in the queue.

eventDetectPeriod - How frequently to check for events.

Throws:

RuntimeIOException - If an I/O error occurred.

MotionSensor

public MotionSensor(int gpio,
                    GpioPullUpDown pud,
                    int threshold,
                    int eventAge,
                    int eventDetectPeriod)
             throws RuntimeIOException

Parameters:

gpio - The GPIO to which the motion sensor is attached.

pud - Pull up/down configuration

threshold - The value above which the device will be considered "on".

eventAge - The time in milliseconds to keep active events in the queue.

eventDetectPeriod - How frequently to check for events.

Throws:

RuntimeIOException - If an I/O error occurred.