pxt-microbit 4.0.9 → 4.0.13

package/docs/projects/v2-clap-lights.md

@@ -0,0 +1,195 @@
+# Clap Lights
+
+## 1. Introduction @unplugged
+
+The new @boardname@s have a microphone to help them detect sound 🎤
+
+Let's learn how to use a clap 👏 to switch your @boardname@'s lights on and off!
+
+![Clap lights banner message](/static/mb/projects/clap-lights.png)
+
+## 2. Setting up the sound input
+
+🔊 **Reacting to sound** 🔊
+
+---
+
+► From the ``||input:Input||`` category, find the ``||input:on [loud] sound||`` container and add it to your workspace.
+
+```blocks
+input.onSound(DetectedSound.Loud, function () {
+
+})
+```
+
+## 3. Creating a lightsOn variable
+
+🤿 **Diving right in** 🤿
+
+Let's begin by creating a [__*variable*__](#variable "a holder for information that may change") to keep track of whether the @boardname@'s lights are on or off.
+
+---
+
+► In the ``||variables:Variables||`` category, click on ``Make a Variable...`` and make a variable named ``lightsOn``.
+
+## 4. Displaying LEDs part 1
+
+🔆 **On or not?** 🌑
+
+In this step, we'll be using an [__*if then / else*__](#ifthenelse "runs some code if a Boolean condition is true and different code if the condition is false") statement.
+
+---
+
+► From the ``||logic:Logic||`` category, grab an ``||logic:if <true> then / else||`` block and snap it into your ``||input:on [loud] sound||`` container.
+
+► Look in the ``||variables:Variables||`` category. Find the new ``||variables:lightsOn||`` variable and snap it in to **replace** the ``||logic:<true>||`` value in your ``||logic:if <true> then / else||`` statement.
+
+```blocks
+let lightsOn = 0
+input.onSound(DetectedSound.Loud, function () {
+    // @highlight
+    if (lightsOn) {
+    	
+    } else {
+    	
+    }
+})
+```
+
+## 5. Displaying LEDs part 2
+
+🌞 **Lighting the display** 🌞
+
+---
+
+► From ``||basic:Basic||``, grab ``||basic:show leds||`` and snap it into the **top container** of your ``||logic:if then / else||`` statement.
+
+► Set the lights to a pattern you like!  
+💡 In the hint, we chose to turn on all of the outside lights. Feel free to make your own design 🎨
+
+```blocks
+let lightsOn = 0
+input.onSound(DetectedSound.Loud, function () {
+    if (lightsOn) {
+        // @highlight
+    	basic.showLeds(`
+            # # # # #
+            # . . . #
+            # . . . #
+            # . . . #
+            # # # # #
+            `)
+    } else {
+    }
+})
+```
+
+## 6. Clearing the screen
+
+► From ``||basic:Basic||``, find ``||basic:clear screen||`` and snap it into the **bottom container** of your ``||logic:if then / else||`` section.  
+💡 This will turn the display off if ``lightsOn`` is **not** ``true``.
+
+```blocks
+let lightsOn = 0
+input.onSound(DetectedSound.Loud, function () {
+    if (lightsOn) {
+    	basic.showLeds(`
+            # # # # #
+            # . . . #
+            # . . . #
+            # . . . #
+            # # # # #
+            `)
+    } else {
+        // @highlight
+    	basic.clearScreen()
+    }
+})
+```
+
+## 7. Setting the lightsOn variable
+
+🎬 **Lights, camera, _action_** ✨
+
+Just like we'd toggle a light switch, each time we clap, we want to **flip** the variable ``lightsOn`` to the **opposite** of what it was before.
+
+---
+
+► From ``||variables:Variables||``, locate ``||variables:set [lightsOn] to [0]||`` and snap it in at the **very top** of your ``||input:on [loud] sound||`` container.
+
+► From the ``||logic:Logic||`` category, find the ``||logic:not <>||`` operator and use it to **replace the ``[0]``** in ``||variables:set [lightsOn] to [0]||``.
+
+► From ``||variables:Variables||``, grab ``||variables:lightsOn||`` and snap it into the **empty part** of the ``||logic:not <>||`` operator.
+
+```blocks
+let lightsOn = false
+input.onSound(DetectedSound.Loud, function () {
+    // @highlight
+    lightsOn = !(lightsOn)
+    if (lightsOn) {
+    	basic.showLeds(`
+            # # # # #
+            # . . . #
+            # . . . #
+            # . . . #
+            # # # # #
+            `)
+    } else {
+    	basic.clearScreen()
+    }
+})
+```
+
+## 8. Testing in the simulator
+
+💡 **Test what you've created** 💡
+
+---
+
+► Check out the simulator!
+
+► Click on the pink slider bar beneath the microphone icon and drag it up and down.  
+💡 Right now, your @boardname@ thinks that anything above 128 is loud. Every time the sound goes > 128, your lights should switch on/off.
+
+## 8. Set loud sound threshold
+
+Your @boardname@ might detect sounds when you don't want it to. Setting a [__*sound threshold*__](#soundThreshold "a number for how loud a sound needs to be to trigger an event. 0 = silence to 255 = maximum noise") could help 🔉🔊
+
+---
+
+► Click on the ``||input:Input||`` category. A new category should show up beneath it called ``||input:...more||``.
+
+► From ``||input:...more||``, grab ``||input:set [loud] sound threshold to [128]||`` and snap it into your **empty** ``||basic: on start||`` container.  
+💡 Try to change the value of your sound threshold so that every time you clap, your lights will turn on if they are off and vice versa.
+
+```blocks
+// @highlight
+input.setSoundThreshold(SoundThreshold.Loud, 150)
+```
+
+## 9. Testing, round 2
+
+👏 **YOU DID IT!** 👏
+
+Don't forget to test your code in the simulator!
+
+If you have a new @boardname@ (the one with the **shiny gold** logo at the top), download this code and try it out!
+
+```blocks
+let lightsOn = false
+input.onSound(DetectedSound.Loud, function () {
+    lightsOn = !(lightsOn)
+    if (lightsOn) {
+    	basic.showLeds(`
+            # # # # #
+            # . . . #
+            # . . . #
+            # . . . #
+            # # # # #
+            `)
+    } else {
+    	basic.clearScreen()
+    }
+})
+input.setSoundThreshold(SoundThreshold.Loud, 150)
+```

