RaspberryPiFoundation · chrisruk · Oct 28, 2022 · Oct 28, 2022
diff --git a/docs/buildhat/index.rst b/docs/buildhat/index.rst
@@ -40,9 +40,11 @@ power supply. For best results, use the `official Raspberry Pi Build HAT power s
    colordistancesensor.rst
    distancesensor.rst
    forcesensor.rst
+   light.rst
    matrix.rst
+   motionsensor.rst
    motor.rst
    motorpair.rst
    passivemotor.rst
+   tiltsensor.rst
    hat.rst
-   light.rst
diff --git a/docs/buildhat/motion.py b/docs/buildhat/motion.py
@@ -0,0 +1,11 @@
+"""Example using motion sensor"""
+
+from time import sleep
+
+from buildhat import MotionSensor
+
+motion = MotionSensor('A')
+
+for _ in range(50):
+    print(motion.get_distance())
+    sleep(0.1)
diff --git a/docs/buildhat/motionsensor.rst b/docs/buildhat/motionsensor.rst
@@ -0,0 +1,19 @@
+Motion Sensor
+=============
+
+|location_link|
+
+.. |location_link| raw:: html
+
+   <a href="https://www.bricklink.com/catalogItemInv.asp?S=45304-1" target="_blank">BrickLink item</a>
+
+.. autoclass:: buildhat.MotionSensor
+   :members:
+   :inherited-members:
+
+Example
+-------
+
+.. literalinclude:: motion.py
+
+
diff --git a/docs/buildhat/tilt.py b/docs/buildhat/tilt.py
@@ -0,0 +1,11 @@
+"""Example using tilt sensor"""
+
+from time import sleep
+
+from buildhat import TiltSensor
+
+tilt = TiltSensor('A')
+
+for _ in range(50):
+    print(tilt.get_tilt())
+    sleep(0.1)
diff --git a/docs/buildhat/tiltsensor.rst b/docs/buildhat/tiltsensor.rst
@@ -0,0 +1,19 @@
+Tilt Sensor
+===========
+
+|location_link|
+
+.. |location_link| raw:: html
+
+   <a href="https://www.bricklink.com/catalogItemInv.asp?S=45305-1" target="_blank">BrickLink item</a>
+
+.. autoclass:: buildhat.TiltSensor
+   :members:
+   :inherited-members:
+
+Example
+-------
+
+.. literalinclude:: tilt.py
+
+