From 14a4fc0d7492441c7b65594b074b066dcb8d7343 Mon Sep 17 00:00:00 2001 From: Laurens Valk Date: Fri, 2 Dec 2022 12:38:26 +0100 Subject: [PATCH] pybricks.robotics: Document behavior on shared resources. Fixes https://github.com/pybricks/pybricks-api/issues/105. --- doc/main/robotics.rst | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/doc/main/robotics.rst b/doc/main/robotics.rst index 49b11d9..2c6261d 100644 --- a/doc/main/robotics.rst +++ b/doc/main/robotics.rst @@ -84,14 +84,11 @@ .. rubric:: Using the DriveBase motors individually - Suppose you make a :class:`.DriveBase` object using two ``Motor`` objects called - ``left_motor`` and ``right_motor``. You **cannot** use these motors - individually while the DriveBase is **active**. - - The DriveBase is active if it is driving, but also when it is actively - holding the wheels in place after a :meth:`.straight` or - :meth:`.turn` command. - To deactivate the :class:`.DriveBase`, call :meth:`.stop`. + After creating a :class:`.DriveBase` object, you can still use its two + motors individually. If you start one motor, the other motor will + automatically stop. Likewise, if a motor is already running and you make + the drive base move, the original maneuver is cancelled and the drive base + will take over. .. rubric:: Advanced settings