pxt-microbit 4.0.12 → 4.0.13

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)
+})
+```

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

@@ -0,0 +1,165 @@
+# Pet Hamster
+
+## 1. Introduction @unplugged
+
+👋 Meet your new pet hamster, Cyrus 🐹
+
+![Pet hamster banner message](/static/mb/projects/pet-hamster.png)
+
+## 2. Cyrus's asleep face
+
+😴 **Sleeping on the job** 😴
+
+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.  
+💡 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** 🤣
+
+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 ``:)``.
+
+```blocks
+input.onLogoEvent(TouchButtonEvent.Pressed, function () {
+    basic.showIcon(IconNames.Happy)
+})
+```
+
+## 4. Tickle sound
+
+🎶 **The sounds of Cyrus** 🎶
+
+---
+
+► 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.
+
+```blocks
+input.onLogoEvent(TouchButtonEvent.Pressed, function () {
+    basic.showIcon(IconNames.Happy)
+    // @highlight
+    soundExpression.giggle.playUntilDone()
+})
+```
+
+## 5. Dizzy Cyrus
+
+😵 **All shaken up** 💫
+
+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 ``:(``.
+
+```blocks
+input.onGesture(Gesture.Shake, function () {
+    basic.showIcon(IconNames.Sad)
+})
+```
+
+## 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.
+
+► Click on the **dropdown** and set it so Cyrus plays a ``||music:sad||`` sound until done.
+
+```blocks
+input.onGesture(Gesture.Shake, function () {
+    basic.showIcon(IconNames.Sad)
+    // @highlight
+    soundExpression.sad.playUntilDone()
+})
+```
+
+## 7. Cyrus's default face pt. 1
+
+💤 **Back to sleep** 💤
+
+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**.
+
+► Snap your copied block in at the **very bottom** of your ``||input:on [shake]||`` container.
+
+```blocks
+input.onGesture(Gesture.Shake, function () {
+    basic.showIcon(IconNames.Sad)
+    soundExpression.sad.playUntilDone()
+    // @highlight
+    basic.showIcon(IconNames.Asleep)
+})
+input.onLogoEvent(TouchButtonEvent.Pressed, function () {
+    basic.showIcon(IconNames.Happy)
+    soundExpression.giggle.playUntilDone()
+})
+basic.showIcon(IconNames.Asleep)
+```
+
+## 8. 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.
+
+```blocks
+input.onGesture(Gesture.Shake, function () {
+    basic.showIcon(IconNames.Sad)
+    soundExpression.sad.playUntilDone()
+    basic.showIcon(IconNames.Asleep)
+})
+input.onLogoEvent(TouchButtonEvent.Pressed, function () {
+    basic.showIcon(IconNames.Happy)
+    soundExpression.giggle.playUntilDone()
+    // @highlight
+    basic.showIcon(IconNames.Asleep)
+})
+basic.showIcon(IconNames.Asleep)
+```
+
+## 9. Testing in the simulator
+
+🐾 **Test what you've created** 🐾
+
+Check out the simulator and make sure your speakers are on 🔊
+
+Play with Cyrus to see how they react 🐹  
+**Click on the SHAKE button** to shake Cyrus.  
+**Touch the gold logo at the top** (it looks like a piggy snout 🐽) to tickle Cyrus.
+
+If you have a new @boardname@ (the one with the **shiny gold** logo at the top), download this code and try it out!
+
+```blocks
+input.onGesture(Gesture.Shake, function () {
+    basic.showIcon(IconNames.Sad)
+    soundExpression.sad.playUntilDone()
+    basic.showIcon(IconNames.Asleep)
+})
+input.onLogoEvent(TouchButtonEvent.Pressed, function () {
+    basic.showIcon(IconNames.Happy)
+    soundExpression.giggle.playUntilDone()
+    basic.showIcon(IconNames.Asleep)
+})
+basic.showIcon(IconNames.Asleep)
+```

package/docs/projects.md

@@ -8,6 +8,11 @@
         "imageUrl": "/static/mb/projects/a1-display.png",
         "largeImageUrl": "/static/mb/projects/flashing-heart/sim.gif"
     },
+    {
+        "name": "Tutorials for the new micro:bit (V2)",
+        "url": "/v2tutorials",
+        "imageUrl": "/static/mb/projects/pet-hamster.png"
+    },
     {
         "name": "Live Coding",
         "url": "/live-coding",
@@ -54,7 +59,7 @@
         "imageUrl": "/static/mb/projects/turtle-square.png"
     },
     {
-        "name": "Blocks To JavaScript",
+        "name": "Blocks to JavaScript",
         "url": "/courses/blocks-to-javascript",
         "imageUrl": "/static/courses/blocks-to-javascript/hello-javascript.png"
     },
@@ -94,6 +99,7 @@
 ## See Also
 
 [Tutorials](/tutorials),
+[Tutorials for the new micro:bit (V2)](/v2tutorials),
 [Live Coding](/live-coding),
 [Games](/projects/games),
 [Radio Games](/projects/radio-games),
@@ -103,7 +109,7 @@
 [Science](/projects/science),
 [Tools](/projects/tools),
 [Turtle](/projects/turtle),
-[Blocks To JavaScript](/courses/blocks-to-javascript),
+[Blocks to JavaScript](/courses/blocks-to-javascript),
 [Courses](/courses),
 [Behind the MakeCode Hardware](/behind-the-makecode-hardware),
 [Science Experiments](/science-experiments),

package/docs/reference/basic/forever.md

@@ -1,4 +1,4 @@
-# Forever
+# forever
 
 Keep running part of a program 
 [in the background](/reference/control/in-background).
@@ -8,7 +8,20 @@ basic.forever(() => {
 })
 ```
 
