Add TouchSensor class for capacitive touch sensors

Author: pjbRPF

docs/api.rst

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

docs/examples/touch_sensor.py

@@ -0,0 +1,13 @@
+from picozero import TouchSensor
+from time import sleep
+
+touch = TouchSensor(2)
+
+print("Touch the sensor...")
+
+while True:
+    if touch.is_touched:
+        print("Touch detected!")
+    else:
+        print("No touch")
+    sleep(0.1)

docs/examples/touch_sensor_advanced.py

@@ -0,0 +1,37 @@
+from picozero import TouchSensor, LED
+from time import sleep, time
+
+touch = TouchSensor(2)
+
+led = LED(25)
+
+
+def on_touch():
+    led.on()
+
+
+def on_release():
+    led.off()
+
+
+# Method 1: Using callbacks
+touch.when_touched = on_touch
+touch.when_touch_ends = on_release
+
+sleep(10)
+
+# Method 2: Polling the sensor state
+touch.when_touched = None  # Disable callbacks
+touch.when_touch_ends = None
+
+start_time = time.time()
+while time.time() - start_time < 10:
+    if touch.is_touched:
+        led.on()
+    else:
+        led.off()
+    sleep(0.5)
+
+# Clean up
+touch.close()
+led.close()

docs/examples/touch_sensor_callbacks.py

@@ -0,0 +1,28 @@
+from picozero import TouchSensor, LED
+from time import sleep
+
+# Create a capacitive touch sensor on pin 2
+touch = TouchSensor(2)
+
+# Create an LED on pin 25 (built-in LED)
+led = LED(25)
+
+
+def touched():
+    led.on()
+
+
+def released():
+    led.off()
+
+
+# Set up event callbacks
+touch.when_touched = touched
+touch.when_touch_ends = released
+
+# Keep the program running
+try:
+    while True:
+        sleep(1)
+except KeyboardInterrupt:
+    led.off()  # Make sure LED is off when exiting

picozero/__init__.py

@@ -1,42 +1,35 @@
 __name__ = "picozero"
 __package__ = "picozero"
-__version__ = '0.4.2'
+__version__ = "0.4.2"
 __author__ = "Raspberry Pi Foundation"
 
 from .picozero import (
     PWMChannelAlreadyInUse,
     EventFailedScheduleQueueFull,
-
     pinout,
-
     DigitalOutputDevice,
     DigitalLED,
     Buzzer,
     PWMOutputDevice,
     PWMLED,
     LED,
     pico_led,
-    
     PWMBuzzer,
     Speaker,
-
     RGBLED,
     Motor,
     Robot,
     Servo,
-    
     DigitalInputDevice,
     Switch,
     Button,
-
+    TouchSensor,
     AnalogInputDevice,
     Potentiometer,
     Pot,
-
     TemperatureSensor,
     pico_temp_sensor,
     TempSensor,
     Thermistor,
-
     DistanceSensor,
 )