radio updated

Author: DamoM73

10_sound.md

@@ -20,12 +20,21 @@ MicroPython on the BBC micro:bit can play music and sound through the built-in s
 
 ### Built-in tunes
 
-Notice that we import the music module. It contains methods used to make and control sound. For example:
+Notice that we import the music module. It contains methods used to make and control sound.
+
+1. Stop and close the current **main.py** file.
+2. Navigate to the **15_music_builtin** folder in Thonny and open the **main.py** file.
+
+You should see the code below:
 
 ```{literalinclude} ./python_files/15_music_builtin/main.py
 :linenos:
 ```
 
+1. **Predict** what you think will happen. Be specific.
+2. **Run** the program.
+3. Time to **investigate** the code. What does each line do?
+
 ```{admonition} Code explanation
 :class: notice
 - **line 3** → imports the music module
@@ -57,12 +66,21 @@ NOTE[octave][:duration]
 
 For example, `"A1:4"` means note `A`, octave `1`, duration `4`.
 
-Make a list of notes to create a melody. This is similar to creating an animation with a list of images. For example, this code plays the opening of "Frere Jacques":
+Make a list of notes to create a melody. This is similar to creating an animation with a list of images. For example, this code plays the opening of "Frere Jacques".
+
+1. Stop and close the current **main.py** file.
+2. Navigate to the **15_music_custom** folder in Thonny and open the **main.py** file.
+
+You should see the code below:
 
 ```{literalinclude} ./python_files/15_music_custom/main.py
 :linenos:
 ```
 
+1. **Predict** what you think will happen. Be specific.
+2. **Run** the program.
+3. Time to **investigate** the code. What does each line do?
+
 ```{admonition} Code explanation
 :class: notice
 - **line 3** → imports the music module
@@ -72,14 +90,23 @@ Make a list of notes to create a melody. This is similar to creating an animatio
 
 ### Sound Effects
 
-MicroPython lets you make tones that are not musical notes. For example, this code creates a siren sound effect:
+MicroPython lets you make tones that are not musical notes. 
+
+1. Stop and close the current **main.py** file.
+2. Navigate to the **15_music_sound_effects** folder in Thonny and open the **main.py** file.
+
+You should see the code below, which creates a siren sound effect:
 
 ```{literalinclude} ./python_files/15_music_sound_effects/main.py
 :linenos:
 ```
 
 This example uses the `music.pitch()` method. It needs a frequency. For example, `440` is the frequency of the note A used by many musicians when tuning instruments.
 
+1. **Predict** what you think will happen. Be specific.
+2. **Run** the program.
+3. Time to **investigate** the code. What does each line do?
+
 ```{admonition} Code explanation
 :class: notice
 - **line 3** → imports the music module
@@ -101,12 +128,21 @@ Full details can be found at the **[BBC micro:bit MicroPython Speech documentati
 
 ### Say
 
-The simplest way to get the micro:bit to speak is to import the speech module and use the `say()` function like this:
+The simplest way to get the micro:bit to speak is to import the speech module and use the `say()`.
+
+1. Stop and close the current **main.py** file.
+2. Navigate to the **15_speech_say** folder in Thonny and open the **main.py** file.
+
+You should see the code below:
 
 ```{literalinclude} ./python_files/15_speech_say/main.py
 :linenos:
 ```
 
+1. **Predict** what you think will happen. Be specific.
+2. **Run** the program.
+3. Time to **investigate** the code. What does each line do?
+
 ```{admonition} Code explanation
 :class: notice
 - **line 3** → imports the speech module
