pybricks.hubs.MoveHub: Enable imu orientation.

doc/main/hubs/movehub.rst

@@ -25,6 +25,8 @@ Move Hub
 
     .. automethod:: pybricks.hubs::MoveHub.imu.up
 
+    .. automethod:: pybricks.hubs::TechnicHub.imu.tilt
+
     .. automethod:: pybricks.hubs::MoveHub.imu.acceleration
 
         .. versionchanged:: 3.2

doc/main/parameters/axis.rst

@@ -5,3 +5,6 @@ Axis
 
 .. autoclass:: pybricks.parameters.Axis
     :no-members:
+
+On Move Hub, doing math with these vectors is not supported. The axes can still
+be used to set up the hub orientation.

jedi/tests/test_complete_move_hub.py

@@ -66,6 +66,7 @@ def test_hub_dot_imu_dot():
     completions: list[CompletionItem] = json.loads(complete(code, 3, len(line) + 1))
     assert [c["insertText"] for c in completions] == [
         "acceleration",
+        "tilt",
         "up",
     ]
 

jedi/tests/test_get_signature.py

@@ -910,9 +910,14 @@ METHOD_PARAMS = [
         [(["name: str"], "None"), ([], "str")],
     ),
     pytest.param(
-        "pybricks.pupdevices", "Remote", "light.on", [(["color: Color"], "None")]
+        "pybricks.pupdevices",
+        "Remote",
+        "light.on",
+        [(["color: Color"], "MaybeAwaitable")],
+    ),
+    pytest.param(
+        "pybricks.pupdevices", "Remote", "light.off", [([], "MaybeAwaitable")]
     ),
-    pytest.param("pybricks.pupdevices", "Remote", "light.off", [([], "None")]),
     pytest.param(
         "pybricks.pupdevices",
         "Remote",

src/pybricks/hubs.py

@@ -46,9 +46,13 @@ class MoveHub:
     def __init__(
         self, broadcast_channel: int = 0, observe_channels: Sequence[int] = []
     ):
-        """MoveHub(broadcast_channel=0, observe_channels=[])
+        """MoveHub(top_side=Axis.Z, front_side=Axis.X, broadcast_channel=0, observe_channels=[])
 
         Arguments:
+            top_side (Axis): The axis that passes through the *top side* of
+                the hub.
+            front_side (Axis): The axis that passes through the *front side* of
+                the hub.
             broadcast_channel:
                 A value from 0 to 255 indicating which channel ``hub.ble.broadcast()``
                 will use. Default is channel 0.