pxt-microbit 5.1.32 → 5.1.34

package/docs/projects/v2-countdown.md

@@ -1,6 +1,6 @@
 # Countdown
 
-## 1. Introduction @unplugged
+## Introduction @unplugged
 
 🎇3...🎇2...🎇1...  
 🎆GO!🎆
@@ -9,16 +9,11 @@ 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** ➰
+## Setting up the loop
 
 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.
-
+► 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!
 
@@ -29,15 +24,10 @@ for (let index = 0; index <= 2; index++) {
 }
 ```
 
-## 3. Play music
-
-🎵 **Musical loops** 🎵
-
----
+## Play music
 
 ► 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.
-
+💡 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
@@ -47,18 +37,12 @@ for (let index = 0; index <= 2; index++) {
 }
 ```
 
-## 4. Showing a number
-
-✨ **Razzle dazzle down** ✨
+## Showing a number
 
 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.
-
+► 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
@@ -69,18 +53,14 @@ for (let index = 0; index <= 2; index++) {
 }
 ```
 
-## 5. Inverting the number
+## 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.
-
+💡 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!
-
+💡 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**!
 
@@ -92,14 +72,9 @@ for (let index = 0; index <= 2; 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.
+## Printing "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
@@ -111,15 +86,10 @@ for (let index = 0; index <= 2; index++) {
 basic.showString("GO!")
 ```
 
-## 7. Adding a "GO!" noise
-
-🏇 **And we're off!** 🏇
-
----
+## Adding a "GO!" noise
 
 ► 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.
-
+💡 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``.
 
@@ -135,8 +105,6 @@ 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!

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

@@ -1,6 +1,6 @@
 # Morse Chat
 
-## 1. Introducing Sky @unplugged
+## 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)").
 
@@ -8,14 +8,9 @@ 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.
+## Setup
 
+► 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
@@ -24,15 +19,10 @@ input.onLogoEvent(TouchButtonEvent.Pressed, function () {
 })
 ```
 
-## 3. Sending different messages pt. 1
-
-💬 **Sending Sky two _different_ messages** 💬
-
----
+## Sending different messages pt. 1
 
 ► 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!
-
+💡 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
@@ -44,10 +34,9 @@ input.onLogoEvent(TouchButtonEvent.Pressed, function () {
 })
 ```
 
-## 4. Sending different messages pt. 2
+## 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
@@ -60,16 +49,12 @@ input.onLogoEvent(TouchButtonEvent.Pressed, function () {
 })
 ```
 
-## 5. Receiving different messages
+## 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.
-
+► 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
@@ -83,10 +68,9 @@ radio.onReceivedNumber(function (receivedNumber) {
 })
 ```
 
-## 6. Conditioning on the input
-
-► From your ``||radio:on radio received [receivedNumber]||`` container, grab the **``receivedNumber``** input and drag out a copy.
+## 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
@@ -100,12 +84,9 @@ radio.onReceivedNumber(function (receivedNumber) {
 })
 ```
 
-## 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.
+## Displaying a message pt. 1
 
+► 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
@@ -124,11 +105,7 @@ radio.onReceivedNumber(function (receivedNumber) {
 })
 ```
 
-## 8. Playing a sound pt. 1
-
-🎵 **Adding sound** 🎵
-
----
+## Playing a sound pt. 1
 
 ► 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.
 
@@ -149,14 +126,9 @@ radio.onReceivedNumber(function (receivedNumber) {
 })
 ```
 
-## 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.
+## Displaying a message pt. 2
 
+► 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
@@ -183,10 +155,9 @@ radio.onReceivedNumber(function (receivedNumber) {
 })
 ```
 
-## 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.
+## 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
@@ -214,11 +185,7 @@ radio.onReceivedNumber(function (receivedNumber) {
 })
 ```
 
-## 11. Clearing the screens
-
-🗨️ **Clear the lights once the messages are sent** 🗨️
-
----
+## Clearing the screens
 
 ► From ``||basic:Basic||``, find ``||basic:clear screen||`` and snap it in at the **very bottom** of your ``||radio:on radio received [receivedNumber]||`` container.
 
@@ -248,21 +215,49 @@ radio.onReceivedNumber(function (receivedNumber) {
 })
 ```
 
