Upgrade notes.

Author: microbit-matt-hillsdon

README.md

@@ -268,6 +268,14 @@ Otherwise, the user will need to use <code>radio.receive_bytes</code> or <code>r
 
 </table>
 
+## Upgrading micropython-microbit-v2
+
+1. Update the lib/micropython-microbit-v2 to the relevant hash. Make sure that its lib/micropython submodule is up-to-date.
+2. Review the full diff for micropython-microbit-v2. In particular, note changes to:
+   1. main.c, src/Makefile and mpconfigport.h all which have simulator versions that may need updates
+   2. the HAL, which may require implementing in the simulator
+   3. the filesystem, which has a JavaScript implementation.
+
 ## Web Assembly debugging
 
 Steps for WASM debugging in Chrome:

src/Makefile

@@ -59,8 +59,6 @@ SRC_C += \
 	main.c \
 	mphalport.c \
 
-# Upgrading?
-# Compare to lib/micropython-microbit-v2/src/codal_port/Makefile
 SRC_C += $(addprefix $(CODAL_PORT)/, \
 	drv_display.c \
 	drv_image.c \

src/examples/sound_effects_builtin.py

@@ -0,0 +1,8 @@
+from microbit import *
+
+# You don't hear this one because we don't wait then play another which stops this one.
+display.show(Image.HAPPY)
+audio.play(Sound.GIGGLE, wait=False)
+audio.play(Sound.GIGGLE)
+display.show(Image.SAD) # This doesn't happen until the giggling is over.
+audio.play(Sound.SAD)

src/examples/sound_effects_user.py

@@ -0,0 +1,15 @@
+from microbit import *
+
+# Create a Sound Effect and immediately play it
+audio.play(
+    audio.SoundEffect(
+        freq_start=400,
+        freq_end=2000,
+        duration=500,
+        vol_start=100,
+        vol_end=255,
+        wave=audio.SoundEffect.WAVE_TRIANGLE,
+        fx=audio.SoundEffect.FX_VIBRATO,
+        shape=audio.SoundEffect.SHAPE_LOG,
+    )
+)