@@ -124,12 +160,19 @@ Together, these settings control the **timbre** of the voice. Timbre means the s
 
 To adjust the settings, pass them into the `say()` function. **[More details can be found in the speech module API documentation](https://microbit-micropython.readthedocs.io/en/latest/speech.html#timbre)**.
 
+1. Stop and close the current **main.py** file.
+2. Navigate to the **15_speech_say_2** folder in Thonny and open the **main.py** file.
+
 This example changes the voice settings:
 
 ```{literalinclude} ./python_files/15_speech_say_2/main.py
 :linenos:
 ```
 
+1. **Predict** what you think will happen. Be specific.
+2. **Run** the program.
+3. Time to **investigate** the code. What does each line do?
+
 ```{admonition} Code explanation
 :class: notice
 - **line 3** → imports the speech module
@@ -145,12 +188,19 @@ When you use phonemes, you write the word the way it sounds, not the way it is n
 
 A **[full list of phonemes](https://microbit-micropython.readthedocs.io/en/latest/speech.html#phonemes)** is available in the speech documentation. You can also pass English words into the **[translate function](https://microbit-micropython.readthedocs.io/en/latest/speech.html#speech.translate)**. It returns a first version of the phonemes that the speech synthesiser would use. You can then edit the result to improve how it sounds.
 
+1. Stop and close the current **main.py** file.
+2. Navigate to the **15_speech_pronounce** folder in Thonny and open the **main.py** file.
+
 The `pronounce()` function is used for phoneme output like this:
 
 ```{literalinclude} ./python_files/15_speech_say_3/main.py
 :linenos:
 ```
 
+1. **Predict** what you think will happen. Be specific.
+2. **Run** the program.
+3. Time to **investigate** the code. What does each line do?
+
 ```{admonition} Code explanation
 :class: notice
 - **line 3** → imports the speech module
@@ -165,12 +215,21 @@ The mapping from pitch numbers to musical notes is shown below:
 
 ![speech-pitch](assets/speech-pitch.jpg)
 
-Annotations work by adding a hash sign (`#`) and a pitch number before the phoneme. The pitch stays the same until a new annotation is given. For example, this code makes MicroPython sing a scale:
+Annotations work by adding a hash sign (`#`) and a pitch number before the phoneme. The pitch stays the same until a new annotation is given. 
+
+1. Stop and close the current **main.py** file.
+2. Navigate to the **15_sing** folder in Thonny and open the **main.py** file.
+
+In this example, the code makes MicroPython sing a scale:
 
 ```{literalinclude} ./python_files/15_sing/main.py
 :linenos:
 ```
 
+1. **Predict** what you think will happen. Be specific.
+2. **Run** the program.
+3. Time to **investigate** the code. What does each line do?
+
 ```{admonition} Code explanation
 :class: notice
 - **lines 5 - 14** → creates a list of sung sounds, for example:
@@ -204,7 +263,10 @@ The microphone can respond to built-in sound events based on how loud the sound
 - `microbit.SoundEvent.QUIET` → sound changes from loud to quiet
 - `microbit.SoundEvent.LOUD` → sound changes from quiet to loud
 
-For example:
+1. Stop and close the current **main.py** file.
+2. Navigate to the **15_microphone_1** folder in Thonny and open the **main.py** file.
+
+You should see the code below:
 
 ```{literalinclude} ./python_files/15_microphone_1/main.py
 :linenos:
@@ -214,14 +276,26 @@ For example:
 
 The microphone can also give a sound level reading from `0` to `255`.
 
-For example:
+1. Stop and close the current **main.py** file.
+2. Navigate to the **15_microphone_2** folder in Thonny and open the **main.py** file.
+
+You should see the code below:
 
 ```{literalinclude} ./python_files/15_microphone_2/main.py
 :linenos:
 ```
 
-## Sound exercises
+## Sound exercise 1
+1. Stop and close the current **main.py** file.
+2. Navigate to the **15_sound_ex1** folder in Thonny and open the **main.py** file.
+3. Create a program that plays your own tune
+
+## Sound exercise 2
+1. Stop and close the current **main.py** file. 
+2. Navigate to the **15_sound_ex2** folder in Thonny and open the **main.py** file.
+3. Create a program that sings the College Song
 
-1. Create a program that plays your own tune
-2. Create a program that sings the College Song
+## Sound exercise 3
+1. Stop and close the current **main.py** file.   
+2. Navigate to the **15_sound_ex3** folder in Thonny and open the **main.py** file.
 3. Create a program that lights up the display based on how loud the sound is

11_radio.md

@@ -23,19 +23,45 @@ When a micro:bit receives a message, it is placed in a message **queue**. A comp
 
 ## Example
 
-The example below shows how radio messages work. One micro:bit sends a message, and the other micro:bit displays an image. Run the same code on two micro:bits.
+The example below shows how radio messages work. One micro:bit sends a message, and the other micro:bit displays an image. 
+
+On two seprate micro:bits:
+1. Stop and close the current **main.py** file.
+2. open the **main.py** file in the **16_radio** folder in Thonny. 
+   
+You should see the code below:
 
 ```{literalinclude} ./python_files/16_radio/main.py
 :linenos:
 ```
 
-## Radio Exercises
+## Radio Exercise 1
+
+On two separate micro:bits:
+1. Stop and close the current **main.py** file.
+2. Open the **main.py** file in the **16_radio_exercise_1** folder in Thonny.
+3. Write code to move an image between two micro:bits when one micro:bit is shaken.
 
-1. Move an image between two micro:bits when one micro:bit is shaken.
-2. Use the micro:bit radio feature to send a private yes or no answer.
+## Radio Exercise 2
+
+On two separate micro:bits:
+1. Stop and close the current **main.py** file. 
+2. Open the **main.py** file in the **16_radio_exercise_2** folder in Thonny.
+3. Write code to use the micro:bit radio feature to send a private yes or no answer.
    - Choose either **yes** or **no** and send it to another micro:bit.
    - Display the answer on the other micro:bit for half a second.
    - Use **[`radio.config`](https://microbit-micropython.readthedocs.io/en/v2-docs/radio.html#radio.config)** to choose a group so other nearby micro:bits do not receive your message.
-3. Use two micro:bits to display the outdoor and indoor temperatures.
-   - The **outdoor micro:bit** should take a temperature reading and transmit it every 5 seconds.
-   - The **indoor micro:bit** should display the indoor temperature when button **A** is pressed, or the outdoor temperature when button **B** is pressed.
+
+## Radio Exercise 3
+
+On one micro:bit:
+1. Stop and close the current **main.py** file.
+2. Open the **main.py** file in the **16_radio_exercise_3/inside** folder in Thonny.
+3. Write code to display the indoor temperature when button **A** is pressed.
+
+On a differnt micro:bit:
+1. Stop and close the current **main.py** file.
+2. Open the **main.py** file in the **16_radio_exercise_3/outside** folder in Thonny.
+3. Write code to take a temperature reading and transmit it every 5 seconds.
+
+ Place the outside micro:bit outside and the inside micro:bit inside. When you press button **A** on the inside micro:bit, it should display the temperature reading from the inside micro:bit. When you press button **B**, it should display the outdoor temperature.

python_files/15_sound_exercise_1/main.py

@@ -1,2 +1,17 @@
 # sound exrercise
-#  1
+
+from microbit import *
+
+# --- SETUP
+# start sensors
+
+# store variables
+
+# --- RUNNING
+while True:
+    # read sensor data
+    
+    # process data
+    
+    # output data
+    

python_files/15_sound_exercise_2/main.py

@@ -1,2 +1,18 @@
 # sound exercise 2
 
+
+from microbit import *
+
+# --- SETUP
+# start sensors
+
+# store variables
+
+# --- RUNNING
+while True:
+    # read sensor data
+    
+    # process data
+    
+    # output data
+    

python_files/15_sound_exercise_3/main.py

@@ -1 +1,17 @@
 # sound exercise 3
+
+from microbit import *
+
+# --- SETUP
+# start sensors
+
+# store variables
+
+# --- RUNNING
+while True:
+    # read sensor data
+    
+    # process data
+    
+    # output data
+    

python_files/16_radio_ex1/main.py

@@ -1 +1,16 @@
 # radio exercise 1
+
+from microbit import *
+
+# --- SETUP
+# start sensors
+
+# store variables
+
+# --- RUNNING
+while True:
+    # read sensor data
+    
+    # process data
+    
+    # output data

python_files/16_radio_ex2/main.py

@@ -1 +1,16 @@
 # radio exercise 2
+
+from microbit import *
+
+# --- SETUP
+# start sensors
+
+# store variables
+
+# --- RUNNING
+while True:
+    # read sensor data
+    
+    # process data
+    
+    # output data

python_files/16_radio_ex3/inside/main.py

@@ -1 +1,16 @@
 # radio exercise 3 indside
+
+from microbit import *
+
+# --- SETUP
+# start sensors
+
+# store variables
+
+# --- RUNNING
+while True:
+    # read sensor data
+    
+    # process data
+    
+    # output data

python_files/16_radio_ex3/outside/main.py

@@ -1 +1,16 @@
 # radio exercise 3 outside
+
+from microbit import *
+
+# --- SETUP
+# start sensors
+
+# store variables
+
+# --- RUNNING
+while True:
+    # read sensor data
+    
+    # process data
+    
+    # output data