-## 12. Testing in the simulator
+## Testing in the simulator - Connect!
 
-🐷 **Test what you've created** 💬
+Test what you've created. Remember to turn your sound on!
 
-Remember to turn your sound on!
+► Touch the gold **micro:bit logo** at the top of your @boardname@ on the simulator. You'll notice that a second @boardname@ appears. This is the @boardname@ for Sky 🐖  
+💡 If your screen is too small, you might not be able to see it.
 
----
+```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)
+})
+```
 
-► Touch the gold **micro:bit logo** at the top of your @boardname@ 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.
+## Testing in the simulator - Send message
 
 ► Touch the logo again to send messages to Sky 🐖  
 **Press** to send a dot.  
-**Long press** (count to 3!) to send a dash.
-
+**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

package/docs/projects/v2-pet-hamster.md

@@ -1,41 +1,26 @@
 # Pet Hamster
 
-## 1. Introduction @unplugged
-
-👋 Meet your new pet hamster, Cyrus 🐹
+## Introduction @unplugged
 
 ![Pet hamster banner message](/static/mb/projects/pet-hamster.png)
 
-## 2. Cyrus's asleep face
-
-😴 **Sleeping on the job** 😴
+## Cyrus's asleep face
 
 Cyrus is a very sleepy hamster. In fact, Cyrus is almost always sleeping.
 
----
-
-► From the ``||basic:Basic||`` category, find ``||basic:show icon [ ]||`` and snap it into your ``||basic:on start||`` container.
-
-► Set it to show the asleep ``-_-`` face.  
+► From the ``||basic:Basic||`` category, find ``||basic:show icon [ ]||`` and snap it into your ``||basic:on start||`` container. Set it to show the asleep ``-_-`` face.  
 💡 In the ``show icon`` dropdown menu options, you can hover to see what each design is called!
 
 ```blocks
 basic.showIcon(IconNames.Asleep)
 ```
 
-## 3. Giggly Cyrus
-
-🤣 **That tickles** 🤣
+## Giggly Cyrus
 
 Pressing Cyrus's logo tickles them!
 