package/docs/projects/v2-countdown.md

@@ -0,0 +1,151 @@
+# Countdown
+
+## 1. Introduction @unplugged
+
+🎇3...🎇2...🎇1...  
+🎆GO!🎆
+
+Let's create a musical countdown using the new @boardname@ with sound!
+
+![Countdown banner message](/static/mb/projects/countdown.png)
+
+## 2. Setting up the loop
+
+➰ **All looped up** ➰
+
+We'll begin by using a [__*for loop*__](#forLoop "repeat code for a given number of times using an index") to recreate the same sound 3 times.
+
+---
+
+► From the ``||loops:Loops||`` category in your toolbox, find the ``||loops:for [index] from 0 to [4]||`` loop and add it to your ``||basic:on start||`` container.
+
+► Change your loop to count from ``0`` to **``2``**.  
+💡 This means the loop will count 0-1-2 instead of what we want, which is 3-2-1. We will worry about this later!
+
+```blocks
+// @highlight
+for (let index = 0; index <= 2; index++) {
+	
+}
+```
+
+## 3. Play music
+
+🎵 **Musical loops** 🎵
+
+---
+
+► From ``||music:Music||``, grab ``||music:play tone [Middle C] for [1 beat]||`` and snap it into your empty ``for`` loop.  
+💡 Your simulator might start playing music. You can mute it if distracting.
+
+► 1 beat is a little long. Use the **dropdown** to set the tone to play for ``||music:1/4 beat||``.
+
+```blocks
+for (let index = 0; index <= 2; index++) {
+    // @highlight
+    music.playTone(262, music.beat(BeatFraction.Quarter))
+}
+```
+
+## 4. Showing a number
+
+✨ **Razzle dazzle down** ✨
+
+With every tone, we also want to **display** our countdown.
+
+---
+
+► From ``||basic:Basic||``, find ``||basic:show number [0]||`` and snap it in at the **bottom** of your ``for`` loop.
+
+► From your ``||loops:for [index] from 0 to [2]||`` loop condition, click and drag out the **red** ``||variables:index||`` variable.
+
+► Use the ``||variables:index||`` that you dragged out to **replace** the ``0`` in ``||basic:show number [0]||``.
+
+```blocks
+for (let index = 0; index <= 2; index++) {
+    music.playTone(262, music.beat(BeatFraction.Quarter))
+    // @highlight
+    basic.showNumber(index)
+}
+```
+
+## 5. Inverting the number
+
+If you take a look at your simulator, you'll notice the @boardname@ flashing 0-1-2. We want it to say 3-2-1! Let's learn a trick to change that.
+
+---
+
+► From the ``||math:Math||`` category, snap ``||math:[0] - [0]||`` in to **replace** ``||variables:index||`` in your ``||basic:show number [index]||`` block.  
+💡 You should now have a greyed out ``index`` variable in your workspace. We'll use that in the next step.
+
+► Pick up the greyed out ``||variables:index||`` variable and snap it in to the **right side** of your ``||math:[0] - [0]||`` operator.  
+💡 Can't find ``||variables:index||``? Try moving your ``||basic:on start||`` container to see if ``||variables: index||`` is hiding behind it!
+
+► Set the **left side** of your ``||math:[0]-[index]||`` operator to **``3``**.  
+💡 Why does this work? Every time we loop, our ``index`` variable will grow by 1 and our @boardname@ will output: 3-0 = **3** ➡️ 3-1 = **2** ➡️ 3-2 = **1**!
+
+```blocks
+for (let index = 0; index <= 2; index++) {
+    music.playTone(262, music.beat(BeatFraction.Quarter))
+    // @highlight
+    basic.showNumber(3 - index)
+}
+```
+
+## 6. Printing "GO!"
+
+🏁 **You had me at "GO!"** 🏁
+
+---
+
+► From ``||basic:Basic||``, grab ``||basic:show string ["Hello!"]||`` and snap it into the **very bottom** of your ``||basic:on start||`` container.
+
+► Replace ``Hello!`` with the word ``GO!``
+
+```blocks
+for (let index = 0; index <= 2; index++) {
+    music.playTone(262, music.beat(BeatFraction.Quarter))
+    basic.showNumber(3 - index)
+}
+// @highlight
+basic.showString("GO!")
+```
+
+## 7. Adding a "GO!" noise
+
+🏇 **And we're off!** 🏇
+
+---
+
+► From the ``||music:Music||`` category, grab ``||music:play tone [Middle C] for [1 beat]||`` and place it **above** your ``||basic:show string ["GO!"]||`` block and **below** your ``||loops:for||`` loop.  
+💡 This will let your @boardname@ play the sound and show ``GO!`` at the same time.
+
+► Set the ``||music:tone||`` to be ``Middle G``.  
+💡 ``Middle G`` is also tone ``392``.
+
+```blocks
+for (let index = 0; index <= 2; index++) {
+    music.playTone(262, music.beat(BeatFraction.Quarter))
+    basic.showNumber(3 - index)
+}
+// @highlight
+music.playTone(392, music.beat(BeatFraction.Whole))
+basic.showString("GO!")
+```
+
+## 8. Testing in the simulator
+
+🚦 **Test what you've created** 🚦
+
+Make sure your speakers are on and check out the simulator!  
+
+If you have a @boardname@ with sound (the one with the **shiny gold** logo at the top), no need to plug in an external speaker - just download this code and try it out!
+
+```blocks
+for (let index = 0; index <= 2; index++) {
+    music.playTone(262, music.beat(BeatFraction.Quarter))
+    basic.showNumber(3 - index)
+}
+music.playTone(392, music.beat(BeatFraction.Whole))
+basic.showString("GO!")
+```

