Merge branch 'dev' into feature/TouchSensor

Author: pjbRPF

docs/examples/stepper.py

@@ -0,0 +1,10 @@
+from picozero import Stepper
+
+# Second Hand Clock - Continuous 60s Rotation
+# One full revolution every 60 seconds.
+
+STEP_DELAY = 60.0 / 2048  # ≈ 0.029296875 seconds per step (full-step)
+
+stepper = Stepper((1, 2, 3, 4), step_delay=STEP_DELAY)
+
+stepper.run_continuous(direction="cw")

docs/examples/stepper_analog_clock.py

@@ -0,0 +1,50 @@
+from picozero import Stepper
+from time import localtime, sleep
+
+stepper = Stepper((1, 2, 3, 4), step_sequence="half")
+
+OPEN_TIME = (7, 0)  # Open at 7:00 AM (hour, minute)
+CLOSE_TIME = (20, 0)  # Close at 8:00 PM
+ROTATIONS = 5  # Number of full rotations needed to fully open/close blinds
+
+# Track state
+is_open = False
+
+
+def open_blinds():
+    global is_open
+    if not is_open:
+        for _ in range(ROTATIONS):
+            stepper.rotate(1, "cw")
+        is_open = True
+
+
+def close_blinds():
+    global is_open
+    if is_open:
+        for _ in range(ROTATIONS):
+            stepper.rotate(1, "ccw")
+        is_open = False
+
+
+def check_schedule():
+    now = localtime()
+    current_time = (now.tm_hour, now.tm_min)
+
+    # Check if it's time to open
+    if current_time == OPEN_TIME and not is_open:
+        open_blinds()
+
+    # Check if it's time to close
+    elif current_time == CLOSE_TIME and is_open:
+        close_blinds()
+
+
+# Set starting position (closed)
+stepper.reset_position()
+is_open = False
+
+# Check every 30 seconds
+while True:
+    check_schedule()
+    sleep(30)

docs/examples/stepper_automatic_blinds.py

@@ -287,16 +287,18 @@ Move the rover (roughly) in a square:
 
 .. literalinclude:: examples/robot_rover_square.py
 
+
 Stepper motor
 -------------
 
-Control a stepper motor connected via a driver board (e.g. ULN2003):
+Control a stepper motor connected via a driver board (e.g. ULN2003) to create:
 
-.. literalinclude:: examples/stepper.py
+Analog clock (continuous second hand):
+.. literalinclude:: examples/stepper_analog_clock.py
 
-Advanced positioning with precise angle control:
+Automatic blinds (multi-rotation, time-based):
+.. literalinclude:: examples/stepper_automatic_blinds.py
 
-.. literalinclude:: examples/stepper_positioning.py
 
 Internal temperature sensor
 ---------------------------