----
-
-► From ``||input:Input||``, find the ``||input:on logo [pressed]||`` container and drag it into your workspace.
-
-► Go to ``||basic:Basic||`` and grab **another** ``||basic:show icon [ ]||``. Snap it into your **empty** ``||input:on logo [pressed]||`` container.
-
-► Set the icon (Cyrus's face) to happy ``:)``.
+► From ``||input:Input||``, find the ``||input:on logo [pressed]||`` container and drag it into your workspace.  
+► Go to ``||basic:Basic||`` and grab **another** ``||basic:show icon [ ]||``. Snap it into your **empty** ``||input:on logo [pressed]||`` container. Set the icon (Cyrus's face) to happy ``:)``.
 
 ```blocks
 input.onLogoEvent(TouchButtonEvent.Pressed, function () {
@@ -43,11 +28,7 @@ input.onLogoEvent(TouchButtonEvent.Pressed, function () {
 })
 ```
 
-## 4. Tickle sound
-
-🎶 **The sounds of Cyrus** 🎶
-
----
+## Tickle sound
 
 ► From the ``||music:Music||`` category, get a ``||music:play sound [giggle] until done||`` and add it to the **bottom** of your ``||input:on logo [pressed]||`` container.
 
@@ -59,19 +40,12 @@ input.onLogoEvent(TouchButtonEvent.Pressed, function () {
 })
 ```
 
-## 5. Dizzy Cyrus
-
-😵 **All shaken up** 💫
+## Dizzy Cyrus
 
 Whenever Cyrus is shaken, they get sad 🙁
 
----
-
-► From ``||input:Input||``, find ``||input:on [shake]||`` and drag it into your workspace.
-
-► From the ``||basic:Basic||`` category, grab ``||basic:show icon [ ]||`` and snap it into your **new** ``||input:on [shake]||`` container.
-
-► Set the icon (Cyrus's face) to sad ``:(``.
+► From ``||input:Input||``, find ``||input:on [shake]||`` and drag it into your workspace.  
+► From the ``||basic:Basic||`` category, grab ``||basic:show icon [ ]||`` and snap it into your **new** ``||input:on [shake]||`` container. Set the icon (Cyrus's face) to sad ``:(``.
 
 ```blocks
 input.onGesture(Gesture.Shake, function () {
@@ -79,10 +53,9 @@ input.onGesture(Gesture.Shake, function () {
 })
 ```
 
-## 6. Dizzy sound
-
-► From the ``||music:Music||`` category, find the ``||music:play sound [giggle] until done||`` block and add it to the **bottom** of your ``||input:on [shake]||`` container.
+## Dizzy sound
 
+► From the ``||music:Music||`` category, find the ``||music:play sound [giggle] until done||`` block and add it to the **bottom** of your ``||input:on [shake]||`` container.  
 ► Click on the **dropdown** and set it so Cyrus plays a ``||music:sad||`` sound until done.
 
 ```blocks
@@ -93,16 +66,11 @@ input.onGesture(Gesture.Shake, function () {
 })
 ```
 
-## 7. Cyrus's default face pt. 1
-
-💤 **Back to sleep** 💤
+## Cyrus's default face pt. 1
 
 Let's ensure that Cyrus will always go back to sleep after being shaken or tickled.
 
----
-
-► Right click the ``||basic:show icon[-_-]||`` block in your workspace (inside the ``||basic:on start||`` container) and choose **Duplicate**.
-
+► Right click the ``||basic:show icon[-_-]||`` block in your workspace (inside the ``||basic:on start||`` container) and choose **Duplicate**.  
 ► Snap your copied block in at the **very bottom** of your ``||input:on [shake]||`` container.
 
 ```blocks
@@ -119,7 +87,7 @@ input.onLogoEvent(TouchButtonEvent.Pressed, function () {
 basic.showIcon(IconNames.Asleep)
 ```
 
-## 8. Cyrus's default face pt. 2
+## Cyrus's default face pt. 2
 
 ► Duplicate the ``||basic:show icon[-_-]||`` block again and this time snap it in at the **very bottom** of your ``||input:on logo [pressed]||`` container.
 
@@ -138,9 +106,7 @@ input.onLogoEvent(TouchButtonEvent.Pressed, function () {
 basic.showIcon(IconNames.Asleep)
 ```
 
-## 9. Testing in the simulator
-
-🐾 **Test what you've created** 🐾
+## Testing in the simulator
 
 Check out the simulator and make sure your speakers are on 🔊
 

package/docs/tours/editor-tour.md

@@ -20,12 +20,24 @@
 * highlight: toolbox
 * location: right
 
+## Toolbox
+* title: Toolbox
+* description: Drag out snippets of code from the Toolbox categories into the Workspace.
+* highlight: monaco toolbox
+* location: right
+
 ## Workspace
 * title: Workspace
 * description: Snap blocks of code together to build your program.
 * highlight: workspace
 * location: center
 
+## Workspace
+* title: Workspace
+* description: Write code to build your program.
+* highlight: monaco workspace
+* location: center
+
 ## Share
 * title: Share
 * description: Create a link to your project to share with others.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pxt-microbit",
-    "version": "5.1.32",
+    "version": "5.1.34",
     "description": "micro:bit target for Microsoft MakeCode (PXT)",
     "keywords": [
         "JavaScript",
@@ -45,7 +45,7 @@
         "typescript": "4.2.3"
     },
     "dependencies": {
-        "pxt-common-packages": "10.4.9",
-        "pxt-core": "8.6.43"
+        "pxt-common-packages": "10.4.10",
+        "pxt-core": "8.6.47"
     }
 }

package/pxtarget.json

@@ -539,6 +539,7 @@
         "simScreenshot": true,
         "simScreenshotMaxUriLength": 300000,
         "simGif": true,
+        "simGifWidth": 240,
         "qrCode": true,
         "importExtensionFiles": true,
         "nameProjectFirst": true,
@@ -573,7 +574,8 @@
         },
         "tutorialSimSidebarLayout": true,
         "preferWebUSBDownload": true,
-        "hideReplaceMyCode": true
+        "hideReplaceMyCode": true,
+        "matchWebUSBDeviceInSim": true
     },
     "queryVariants": {
         "hidemenu": {