pxt-microbit 4.1.43 → 4.1.46

package/docs/extensions.md

@@ -481,6 +481,10 @@ Check out [the accessories pages on microbit.org](https://microbit.org/buy/acces
 
 ```codecard
 [{
+  "name": "Elecfreaks XGO",
+  "url":"/pkg/elecfreaks/pxt-xgo",
+  "cardType": "package"
+}, {
   "name": "Robotixlab Theta",
   "url":"/pkg/4tronix/Theta",
   "cardType": "package"

package/docs/projects/v2-play-sound-long.md

@@ -0,0 +1,144 @@
+# Dance to the Beat
+
+## 1. Introduction @unplugged
+
+The new micro:bits have speakers, which leaves you free to move around in ways you weren't able to before!
+
+Let's use movement to create a beat box of your own.
+
+![Dance beat banner message](/static/mb/projects/dance-beat.png)
+
+
+## 2. Understanding Input
+
+Let's find out what numbers the micro:bit produces when you move it around.
+
+---
+
+⇼ Open the ``||serial:^ Advanced||`` category to show the ``||serial:Serial||`` label.
+
+⇼ From ``||serial:Serial||``, drag the ``||serial:serial write value ["x"] = [0]||``
+block into the ``||basic:forever||`` loop container.
+
+
+
+```blocks
+basic.forever(function(){
+    serial.writeValue("x", 0)
+})
+```
+
+
+
+## 3. See the Console
+
+When your code runs again, you'll see a button below the micro:bit that says
+"Show console Simulator".
+
+Click that button to see what happens.
+
+---
+
+The graph for the simulator should stay flat at 0
+and the text in the console below should say "x:0".
+
+
+
+## 4. Acceleration Values
+
+For the graph to change with the speed of your movement, we need to replace the "0"
+with the micro:bit **acceleration** value.
+
+---
+
+⇼ Open the ``||input:Input||`` category and drag ``||input:acceleration (mg) [x]||``
+over to replace "0" in the ``||serial:serial write value ["x"] = [0]||``
+block.
+
+⇼ Change "x" to "a" (for "acceleration".)
+
+
+
+```blocks
+basic.forever(function(){
+    serial.writeValue("a", input.acceleration(Dimension.X))
+})
+```
+
+
+
+## 5. Look Again
+
+Click the  "Show console Simulator" button again.
+
+---
+
+Now you should see your graph and text change between **-1023** and **1023** as you click
+around on the micro:bit simulator to pretend like you're swinging it around.
+
+
+
+## 6. Compass Values
+
+For the graph to change with the speed of your movement, we need to replace the "0" with
+the micro:bit **acceleration** value.
+
+---
+
+⇼ Open the ``||input:Input||`` category and drag ``||input:acceleration (mg) [x]||``
+over to replace "0" in the ``||serial:serial write value ["x"] = [0]||``
+block.
+
+⇼ Change "x" to "a" (for "acceleration".)
+
+
+
+```blocks
+basic.forever(function(){
+    serial.writeValue("a", input.acceleration(Dimension.X))
+})
+```
+
+## Finale
+
+👏 **YOU DID IT!** 👏
+
+Don't forget to test your code in the simulator!
+
+If you have a new @boardname@ (the one with the **shiny gold** logo at the top), download this code and try it out!
+
+```blocks
+basic.forever(function () {
+    serial.writeValue("Accel", input.acceleration(Dimension.X))
+    serial.writeValue("Compass", input.compassHeading())
+    music.playSoundEffect(music.createSoundEffect(
+    WaveShape.Sine,
+    input.acceleration(Dimension.X),
+    input.compassHeading(),
+    255,
+    0,
+    500,
+    SoundExpressionEffect.None,
+    InterpolationCurve.Linear
+    ), SoundExpressionPlayMode.UntilDone)
+})
+```
+
+```ghost
+
+basic.forever(function () {
+    serial.writeValue("Accel", input.acceleration(Dimension.X))
+    serial.writeValue("Compass", input.compassHeading())
+    music.playSoundEffect(music.createSoundEffect(
+    WaveShape.Sine,
+    input.acceleration(Dimension.X),
+    input.compassHeading(),
+    255,
+    0,
+    500,
+    SoundExpressionEffect.None,
+    InterpolationCurve.Linear
+    ), SoundExpressionPlayMode.UntilDone)
+})
+
+```

package/docs/projects/v2-play-sound.md

@@ -0,0 +1,167 @@
+# Dance to the Beat
+
+## 1. Introduction @unplugged
+
+The new micro:bit has speakers so you can hear sounds without being tied down!
+
+Let's use movement to create an electronic beat of our own.
+
+![Dance beat banner message](/static/mb/projects/dance-beat.png)
+
+
+## 2. Add Play Sound Block
+
+To start your electronic beat, you'll want to repeat a sound forever.
+
+---
+
+⇼ Open the ``||music:Music||`` category and drag the ``||music:play sound [♫ ∿∿∿∿ +] [until done]||``
+block into the empty ``||basic:forever||`` loop container.
+
+
+
+```blocks
+basic.forever(function(){
+    music.playSoundEffect(music.createSoundEffect(WaveShape.Sine, 5000, 0, 255, 0, 500, SoundExpressionEffect.None, InterpolationCurve.Linear), SoundExpressionPlayMode.UntilDone)
+})
+```
+
+
+
+## 3. Listen Close
+
+When your code runs again, you should hear a short laser/alarm
+sound that repeats over and over forever.
+
+---
+
+💡 _You can press the stop button (_⏹️_) beneath the simulator to prevent the noise from bothering you while you're coding._
+
+
+
+
+
+## 4. Make a Change
+
+For the sound to change with your speed of movement, we need to put the
+micro:bit **acceleration** value in the sound block.
+
+---
+
+⇼ On the ``||music:play sound [♫ ∿∿∿ +] [until done]||`` block, click the plus icon (**+**)
+to show the start frequency value of 5000.
+
+⇼ From the ``||input:Input||`` category, drag the ``||input:acceleration (mg) [x]||``
+value block to replace **5000**.
+
+
+```blocks
+basic.forever(function(){
+    music.playSoundEffect(music.createSoundEffect(WaveShape.Sine, input.acceleration(Dimension.X), 0, 255, 0, 500, SoundExpressionEffect.None, InterpolationCurve.Linear), SoundExpressionPlayMode.UntilDone)
+})
+```
+
+
+
+## 5. Listen Again
+
+Run your code again.
+
+---
+
+This time, hover around above the micro:bit to simulate swinging it from side to side.
+You should hear the sound change as the micro:bit moves.
+
+
+
+## 6. Rotation Values
+
+You can make the beat even more fun by changing the end frequency as the micro:bit rotates.
+
+---
+
+⇼ From the ``||input:...more||`` category, drag the ``||input:rotation (°) [pitch]||``
+value block to replace the frequency **0**.
+
+
+```blocks
+basic.forever(function(){
+    music.playSoundEffect(music.createSoundEffect(WaveShape.Sine, input.acceleration(Dimension.X), input.rotation(Rotation.Pitch), 255, 0, 500, SoundExpressionEffect.None, InterpolationCurve.Linear), SoundExpressionPlayMode.UntilDone)
+})
+```
+
+
+
+## 7. Listen Again
+
+Run your code again.
+
+
+This time, roll over the micro:bit in all directions to simulate turning it while you
+swing it around.
+
+---
+
+You should hear the sound change from high to low and low to high.
+
+Try moving the micro:bit in different ways. Can you make a fun beat?
+
+
+
+## 8. Customize Your Beat
+
+Try changing the **duration** of the beat to something other than **500**. <br/>
+Then, change the dropdown selection inside both the **acceleration** and **rotation**
+blocks.
+
+What else can you click on to edit your sound?
+
+
+
+
+## Finale
+
+👏 **YOU DID IT!** 👏
+
+Imagine how exciting this project will be when it's loaded on a micro:bit!
+
+If you have a micro:bit v2 (the one with the **shiny gold** logo at the top),
+download this code and hold your micro:bit while you dance.
+
+Congratulations, you are your own DJ!
+
+
+
+```blocks
+basic.forever(function () {
+    music.playSoundEffect(music.createSoundEffect(
+    WaveShape.Sine,
+    input.acceleration(Dimension.X),
+    input.rotation(Rotation.Pitch),
+    255,
+    0,
+    500,
+    SoundExpressionEffect.None,
+    InterpolationCurve.Linear
+    ), SoundExpressionPlayMode.UntilDone)
+})
+```
+
+```ghost
+
+basic.forever(function () {
+    serial.writeValue("Accel", input.acceleration(Dimension.X))
+    serial.writeValue("Rotation", input.rotation(Rotation.Pitch),)
+    music.playSoundEffect(music.createSoundEffect(
+    WaveShape.Sine,
+    input.acceleration(Dimension.X),
+    input.rotation(Rotation.Pitch),
+    255,
+    0,
+    500,
+    SoundExpressionEffect.None,
+    InterpolationCurve.Linear
+    ), SoundExpressionPlayMode.UntilDone)
+})
+
+```

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pxt-microbit",
-    "version": "4.1.43",
+    "version": "4.1.46",
     "description": "micro:bit target for Microsoft MakeCode (PXT)",
     "keywords": [
         "JavaScript",
@@ -44,7 +44,7 @@
         "typescript": "4.2.3"
     },
     "dependencies": {
-        "pxt-common-packages": "9.5.10",
-        "pxt-core": "7.5.42"
+        "pxt-common-packages": "9.5.11",
+        "pxt-core": "7.5.44"
     }
 }

package/targetconfig.json

@@ -249,7 +249,7 @@
             "bsiever/microbit-pxt-blehid",
             "DFRobot/pxt-DFRobot_Environment_Science",
             "ekkai/aicococam",
-
+            "elecfreaks/pxt-xgo",
             "microsoft/pxt-jacdac",
             "microsoft/pxt-jacdac/accelerometer",
             "microsoft/pxt-jacdac/acidity",
@@ -759,7 +759,11 @@
             "smarthon/pxt-smartcity": { "tags": [ "Kits" ] },
             "aorczyk/soroban": { "tags": [ "Utilities" ] },
             "aorczyk/pf-recorder": { "tags": [ "Utilities" ] },
-            "4tronix/theta": { "tags": [ "Robotics" ] }
+            "4tronix/theta": { "tags": [ "Robotics" ] },
+            "bsiever/microbit-pxt-blehid": {},
+            "dfrobot/pxt-dfrobot_environment_science": {},
+            "ekkai/aicococam": {},
+            "elecfreaks/pxt-xgo": {}
         },
         "upgrades": {
             "tinkertanker/pxt-iot-environment-kit": "min:v4.2.1",
@@ -842,4 +846,4 @@
     "electronManifest": {
         "latest": "v4.0.11"
     }
-}
+}