pxt-microbit 6.1.2 → 6.1.4

package/docs/extensions.md

@@ -307,6 +307,10 @@ Check out [the accessories pages on microbit.org](https://microbit.org/buy/acces
     "name": "gator:UV UV Light sensor",
     "url":"/pkg/sparkfun/pxt-gator-UV",
     "cardType": "package"
+}, {
+    "name": "Sensirion SEN55 (Air Quality) Sensor",
+    "url":"/pkg/bsiever/pxt-sen55",
+    "cardType": "package"
 }]
 ```
 
@@ -427,6 +431,10 @@ Check out [the accessories pages on microbit.org](https://microbit.org/buy/acces
   "name": "Joy-IT Joy-Pi Advanced",
   "url":"/pkg/joy-it/pxt-RB-JoyPi-Advanced",
   "cardType": "package"
+}, {
+  "name": "FWD Edu Climate Action Kit Gen. 2 Kit",
+  "url":"/pkg/climate-action-kits/pxt-fwd-edu",
+  "cardType": "package"
 }]
 ```
 
@@ -680,6 +688,10 @@ Check out [the accessories pages on microbit.org](https://microbit.org/buy/acces
   "name": "Elecfreaks Cutebot",
   "url":"/pkg/elecfreaks/pxt-cutebot",
   "cardType": "package"
+}, {
+  "name": "Elecfreaks Cutebot Pro",
+  "url":"/pkg/elecfreaks/pxt-cutebot-pro",
+  "cardType": "package"
 }, {
   "name": "Kittenbot RobotBit",
   "url":"/pkg/kittenbot/pxt-robotbit",
@@ -912,6 +924,10 @@ Check out [the accessories pages on microbit.org](https://microbit.org/buy/acces
 ## Utilities
 ```codecard
 [{
+  "name": "Morse Code",
+  "url": "/pkg/bsiever/pxt-morse",
+  "cardType": "package"
+}, {
   "name": "Button clicks",
   "url": "/pkg/bsiever/microbit-pxt-clicks",
   "cardType": "package"

package/docs/projects/7-seconds.md

@@ -1,6 +1,6 @@
 # 7 seconds game
 
-## Introduction @unplugged
+## {Introduction @unplugged}
 
 The goal of this game is press a button after **exactly** 7 seconds!
 
@@ -8,7 +8,7 @@ The goal of this game is press a button after **exactly** 7 seconds!
 
 This game is inspired from the [flipping panckakes game](https://www.elecfreaks.com/blog/post/flipping-pancakes-microbit-game.html).
 
-## Step 1
+## {Step 1}
 
 The player starts the timer by pressing button **A**. We'll run the code run code when ``||input:button A is pressed||``.
 
@@ -18,7 +18,7 @@ input.onButtonPressed(Button.A, function () {
 })
 ```
 
-## Step 2
+## {Step 2}
 
 We need to remember the time when the button was pressed so that we can compute the elapsed time later on.
 Add code to store the ``||input:running time||`` in a ``||variables:start||`` variable.
@@ -31,7 +31,7 @@ input.onButtonPressed(Button.A, function () {
 })
 ```
 
-## Step 3
+## {Step 3}
 
 Show something on the screen so that the user knows that the timer has started...
 
@@ -44,7 +44,7 @@ input.onButtonPressed(Button.A, function () {
 })
 ```
 
-## Step 4
+## {Step 4}
 
 The player stops the timer by pressing button **B**. Add the code to run code when ``||input:button B is pressed||``.
 
@@ -54,7 +54,7 @@ input.onButtonPressed(Button.B, function () {
 })
 ```
 
-## Step 5
+## {Step 5}
 
 Compute the elapsed time as ``||input:running time||`` ``||math:minus||`` ``||variables:start||`` and store it into a new variable ``||variables:elapsed||``.
 
@@ -67,7 +67,7 @@ input.onButtonPressed(Button.B, function () {
 })
 ```
 
-## Step 6
+## {Step 6}
 
 Compute the ``||variables:score||`` of the game as the ``||math:absolute value||`` of the ``||math:difference||`` of ``||variables:elapsed||`` time from 7 seconds, which is 7000 milliseconds.
 
@@ -82,7 +82,7 @@ input.onButtonPressed(Button.B, function () {
 })
 ```
 
-## Step 7
+## {Step 7}
 
 Display the score on the screen and your game is ready!
 

package/docs/projects/carnival/button-points.md

@@ -0,0 +1,118 @@
+# Add Points with Buttons
+### @explicitHints true
+
+
+## Introduction @showdialog
+
+Let's add a point to your score when a button is pressed on the @boardname@!
+
+![A graphic depicting someone pressing a button](/static/mb/projects/points.png)
+
+
+## {Step 2}
+
+We 'll start by adding code to the ``||input:on button pressed||``<br/>
+container already in the workspace.
+
+💡 _You can click the arrow next to ``||input:A||`` and change to another button if you prefer._
+
+#### ~ tutorialhint
+```blocks
+input.onButtonPressed(Button.A, function() { })
+```
+
+## {Step 3}
+
+Open the  ``||variables:Variables||`` category<br/>
+and drag  ``||variables:change [score] by [1]||``<br/>
+into the empty ``||input:on button [A] [pressed]||``.
+
+#### ~ tutorialhint
+```blocks
+input.onButtonPressed(Button.A, function() {
+    score += 1
+    })
+```
+
+## {Step 4}
+
+Update the LEDs after you change the score by opening the <br/>
+``||basic:Basic||`` category and dragging ``||basic:show number [score]||``<br/>
+into **the end** of the ``||input:on button [A] [pressed]||`` container already in the workspace.
+
+#### ~ tutorialhint
+```blocks
+pins.onPulsed(DigitalPin.P0, PulseValue.High, function () {
+    score += 1
+    basic.showNumber(score)
+})
+```
+
+
+## {Step 4}
+
+Click the A button in the simulator to give your code a try.
+
+You should see the score go up each time the button is pressed.
+
+
+## {Step 5}
+
+**Add sound effects.**
+
+Open the ``||music:Music||`` category and <br/>
+drag ``||music:play [〰️] [in background]||`` <br/>
+into **the end** of the ``||input:on button [A] [pressed]||`` container in the workspace.
+
+
+#### ~ tutorialhint
+```blocks
+pins.onPulsed(DigitalPin.P0, PulseValue.High, function () {
+    score += 1
+    basic.showNumber(score)
+    music._playDefaultBackground(music.createSoundExpression(WaveShape.Square, 400, 600, 255, 0, 100, SoundExpressionEffect.Warble, InterpolationCurve.Linear), music.PlaybackMode.InBackground)
+})
+```
+
+
+## {Step 6}
+
+**Test again by pressing A**
+
+Your program should play a sound and increase your points with each click.
+
+💡 _You may need to unmute the simulator to hear your music._
+
+
+
+## {Step 7}
+
+If you have a @boardname@ connected, click ``|Download|`` and transfer your code.
+
+Now you're ready to attach your @boardname@ to your project and try it out!
+
+
+
+```blockconfig.global
+    music._playDefaultBackground(music.createSoundExpression(WaveShape.Square, 400, 600, 255, 0, 100, SoundExpressionEffect.Warble, InterpolationCurve.Linear), music.PlaybackMode.InBackground)
+    basic.showNumber(score)
+```
+
+
+```template
+input.onButtonPressed(Button.A, function() {})
+
+let score = 0
+score = 0
+basic.showNumber(score)
+```
+
+```ghost
+basic.showIcon(IconNames.Yes)
+    score += 1
+
+
+let score = 0
+basic.showNumber(score)
+
+```

package/docs/projects/carnival/circuit-win.md

@@ -0,0 +1,107 @@
+# Connect a Circuit to Win
+### @explicitHints true
+
+
+## Introduction @showdialog
+
+Let's detect a WIN when a circuit is completed on the @boardname@!
+
+![A graphic depicting a sad micro:bit after loss](/static/mb/projects/clap-lights.png)
+
+
+## {Step 2}
+
+We 'll start by adding code to the ``||input:on pin [P0] [pressed]||``<br/>
+container already in the workspace.
+
+💡 _You can click the arrow next to ``||input:P0||`` and change it to another pin if you prefer._
+
+#### ~ tutorialhint
+```blocks
+input.onPinPressed(TouchPin.P0, function () {})
+```
+
+## {Step 3}
+
+Open the  ``||basic:Basic||`` category<br/>
+and drag  ``||basic:show string ["WIN!"]||``<br/>
+into the empty ``||input:on pin [P0] [pressed]||`` container to display a message.
+
+#### ~ tutorialhint
+```blocks
+input.onPinPressed(TouchPin.P0, function () {
+    basic.showString("WIN!")
+})
+
+
+```
+
+## {Step 4}
+
+Click the pin marked **0** in the simulator to give your code a try.
+
+![An image of the pin you should click on the micro:bit](/static/mb/projects/p0.png)
+
+
+## {Step 5}
+
+**Add some drama with music.**
+
+Open the ``||music:Music||`` category and <br/>
+drag ``||music:play [melody] [in background]||`` <br/>
+into **the top** of the ``||input:on pin [P0] [pressed]||`` container in the workspace.
+
+
+#### ~ tutorialhint
+```blocks
+input.onPinPressed(TouchPin.P0, function () {
+    music._playDefaultBackground(music.builtInPlayableMelody(Melodies.Dadadadum), music.PlaybackMode.InBackground)
+    basic.showString("WIN!")
+})
+```
+
+
+## {Step 6}
+
+**Test again by clicking P0 in the simulator**
+
+Your program should play a song and scroll the word "WIN!".
+
+💡 _You may need to unmute the simulator to hear your music._
+
+
+
+## {Step 7}
+
+If you have a @boardname@ connected, click ``|Download|`` and transfer your code.
+
+Now you're ready to attach your @boardname@ to your project and try it out!
+
+
+💡 _Note that the **pin pressed** block requires the pin to be pressed **and** released before it will trigger._
+
+
+
+
+```blockconfig.global
+    music.play(music.builtinPlayableSoundEffect(soundExpression.soaring), music.PlaybackMode.InBackground)
+    basic.showString("WIN!")
+```
+
+
+```template
+input.onPinPressed(TouchPin.P0, function () { })
+```
+
+```ghost
+basic.showIcon(IconNames.Yes)
+input.onButtonPressed(Button.A, function () {
+    music.play(music.builtinPlayableSoundEffect(soundExpression.sad), music.PlaybackMode.InBackground)
+    music._playDefaultBackground(music.builtInPlayableMelody(Melodies.Funeral), music.PlaybackMode.InBackground)
+    basic.showString("Loss")
+})
+input.onPinPressed(TouchPin.P0, function () {
+    music.play(music.builtinPlayableSoundEffect(soundExpression.sad), music.PlaybackMode.InBackground)
+    basic.showString("WIN!")
+})
+```

package/docs/projects/carnival/shake-lose.md

@@ -0,0 +1,97 @@
+# Shake or Fall to Lose
+### @explicitHints true
+
+## Introduction @showdialog
+
+Let's detect a loss when the @boardname@ shakes or drops!
+
+![A graphic depicting a sad micro:bit after loss](/static/mb/projects/lose.png)
+
+## {Step 2}
+
+We 'll start by adding code to the ``||input:on shake||`` container already in the workspace.
+
+💡 _You can also click the arrow next to ``||input:shake||`` and change the action to ``||input:free fall||`` or another event in the library._
+
+#### ~ tutorialhint
+```blocks
+input.onGesture(Gesture.Shake, function() { })
+```
+
+## {Step 3}
+
+Open the  ``||basic:Basic||`` category<br/>
+and drag  ``||basic:show string ["Loss"]||``<br/>
+into the empty ``||input:on shake||`` container to display a message.
+
+#### ~ tutorialhint
+```blocks
+input.onGesture(Gesture.Shake, function() {
+    basic.showString("Loss")
+})
+
+
+```
+
+## {Step 4}
+
+Click the little white circle in the simulator next to **SHAKE** to give your code a try.
+
+![An image of the word SHAKE above the B button](/static/mb/projects/shake.png)
+
+
+## {Step 5}
+
+**Add some drama with music.**
+
+Open the ``||music:Music||`` category and <br/>
+drag ``||music:play [melody] [in background]||`` <br/>
+into **the top** of the ``||input:on shake||`` container in the workspace.
+
+
+#### ~ tutorialhint
+```blocks
+input.onGesture(Gesture.Shake, function() {
+    music._playDefaultBackground(music.builtInPlayableMelody(Melodies.Dadadadum), music.PlaybackMode.InBackground)
+    basic.showString("Loss")
+})
+```
+
+
+## {Step 6}
+
+**Test again by clicking ⚬SHAKE**
+
+Your program should play a song and scroll the word "Loss".
+
+💡 _You may need to unmute the simulator to hear your music._
+
+
+
+## {Step 7}
+
+If you have a @boardname@ connected, click ``|Download|`` and transfer your code.
+
+Now you're ready to attach your @boardname@ to your project and try it out!
+
+
+
+```blockconfig.global
+    music._playDefaultBackground(music.builtInPlayableMelody(Melodies.Funeral), music.PlaybackMode.InBackground)
+    basic.showString("Loss")
+    basic.showIcon(IconNames.Yes)
+```
+
+
+```template
+input.onGesture(Gesture.Shake, function() {})
+```
+
+```ghost
+basic.showIcon(IconNames.Yes)
+input.onButtonPressed(Button.A, function () {
+    music.play(music.builtinPlayableSoundEffect(soundExpression.sad), music.PlaybackMode.InBackground)
+    music._playDefaultBackground(music.builtInPlayableMelody(Melodies.Funeral), music.PlaybackMode.InBackground)
+    basic.showString("Loss")
+})
+```

package/docs/projects/coin-flipper.md

@@ -1,12 +1,12 @@
 # Coin Flipper
 
-## Introduction @unplugged
+## {Introduction @unplugged}
 
 Let's create a coin flipping program to simulate a real coin toss. We'll use icon images to represent a ``heads`` or ``tails`` result.
 
 ![Simulating coin toss](/static/mb/projects/coin-flipper/coin-flipper.gif)
 
-## Step 1
+## {Step 1}
 
 Let's start with the ``||input:on button A pressed||`` block on the Workspace. We'll put our coin flipping code in here.
 
@@ -15,7 +15,7 @@ input.onButtonPressed(Button.A, function() {
 })
 ```
 
-## Step 2
+## {Step 2}
 
 Grab an ``||logic:if else||`` block and set it inside ``||input:on button A pressed||``. Put a ``||Math:pick random true or false||`` into the ``||logic:if||`` as its condition.
 
@@ -29,7 +29,7 @@ input.onButtonPressed(Button.A, function() {
 })
 ```
 
-## Step 3
+## {Step 3}
 
 Now, put a ``||basic:show icon||`` block inside both the ``||logic:if||`` and the ``||logic:else||``. Pick images to mean ``heads`` and ``tails``.
 
@@ -43,11 +43,11 @@ input.onButtonPressed(Button.A, function() {
 })
 ```
 
-## Step 4
+## {Step 4}
 
 Press button **A** in the simulator to try the coin toss code.
 
-## Step 5
+## {Step 5}
 
 You can animate the coin toss to add the feeling of suspense. Place different ``||basic:show icon||`` blocks before the ``||logic:if||`` to show that the coin is flipping.
 
@@ -65,11 +65,11 @@ input.onButtonPressed(Button.A, function() {
 })
 ```
 
-## Step 6
+## {Step 6}
 
 If you have a @boardname@, connect it to USB and click ``|Download|`` to transfer your code.
 
-## Step 7
+## {Step 7}
 
 Press button **A** for a flip. Test your luck and guess ``heads`` or ``tails`` before the toss is over!
 

package/docs/projects/compass.md

@@ -1,14 +1,14 @@
 # Compass
 
-## Introduction @unplugged
+## {Introduction @unplugged}
 
-This tutorial will show you how to program a script that displays which direction the @boardname@ is pointing. Let's get started!
+This tutorial shows you how to create a program that displays which direction the @boardname@ is pointing. Let's get started!
 
 ![A cartoon of a compass](/static/mb/projects/a5-compass.png)
 
-## Step 1
+## {Step 1}
 
-Store the ``||input:compass heading||`` of the @boardname@ in a variable called ``||variables:degrees||`` in the ``||basic:forever||`` loop.
+First, store the ``||input:compass heading||`` of the @boardname@ in a variable called ``||variables:degrees||`` in the ``||basic:forever||`` loop.
 
 ```blocks
 basic.forever(function() {
@@ -16,7 +16,7 @@ basic.forever(function() {
 })
 ```
 
-## Step 2
+## {Step 2}
 
 ``||logic:If||`` ``||variables:degrees||`` is ``||logic:less than||`` `45`, 
 then the compass heading is mostly pointing toward **North**. ``||basic:Show||`` `N` on the @boardname@.
@@ -30,7 +30,7 @@ basic.forever(function() {
 })
 ```
 
-## Step 3
+## {Step 3}
 
 ``||logic:If||`` ``||variables:degrees||`` is less than `135`, the @boardname@ is mostly pointing **East**. ``||basic:Show||`` `E` on the @boardname@.
 
@@ -46,11 +46,11 @@ basic.forever(function() {
 })
 ```
 
-## Step 4
+## {Step 4}
 
 Go to the simulator and rotate the @boardname@ logo to simulate changes in the compass heading.
 
-## Step 5
+## {Step 5}
 
 ``||logic:If||`` ``||variables:degrees||`` is less than `225`, the @boardname@ is mostly pointing **South**. ``||basic:Show||`` `S` on the @boardname@.
 
@@ -69,7 +69,7 @@ basic.forever(function() {
 })
 ```
 
-## Step 6
+## {Step 6}
 
 ``||logic:If||`` ``||variables:degrees||`` is less than `315`, the @boardname@ is mostly pointing **West**. ``||basic:Show||`` `W` on the @boardname@.
 
@@ -89,7 +89,7 @@ basic.forever(function() {
 })
 ```
 
-## Step 7
+## {Step 7}
 
 ``||logic:If||`` none of these conditions returned true, then the @boardname@ must be pointing **North** again. Display `N` on the @boardname@.
 
@@ -114,13 +114,8 @@ basic.forever(function() {
 })
 ```
 
-## Step 8 @unplugged
+## {Step 9 @unplugged}
 
-If you have a @boardname@, click `|Download|` and follow the screen instructions. 
-You will have to follow the screen instructions to calibrate your compass.
+If you have a @boardname@, click `|Download|` and follow the screen instructions. You will have to follow the screen instructions to calibrate your compass.
 
 https://youtu.be/IL5grHtz_MU
-
-```template
-basic.forever(function() {})
-```

package/docs/projects/dice.md

@@ -1,13 +1,13 @@
 # Dice
 
-## Introduction @unplugged
+## {Introduction @unplugged}
 
-Let's turn the @boardname@ into a dice!
+Let's turn the @boardname@ into dice!
 (Want to learn how the accelerometer works? [Watch this video](https://youtu.be/byngcwjO51U)).
 
 ![A microbit dice](/static/mb/projects/dice.png)
 
-## Step 1
+## {Step 1}
 
 We need 3 pieces of code: one to detect a throw (shake), another to pick a random number, and then one to show the number.
 
@@ -19,44 +19,51 @@ input.onGesture(Gesture.Shake, function() {
 })
 ```
 
-## Step 2
+## {Step 2}
 
 Get a ``||basic:show number||`` block and place it inside the ``||input:on shake||`` block to display a number.
 
 ```blocks
 input.onGesture(Gesture.Shake, function() {
+    //@highlight
     basic.showNumber(0)
 })
 ```
 
-## Step 3
+## {Step 3}
 
 Put a ``||Math:pick random||`` block in the ``||basic:show number||`` block to pick a random number.
 
 ```blocks
 input.onGesture(Gesture.Shake, function() {
+    //@highlight
     basic.showNumber(randint(0, 10))
 })
 ```
 
-## Step 4
+## {Step 4}
 
 A typical dice shows values from `1` to `6`. So, in ``||Math:pick random||``, don't forget to choose the right minimum and maximum values!
 
 ```blocks
 input.onGesture(Gesture.Shake, function() {
+    //@highlight
     basic.showNumber(randint(1, 6))
 })
 ```
 
-## Step 5
+## {Step 5}
 
 Use the simulator to try out your code. Does it show the number you expected?
 
-## Step 6
+## {Step 6}
 
 If you have a @boardname@ connected, click ``|Download|`` and transfer your code to the @boardname@!
 
+```validation.global
+# BlocksExistValidator
+```
+
 ```template
 input.onGesture(Gesture.Shake, function() {})
 ```

package/docs/projects/flashing-heart.md

@@ -8,13 +8,13 @@ Learn how to use the LEDs and make a flashing heart!
 
 ![Heart shape in the LEDs](/static/mb/projects/flashing-heart/sim.gif)
 
-## Step 1 @fullscreen
+## {Step 1 @fullscreen}
 
 Place the ``||basic:show leds||`` block in the ``||basic:forever||`` block and draw a heart.
 
 ![An animation that shows how to drag a block and paint a heart](/static/mb/projects/flashing-heart/showleds.gif)
 
-## Step 2
+## {Step 2}
 
 Place another ``||basic:show leds||`` block. You can leave it blank and draw what you want.
 
@@ -35,11 +35,11 @@ basic.forever(function() {
 })
 ```
 
-## Step 3
+## {Step 3}
 
 Look at the virtual @boardname@, you should see the heart and your drawing blink on the screen.
 
-## Step 4
+## {Step 4}
 
 If you have a @boardname@ connected, click ``|Download|`` to transfer your code and watch the hearts flash!