-## Example: compass
+You can have part of a program continuously by placing it in an **forever** loop. The **forever** loop will _yield_ to the other code in your program though, allowing that code to have time to run when needs to.
+
+### ~ reminder
+
+#### Event-based loops
+
+Both the **forever** loop and the **every** loop are _event-based_ loops where the code inside is run as part of a function. These are different from the [for](/blocks/loops/for) and [while](/blocks/loops/while) loops. Those are loops are part of the programming language and can have [break](/blocks/loops/break) and [continue](/blocks/loops/continue) statements in them.
+You can NOT use **break** or **continue** in either a **forever** loop or an **every** loop.
+
+### ~
+
+## Examples
+
+### Example: compass
 
 The following example constantly checks the 
 [compass heading](/reference/input/compass-heading) 
@@ -32,7 +45,7 @@ basic.forever(() => {
 })
 ```
 
-## Example: counter
+### Example: counter
 
 The following example keeps showing the [number](/types/number) stored in a global variable.
 When you press button `A`, the number gets bigger.
@@ -66,5 +79,5 @@ input.onButtonPressed(Button.A, () => {
 
 ## See also
 
-[while](/blocks/loops/while), [on button pressed](/reference/input/on-button-pressed), [in background](/reference/control/in-background)
+[while](/blocks/loops/while), [in background](/reference/control/in-background), [every](/reference/loops/every-interval)
 

package/docs/reference/basic/show-number.md

@@ -8,7 +8,7 @@ basic.showNumber(2)
 
 ## Parameters
 
-* `value` is a [Number](/types/number).
+* `value` is a [Number](/types/number). If the number is not single-digit number, it will scroll on the display.
 * `interval` is an optional [Number](/types/number). It means the number of milliseconds before sliding the `value` left by one LED each time. Bigger intervals make the sliding slower.
 
 ## Examples:

package/docs/reference/loops/every-interval.md

@@ -0,0 +1,42 @@
+# every Interval
+
+Run part of the program in a loop continuously at a time interval.
+
+```sig
+loops.everyInterval(500, function () {})
+```
+
+If you want to run some code continuously, but on a time interval, then use an **every** loop. You set the amount of time that the loop waits before the code inside runs again. This is similar to a [forever](/reference/basic/forever) loop, in that it runs continuously, except that there's a time interval set to wait on before the loop runs the next time. This loop is useful when you want some of a program's code run on a _schedule_.
+
+## Parameters
+
+* **interval**: a [number](/types/number) that is the amount of time in milliseconds to wait before running the loop again.
+
+### ~ reminder
+
+#### Event-based loops
+
+Both the **every** loop and the **forever** loop are _event-based_ loops where the code inside is run as part of a function. These are different from the [for](/blocks/loops/for) and [while](/blocks/loops/while) loops. Those are loops are part of the programming language and can have [break](/blocks/loops/break) and [continue](/blocks/loops/continue) statements in them.
+You can NOT use **break** or **continue** in either an **every** loop or a **forever** loop.
+
+### ~
+
+## Example
+
+At every `200` milliseconds of time, check if either the **A** or **B** button is pressed. If so, show on the screen which one is pressed.
+
+```blocks
+loops.everyInterval(200, function () {
+    if (input.buttonIsPressed(Button.A)) {
+        basic.showString("A")
+    } else if (input.buttonIsPressed(Button.B)) {
+        basic.showString("B")
+    } else {
+        basic.clearScreen()
+    }
+})
+```
+
+## See also
+
+[forever](/reference/basic/forever)

package/docs/reference/radio/on-received-buffer.md

@@ -19,6 +19,7 @@ Two @boardname@s work like remote levels. They lie flat and detect any change in
 ```typescript
 let ax = 0;
 let ay = 0;
