Add MotionSensor

Fixes #99

Author: pjbRPF

docs/api.rst

@@ -101,6 +101,14 @@ Button
     :inherited-members:
     :members:
 
+MotionSensor
+------------
+
+.. autoclass:: MotionSensor
+    :show-inheritance:
+    :inherited-members:
+    :members: 
+
 Switch
 ------
 

docs/examples/motion_sensor.py

@@ -0,0 +1,15 @@
+from picozero import MotionSensor
+from time import sleep
+
+pir = MotionSensor(2)
+
+print("PIR Motion Sensor Example")
+print("Waiting for motion...")
+
+while True:
+    if pir.motion_detected:
+        print("Motion detected!")
+        sleep(1)
+    else:
+        print("No motion")
+        sleep(0.5)

docs/examples/motion_sensor_callbacks.py

@@ -0,0 +1,31 @@
+from picozero import MotionSensor, LED
+from time import sleep
+
+pir = MotionSensor(2)
+led = LED(14)
+
+print("Advanced PIR Motion Sensor Example")
+print("Using event callbacks for motion detection...")
+
+
+def motion_detected():
+    print("🚶 Motion detected!")
+    led.on()  # Turn on LED when motion detected
+
+
+def no_motion():
+    print("😴 No motion detected")
+    led.off()  # Turn off LED when no motion
+
+
+# Set up event callbacks
+pir.when_motion = motion_detected
+pir.when_no_motion = no_motion
+
+# Keep the program running
+try:
+    while True:
+        sleep(1)
+except KeyboardInterrupt:
+    print("\nShutting down...")
+    led.off()  # Make sure LED is off when exiting

picozero/__init__.py

@@ -28,6 +28,7 @@
     DigitalInputDevice,
     Switch,
     Button,
+    MotionSensor,
 
     AnalogInputDevice,
     Potentiometer,