pxt-microbit 4.0.9 → 4.0.13

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())

package/docs/reference/radio/write-value-to-serial.md

@@ -29,6 +29,7 @@ the second @boardname@), this program sends temperature data to
 serial.
 
 ```blocks
+radio.setGroup(1)
 input.onButtonPressed(Button.A, () => {
     radio.sendNumber(input.temperature());
 });

package/docs/v2tutorials.md

@@ -0,0 +1,39 @@
+# Projects
+
+Here are some cool tutorials to get you started with your new @boardname@ (V2)!
+
+## Basic
+
+```codecard
+[{
+  "name": "Pet Hamster",
+  "url":"/projects/v2-pet-hamster",
+  "description": "Interact with your very own micro:bit hamster named Cyrus.",
+  "imageUrl": "/static/mb/projects/pet-hamster.png",
+  "cardType": "tutorial"
+}, {
+  "name": "Countdown",
+  "url":"/projects/v2-countdown",
+  "description": "Create a musical countdown sequence.",
+  "imageUrl": "/static/mb/projects/countdown.png",
+  "cardType": "tutorial"
+}, {
+  "name": "Morse Chat",
+  "url":"/projects/v2-morse-chat",
+  "description": "Learn how to send morse code messages to a pig named Sky.",
+  "imageUrl": "/static/mb/projects/morse-chat.png",
+  "cardType": "tutorial"
+}, {
+  "name": "Clap Lights",
+  "url":"/projects/v2-clap-lights",
+  "description": "Turn your micro:bit's lights on or off when you clap.",
+  "imageUrl": "/static/mb/projects/clap-lights.png",
+  "cardType": "tutorial"
+}, {
+  "name": "Blow Away",
+  "url":"/projects/v2-blow-away",
+  "description": "Use the sound of your breath to blow a ghost named Haven away.",
+  "imageUrl": "/static/mb/projects/blow-away.png",
+  "cardType": "tutorial"
+}]
+```

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pxt-microbit",
-    "version": "4.0.9",
+    "version": "4.0.13",
     "description": "micro:bit target for Microsoft MakeCode (PXT)",
     "keywords": [
         "JavaScript",
@@ -45,6 +45,6 @@
     },
     "dependencies": {
         "pxt-common-packages": "9.0.1",
-        "pxt-core": "7.0.6"
+        "pxt-core": "7.0.8"
     }
 }

package/targetconfig.json

@@ -206,18 +206,34 @@
             "microsoft/pxt-data-streamer",
             "iBuilds/pxt-PTKidsBIT-Robot",
             "4tronix/EggBit",
-            "joy-it/SEN-MPU6050"
+            "joy-it/SEN-MPU6050",
+            "gomakekit/Hoverbit_V2",
+            "Matrix-Robotics/pxt-MatrixMicro",
+            "elecfreaks/pxt-PlanetX-AI",
+            "joy-it/pxt-SEN-Color",
+            "stemhub/pxt-Stemhubbit",
+            "KitronikLtd/pxt-kitronik-lab-bit",
+            "KitronikLtd/pxt-kitronik-128x64Display",
+            "monkmakes/monkmakes-7-segment",
+            "stemhub/pxt-StemhubCity",
+            "KittenBot/pxt-powerbrick"
         ],
         "preferredRepos": [
             "Microsoft/pxt-neopixel",
-            "Microsoft/pxt-microturtle",
-            "Tinkertanker/pxt-tinkercademy-tinker-kit",
+            "4tronix/BitBot",
+            "dfrobot/pxt-maqueen",
             "kittenbot/pxt-robotbit",
             "Microsoft/pxt-sonar",
-            "4tronix/BitBot",
+            "Microsoft/pxt-microturtle",
+            "Tinkertanker/pxt-tinkercademy-tinker-kit",
+            "seeed-studio/pxt-grove",
+            "elecfreaks/pxt-cutebot",
+            "dfrobot/pxt-dfrobot-maqueenplus",
+            "tinkertanker/pxt-iot-environment-kit",
+            "tinkertanker/pxt-ringbitcar",
             "kitronikltd/pxt-kitronik-servo-lite",
             "kitronikltd/pxt-kitronik-motor-driver",
-            "Tinkertanker/pxt-ringbitcar"
+            "tinkertanker/pxt-smarthome"
         ],
         "upgrades": {
             "tinkertanker/pxt-iot-environment-kit": "min:v4.2.1",
@@ -259,6 +275,7 @@
     },
     "galleries": {
         "Tutorials": "tutorials",
+        "Tutorials for the new micro:bit (V2)": "v2tutorials",
         "Live Coding": {
             "url": "live-coding",
             "shuffle": "daily",
@@ -272,7 +289,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": {
             "url": "behind-the-makecode-hardware",