package/docs/projects/v2-morse-chat.md

@@ -0,0 +1,297 @@
+# Morse Chat
+
+## 1. Introducing Sky @unplugged
+
+🐷 Meet Sky, the pig! Sky can only communicate using [__*morse code*__](#morsecode "an alphabet composed of dots (short signals) and dashes (long signals)").
+
+Luckily, you can use your @boardname@ with sound to talk to Sky 👋
+
+![Morse chat banner message](/static/mb/projects/morse-chat.png)
+
+## 2. Setup
+
+⚙️ **Communication works best when set up properly** ⚙️
+
+---
+
+► From the ``||input:Input||`` category in the toolbox, drag an ``||input:on logo [pressed]||`` container into to your workspace.
+
+► From the ``||radio:Radio||`` category, get ``||radio:radio send number [0]||`` and snap it into your empty ``||input:on logo [pressed]||`` container.
+
+```blocks
+input.onLogoEvent(TouchButtonEvent.Pressed, function () {
+    radio.sendNumber(0)
+})
+```
+
+## 3. Sending different messages pt. 1
+
+💬 **Sending Sky two _different_ messages** 💬
+
+---
+
+► From ``||input:Input||``, grab **another** ``||input:on logo [pressed]||`` container and add it to your workspace.  
+💡 This container is greyed out because it matches another. Let's change that!
+
+► On the greyed-out ``||input:on logo [pressed]||`` container, click on the **``pressed``** dropdown and set it to ``||input:long pressed||``.
+
+```blocks
+// @highlight
+input.onLogoEvent(TouchButtonEvent.LongPressed, function () {
+})
+input.onLogoEvent(TouchButtonEvent.Pressed, function () {
+    radio.sendNumber(0)
+})
+```
+
+## 4. Sending different messages pt. 2
+
+► From the ``||radio:Radio||`` category, get a ``||radio:radio send number [0]||`` block and snap it into your **empty** ``||input:on logo [long pressed]||`` container.  
+
+► Set the number to be ``1``.
+
+```blocks
+input.onLogoEvent(TouchButtonEvent.LongPressed, function () {
+    // @highlight
+    radio.sendNumber(1)
+})
+input.onLogoEvent(TouchButtonEvent.Pressed, function () {
+    radio.sendNumber(0)
+})
+```
+
+## 5. Receiving different messages
+
+To ensure Sky gets the right message, we will use an [__*if then / else*__](#ifthenelse "runs some code if a boolean condition is true and different code if the condition is false") conditional statement.
+
+---
+
+► From ``||radio:Radio||``, find the ``||radio:on radio received [receivedNumber]||`` container and add it to your workspace.
+
+► From ``||logic:Logic||``, grab an ``||logic:if <true> then / else||`` statement and snap it into your **new** ``||radio:on radio received [receivedNumber]||`` container.
+
+► Go back to the ``||logic:Logic||`` category, grab ``||logic:<[0] [=] [0]>||``, and click it in to **replace** the ``||logic:<true>||`` argument in your ``||logic:if <true> then / else||`` statement.
+
+```blocks
+radio.onReceivedNumber(function (receivedNumber) {
+    // @highlight
+    if (0 == 0) {
+    	
+    } else {
+    	
+    }
+})
+```
+
+## 6. Conditioning on the input
+
+► From your ``||radio:on radio received [receivedNumber]||`` container, grab the **``receivedNumber``** input and drag out a copy.
+
+► Use your copy of **``receivedNumber``** to replace the ``[0]`` on the **left side** of ``||logic:<[0] [=] [0]>||``.
+
+```blocks
+radio.onReceivedNumber(function (receivedNumber) {
+    // @highlight
+    if (receivedNumber == 0) {
+    	
+    } else {
+    	
+    }
+})
+```
+
+## 7. Displaying a message pt. 1
+
+📃 **Dashing through the lights** 📃
+
+► We want to display a dash if the logo is long pressed.  From ``||basic:Basic||``, grab ``||basic:show leds||`` and snap it into the empty **bottom container** of your ``||logic:if then / else||`` statement.
+
+► Turn on 3 LEDs in a row to be a dash: -
+
+```blocks
+radio.onReceivedNumber(function (receivedNumber) {
+    if (receivedNumber == 0) {
+    } else {
+        // @highlight
+        basic.showLeds(`
+            . . . . .
+            . . . . .
+            . # # # .
+            . . . . .
+            . . . . .
+            `)
+    }
+})
+```
+
+## 8. Playing a sound pt. 1
+
+🎵 **Adding sound** 🎵
+
+---
+
+► From the ``||music:Music||`` category, grab a ``||music:play tone [Middle C] for [1 beat]||`` block and snap it at the **end** of the **bottom container** in your ``||logic:if then / else||`` statement.
+
+```blocks
+radio.onReceivedNumber(function (receivedNumber) {
+    if (receivedNumber == 0) {
+    } else {
+        basic.showLeds(`
+            . . . . .
+            . . . . .
+            . # # # .
+            . . . . .
+            . . . . .
+            `)
+        // @highlight
+        music.playTone(262, music.beat(BeatFraction.Whole))
+    }
+})
+```
+
+## 9. Displaying a message pt. 2
+
+⚫ **Dot dot dot** ⚫
+
+---
+
+► We want to display a dot if the logo is pressed. From ``||basic:Basic||``, grab another ``||basic:show leds||`` and snap it into the **top container** of your ``||logic:if then / else||`` statement.
+
+► Turn on a single LED to make a dot: .
+
+```blocks
+radio.onReceivedNumber(function (receivedNumber) {
+    if (receivedNumber == 0) {
+        // @highlight
+        basic.showLeds(`
+            . . . . .
+            . . . . .
+            . . # . .
+            . . . . .
+            . . . . .
+            `)
+    } else {
+        basic.showLeds(`
+            . . . . .
+            . . . . .
+            . # # # .
+            . . . . .
+            . . . . .
+            `)
+        music.playTone(262, music.beat(BeatFraction.Whole))
+    }
+})
+```
+
+## 10. Playing a sound pt. 2
+
+► From the ``||music:Music||`` category, grab ``||music:play tone [Middle C] for [1 beat]||`` and snap it in at the **end** of the **top container** in your ``||logic:if then / else||`` statement.
+
+► Dots are shorter than dashes! Set the tone to play for ``1/4 beat``.
+
+```blocks
+radio.onReceivedNumber(function (receivedNumber) {
+    if (receivedNumber == 0) {
+        basic.showLeds(`
+            . . . . .
+            . . . . .
+            . . # . .
+            . . . . .
+            . . . . .
+            `)
+        // @highlight
+        music.playTone(262, music.beat(BeatFraction.Quarter))
+    } else {
+        basic.showLeds(`
+            . . . . .
+            . . . . .
+            . # # # .
+            . . . . .
+            . . . . .
+            `)
+        music.playTone(262, music.beat(BeatFraction.Whole))
+    }
+})
+```
+
+## 11. Clearing the screens
+
+🗨️ **Clear the lights once the messages are sent** 🗨️
+
+---
+
+► From ``||basic:Basic||``, find ``||basic:clear screen||`` and snap it in at the **very bottom** of your ``||radio:on radio received [receivedNumber]||`` container.
+
+```blocks
+radio.onReceivedNumber(function (receivedNumber) {
+    if (receivedNumber == 0) {
+        basic.showLeds(`
+            . . . . .
+            . . . . .
+            . . # . .
+            . . . . .
+            . . . . .
+            `)
+        music.playTone(262, music.beat(BeatFraction.Quarter))
+    } else {
+        basic.showLeds(`
+            . . . . .
+            . . . . .
+            . # # # .
+            . . . . .
+            . . . . .
+            `)
+        music.playTone(262, music.beat(BeatFraction.Whole))
+    }
+    // @highlight
+    basic.clearScreen()
+})
+```
+
+## 12. Testing in the simulator
+
+🐷 **Test what you've created** 💬
+
+Remember to turn your sound on!
+
+---
+
+► Touch the gold logo at the top of your @boardname@ (it looks like a pig snout 🐽) on the simulator. You'll notice that a second @boardname@ appears.  
+💡 If your screen is too small, you might not be able to see it.
+
+► Touch the 🐽 again to send messages to Sky 🐖  
+**Press** to send a dot.  
+**Long press** (count to 3!) to send a dash.
+
+► If you have multiple @boardname@s with sound (they have **shiny gold** logos at the top), download this code and try it out!
+
+```blocks
+radio.onReceivedNumber(function (receivedNumber) {
+    if (receivedNumber == 0) {
+        basic.showLeds(`
+            . . . . .
+            . . . . .
+            . . # . .
+            . . . . .
+            . . . . .
+            `)
+        music.playTone(262, music.beat(BeatFraction.Quarter))
+    } else {
+        basic.showLeds(`
+            . . . . .
+            . . . . .
+            . # # # .
+            . . . . .
+            . . . . .
+            `)
+        music.playTone(262, music.beat(BeatFraction.Whole))
+    }
+    basic.clearScreen()
+})
+input.onLogoEvent(TouchButtonEvent.LongPressed, function () {
+    radio.sendNumber(1)
+})
+input.onLogoEvent(TouchButtonEvent.Pressed, function () {
+    radio.sendNumber(0)
+})
+```