docs: Radio is now turned on during import. (#763)

microbit-carlos · web-flow · commit de0047114a69 · 2022-08-31T19:57:38.000+01:00
diff --git a/docs/radio.rst b/docs/radio.rst
@@ -48,8 +48,13 @@ Functions
 
 .. py:function:: on()
 
-    Turns the radio on. This needs to be explicitly called since the radio
-    draws power and takes up memory that you may otherwise need.
+    Turns the radio on.
+
+    Since MicroPython-on-micro:bit v1.1
+    the radio is turned on by default when the radio module is imported.
+    In earlier releases, to reduce power consumption until needed, this
+    function had to be explicitly called.
+    For those cases ``radio.off()`` can be called after import.
 
 .. py:function:: off()
 
diff --git a/docs/tutorials/radio.rst b/docs/tutorials/radio.rst
@@ -107,10 +107,6 @@ We're going to use the radio module to create something akin to a swarm of
 fireflies signalling to each other.
 
 First ``import radio`` to make the functions available to your Python program.
-Then call the ``radio.on()`` function to turn the radio on. Since
-the radio draws power and takes up memory we've made it so *you* decide
-when it is enabled (there is, of course a ``radio.off()`` function).
-
 At this point the radio module is configured to sensible defaults that make
 it compatible with other platforms that may target the BBC micro:bit. It is
 possible to control many of the features discussed above (such as channel and
diff --git a/examples/radio.py b/examples/radio.py
@@ -7,9 +7,6 @@
 # Create the "flash" animation frames. Can you work out how it's done?
 flash = [Image().invert()*(i/9) for i in range(9, -1, -1)]
 
-# The radio won't work unless it's switched on.
-radio.on()
-
 # Event loop.
 while True:
     # Button A sends a "flash" message.
