pxt-microbit 5.1.2 → 5.1.3

package/docs/device/v2.md

@@ -58,7 +58,7 @@ The first thing to know is whether you have a micro:bit v1 or micro:bit v2 at ha
 ![micro:bit v1 and micro:bit v2 front side by side](/static/v2/front.jpg)
 
 * red power LED next to the USB connect
-* large black microphone component centrally located in the back and rotated by 45 degrees
+* large black speaker component centrally located in the back and rotated by 45 degrees
 * slanted radio antenna
 
 ![micro:bit v1 and micro:bit v2 back side by side](/static/v2/back.jpg)

package/docs/extensions.md

@@ -303,6 +303,10 @@ Check out [the accessories pages on microbit.org](https://microbit.org/buy/acces
     "name": "HTS221 Humidity and temperature",
     "url": "/pkg/makecode-extensions/HTS221",
     "cardType": "package"
+}, {
+    "name": "gator:UV UV Light sensor",
+    "url":"/pkg/sparkfun/pxt-gator-UV",
+    "cardType": "package"
 }]
 ```
 
@@ -415,6 +419,10 @@ Check out [the accessories pages on microbit.org](https://microbit.org/buy/acces
   "name": "Minode Kit",
   "url":"/pkg/minodekit/pxt-minode",
   "cardType": "package"
+}, {
+  "name": "DFRobot Boson Kit",
+  "url":"/pkg/dfrobot/pxt-dfrobot_bosonkit",
+  "cardType": "package"
 }]
 ```
 
