pxt-microbit 7.1.40 → 7.1.43

package/docs/courses/csintro/algorithms.md

@@ -17,10 +17,6 @@ Students will...
 3. [**Activity**: Happy face, sad face](/courses/csintro/algorithms/activity)
 4. [**Project**: Fidget cube](/courses/csintro/algorithms/project)
 
-## Flipgrid
-
-The [Flipgrid](https://info.flipgrid.com/) topic for the **Algorithms** lesson: https://flipgrid.com/31ed5382
-
 ## Related standards
 
 [Targeted CSTA standards](/courses/csintro/algorithms/standards)

package/docs/courses/csintro/arrays.md

@@ -28,10 +28,6 @@ Students will...
 3. [**Activity**: Headband charades](/courses/csintro/arrays/activity)
 4. [**Project**: Musical instrument ](/courses/csintro/arrays/project)
 
-## Flipgrid
-
-The [Flipgrid](https://info.flipgrid.com/) topic for the **Arrays** lesson: https://flipgrid.com/f0f1bbc5
-
 ## Related standards
 
 [Targeted CSTA standards](/courses/csintro/arrays/standards)

package/docs/courses/csintro/binary.md

@@ -27,10 +27,6 @@ Students will...
 3. [**Activity**: Binary transmogrifier](/courses/csintro/binary/activity)
 4. [**Project**: Make binary a cash register](/courses/csintro/binary/project)
 
-## Flipgrid
-
-The [Flipgrid](https://info.flipgrid.com/) topic for the **Binary** lesson: https://flipgrid.com/d44cd204
-
 ## Related standards
 
 [Targeted CSTA standards](/courses/csintro/binary/standards)

package/docs/courses/csintro/booleans.md

@@ -26,10 +26,6 @@ Students will...
 3. [**Activity**: Double coin flipper](/courses/csintro/booleans/activity)
 4. [**Project**: Boolean](/courses/csintro/booleans/project)
 
-## Flipgrid
-
-The [Flipgrid](https://info.flipgrid.com/) topic for the **Booleans** lesson: https://flipgrid.com/36e0c7e0
-
 ## Related standards
 
 [Targeted CSTA standards](/courses/csintro/booleans/standards)

package/docs/courses/csintro/conditionals.md

@@ -20,10 +20,6 @@ Students will...
 3. [**Activity**: Rock, paper, scissors](/courses/csintro/conditionals/activity)
 4. [**Project**: Board game](/courses/csintro/conditionals/project)
 
-## Flipgrid
-
-The [Flipgrid](https://info.flipgrid.com/) topic for the **Conditionals** lesson: https://flipgrid.com/f260eda7
-
 ## Related standards
 
 [Targeted CSTA standards](/courses/csintro/conditionals/standards)

package/docs/courses/csintro/coordinates.md

@@ -31,10 +31,6 @@ Students will...
 3. [**Activity**: Animation and patterns](/courses/csintro/coordinates/activity)
 4. [**Project**: Screensaver or game](/courses/csintro/coordinates/project)
 
-## Flipgrid
-
-The [Flipgrid](https://info.flipgrid.com/) topic for the **Coordinates** lesson: https://flipgrid.com/699ca0b7
-
 ## Related standards
 
 [Targeted CSTA standards](/courses/csintro/coordinates/standards)

package/docs/courses/csintro/iteration.md

@@ -29,10 +29,6 @@ Students will...
 3. [**Activity**: Loops demos](/courses/csintro/iteration/activity)
 4. [**Project**: Get loopy](/courses/csintro/iteration/project)
 
-## Flipgrid
-
-The [Flipgrid](https://info.flipgrid.com/) topic for the **Iteration** lesson: https://flipgrid.com/ee559ab7
-
 ## Related standards
 
 [Targeted CSTA standards](/courses/csintro/iteration/standards)

package/docs/courses/csintro/making.md

@@ -22,10 +22,6 @@ Students will...
 * [**Activity**: MakeCode download](/courses/csintro/making/activity)
 * [**Project**: micro:pet (including mods and rubric)](/courses/csintro/making/project)
 
-## Flipgrid
-
-The [Flipgrid](https://info.flipgrid.com/) topic for the **Making** lesson: https://flipgrid.com/5773f935
-
 ## Related standards
 
 [Targeted CSTA standards](/courses/csintro/making/standards)

package/docs/courses/csintro/radio.md

@@ -26,10 +26,6 @@ Students will...
 3. [**Activity**: Marco Polo and Morse code](/courses/csintro/radio/activity)
 4. [**Project**: Radio project](/courses/csintro/radio/project)
 
-## Flipgrid
-
-The [Flipgrid](https://info.flipgrid.com/) topic for the **Radio** lesson: https://flipgrid.com/eb9af729
-
 ## Related standards
 
 [Targeted CSTA standards](/courses/csintro/radio/standards)

package/docs/courses/csintro/variables.md

@@ -23,10 +23,6 @@ Students will...
 3. [**Activity**: Make a Game Scorekeeper](/courses/csintro/variables/activity)
 4. [**Project**: Everything Counts](/courses/csintro/variables/project)
 
-## Flipgrid
-
-The [Flipgrid](https://info.flipgrid.com/) topic for the **Variables** lesson: https://flipgrid.com/dc42bdcc
-
 ## Related standards
 
 [Targeted CSTA standards](/courses/csintro/variables/standards)

package/docs/courses/csintro.md

@@ -38,10 +38,6 @@ Each of the 12 lessons is structured in this format:
 * Assessment - A project rubric and guidance for grading the project.
 * Standards - A list of CSTA K-12 Computer Science Standards and/or concepts covered by this lesson.
 
-### Course on Flipgrid
-
-Flipcode for the **Intro to CS** course grid: **[csintromicrobit](https://flipgrid.com/csintromicrobit)**
-
 ## Course contents
 
 * [About](/courses/csintro/about)

package/docs/extensions/extension-gallery.md

@@ -867,6 +867,10 @@ Many extensions are available to work with interface kits, add-on hardware, or o
 
 ```codecard
 [{
+    "name": "Elecfreaks Petal:bit",
+    "url": "/pkg/elecfreaks/pxt-petal",
+    "cardType": "package"
+}, {
     "name": "Joy IT RFID Module MFRC-522",
     "url": "/pkg/joy-it/pxt-rfid-mfrc522",
     "cardType": "package"

package/docs/projects/games.md

@@ -151,8 +151,4 @@ Fun games to build with your @boardname@.
   "url":"/projects/crashy-bird",
   "imageUrl":"/static/mb/projects/crashy-bird.png"
 }]
-```
-
-## Flipgrid
-
-https://flipgrid.com/makecodemicrobit
+```

package/docs/projects/guitar.md

@@ -37,8 +37,4 @@ https://youtu.be/GYmdTFvxz80
 
 Let's get started!
 
-## ~
-
-## Flipgrid
-
-https://flipgrid.com/e302fe4b
+## ~

package/docs/projects/inchworm.md

@@ -40,8 +40,4 @@ https://youtu.be/BiZLjugXMbM
 
 Let's get started!
 
-## ~
-
-## Flipgrid
-
-https://flipgrid.com/1b675b12
+## ~

package/docs/projects/reaction-time.md

@@ -31,8 +31,4 @@ https://youtu.be/doHwknM7HbQ
 
 Let's get started!
 
-## ~
-
-## Flipgrid
-
-https://flipgrid.com/7120893b
+## ~

package/docs/projects/servo-calibrator.md

@@ -27,4 +27,4 @@ pins.servoWritePin(AnalogPin.P0, angle)
 
 ## See also
 
-[Brief Guide to Servos](https://www.kitronik.co.uk/pdf/a-brief-guide-to-servos.pdf)
+[Brief Guide to Servos](https://kitronik.co.uk/blogs/resources/servos-brief-guide)

package/docs/projects/wallet.md

@@ -21,10 +21,6 @@ Let's get started!
 
 ## ~
 
-## Flipgrid
-
-https://flipgrid.com/c616f092
-
 ## References
 
 The wallet built in this activity is inspired from the duct tape wallet in 

package/docs/projects/watch.md

@@ -29,10 +29,6 @@ Let's get started!
 
 ## ~
 
-## Flipgrid
-
-https://flipgrid.com/0398a822
-
 ## Additional coding activities
 
 * [Countdown timer](/projects/watch/timer)

package/docs/reference/music/built-in-playable-melody.md

@@ -47,4 +47,4 @@ music.play(music.builtInPlayableMelody(Melodies.Blues), music.PlaybackMode.InBac
 
 ## See also
 
-[built-in sound effect](/reference/music/builtin-sound-effect)
+[string playable](/reference/music/string-playable)

package/docs/reference/music/create-sound-expression.md

@@ -0,0 +1,68 @@
+# create Sound Expression
+
+Create a sound expression object for a sound effect.
+
+```sig
+music.createSoundExpression(WaveShape.Sine, 2000, 0, 1023, 0, 500, SoundExpressionEffect.None, InterpolationCurve.Linear)
+```
+
+A sound expression is set of parameters that describe a **[Sound](/types/sound)** that will last for some amount of time. These parameters specify a base waveform, frequency range, sound volume, and effects. Sound data is created as a [Sound](/types/sound) object and can then be [played](/reference/music/play) to the speaker, headphones, or at an output pin.
+
+## Parameters
+
+* **waveShape**: the primary shape of the waveform:
+>* `sine`: sine wave shape
+>* `sawtooth`: sawtooth wave shape
+>* `triangle`: triangle wave shape
+>* `square`: square wave shape
+>* `noise`: random noise generated wave shape
+* **startFrequency**: a [number](/types/number) that is the frequency of the waveform when the sound expression starts.
+* **endFrequency**: a [number](/types/number) that is the frequency of the waveform when the sound expression stops.
+* **startVolume**: a [number](/types/number) the initial volume of the sound expression.
+* **endVolume**: a [number](/types/number) the ending volume of the sound expression.
+* **duration**: a [number](/types/number) the duration in milliseconds of the sound expression.
+* **effect**: an effect to add to the waveform. These are:
+>* `tremolo`: add slight changes in volume of the sound expression.
+>* `vibrato`: add slight changes in frequency to the sound expression.
+>* `warble`: a combination of the `tremolo` and `vibrato` effects.
+* **interpolation**: controls the rate of frequency change in the sound expression.
+>* `linear`: the change in frequency is constant for the duration of the sound.
+>* `curve`: the change in frequency is faster at the beginning of the sound and slows toward the end.
+>* `logarithmic`: the change in frequency is rapid during the very first part of the sound.
+
+## Returns
+
+* a [sound](/types/sound) expression with the the desired sound effect parameters.
+
+## Examples
+
+### Sine wave sound
+
+Create a sound expression and assign it to a variable. Play the sound for the sound expression.
+
+```blocks
+let mySound = music.createSoundExpression(WaveShape.Sine, 2000, 0, 1023, 0, 500, SoundExpressionEffect.None, InterpolationCurve.Linear)
+music.play(mySound, music.PlaybackMode.UntilDone)
+```
+
+### Complex waveform sound
+
+Create a `triangle` wave sound expression with `vibrato` and a `curve` interpolation. Play the sound until it finishes.
+
+```typescript
+let mySound = music.createSoundExpression(
+    WaveShape.Triangle,
+    1000,
+    2700,
+    255,
+    255,
+    500,
+    SoundExpressionEffect.Vibrato,
+    InterpolationCurve.Curve
+    )
+music.play(mySound, music.PlaybackMode.UntilDone)
+```
+
+## See also
+
+[play](/reference/music/play)

package/docs/reference/music/play.md

@@ -1,43 +1,110 @@
 # play
 
-Play a sound expression.
+Play a song, melody, tone, or a sound effect from a playable music source.
 
 ```sig
-soundExpression.giggle.play()
+music.play(music.tonePlayable(262, music.beat(BeatFraction.Whole)), music.PlaybackMode.UntilDone)
 ```
 
-A sound expression is a preformatted set of tones that create a certain sound. There are several sounds to choose from. The sound is started and your program then continues.
+Music is played for a simple tone, a melody, or a song. Each of these music sources is called a [playable](/types/playable) object. The ``||music:play||`` block can take any of these playable objects and play them as sound output for your game.
 
 ### ~ reminder
 
+#### For micro:bit v2 only
+
 ![works with micro:bit V2 only image](/static/v2/v2-only.png)
 
 This block requires the [micro:bit V2](/device/v2) hardware. If you use this block with a micro:bit v1 board, you will see the **927** error code on the screen.
 
 ### ~
 
-## Parameters
+The simplest music source is a **tone**, on note play for a duration of time:
+
+```block
+music.play(music.tonePlayable(262, music.beat(BeatFraction.Whole)), music.PlaybackMode.UntilDone)
+```
 
-In blocks, the sound is selected from the list in the ``||music:play sound||`` block.
+Then, there is the **melody** which is a series of notes played at a certain speed, or `tempo`. You can create your own melody of choose a built-in one to play:
 
 ```block
-soundExpression.giggle.play()
+music.play(music.stringPlayable("D F E A E A C B ", 120), music.PlaybackMode.UntilDone)
+music.play(music.builtInPlayableMelody(Melodies.BaDing), music.PlaybackMode.UntilDone)
 ```
 
-When coding in JavaScript or Python, the sound is a ``soundExpression`` object which from which you run the ``play()`` function from. For example, to play the ``soaring`` sound, select ``soaring`` from the ``soundExpression`` namespace and run ``play()``:
+The most complex playable object is a **sound expression**. [Sound expressions](/reference/music/create-sound-expression) are composed in the [Sound Editor](/types/sound#sound-editing) using different parameters for making sound waves and effects..
 
-```typescript
-soundExpression.soaring.play()
+```block
+music.play(music.createSoundExpression(WaveShape.Sine, 5000, 0, 255, 0, 500, SoundExpressionEffect.None, InterpolationCurve.Linear), music.PlaybackMode.UntilDone)
 ```
 
-## Example
+## Parameters
+
+* **toPlay**: the [playable](/types/playable) object, or music source, to play.
+* **playbackMode**: the playback mode for continuing the program:
+>* `play until done`: play the music source in **toPlay** but wait to run the next part of the program until music play is done.
+>* `in background`: play the music source in **toPlay** but continue with the rest of the program before music play is done.
+>* `looping in background`: play the music source in **toPlay** but continue with the rest of the program before music play is done. The music will remain playing, returning to the first note of the music after its duration.
+
+### ~ hint
+
+#### Stop the music!
+
+You can stop any music currently playing with the ``||music:stop all sounds||`` block. This is useful if **playbackMode** is set to `in background looping` and you wish to stop the music for a scene change or respond to an event with a different sound.
+
+### ~
+
+## Examples #example
+
+### Play a melody
+
+Play a short melody created in the Melody Editor.
+
+```blocks
+music.play(music.stringPlayable("D F E A E A C B ", 120), music.PlaybackMode.UntilDone)
+```
+
+### Different music sources, one block to play them all
+
+Put 4 different playable music sources in an array. Play one after the other.
+
+```blocks
+let playables = [
+music.tonePlayable(262, music.beat(BeatFraction.Whole)),
+music.stringPlayable("D F E A E A C B ", 120),
+music.builtInPlayableMelody(Melodies.BaDing),
+music.createSoundExpression(WaveShape.Sine, 5000, 0, 255, 0, 500, SoundExpressionEffect.None, InterpolationCurve.Linear)
+]
+for (let someMusic of playables) {
+    music.play(someMusic, music.PlaybackMode.UntilDone)
+    basic.pause(500)
+}
+```
+
+### Looping music play
+
+Play a simple song in the background. When the @boardname@ is shaken, stop the song an play the `power down` melody.
+
+```blocks
+music.play(music.stringPlayable("C5 A B G A F A C5 ", 120), music.PlaybackMode.LoopingInBackground)
+input.onGesture(Gesture.Shake, function () {
+    music.stopAllSounds()
+    music.play(music.builtInPlayableMelody(Melodies.PowerDown), music.PlaybackMode.InBackground)
+})
+```
+### Play a sound effect
 
-Play the ``twinkle`` sound on the speaker.
+Play a sine wave sound effect for `5` seconds.
 
 ```blocks
-soundExpression.twinkle.play()
+music.play(music.createSoundExpression(WaveShape.Sine, 5000, 0, 255, 0, 5000, SoundExpressionEffect.None, InterpolationCurve.Linear), music.PlaybackMode.UntilDone)
 ```
 
 ## See also
 
-[play until done](/reference/music/play-until-done)
+[tone playable](/reference/music/tone-playable),
+[string playable](/reference/music/string-playable),
+[melody playable](/reference/music/built-in-melody-playable),
+[create song](/reference/music/create-song),
+[stop all sounds](/reference/music/stop-all-sounds),
+[sound editor](/reference/types/sound#sound-editing),
+[create sound expression](/reference/music/create-sound-expression)

package/docs/test/courses/csintro.md

@@ -38,10 +38,6 @@ Each of the 12 lessons is structured in this format:
 * Assessment - A project rubric and guidance for grading the project.
 * Standards - A list of CSTA K-12 Computer Science Standards and/or concepts covered by this lesson.
 
-### Course on Flipgrid
-
-Flipcode for the **Intro to CS** course grid: **[csintromicrobit](https://flipgrid.com/csintromicrobit)**
-
 ## Course contents
 
 * [About](/test/courses/csintro/about)

package/docs/types/playable.md

@@ -22,6 +22,14 @@ Melodies are a series of notes and a tempo to play them at.
 music.stringPlayable("D F E A E A C B ", 120)
 ```
 
+### Sound Expression
+
+A sound expression is set of parameters that describe a **[sound](/types/sound)** that will last for some amount of time. These parameters specify a base waveform, frequency range, sound volume, and effects.
+
+```block
+music.play(music.createSoundExpression(WaveShape.Sine, 5000, 0, 255, 0, 500, SoundExpressionEffect.None, InterpolationCurve.Linear), music.PlaybackMode.UntilDone)
+```
+
 ## Play the music
 
 In your programs, you can simply use the ``||music:play||`` blocks for each playable object. Like this one for tone:
@@ -47,5 +55,5 @@ for (let someMusic of playables) {
 
 ## See also
 
-[play](/reference/music/play), [tone playable](/reference/music/tone-playable),
-[string playable](/reference/music/string-playable)
+[play](/reference/music/play), [tone playable](/reference/music/tone-playable)
+[string playable](/reference/music/string-playable), [create sound expression](/reference/music/create-sound-expression)

package/docs/types/sound.md

@@ -15,8 +15,8 @@ In code, a **Sound** type is a complex data object that includes data for all th
 Code for creating and playing a sound from a sound expression could look like this:
 
 ```typescript-ignore
-let mySound = music.createSoundEffect(WaveShape.Sine, 2000, 0, 1023, 0, 500, SoundExpressionEffect.None, InterpolationCurve.Linear)
-music.playSoundEffect(mySound, SoundExpressionPlayMode.UntilDone)
+let mySound = music.createSoundExpression(WaveShape.Sine, 2000, 0, 1023, 0, 500, SoundExpressionEffect.None, InterpolationCurve.Linear)
+music.play(mySound, music.PlaybackMode.UntilDone)
 ```
 
 ### ~
@@ -59,7 +59,7 @@ A square wave has both verical rising and falling edges with a flat section on t
 
 ### Noise wave
 
-The noise wave is created using random frequenices and volume. Setting the frequency parameters for the sound expression creates a "tuning" range for the noise sound effect.
+The noise wave is created using random frequencies and volume. Setting the frequency parameters for the sound expression creates a "tuning" range for the noise sound effect.
 
 ![Noise wave](/static/types/sound/noise-wave.png)
 
@@ -85,9 +85,9 @@ The volume controls the loudness (amplitude) of the sound. The sound can start w
 
 ## Frequency
 
-Frequency is how fast a wave repeats itself from the zero line to its peak down to its trough and back to the zero line. If it does this 1000 times in one second then the frequency has 1000 cycles per second and is measured in units of Hertz (1000 Hz). The frequency of the sound at any point in time is its current _pitch_. Musical notes and parts of speech are different frequecies that last for short periods of time in a sound.
+Frequency is how fast a wave repeats itself from the zero line to its peak down to its trough and back to the zero line. If it does this 1000 times in one second then the frequency has 1000 cycles per second and is measured in units of Hertz (1000 Hz). The frequency of the sound at any point in time is its current _pitch_. Musical notes and parts of speech are different frequencies that last for short periods of time in a sound.
 
-A sound expression has both a starting frequency and an ending frequecy. The frequency can start low and end high, start high and end low, or remain the same for the duration of the sound.
+A sound expression has both a starting frequency and an ending frequency. The frequency can start low and end high, start high and end low, or remain the same for the duration of the sound.
 
 ### High to low
 
@@ -132,5 +132,5 @@ Interpolation is how the sound expression will make the changes in frequency or
 
 ## See also
 
-[play sound effect](/reference/music/play-sound-effect),
-[create sound effect](/reference/music/create-sound-effect)
+[play](/reference/music/play),
+[create sound expression](/reference/music/create-sound-expression)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pxt-microbit",
-    "version": "7.1.40",
+    "version": "7.1.43",
     "description": "micro:bit target for Microsoft MakeCode (PXT)",
     "keywords": [
         "JavaScript",
@@ -45,8 +45,8 @@
         "typescript": "4.8.3"
     },
     "dependencies": {
-        "pxt-common-packages": "12.3.30",
-        "pxt-core": "11.4.25"
+        "pxt-common-packages": "12.3.31",
+        "pxt-core": "11.4.29"
     },
     "overrides": {
         "@blockly/field-colour": {

package/pxtarget.json

@@ -7,6 +7,7 @@
     "corepkg": "core",
     "bundleddirs": [
         "libs/core",
+        "libs/audio-samples",
         "libs/radio",
         "libs/devices",
         "libs/bluetooth",
@@ -430,14 +431,18 @@
         "workspaceSearch": true,
         "allowPackageExtensions": true,
         "addNewTypeScriptFile": true,
-        "aiErrorHelp": true,
+        "enabledFeatures": {
+            "blocksErrorList": {},
+            "aiErrorHelp": {
+                "includeRegions": ["US"]
+            }
+        },
         "experiments": [
             "accessibleBlocks",
             "debugExtensionCode",
             "bluetoothUartConsole",
             "bluetoothPartialFlashing",
-            "identity",
-            "blocksErrorList"
+            "identity"
         ],
         "supportedExperiences": [
             "code-eval"

package/targetconfig.json

@@ -350,7 +350,6 @@
             "microsoft/pxt-jacdac/motor": {},
             "microsoft/pxt-jacdac/multitouch": {},
             "microsoft/pxt-jacdac/potentiometer": {},
-            "microsoft/pxt-jacdac/power": {},
             "microsoft/pxt-jacdac/pulse-oximeter": {},
             "microsoft/pxt-jacdac/rain-gauge": {},
             "microsoft/pxt-jacdac/real-time-clock": {},
@@ -477,6 +476,7 @@
             "ines-hpmm/pxt-luma-matrix": { "tags": [ "Lights and Display" ] },
             "team-bp/pxt-bplab": { "tags": [ "Science" ] },
             "jimd80/pxt-coderdojo-controller": { "tags": [ "Gaming" ] },
+            "elecfreaks/pxt-petal": { "tags": [ "Science" ] },
             "microsoft/pxt-simx-sample": {
                 "simx": {
                     "sha": "7301f5900879b85127482d79bab48f03c25690a8",
@@ -498,7 +498,7 @@
             },
             "jacdac/pxt-jacdac": {
                 "simx": {
-                    "sha": "1992ffbd37a7e28604e65cc16efa78a827543199",
+                    "sha": "c286f6312ba29f9acc9a153d7b852f37f31e62e3",
                     "devUrl": "https://jacdac.github.io/pxt-jacdac/"
                 }
             },
@@ -542,7 +542,6 @@
             "jacdac/pxt-jacdac/motor": {},
             "jacdac/pxt-jacdac/multitouch": {},
             "jacdac/pxt-jacdac/potentiometer": {},
-            "jacdac/pxt-jacdac/power": {},
             "jacdac/pxt-jacdac/pulse-oximeter": {},
             "jacdac/pxt-jacdac/rain-gauge": {},
             "jacdac/pxt-jacdac/real-time-clock": {},