Merge pull request #73 from RaspberryPiFoundation/dev

0.3.0

Author: Martin O'Hanlon

docs/api.rst

@@ -56,6 +56,21 @@ Speaker
     :inherited-members:
     :members: 
 
+Motor
+-----
+
+.. autoclass:: Motor
+    :show-inheritance:
+    :inherited-members:
+    :members: 
+
+Robot / Rover
+-------------
+
+.. autoclass:: Robot
+    :show-inheritance:
+    :inherited-members:
+    :members: 
 
 DigitalOutputDevice
 -------------------
@@ -87,22 +102,30 @@ Switch
     :inherited-members:
     :members: 
 
-Potentiometer
--------------
+Potentiometer / Pot
+-------------------
 
 .. autoclass:: Potentiometer
     :show-inheritance:
     :inherited-members:
     :members: 
 
-TemperatureSensor
------------------
+TemperatureSensor / TempSensor / Thermistor
+-------------------------------------------
 
 .. autoclass:: TemperatureSensor
     :show-inheritance:
     :inherited-members:
     :members: 
 
+DistanceSensor
+--------------
+
+.. autoclass:: DistanceSensor
+    :show-inheritance:
+    :inherited-members:
+    :members: 
+
 DigitalInputDevice
 ------------------
 

docs/changelog.rst

@@ -6,7 +6,7 @@ Change log
 0.2.0 - 2022-06-29
 ~~~~~~~~~~~~~~~~~~
 
-+ Compatibility fix LED
++ Pico W compatibility fix for onboard LED
 
 0.1.1 - 2022-06-08
 ~~~~~~~~~~~~~~~~~~

docs/conf.py

@@ -38,6 +38,7 @@ def __getattr__(cls, name):
 # add the ticks_ms function to time (as it is in micropython)
 import time
 setattr(time, 'ticks_ms', lambda x: None)
+setattr(time, 'ticks_us', lambda x: None)
 
 # -- Project information -----------------------------------------------------
 

docs/developing.rst

@@ -38,13 +38,13 @@ Install sphinx using ::
 
     pip3 install sphinx
 
-To build the documentation, run the following command from the docs directory ::
+To test the documentation build, run the following command from the docs directory ::
 
     $ make html
 
 The website will be built in the directory docs/_build/html.
 
-Documentation can be viewed at `picozero.readthedocs.io`_.
+Documentation can be viewed at `picozero.readthedocs.io`_ and is automatically built and deployed on commit.
 
 .. _picozero.readthedocs.io: https://picozero.readthedocs.io
 
@@ -59,4 +59,16 @@ The tests are design to be run on a Raspberry Pi Pico.
 
 3. Copy the ``test_picozero.py`` to the pico.
 
-4. Run the ``test_picozero.py`` file.
+4. Run the ``test_picozero.py`` file.
+
+If a test fails it is helpful to be able to see verbose error messages. To see error messages you need to modify the ``lib/unittest.py`` file on the pico.
+
+Locate the following code in the ``run_class`` function::
+
+    # Uncomment to investigate failure in detail
+    #raise
+
+Uncomment ``raise``::
+
+    # Uncomment to investigate failure in detail
+    raise

docs/examples/motor_move.py

@@ -0,0 +1,8 @@
+from picozero import Motor
+from time import sleep
+
+motor = Motor(14, 15)
+
+motor.move()
+sleep(1)
+motor.stop()

docs/examples/robot_rover_forward.py

@@ -0,0 +1,9 @@
+from picozero import Robot
+from time import sleep
+
+robot_rover = Robot(left=(14,15), right=(12,13))
+
+# move forward
+robot_rover.forward()
+sleep(1)
+robot_rover.stop()

docs/examples/robot_rover_square.py

@@ -0,0 +1,10 @@
+from picozero import Robot
+from time import sleep
+
+robot_rover = Robot(left=(14,15), right=(12,13))
+
+for i in range(4):
+    # move forward for 1 second
+    robot_rover.forward(t=1, wait=True)
+    # rotate to the left for 1 second
+    robot_rover.left(t=1, wait=True)

docs/examples/ultrasonic_distance_sensor.py

@@ -0,0 +1,8 @@
+from picozero import DistanceSensor
+from time import sleep
+
+ds = DistanceSensor(echo=4, trigger=5)
+
+while True:
+    print(ds.distance)
+    sleep(0.1)