@@ -485,6 +493,14 @@ Check out [the accessories pages on microbit.org](https://microbit.org/buy/acces
 
 ```codecard
 [{
+  "name": "MAKE&LEARN Didacbot",
+  "url":"/pkg/MakeAndLearn/pxt-didacbot",
+  "cardType": "package"
+}, {
+  "name": "Resolute Apprentice Car",
+  "url":"/pkg/resolute-support/pxt-apprentice_Car",
+  "cardType": "package"
+}, {
   "name": "Elecfreaks XGO",
   "url":"/pkg/elecfreaks/pxt-xgo",
   "cardType": "package"
@@ -743,6 +759,14 @@ Check out [the accessories pages on microbit.org](https://microbit.org/buy/acces
 
 ```codecard
 [{
+    "name": "Joy IT RFID Module MFRC-522",
+    "url": "/pkg/joy-it/pxt-rfid-mfrc522",
+    "cardType": "package"
+}, {
+  "name": "Joy-IT ADS1115",
+  "url":"/pkg/joy-it/pxt-ads1115",
+    "cardType": "package"
+}, {
   "name": "DFRobot Environment Science Board ",
   "url":"/pkg/DFRobot/pxt-DFRobot_Environment_Science",
   "cardType": "package"
@@ -872,6 +896,14 @@ Check out [the accessories pages on microbit.org](https://microbit.org/buy/acces
 ## Utilities
 ```codecard
 [{
+  "name": "Button clicks",
+  "url": "/pkg/bsiever/microbit-pxt-clicks",
+  "cardType": "package"
+}, {
+  "name": "Rotate Display",
+  "url":"/pkg/bsiever/microbit-pxt-rotate",
+  "cardType": "package"
+}, {
   "name": "Bluetooth HID",
   "url":"/pkg/bsiever/microbit-pxt-blehid",
   "cardType": "package"

package/docs/microcode.md

@@ -0,0 +1,27 @@
+# MicroCode
+
+[MicroCode](https://aka.ms/m9) is an experimental tile-based language and editor for young coders and coders with disabilities on the BBC micro:bit V2 (V1 not supported), inspired by Kodu Game Lab.
+
+## Getting started
+
+```codecard
+[{
+        "name": "Getting Started",
+        "description": "MicroCode is an experimental tile-based language and editor for young coders and coders with disabilities on the BBC micro:bit V2 (V1 not supported), inspired by Kodu Game Lab.",
+        "url":"https://microsoft.github.io/microcode",
+        "imageUrl": "/static/microcode/home.png"
+    },
+    {
+        "name": "User Guide",
+        "description": "Learn how to use MicroCode editor and language.",
+        "url": "https://microsoft.github.io/microcode/docs/manual",
+        "imageUrl": "/static/microcode/userguide.png"
+    },
+    {
+        "name": "Samples",
+        "description": "Annotated MicroCode programs with screen animations, sounds, radio messages and more.",
+        "url": "https://microsoft.github.io/microcode/docs/samples",
+        "imageUrl": "/static/microcode/samples.png"
+    }
+]
+```

package/docs/projects/SUMMARY.md

@@ -85,6 +85,8 @@
   * [Hack Your Headphones](/projects/hack-your-headphones)
   * [Banana Keyboard](/projects/banana-keyboard)
   * [Guitar](/projects/guitar)
+  * [Jonny's Bird](/projects/jonnys-bird)
+  * [Electric Guitar](/projects/electric-guitar)
 * [Toys](/projects/toys)
   * [Inchworm](/projects/inchworm)
   * [Milk Carton Robot](/projects/milk-carton-robot)
@@ -148,6 +150,10 @@
   * [Rotary Sound Bender](https://microsoft.github.io/jacdac-docs/clients/makecode/projects/rotary-sound-bender/)
   * [Sound LED](https://microsoft.github.io/jacdac-docs/clients/makecode/projects/sound-led/)
   * [Magnetic Sound Bender](https://microsoft.github.io/jacdac-docs/clients/makecode/projects/magnetic-sound-bender/)
+* [MicroCode for the new micro:bit (V2)](/microcode)
+  * [Getting Started](https://microsoft.github.io/microcode)
+  * [User Guide](https://microsoft.github.io/microcode/docs/manual)
+  * [Samples](https://microsoft.github.io/microcode/docs/samples)
 * [Behind the MakeCode Hardware](/behind-the-makecode-hardware)
   * [LEDs](https://youtu.be/qqBmvHD5bCw)
   * [Buttons](https://youtu.be/t_Qujjd_38o)

package/docs/projects/electric-guitar/code.md

@@ -0,0 +1,42 @@
+# Code
+
+Let's add code so that whenever we press or touch the foil chords it will produce sound.
+
+From the [Make](/projects/electric-guitar/make.md) project, we know that whenever user touches the chords, sound will be produced and diffrent chords will produce diffrent sounds.
+
+## Code your electric guitar
+
+Download this code to your micro:bit. It creates the tones that play when you press the foil strips on the guitar.
+
+```blocks
+input.onButtonPressed(Button.A, function () {
+    F = F / 2
+    A = A / 2
+    C = C / 2
+    E = E / 2
+})
+input.onPinPressed(TouchPin.P2, function () {
+    music.playTone(988, music.beat(BeatFraction.Whole))
+    music.playTone(165, music.beat(BeatFraction.Whole))
+    music.playTone(932, music.beat(BeatFraction.Whole))
+})
+input.onButtonPressed(Button.B, function () {
+    F = F * 2
+    A = A * 2
+    C = C * 2
+    E = E * 2
+})
+input.onPinPressed(TouchPin.P1, function () {
+    music.playTone(F, music.beat(BeatFraction.Half))
+    music.playTone(A, music.beat(BeatFraction.Half))
+    music.playTone(C, music.beat(BeatFraction.Half))
+})
+let E = 0
+let C = 0
+let A = 0
+let F = 0
+F = 349
+A = 440
+C = 523
+E = 659
+```

package/docs/projects/electric-guitar/make.md

@@ -0,0 +1,40 @@
+# Make
+
+A guitar is a plucked stringed musical instrument. Normally, the guitar is an expensive instrument, but here we create a cheap and convenient DIY instrument that can help you enjoy and play real chords on an electric micro:bit guitar. Have fun and enjoy playing the micro:bit guitar by shifting the pitch up and down octaves.
+
+## How it Works?
+
+When you touch pin **1** or pin **2** and **GND** it will play a broken chord, but now you can move the chord down an octave (lowering its pitch) by pressing button **A** and move it up an octave (raising its pitch) by pressing button **B**.
+
+The pitch (frequency) of a note doubles when you move up one octave: `middle A` has a frequency of 440Hz (440 vibrations per second), `high A` has a frequency of 880Hz. This is why making the vibrating part of guitar strings different lengths with your fingers changes the pitch of the note being played.
+
+## Materials you need
+
+* micro:bit and optional battery pack
+* 4 crocodile clip leads
+* cardboard, scissors, glue, tin foil
+* headphones, buzzer, or powered speaker
+
+## How to build and play your electric guitar
+
+Watch this video to see how to make your electric guitar and play it:
+
+https://youtu.be/Yocsl_80YsY
+
+You can connect the electric guitar to some headphones with some crocodile clips you attach to the phone jack.
+
+![Output connections for sound](/static/mb/projects/electric-guitar/connections.jpg)
+
+Here are two pictures of the finished electric guitar with its connections:
+
+![Electric guitar project 1](/static/mb/projects/electric-guitar/guitar-board1.jpg)
+
+![Electric guitar project 2](/static/mb/projects/electric-guitar/guitar-board2.jpg)
+
+Let's go on to code the guitar!
+
+### ~button /projects/electric-guitar/code
+
+Code
+
+### ~

package/docs/projects/electric-guitar.md

@@ -0,0 +1,27 @@
+# Electric Guitar
+
+## ~avatar avatar
+
+Make an electric guitar that you can play real chords with using the micro:bit.
+
+## ~
+
+https://youtu.be/Yocsl_80YsY
+
+## Materials
+
+* micro:bit and optional battery pack
+* 4 crocodile clip leads
+* cardboard, scissors, glue, tin foil
+* headphones, buzzer, or powered speaker
+
+## Activities
+
+* [Make](/projects/electric-guitar/make)  
+* [Code](/projects/electric-guitar/code)
+
+## ~button /projects/electric-guitar/make
+
+Let's get started!
+
+## ~

package/docs/projects/jonnys-bird.md

@@ -0,0 +1,110 @@
+# Jonny's Bird
+
+The ``||music:play sound||`` block lets you create and play complex sounds beyond the simple sequence of tones in a melody. You can choose a sound waveform, change its frequency or volume, and add custom effects. Here's a program you can code to create fun bird sounds when you shake or tilt the @boardname@!
+
+## Use acceleration to set frequency
+
+The acceleration in the `X`and `Y` dimensions are used to set the frequencies of the sound. Make two variables named ``||variables:currFreq||`` and ``||variables:lastFreq||``. One variable will hold the value for the current freqency as an input of accleration in the `X` direction. The other will remember the previous frequency value.
+
+Get a ``||loops:forever||`` block and pull the ``||variables:set currFreq||`` and ``||variables:set lastFreq||`` blocks into it. Change the value for ``||variables:set lastFreq||`` from `0` to ``||variables:currFreq||``.
+
+```blocks
+let currfreq = 0
+let lastfreq = 0
+basic.forever(function () {
+    currfreq = 0
+    lastfreq = currfreq
+})
+```
+
+Pull a ``||math:map from to||`` block into the value slot of the ``||variables:set currFreq||``. Use ``||input:acceleration (mg) x||`` as the mapping value, set the `from` value range as `-1024` and `1023`. Set the `to` value range as `0` and `5000`.
+
+```blocks
+let currfreq = 0
+let lastfreq = 0
+basic.forever(function () {
+    currfreq = Math.map(input.acceleration(Dimension.X), -1024, 1023, 1, 5000)
+    lastfreq = currfreq
+})
+```
+
+Go get a ``||music:play sound until done||`` block and place it in between the ``||variables:set currFreq||`` and ``||variables:set lastFreq||``.
+
+```blocks
+let currFreq = 0
+let lastFreq = 0
+basic.forever(function () {
+    currFreq = Math.map(input.acceleration(Dimension.X), -1024, 1023, 0, 5000)
+    music.playSoundEffect(music.createSoundEffect(WaveShape.Sine, 5000, 0, 255, 0, 500, SoundExpressionEffect.None, InterpolationCurve.Linear), SoundExpressionPlayMode.UntilDone)
+    lastFreq = currFreq
+})
+```
+
+Expand the sound effect parameters in ``||music:play sound until done||`` by clicking the **(+)** symbol. Duplicate **2** ``||math:map from to||`` blocks from ``||variables:set currFreq||`` and place one in the `start frequency` value and the other in the `end frequency` value. Change the acceleration direction in the `end frequency` value to the `y` direction.
+
+```blocks
+let currFreq = 0
+let lastFreq = 0
+basic.forever(function () {
+    currFreq = Math.map(input.acceleration(Dimension.X), -1024, 1023, 0, 5000)
+    music.playSoundEffect(music.createSoundEffect(WaveShape.Sine,
+        Math.map(input.acceleration(Dimension.X), -1024, 1023, 0, 5000),
+        Math.map(input.acceleration(Dimension.Y), -1024, 1023, 0, 5000),
+        255,
+        0,
+        500,
+        SoundExpressionEffect.None, InterpolationCurve.Linear), SoundExpressionPlayMode.UntilDone)
+    lastFreq = currFreq
+})
+```
+
+## Add duration and volume
+
+Click the **(+)** symbol again on the sound effect block inside of ``||music:play sound until done||``. This will show the volume parameters.
+
+Pull out **3** ``||math:pick random||`` blocks and put them in for the values of `duration`, `start volume`, and `end volume`. For `duration`, use a range of `40` to `100`. For both `start volume` and `end volume`, use a random range of `0` to `1024`. 
+
+```blocks
+let currFreq = 0
+let lastFreq = 0
+basic.forever(function () {
+    currFreq = Math.map(input.acceleration(Dimension.X), -1024, 1023, 0, 5000)
+    music.playSoundEffect(music.createSoundEffect(WaveShape.Sine,
+        Math.map(input.acceleration(Dimension.X), -1024, 1023, 0, 5000),
+        Math.map(input.acceleration(Dimension.Y), -1024, 1023, 0, 5000),
+        randint(0, 1024),
+        randint(0, 1024),
+        randint(40, 100),
+        SoundExpressionEffect.None, InterpolationCurve.Linear), SoundExpressionPlayMode.UntilDone)
+    lastFreq = currFreq
+})
+```
+
+## Set the effects
+
+Once again, click the **(+)** symbol again on the sound effect block inside of ``||music:play sound until done||``. The effects parameters will appear. Change the setting for `effect` to `vibrato` and change `interpolation` to `curve`.
+
+
+```blocks
+let currfreq = 0
+let lastfreq = 0
+basic.forever(function () {
+    currfreq = Math.map(input.acceleration(Dimension.X), -1024, 1023, 1, 5000)
+    music.playSoundEffect(music.createSoundEffect(
+    WaveShape.Sine,
+    Math.map(input.acceleration(Dimension.X), -1024, 1023, 1, 5000),
+    Math.map(input.acceleration(Dimension.Y), -1024, 1023, 1, 5000),
+    randint(0, 1024),
+    randint(0, 1024),
+    randint(40, 100),
+    SoundExpressionEffect.Vibrato,
+    InterpolationCurve.Curve
+    ), 
+    SoundExpressionPlayMode.UntilDone)
+    lastfreq = currfreq
+})
+```
+
+## Birds are singing!
+
+Transfer you program to the @boardname@, shake and tilt it. The birds are singing!

package/docs/projects/music.md

@@ -20,5 +20,15 @@ Get your headphone and let's do music!
   "url":"/projects/guitar",
   "description": "An awesome cardboard guitar project, get ready to riff!",
   "imageUrl":"/static/mb/projects/guitar.png"
+}, {
+  "name": "Jonny's Bird",
+  "url":"/projects/jonnys-bird",
+  "description": "Shake and tilt to make incredible bird sounds!",
+  "imageUrl":"/static/mb/projects/jonnys-bird.png"
+}, {
+  "name": "Electric Guitar",
+  "url":"/projects/electric-guitar",
+  "description": "Make an electric guitar that you can play real chords with using the micro:bit!",
+  "imageUrl":"/static/mb/projects/electric-guitar.png"
 }]
 ```

package/docs/projects/red-light-green-light.md

@@ -203,7 +203,7 @@ basic.forever(function () {
 basic.forever(function () {
     if (state == REDLIGHT) {
         movement = Math.abs(input.acceleration(Dimension.Strength) - 1000)
-        if (movement != 0) {
+        if (movement > 100) {
             game.gameOver()
         }
     }

package/docs/projects.md

@@ -73,6 +73,11 @@
         "url": "/jacdac",
         "imageUrl": "/static/jacdac/getting-started.jpg"
     },
+    {
+        "name": "MicroCode for the new micro:bit (V2)",
+        "url": "/microcode",
+        "imageUrl": "/static/microcode/home.png"
+    },
     {
         "name": "Behind the MakeCode Hardware",
         "url": "/behind-the-makecode-hardware",
@@ -117,6 +122,7 @@
 [Blocks to JavaScript](/courses/blocks-to-javascript),
 [Courses](/courses),
 [Jacdac](/jacdac),
+[MicroCode for the new micro:bit (V2)](/microcode),
 [Behind the MakeCode Hardware](/behind-the-makecode-hardware),
 [Science Experiments](/science-experiments),
 [Coding for Teachers](/coding-for-teachers),

package/docs/reference/music/beat.md

@@ -1,17 +1,11 @@
 # Beat
 
-Returns the duration of a beat in milli-seconds
+Returns the duration of a beat in milliseconds
 
 ```sig
 music.beat(BeatFraction.Whole)
 ```
 
-## ~ hint
-
-**Simulator**: This function only works on the @boardname@ and in some browsers.
-
-## ~
-
 ## Parameters
 
 * ``BeatFraction`` means fraction of a beat (BeatFraction.Whole, BeatFraction.Sixteenth etc) 

package/docs/reference/music/change-tempo-by.md

@@ -7,11 +7,13 @@ faster or slower by the amount you say.
 music.changeTempoBy(20)
 ```
 
-## ~ hint
+### ~hint
 
-**Simulator**: This function only works on the @boardname@ and in some browsers.
+#### Simulator
 
-## ~
+``||music:change tempo by||`` works on the @boardname@. It might not work in the simulator on every browser.
+
+### ~
 
 ## Parameters
 

package/docs/reference/music/play-tone.md

@@ -1,39 +1,52 @@
 # Play Tone
 
-Play a musical tone through pin ``P0`` of the @boardname@ for as long as you say.
-
-## ~ hint
-
-This function only works on the @boardname@ and in some browsers.
-
-## ~
+Play a musical tone on the speaker or at a sound pin of the @boardname@ for as long as you say.
 
 ```sig
 music.playTone(440, 120)
 ```
+The frequency of the tone is set as a number of cycle per second, or Hertz. The [note frequency](/reference/music/note-frequency) block will allow you to use a musical note for the tone instead of a number of Hertz.
+
+The duration of the tone is set as a number of milliseconds. It's typical though to use a number of beats or a beat fraction for the tone duration instead. The ``||music:beat||`` block is used to convert beats to milliseconds. You can also make a custom duration by just setting the tone duration to certain amount of milliseconds.
+
+### ~hint
+
+#### Simulator
+
+The ``||music:play tone||`` block works on the @boardname@ board. It might not work in the simulator on every browser.
+
+### ~
 
 ## Parameters
 
-* ``frequency`` is the [number](/types/number) of Hertz (how high or low the tone is).
-* ``ms`` is the [number](/types/number) of milliseconds that the tone lasts
+* **frequency** is the [number](/types/number) of Hertz (how high or low the tone is). You can set this value with a note instead by using the [note frequency](/reference/music/note-frequency) block.
+* **ms** is the [number](/types/number) of milliseconds for the duration of the tone. A [beat](/reference/music/beat) value is used instead as the block's default tone duration. The number of beats is converted to milliseconds for you.
+
 
 ## Example
 
-This example stores the musical note C in the variable `freq`.
-Next, it plays that note for 1000 milliseconds (one second).
+### Tone and beat
+
+Play a `Middle C` for `1 beat`.
 
 ```blocks
-let freq = music.noteFrequency(Note.C)
-music.playTone(freq, 1000)
+music.playTone(music.noteFrequency(Note.C), music.beat(BeatFraction.Whole))
 ```
 
+### Custom tone frequency and duration
+
+Play a `250` Hertz tone for `1000` milliseconds.
+
+```blocks
+music.playTone(250, 1000)
+```
 
 ## Using other pins
 
-Use [analogSetPitchPin](/reference/pins/analog-set-pitch-pin) to change that pin used to generate music.
+Use [analogSetPitchPin](/reference/pins/analog-set-pitch-pin) to change the pin used to generate music.
 
 ```blocks
-pins.analogSetPitchPin(AnalogPin.P1);
+pins.analogSetPitchPin(AnalogPin.P1)
 ```
 
 ## See also

package/docs/reference/music/rest.md

@@ -1,29 +1,47 @@
 # Rest
 
-Rest (play no sound) through pin `PO` for the amount of time you say.
+Play no sound (rest) on the speaker or at a sound pin for the amount of time you say.
 
 ```sig
 music.rest(400)
 ```
 
-### ~ hint
+The duration of the rest is set as a number milliseconds. Instead, it's typical to use a number of beats or a beat fraction for a rest. The ``||music:beat||`` block is used to convert beats to milliseconds. You can also make a custom rest by setting the rest duration to certain amount of milliseconds.
 
-**Simulator**: This function only works on the @boardname@ and in some browsers.
+### ~hint
 
-## ~
+#### Simulator
+
+The ``||music:rest||`` block works on the @boardname@ board. It might not work in the simulator on every browser.
+
+### ~
 
 ## Parameters
 
-* ``ms`` is a [number](/types/number) saying how many
-  milliseconds the @boardname@ should rest. One second is 1000
-  milliseconds.
+* **ms** is the [number](/types/number) of milliseconds for the duration of the rest. A [beat](/reference/music/beat) value is used instead as the block's default rest duration. The number of beats is converted to milliseconds for you.
 
 ## Example
 
+### Middle C loop
+
+Continuously play a `Middle C` tone for `1` beat and rest for `2` beats.
+
+```blocks
+basic.forever(function () {
+    music.playTone(262, music.beat(BeatFraction.Whole))
+    music.rest(music.beat(BeatFraction.Double))
+})
+```
+
+### Custom rest time
+
+Continuously play a `Middle C` note followed by a random rest time.
+
 ```blocks
-let frequency = music.noteFrequency(Note.C)
-music.playTone(frequency, 1000)
-music.rest(1000)
+basic.forever(function () {
+    music.playTone(262, music.beat(BeatFraction.Whole))
+    music.rest(randint(500, 2000))
+})
 ```
 
 ## See also

package/docs/reference/music/ring-tone.md

@@ -1,22 +1,23 @@
 # Ring Tone
 
-Play a musical tone through pin `P0` with the pitch as high or low as you say.
-The tone will keep playing until you tell it not to.
+Play a musical tone on the speaker or at a sound pin of the @boardname@ with the pitch as high or low as you say. The tone will keep playing until you tell it not to.
 
 ```sig
 music.ringTone(440)
 ```
 
-## ~ hint
+### ~hint
 
-**Simulator**: This function only works on the @boardname@ and in some browsers.
+#### Simulator
 
-## ~
+The ``||music:ring tone||`` block works on the @boardname@ board. It might not work in the simulator on every browser.
+
+### ~
 
 ## Parameters
 
 * ``frequency`` is a [number](/types/number) that says
-how high-pitched or low-pitched the tone is.  This
+how high-pitched or low-pitched the tone is. This
 number is in **Hz** (**Hertz**), which is a measurement of frequency
 or pitch.
 

package/docs/reference/music/set-tempo.md

@@ -5,11 +5,15 @@ Makes the tempo (speed of a piece of music) as fast or slow as you say.
 ```sig
 music.setTempo(60)
 ```
-## ~ hint
 
-**Simulator**: This function only works on the @boardname@ and in some browsers.
+### ~hint
+
+#### Simulator
+
+``||music:set tempo||`` works on the @boardname@. It might not work in the simulator on every browser.
+
+### ~
 
-## ~
 
 ## Parameters