doc/ev3devices/UltrasonicSensor: add freeze note

Simplify the text for silent mode, and add a note to say what to do if it stops working when the UART gets confused.
pybricks · Apr 7, 2020 · 32ab928 · 32ab928
1 parent d2a480f
commit 32ab928
Showing 1 changed file with 4 additions and 7 deletions.
diff --git a/pybricks/ev3devices.py b/pybricks/ev3devices.py
@@ -222,13 +222,10 @@ def distance(self, silent=False):
 
         Arguments:
             silent (bool): Choose ``True`` to turn the sensor off after
-                           measuring the distance. Choose ``False`` to leave
-                           the sensor on. When you choose
-                           ``silent=True``, the sensor does not
-                           emit sounds waves except when taking the
-                           measurement. This reduces interference with other
-                           ultrasonic sensors, but turning the sensor off takes
-                           approximately 300 ms each time.
+                           measuring the distance. This reduces interference
+                           with other ultrasonic sensors. If you do
+                           this too frequently, the sensor can freeze.
+                           If this happens, unplug it and plug it back in.
 
         Returns:
             :ref:`distance`: Distance.