+radio.setGroup(3)
 basic.forever(() => {
     ax = input.acceleration(Dimension.X);
     ay = input.acceleration(Dimension.Y);

package/docs/reference/radio/on-received-number.md

@@ -29,6 +29,7 @@ thing from nearby @boardname@s. It shows these numbers as a
 [bar graph](/reference/led/plot-bar-graph).
 
 ```blocks
+radio.setGroup(1)
 basic.forever(() => {
     radio.sendNumber(input.acceleration(Dimension.X));
 })
@@ -43,6 +44,7 @@ This program uses the signal strength from received packets to graph the
 approximate distance between two @boardname@s.
 
 ```blocks
+radio.setGroup(1)
 basic.forever(() => {
     radio.sendNumber(0)
 })

package/docs/reference/radio/on-received-string.md

@@ -23,6 +23,7 @@ https://www.youtube.com/watch?v=Re3H2ISfQE8
 This program continuously sends a cheerful message. It also receives a messages from nearby @boardname@s. It shows these messages on the screen.
 
 ```blocks
+radio.setGroup(1)
 basic.forever(() => {
     radio.sendString("I'm happy");
 })

package/docs/reference/radio/on-received-value.md

@@ -27,6 +27,7 @@ thing from nearby @boardname@s, show the numbers as a
 [bar graph](/reference/led/plot-bar-graph).
 
 ```blocks
+radio.setGroup(1)
 basic.forever(() => {
     radio.sendValue("accel-x", input.acceleration(Dimension.X))
 })

package/docs/reference/radio/received-packet.md

@@ -28,6 +28,7 @@ This program uses the signal strength from received packets to graph the
 approximate distance between two @boardname@s.
 
 ```blocks
+radio.setGroup(1)
 basic.forever(() => {
     radio.sendNumber(0)
 })

package/docs/reference/radio/send-buffer.md

@@ -19,6 +19,7 @@ If you load this program onto two @boardname@s, each board will send the level i
 ```typescript
 let ax = 0;
 let ay = 0;
+radio.setGroup(6)
 basic.forever(() => {
     ax = input.acceleration(Dimension.X);
     ay = input.acceleration(Dimension.Y);

package/docs/reference/radio/send-string.md

@@ -26,6 +26,7 @@ code word from one of them to the others by pressing button `A`.  The
 other @boardname@s will receive the code word and then show it.
 
 ```blocks
+radio.setGroup(1)
 input.onButtonPressed(Button.A, () => {
     radio.sendString("Codeword: TRIMARAN")
     basic.showString("SENT");

package/docs/reference/radio/set-group.md

@@ -20,6 +20,14 @@ to talk to each other because they will have the same group ID.
 
 * **id**: a [number](/types/number) from ``0`` to ``255``.
 
+### ~ reminder
+
+#### Default radio group
+
+If you haven't set a radio group for the @boardname@, it will use one selected randomly. If you are transmiting data to a @boardname@ that has a different hardware version from the sending @boardname@, it will select a random default group that is not the same as the other @boardname@. To be certain that your program will send or receive data using the same radio group, you will need to first choose and set a radio group for your program if you want it to work between different versions of the @boardname@.
+
+### ~
+
 ## Simulator
 
 This function only works on the @boardname@, not in browsers.

package/docs/reference/radio/write-received-packet-to-serial.md

@@ -40,6 +40,7 @@ the second @boardname@), this program sends temperature data to the
 serial port.
 
 ```blocks
+radio.setGroup(44)
 input.onButtonPressed(Button.A, function () {
     radio.sendNumber(input.temperature())
     radio.sendValue("temp", input.temperature())